refactor: rebrand to PosadMesh, translate docs to Russian, drop legacy brokers

2026-10-07 19:04:39 +03:00
parent c0c1336540
commit c86ae584ab
81 changed files with 6942 additions and 5118 deletions
@@ -0,0 +1,209 @@
+# Загрузка и прошивка релизов
+
+Файлы релизов PosadMesh публикуются на:
+
+- <https://git.meshinfo.ru/shade/MeshCore-Posadmesh/releases>
+
+## С чего начать
+
+Если вы прошиваете прошивку PosadMesh впервые, самый простой путь:
+
+1. Откройте <https://flasher.eastmesh.au/>.
+2. Выберите прошивку, соответствующую тому, что будет делать устройство.
+3. Выберите плату, точно соответствующую вашему железу.
+4. Выберите версию. Флешер по умолчанию выбирает последний доступный релиз.
+5. Выберите тип образа:
+   - `Update` для обычного обновления прошивки
+   - `Full Flash` для чистой прошивки полного образа
+6. Нажмите `Flash Firmware`.
+7. После прошивки завершите настройку через `Open MeshCore Config Panel` или `Serial Console`.
+
+Если вы не уверены, какой трек вам нужен, начните с `companion-wifi` для companion-устройств, подключаемых к приложению, или с `observer-posadmesh` для стационарного репитера, который должен публиковать данные в MQTT.
+
+## Выбор трека
+
+PosadMesh публикует четыре трека релизов:
+
+| Трек                              | Используйте, когда                                                                                     | Суффикс имени файла прошивки   |
+| --------------------------------- | ------------------------------------------------------------------------------------------------------ | ------------------------------ |
+| `companion-wifi`                  | Нужно companion-устройство, которое подключается по Wi-Fi вместо BLE или USB.                          | `*_companion_radio_wifi`       |
+| `observer-posadmesh`               | Нужен репитер с Wi-Fi и MQTT-аплинком, обычно для видимости в брокере, например в PosadMesh/CoreScope. | `*_repeater_observer`          |
+| `repeater-bridge-espnow`          | Нужен локальный ESP-NOW мост между соседними репитерами, без MQTT-аплинка и без веб-панели PosadMesh.  | `*_repeater_bridge_espnow`     |
+| `observer-posadmesh-bridge-espnow` | Нужно, чтобы один репитер выполнял и MQTT-аплинк, и задачи локального ESP-NOW моста.                   | `*_repeater_observer_espnow`   |
+
+!!! note "Прошивка моста — это не WAN-мост"
+
+    Треки ESP-NOW моста предназначены для соединения двух соседних репитеров, работающих с разными конфигурациями радио MeshCore, например `Australia (Narrow)` и `Australia (Mid)`.
+
+    Треки моста не используют брокеры MQTT-аплинка для туннелирования mesh-трафика через интернет, WAN-каналы или VPN.
+
+## Выбор подходящего файла релиза
+
+Скачайте файл, соответствующий вашей плате и типу прошивки.
+
+Примеры:
+
+- `heltec_v4_companion_radio_wifi-v1.14.1-abcdef.bin`
+- `heltec_v4_repeater_observer-v1.15.0-posadmesh-v2026.5.1-abcdef.bin`
+- `heltec_v4_repeater_observer-v1.15.0-posadmesh-v2026.5.1-abcdef-merged.bin`
+- `heltec_v4_repeater_bridge_espnow-v1.15.0-abcdef.bin`
+- `heltec_v4_repeater_observer_espnow-v1.15.0-posadmesh-v2026.5.1-abcdef.bin`
+
+Важен префикс платы/env:
+
+- `*_companion_radio_wifi`
+- `*_repeater_observer`
+- `*_repeater_bridge_espnow`
+- `*_repeater_observer_espnow`
+
+## Какой файл прошивать
+
+Если вы используете <https://flasher.eastmesh.au/>, выберите тип образа во флешере:
+
+- `Update` = обычное обновление прошивки
+- `Full Flash` = чистая прошивка полного образа
+
+Если вы скачиваете файлы вручную из раздела Releases на git.meshinfo.ru, вместо этого ориентируйтесь на имя файла:
+
+Используйте стандартный файл `.bin`, когда обновляете существующее устройство с тем же таргетом и той же разметкой разделов.
+
+Используйте файл `-merged.bin`, когда нужна чистая установка после стирания flash. Это полный образ ESP32, и его следует прошивать по адресу `0x0`.
+
+Практическое правило:
+
+- `.bin` = инкрементальное обновление
+- `-merged.bin` = стирание и чистая прошивка
+
+## Процесс прошивки
+
+1. Выберите прошивку.
+2. Выберите плату.
+3. Выберите версию. Последняя версия выбирается по умолчанию.
+4. Выберите тип образа: `Update` или `Full Flash`.
+5. Нажмите `Flash Firmware`.
+6. После прошивки используйте `Open MeshCore Config Panel` или `Serial Console` для настройки после прошивки, такой как Wi-Fi, MQTT, мост или параметры радио.
+
+## Рекомендуемый флешер
+
+Рекомендуемый флешер:
+
+- <https://flasher.eastmesh.au/>
+
+Он имеет встроенную поддержку распространённых типов прошивок PosadMesh, а также может прошивать пользовательские файлы прошивок:
+
+- прошивка `companion_radio_wifi`
+- прошивка `repeater_observer`
+- пользовательские файлы прошивок
+
+Для релизов моста используйте соответствующий пункт для моста, если флешер его показывает. В противном случае скачайте файл релиза самостоятельно и прошейте его как пользовательский файл прошивки.
+
+Рекомендуемое использование:
+
+- используйте `Update`, когда обновляете существующее устройство
+- используйте `Full Flash`, когда нужна чистая прошивка полного образа
+
+После прошивки во флешере доступны два полезных пути настройки.
+
+### Открыть панель конфигурации MeshCore
+
+Используйте `Open MeshCore Config Panel`, чтобы получить доступ к пошаговым инструментам настройки MeshCore:
+
+- `Repeater Setup`
+- `Console`
+
+#### Настройка репитера
+
+`Repeater Setup` — это пошаговый процесс первой настройки репитера.
+
+Это традиционный способ настройки репитера после прошивки, включающий:
+
+- имя устройства
+- широту и долготу
+- пароли администратора и гостя
+- параметры радио, включая выбор пресета
+- интервал advert
+- интервал flood advert
+- flood max
+- некоторые расширенные настройки репитера
+
+Начиная с `v1.2.1`, локальная веб-панель репитера также включает те же общие настройки репитера, поэтому пользователи могут выполнить первоначальную настройку там и возвращаться к ней для периодической диагностики или изменения конфигурации. На обсерверах, которым нужен максимальный запас heap, по-прежнему лучше снова отключить панель, когда вы закончили.
+
+#### Консоль
+
+`Console` — это необработанный интерфейс CLI.
+
+Он особенно полезен, а часто и необходим, для первоначальной настройки Wi-Fi на прошивках с поддержкой Wi-Fi:
+
+- `set wifi.ssid <your-ssid>`
+- `set wifi.pwd <your-password>`
+
+Это относится к:
+
+- `companion_radio_wifi`
+- `repeater_observer`
+- `repeater_observer_espnow`
+
+### Последовательная консоль
+
+Используйте `Serial Console`, когда хотите подключиться по USB и вводить команды CLI напрямую.
+
+Флешер может подключаться к устройству по USB и отключаться от него. Он также включает готовые команды CLI, которые подставляются в поле ввода команд для упрощения настройки:
+
+- `set wifi.ssid`
+- `set wifi.pwd`
+- `get wifi.status`
+- `get mqtt.status`
+- `set web on`
+- `get web.status`
+
+Для команд `set` допишите команду в поле ввода перед отправкой. Например, выберите `set wifi.ssid`, добавьте имя вашей Wi-Fi сети, затем нажмите `Send`.
+
+## Типовые первые шаги
+
+### Обсервер
+
+Сборки `repeater_observer` включают дополнения MQTT от PosadMesh. В зависимости от платы они также могут включать локальную веб-панель.
+
+Типовые первые шаги после прошивки:
+
+- задайте `wifi.ssid`
+- задайте `wifi.pwd`
+- задайте `mqtt.iata`
+- проверьте `get mqtt.status`
+- при желании задайте `mqtt.owner` и `mqtt.email`
+- при желании включите пользовательский брокер как второй аплинк
+
+### Обсервер ESP-NOW
+
+Сборки `repeater_observer_espnow` объединяют роль обсервера с поддержкой локального ESP-NOW моста.
+
+Типовые первые шаги после прошивки:
+
+- задайте `wifi.ssid`
+- задайте `wifi.pwd`
+- задайте `mqtt.iata`
+- проверьте `get mqtt.status`
+- проверьте `get wifi.status` и запомните канал Wi-Fi, к которому выполнено подключение
+- задайте `bridge.channel` в соответствии с этим каналом Wi-Fi
+- задайте одинаковый `bridge.secret` на каждом узле локального ESP-NOW моста, которые должны общаться между собой
+
+### ESP-NOW мост репитера
+
+Сборки `repeater_bridge_espnow` предназначены для узлов локального ESP-NOW моста без MQTT-аплинка.
+
+Типовые первые шаги после прошивки:
+
+- настройте обычные параметры репитера для платы
+- задайте нужный пресет/конфигурацию радио MeshCore
+- задайте одинаковые канал моста и секрет для локальной пары моста
+- убедитесь, что оба репитера моста физически находятся достаточно близко для работы ESP-NOW
+
+### Companion-радио Wi-Fi
+
+Сборки `companion_radio_wifi` предназначены для companion-устройств, которые предоставляют интерфейс приложения по Wi-Fi вместо BLE или USB.
+
+Типовые первые шаги после прошивки:
+
+- задайте учётные данные Wi-Fi
+- проверьте `get wifi.status`
+- подключите ваше клиентское приложение к companion-устройству по Wi-Fi