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,121 @@
+# Миграция с `xJARiD/MeshCore`
+
+Эта страница описывает переход с предыдущей прошивки, опубликованной по адресу:
+
+- `https://github.com/xJARiD/MeshCore`
+
+на прошивку PosadMesh, опубликованную по адресу:
+
+- `https://git.meshinfo.ru/shade/MeshCore-Posadmesh`
+
+Эти шаги предназначены для существующих пользователей репитеров, переходящих на новую прошивку PosadMesh `*_repeater_observer`.
+
+Начните с загрузки подходящего релиза PosadMesh для вашей платы:
+
+- [Скачивание и прошивка релизов](./releases.md)
+
+## Краткий ответ
+
+Сначала попробуйте обычную прошивку, без стирания устройства. После прошивки заново введите текущие настройки Wi-Fi и MQTT PosadMesh, перечисленные ниже.
+
+Полное стирание с прошивкой (erase-flash) выполняйте только в том случае, если репитер по-прежнему ведёт себя странно после перепрошивки, повторного применения настроек и перезагрузки.
+
+## Перед началом
+
+- новую прошивку можно установить без предварительного стирания
+- после прошивки потребуется заново применить настройки Wi-Fi и некоторые настройки MQTT
+- это можно сделать как через последовательный CLI, так и через приложение companion
+
+Старые настройки MQTT-моста из `xJARiD/MeshCore` не переносятся в текущие настройки MQTT-аплинка PosadMesh. Введите заново те настройки, которые вы используете сейчас, вместо того чтобы рассчитывать на перенос старых значений брокера/анализатора.
+
+## Обязательная настройка после прошивки
+
+После установки новой прошивки задайте:
+
+- `set wifi.ssid <your-ssid>`
+- `set wifi.pwd <your-password>`
+- `set mqtt.iata <code>`
+- `set mqtt.status on`
+
+## Необязательные настройки
+
+Если вы ранее использовали метаданные владельца, также задайте:
+
+- `set mqtt.owner <64-hex-char-public-key>`
+- `set mqtt.email <email>`
+
+Если вы ранее отключали публикацию TX, также задайте:
+
+- `set mqtt.tx off`
+
+## Последний шаг
+
+После применения настроек:
+
+- `reboot`
+
+После перезагрузки репитер должен работать.
+
+## Проверка работы
+
+Убедитесь, что репитер запущен и подключён, с помощью:
+
+- `get wifi.status`
+- `get mqtt.status`
+
+## Проверка в веб-консоли
+
+Если на вашей плате включена веб-панель, проверить можно также через локальную страницу администратора по HTTPS.
+
+Включите и проверьте её с помощью:
+
+- `set web on`
+- `get web.status`
+
+Затем откройте:
+
+- `https://<IP_ADDRESS>/`
+
+Примечания:
+
+- игнорируйте предупреждение браузера о самоподписанном сертификате
+- войдите, используя пароль администратора
+- это тот же пароль администратора, который используется для доступа администратора через приложение companion
+
+## Устаревшие команды MQTT
+
+Некоторые CLI-команды MQTT из предыдущей прошивки не применяются в PosadMesh и не должны переноситься.
+
+PosadMesh хранит текущие настройки Wi-Fi и MQTT-аплинка отдельно от старой прошивки, поэтому старые настройки брокера и анализатора не переносятся осмысленным образом. После прошивки введите заново те настройки, которые вы используете сейчас, вместо того чтобы ожидать переноса старой конфигурации MQTT-моста.
+
+Следующие прежние CLI-команды MQTT больше не применяются в PosadMesh:
+
+- `get mqtt.server`
+- `get mqtt.port`
+- `get mqtt.password`
+- `get mqtt.analyzer.us`
+- `get mqtt.analyzer.eu`
+- `get mqtt.config.valid`
+
+Если выполнить прошивку без предварительного стирания, некоторые старые значения могут остаться во flash-памяти в фоновом режиме. Важно то, что PosadMesh не использует эти старые значения MQTT-моста для текущей конфигурации аплинка, поэтому пользователям не следует ожидать их переноса или какого-либо эффекта.
+
+## Рекомендуемый порядок миграции
+
+1. Прошейте новую прошивку PosadMesh без стирания.
+2. Откройте последовательный CLI или приложение companion.
+3. Задайте `wifi.ssid`, `wifi.pwd`, `mqtt.iata` и `mqtt.status on`.
+4. При необходимости задайте `mqtt.owner` и `mqtt.email`.
+5. Если вы ранее отключали публикацию TX, задайте `mqtt.tx off`.
+6. Перезагрузите репитер.
+7. Проверьте с помощью `get wifi.status` и `get mqtt.status`.
+8. При необходимости убедитесь в локальном веб-доступе с помощью `set web on`, `get web.status` и `https://<IP_ADDRESS>/`.
+
+## См. также
+
+- [Веб-панель репитера](./web-panel.md)
+- [Пользовательские команды CLI](./custom-cli.md)
+- [Скачивание и прошивка релизов](./releases.md)
+
+## Крайняя мера
+
+Если репитер по-прежнему не запускается корректно после перепрошивки, повторного применения настроек и перезагрузки, крайняя мера — выполнить полное стирание с прошивкой (erase-flash), а затем настроить его заново с нуля.