配网

[English]

重大变更

本次更新从 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 安全配置选项的默认值已更改:

依赖 protocomm 安全版本 0 或 1 的项目需要在其配置中显式启用这些选项。如果您的应用程序使用 protocomm 安全版本 0(无安全)或版本 1(Curve25519 + AES-CTR),则必须在项目的 sdkconfig 中或通过 menuconfig 显式启用相应的配置选项:

此项变更旨在默认减少代码大小,并鼓励使用更安全的 protocomm 实现。


此文档对您有帮助吗?