shade
c86ae584ab
Build and deploy Docs site to GitHub Pages / github-pages (push) Canceled after 0s
PR Build Check / build (Heltec_v3_companion_radio_ble) (push) Canceled after 0s
PR Build Check / build (Heltec_v3_repeater) (push) Canceled after 0s
PR Build Check / build (Heltec_v3_room_server) (push) Canceled after 0s
PR Build Check / build (LilyGo_Tlora_C6_repeater_) (push) Canceled after 0s
PR Build Check / build (PicoW_repeater) (push) Canceled after 0s
PR Build Check / build (RAK_4631_companion_radio_ble) (push) Canceled after 0s
PR Build Check / build (RAK_4631_companion_radio_ethernet) (push) Canceled after 0s
PR Build Check / build (RAK_4631_repeater) (push) Canceled after 0s
PR Build Check / build (RAK_4631_repeater_ethernet) (push) Canceled after 0s
PR Build Check / build (RAK_4631_room_server) (push) Canceled after 0s
PR Build Check / build (RAK_4631_room_server_ethernet) (push) Canceled after 0s
PR Build Check / build (Tbeam_SX1276_repeater) (push) Canceled after 0s
PR Build Check / build (wio-e5-mini_repeater) (push) Canceled after 0s
PR Build Check / build (wio_wm1110_repeater) (push) Canceled after 0s
Run Unit Tests / test (push) Canceled after 0s
210 lines
12 KiB
Markdown
210 lines
12 KiB
Markdown
# Загрузка и прошивка релизов
|
||
|
||
Файлы релизов 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
|