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

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

- `https://github.com/xJARiD/MeshCore`

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

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

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

Начните с загрузки подходящего релиза 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), а затем настроить его заново с нуля.