Removed EastMesh MQTT broker support.
It's intended for Eastern Australia repeaters only. Using original EastMesh firmware is prefered in this case.
Tento commit je obsažen v:
+9
-81
@@ -1,64 +1,25 @@
|
||||
# MeshCore-EastMesh-MeshCoreTel
|
||||
# MeshCoreTel Firmware
|
||||
|
||||
This is a fork of MeshCore-EastMesh firmware with MeshCoreTel broker support.
|
||||
|
||||
Original firmware (credits to Jared Dohrman, Scott Powell / Ripple Radios and the MeshCore contributors):
|
||||
|
||||
- <https://github.com/xJARiD/MeshCore-EastMesh>
|
||||
This is a fork of MeshCore-EastMesh firmware with MeshCoreTel broker support instead of EastMesh.
|
||||
|
||||
MeshCoreTel:
|
||||
|
||||
- <https://meshcoretel.ru/>
|
||||
|
||||
EastMesh firmware builds for MeshCore, with MQTT repeaters, WiFi companions, and simple release downloads for supported boards.
|
||||
Original firmware (credits to Jared Dohrman, Scott Powell / Ripple Radios and the MeshCore contributors):
|
||||
|
||||
This repository keeps the upstream MeshCore firmware intact and adds an EastMesh layer on top for packaging, release automation, WiFi-enabled companion builds, and MQTT-enabled repeater builds.
|
||||
- <https://github.com/xJARiD/MeshCore-EastMesh>
|
||||
|
||||
Additinally, the MeshCoreTel broker added in this fork.
|
||||
MeshCoreTel firmware builds for MeshCore, with MQTT repeaters, WiFi companions, and simple release downloads for supported boards.
|
||||
|
||||
## What This Repo Adds
|
||||
This repository keeps the upstream MeshCore firmware intact and adds an MeshCoreTel layer on top for packaging, release automation, WiFi-enabled companion builds, and MQTT-enabled repeater builds.
|
||||
|
||||
- `*_repeater_mqtt` firmware targets with:
|
||||
- native WiFi
|
||||
- MQTT over WSS with JWT auth or over plain TCP (for MeshCoreTel support)
|
||||
- optional local HTTPS config panel on supported ESP32 targets
|
||||
- `*_companion_radio_wifi` firmware targets for WiFi-connected companion devices
|
||||
- EastMesh-specific release workflows and versioning on top of upstream MeshCore releases
|
||||
- docs and release guidance for EastMesh users instead of the full upstream MeshCore docs set
|
||||
|
||||
## Status
|
||||
|
||||
I've tested it only with my Heltec V4.
|
||||
|
||||
## Key Files
|
||||
|
||||
- [`build.sh`](./build.sh)
|
||||
- main local build wrapper
|
||||
- injects `FIRMWARE_VERSION`, `CLIENT_VERSION`, and EastMesh release metadata
|
||||
- [`pyproject.toml`](./pyproject.toml)
|
||||
- Python tooling and docs dependencies
|
||||
- [`platformio.ini`](./platformio.ini)
|
||||
- root PlatformIO config and ESP32 helper scripts
|
||||
- [`variants/eastmesh_mqtt/platformio.ini`](./variants/eastmesh_mqtt/platformio.ini)
|
||||
- shared EastMesh MQTT repeater env definitions
|
||||
- [`examples/simple_repeater/MyMesh.cpp`](./examples/simple_repeater/MyMesh.cpp)
|
||||
- repeater CLI wiring, MQTT command surface, and web allowlist integration
|
||||
- [`src/helpers/mqtt/MQTTUplink.cpp`](./src/helpers/mqtt/MQTTUplink.cpp)
|
||||
- MQTT uplink implementation, HTTPS web panel, WSS/JWT handling, and repeater WiFi control
|
||||
- [`examples/companion_radio`](./examples/companion_radio)
|
||||
- companion firmware implementation
|
||||
- [`RELEASE.md`](./RELEASE.md)
|
||||
- tag formats and release workflow behavior
|
||||
- [`docs/`](./docs)
|
||||
- EastMesh-focused docs published to GitHub Pages
|
||||
|
||||
## Key EastMesh Features
|
||||
## Key MeshCoreTel Features
|
||||
|
||||
### MQTT Repeater Additions
|
||||
|
||||
- hardcoded broker support for:
|
||||
- `meshcoretel`
|
||||
- `eastmesh-au`
|
||||
- `letsmesh-eu`
|
||||
- `letsmesh-us`
|
||||
- WSS transport at `/mqtt`
|
||||
@@ -105,46 +66,13 @@ These rescue commands are only available after entering `CLI Rescue`:
|
||||
- `set wifi.pwd <password>`
|
||||
- `set wifi.powersaving none|min|max`
|
||||
|
||||
## Active GitHub Workflows
|
||||
## Status
|
||||
|
||||
- `.github/workflows/build-companion-wifi-firmwares.yml`
|
||||
- `.github/workflows/build-repeater-mqtt-firmwares.yml`
|
||||
- `.github/workflows/pr-build-check.yml`
|
||||
- `.github/workflows/push-build-check.yml`
|
||||
- `.github/workflows/github-pages.yml`
|
||||
|
||||
The current release workflows intentionally focus only on:
|
||||
|
||||
- `companion-wifi`
|
||||
- `repeater-mqtt`
|
||||
|
||||
## Release Tags
|
||||
|
||||
Current release tags are:
|
||||
|
||||
```bash
|
||||
git tag companion-wifi-v1.14.1
|
||||
git tag repeater-mqtt-eastmesh-v1.0.1
|
||||
```
|
||||
|
||||
Companion WiFi uses the upstream MeshCore version in the tag.
|
||||
|
||||
Repeater MQTT uses:
|
||||
|
||||
- `OFFICIAL_MESHCORE_VERSION` from GitHub Actions variables as `FIRMWARE_VERSION`
|
||||
- the EastMesh tag version as `EASTMESH_VERSION`
|
||||
|
||||
See [RELEASE.md](./RELEASE.md) for the full release flow.
|
||||
Tested with my Heltec V4 OLED.
|
||||
|
||||
## Documentation
|
||||
|
||||
Published docs site:
|
||||
|
||||
- <https://xjarid.github.io/MeshCore-EastMesh/>
|
||||
|
||||
Current docs pages:
|
||||
|
||||
- [Home](./docs/index.md)
|
||||
- [Download and Flash Releases](./docs/releases.md)
|
||||
- [Build Locally With uv](./docs/local-builds.md)
|
||||
- [Custom CLI Commands](./docs/custom-cli.md)
|
||||
|
||||
Odkázat v novém úkolu
Zablokovat Uživatele