Essa é uma revisão anterior do documento!
Tabela de conteúdos
📟 Heltec V2 (ESP32)
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.
📐 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.
🔌 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 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.
📦 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:
- 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.
- RLee203 Flasher (Imagem Factory Pronta): RLee203 Web Flasher
- Vantagem: Interface simplificada que grava a imagem completa (offset
0x0) a 115200 baud.
⚠️ Antes de iniciar: Garanta que a placa está em modo de gravação seguindo o passo a passo em: Como colocar a Heltec V2 em modo de programação.
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: 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: GitHub - Meshtastic 2.5.22 (Heltec V2)
- Download Direto (.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: Reddit - Guia de Compilação para Heltec V2
🚀 Passo a Passo de Gravação (Flashing)
Antes de iniciar a gravação por qualquer método web, é obrigatório colocar a Heltec V2 em modo de programação (bootloader).
🔧 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 Meshtastic Web Flasher.
- Clique em “Upload your own firmware release zip or bin”.
- Selecione o arquivo
firmware.binque 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 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:
# 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.
⚠️ 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.