Guia completo para instalar ou atualizar o firmware Meshtastic nos dispositivos compatíveis.

• Dispositivo compatível (Heltec V3/V4, T-Beam, RAK4631, etc.)
• Cabo USB adequado (USB-C para placas mais recentes)
• Computador com navegador web (Chrome/Edge recomendado)
• Conexão com a internet

1. Acesse Meshtastic Web Flasher
2. Permita o acesso à porta serial quando solicitado

1. Conecte o dispositivo via USB
2. Clique em Select Device
3. Escolha o modelo correto do dispositivo
4. Se não aparecer, clique em Manually Select e escolha o chip

1. Selecione a versão mais recente (latest)
2. Configure as opções:
   • WiFi: Ative se for gateway
   • WebUI: DESLIGUE para Heltec V4 (evita erro de partição)
   • BLE: Ative para nós móveis
3. Clique em Build Firmware

1. Aguarde o download do firmware
2. Coloque o dispositivo em modo de programação:
   • Heltec V3/V4: Segure PRG + clique RST
   • T-Beam: Segure PRG + clique RST
   • RAK4631: Conecte via USB e pressione RESET
3. Clique em Flash
4. Aguarde a instalação (~2-5 minutos)

Acesse Releases no GitHub e baixe:

• firmware.bin para flash via web
• firmware.factory.bin para flash completo

1. Acesse ESP Web Flasher
2. Conecte o dispositivo via USB

• Para .bin: Offset = 0x10000
• Para .factory.bin: Offset = 0x0

1. Selecione o arquivo firmware
2. Configure o offset correto
3. Clique em Program
4. Aguarde a conclusão

pip install esptool

# Apague o flash (opcional, mas recomendado)
esptool.py erase_flash
 
# Instale o firmware
esptool.py --chip esp32s3 --baud 460800 write_flash 0x0 firmware.factory.bin

esptool.py --chip esp32s3 --baud 460800 write_flash 0x10000 firmware.bin

1. Segure o botão PRG
2. Clique no botão RST
3. Solte o PRG
4. O dispositivo está em modo de programação

1. Segure o botão PRG
2. Clique no botão RST
3. Solte o PRG

1. Conecte via USB
2. Pressione o botão RESET
3. O bootloader entra em modo DFU

• CP2102: Download drivers
• CH340: Download drivers

# Ubuntu/Debian
sudo apt install brltty
 
# ou
sudo usermod -a -G dialout $USER
# (faça logout e login novamente)

• CP2102: Download drivers
• Geralmente funciona nativamente

• Dispositivo não aparece: Verifique o cabo (alguns são só para carga)
• Erro de permissão (Linux): Adicione seu usuário ao grupo dialout
• Flash falhou: Coloque o dispositivo em modo de programação
• Erro de partição (Heltec V4): Desative “Include WebUI”
• Não inicia após flash: Reinicie o dispositivo

Para atualizar de uma versão anterior:

1. Faça backup das configurações
2. Siga qualquer método acima
3. As configurações são preservadas entre versões

• Guia Heltec V3
• Guia Heltec V4
• Guia de Configuração