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