Moved docs and workflows to avoid conflicts while merging official repo

2026-06-06 20:18:03 +03:00
Parent 86154ce8d0
@@ -0,0 +1,91 @@
+# Загрузка и прошивка релизов
+
+Релизные файлы прошивки 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`