Компонент esp_https_ota предоставляет упрощенные API-функции для обновления firmware по протоколу HTTPS. Он представляет слой абстракции поверх существующего OTA API [4].

Пример приложения:

esp_err_t do_firmware_upgrade()
{
   esp_http_client_config_t config =
   {
      .url = CONFIG_FIRMWARE_UPGRADE_URL,
      .cert_pem = (char *)server_cert_pem_start,
   };
   
   esp_https_ota_config_t ota_config =
   {
      .http_config = &config,
   };
   
   esp_err_t ret = esp_https_ota(&ota_config);
   if (ret == ESP_OK)
   {
      esp_restart();
   }
   else
   {
      return ESP_FAIL;
   }
   return ESP_OK;
}

[Проверка сервера]

Для дополнительной информации по проверке сервера см. раздел "TLS Server Verification" [2]. Нужен корневой сертификат (root certificate) в формате PEM для esp_http_client_config_t::cert_pem.

Замечание: для проверки должен использоваться server-endpoint корневой сертификат вместо любых промежуточных точек из цепочки сертификата. Причина в том, что у корневого сертификата максимальная достоверность, и она обычно остается неизменной в течение долгого периода времени. Пользователи также могут для проверки использовать функцию ESP x509 Certificate Bundle (с помощью esp_http_client_config_t::crt_bundle_attach), которая охватывает большинство доверенных корневых сертификатов (trusted root certificate).

[Загрузка части образа по протоколу HTTPS]

Для использования функции частичной загрузки образа приложения (partial image download) разрешите конфигурацию partial_http_download в esp_https_ota_config_t. Когда эта конфигурация разрешена, образ firmware будет загружен с помощью нескольких запросов HTTP указанного размера. Максимальный размер содержимого для каждого запроса может быть указан установкой значения max_http_request_size.

Эта опция полезна при извлечении образа из службы наподобие AWS S3, когда размер буфера mbedTLS Rx (опция CONFIG_MBEDTLS_SSL_IN_CONTENT_LEN) может быть установлен в меньшее значение, которое нельзя использовать без разрешения этой конфигурации.

Размер по умолчанию для буфера mbedTLS Rx установлен в 16K. С использованием partial_http_download при max_http_request_size = 4K, размер буфера mbedTLS Rx может быть уменьшен до 4K. С этой конфигурацией ожидается экономия памяти около 12K.

Signature Verification. Для дополнительной безопасности может быть проверена цифровая подпись образов OTA firmware. Как это делается, см. раздел "Обновления Secure OTA без Secure boot" документации [4].

Advanced API. Компонент esp_https_ota также предоставляет дополнительные API-функции, которые могут использоваться, если за процессом OTA требуется больше контроля.

Пример, который использует дополнительное ESP_HTTPS_OTA API, см. в каталоге advanced_https_ota среди примеров среды разработки ESP-IDF (examples\system\ota).

[Обновления OTA с предварительно зашифрованным firmware]

Для выполнения обновлений OTA зашифрованным образом приложения (Pre-Encrypted Firmware) разрешите опцию CONFIG_ESP_HTTPS_OTA_DECRYPT_CB в menuconfig (Security features → Enable flash encryption on boot (READ DOCS FIRST) → Potentially insecure options). Пример выполнения OTA-обновления с Pre-Encrypted Firmware см. в каталоге pre_encrypted_ota среди примеров среды разработки ESP-IDF (examples\system\ota).

[Справочник по ESP HTTPS API]

Заголовочный файл: components/esp_https_ota/include/esp_https_ota.h.

Примечание: полное описание макросов, типов данных, API-функций OTA и их параметров см. в документации [1].

[Словарик]

AWS S3 Amazon Web Services, или Amazon Simple Storage Service (Amazon S3) - сервис хранения объектов, предлагающий лучшие в отрасли показатели производительности, масштабируемости, доступности и безопасности данных. Amazon S3 можно использовать для хранения и доступа к любым объемам данных когда угодно и откуда угодно.

OTA Over The Air, технология загрузки (обновления) по радиоканалу.

[Ссылки]

1. ESP32 ESP HTTPS OTA site:docs.espressif.com.
2. ESP-TLS site:docs.espressif.com.
3. Amazon S3 site:aws.amazon.com.
4. ESP32: обновление по радиоканалу (OTA).
5. ESP32: таблицы разделов.