Ferramentas do usuário

Ferramentas do site


meshtastic:dispositivos:heltec_v2

Essa é uma revisão anterior do documento!


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


📐 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: Flasher Direto da Comunidade (Mais Fácil - Tudo em 1 Clique)

O site mantido por RLee203 já possui a imagem do firmware compilado e um gravador embutido no navegador:

  • Acessar Flasher Embutido: RLee203 Heltec V2 Web Flasher
  • Vantagem: Não precisa baixar arquivos .bin. Ele grava a imagem completa (offset 0x0) direto na placa via WebSerial.

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:

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:

Opção 4: Compilação Manual via PlatformIO (Avançado)

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


🚀 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

  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. Clique em “Upload your own firmware release zip or bin”.
  2. Selecione o arquivo firmware.bin que você baixou.
  3. Certifique-se de que a placa está no modo de programação (passos acima).
  4. Clique em Flash e aguarde a conclusão.
  5. 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 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
  1. Clique em Start / Flash e aguarde finalizar.
  2. 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.

meshtastic/dispositivos/heltec_v2.1786935514.txt.gz · Última modificação: por pedrom