# 配网

[English]

## 重大变更

本次更新从 ESP-IDF 中移除了组件 `wifi_provisioning`，更名为 `network_provisioning` 并作为一个独立组件受到支持。该组件增加了对Thread 配网的支持。可在乐鑫组件注册表中，查看更多有关 `network_provisioning` 的信息：

- 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 实现。

此文档对您有帮助吗？

- 反馈已收到，谢谢！
- 如果您有其他意见，欢迎填写乐鑫文档反馈表。

- 我们重视您的反馈。
- 您可以填写乐鑫文档反馈表告诉我们如何改进该文档。