Meshbrasil Wiki

Ferramentas do usuário

Ferramentas do site

Visitou:
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

Próxima revisão		Revisão anterior
meshtastic:firmware [2026/09/02 12:57] – criada - edição externa 127.0.0.1meshtastic:firmware [2026/09/14 13:40] (atual) – criada - edição externa 127.0.0.1
Linha 1: Linha 1:
-====== Instalação de Firmware ======+# ⚡ Firmware
  
-Guia completo para instalar ou atualizar o firmware Meshtastic nos dispositivos compatíveis.+O firmware é o "sistema operacional" do seu dispositivo Meshtastic. Este guia explica como instalar (flashar) o firmware no seu hardware.
  
-===== Pré-requisitos =====+---
  
-  * Dispositivo compatível (Heltec V3/V4, T-Beam, RAK4631, etc.) +## 🤔 O que é Firmware?
-  * Cabo USB adequado (USB-C para placas mais recentes) +
-  * Computador com navegador web (Chrome/Edge recomendado) +
-  * Conexão com a internet+
  
-===== Método 1: Meshtastic Web Flasher (Recomendado) =====+Firmware é o software que roda diretamente no hardware do seu dispositivo. Ele transforma um módulo LoRa bruto em um node Meshtastic funcional.
  
-=== Passo 1: Acesse o Flasher ===+| Conceito | Analogia | 
 +| :--- | :--- | 
 +| **Hardware** | O celular (físico) | 
 +| **Firmware** | O Android (sistema) | 
 +| **App** | O aplicativo de mensagens |
  
-  1. Acesse [[https://flasher.meshtastic.org|Meshtastic Web Flasher]] +---
-  2. Permita o acesso à porta serial quando solicitado+
  
-=== Passo 2: Selecione o Dispositivo ===+## 📋 Pré-requisitos
  
-  1. Conecte o dispositivo via USB +| Item | Onde Conseguir | 
-  2. Clique em **Select Device** +| :--- | :--- | 
-  3. Escolha o modelo correto do dispositivo +| 📱 Dispositivo LoRa | Ver [[meshtastic:hardware\|Hardware]] | 
-  4. Se não aparecer, clique em **Manually Select** e escolha o chip+| 🔌 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) |
  
-=== Passo 3: Escolha o Firmware ===+---
  
-  1. Selecione a versão mais recente (''latest'') +## 🌐 Método 1: Web Flasher (Recomendado)
-  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**+
  
-=== Passo 4: Instale ===+O **Web Flasher** é o método mais fácil — funciona direto no navegador, sem instalar nada.
  
-  1. Aguarde o download do firmware +### Passo 1: Acessar o Web Flasher
-  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)+
  
-===== Método 2: ESP Web Flasher (Manual) =====+🌐 https://flasher.meshtastic.org
  
-=== Passo 1: Baixe o Firmware ===+### Passo 2: Conectar o Dispositivo
  
