单片机与物联网 / 系统课时
实现 OTA 升级
实现 OTA 升级
OTA 的难点不是“把新固件下载下来”,而是保证下载中断仍能启动、版本不会误刷,并在新固件首启失败时退回旧版本。本节用 ESP-IDF 的 HTTPS OTA 流程完成版本检查、写入备用分区、重启验证和回滚保护。
学习目标
- 理解 A/B OTA 分区、版本检查和首启确认之间的关系
- 使用
esp_https_ota下载并切换固件,同时保留失败后的可启动版本 - 设计升级失败、自检失败和重复版本的验证路径
OTA 升级为什么要分成两个阶段
一次可靠升级包含“下载并切换”和“新版本确认”两个阶段。设备运行旧固件时,把新镜像写入未运行的 OTA 分区;写入完整后才修改启动目标并重启。新固件第一次启动后还要完成最小自检,确认网络、关键外设和配置都可用,再把当前镜像标记为有效。
这样设计能把下载失败和运行失败分开处理:下载中断时继续运行旧分区;新固件能写入但无法正常工作时,由启动器回到上一份有效镜像。

准备分区与安全前提
项目至少要有 otadata 和两个可轮换的应用分区,例如 ota_0、ota_1;如果只有一个应用分区,写新固件时就没有安全的备用槽位。若要自动回滚,还要在 Bootloader 配置中启用应用回滚,并确保上一版本仍处于可启动状态。
固件地址应使用 HTTPS。设备端要校验证书链,不要为了“先跑通”关闭服务器身份校验;量产设备还应把固件签名、密钥保护和反回滚策略纳入发布流程。升级期间也要避免主动断电,并保证镜像大小小于目标 OTA 分区容量。
下载、比较版本并切换
下面是片段示例:它用于 ESP-IDF 项目,调用前设备已经完成 Wi-Fi 联网,并启用了证书包;firmware_url 指向可直接下载的固件二进制。示例先读取新镜像中的版本字符串,与当前版本相同就停止升级;下载完成后切换启动分区并重启。
#include <stdbool.h>
#include <string.h>
#include "esp_app_desc.h"
#include "esp_crt_bundle.h"
#include "esp_err.h"
#include "esp_http_client.h"
#include "esp_https_ota.h"
#include "esp_log.h"
#include "esp_ota_ops.h"
#include "esp_system.h"
static const char *TAG = "ota";
static void confirm_current_image(bool self_test_ok)
{
const esp_partition_t *running = esp_ota_get_running_partition();
esp_ota_img_states_t state;
if (esp_ota_get_state_partition(running, &state) != ESP_OK ||
state != ESP_OTA_IMG_PENDING_VERIFY) {
return;
}
if (self_test_ok) {
ESP_ERROR_CHECK(esp_ota_mark_app_valid_cancel_rollback());
ESP_LOGI(TAG, "new image verified: %s",
esp_app_get_description()->version);
} else {
ESP_LOGE(TAG, "self-test failed, rollback");
esp_ota_mark_app_invalid_rollback_and_reboot();
}
}
static esp_err_t perform_ota(const char *firmware_url)
{
esp_http_client_config_t http_cfg = {
.url = firmware_url,
.crt_bundle_attach = esp_crt_bundle_attach,
.timeout_ms = 15000,
.keep_alive_enable = true,
};
esp_https_ota_config_t ota_cfg = {
.http_config = &http_cfg,
};
esp_https_ota_handle_t handle = NULL;
esp_err_t err = esp_https_ota_begin(&ota_cfg, &handle);
if (err != ESP_OK) {
ESP_LOGE(TAG, "ota begin failed: %s", esp_err_to_name(err));
return err;
}
/* 只读取镜像头,先做版本决策,避免无意义地写 Flash。 */
esp_app_desc_t new_desc;
err = esp_https_ota_get_img_desc(handle, &new_desc);
if (err != ESP_OK) {
esp_https_ota_abort(handle);
return err;
}
const esp_app_desc_t *current = esp_app_get_description();
ESP_LOGI(TAG, "current=%s, new=%s", current->version, new_desc.version);
/* 相同版本直接退出;严格的版本先后判断应交给语义版本策略。 */
if (strcmp(current->version, new_desc.version) == 0) {
ESP_LOGI(TAG, "same version, skip");
esp_https_ota_abort(handle);
return ESP_OK;
}
/* perform 会分块接收并写入未运行的 OTA 分区。 */
do {
err = esp_https_ota_perform(handle);
} while (err == ESP_ERR_HTTPS_OTA_IN_PROGRESS);
if (err != ESP_OK || !esp_https_ota_is_complete_data_received(handle)) {
ESP_LOGE(TAG, "download failed");
esp_https_ota_abort(handle);
return err == ESP_OK ? ESP_FAIL : err;
}
/* finish 成功后才切换下次启动目标,失败时继续保留旧固件。 */
err = esp_https_ota_finish(handle);
if (err == ESP_OK) {
ESP_LOGI(TAG, "image downloaded, rebooting");
esp_restart();
}
return err;
}
void app_main(void)
{
/* 先完成 Wi-Fi 和关键外设初始化,再确认新镜像。 */
bool self_test_ok = true;
confirm_current_image(self_test_ok);
/* 实际项目中应由云端指令、定时检查或维护命令触发。 */
perform_ota("https://example.com/firmware/env-node.bin");
}预期输出(成功升级场景,时间值会不同):
I (<TIME>) ota: current=1.2.0, new=1.3.0
I (<TIME>) ota: image downloaded, rebooting
I (<TIME>) ota: new image verified: 1.3.0项目版本应在构建阶段写入固件描述信息,例如发布 1.3.0 时同步更新项目版本。上面的比较只阻止“相同版本重复刷写”;如果需要严格判断版本先后,应使用明确的语义版本解析或由服务端只下发允许升级的目标版本,不能直接依赖字符串大小比较。
失败与回滚边界
下载失败、TLS 校验失败或镜像不完整时,不应修改当前启动目标,设备继续运行旧固件。新镜像已经切换但首启自检失败时,才进入回滚路径;因此不要在应用一启动就立刻标记为有效,而应至少检查关键配置、核心传感器初始化以及必要的网络能力。
上线前做破坏性验收
至少验证四类场景:下载到一半断网后旧固件仍能启动;服务端返回相同版本时设备不重复刷写;新固件故意让自检失败时能回到上一版本;证书错误或镜像损坏时升级被拒绝。只有这些失败路径都闭环,OTA 才算从“能升级”变成“可远程维护”。