
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乐鑫官方物联网开发框架正在跨入大版本master 分支的版本头文件 components/esp_common/include/esp_idf_version.h 中主版本号已写为 6。本周期最核心的动作是把加密库整体切换到 MbedTLS v4.x 与 PSA Crypto API一套更统一的密码学接口标准。基于仓库内的 ROADMAP 与兼容性文档本文按发布节奏 → 加密迁移 → 芯片兼容 → 老项目升级给你四份可直接对照执行的材料。 v6.0 发布时间线从 beta2 到正式版只要 30 天v6.0 的大版本节奏写在 ROADMAP_CN.md 里比多数人预期的更紧凑关键数字beta21/27到正式版2/27正好间隔 1 个月同年还有 v6.1 计划 7 月 31 日、v6.2 计划 12 月 31 日。正式版之后路线图已排定 v6.0 分支共 4 次 bugfix 版本从 2026-04-10 的 v6.0.1 一直排到 2026-11-18 的 v6.0.4。对读者意味着什么如果项目要赶上半年出货不用等到 2 月但也不建议直接用 beta 上生产4 月 10 日的 v6.0.1 是首个正式 bugfix 版本是相对稳妥的接入点。 ESP-IDF v6.0 加密 API 迁移检查清单MbedTLS 2.x 到 4.x 变了什么ROADMAP 原文明确v6.0 正在升级至 MbedTLS v4.x 和新的 PSA 加密 API且这项工作仍在进行后续 beta 或 RC 可能还会包含对加密 API 的进一步非兼容性更新。也就是说beta 阶段拿到的加密接口不能当作最终形态。仓库里可以佐证这个方向的改动components/mbedtls/ 下已存在 PSA 适配层 port/esp_psa_crypto_init.c其中调用psa_crypto_init()初始化 PSA 子系统components/mbedtls/test_apps/mbedtls_ut/ 提供了新 API 的现成参考如test_psa_cipher.c、test_psa_aes.c、test_psa_gcm.c仅test_psa_aes.c中就包含 15 处 PSA 调用点迁移时照着改即可。新旧调用对照以仓库测试用例中出现的新 API 为准旧路径MbedTLS 2.x 习惯用法v6.0 新路径MbedTLS 4.x / PSA说明mbedtls_aes_crypt_ecb()等模块级函数psa_cipher_encrypt()/psa_cipher_decrypt()对称加解密统一走 PSA 接口直接操作底层 crypto 模块统一走 PSA Crypto API仓库内port/esp_psa_crypto_init.c已完成初始化适配对读者意味着什么全局搜索项目里所有mbedtls_前缀的调用逐处对照 PSA 接口替换若基于 beta 编译过拿到 rc1 后必须重新编译验证一次加密相关模块。 v6.0 芯片兼容版本速查C5、C61、H4 分别要哪个版本COMPATIBILITY.md 给出了每个芯片版本的Required最低可运行版本芯片硅片版本Required / RecommendedESP32-C5v1.0自 v5.5.2 起支持ESP32-C5v1.2v5.5.2ESP32-C61v1.0 / v1.1v5.5.2ESP32-H4量产版v6.0 起提供预览支持两个实用命令可确认自己的现状文档中推荐做法esptool chip-id idf.py --version对读者意味着什么量产在用 C5/C61 的项目5.5.2 以上版本已经够用没有理由被迫抢升 6.0想评估 ESP32-H4 则必须跟 6.0 的预览线但预览版本按官方说明不会在正式版发布后继续维护评估用即可不建议上生产。 老项目升级路径先算 5.x 维护期再动代码升级 6.0 之前先看 ROADMAP_CN.md 里各 5.x 分支的最后期限v5.22026 年 8 月 EOL停止维护最后的 bugfix 是 v5.2.74/28和 v5.2.88/17——这是硬期限v5.32027 年 1 月 EOL期间还有 v5.3.5 / v5.3.6 / v5.3.7v5.42026 年 1 月起进入维护周期v5.52026 年 7 月起进入维护周期年内还会出 v5.5.3 至 v5.5.7 共 5 个 bugfix。动手升级前按仓库自带脚本检查环境依赖git clone https://gitcode.com/GitHub_Trending/es/esp-idf cd esp-idf ./install.sh ./export.sh python tools/check_python_dependencies.py对读者意味着什么生产环境还在 v5.2 的团队2026 年内必须排一次升级窗口否则 8 月之后没有官方修复5.4/5.5 用户则可以用先升到 5.5 最新 bugfix、再上 6.0的两段式路径降低风险。建议收藏 ROADMAP_CN.md 跟踪 v6.0.1~v6.0.4 的实际落地情况。下期预告5.x 到 6.0 的构建侧迁移——CMake 版本要求与 Kconfig 变更对照。【免费下载链接】esp-idfEspressif IoT Development Framework. Official development framework for Espressif SoCs.项目地址: https://gitcode.com/GitHub_Trending/es/esp-idf创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考