企业官网建设流程全解析

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-idf

ESP-IDF v6.0 是乐鑫官方物联网开发框架的下一个主版本，最先要盯住的变化是加密栈向 MbedTLS v4.x 与 PSA Crypto API（可理解为新一代统一加密接口）的迁移。本文基于仓库内的路线图与兼容性文档，梳理发版计划、两个变化点，以及跑通 v6.0 的最小步骤，供升级排期参考。

📋 版本速览：四件事先记住

• 加密栈换底座：底层加密库切换到 MbedTLS v4.x，推荐调用方式改为 PSA Crypto API，工作仍在进行
• 芯片矩阵：ESP32-C5、ESP32-C61 延续支持，ESP32-H21、ESP32-H4 进入路线图，量产后给初步支持
• 命令调整：esptool.py chip_id改为esptool chip-id
• 发版节奏：v6.0 落在 2026 年 Q1，v6.1 在 7 月，v6.2 在年底，存量分支并行滚动 bugfix

上面四条就是本版的骨架，下面逐一展开。

🗓️ 2026 发版时间表：主版本、次版本与 bugfix 节奏

主、次版本计划：

存量分支的 bugfix 也按节奏滚动：

• v5.5.3（2026-02-13）、v5.4.4（2026-04-03）、v6.0.1（2026-04-10）
• v5.2.7 与 v5.2.8：安排在 2026 年 8 月底 v5.2 停止维护之前
• v5.5.3 至 v5.5.7 序列：年内陆续放出

这些日期属于方向性计划，官方保留调整空间，排期时别把它当硬承诺，一切以正式版为准。

排期看清之后，接下来看变化本身。

🔍 变化点逐个拆：加密栈与芯片矩阵

MbedTLS v4 与 PSA Crypto API 迁移要改什么

一句话结论：这一条是 v6.0 动得最大的地方，加密底座切到 MbedTLS v4.x，代码要逐步转向 PSA Crypto API 的调用方式。

细节与仓库依据：路线图写明这项工作仍在进行，后续 beta 或 RC 可能还会带来加密 API 的进一步更新或非兼容性变更。加密实现以子模块形式放在components/mbedtls/mbedtls/，上层封装与平台适配位于components/mbedtls/port/等目录；components/mbedtls/Kconfig 里已提供MBEDTLS_VER_4_X_SUPPORT开关，用来控制是否启用 v4.x 支持。

你的项目会受什么影响：直接调用旧 mbedtls C API 的代码要评估改写；间接使用 TLS 的组件（esp-tls、http_client）通常不用动，但建议 beta/RC 阶段走一遍回归。

怎么核对：拿examples/security/flash_encryption和examples/protocols/https_server当排查切入点，重点盯密钥管理与证书配置逻辑；先在 beta 版本上完成编译和加密路径回归，再切正式版，免得 RC 阶段的 API 抖动拖住排期。

芯片支持矩阵：C5/C61 走到哪一步，H21/H4 何时落地

先记这一条：C5 与 C61 的完整支持实际自 v5.5.2 起已可用，v6.0 将其纳入正式维护；H21、H4 要等芯片达到量产状态后才落地。

细节：COMPATIBILITY_CN.md 中，ESP32-C5 v1.0 自 v5.5.2 起支持，v1.2 的推荐与需求版本均指向 v5.5.2 及以上分支；ESP32-C61 v1.0 同样自 v5.5.2 起支持，v1.1 也是 v5.5.2 及以上。路线图则写明 H21、H4 在量产后提供初步支持。另外查芯片系列的方式换了：v6.0 用esptool chip-id，v5.5 及更早版本仍是esptool.py chip_id。

实际影响：项目已在用 C5/C61 的话，迁到 v6.0 不存在芯片层面的阻塞；等 H21/H4 的，关注量产进展的官方口径即可。

怎么核对：真机上跑esptool chip-id确认系列与版本；Wi-Fi 场景可在 examples/wifi/ 找getting_started、power_save、ftm等对应样例。

想在机器上先验证一遍的话，下面是最小跑通路径。

🚀 从 clone 到跑通的五步

第一步，克隆仓库并检出目标分支：

git clone https://gitcode.com/GitHub_Trending/es/esp-idf cd esp-idf && git checkout release/v6.0

第二步，安装工具链并导出环境变量（Windows 改用install.bat）：

./install.sh source export.sh

第三步，建议每次开新终端都重新执行一次导出。第四步，进入任一示例目录，设好目标芯片后编译烧录：

idf.py set-target esp32c6 idf.py build flash monitor

第五步，用idf.py menuconfig检查加密相关选项，确认CONFIG_MBEDTLS_VER_4_X_SUPPORT的状态。

新旧写法对照：

最后留几个长期维护的入口。

📚 资料与维护索引

• 分支维护：release/5.2、release/5.3、release/5.4、release/5.5 分支持续发布 bugfix 版本；release/6.0 与 release/6.1 也会通过 bugfix 逐步走向产品化稳定
• 文档：仓库 docs/ 目录同时维护 en 与 zh_CN 两套 Sphinx 文档
• 芯片支持边界以 COMPATIBILITY_CN.md 为准，发版计划见 ROADMAP_CN.md，构建与组件问题可查 README_CN.md 里的开发环境说明

把上面两个变化点核对完、发版节奏排进项目计划，ESP-IDF v6.0 的升级就可以纳入例行评审流程了。

【免费下载链接】esp-idfEspressif IoT Development Framework. Official development framework for Espressif SoCs.项目地址: https://gitcode.com/GitHub_Trending/es/esp-idf