
ESP-IDF v6.0 发布全解析MbedTLS v4 换代、2026 路线图与芯片支持边界【免费下载链接】esp-idfEspressif IoT Development Framework. Official development framework for Espressif SoCs.项目地址: https://gitcode.com/GitHub_Trending/es/esp-idfESP-IDF v6.0 是乐鑫官方开发框架 ESP-IDF 的下一个主版本计划于 2026 年 Q1 正式发布。它最重要的变化是加密栈整体迁移到 MbedTLS v4.x 与 PSA Crypto API——直接调用 mbedtls C API 的固件代码需要评估改写而只通过 esp-tls、HTTP 客户端等上层组件间接使用 TLS 的项目通常无需改动。本文基于仓库内的 ROADMAP_CN.md 与 COMPATIBILITY_CN.md把 v6.0 的变化、上手步骤和 2026 年版本节奏一次讲清。v6.0 到底变了什么一张变化清单变更项状态影响面加密栈升级至 MbedTLS v4.x PSA Crypto API进行中直接调用 mbedtls C API 的代码需评估改写esp-tls、http_client 等间接使用者通常不用改但建议在 beta/RC 阶段回归验证加密配置开关CONFIG_MBEDTLS_VER_4_X_SUPPORT已落地默认开启在 components/mbedtls/Kconfig 中定义可于idf.py menuconfig中查看芯片支持矩阵纳入 C5 / C61已落地ESP32-C5 v1.0、ESP32-C61 v1.0 自 v5.5.2 起支持v6.0 延续维护C5 v1.2 与 C61 v1.1 的推荐/需求版本均为 v5.5.2 及以上ESP32-H4 预览支持已落地COMPATIBILITY_CN.md 明确从 ESP-IDF v6.0 开始提供预览支持ESP32-H21 支持待量产路线图写明待芯片达到量产状态后提供初步支持进展以开发者门户为准工具链命令调整自 v6.0 生效查看芯片系列与版本由esptool.py chip_idv5.5 及更早变为esptool chip-id两点需要如实说明加密 API 尚未定稿。路线图原文写道升级至 MbedTLS v4.x 和新的 PSA 加密 API 的工作仍在进行中后续 beta 或 RC 版本可能包含对加密 API 的进一步更新或非兼容性更新。因此依赖加密路径的项目应把回归测试排进 beta/RC 周期而不是只验证一个版本。路线图是方向性计划不是约束性承诺。文档明确声明日期可能因业务等因素调整本文所列日期以 ROADMAP_CN.md 当前内容为准。加密相关源码的位置方便排查问题时直接定位MbedTLS 本体子模块指向乐鑫自维护分支components/mbedtls/mbedtls/平台适配层含 PSA 初始化、HMAC/PBKDF2 等封装components/mbedtls/port/回归验证建议从这两个示例切入examples/security/flash_encryption/密钥与存储加密、examples/protocols/https_server/证书与 TLS 服务端配置从零跑通 v6.0 分支的最短路径克隆仓库并切到目标分支git clone https://gitcode.com/GitHub_Trending/es/esp-idf cd esp-idf git checkout release/v6.0安装工具链Linux/macOS 执行./install.shWindows 执行install.bat。导出环境变量source export.sh建议每个新终端重新执行一次。进入任一示例工程指定目标芯片后构建烧录例如cd examples/get-started/... # 任选示例目录 idf.py set-target esp32c6 idf.py build flash monitor执行idf.py menuconfig确认加密相关的CONFIG_MBEDTLS_VER_4_X_SUPPORT处于预期状态当前默认开启。Wi-Fi 场景的示例可在 examples/wifi/ 下按用途查找如getting_started、power_save、ftm、roaming等子目录。旧写法 → 新写法迁移核对表场景旧写法v5.5 及更早新写法v6.0说明查看芯片系列/版本esptool.py chip_idesptool chip-id命令随工具链改版旧 IDF 版本仍用旧命令加密接口mbedtls 传统 C APIPSA Crypto API迁移仍在进行beta/RC 阶段可能有非兼容性变更需随版本复验查看 IDF 版本idf.py --versionidf.py --version不变可用于确认当前运行的是 v6.0 分支迁移节奏建议先在 v6.0-beta 上完成编译与加密路径回归再等 RC 稳定后切换正式版避免 API 抖动影响交付排期。2026 发布节奏与存量分支维护承诺主/次版本节奏摘自 ROADMAP_CN.md 的发布计划版本关键节点v6.0beta22026-01-27rc12026-02-22正式版2026-02-27v6.1beta12026-06-11rc12026-07-23正式版2026-07-31v6.2beta12026-11-11rc12026-12-23正式版2026-12-31存量分支的 bugfix 计划部分release/5.2v5.2.72026-04-28、v5.2.82026-08-17随后于 2026 年 8 月底停止维护release/5.3v5.3.52026-03-09、v5.3.62026-07-02、v5.3.72027-01-182027 年 1 月底停止维护release/5.42026 年 1 月进入维护周期2026 年内发布 v5.4.4、v5.4.5release/5.52026 年 7 月进入维护周期计划发布 v5.5.32026-02-13至 v5.5.72027-01-11release/6.0、release/6.1通过 v6.0.1v6.0.4、v6.1.1v6.1.3 等 bugfix 逐步走向产品化稳定选型提示如果新项目直接用 v6.0关注上述加密变更即可如果量产项目仍停留在 5.x按上表把维护窗口纳入升级窗口期。查资料去哪里芯片支持边界推荐版本/需求版本COMPATIBILITY_CN.md以 master 分支版本为最新年度规划与发布日期ROADMAP_CN.md英文版 ROADMAP.md构建环境与组件说明README_CN.md完整文档docs/ 目录同时维护 en 与 zh_CN 两套 Sphinx 文档再次提醒所有日期均为路线图中的方向性计划加密 API 相关变更以各 beta/RC 的 Release Notes 为准。【免费下载链接】esp-idfEspressif IoT Development Framework. Official development framework for Espressif SoCs.项目地址: https://gitcode.com/GitHub_Trending/es/esp-idf创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考