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

Релизные файлы прошивки 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`
