OTA-обновление прошивки ESP32 по Wi-Fi

Введение

Устройство, развёрнутое автономно в другой комнате или вообще за пределами дома, неудобно обновлять, подключая каждый раз USB-кабель физически. ESP32 поддерживает OTA (Over-The-Air) обновление прошивки по Wi-Fi — концептуально близкое к OTA для embedded Linux устройств (статья 245), но реализованное на уровне самого микроконтроллера, без полноценной операционной системы и схемы A/B-партиционирования.

Концепция

Базовый механизм OTA для ESP32 (через встроенную библиотеку Update.h или более высокоуровневую ArduinoOTA) выделяет отдельный раздел флеш-памяти для новой прошивки, принимает новый образ по сети (либо через локальный сервер обновлений, либо непосредственно от Arduino IDE/PlatformIO по сети вместо USB), и после успешной записи и проверки переключает загрузчик на новый раздел при следующей перезагрузке — что является упрощённым аналогом A/B-схемы из embedded-цикла, но без такой же развитой инфраструктуры явного управления слотами.

Пример кода: OTA-обновление прошивки ESP32 по Wi-Fi

// firmware/src/main.cpp — поддержка OTA-обновления через ArduinoOTA для разработки
#include <WiFi.h>
#include <ArduinoOTA.h>

const char *WIFI_SSID = "MyHomeNetwork";
const char *WIFI_PASSWORD = "secure_password_here";

void setup()
{
    Serial.begin(115200);
    WiFi.begin(WIFI_SSID, WIFI_PASSWORD);
    while (WiFi.status() != WL_CONNECTED) delay(500);

    ArduinoOTA.setHostname("esp32-livingroom"); // имя, под которым устройство видно в сети для прошивки

    ArduinoOTA.onStart([]() {
        Serial.println("Начало OTA-обновления");
    });
    ArduinoOTA.onEnd([]() {
        Serial.println("OTA-обновление завершено");
    });
    ArduinoOTA.onProgress([](unsigned int progress, unsigned int total) {
        Serial.printf("Прогресс: %u%%\n", (progress / (total / 100)));
    });
    ArduinoOTA.onError([](ota_error_t error) {
        Serial.printf("Ошибка OTA [%u]\n", error);
    });

    ArduinoOTA.begin();
    Serial.println("OTA готов к приёму обновлений");
}

void loop()
{
    ArduinoOTA.handle(); // обязательный регулярный вызов для обработки запросов обновления
    // ... остальная логика прошивки ...
}

// firmware/src/main.cpp — альтернатива: OTA-обновление по HTTP-ссылке,
// инициируемое самим устройством (полезно для production без участия Arduino IDE)
#include <HTTPUpdate.h>

void checkAndApplyOtaUpdate()
{
    WiFiClient client;
    const String firmwareUrl = "http://192.168.1.100:8080/firmware/esp32-livingroom-latest.bin";

    t_httpUpdate_return result = httpUpdate.update(client, firmwareUrl);

    switch (result) {
        case HTTP_UPDATE_FAILED:
            Serial.printf("Ошибка обновления: %s\n", httpUpdate.getLastErrorString().c_str());
            break;
        case HTTP_UPDATE_NO_UPDATES:
            Serial.println("Обновлений не найдено");
            break;
        case HTTP_UPDATE_OK:
            Serial.println("Обновление успешно установлено"); // устройство автоматически перезагрузится
            break;
    }
}

Пояснения к коду

ArduinoOTA — вариант, наиболее удобный именно на этапе разработки: после вызова ArduinoOTA.begin() устройство становится видимым в Arduino IDE/PlatformIO как обычная цель для загрузки прошивки, но уже по сети, а не по USB — ArduinoOTA.handle() в loop() обрабатывает входящий запрос загрузки новой прошивки точно так же, как server.handleClient() обрабатывал HTTP-запросы в статье 310 — без этого регулярного вызова устройство не будет реагировать на попытку обновления, даже формально находясь в сети.

httpUpdate.update() показывает более production-ориентированный подход — устройство самостоятельно, по собственной инициативе (например, по таймеру или команде через MQTT) скачивает файл прошивки с явно указанного HTTP-адреса и применяет его, что больше похоже на паттерн периодической проверки обновлений с сервера, разобранный для десктопных приложений в статье 213 цикла про установку/автообновление — этот вариант не требует постоянного присутствия рядом разработчика с Arduino IDE и подходит для по-настоящему автономно работающих в полевых условиях устройств.

Подводные камни

Отсутствие проверки целостности и подлинности файла прошивки перед его применением в показанном базовом примере — устройство, скачивающее и применяющее прошивку по простому HTTP-адресу без какой-либо проверки контрольной суммы или цифровой подписи, потенциально уязвимо к получению повреждённого или, в худшем случае, злонамеренно подменённого образа прошивки; для серьёзных, не чисто учебных проектов стоит реализовать хотя бы базовую проверку контрольной суммы (аналогично подписи установочных пакетов из статьи 215 десктопного цикла), а в идеале — полноценную криптографическую проверку подписи.
Прерывание процесса OTA-обновления из-за временной потери Wi-Fi-соединения или сбоя питания — в отличие от полноценной A/B-схемы embedded Linux устройств (статья 245), базовый механизм OTA для ESP32 не всегда даёт такие же надёжные гарантии безопасного, гарантированно атомарного откат к предыдущей рабочей версии при прерванном обновлении; для критичных, развёрнутых вдалеке устройств стоит явно изучить и протестировать поведение конкретной используемой реализации OTA при намеренно прерванном обновлении (например, физическим отключением питания в середине процесса).
Доступность OTA-интерфейса (через ArduinoOTA) без какой-либо аутентификации в локальной сети — устройство с включённым ArduinoOTA без дополнительной защиты паролем (хотя библиотека и поддерживает опциональный пароль через ArduinoOTA.setPassword()) потенциально позволяет любому в той же локальной сети попытаться загрузить произвольную прошивку на устройство, что для домашнего проекта может быть приемлемым риском, но для более серьёзного применения требует явной защиты.
OTA-обновление, выполняемое слишком часто или без реальной необходимости (например, при каждом запуске устройства, без проверки, действительно ли доступна новая версия) создаёт ненужную сетевую нагрузку и риск (хотя бы временной недоступности устройства во время обновления) — логика проверки обновлений должна быть продуманной, аналогично каналам обновлений и версионированию из десктопного цикла статей (статья 214), а не выполняться бездумно при каждой возможности.