Форк репозитария VBart для meshcoretel.ru с моими добавками
Valentin V. Bartenev
64cebbc750
Updated readme and licence for this fork.
|
3 달 전 | |
|---|---|---|
| .devcontainer | 4 달 전 | |
| .github | 3 달 전 | |
| .vscode | 1 년 전 | |
| arch | 3 달 전 | |
| bin | 1 년 전 | |
| boards | 3 달 전 | |
| docs | 3 달 전 | |
| examples | 3 달 전 | |
| include | 1 년 전 | |
| lib | 1 년 전 | |
| logo | 1 년 전 | |
| src | 3 달 전 | |
| variants | 3 달 전 | |
| .clang-format | 1 년 전 | |
| .envrc | 1 년 전 | |
| .gitignore | 4 달 전 | |
| .python-version | 4 달 전 | |
| AGENTS.md | 3 달 전 | |
| CONTRIBUTING.md | 4 달 전 | |
| README.md | 3 달 전 | |
| RELEASE.md | 3 달 전 | |
| build.sh | 4 달 전 | |
| build_as_lib.py | 11 달 전 | |
| create-uf2.py | 9 달 전 | |
| default.nix | 1 년 전 | |
| library.json | 4 달 전 | |
| license.txt | 3 달 전 | |
| merge-bin.py | 1 년 전 | |
| mkdocs.yml | 3 달 전 | |
| platformio.ini | 3 달 전 | |
| pyproject.toml | 4 달 전 | |
| release-notes.yml | 3 달 전 | |
| uv.lock | 4 달 전 |
README.md
MeshCore-EastMesh-MeshCoreTel
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):
MeshCoreTel:
EastMesh firmware builds for MeshCore, with MQTT repeaters, WiFi companions, and simple release downloads for supported boards.
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.
Additinally, the MeshCoreTel broker added in this fork.
What This Repo Adds
*_repeater_mqttfirmware 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_wififirmware 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- main local build wrapper
- injects
FIRMWARE_VERSION,CLIENT_VERSION, and EastMesh release metadata
pyproject.toml- Python tooling and docs dependencies
platformio.ini- root PlatformIO config and ESP32 helper scripts
variants/eastmesh_mqtt/platformio.ini- shared EastMesh MQTT repeater env definitions
examples/simple_repeater/MyMesh.cpp- repeater CLI wiring, MQTT command surface, and web allowlist integration
src/helpers/mqtt/MQTTUplink.cpp- MQTT uplink implementation, HTTPS web panel, WSS/JWT handling, and repeater WiFi control
examples/companion_radio- companion firmware implementation
RELEASE.md- tag formats and release workflow behavior
docs/- EastMesh-focused docs published to GitHub Pages
Key EastMesh Features
MQTT Repeater Additions
- hardcoded broker support for:
meshcoreteleastmesh-auletsmesh-euletsmesh-us
- WSS transport at
/mqtt - JWT auth using the device identity
- CLI controls for:
- WiFi credentials
- WiFi powersaving
- board battery reporting on supported targets
- MQTT endpoint enablement
- MQTT packet and raw publishing
- owner public key and email
- local web panel enablement
Local Web Panel
On supported *_repeater_mqtt ESP32 targets, the repeater can expose a local HTTPS config panel over WiFi.
Features include:
- password-gated access using the existing repeater admin password
- allowlisted CLI execution
- grouped quick actions
- light and dark themes
- optional disable via
set web off
Recommended use is initial setup and occasional troubleshooting. On MQTT repeater deployments, disable the panel again when finished if you want maximum MQTT heap headroom.
Companion WiFi Additions
*_companion_radio_wifi targets now support persisted WiFi rescue commands:
- open a serial monitor at
115200baud - reboot the device
- long-press the user button within the first 8 seconds after boot to enter
CLI Rescue - wait for
========= CLI Rescue ========= - send the commands from the serial monitor
These rescue commands are only available after entering CLI Rescue:
get wifi.statusget wifi.ssidget wifi.powersavingset wifi.ssid <ssid>set wifi.pwd <password>set wifi.powersaving none|min|max
Active GitHub Workflows
.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-wifirepeater-mqtt
Release Tags
Current release tags are:
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_VERSIONfrom GitHub Actions variables asFIRMWARE_VERSION- the EastMesh tag version as
EASTMESH_VERSION
See RELEASE.md for the full release flow.
Documentation
Published docs site:
Current docs pages: