====== 📟 Heltec V4 (ESP32-S3) ======

[[..|← Voltar para Dispositivos]]

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.

{{:meshtastic:dispositivos:v4001.png?400|}}

---

===== 📐 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`).

> ⚠️ **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):

  1. Acesse o [[https://flasher.meshtastic.org/|Meshtastic Web Flasher]].
  2. No campo **Device**, selecione **Heltec V4**.
  3. Selecione a versão do firmware desejada (Release/Stable ou Prerelease).
  4. Conecte a placa à USB do computador.
  5. 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.
{{:meshtastic:dispositivos:4906936038048075050.jpg?400|}}
==== 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:** [[https://github.com/meshtastic/firmware/releases|GitHub Meshtastic Releases]]
  * **Ferramenta de Flash Web:** [[https://web.espressif.com/|Espressif ESP Web Flasher]] ou [[https://adafruit.github.io/web-esptool/|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:

<code>
# 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
</code>

---

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