配网
重大变更
本次更新从 ESP-IDF 中移除了组件 wifi_provisioning
,更名为 network_provisioning
并作为一个独立组件受到支持。该组件增加了对Thread 配网的支持。可在乐鑫组件注册表中,查看更多有关 network_provisioning
的信息:
在新版应用程序中, main
组件文件夹应包括组件管理器清单文件 idf_component.yml
,如下所示:
dependencies:
espressif/network_provisioning:
version: "^1.0.5"
对于使用 ESP-IDF v5.x 及以后版本的应用程序,需要通过添加组件管理器清单文件 idf_component.yml
拉取新版 network_provisioning
组件。同时,在编译时,应去掉已过时的 wifi_provisioning
组件。此项操作可通过项目 CMakeLists.txt
中的以下语句实现:
set(EXCLUDE_COMPONENTS wifi_provisioning)
在新版的组件中,组件接口名有所更新,绝大多数的改动是将原组件中的 wifi_prov_xx
改为 network_prov_xx
。下表展示了其余的应用程序接口在新旧组件中的变化:
原组件接口 |
现组件接口 |
---|---|
wifi_prov_mgr_is_provisioned |
network_prov_mgr_is_wifi_provisioned |
wifi_prov_mgr_configure_sta |
network_prov_mgr_configure_wifi_sta |
wifi_prov_mgr_reset_provisioning |
network_prov_mgr_reset_wifi_provisioning |
wifi_prov_mgr_reset_sm_state_on_failure |
network_prov_mgr_reset_wifi_sm_state_on_failure |
wifi_prov_mgr_reset_sm_state_for_reprovision |
network_prov_mgr_reset_wifi_sm_state_for_reprovision |
配置变更
Protocomm 安全配置
为了默认提高安全性,protocomm 安全配置选项的默认值已更改:
CONFIG_ESP_PROTOCOMM_SUPPORT_SECURITY_VERSION_0 现在默认为
n
(原为y
)CONFIG_ESP_PROTOCOMM_SUPPORT_SECURITY_VERSION_1 现在默认为
n
(原为y
)
依赖 protocomm 安全版本 0 或 1 的项目需要在其配置中显式启用这些选项。如果您的应用程序使用 protocomm 安全版本 0(无安全)或版本 1(Curve25519 + AES-CTR),则必须在项目的 sdkconfig
中或通过 menuconfig
显式启用相应的配置选项:
对于安全版本 0:启用 CONFIG_ESP_PROTOCOMM_SUPPORT_SECURITY_VERSION_0
对于安全版本 1:启用 CONFIG_ESP_PROTOCOMM_SUPPORT_SECURITY_VERSION_1
此项变更旨在默认减少代码大小,并鼓励使用更安全的 protocomm 实现。