All firmwares

EastMesh

Fork

EastMesh firmware builds for MeshCore, with MQTT repeaters, WiFi companions, and simple release downloads for supported boards. Features an optional local HTTPS config panel on supported ESP32 targets, JWT auth using device identity, and battery reporting.

Fork of MeshCore (Reference)

Maintainer
xJARiD ↗
Status
Active
Maturity
Beta
Lifecycle
Active
Latest version
2026.7.0
Released
2026-07-19
Runtime
Arduino · C++
Distribution
Community
Licensing
Open source
License
MIT

Capabilities

Transports

  • BLE
  • USB serial
  • Native TCP
  • Wi-Fi AP

Operations

  • Web flasher
  • OTA updates

Networking

  • Repeater
  • Room server
  • Observer
  • MQTT
  • KISS modem

Hardware

  • GPS
  • Display
  • Sensors
  • Low-power RX

Protocol

  • MeshCore compatible

Node role

CompanionRepeaterObserver

Features

  • MQTT repeater builds
  • WiFi companion builds
  • Optional local HTTPS config panel (ESP32)
  • JWT auth using device identity
  • Battery reporting on supported targets
  • Observer role support

Project signals

popularity 2026-08-05 verification 2026-08-05
GitHub stars
23
Forks
8
Watchers
2
Open issues
1
Contributors
179
Release downloads
5,522
Latest downloads
128
Source available
Yes
Releases available
Yes
CI builds
Yes

Releases

