# Прошивка для 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 (под заголовком _Прошивки наблюдателя от VBart_):

- <https://meshcoretel.ru/ru/flasher>

## Документация (TODO: перевод и адаптация)

- [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)