
ESP-IDF v6.0 发版指南MbedTLS v4 加密栈迁移与芯片支持矩阵【免费下载链接】esp-idfEspressif IoT Development Framework. Official development framework for Espressif SoCs.项目地址: https://gitcode.com/GitHub_Trending/es/esp-idfESP-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.0ESP32-H4 预览支持特定芯片用户否v6.0C5 / 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 APIpsa_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.mdC5 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.shWindows 用install.batsource export.shLinux/macOSidf.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-idv5.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.8v5.3 维护到 2027 年 1 月底规划 v5.3.5 至 v5.3.7release/5.4 自 2026 年 1 月进入维护周期年内发布 v5.4.4、v5.4.5release/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),仅供参考