Skip to content

Getting started

Flash firmware

The easiest way is the MeshCoreNG web flasher.

The web flasher lets you choose the firmware type, board variant, and firmware release version. The newest release is selected by default, but older published versions remain available when release assets exist for that board.

ESP32-family boards flash from merged .bin files using Web Serial. nRF52 boards can use serial DFU .zip assets when the release provides them. RP2040, STM32 and other download-only targets still use their normal firmware files and tools.

See Web flasher for asset naming, supported families and download-only behavior.

Connect a client

MeshCoreNG uses the same protocol as MeshCore. Use any existing MeshCore client:

Start with defaults

The default settings are safe for any network. You do not need to change anything to get a working repeater.

When you want to tune behavior, start with Dense mesh and check get dense.stats to understand what is happening on your network before changing anything.

For dense deployments, also review Regions before connecting multiple towns, provinces or bridge groups.

Developer setup

  1. Install PlatformIO in Visual Studio Code.
  2. Clone the MeshCoreNG repository.
  3. Open the repository in Visual Studio Code.
  4. Select a build environment for your board (e.g. Heltec_v3_repeater).
  5. Build and upload.

Released under the MIT License.