Этот коммит содержится в:
Valentin V. Bartenev
2026-05-01 19:51:18 +03:00
коммит произвёл GitHub
родитель 89aec17b68
Коммит fe8e0556df
+39 -55
Просмотреть файл
@@ -1,78 +1,62 @@
# MeshCoreTel Firmware # Прошивка для MeshCore-репитеров с MQTT и веб-панелью
This is a fork of MeshCore-EastMesh firmware with MeshCoreTel broker support instead of EastMesh. Это форк прошивки [MeshCore-EastMesh](https://github.com/meshcore-dev/MeshCore), в котором поддержка австралийского сервиса телеметрии EastMesh AU заменена на поддержку сервиса [MeshCoreTel](https://meshcoretel.ru/), а также выполнен ряд других доработок и адаптация.
MeshCoreTel: В остальном прошивка базируется на официальных версиях прошивок МеshCore. Благодарность Scott Powell / Ripple Radios и всем контрибьюторам MeshCore за оригинальную прошивку и основу проекта, а также Jared Dohrman за доработки, выполненные в рамках EastMesh.
- <https://meshcoretel.ru/> ## Ключевые особенности прошивки
Original firmware (credits to Jared Dohrman, Scott Powell / Ripple Radios and the MeshCore contributors): ### Дополнения ретранслятора
- <https://github.com/xJARiD/MeshCore-EastMesh> - поддержка Wi-Fi в клиентском режиме
- автонастройка сети через DHCP
MeshCoreTel firmware builds for MeshCore, with MQTT repeaters, WiFi companions, and simple release downloads for supported boards. - синхронизация времени по NTP
- жёстко заданная поддержка MQTT-брокеров:
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.
## Key MeshCoreTel Features
### MQTT Repeater Additions
- hardcoded broker support for:
- `meshcoretel` - `meshcoretel`
- `letsmesh-eu` - `letsmesh-eu`
- `letsmesh-us` - `letsmesh-us`
- WSS transport at `/mqtt` - транспорт plain TCP и WSS по пути `/mqtt`
- JWT auth using the device identity - JWT-аутентификация с использованием идентификации устройства для WSS
- CLI controls for: - CLI-команды для:
- WiFi credentials - учётных данных WiFi
- WiFi powersaving - энергосбережения WiFi
- board battery reporting on supported targets - отчётов о заряде батареи на поддерживаемых платформах
- MQTT endpoint enablement - включения конечной точки MQTT
- MQTT packet and raw publishing - отправки пакетов MQTT и публикации сырых данных
- 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. Дополнительно на поддерживаемых устройствах (с достаточным количеством памяти) ретранслятор может предоставлять локальную панель конфигурации по HTTPS через WiFi.
Features include: Возможности:
- password-gated access using the existing repeater admin password - доступ по паролю, используя существующий административный пароль ретранслятора
- allowlisted CLI execution - выполнение CLI-команд из белого списка
- grouped quick actions - сгруппированные быстрые действия
- light and dark themes - светлая и тёмная темы
- optional disable via `set web off` - возможность отключения командой `set web off`
- изменение основных настроек репитера и MQTT через веб-интерфейс
- вся ключевая статистика по репитеру с историей за последние 3 часа
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. Для входа в адресной строке браузера введите `https://ip-адрес-репитера` и согласитесь с предупреждением принять самоподписной SSL-сертификат. Узнать IP-адрес можно на экране устройства или панели управления вашего роутера).
### Companion WiFi Additions Рекомендуется для начальной настройки и периодической диагностики. На развернутых MQTT-ретрансляторах отключайте панель после завершения настройки, если требуется максимальный запас памяти для MQTT.
`*_companion_radio_wifi` targets now support persisted WiFi rescue commands: ## Релизы
- open a serial monitor at `115200` baud Готовые прошивки публикуются на GitHub Releases:
- 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`: - <https://github.com/VBart/MeshCoreTel-firmware/releases>
- `get wifi.status` А также доступны в веб-прошивальщике от MeshCoreTel (под заголовком _Прошивки наблюдателя от VBart_):
- `get wifi.ssid`
- `get wifi.powersaving`
- `set wifi.ssid <ssid>`
- `set wifi.pwd <password>`
- `set wifi.powersaving none|min|max`
## Status - <https://meshcoretel.ru/ru/flasher>
Tested with my Heltec V4 OLED. ## Документация (TODO: перевод и адаптация)
## Documentation
Current docs pages:
- [Home](./docs/index.md) - [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) - [Custom CLI Commands](./docs/custom-cli.md)