Skip to main content

Heltec V3 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 V3 (WiFi LoRa 32 V3) — Setup Guide

The Heltec V3 is widely regarded as the best beginner board in the LoRa mesh ecosystem. It combines an ESP32-S3 MCU with an SX1262 radio and a built-in OLED display, making it easy to monitor status at a glance without a phone.

Specifications

AttributeValue
MCUESP32-S3
RadioSX1262
Max TX Power21 dBm (~125 mW)
Display0.96" OLED
USBUSB-C
BatteryLiPo connector (battery not included)
Price$20–30
StrengthsBest beginner board, OLED status display, widely supported
WeaknessesHigher power draw than nRF52 boards; no GPS

Driver Installation

The Heltec V3 uses a CP210x USB-to-UART bridge.

  • Windows: Download the CP210x driver from the Silicon Labs website (silabs.com). Install and reboot if prompted. The device will appear as a COM port in Device Manager.
  • macOS & Linux: Driver is built in — no installation required. The device appears automatically as a serial port (/dev/ttyUSB0 or /dev/cu.usbserial-*).

Entering Bootloader / DFU Mode

You must place the device into bootloader mode before the web flasher can program it.

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

  1. Unplug the USB cable.
  2. Hold the BOOT button.
  3. Plug in the USB cable while continuing to hold BOOT.
  4. Hold for 1–2 seconds after the cable is connected, then release BOOT.

Method 2 — From powered-on state:

  1. Hold the BOOT button.
  2. While holding BOOT, briefly press and release the RST button.
  3. Release the BOOT button.

The OLED will go blank when the device is in bootloader mode. This is normal.

Firmware Flashing

Use a Chromium-based browser (Chrome or Edge) — Firefox does not support WebSerial.

  1. Enter bootloader mode (see above).
  2. Navigate to your preferred flasher:
  3. Select Heltec WiFi LoRa 32 V3 from the device list.
  4. Select your desired firmware variant.
  5. Click Flash and grant the browser permission to access the serial port when prompted.
  6. Wait for the flash to complete — do not disconnect during this process.
  7. The device will reboot automatically when flashing is done.

Post-Flash Configuration

  1. Connect to the device via the Bluetooth app (MeshCore or Meshtastic app on your phone).
  2. Set your region to US (required for legal operation on 915 MHz).
  3. MeshCore: Select the USA/Canada channel preset.
  4. Meshtastic: Set region to US in the Radio Config → LoRa section.
  5. Set your node name and any other desired settings.

Known Quirks & Fixes

Bluetooth Antenna Issue: The stock PCB Bluetooth antenna causes Bluetooth dropouts at range. Fix: Replace it with a 31 mm bare wire antenna soldered directly to the BT antenna pad on the PCB. This significantly improves Bluetooth range and reliability.

No comments to display

Back to top