shade
26b724c0f0
- добавлен ручной workflow Gitea Actions (.gitea/workflows/build-mqtt-firmwares.yml): сборка MQTT-прошивок на сервере и публикация релиза - добавлен posadmesh-tools/publish-gitea-release.sh для выгрузки собранных файлов в релиз Gitea (идемпотентно, фильтр по треку) - README: происхождение проекта переписано (форк EastMesh, доработка энтузиастов из Сергиева Посада, ориентация на meshcoretel.ru), добавлены раздел «Отличия от upstream MeshCore» и журнал «Изменения в проекте» - убраны упоминания Австралии, ссылки на eastmesh.au и региональные материалы; руководство по прошивке переведено на файлы релизов и esptool.py - posadmesh-build.sh: вывод PlatformIO очищается от \r — на Windows групповые команды сборки не находили ни одной цели; companion-команды удалены, добавлены build-mqtt-firmwares и list-mqtt - release-notes.yml: треки repeater-mqtt*, запись 2026.10.0 дополнена удалением companion и исправлением сборки, companion-wifi помечен как снятый с выпуска - AGENTS.md: правило дописывать изменения в README - .gitignore: .pio-home
122 lines
6.9 KiB
Markdown
122 lines
6.9 KiB
Markdown
# Миграция с `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), а затем настроить его заново с нуля.
|