====== 📟 Heltec V3 (WiFi LoRa 32 V3) ======

* **Processador:** ESP32-S3 (Dual-Core LX7)
* **Display:** OLED 0.96" (SSD1306) integrado
* **Chip LoRa:** Semtech SX1262
* **Conectividade:** Wi-Fi, Bluetooth 5.0 (BLE), USB-C
* **Gerenciamento de Bateria:** Chip de carga integrado com conector JST SH 1.25mm
* **Firmwares Suportados:** Meshtastic (Suporte Oficial Nativo), MeshCore
* **Uso Ideal:** Nó mestre/roteador, gateway Wi-Fi/MQTT, nó portátil e testes de campo.

{{:meshtastic:dispositivos:wifi-lora-32-v3.png?400|}}

---

===== 💾 Instalação do Firmware Meshtastic =====

Diferente das versões antigas, a **Heltec V3 possui suporte oficial nativo** no repositório principal do Meshtastic.

> ⚠️ **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 V3**.
  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**.

==== 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-v3-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-v3.bin
</code>