Files
MeshCoreTel-firmware/README.md
T

68 строки
4.5 KiB
Markdown

# Прошивка MeshCore-репитеров с MQTT и веб-панелью
Это форк прошивки [MeshCore-EastMesh](https://github.com/meshcore-dev/MeshCore), в котором поддержка австралийского сервиса телеметрии 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 и публикации сырых данных
- публичного ключа владельца и адреса электронной почты
- включения локальной веб-панели
### Локальная веб-панель
Дополнительно на поддерживаемых устройствах (с достаточным количеством памяти) ретранслятор может предоставлять локальную панель конфигурации по HTTPS через WiFi.
Возможности:
- доступ по паролю, используя существующий административный пароль ретранслятора
- выполнение CLI-команд из белого списка
- сгруппированные быстрые действия
- светлая и тёмная темы
- возможность отключения командой `set web off`
- изменение основных настроек репитера и MQTT через веб-интерфейс
- вся ключевая статистика по репитеру с историей за последние 3 часа
Для входа в адресной строке браузера введите `https://ip-адрес-репитера` и согласитесь с предупреждением принять самоподписной SSL-сертификат. Узнать IP-адрес можно на экране устройства или панели управления вашего роутера).
Рекомендуется для начальной настройки и периодической диагностики. На развернутых MQTT-ретрансляторах отключайте панель после завершения настройки, если требуется максимальный запас памяти для MQTT.
## Релизы
Готовые прошивки публикуются на GitHub Releases:
- <https://github.com/VBart/MeshCoreTel-firmware/releases>
А также доступны в веб-прошивальщике от MeshCoreTel:
- <https://meshcoretel.ru/ru/flasher> (под заголовком _Прошивки наблюдателя от VBart_)
## Документация (TODO: перевод и адаптация)
Опубликованный сайт документации:
- <https://vbart.github.io/MeshCoreTel-firmware/>
Текущие страницы документации на GitHub:
- [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)