Meshbrasil Wiki

Você carregou uma revisão antiga desse documento! Se você salvá-la, irá criar uma nova versão com esses dados.

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

---

===== 📐 Especificações Técnicas =====

---

===== ⚡ 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):

1. Acesse o [[https://flasher.meshtastic.org/|Meshtastic Web Flasher]].
  2. No campo **Device**, selecione **Heltec V4** (ou **Heltec V3.1**).
  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-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.

Resumo da edição

Observe: editando esta página você aceita disponibilizar o seu conteúdo sob a seguinte licença: CC Attribution-Share Alike 4.0 International