from GitHub · updated 2026-07-19
  1. v2026.7.0 # Latest 2 variants 17 days ago · 2026-07-19 04:09 UTC
    observer eastmesh observer-eastmesh-v2026.7.0 View ↗
    observer eastmesh bridge espnow observer-eastmesh-bridge-espnow-v2026.7.0 View ↗

    MeshCore EastMesh Observer

    EastMesh observer-eastmesh firmware for MeshCore boards with secure MQTT uplink and optional local web management, based on MeshCore firmware v1.16.0 plus upstream dev updates (as of 2026-07-09).

    This release syncs with upstream MeshCore dev — bringing power-off/deep-sleep improvements, SX1262 LDO support, hardware channel-activity detection, and board/platform fixes — realigns saved settings storage with upstream so future syncs can't shift or corrupt EastMesh settings, and restores EastMesh/MeshMapper broker TLS trust after a server-side certificate change.

    What's Changed

    • Merged upstream MeshCore dev updates including power-off/deep-sleep improvements, SX1262 LDO support, hardware channel-activity detection, radio gain fixes, and board/platform fixes.
    • Realigned saved node settings to upstream byte offsets and moved EastMesh-specific fields behind a reserved gap so future upstream syncs no longer shift or corrupt them.
    • Restored EastMesh and MeshMapper broker TLS trust after mqtt2.eastmesh.au moved from Let's Encrypt to a Google Trust Services certificate.
    • Bumped CI build and docs workflows to Python 3.13.

    Breaking Changes

    • The saved settings layout changed: devices upgrading from 2026.6.6 or earlier may need EastMesh-specific settings (such as fan control and bridge peer) and recently added radio settings reconfigured after the update.

    Notes

    • If your observer stopped uplinking to eastmesh-au or meshmapper with TLS certificate errors, this release is the fix — update and the connection will recover on its own.
    • After updating, check your fan control, bridge peer, and recently added radio settings (see Breaking Changes) and re-set any that came back at defaults.
    • eastmesh-au remains the recommended MQTT endpoint once mqtt.iata is configured; meshmapper and waev are available as global second brokers.
    • Select brokers from the Primary and Secondary dropdowns in the web panel, or toggle them from the CLI (set mqtt.eastmesh-au on, set mqtt.meshmapper on, set mqtt.waev on, etc.). A maximum of two brokers can be enabled at once.
    • waev (mqtt.waev.app) uses a 1-hour auth token that the firmware refreshes automatically, so no extra configuration is needed. Set your Waev account email with set mqtt.email <email> so Waev can link the observer to your account.
    • MQTT status messages report cumulative packets_sent and packets_received alongside the existing radio stats; both counters reset on reboot.
    • LetsMesh EU/US are retired but still selectable for legacy use.
    • Custom MQTT is available for private broker deployments and uses username/password auth only. For TCP custom MQTT, use the broker host and port as before. For WSS custom MQTT, set the host and port, select WSS transport, and the firmware connects using wss://host:port/mqtt.
    • WSS uses TLS encryption and validates against the ESP-IDF x509 root CA bundle.
    • For maximum heap headroom on busy observers, use the web panel for setup and troubleshooting, then disable it with set web off.
    • Browsers may still require accepting the self-signed certificate warning on first HTTPS access.
    • flood.max.unscoped defaults to 64; lower it only if you want to limit how far unscoped flood traffic repeats.
    • flood.max.advert controls the hop limit for flooded advert packets.

    Documentation

    xjarid.github.io/MeshCore-EastMesh

    Flashing

    Assets

    • .bin - standard update image
    • -merged.bin - full ESP32 image for flashing after erase
  2. v2026.6.6 # 2 variants 1 month ago · 2026-06-27 13:12 UTC
    observer eastmesh observer-eastmesh-v2026.6.6 View ↗
    observer eastmesh bridge espnow observer-eastmesh-bridge-espnow-v2026.6.6 View ↗

    MeshCore EastMesh Observer

    EastMesh observer-eastmesh firmware for MeshCore boards with secure MQTT uplink and optional local web management, based on MeshCore firmware v1.16.0.

    This release adds packet counters to the MQTT status payload — each observer now reports cumulative packets_sent and packets_received totals in its status message — so brokers and dashboards such as Waev and MeshMapper can track per-node throughput.

    What's Changed

    • Added packets_sent and packets_received counters to the MQTT status payload stats object, reporting cumulative radio TX/RX packet totals to align with the Waev/MeshMapper status schema.

    Breaking Changes

    • None in this release.

    Notes

    • eastmesh-au remains the recommended MQTT endpoint once mqtt.iata is configured; meshmapper and waev are available as global second brokers.
    • Select brokers from the Primary and Secondary dropdowns in the web panel, or toggle them from the CLI (set mqtt.eastmesh-au on, set mqtt.meshmapper on, set mqtt.waev on, etc.). A maximum of two brokers can be enabled at once.
    • waev (mqtt.waev.app) uses a 1-hour auth token that the firmware refreshes automatically, so no extra configuration is needed. Set your Waev account email with set mqtt.email <email> so Waev can link the observer to your account.
    • MQTT status messages now report cumulative packets_sent and packets_received alongside the existing radio stats; both counters reset on reboot.
    • LetsMesh EU/US are retired but still selectable for legacy use.
    • Custom MQTT is available for private broker deployments and uses username/password auth only. For TCP custom MQTT, use the broker host and port as before. For WSS custom MQTT, set the host and port, select WSS transport, and the firmware connects using wss://host:port/mqtt.
    • WSS uses TLS encryption and validates against the ESP-IDF x509 root CA bundle.
    • For maximum heap headroom on busy observers, use the web panel for setup and troubleshooting, then disable it with set web off.
    • Browsers may still require accepting the self-signed certificate warning on first HTTPS access.
    • flood.max.unscoped defaults to 64; lower it only if you want to limit how far unscoped flood traffic repeats.
    • flood.max.advert controls the hop limit for flooded advert packets.

    Documentation

    xjarid.github.io/MeshCore-EastMesh

    Flashing

    Assets

    • .bin - standard update image
    • -merged.bin - full ESP32 image for flashing after erase
  3. v2026.6.5 # 2 variants 1 month ago · 2026-06-26 02:52 UTC
    observer eastmesh observer-eastmesh-v2026.6.5 View ↗
    observer eastmesh bridge espnow observer-eastmesh-bridge-espnow-v2026.6.5 View ↗

    MeshCore EastMesh Observer

    EastMesh observer-eastmesh firmware for MeshCore boards with secure MQTT uplink and optional local web management, based on MeshCore firmware v1.16.0.

    This release adds the Waev curated broker as a selectable MQTT uplink — with automatic short-lived auth tokens to satisfy Waev's requirements — and widens the Custom MQTT settings panel in the web panel.

    What's Changed

    • Added the waev curated broker (wss://mqtt.waev.app:443/mqtt) using WSS, verified TLS, and MeshCore JWT authentication with the broker host as the token audience.
    • Added get mqtt.waev and set mqtt.waev on|off to toggle the Waev broker, and added Waev to the Primary MQTT and Secondary MQTT dropdowns in the web panel.
    • Added per-broker JWT auth token lifetimes; Waev receives a 1-hour token to match its shorter maximum token lifetime, while the other brokers keep the existing lifetime.
    • Fixed the web panel so the Custom MQTT settings panel spans the full width of the MQTT Servers card when Custom is selected.
    • Updated the README and custom CLI guides for the Waev broker.

    Breaking Changes

    • None in this release.

    If you are upgrading from before 2026.6.4, that release's changes still apply: get mqtt.status switched from per-broker fields to p:/s: broker slots, and saved LetsMesh EU/US selections are cleared once on upgrade.

    Notes

    • eastmesh-au remains the recommended MQTT endpoint once mqtt.iata is configured; meshmapper and waev are available as global second brokers.
    • Select brokers from the Primary and Secondary dropdowns in the web panel, or toggle them from the CLI (set mqtt.eastmesh-au on, set mqtt.meshmapper on, set mqtt.waev on, etc.). A maximum of two brokers can be enabled at once.
    • waev (mqtt.waev.app) uses a 1-hour auth token that the firmware refreshes automatically, so no extra configuration is needed. Set your Waev account email with set mqtt.email <email> so Waev can link the observer to your account.
    • LetsMesh EU/US are retired but still selectable for legacy use.
    • Custom MQTT is available for private broker deployments and uses username/password auth only. For TCP custom MQTT, use the broker host and port as before. For WSS custom MQTT, set the host and port, select WSS transport, and the firmware connects using wss://host:port/mqtt.
    • WSS uses TLS encryption and validates against the ESP-IDF x509 root CA bundle.
    • For maximum heap headroom on busy observers, use the web panel for setup and troubleshooting, then disable it with set web off.
    • Browsers may still require accepting the self-signed certificate warning on first HTTPS access.
    • flood.max.unscoped defaults to 64; lower it only if you want to limit how far unscoped flood traffic repeats.
    • flood.max.advert controls the hop limit for flooded advert packets.

    Documentation

    xjarid.github.io/MeshCore-EastMesh

    Flashing

    Assets

    • .bin - standard update image
    • -merged.bin - full ESP32 image for flashing after erase
Show all 10 releases →

Device compatibility (1)

✓ 1 Supported
DeviceMCURadioStatusNotes
Heltec V4esp32-s3Semtech SX1262✓ Supported