MeshCore-Posadmesh/posadmesh-docs/releases.md

Загрузка и прошивка релизов

Файлы релизов 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