-Acesse [[https://github.com/meshtastic/firmware/releases|Releases no GitHub]] e baixe:+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"
  
-  * ''firmware.bin'' para flash via web +### Passo 3: Selecionar o Dispositivo
-  * ''firmware.factory.bin'' para flash completo+
  
-=== Passo 2: Acesse o ESP Web Flasher ===+| 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" |
  
-  1. Acesse [[https://espwebtool.github.io|ESP Web Flasher]] +### Passo 4: Selecionar o Firmware
-  2. Conecte o dispositivo via USB+
  
-=== Passo 3: Configure os Offsets ===+| 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) |
  
-  * Para ''.bin'': Offset = ''0x10000'' +> 💡 **Dica:** Comece com a versão **Stable**. É a mais testada e confiável.
-  * Para ''.factory.bin'': Offset = ''0x0''+
  
-=== Passo 4: Instale ===+### Passo 5: Flashar
  
-  1. Selecione o arquivo firmware +1. ✅ **Confirme** as opções selecionadas 
-  2. Configure o offset correto +2. ⚡ **Clique** em "Flash" 
-  3. Clique em **Program** +3. ⏳ **Aguarde** o processo (1-3 minutos) 
-  4. Aguarde a conclusão+4. ✅ **Pronto!** O dispositivo reiniciará automaticamente
  
-===== Método 3: esptool.py (Linha de Comando) =====+---
  
-=== Instalação ===+## 💻 Método 2: Meshtastic Flasher (Python) 
 + 
 +Para quem prefere linha de comando ou tem problemas com o Web Flasher. 
 + 
 +### Instalação
  
 ```bash ```bash
-pip install esptool+# Instalar o flasher 
 +pip install --upgrade meshtastic-flasher 
 + 
 +# Verificar instalação 
 +meshtastic-flasher --version
 ``` ```
  
-=== Flash Completo (Recomendado) ===+### Uso
  
 ```bash ```bash
-# Apague o flash (opcional, mas recomendado) +# Listar dispositivos conectados 
-esptool.py erase_flash+meshtastic-flasher --list
  
-# Instale o firmware +# Flashar (substitua pela porta correta) 
-esptool.py --chip esp32s3 --baud 460800 write_flash 0x0 firmware.factory.bin+meshtastic-flasher --port /dev/ttyUSB0 --firmware stable
 ``` ```
  
-=== Flash Parcial ===+---
  
 +## 🔧 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 ```bash
-esptool.py --chip esp32s3 --baud 460800 write_flash 0x10000 firmware.bin+git clone https://github.com/meshtastic/firmware.git 
 +cd firmware
 ``` ```
  
-===== Modo de Programação =====+2. 🔧 **Abra** no VS Code com PlatformIO
  
-=== Heltec V3/V4 ===+3. ⚙️ **Selecione** o target (seu dispositivo)
  
-  1. Segure o botão **PRG** +4. ⚡ **Compile** e **upload**
-  2. Clique no botão **RST** +
-  3. Solte o **PRG** +
-  4. O dispositivo está em modo de programação+
  
-=== LilyGO T-Beam ===+---
  
-  1. Segure o botão **PRG** +## 🔄 Atualizar Firmware
-  2. Clique no botão **RST** +
-  3. Solte o **PRG**+
  
-=== RAK4631 ===+Se já tem um node funcionando e quer atualizar:
  
-  1. Conecte via USB +### Via Web Flasher
-  2. Pressione o botão **RESET** +
-  3. O bootloader entra em modo DFU+
  
-===== Drivers Seriais =====+1. 🌐 Acesse https://flasher.meshtastic.org 
 +2. 📡 Conecte o dispositivo 
 +3. ⚡ Selecione a nova versão 
 +4. ✅ Clique em "Flash"
  
-=== Windows ===+### Via App (OTA)
  
-  * **CP2102**: [[https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers|Download drivers]] +1. 📲 Abra o app Meshtastic 
-  * **CH340**: [[https://www.wch-ic.com/downloads/CH341SER_EXE.html|Download drivers]]+2. ⚙️ Vá em "Configurações do dispositivo" 
 +3. 🔧 Selecione "Atualizar firmware" 
 +4. ⏳ Aguarde o download e instalação
  
-=== Linux ===+---
  
-```bash +## ⚠️ Solução de Problemas
-# Ubuntu/Debian +
-sudo apt install brltty+
  
-# ou +### Dispositivo não é detectado 
-sudo usermod -a -G dialout $USER + 
-# (faça logout e login novamente) +| 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 |
  
-=== macOS ===+---
  
-  * CP2102: [[https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers|Download drivers]] +## 📚 Recursos
-  * Geralmente funciona nativamente+
  
-===== Solução de Problemas =====+| 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 |
  
-  * **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+
  
-===== Atualização de Firmware =====+## 🔗 Próximos Passos
  
-Para atualizar de uma versão anterior:+| 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 |
  
-  1. Faça backup das configurações +---
-  2. Siga qualquer método acima +
-  3. As configurações são preservadas entre versões+
  
-===== Veja Também =====+## 📝 Créditos
  
-  * [[meshtastic:dispositivos:heltec_v3|Guia Heltec V3]] +Guia baseado na documentação oficial do Meshtastic. 
-  * [[meshtastic:dispositivos:heltec_v4|Guia Heltec V4]] +Fonte: https://meshtastic.org/docs/getting-started/flash-firmware
-  * [[meshtastic:configuracao|Guia de Configuração]]+
  
meshtastic/firmware.1788364662.txt.gz · Última modificação: por 127.0.0.1