Meshbrasil Wiki

Ferramentas do usuário

Ferramentas do site

Visitou: • o-que-e
meshtastic:firmware

Diferenças

Aqui você vê as diferenças entre duas revisões dessa página.

Link para esta página de comparações

Ambos lados da revisão anteriorRevisão anterior
meshtastic:firmware [2026/09/08 18:56] – removida - edição externa (Data desconhecida) 127.0.0.1meshtastic:firmware [2026/09/14 13:40] (atual) – criada - edição externa 127.0.0.1
Linha 1: Linha 1:
 +# ⚡ Firmware
 +
 +O firmware é o "sistema operacional" do seu dispositivo Meshtastic. Este guia explica como instalar (flashar) o firmware no seu hardware.
 +
 +---
 +
 +## 🤔 O que é Firmware?
 +
 +Firmware é o software que roda diretamente no hardware do seu dispositivo. Ele transforma um módulo LoRa bruto em um node Meshtastic funcional.
 +
 +| Conceito | Analogia |
 +| :--- | :--- |
 +| **Hardware** | O celular (físico) |
 +| **Firmware** | O Android (sistema) |
 +| **App** | O aplicativo de mensagens |
 +
 +---
 +
 +## 📋 Pré-requisitos
 +
 +| Item | Onde Conseguir |
 +| :--- | :--- |
 +| 📱 Dispositivo LoRa | Ver [[meshtastic:hardware\|Hardware]] |
 +| 🔌 Cabo USB | Geralmente vem com o dispositivo |
 +| 🌐 Navegador web | Chrome, Edge ou Firefox (versão recente) |
 +| 💻 OU Python | https://python.org/ (para outras métodos) |
 +
 +---
 +
 +## 🌐 Método 1: Web Flasher (Recomendado)
 +
 +O **Web Flasher** é o método mais fácil — funciona direto no navegador, sem instalar nada.
 +
 +### Passo 1: Acessar o Web Flasher
 +
 +🌐 https://flasher.meshtastic.org
 +
 +### Passo 2: Conectar o Dispositivo
 +
 +1. 🔌 **Conecte** o dispositivo via cabo USB
 +2. 🖥️ **Abra** o Web Flasher no navegador
 +3. 📡 **Selecione** a porta serial (geralmente aparece automaticamente)
 +4. 📲 **Clique** em "Connect"
 +
 +### Passo 3: Selecionar o Dispositivo
 +
 +| Seu Dispositivo | Selecione |
 +| :--- | :--- |
 +| Heltec V3 | "Heltec WiFi LoRa 32 V3" |
 +| Heltec V4 | "Heltec WiFi LoRa 32 V4" |
 +| T-Beam v1.2 | "TTGO T-Beam" |
 +| RAK4631 | "RAK WisBlock Core RAK4631" |
 +
 +### Passo 4: Selecionar o Firmware
 +
 +| Opção | Descrição |
 +| :--- | :--- |
 +| **Stable** | Versão estável (recomendado para iniciantes) |
 +| **Beta** | Versão de teste (funcionalidades novas) |
 +| **Alpha** | Versão experimental (pode ter bugs) |
 +
 +> 💡 **Dica:** Comece com a versão **Stable**. É a mais testada e confiável.
 +
 +### Passo 5: Flashar
 +
 +1. ✅ **Confirme** as opções selecionadas
 +2. ⚡ **Clique** em "Flash"
 +3. ⏳ **Aguarde** o processo (1-3 minutos)
 +4. ✅ **Pronto!** O dispositivo reiniciará automaticamente
 +
 +---
 +
 +## 💻 Método 2: Meshtastic Flasher (Python)
 +
 +Para quem prefere linha de comando ou tem problemas com o Web Flasher.
 +
 +### Instalação
 +
 +```bash
 +# Instalar o flasher
 +pip install --upgrade meshtastic-flasher
 +
 +# Verificar instalação
 +meshtastic-flasher --version
 +```
 +
 +### Uso
 +
 +```bash
 +# Listar dispositivos conectados
 +meshtastic-flasher --list
 +
 +# Flashar (substitua pela porta correta)
 +meshtastic-flasher --port /dev/ttyUSB0 --firmware stable
 +```
 +
 +---
 +
 +## 🔧 Método 3: VS Code + PlatformIO
 +
 +Para avançados que querem compilar o firmware do código-fonte.
 +
 +### Pré-requisitos
 +
 +| Item | Onde Conseguir |
 +| :--- | :--- |
 +| VS Code | https://code.visualstudio.com/ |
 +| PlatformIO | Extensão no VS Code |
 +| Git | https://git-scm.com/ |
 +
 +### Passos
 +
 +1. 📥 **Clone** o repositório:
 +```bash
 +git clone https://github.com/meshtastic/firmware.git
 +cd firmware
 +```
 +
 +2. 🔧 **Abra** no VS Code com PlatformIO
 +
 +3. ⚙️ **Selecione** o target (seu dispositivo)
 +
 +4. ⚡ **Compile** e **upload**
 +
 +---
 +
 +## 🔄 Atualizar Firmware
 +
 +Se já tem um node funcionando e quer atualizar:
 +
 +### Via Web Flasher
 +
 +1. 🌐 Acesse https://flasher.meshtastic.org
 +2. 📡 Conecte o dispositivo
 +3. ⚡ Selecione a nova versão
 +4. ✅ Clique em "Flash"
 +
 +### Via App (OTA)
 +
 +1. 📲 Abra o app Meshtastic
 +2. ⚙️ Vá em "Configurações do dispositivo"
 +3. 🔧 Selecione "Atualizar firmware"
 +4. ⏳ Aguarde o download e instalação
 +
 +---
 +
 +## ⚠️ Solução de Problemas
 +
 +### Dispositivo não é detectado
 +
 +| Possível Causa | Solução |
 +| :--- | :--- |
 +| 🔌 Cabo USB ruim | Teste com outro cabo |
 +| 🔌 Cabo só carrega (sem dados) | Use cabo com dados |
 +| 🖥️ Driver não instalado | Instale CP2102 ou CH340 |
 +| 💻 Porta errada | Verifique no Gerenciador de Dispositivos |
 +
 +### Flash falha
 +
 +| Possível Causa | Solução |
 +| :--- | :--- |
 +| ⏱️ Tempo esgotado | Reconecte e tente novamente |
 +| 🔄 Dispositivo reiniciou | Aguarde 30 segundos e tente |
 +| ⚡ Bateria baixa | Conecte na energia USB |
 +| 📦 Firmware errado | Verifique o modelo do dispositivo |
 +
 +### Dispositivo não liga após flash
 +
 +| Possível Causa | Solução |
 +| :--- | :--- |
 +| 🔌 Cabo desconectado | Reconecte o cabo USB |
 +| ⏱️ Aguarde | Pode demorar até 1 minuto para o primeiro boot |
 +| 🔄 Reflash | Repita o processo de flash |
 +
 +---
 +
 +## 📚 Recursos
 +
 +| Recurso | Link |
 +| :--- | :--- |
 +| 🌐 Web Flasher Oficial | https://flasher.meshtastic.org |
 +| 📖 Documentação Meshtastic | https://meshtastic.org/docs/getting-started |
 +| 🎥 Vídeo Tutorial (YT) | https://youtu.be/f8zv2qso7G8 |
 +| 💬 Comunidade | https://t.me/meshtastic_br |
 +
 +---
 +
 +## 🔗 Próximos Passos
 +
 +| Você flashou... | Próximo passo |
 +| :--- | :--- |
 +| ✅ Firmware instalado | [[meshtastic:configuracao\|Configurar o Node]] |
 +| 🔄 Atualizou firmware | Verifique as configurações |
 +| ❓ Teve problemas | Consulte a seção de solução acima |
 +
 +---
 +
 +## 📝 Créditos
 +
 +Guia baseado na documentação oficial do Meshtastic.
 +Fonte: https://meshtastic.org/docs/getting-started/flash-firmware