ESP-IDF v6.0 升級(jí)前先看這 3 件事加密 API 重寫、芯片邊界與 2026 行動(dòng)日歷【免費(fèi)下載鏈接】esp-idfEspressif IoT Development Framework. Official development framework for Espressif SoCs.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/es/esp-idfESP-IDF v6.0 是樂鑫官方開發(fā)框架的主版本更新組件庫(kù)、構(gòu)建系統(tǒng)、示例工程與 Wi-Fi/BLE/存儲(chǔ)等能力都包含在內(nèi)。這一版真正需要?jiǎng)邮衷u(píng)估的只有兩件事加密棧整體換到 MbedTLS v4.x全部加密調(diào)用轉(zhuǎn)向 PSA Crypto API以及 2026 年 Q1 到 Q4 的版本節(jié)奏。下面直接按誰會(huì)受影響、影響多大、每個(gè)時(shí)間點(diǎn)該做什么來講。加密 API 重寫哪些代碼必須動(dòng)哪些只要回歸先說結(jié)論影響只落在兩類人身上。?第一類業(yè)務(wù)代碼里直接調(diào) mbedtls 接口的——這是 v6.0 升級(jí)里工作量最集中的地方?？梢赃@么理解這次遷移舊版里mbedtls_xxx和psa_xxx兩套接口并存4.x 之后 PSA Crypto API 成了主路徑很多傳統(tǒng)函數(shù)被廢棄或改名。你的 AES、SHA、ECDSA 調(diào)用點(diǎn)都要對(duì)著新接口逐個(gè)過一遍換個(gè)參數(shù)名這種輕量遷移基本不存在。mbedtls 源碼以子模塊形式放在 components/mbedtls/倉(cāng)庫(kù)里掛的是樂鑫自維護(hù)的分支上層封裝和平臺(tái)適配在components/mbedtls/port/子目錄——也就是說它不是上游原版 mbedtls 的簡(jiǎn)單拷貝個(gè)別行為差異要以樂鑫的適配代碼為準(zhǔn)。組件的 components/mbedtls/Kconfig 里已經(jīng)有一個(gè)總開關(guān)MBEDTLS_VER_4_X_SUPPORT默認(rèn) y控制整套 4.x 路徑CONFIG_MBEDTLS_PSA_ITS_CUSTOM_STORAGE_BACKEND默認(rèn)關(guān)則決定 PSA 密鑰存儲(chǔ)能不能掛自定義后端密鑰存 NVS 以外的地方時(shí)才會(huì)用到。第二類通過組件間接用 TLS 的esp-tls、http_client、https_server 這類用戶——代碼大概率一行不用改但要留排期。官方在 ROADMAP_CN.md 里把話說得很直白MbedTLS v4.x 與 PSA Crypto API 的升級(jí)還在進(jìn)行中即將發(fā)布的 beta 版本或 RC 版本可能會(huì)包含對(duì)加密 API 的進(jìn)一步更新或非兼容性更新。實(shí)際做法是在 v6.0-beta2 或 v6.0-rc1 出來后跑一輪完整回歸——編譯過、TLS 握手過、證書校驗(yàn)過、密鑰讀寫過四件事都綠再切正式版。別把回歸壓到正式版當(dāng)天API 萬一又動(dòng)了一下排期會(huì)很被動(dòng)。排查兼容問題時(shí)examples/security/flash_encryption、key_manager和 examples/protocols/https_server 是現(xiàn)成的參照路徑把項(xiàng)目里密鑰管理與證書配置的邏輯和它們對(duì)齊著看能快速定位差異點(diǎn)。芯片支持邊界C5/C61 放心上量H21/H4 還要等芯片版本的支持邊界以 COMPATIBILITY_CN.md 為準(zhǔn)跟 v6.0 直接相關(guān)的幾條芯片系列狀態(tài)對(duì)應(yīng)版本ESP32-C5v1.0 從 v5.5.2 開始支持v1.2 的推薦版本與需求版本均為 v5.5.2 及以上分支v6.0 延續(xù)正式支持ESP32-C61v1.0 從 v5.5.2 開始支持v1.1 推薦/需求版本同為 v5.5.2 及以上v6.0 延續(xù)正式支持ESP32-H4v6.0 起提供預(yù)覽支持預(yù)覽版在該系列正式支持發(fā)布后即停止維護(hù)量產(chǎn)以正式版為準(zhǔn)量產(chǎn)支持待落地ESP32-H21文檔只承諾芯片達(dá)到量產(chǎn)狀態(tài)時(shí)增加對(duì)其量產(chǎn)版本的初步支持進(jìn)展在開發(fā)者門戶跟蹤兩個(gè)提醒工具命令變了查芯片系列和版本v6.0 起用esptool chip-idv5.5 及更早版本還是esptool.py chip_id。寫腳本的人注意這個(gè)斷點(diǎn)CI 里兩條命令要分開配。另可用idf.py --version核對(duì)當(dāng)前框架版本。預(yù)覽支持不等于量產(chǎn)支持。H4 的 v6.0 預(yù)覽版適合做預(yù)研驗(yàn)證別拿它跑產(chǎn)線。2026 版本日歷每個(gè)節(jié)點(diǎn)該做什么官方排期全部來自 ROADMAP_CN.md。文檔同時(shí)聲明這些是方向性計(jì)劃不是約束性承諾具體日期可能調(diào)整。Q1v6.0 正式版2026-02-27遷移窗口從 beta 就開始了v6.0 的 beta2 在 01/27、rc1 在 02/22、正式版 02/27 三連發(fā)。同一季度 02/13 還有 v5.5.3——還在舊分支上的團(tuán)隊(duì)先把這個(gè)補(bǔ)丁吃掉。Q1 的核心動(dòng)作不是等正式版而是用 beta/rc 把加密路徑跑一遍。Q2v6.1-beta106/11 舊分支密集打補(bǔ)丁v6.0.1 于 06/04 發(fā)布v6.1 走 beta106/11→ rc107/23→ 正式版07/31。舊分支方面v5.2.704/28、v5.5.405/08、v5.3.607/02、v6.0.206/04排隊(duì)落地。Q2 的任務(wù)清單就一條用 v6.1-beta1 做第二輪回歸重點(diǎn)看 rc 階段加密 API 有沒有再變。Q3v6.1 正式版07/31——建議的正式切換點(diǎn)v6.1 正式版之后加密 API 基本定型是比 v6.0 更早暴露問題的更穩(wěn)切換點(diǎn)。同期 bugfixv5.5.507/30、v5.2.808/17v5.2 的最后一發(fā)、v6.0.309/10、v6.1.109/03、v5.4.509/28。Q4v6.211/11 beta1 → 12/31 正式版把主力分支定下來v6.0 和 v6.1 兩條分支全年持續(xù)出 bugfixv6.0.4 于 11/18、v6.1.2 于 10/22、v6.1.3 于 12/16、v5.5.6 于 10/08文檔的目標(biāo)是使這兩個(gè)分支更加穩(wěn)定和產(chǎn)品化。Q4 要做的決策是產(chǎn)品線主力停在 v6.0 還是 v6.1兩條分支都長(zhǎng)期有補(bǔ)丁選哪個(gè)取決于你對(duì) bugfix 節(jié)奏的偏好。舊分支的遷移期限比 v6.0 發(fā)布時(shí)間更緊這張表建議截圖存檔分支維護(hù)窗口窗口內(nèi)的最后補(bǔ)丁release/5.22026 年 8 月底 EOLv5.2.704/28、v5.2.808/17release/5.32027 年 1 月底 EOLv5.3.503/09、v5.3.607/02、v5.3.72027/01/18release/5.42026-01 進(jìn)入維護(hù)周期v5.4.404/03、v5.4.509/28release/5.52026-07 進(jìn)入維護(hù)周期v5.5.302/13、v5.5.405/08至 v5.5.72027/01/11還在 v5.2 上的產(chǎn)品2026 年 8 月 17 日之后就沒有補(bǔ)丁可拿了v5.3 的窗口到 2027 年 1 月 18 日關(guān)。這兩條線要提前排分支切換或鎖死最后 bugfix 版本別卡在 EOL 當(dāng)天。收束升級(jí) v6.0 前跑完這 5 步全倉(cāng) grep 直接調(diào)用 mbedtls 接口的代碼點(diǎn)逐個(gè)映射到 PSA Crypto API——v6.0 里工作量最大的一塊先估時(shí)再排期。beta/rc 階段跑 TLS 全鏈路回歸編譯、握手、證書校驗(yàn)、密鑰讀寫以examples/security/的flash_encryption、key_manager和 examples/protocols/https_server 作參照排查差異。檢查構(gòu)建與產(chǎn)測(cè)腳本v6.0 用esptool chip-idv5.5 及更早用esptool.py chip_id命令斷點(diǎn)要分開處理。idf.py menuconfig確認(rèn)CONFIG_MBEDTLS_VER_4_X_SUPPORT仍是 y別被歷史配置意外關(guān)掉。芯片決策C5/C61 直接上量H4 預(yù)覽版只做預(yù)研H21/H4 的量產(chǎn)支持以芯片量產(chǎn)狀態(tài)和開發(fā)者門戶跟蹤頁(yè)為準(zhǔn)。從源碼分支跑 v6.0 的完整流程git clone https://gitcode.com/GitHub_Trending/es/esp-idf cd esp-idf git checkout release/v6.0 ./install.sh # Windows 用 install.bat source export.sh # 每個(gè)新終端重新執(zhí)行一次 cd 示例工程 idf.py set-target esp32c6 idf.py build flash monitorWi-Fi 相關(guān)場(chǎng)景的驗(yàn)證工程在 examples/wifi/ 下getting_started、power_save、ftm各子目錄可按測(cè)試目標(biāo)直接取用?！久赓M(fèi)下載鏈接】esp-idfEspressif IoT Development Framework. Official development framework for Espressif SoCs.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/es/esp-idf創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考