====== 📟 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: # 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. ===== 🔋 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]]