Skip to main content

Heltec V4 Setup Guide

⚠ ANTENNA SAFETY — ALL DEVICES: Always connect an antenna before powering on any LoRa device. Even a brief transmission without an antenna connected risks permanent damage to the LoRa radio chip.

Heltec V4 (Vision Master T190 / Heltec V4.x) — Setup Guide

The Heltec V4 offers significantly higher TX power than the V3 (28 dBm vs 21 dBm) and includes a built-in solar charging interface, making it well-suited for permanent outdoor installations.

Specifications

AttributeValue
MCUESP32-S3
RadioSX1262
Max TX Power28 dBm (~630 mW)
SolarBuilt-in solar charging interface
USBUSB-C
Price$25–35
StrengthsHigher TX power than V3, solar interface, good for permanent installs

Driver Installation

The Heltec V4 uses a CH340 USB-to-Serial chip. This driver is required on Windows — the device will not appear without it.

  • Windows: Download the CH340 driver from the manufacturer (search “CH340 driver Windows” or visit the WCH website). Install and reboot. Verify the device appears as a COM port in Device Manager.
  • macOS: May require the CH34xVCPDriver. Download from the WCH website if the device is not detected automatically.
  • Linux: Built-in kernel driver — no installation required.
⚠ Windows users: If the device does not appear as a COM port after plugging in, the CH340 driver is missing. Do not proceed until the driver is installed.

Entering Bootloader / DFU Mode

Method 1 — From powered-off state (recommended):

  1. Disconnect the USB cable.
  2. Hold the BOOT button.
  3. Connect the USB cable while continuing to hold BOOT.
  4. Hold for 1–2 seconds after connecting, then release BOOT.

Method 2 — From powered-on state:

  1. Hold the BOOT button.
  2. Briefly press and release the RST button while holding BOOT.
  3. Release the BOOT button.

Firmware Flashing

  1. Enter bootloader mode (see above).
  2. Open Chrome or Edge and navigate to:
  3. Select the Heltec V4 variant from the device list.
  4. Click Flash and grant serial port access when prompted.
  5. Wait for completion. Device reboots automatically.

Post-Flash Configuration

  1. Connect via Bluetooth app.
  2. Set region to US.
  3. Select the appropriate channel preset (MeshCore: USA/Canada; Meshtastic: US region).
  4. Configure solar charging settings if using a solar panel.

Known Quirks & Fixes

FEM (Front End Module) Self-Interference: The V4’s high-power front end module can cause RF self-interference. Two mitigations:
  • Wrap the PCB in electrical tape followed by aluminum foil (Faraday shielding).
  • Add a 915 MHz bandpass filter (JMT or Baymesh) on the antenna line.
rxgain on V4.3 (MeshCore v1.15.0+): MeshCore v1.15.0 enables rxgain by default on V4.3 hardware. This improves receive sensitivity but adds ~0.5 mA idle draw. If the device is power-critical (e.g., solar with limited panel), disable it via serial or Bluetooth:
set radio.rxgain off