Skip to content

Overview

Flash a Heltec WiFi LoRa 32 V4 with MeshCore Companion (Bluetooth), set the local radio preset, and prove the node is alive with the MeshCore app.

Heltec V4 in an open case with Quectel L76K GPS, LiFePO4 cell, and SMA antenna
Desk unit โ€” Heltec V4, Expansion Kit GPS, battery, SMA antenna.

Host note

Host-side checks and serial examples were done on Fedora. Flash and MeshCore config are the same elsewhere; package names, serial groups, and device paths may differ. Desk evidence for this guide used Companion BLE v1.17.1 on plain Heltec v4.

Path

  1. Prerequisites
  2. Identify the board
  3. Bootloader mode
  4. Flash firmware
  5. First boot
  6. Configure
  7. Phone app
  8. Verify

Stuck? Troubleshoot. Numbers and links: Reference.

Scope

This guide is Companion ยท Bluetooth on plain Heltec v4. Repeater and Room Server are different flasher roles โ€” not covered here beyond naming them on Flash / Reference.