ESP-IDF v6.0 升级前先看这 3 件事加密 API 重写、芯片边界与 2026 行动日历【免费下载链接】esp-idfEspressif IoT Development Framework. Official development framework for Espressif SoCs.项目地址: https://gitcode.com/GitHub_Trending/es/esp-idfESP-IDF v6.0 是乐鑫官方开发框架的主版本更新组件库、构建系统、示例工程与 Wi-Fi/BLE/存储等能力都包含在内。这一版真正需要动手评估的只有两件事加密栈整体换到 MbedTLS v4.x全部加密调用转向 PSA Crypto API以及 2026 年 Q1 到 Q4 的版本节奏。下面直接按谁会受影响、影响多大、每个时间点该做什么来讲。加密 API 重写哪些代码必须动哪些只要回归先说结论影响只落在两类人身上。⚡第一类业务代码里直接调 mbedtls 接口的——这是 v6.0 升级里工作量最集中的地方。可以这么理解这次迁移旧版里mbedtls_xxx和psa_xxx两套接口并存4.x 之后 PSA Crypto API 成了主路径很多传统函数被废弃或改名。你的 AES、SHA、ECDSA 调用点都要对着新接口逐个过一遍换个参数名这种轻量迁移基本不存在。mbedtls 源码以子模块形式放在 components/mbedtls/仓库里挂的是乐鑫自维护的分支上层封装和平台适配在components/mbedtls/port/子目录——也就是说它不是上游原版 mbedtls 的简单拷贝个别行为差异要以乐鑫的适配代码为准。组件的 components/mbedtls/Kconfig 里已经有一个总开关MBEDTLS_VER_4_X_SUPPORT默认 y控制整套 4.x 路径CONFIG_MBEDTLS_PSA_ITS_CUSTOM_STORAGE_BACKEND默认关则决定 PSA 密钥存储能不能挂自定义后端密钥存 NVS 以外的地方时才会用到。第二类通过组件间接用 TLS 的esp-tls、http_client、https_server 这类用户——代码大概率一行不用改但要留排期。官方在 ROADMAP_CN.md 里把话说得很直白MbedTLS v4.x 与 PSA Crypto API 的升级还在进行中即将发布的 beta 版本或 RC 版本可能会包含对加密 API 的进一步更新或非兼容性更新。实际做法是在 v6.0-beta2 或 v6.0-rc1 出来后跑一轮完整回归——编译过、TLS 握手过、证书校验过、密钥读写过四件事都绿再切正式版。别把回归压到正式版当天API 万一又动了一下排期会很被动。排查兼容问题时examples/security/flash_encryption、key_manager和 examples/protocols/https_server 是现成的参照路径把项目里密钥管理与证书配置的逻辑和它们对齐着看能快速定位差异点。芯片支持边界C5/C61 放心上量H21/H4 还要等芯片版本的支持边界以 COMPATIBILITY_CN.md 为准跟 v6.0 直接相关的几条芯片系列状态对应版本ESP32-C5v1.0 从 v5.5.2 开始支持v1.2 的推荐版本与需求版本均为 v5.5.2 及以上分支v6.0 延续正式支持ESP32-C61v1.0 从 v5.5.2 开始支持v1.1 推荐/需求版本同为 v5.5.2 及以上v6.0 延续正式支持ESP32-H4v6.0 起提供预览支持预览版在该系列正式支持发布后即停止维护量产以正式版为准量产支持待落地ESP32-H21文档只承诺芯片达到量产状态时增加对其量产版本的初步支持进展在开发者门户跟踪两个提醒工具命令变了查芯片系列和版本v6.0 起用esptool chip-idv5.5 及更早版本还是esptool.py chip_id。写脚本的人注意这个断点CI 里两条命令要分开配。另可用idf.py --version核对当前框架版本。预览支持不等于量产支持。H4 的 v6.0 预览版适合做预研验证别拿它跑产线。2026 版本日历每个节点该做什么官方排期全部来自 ROADMAP_CN.md。文档同时声明这些是方向性计划不是约束性承诺具体日期可能调整。Q1v6.0 正式版2026-02-27迁移窗口从 beta 就开始了v6.0 的 beta2 在 01/27、rc1 在 02/22、正式版 02/27 三连发。同一季度 02/13 还有 v5.5.3——还在旧分支上的团队先把这个补丁吃掉。Q1 的核心动作不是等正式版而是用 beta/rc 把加密路径跑一遍。Q2v6.1-beta106/11 旧分支密集打补丁v6.0.1 于 06/04 发布v6.1 走 beta106/11→ rc107/23→ 正式版07/31。旧分支方面v5.2.704/28、v5.5.405/08、v5.3.607/02、v6.0.206/04排队落地。Q2 的任务清单就一条用 v6.1-beta1 做第二轮回归重点看 rc 阶段加密 API 有没有再变。Q3v6.1 正式版07/31——建议的正式切换点v6.1 正式版之后加密 API 基本定型是比 v6.0 更早暴露问题的更稳切换点。同期 bugfixv5.5.507/30、v5.2.808/17v5.2 的最后一发、v6.0.309/10、v6.1.109/03、v5.4.509/28。Q4v6.211/11 beta1 → 12/31 正式版把主力分支定下来v6.0 和 v6.1 两条分支全年持续出 bugfixv6.0.4 于 11/18、v6.1.2 于 10/22、v6.1.3 于 12/16、v5.5.6 于 10/08文档的目标是使这两个分支更加稳定和产品化。Q4 要做的决策是产品线主力停在 v6.0 还是 v6.1两条分支都长期有补丁选哪个取决于你对 bugfix 节奏的偏好。旧分支的迁移期限比 v6.0 发布时间更紧这张表建议截图存档分支维护窗口窗口内的最后补丁release/5.22026 年 8 月底 EOLv5.2.704/28、v5.2.808/17release/5.32027 年 1 月底 EOLv5.3.503/09、v5.3.607/02、v5.3.72027/01/18release/5.42026-01 进入维护周期v5.4.404/03、v5.4.509/28release/5.52026-07 进入维护周期v5.5.302/13、v5.5.405/08至 v5.5.72027/01/11还在 v5.2 上的产品2026 年 8 月 17 日之后就没有补丁可拿了v5.3 的窗口到 2027 年 1 月 18 日关。这两条线要提前排分支切换或锁死最后 bugfix 版本别卡在 EOL 当天。收束升级 v6.0 前跑完这 5 步全仓 grep 直接调用 mbedtls 接口的代码点逐个映射到 PSA Crypto API——v6.0 里工作量最大的一块先估时再排期。beta/rc 阶段跑 TLS 全链路回归编译、握手、证书校验、密钥读写以examples/security/的flash_encryption、key_manager和 examples/protocols/https_server 作参照排查差异。检查构建与产测脚本v6.0 用esptool chip-idv5.5 及更早用esptool.py chip_id命令断点要分开处理。idf.py menuconfig确认CONFIG_MBEDTLS_VER_4_X_SUPPORT仍是 y别被历史配置意外关掉。芯片决策C5/C61 直接上量H4 预览版只做预研H21/H4 的量产支持以芯片量产状态和开发者门户跟踪页为准。从源码分支跑 v6.0 的完整流程git clone https://gitcode.com/GitHub_Trending/es/esp-idf cd esp-idf git checkout release/v6.0 ./install.sh # Windows 用 install.bat source export.sh # 每个新终端重新执行一次 cd 示例工程 idf.py set-target esp32c6 idf.py build flash monitorWi-Fi 相关场景的验证工程在 examples/wifi/ 下getting_started、power_save、ftm各子目录可按测试目标直接取用。【免费下载链接】esp-idfEspressif IoT Development Framework. Official development framework for Espressif SoCs.项目地址: https://gitcode.com/GitHub_Trending/es/esp-idf创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考