MeshCore-Posadmesh/posadmesh-docs/migration.md

Миграция с xJARiD/MeshCore

Эта страница описывает переход с предыдущей прошивки, опубликованной по адресу:

• https://github.com/xJARiD/MeshCore

на прошивку PosadMesh, опубликованную по адресу:

• https://git.meshinfo.ru/shade/MeshCore-Posadmesh

Эти шаги предназначены для существующих пользователей репитеров, переходящих на новую прошивку PosadMesh *_repeater_mqtt.

Начните с загрузки подходящего релиза PosadMesh для вашей платы:

• Скачивание и прошивка релизов

Краткий ответ

Сначала попробуйте обычную прошивку, без стирания устройства. После прошивки заново введите текущие настройки 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>/.

См. также

• Веб-панель репитера
• Пользовательские команды CLI
• Скачивание и прошивка релизов

Крайняя мера

Если репитер по-прежнему не запускается корректно после перепрошивки, повторного применения настроек и перезагрузки, крайняя мера — выполнить полное стирание с прошивкой (erase-flash), а затем настроить его заново с нуля.