85 строки
6.0 KiB
Markdown
85 строки
6.0 KiB
Markdown
# Прошивка MeshCore-репитеров с WEB и MQTT
|
|
|
|
Это форк прошивки [MeshCore-EastMesh](https://github.com/xJARiD/MeshCore-EastMesh), в котором поддержка австралийского сервиса телеметрии EastMesh AU заменена на поддержку сервиса [MeshCoreTel](https://meshcoretel.ru/), а также выполнен ряд других доработок и адаптация.
|
|
|
|
В остальном прошивка базируется на официальных версиях прошивок МеshCore. Благодарность Scott Powell / Ripple Radios и всем контрибьюторам MeshCore за оригинальную прошивку и основу проекта, а также Jared Dohrman за доработки, выполненные в рамках EastMesh.
|
|
|
|
## Ключевые особенности прошивки
|
|
|
|
### Дополнения ретранслятора
|
|
|
|
- поддержка Wi-Fi в клиентском режиме
|
|
- автонастройка сети через DHCP
|
|
- синхронизация времени по NTP
|
|
- поддержка MQTT-брокеров:
|
|
- `meshcoretel`
|
|
- `letsmesh-eu`
|
|
- `letsmesh-us`
|
|
- транспорт plain TCP и WSS по пути `/mqtt`
|
|
- JWT-аутентификация с использованием идентификации устройства для WSS
|
|
- CLI-команды для:
|
|
- учётных данных WiFi
|
|
- энергосбережения WiFi
|
|
- отчётов о заряде батареи на поддерживаемых платформах
|
|
- включения конечной точки MQTT
|
|
- отправки пакетов MQTT и публикации сырых данных
|
|
- публичного ключа владельца и адреса электронной почты
|
|
- включения локальной веб-панели
|
|
- управления вентилятором на TBeam 1W
|
|
- все сетевые процессы (включая обработку MQTT и веб-панели) вынесены на отдельное ядро и не вносят задержек в обработку LoRa-пакетов и функционирование ретранслятора
|
|
|
|
### Локальная веб-панель
|
|
<img align="right" width=128 src="docs/_assets/repeater_web_panel_stats_light.webp">
|
|
<img align="right" width=128 src="docs/_assets/repeater_web_panel_app_light.webp">
|
|
Дополнительно на поддерживаемых устройствах (с достаточным количеством памяти) ретранслятор может предоставлять локальную панель конфигурации по HTTPS через WiFi.
|
|
|
|
#### Возможности:
|
|
|
|
- доступ по паролю, используя существующий административный пароль ретранслятора
|
|
- выполнение CLI-команд
|
|
- изменение основных настроек репитера и MQTT через веб-интерфейс
|
|
- сгруппированные быстрые действия
|
|
- вся ключевая статистика по репитеру
|
|
- список последних услышанных соседий с показателями качества сигнала
|
|
- хранение истории показателей за последние несколько часов (только на устройствах с PSRAM)
|
|
- светлая и тёмная темы
|
|
- возможность отключения командой `set web off`
|
|
|
|
Подробнее в документации: [Использование веб-панели ретранслятора](https://vbart.github.io/MeshCoreTel-firmware/web-panel/)
|
|
|
|
### Веб-API по HTTPS
|
|
|
|
На устройствах с поддержкой веб-панели также возможно использование встроенного API по Wi-Fi.
|
|
|
|
#### Возможности:
|
|
|
|
- авторизация по паролю администратора с получением временного токена
|
|
- выполнение любых CLI-команд для управления, настройки и статуса
|
|
- получение всей доступной телеметрии
|
|
|
|
Данный API может быть использован для мониторинга с хранением долгосрочной истории (например с использованием таких инструментов как Prometheus и Grafana), а также автонастройки и управления устройством с помощью скриптов.
|
|
|
|
Подробнее в документации: [Использование веб-API ретранслятора](https://vbart.github.io/MeshCoreTel-firmware/api/)
|
|
|
|
## Релизы
|
|
|
|
Готовые прошивки публикуются на GitHub Releases:
|
|
|
|
- <https://github.com/VBart/MeshCoreTel-firmware/releases>
|
|
|
|
А также доступны в веб-прошивальщике от MeshCoreTel:
|
|
|
|
- <https://meshcoretel.ru/ru/flasher> (под заголовком _Прошивки наблюдателя от VBart_)
|
|
|
|
## Документация
|
|
|
|
- <https://vbart.github.io/MeshCoreTel-firmware/>
|
|
|
|
Основные разделы пользовательского руководства:
|
|
|
|
- [Сравнение устройств](https://vbart.github.io/MeshCoreTel-firmware/boards/)
|
|
- [Загрузка и прошивка релизов](https://vbart.github.io/MeshCoreTel-firmware/releases/)
|
|
- [Использование веб-панели ретранслятора](https://vbart.github.io/MeshCoreTel-firmware/web-panel/)
|
|
- [Использование веб-API ретранслятора](https://vbart.github.io/MeshCoreTel-firmware/api/)
|
|
- [Пользовательские команды CLI](https://vbart.github.io/MeshCoreTel-firmware/custom-cli/)
|