单片机与物联网 / 系统课时

实现 OTA 升级

实现 OTA 升级

OTA 的难点不是“把新固件下载下来”,而是保证下载中断仍能启动、版本不会误刷,并在新固件首启失败时退回旧版本。本节用 ESP-IDF 的 HTTPS OTA 流程完成版本检查、写入备用分区、重启验证和回滚保护。

学习目标

  • 理解 A/B OTA 分区、版本检查和首启确认之间的关系
  • 使用 esp_https_ota 下载并切换固件,同时保留失败后的可启动版本
  • 设计升级失败、自检失败和重复版本的验证路径

OTA 升级为什么要分成两个阶段

一次可靠升级包含“下载并切换”和“新版本确认”两个阶段。设备运行旧固件时,把新镜像写入未运行的 OTA 分区;写入完整后才修改启动目标并重启。新固件第一次启动后还要完成最小自检,确认网络、关键外设和配置都可用,再把当前镜像标记为有效。

这样设计能把下载失败和运行失败分开处理:下载中断时继续运行旧分区;新固件能写入但无法正常工作时,由启动器回到上一份有效镜像。

ESP32 OTA 下载、首启确认与回滚状态流

准备分区与安全前提

项目至少要有 otadata 和两个可轮换的应用分区,例如 ota_0、ota_1;如果只有一个应用分区,写新固件时就没有安全的备用槽位。若要自动回滚,还要在 Bootloader 配置中启用应用回滚,并确保上一版本仍处于可启动状态。

固件地址应使用 HTTPS。设备端要校验证书链,不要为了“先跑通”关闭服务器身份校验;量产设备还应把固件签名、密钥保护和反回滚策略纳入发布流程。升级期间也要避免主动断电,并保证镜像大小小于目标 OTA 分区容量。

下载、比较版本并切换

下面是片段示例:它用于 ESP-IDF 项目,调用前设备已经完成 Wi-Fi 联网,并启用了证书包;firmware_url 指向可直接下载的固件二进制。示例先读取新镜像中的版本字符串,与当前版本相同就停止升级;下载完成后切换启动分区并重启。

c
#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");
}

预期输出(成功升级场景,时间值会不同):

text
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 才算从“能升级”变成“可远程维护”。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

实现 OTA 升级

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通