# Документация 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`.