shade
71f7095d17
- добавлен локальный мастер настройки репитера: examples/simple_repeater/UITask.* (меню на кнопке, редактор координат, применение значений через CommonCLI) - MyMesh: публичный доступ к CommonCLI для UI (getCLI), main.cpp передаёт его в UITask - мастер работает на любой цели с дисплеем и кнопкой и исключается препроцессором там, где их нет; WiFi-код теперь под #if defined(ESP32) - новая страница документации posadmesh-docs/device-setup.md, ссылки в index.md и mkdocs.yml - README: раздел «Настройка с дисплея и кнопки» и запись в журнале изменений - проверено сборкой: heltec_v4_repeater_mqtt, Meshadventurer_sx1262_repeater_mqtt, Generic_E22_sx1262_repeater_mqtt (без дисплея), RAK_3112_repeater_mqtt
69 lines
5.6 KiB
Markdown
69 lines
5.6 KiB
Markdown
# Документация MeshCore PosadMesh
|
||
|
||
MeshCore-Posadmesh сохраняет upstream-прошивку MeshCore без изменений и публикует четыре трека прошивок в зависимости от того, как устройству нужно подключаться:
|
||
|
||
- `repeater-bridge-espnow`: используйте, когда нужен обычный репитерный мост ESP-NOW в стиле upstream, без MQTT-аплинка и без веб-панели PosadMesh.
|
||
- `repeater-mqtt`: используйте для Wi-Fi репитера, который должен публиковать данные в MQTT-брокер и, на поддерживаемых платах ESP32, предоставлять опциональную локальную веб-панель для настройки и диагностики.
|
||
- `repeater-mqtt-espnow`: используйте, когда одному репитеру нужны одновременно MQTT-аплинк и обязанности моста ESP-NOW, включая управление каналом/секретом моста для синхронизации моста с Wi-Fi.
|
||
- `repeater-mqtt-bridge`: используйте, когда репитер должен пересылать raw-пакеты mesh между репитерами через ваш собственный MQTT-брокер (например, Mosquitto в локальной сети), а не публиковать телеметрию в курируемый брокер.
|
||
|
||
!!! note "Треки-мосты — это локальные радиомосты"
|
||
|
||
Треки-мосты ESP-NOW предназначены для соединения двух расположенных рядом репитеров, работающих на разных радиоконфигурациях MeshCore — например, с разной полосой пропускания и SF.
|
||
|
||
Треки-мосты — это не релизы MQTT-over-WAN, VPN или интернет-туннелей.
|
||
|
||
Если сначала нужны рекомендации, начните с:
|
||
|
||
- [Сравнение плат](./boards.md)
|
||
- [Скачивание и прошивка релизов](./releases.md)
|
||
|
||
Если вы уже знаете свою плату и хотите самый быстрый путь, пропустите документацию и откройте раздел релизов:
|
||
|
||
- [Скачать прошивку PosadMesh](https://git.meshinfo.ru/shade/MeshCore-Posadmesh/releases)
|
||
|
||
## Я хочу
|
||
|
||
- выбрать плату: начните с [Сравнение плат](./boards.md)
|
||
- прошить прошивку с рекомендациями: начните с [Скачивание и прошивка релизов](./releases.md)
|
||
- прошить прошивку сейчас: скачайте файл из [раздела релизов](https://git.meshinfo.ru/shade/MeshCore-Posadmesh/releases)
|
||
- настроить репитер после прошивки: используйте [Скачивание и прошивка релизов](./releases.md) и [Использование веб-панели репитера](./web-panel.md)
|
||
- разобраться в CLI-командах PosadMesh: используйте [Пользовательские CLI-команды](./custom-cli.md)
|
||
- автоматизировать работу с репитером или писать скрипты: используйте [Использование веб-API репитера](./api.md)
|
||
- собирать прошивку локально: используйте [Локальная сборка с uv](./local-builds.md)
|
||
|
||
## Руководства для пользователей
|
||
|
||
- [Сравнение плат](./boards.md)
|
||
- [Скачивание и прошивка релизов](./releases.md)
|
||
- [Миграция с xJARiD/MeshCore](./migration.md)
|
||
- [Настройка с дисплея и кнопки](./device-setup.md)
|
||
- [Использование веб-панели репитера](./web-panel.md)
|
||
- [Использование веб-API репитера](./api.md)
|
||
- [Пользовательские CLI-команды](./custom-cli.md)
|
||
|
||
## Заметки для разработчиков
|
||
|
||
- [Локальная сборка с uv](./local-builds.md)
|
||
|
||
## Текущий охват
|
||
|
||
Этот сайт документации охватывает только части, специфичные для PosadMesh, в данном репозитории.
|
||
|
||
По общему поведению MeshCore, работе с радио и концепциям upstream-прошивки обращайтесь к upstream-проекту:
|
||
|
||
- [meshcore-dev/MeshCore](https://github.com/meshcore-dev/MeshCore)
|
||
|
||
## Материалы MeshCoreTel
|
||
|
||
Проект ориентирован на сеть и сайт <https://meshcoretel.ru>:
|
||
|
||
- [Карта сети](https://meshcoretel.ru/ru/MOW/map)
|
||
- [Связность](https://meshcoretel.ru/ru/MOW/links)
|
||
- [Покрытие](https://meshcoretel.ru/ru/MOW/coverage)
|
||
- [Узлы](https://meshcoretel.ru/ru/MOW/adverts)
|
||
- [Наблюдатели](https://meshcoretel.ru/ru/MOW/observers)
|
||
- [Веб-прошивальщик и консоль](https://meshcoretel.ru/ru/flasher)
|
||
|
||
Радиопараметры региона Москва (MOW), которые использует сеть: 868,731 МГц, полоса 62,5 кГц, SF7, CR7, хэш пути 2 байта. Брокер: `mqtt://mqtt.meshcoretel.ru:1883`, пользователь и пароль `meshcore`.
|