Files
MeshCoreTel-firmware/docs/releases.md
T

92 líneas
5.8 KiB
Markdown

# Загрузка и прошивка релизов
Релизные файлы прошивки MeshCoreTel-firmware публикуются здесь:
- <https://github.com/VBart/MeshCoreTel-firmware/releases>
## Выбор нужного файла
Скачайте файл, соответствующий вашему устройству и типу прошивки.
Примеры:
- `heltec_v4_repeater_mqtt-v1.15.0-vbart-meshcoretel-v1.0.0-79550a7f.bin`
- `heltec_v4_repeater_mqtt-v1.15.0-vbart-meshcoretel-v1.0.0-79550a7f-merged.bin`
## Какой файл прошивать
Используйте обычный `.bin`-файл при обновлении существующего устройства того же типа и той же раскладкой разделов.
Используйте `-merged.bin`-файл, когда нужна чистая установка после полной очистки флеш-памяти. Это полный образ ESP32, предназначенный для прошивки с адреса `0x0`.
Практическое правило:
- `.bin` = инкрементальное обновление
- `-merged.bin` = очистка и чистая прошивка
## Порядок прошивки
1. Откройте страницу релиза и скачайте файл для вашего устройства.
2. Убедитесь, что название в имени файла соответствует вашему устройству.
3. Выберите один из вариантов: обновить существующую прошивку обычным `.bin`-файлом, либо сначала полностью очистить устройство и прошить `-merged.bin`.
4. Перезагрузите устройство и завершите настройку после прошивки (Wi-Fi, MQTT, радио и т.п.).
## Рекомендуемый прошивальщик
Рекомендуемый инструмент для прошивки:
- <https://meshcoretel.ru/ru/flasher>
Он уже содержит каталог прошивок под заголовком _Прошивки наблюдателя от VBart_.
Рекомендации по использованию:
- применяйте обычный `.bin` при обновлении существующего устройства
- используйте `-merged.bin` после очистки, когда нужна чистая прошивка с нуля
## Начальная настройка для новичков
Если вы прошиваете MeshCoreTel-firmware впервые, самый простой путь:
1. Откройте <https://meshcoretel.ru/ru/flasher>.
2. Выберите подходящую прошивку для вашего устройства из раздела _Прошивки наблюдателя от VBart_.
3. Отметьте пункт _Очистить устройство_, если устанавливаете новую прошивку впервые
4. Используйте встроенные инструменты настройки, такие как _Настройка репитера_ и _Консоль_ на сайте прошивальщика для завершения первоначальной конфигурации.
### Настройка репитера
_Настройка репитера_ — это пошаговый мастер первой настройки ретранслятора.
Это традиционный способ сконфигурировать ретранслятор после прошивки, включая:
- имя устройства
- широту и долготу
- пароли администратора и гостя
- настройки радио, в том числе выбор пресета
- интервал объявлений (advert interval)
- интервал массовых объявлений (flood advert interval)
- максимальное количество массовых сообщений (flood max)
- некоторые расширенные настройки ретранслятора
[Локальная веб-панель](./web-panel.md) прошивки MeshCoreTel-firmware также содержит те же самые основные настройки, поэтому пользователи могут выполнить начальную настройку там, а к мастеру возвращаться лишь для диагностики или эпизодических изменений. На MQTT-ретрансляторах, где важен максимальный запас ресурсов, всё же лучше отключить веб-панель после завершения настройки, особенно если у вас на устройстве мало памяти.
### Консоль
_Консоль_ — это прямой интерфейс командной строки (CLI).
Он особенно полезен, а часто и необходим, для первичной настройки Wi-Fi:
- `set wifi.ssid <ваш-ssid>`
- `set wifi.pwd <ваш-пароль>`
Прошивки MeshCoreTel-firmware включает MQTT-дополнения. В зависимости от устройства, они также могут включать [локальную веб-панель](./web-panel.md).
Типичные первые шаги после прошивки:
- задать `wifi.ssid`
- задать `wifi.pwd`
- задать `mqtt.iata`
- проверить `get mqtt.status`
- опционально задать `mqtt.owner` и `mqtt.email`
- опционально включить `letsmesh-eu` или `letsmesh-us`