SuperAPI AI 工具集

esp32-ota

部署与运维

查看项目

更新于 10-15 21:48

技能介绍

用途:为 ESP32 设计并排障 ESP-IDF OTA 远程固件升级,核心是分区机制、升级状态机与回滚确认三者的配合。

主要能力:给出 OTA 最小分区模板(nvs、otadata、phy_init、factory、ota_0、ota_1,Offset 留空由构建自动排布);说明镜像有效性状态存于 otadata(VALID/UNDEFINED 可启动,INVALID/ABORTED 不启动);梳理 API 顺序 esp_ota_begin → esp_ota_write → esp_ota_end → esp_ota_set_boot_partition,选槽用 esp_ota_get_next_update_partition(),高层封装用 esp_https_ota;提供升级决策检查单、回滚验收项与陷阱清单。

必要用法:先执行 idf.py --version 与 idf.py partition-table 读取目标板实际分区表,分区偏移与大小以该输出为准,不凭记忆填写;menuconfig 可选 "Factory app, two OTA definitions" 并启用 CONFIG_BOOTLOADER_APP_ROLLBACK_ENABLE;开启回滚后新镜像必须显式调用 esp_ota_mark_app_valid_cancel_rollback(),自检失败调用 esp_ota_mark_app_invalid_rollback_and_reboot()。

适用场景:产品新增 OTA 能力、升级后设备跑回旧版本的排障、升级通道健壮性决策。

限制:回滚只发生在 OTA 槽之间,factory 不可回滚;OTA 本质需要网络,离线设备走 USB 串口烧录;服务器证书校验不可关闭;签名、防回滚 eFuse、加密镜像、真机 HIL 验收、发布流程等分别交由 esp32-secureboot、fw-hil-testing、fw-release-gate 等技能处理。