ESP-IDF v6.0 更新解读安全栈升级 PSA Crypto 与芯片矩阵扩展【免费下载链接】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 预览支持。对跑在 v5.x 上的项目这是一次必须认真评估的大版本升级加密相关的代码路径存在 breaking change而 Wi-Fi、存储、驱动等大部分功能面变化有限。关键信息速览版本号v6.0计划正式发布于 2026 年 2 月 27 日基线时间以 ROADMAP_CN.md 公布的 2026 年 2 月节点为准核心依赖变更MbedTLS 升级至 v4.x加密接口统一收敛到 PSA Crypto API芯片变化新增 ESP32-H4 预览支持ESP32-C5 / ESP32-C61 在 v5.5.2 起为预览v6.0 是首个完整覆盖的大版本向后兼容不向后兼容加密 API 存在破坏性变更v6.0 开发时间线只列开发者需要关心的节点v6.0-beta22026 年 1 月 27 日第二个可用测试版v6.0-RC12026 年 2 月 22 日候选版本接近冻结v6.0 正式版2026 年 2 月 27 日官方明确提示由于 MbedTLS v4.x 与 PSA API 的迁移工作仍在进行beta 和 RC 阶段仍可能包含加密 API 的进一步更新或非兼容性更新。也就是说如果你基于 beta 版本做了验证正式版发布前值得重新跑一遍加密相关回归。逐条拆解本次变更以下按影响面排序先说会动你代码的再说影响选型和排期的。⚠️ 安全栈升级MbedTLS v4.x 与 PSA Crypto API 迁移改了什么components/mbedtls 组件整体按 MbedTLS v4.x 结构重组底层加密能力收敛到 PSA Crypto API代码树中可见独立的tf-psa-crypto目录。v5.x 时代直接调用mbedtls_*前缀旧接口的代码在 v6.0 中需要改写为 PSA 风格调用。对谁有影响只要你的项目直接调用过mbedtls_aes_*、mbedtls_ssl_*这类 API就需要关注。典型场景包括自己实现的 HTTPS 客户端、Flash 加密、NVS 加密、HMAC/证书校验逻辑。只调用 ESP 高层 API如esp_https_ota且未碰底层加密的项目影响相对小。怎么应对在代码库里全局搜索mbedtls_前缀先圈出直接调用点逐文件评估改写工作量对照 examples/security 下的 flash_encryption、key_manager、nvs_encryption_hmac 等示例它们已按新体系更新可以作为改写参照常用旧接口到新 API 的对照旧版本 APIv5.xv6.0 替代PSA 体系mbedtls_aes_crypt_ecb()psa_cipher_encrypt()mbedtls_ssl_init()psa_ssl_init()另外 components/mbedtls 的sdkconfig.rename里可以看到原本面向特定安全元件ATCA的 ECDSA 配置项已合并为通用的CONFIG_MBEDTLS_SECURE_ELEMENT_DRIVER_ENABLED如果你的 Kconfig 里写过这些选项sdkconfig需要清理重配。芯片矩阵扩展ESP32-H4 预览支持与 C5 / C61 落地改了什么COMPATIBILITY_CN.md 显示ESP32-H4 自 v6.0 开始提供预览支持ESP32-C5v1.0/v1.2和 ESP32-C61v1.0/v1.1从 v5.5.2 起即为预览状态v6.0 是首个大版本基线覆盖这两颗芯片的发布。对谁有影响如果你的硬件立项包含 H4或者 C5 / C61 已经打板但还在 v5.5.x 上验证需要关注。量产项目则反过来预览支持在正式发布后不再维护量产请以正式版为准。怎么应对先用esptool chip-id确认目标芯片的系列与版本号再对照兼容性表中的需求版本 / 推荐版本新芯片项目建议直接用 v6.0 的 RC 版本起步避免在预览支持期内做量产决策examples/wifi、examples/peripherals 下均有对应芯片的验证示例可直接复用。维护策略v5.2 / v5.3 走向 EOL排期需要跟上改了什么ROADMAP_CN.md 给出了明确的时间表v5.2 在 2026 年 8 月底 EOL 前还有 v5.2.7、v5.2.8 两个补丁版v5.3 在 2027 年 1 月底 EOL 前有 v5.3.5~v5.3.7release/5.4 分支 2026 年 1 月进入维护周期release/5.5 在 7 月进入维护周期。v6.0 与 v6.1 分支则会持续发 bugfix 版本。对谁有影响量产固件还停留在 v5.2 / v5.3 的团队等于被排上了升级倒计时这不是可选项。怎么应对把 v6.0 正式版 首个 v6.0.x bugfix 版本计划 2026 年 4 月 10 日的 v6.0.1作为升级目标版本写进排期留出一个完整版本的验证窗口。动手验证拿到 v6.0 后的最小验证步骤# 1. 确认版本 idf.py --version # 2. 构建并烧写一个加密相关示例 idf.py -B build_v60 set-target esp32 idf.py -B build_v60 -p /dev/ttyUSB0 flash monitor示例目录可用 examples/security/flash_encryption 或 examples/security/key_manager。预期结果idf.py --version输出的版本号为v6.0串口监视器中 bootloader 启动日志打印的版本字符串同样以v6.0开头。两条都对上才算真正跑在 v6.0 上。顺带一提如果你手头的仓库检出是 master 分支注意它已越过 v6.0 基线本仓库快照的版本宏为 6.2.0-dev做 v6.0 的验证和迁移时请切到对应的 release/v6.0 分支。边界与已知限制加密 API 在 beta / RC 阶段仍可能继续变。官方原话是 beta 或 RC 可能会包含对加密 API 的进一步更新或非兼容性更新迁移代码建议压在正式版上不要过早锁定ESP32-H4 只是预览支持正式发布后该预览通道即停止维护基于 H4 的量产评估要等后续正式版v5.2 的 EOL 时间是 2026 年 8 月底届时没有新的 bugfix 兜底还停留在这个分支的量产固件要提前规划后续值得关注的方向v6.1 计划 2026 年 7 月 31 日、v6.2 计划 2026 年 12 月 31 日发布新增 ESP32-H21 芯片支持进展以芯片量产状态为准v6.0 分支将按计划发布 v6.0.1 ~ v6.0.4 等 bugfix 版本升级窗口期可以跟着补丁版走如果你的项目目前跑在 v5.x建议正式版发布后先花 10 分钟跑一遍idf.py --version与加密示例构建确认自己的 API 调用面再排迁移。【免费下载链接】esp-idfEspressif IoT Development Framework. Official development framework for Espressif SoCs.项目地址: https://gitcode.com/GitHub_Trending/es/esp-idf创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考