Meshbrasil Wiki

Essa página está em modo somente de leitura. Você pode visualizar a fonte, mas não alterá-la. Informe-se com o administrador do Wiki, caso você ache que isso está incorreto.
====== 📟 Heltec V2 (ESP32) ======

[[..|← Voltar para Dispositivos]]

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|}}

---

===== 📐 Especificações Técnicas =====

^ Componente ^ Especificação ^
| **MCU** | ESP32-D0WDQ6 (Dual-Core 32-bit LX6, até 240 MHz) |
| **RF Transceiver** | Semtech SX1276 / SX1278 |
| **Frequência Operacional** | 915 MHz (Versão BR/US - SX1276) ou 433 MHz (SX1278) |
| **Memória** | 8 MB Flash, 520 KB SRAM |
| **Conectividade** | Wi-Fi 802.11 b/g/n, Bluetooth 4.2 / BLE |
| **Display** | OLED 0.96" Azul/Branco (Driver SSD1306) |
| **Conector USB** | Micro-USB (Ponte Serial CP2102) |
| **Gerenciamento de Bateria** | Conector SH1.25 2-pin (Carga LiPo 3.7V / TP4054 integrados) |

---

===== ⚡ Mapeamento de Pinos (Pinout Interno) =====

Para fins de compilação, diagnóstico ou adição de sensores externos no Meshtastic:

  * **OLED SDA:** GPIO 21
  * **OLED SCL:** GPIO 22
  * **OLED RST:** GPIO 16
  * **LoRa NSS (CS):** GPIO 18
  * **LoRa SCK:** GPIO 5
  * **LoRa MOSI:** GPIO 27
  * **LoRa MISO:** GPIO 19
  * **LoRa RST:** GPIO 14
  * **LoRa DIO0:** GPIO 26
  * **LoRa DIO1:** GPIO 35
  * **LoRa DIO2:** GPIO 34
  * **Botão PRG (Usuário):** GPIO 0
  * **Medição de Bateria (ADC):** GPIO 37

---

===== 💾 Instalação do Firmware Meshtastic =====

===== ⚠️ Alerta de Suporte do Firmware =====

> **Atenção:** A placa Heltec V2 **não é mais suportada oficialmente** pelas versões recentes do firmware Meshtastic (deprovisionada no repositório principal). Para utilizar esta placa, você deve recorrer a builds customizadas da comunidade ou compilar uma versão recente manualmente.

---



===== 📦 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:** 
1- 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]].

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

  * **Acessar Repositório:** [[https://www.loraitalia.it/firmware/|LoRa Italia - Firmwares Prontos]]

==== 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**:

  * **Guia e Instruções:** [[https://github.com/psdurco/Meshtastic.2.5.22-Heltec-v2/blob/main/README.md|GitHub - Meshtastic 2.5.22 (Heltec V2)]]
  * **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 4: Compilação Manual via PlatformIO (Avançado) ====

Caso deseje compilar versões customizadas manualmente no seu computador:

  * **Discussão Técnica:** [[https://www.reddit.com/r/meshtastic/s/KR8toUrfAS|Reddit - Guia de Compilação para Heltec V2]]

---

===== 🚀 Passo a Passo de Gravação (Flashing Firmware) =====

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 ====

  1. Conecte a Heltec V2 ao computador via cabo USB.
  2. Mantenha pressionado o botão **PRG** (Program) na placa.
  3. Enquanto segura o **PRG**, pressione e solte o botão **RST** (Reset).
  4. Solte o botão **PRG**.
  5. A placa entrará em modo bootloader, pronta para receber o firmware.

---

==== Opção 1: Gravação via Meshtastic Web Flasher ====

  1. Acesse o [[https://flasher.meshtastic.org/|Meshtastic Web Flasher]].
  2. Clique em **"Upload your own firmware release zip or bin"**.
  3. Selecione o arquivo `firmware.bin` que você baixou.
  4. Certifique-se de que a placa está no modo de programação (passos acima).
  5. Clique em **Flash** e aguarde a conclusão.
  6. 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`):

  1. Acesse o [[https://web.espressif.com/|ESP Web Flasher]] (ou flasher web genérico da Espressif).
  2. Clique em **Connect** e selecione a porta serial da sua Heltec V2.
  3. Garanta que a placa está no modo de programação.
  4. 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` |

  5. Clique em **Start / Flash** e aguarde finalizar.
  6. 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

# 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 =====

  * **Proteção de Antena:** Nunca alimente ou ligue a placa sem a antena devidamente rosqueada/conectada ao conector U.FL/IPEX. Ligar o rádio transmitindo sem antena pode danificar o amplificador de potência do chip LoRa (SX1276).
  * **Diferença Heltec V2 vs Heltec V2.1:** A revisão V2.1 possui pequenas melhorias no circuito de carga de bateria e no layout de dissipação, mas ambas utilizam o mesmo alvo de firmware (`heltec-v2`) no Meshtastic.
  * **Consumo de Energia:** Como utiliza o processador ESP32 clássico e regulação linear em algumas partes, o consumo em operação contínua gira em torno de 100mA a 130mA. Para repetidores solares isolados, placas baseadas em nRF52 (como RAK4631) são mais indicadas.

---

===== 🔗 Links Relacionados =====
  * [[:meshtastic:dispositivos:heltec_v3|Comparativo com Heltec V3 (ESP32-S3)]]
  * [[:meshtastic:configuracao|Guia de Configuração do Meshtastic]]
  * [[:meshtastic:dispositivos|Voltar para a Lista de Dispositivos]]