⚡ 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 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
Passo 2: Conectar o Dispositivo
🔌 Conecte o dispositivo via cabo USB
🖥️ Abra o Web Flasher no navegador
📡 Selecione a porta serial (geralmente aparece automaticamente)
📲 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
✅ Confirme as opções selecionadas
⚡ Clique em “Flash”
⏳ Aguarde o processo (1-3 minutos)
✅ 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
# Instalar o flasher
pip install --upgrade meshtastic-flasher
# Verificar instalação
meshtastic-flasher --version
Uso
# Listar dispositivos conectados
meshtastic-flasher --list
# Flashar (substitua pela porta correta)
meshtastic-flasher --port /dev/ttyUSB0 --firmware stable
Para avançados que querem compilar o firmware do código-fonte.
Pré-requisitos
Passos
📥 Clone o repositório:
git clone https://github.com/meshtastic/firmware.git
cd firmware
🔧 Abra no VS Code com PlatformIO
⚙️ Selecione o target (seu dispositivo)
⚡ Compile e upload
🔄 Atualizar Firmware
Se já tem um node funcionando e quer atualizar:
Via Web Flasher
-
📡 Conecte o dispositivo
⚡ Selecione a nova versão
✅ Clique em “Flash”
Via App (OTA)
📲 Abra o app Meshtastic
⚙️ Vá em “Configurações do dispositivo”
🔧 Selecione “Atualizar firmware”
⏳ 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
🔗 Próximos Passos
| Você flashou… | Próximo passo |
| ✅ Firmware instalado | Configurar o Node |
| 🔄 Atualizou firmware | Verifique as configurações |
| ❓ Teve problemas | Consulte a seção de solução acima |
📝 Créditos