Diferenças

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

--- meshtastic:dispositivos:heltec_v2 [2026/08/16 23:24] – pedrom
+++ meshtastic:dispositivos:heltec_v2 [2026/08/17 01:08] (atual) – [📟 Heltec V2 (ESP32)] pedrom
@@ Linha 4: / Linha 4: @@
 A **Heltec Automation V2** (WiFi LoRa 32 V2) é uma placa de desenvolvimento baseada no microcontrolador ESP32 clássico, integrada com display OLED de 0.96" e chip LoRa SX1276 ou SX1278. É uma placa muito popular para a criação de nós de mesa e testes na rede Meshtastic.
+{{:meshtastic:dispositivos:wifi-lora-32-v2-1.png?400|}}
 ---
@@ Linha 49: / Linha 50: @@
 ---
-===== 💾 Métodos de Instalação =====
-==== Opção 1: Acervo LoRa Italia (Recomendado - Várias Versões Prontas) ====
+===== 📦 Onde Obter o Firmware (Opções e Fontes) =====
+==== Opção 1: Flash Direto pelo Navegador (Sem Baixar Arquivos) ====
+Ferramentas web com firmware integrado e gravação em 1 clique via WebSerial:
+> ⚠️ **Antes de iniciar:**
+- Garanta que está reconhecendo o driver serial:[[https://wiki.meshbrasil.com/meshtastic:dispositivos:heltec_v2#%F0%9F%94%A7_como_colocar_a_heltec_v2_em_modo_de_programacao|Drivers de Comunicação Serial]].
+- Garanta que a placa está em modo de gravação: [[https://wiki.meshbrasil.com/meshtastic:dispositivos:heltec_v2#%F0%9F%94%A7_como_colocar_a_heltec_v2_em_modo_de_programacao|Como colocar a Heltec V2 em modo de programação]].
+  * **MeshForge (Recomendado - Firmware 2.7.x Recente):** [[https://meshforge.org/meshtastic/firmware/tree/v2.7.26.54e0d8d/target/heltec-v2_0|MeshForge Heltec V2]]
+    * *Vantagem:* Mantém builds atualizadas da versão 2.7.x e possui botão de flash direto na página.
+* **FlashMesh:** [[https://flashmesh.ru/|FlashMesh Web Installer]]
+    * *Vantagem:* Ferramenta web da comunidade (suporta Meshtastic e MeshCore) com interface simples baseada em ESP Web Tools.
+  * **RLee203 Flasher (Imagem Factory Pronta):** [[https://rlee203.github.io/heltec-v2-meshtastic-flasher/|RLee203 Web Flasher]]
+    * *Vantagem:* Interface simplificada que grava a imagem completa (offset `0x0`) a 115200 baud.
+==== Opção 2: Acervo LoRa Italia (Recomendado - Várias Versões Prontas) ====
 O repositório do **LoRa Italia** disponibiliza arquivos `.bin` pré-compilados prontos para gravação no Heltec V2 e outras placas antigas:
@@ Linha 57: / Linha 79: @@
   * **Acessar Repositório:** [[https://www.loraitalia.it/firmware/|LoRa Italia - Firmwares Prontos]]
-==== Opção 2: Build Estável 2.5.22 (GitHub psdurco) ====
+==== Opção 3: Build Estável 2.5.22 (GitHub psdurco) ====
 Firmware pré-compilado na versão 2.5.22 mantido pelo usuário **psdurco**:
@@ Linha 64: / Linha 86: @@
   * **Download Direto (.bin):** [[https://github.com/psdurco/Meshtastic.2.5.22-Heltec-v2/raw/main/firmware-heltec-v2-2.5.22.bin|Baixar Firmware 2.5.22 (.bin)]]
-==== Opção 3: Compilação Manual via PlatformIO (Avançado) ====
+==== Opção 4: Compilação Manual via PlatformIO (Avançado) ====
 Caso deseje compilar versões customizadas manualmente no seu computador:
@@ Linha 72: / Linha 94: @@
 ---
-==== 🛠️ Como Gravar o Arquivo .bin Baixado ====
+===== 🚀 Passo a Passo de Gravação (Flashing Firmware) =====
-Após baixar o arquivo `.bin` (via LoRa Italia ou GitHub), conecte a placa via Micro-USB e execute no terminal:
+Antes de iniciar a gravação por qualquer método web, é **obrigatório colocar a Heltec V2 em modo de programação (bootloader)**.
+===== 🔌 Drivers de Comunicação Serial =====
+A Heltec V2 utiliza o chip conversor **CP2102**.
+  * **Linux / Windows 10/11:** Reconhecimento automático (plug and play).
+  * **Caso a porta COM / ttyUSB não apareça:** Baixe o driver oficial em [[https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers|Silicon Labs CP210x VCP Drivers]].
+  * **Atenção ao Cabo:** Certifique-se de usar um cabo Micro-USB **com vias de dados**. Cabos de carregadores baratos que possuem apenas linhas de energia (+5V/GND) não permitirão a comunicação com o computador.
+==== 🔧 Como Colocar a Heltec V2 em Modo de Programação ====
+. Conecte a Heltec V2 ao computador via cabo USB.
+. Mantenha pressionado o botão **PRG** (Program) na placa.
+. Enquanto segura o **PRG**, pressione e solte o botão **RST** (Reset).
+. Solte o botão **PRG**.
+. A placa entrará em modo bootloader, pronta para receber o firmware.
+---
+==== Opção 1: Gravação via Meshtastic Web Flasher ====
+. Acesse o [[https://flasher.meshtastic.org/|Meshtastic Web Flasher]].
+. Clique em **"Upload your own firmware release zip or bin"**.
+. Selecione o arquivo `firmware.bin` que você baixou.
+. Certifique-se de que a placa está no modo de programação (passos acima).
+. Clique em **Flash** e aguarde a conclusão.
+. Reinicie o dispositivo (pressione RST).
+---
+==== Opção 2: Gravação via ESP Web Flasher (Avançado) ====
+Ideal para quando você baixa os arquivos divididos (`bootloader`, `partitions` e `firmware`):
+. Acesse o [[https://web.espressif.com/|ESP Web Flasher]] (ou flasher web genérico da Espressif).
+. Clique em **Connect** e selecione a porta serial da sua Heltec V2.
+. Garanta que a placa está no modo de programação.
+. Adicione os arquivos e defina manualmente os endereços de memória corretos:
+^ Arquivo ^ Endereço de Memória (Offset) ^
+| `bootloader.bin` | `0x1000` |
+| `partitions.bin` | `0x8000` |
+| `firmware.bin` | `0x10000` |
+. Clique em **Start / Flash** e aguarde finalizar.
+. Pressione o botão **RST** para reiniciar a placa com o novo firmware.
+==== Opção 3: Linha de Comando / Terminal (esptool.py) ====
+Método via linha de comando no Linux/Terminal usando a ferramenta nativa da Espressif:
 <code>
+# 1. Limpa a memória flash antiga
 esptool.py --chip esp32 --port /dev/ttyUSB0 erase_flash
-esptool.py --chip esp32 --port /dev/ttyUSB0 write_flash 0x10000 nome_do_arquivo.bin
+# 2. Grava o novo firmware (.bin único)
+esptool.py --chip esp32 --port /dev/ttyUSB0 write_flash 0x10000 firmware-heltec-v2.bin
 </code>
 ---
+Após concluir a gravação por qualquer um dos métodos, **pressione o botão RST** na placa para inicializar o Meshtastic.
+===== 🔋 Leitura da Tensão da Bateria (V2.0 vs V2.1) =====
+Se após a gravação do firmware o dispositivo **não exibir a leitura da bateria** (ou a porcentagem ficar cravada em 0% / 0.0V):
+> ⚠️ **Incompatibilidade de Hardware (V2.0 vs V2.1):** As placas **Heltec V2.0** e **Heltec V2.1** utilizam pinos diferentes do microcontrolador para ler a tensão do divisor de ressitores da bateria:
+>   * **Heltec V2.0:** Leitura pelo pino **GPIO 37**
+>   * **Heltec V2.1:** Leitura pelo pino **GPIO 13**
+* **Como Corrigir:**
+  * Certifique-se de baixar/gravar o arquivo compilado especificamente para a **Heltec V2.1** (`heltec-v2_1`).
+  * Caso o firmware utilizado não possua uma build específica para a V2.1, você pode ajustar manualmente os pinos do ADC nas configurações do aplicativo Meshtastic (*Power / Battery Overriding*) informando o pino correto do sensor.
 ===== ⚠️ Cuidados e Observações Importantes =====