📟 Heltec V4 (ESP32-S3)

A Heltec Automation V4 (WiFi LoRa 32 V4 / V3.1) é a evolução direta da linha WiFi LoRa 32. Mantém o microcontrolador ESP32-S3, mas introduz um novo front-end de RF com amplificador de potência (PA) capaz de atingir até +28 dBm de transmissão, além de melhorias no gerenciamento térmico, eficiência de bateria e circuito de recarga.

📐 Especificações Técnicas

Componente	Especificação
MCU	ESP32-S3FN8 (Dual-Core 32-bit LX7, até 240 MHz)
RF Transceiver	Semtech SX1262 + Front-End High-Power PA (Até +28 dBm / 630mW)
Frequência Operacional	863–928 MHz (Versão BR/US) ou 433–510 MHz
Memória	8 MB Flash (QSPI), 512 KB SRAM + 2 MB PSRAM
Conectividade	Wi-Fi 802.11 b/g/n, Bluetooth 5.0 (BLE)
Display	OLED 0.96“ (Driver SSD1306)
Conector USB	USB Type-C (Ponte Serial Nativa / CP2102)
Gerenciamento de Bateria	Conector SH1.25 2-pin (Circuito de carga LiPo/LiFePO4 integrado)

⚡ Mapeamento de Pinos (Pinout Interno)

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

OLED SDA: GPIO 17
OLED SCL: GPIO 18
OLED RST: GPIO 21
LoRa NSS (CS): GPIO 8
LoRa SCK: GPIO 9
LoRa MOSI: GPIO 10
LoRa MISO: GPIO 11
LoRa RST: GPIO 12
LoRa BUSY: GPIO 13
LoRa DIO1: GPIO 14
Vext Control (Power On): GPIO 36
Botão PRG (Usuário): GPIO 0
Medição de Bateria (ADC): GPIO 1

💾 Instalação do Firmware Meshtastic

A Heltec V4 possui suporte oficial nativo no repositório principal do Meshtastic (alvo heltec-v4 ou heltec-v3-1).

⚠️ Atenção ao Cabo USB: Certifique-se de utilizar um cabo USB-C que possua linhas de transmissão de dados. Cabos exclusivos de carregamento não permitirão que o computador reconheça a placa.

📦 Métodos de Gravação (Flashing)

Opção 1: Web Flasher Oficial do Meshtastic (Recomendado)

Como a placa é suportada oficialmente, o processo é feito em poucos cliques no navegador (Chrome ou Edge):

Acesse o Meshtastic Web Flasher.
No campo Device, selecione Heltec V4.
Selecione a versão do firmware desejada (Release/Stable ou Prerelease).
Conecte a placa à USB do computador.
Clique em Flash e selecione a porta serial/COM correspondente.

💡 Nota de Recuperação: Se o navegador não detectar a placa automaticamente durante a gravação, coloque-a manualmente em modo bootloader: mantenha o botão PRG pressionado, aperte e solte o botão RST, e então solte o PRG.

⚠️ Dica Crucial para a Gravação da Heltec V4

🚨 Atenção ao usar o Meshtastic Web Flasher: Na hora de gravar pelo site flasher.meshtastic.org, MANTENHA A OPÇÃO “Include WebUI” DESATIVADA.

Por que isso acontece? O arquivo da interface web faz a imagem do firmware exceder o tamanho máximo permitido da partição de memória flash. Se essa opção ficar marcada, a gravação apresentará erro ou a placa não iniciará após o término.

Opção 2: Gravação Manual de Arquivos .bin / Factory

Caso deseje baixar as compilações diretamente do repositório ou utilizar o ESP Web Flasher:

Download Oficial de Firmwares: GitHub Meshtastic Releases
Ferramenta de Flash Web: Espressif ESP Web Flasher ou Adafruit Web Serial ESPTool
Endereço de Gravação (Offset):
- Para arquivos firmware-heltec-v4-2.x.x.bin: utilize o offset 0x10000.
- Para arquivos de imagem completa factory: utilize o offset 0x0.

Opção 3: Via Linha de Comando (`esptool.py`)

Para usuários Linux/Debian ou preferência por terminal:

# 1. Apagar a memória flash
esptool.py --chip esp32s3 --port /dev/ttyACM0 erase_flash

# 2. Gravar o firmware .bin
esptool.py --chip esp32s3 --port /dev/ttyACM0 write_flash 0x10000 firmware-heltec-v4.bin

⚡ Cuidados de Alimentação e Transmissão

⚠️ Atenção à Potência (+28 dBm): Devido à alta potência de transmissão do amplificador da V4, NUNCA ligue a placa sem a antena conectada. Ligar o transmissor sem antena (carga casada) pode queimar permanentemente o andar de saída RF do chip.