ESP-IDF v6.0 发版指南：MbedTLS v4 加密栈迁移与芯片支持矩阵
【免费下载链接】esp-idfEspressif IoT Development Framework. Official development framework for Espressif SoCs.项目地址: https://gitcode.com/GitHub_Trending/es/esp-idf
ESP-IDF v6.0 是乐鑫物联网开发框架的主版本更新，核心变化有两个：加密栈迁移到 MbedTLS v4.x 与 PSA Crypto API，芯片矩阵新增 ESP32-H4 预览支持。加密层属于架构级替换，涉及 TLS、Flash 加密或证书管理的项目，必须在正式版前完成回归验证，否则会拖慢交付排期。
变更全景速览
| 变更项 | 影响范围 | 是否破坏性变更 | 预计落地版本 |
|---|---|---|---|
| MbedTLS v4.x 与 PSA Crypto API 迁移 | 全部加密相关调用方 | 部分破坏 | v6.0（进行中） |
esptool chip-id命令语法 | 全部用户 | 否，旧脚本需适配 | v6.0 |
| ESP32-H4 预览支持 | 特定芯片用户 | 否 | v6.0 |
| C5 / C61 正式支持延续 | 特定芯片用户 | 否 | v5.5.2 起可用 |
| ESP32-H21 支持 | 特定芯片用户 | 否 | 2026 路线图 |
做加密相关开发的读者，第一行表格和下一节必须读完；只跑 C2/C6、不碰加密的读者，可以直接跳到升级实操段和版本时间线。
MbedTLS v4 加密栈迁移：旧 C API 怎么切到 PSA Crypto
现状：mbedtls 实现以子模块形式放在 components/mbedtls/mbedtls（乐鑫自维护分支），平台适配、硬件加速与证书处理位于 components/mbedtls/port/ 及 components/mbedtls/esp_crt_bundle/。
变更：v6.0 将底层升级到 MbedTLS v4.x 并启用 PSA Crypto API，组件配置里已有默认开启的MBEDTLS_VER_4_X_SUPPORT开关，定义在 components/mbedtls/Kconfig。
影响：直接调用加密 C API 的用户需要按下表改写；间接使用 TLS 的组件基本不用改代码，但仍要回归复验。
| 旧写法 | 新写法 | 说明 |
|---|---|---|
mbedtls_xxx传统 C API | psa_crypto_xxxPSA Crypto API | 直接调用加密的代码需改写 |
| 经 esp-tls / http_client 间接调用 | 保持不变 | 建议在 beta/RC 阶段回归 |
| 密钥与证书配置逻辑 | 对照 examples/security/flash_encryption | 兼容问题排查的合适入口 |
风险单独标注：路线图明确写道该迁移仍在进行中，后续 beta 或 RC 版本可能包含对加密 API 的进一步更新或非兼容性变更。
验证：先在 beta 上完成完整编译与加密路径回归，等 RC 阶段 API 稳定后再锁版本。
芯片支持矩阵核对：C5、C61 与 H4 的边界
现状：按 COMPATIBILITY_CN.md，C5 v1.2 与 C61 v1.1 的推荐版本、需求版本同为 v5.5.2+，两款芯片的完整支持从 v5.5.2 就已可用，v6.0 只是延续维护矩阵。
变更：H4 自 v6.0 起提供预览支持，预览版本在正式版本发布后停止维护，量产请以正式版为准；H21 则要等芯片达到量产状态才提供初步支持。
影响：Wi-Fi 场景可按 examples/wifi/ 下getting_started、power_save等子目录组织验证。排查建议：烧录后用esptool chip-id核对输出中的芯片系列与版本是否符合预期；CI 里残留esptool.py chip_id旧语法的脚本要同步修正。
从 v5.5 升级到 v6.0 的最小操作路径
git clone https://gitcode.com/GitHub_Trending/es/esp-idfcd esp-idf && git checkout release/v6.0./install.sh（Windows 用install.bat）source export.sh（Linux/macOS）idf.py set-target esp32c6（替换为你的目标芯片）idf.py build flash monitoridf.py menuconfig检查加密选项，确认CONFIG_MBEDTLS_VER_4_X_SUPPORT状态
| 核对项 | 确认方法 | 异常时怎么办 |
|---|---|---|
CONFIG_MBEDTLS_VER_4_X_SUPPORT状态 | 查 sdkconfig 或 menuconfig | 回退 v5.5 分支隔离问题 |
| TLS 与 Flash 加密路径 | 跑 examples/protocols/https_server 与 flash_encryption 示例 | 在 beta 上先修，RC 后复验 |
| 芯片探测命令 | esptool chip-id | v5.5 及以下仍用旧语法 |
低功耗场景同样是升级后值得跑一遍的回归点，流程见下图：
2026 版本时间线与存量分支维护承诺
节奏：2026-Q1 → v6.0-beta2(01-27) → v6.0-rc1(02-22) → v6.0 正式版(02-27) → 2026-06-11 v6.1-beta1 → 07-23 rc1 → 07-31 v6.1 正式版 → 2026-11-11 v6.2-beta1 → 12-23 rc1 → 12-31 v6.2 正式版。
存量分支维护：v5.2 于 2026 年 8 月底停止维护，此前发布 v5.2.7、v5.2.8；v5.3 维护到 2027 年 1 月底，规划 v5.3.5 至 v5.3.7；release/5.4 自 2026 年 1 月进入维护周期，年内发布 v5.4.4、v5.4.5；release/5.5 自 2026 年 7 月进入维护周期，覆盖 v5.5.3 至 v5.5.7 系列；release/6.0 与 6.1 分支则通过持续的 bugfix 版本走向产品化稳定。
完整排期见 ROADMAP_CN.md，芯片兼容边界以 COMPATIBILITY_CN.md 为准。文中日期属方向性计划、可能调整，立项前请以最新发布说明再核对一遍。
【免费下载链接】esp-idfEspressif IoT Development Framework. Official development framework for Espressif SoCs.项目地址: https://gitcode.com/GitHub_Trending/es/esp-idf
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
` 修改默认调色板)
