📟 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.

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

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.

Ferramentas web com firmware integrado e gravação em 1 clique via WebSerial:

⚠️ Antes de iniciar:

1- Garanta que está reconhecendo o driver serial:Drivers de Comunicação Serial.

2- Garanta que a placa está em modo de gravação: Como colocar a Heltec V2 em modo de programação.

• MeshForge (Recomendado - Firmware 2.7.x Recente): 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: 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): RLee203 Web Flasher
  • Vantagem: Interface simplificada que grava a imagem completa (offset 0x0) a 115200 baud.

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: LoRa Italia - Firmwares Prontos

Firmware pré-compilado na versão 2.5.22 mantido pelo usuário psdurco:

• Guia e Instruções: GitHub - Meshtastic 2.5.22 (Heltec V2)
• Download Direto (.bin): Baixar Firmware 2.5.22 (.bin)

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

• Discussão Técnica: Reddit - Guia de Compilação para Heltec V2

Antes de iniciar a gravação por qualquer método web, é obrigatório colocar a Heltec V2 em modo de programação (bootloader).

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

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.

1. Acesse o 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).

Ideal para quando você baixa os arquivos divididos (bootloader, partitions e firmware):

1. Acesse o 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:

5. Clique em Start / Flash e aguarde finalizar.
6. Pressione o botão RST para reiniciar a placa com o novo firmware.

Método via linha de comando no Linux/Terminal usando a ferramenta nativa da Espressif:

# 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

Após concluir a gravação por qualquer um dos métodos, pressione o botão RST na placa para inicializar o Meshtastic.

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.

• 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.

• Comparativo com Heltec V3 (ESP32-S3)
• Guia de Configuração do Meshtastic
• Voltar para a Lista de Dispositivos