Diferenças

Aqui você vê as diferenças entre duas revisões dessa página.

--- meshtastic:dispositivos:heltec_v4 [2026/08/17 01:23] – pedrom
+++ meshtastic:dispositivos:heltec_v4 [2026/08/17 01:36] (atual) – [💾 Instalação do Firmware Meshtastic] pedrom
@@ Linha 44: / Linha 44: @@
 ===== 💾 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):
+. Acesse o [[https://flasher.meshtastic.org/|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.
+{{: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.