Skip to content

Прошивка (OTA)

Страница http://<ip-платы>/firmware.html доступна администратору. Она обновляет настроенную плату по сети. Для пустой платы используйте первую USB-установку.

Файлы и порядок

  • firmware.bin — код приложения.
  • Файл с окончанием .littlefs.bin — файловая система с UI и конфигурацией.

Форма принимает один файл за одну загрузку. Для согласованного обновления возьмите пару от одной платы, версии и набора возможностей. Сначала загрузите firmware, дождитесь перезапуска и проверки версии, затем соответствующий LittleFS. Если файл называется просто littlefs.bin, для локального OTA переименуйте его, например, в esp8266.littlefs.bin: обработчик различает тип по суффиксу .littlefs.bin.

Прогресс показывает передачу файла. Ответ 200 ещё не доказывает успешный запуск: после перезагрузки проверьте версию, UI, устройства, задачи и свежесть удалённых показаний. При регрессии сначала снимите состояние и логи.

Конфигурация

При штатном FS-OTA сохраняется и восстанавливается /config: Wi-Fi, пользователи, ключи, UUID, устройства, задачи и параметры модулей. Механизм проверяет возможность сохранить конфигурацию перед записью; не считайте OTA заменой отдельному резервному файлу.

USB-запись отличается от OTA

Запись файловой системы через USB заменяет настройки. Установочный ZIP также предназначен для первой записи. Для действующей платы сначала сделайте резервную копию через API или интерфейс резервирования.

Уменьшение лимита задач, удаление используемого плагина или смена разметки могут сделать прежний конфиг несовместимым. Проверьте состав сборки и лимиты заранее.

Откуда брать образы

Используйте конструктор: выберите свою плату, нужные функции и число задач. Скачайте firmware и LittleFS от одного завершённого результата. Доступ к репозиторию и самостоятельная компиляция не требуются.

Облачное OTA выбирается в кабинете для конкретной платы. Плата получает команды через heartbeat, загружает образы и проверяет размер/SHA256. Это отдельный путь от ручной формы. ESP-01S не поддерживает обычное firmware OTA в текущей разметке: используйте программатор и профиль esp01s.

Разделы и восстановление

OTA не обновляет загрузчик и таблицу разделов. Смена разметки требует USB-записи. Наличие двух app-разделов ESP32 само по себе не гарантирует автоматический откат после трёх сбоев: такая гарантия текущим кодом не реализована.

Если плата не стартует, подключите USB, прочитайте Serial и определите, что повреждено. Сначала попробуйте восстановить только код совместимой версии. При недоступном UI проверьте IP, HTTP/API и логи. Запись FS или сброс настроек — осознанный следующий шаг с потерей конфигурации, а не обязательное действие при любой проблеме. Сохраните доступные данные перед ним.