From 452ac4f9a5fd654e73f488734ac2db88be5fa9c5 Mon Sep 17 00:00:00 2001 From: Jared Dohrman Date: Wed, 6 May 2026 17:01:52 +1000 Subject: [PATCH 1/2] chore: workflow housekeeping --- .github/workflows/eastmesh-build-companion-wifi-firmwares.yml | 4 ++-- .../eastmesh-build-repeater-bridge-espnow-firmwares.yml | 4 ++-- .../eastmesh-build-repeater-mqtt-bridge-firmwares.yml | 4 ++-- .github/workflows/eastmesh-build-repeater-mqtt-firmwares.yml | 4 ++-- 4 files changed, 8 insertions(+), 8 deletions(-) diff --git a/.github/workflows/eastmesh-build-companion-wifi-firmwares.yml b/.github/workflows/eastmesh-build-companion-wifi-firmwares.yml index 7cee5f71..4f2cf517 100644 --- a/.github/workflows/eastmesh-build-companion-wifi-firmwares.yml +++ b/.github/workflows/eastmesh-build-companion-wifi-firmwares.yml @@ -7,7 +7,7 @@ on: workflow_dispatch: push: tags: - - 'companion-wifi-v*' + - "companion-wifi-v*" jobs: @@ -33,7 +33,7 @@ jobs: path: out - name: Create Release - uses: softprops/action-gh-release@v2 + uses: softprops/action-gh-release@v3 if: startsWith(github.ref, 'refs/tags/') with: name: Companion WiFi Firmware ${{ env.RELEASE_VERSION }} diff --git a/.github/workflows/eastmesh-build-repeater-bridge-espnow-firmwares.yml b/.github/workflows/eastmesh-build-repeater-bridge-espnow-firmwares.yml index cc3e8cc2..716b512c 100644 --- a/.github/workflows/eastmesh-build-repeater-bridge-espnow-firmwares.yml +++ b/.github/workflows/eastmesh-build-repeater-bridge-espnow-firmwares.yml @@ -7,7 +7,7 @@ on: workflow_dispatch: push: tags: - - 'repeater-bridge-espnow-v*' + - "repeater-bridge-espnow-v*" jobs: @@ -33,7 +33,7 @@ jobs: path: out - name: Create Release - uses: softprops/action-gh-release@v2 + uses: softprops/action-gh-release@v3 if: startsWith(github.ref, 'refs/tags/') with: name: Repeater ESP-NOW Bridge Firmware ${{ env.RELEASE_VERSION }} diff --git a/.github/workflows/eastmesh-build-repeater-mqtt-bridge-firmwares.yml b/.github/workflows/eastmesh-build-repeater-mqtt-bridge-firmwares.yml index 29c1b472..cced8d37 100644 --- a/.github/workflows/eastmesh-build-repeater-mqtt-bridge-firmwares.yml +++ b/.github/workflows/eastmesh-build-repeater-mqtt-bridge-firmwares.yml @@ -7,7 +7,7 @@ on: workflow_dispatch: push: tags: - - 'repeater-mqtt-bridge-eastmesh-*' + - "repeater-mqtt-bridge-eastmesh-*" jobs: @@ -34,7 +34,7 @@ jobs: path: out - name: Create Release - uses: softprops/action-gh-release@v2 + uses: softprops/action-gh-release@v3 if: startsWith(github.ref, 'refs/tags/') with: name: Repeater MQTT Bridge Firmware ${{ env.RELEASE_VERSION }} diff --git a/.github/workflows/eastmesh-build-repeater-mqtt-firmwares.yml b/.github/workflows/eastmesh-build-repeater-mqtt-firmwares.yml index 49e64a6c..252e24a0 100644 --- a/.github/workflows/eastmesh-build-repeater-mqtt-firmwares.yml +++ b/.github/workflows/eastmesh-build-repeater-mqtt-firmwares.yml @@ -7,7 +7,7 @@ on: workflow_dispatch: push: tags: - - 'repeater-mqtt-eastmesh-*' + - "repeater-mqtt-eastmesh-*" jobs: @@ -34,7 +34,7 @@ jobs: path: out - name: Create Release - uses: softprops/action-gh-release@v2 + uses: softprops/action-gh-release@v3 if: startsWith(github.ref, 'refs/tags/') with: name: Repeater MQTT Firmware ${{ env.RELEASE_VERSION }} From e376f885ee0e6fab1e4d537388653b27cb0e6711 Mon Sep 17 00:00:00 2001 From: Jared Dohrman Date: Fri, 8 May 2026 11:10:58 +1000 Subject: [PATCH 2/2] docs: add clarification surrounding bridge and mqtt --- eastmesh-docs/index.md | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) diff --git a/eastmesh-docs/index.md b/eastmesh-docs/index.md index 438bc502..a9d2ac42 100644 --- a/eastmesh-docs/index.md +++ b/eastmesh-docs/index.md @@ -1,15 +1,23 @@ # MeshCore EastMesh Docs -MeshCore-EastMesh keeps the upstream MeshCore firmware intact and adds an EastMesh layer on top for: +MeshCore-EastMesh keeps the upstream MeshCore firmware intact and publishes four firmware tracks, depending on how the device needs to connect: -- `repeater_mqtt` builds with native WiFi, MQTT, and the optional local web panel -- `companion_radio_wifi` builds for Wi-Fi-connected companion devices -- EastMesh-specific release automation and versioning on top of upstream MeshCore releases +- `companion-wifi`: use this for Wi-Fi-connected companion devices. It stays closest to upstream MeshCore and adds the EastMesh Wi-Fi rescue/configuration commands. +- `repeater-bridge-espnow`: use this when you need a plain upstream-style repeater ESP-NOW bridge without MQTT uplink or the EastMesh web panel. +- `repeater-mqtt`: use this for a Wi-Fi repeater that should publish to an MQTT broker and, on supported ESP32 boards, offer the optional local web panel for setup and troubleshooting. +- `repeater-mqtt-bridge`: use this when one repeater needs both MQTT uplink and ESP-NOW bridge duties, including bridge channel/secret controls for keeping the bridge aligned with Wi-Fi. + +!!! note "Bridge tracks are local radio bridges" + + The bridge tracks are for bridging two nearby repeaters that operate on different MeshCore radio configs, for example one repeater on `Australia (Narrow)` and another on `Australia (Mid)`. + + They are not MQTT-over-WAN, VPN, or internet bridge releases. MQTT is still the uplink/visibility path for MQTT firmware; it is not used to tunnel mesh traffic between distant sites. If you are just trying to pick a board or download firmware, start with: - [Compare Boards](./boards.md) - [Download and Flash Releases](./releases.md) +- [Flash NOW!](https://flasher.eastmesh.au) ## End User Guides