mirror of
https://github.com/espressif/esp-idf.git
synced 2024-09-20 10:46:02 -04:00
72 lines
2.4 KiB
ReStructuredText
72 lines
2.4 KiB
ReStructuredText
ESP HTTPS OTA
|
|
=============
|
|
|
|
Overview
|
|
--------
|
|
|
|
``esp_https_ota`` provides simplified APIs to perform firmware upgrades over HTTPS.
|
|
It's an abstraction layer over existing OTA APIs.
|
|
|
|
Application Example
|
|
-------------------
|
|
|
|
.. highlight:: c
|
|
|
|
::
|
|
|
|
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;
|
|
}
|
|
|
|
Partial Image Download over HTTPS
|
|
---------------------------------
|
|
|
|
To use partial image download feature, enable ``partial_http_download`` configuration in ``esp_https_ota_config_t``.
|
|
When this configuration is enabled, firmware image will be downloaded in multiple HTTP requests of specified size.
|
|
Maximum content length of each request can be specified by setting ``max_http_request_size`` to required value.
|
|
|
|
This option is useful while fetching image from a service like AWS S3, where mbedTLS Rx buffer size (:ref:`CONFIG_MBEDTLS_SSL_IN_CONTENT_LEN`)
|
|
can be set to lower value which is not possible without enabling this configuration.
|
|
|
|
Default value of mbedTLS Rx buffer size is set to 16K. By using partial_http_download with max_http_request_size of 4K,
|
|
size of mbedTLS Rx buffer can be reduced to 4K. With this configuration, memory saving of around 12K is expected.
|
|
|
|
Signature Verification
|
|
----------------------
|
|
|
|
For additional security, signature of OTA firmware images can be verified. For that, refer :ref:`secure-ota-updates`
|
|
|
|
Advanced APIs
|
|
-------------
|
|
|
|
``esp_https_ota`` also provides advanced APIs which can be used if more information and control is needed during the OTA process.
|
|
|
|
Example that uses advanced ESP_HTTPS_OTA APIs: :example:`system/ota/advanced_https_ota`.
|
|
|
|
|
|
OTA Upgrades with Pre-Encrypted Firmware
|
|
----------------------------------------
|
|
|
|
To perform OTA upgrades with Pre-Encrypted Firmware, please enable :ref:`CONFIG_ESP_HTTPS_OTA_DECRYPT_CB` in component menuconfig.
|
|
|
|
Example that performs OTA upgrade with Pre-Encrypted Firmware: :example:`system/ota/pre_encrypted_ota`.
|
|
|
|
API Reference
|
|
-------------
|
|
|
|
.. include-build-file:: inc/esp_https_ota.inc
|