uploaded 15 hours ago
Controller-side network provisioning client for Wi-Fi and Thread (SoftAP/HTTP, BLE, Console)
Readme (zh)
# Network Provisioner
面向 [espressif/network_provisioning](https://components.espressif.com/components/espressif/network_provisioning) 的**控制器侧**配网客户端。
| 组件 | 角色 |
|------|------|
| **network_provisioning** | 设备端 **Server** |
| **protocomm_ext** | 控制器 **管道**（传输 + Sec0/1/2） |
| **network_provisioner**（本组件） | 控制器 **业务**（`prov-config` / `prov-scan` / `prov-ctrl`） |
## 能力矩阵
| 链路 \\ 凭证 | Wi-Fi | Thread |
|--------------|:-----:|:------:|
| SoftAP + HTTP | ✓ | — |
| BLE | ✓ | ✓ |
| UART Console | 调试 | 调试 |
## 典型流程
推荐按对端 `proto-ver` 运行时识别安全等级：
```c
network_provisioner_t *np = network_provisioner_create(pc);
network_provisioner_fetch_capabilities(np, NULL);
network_provisioner_capabilities_t caps = {0};
network_provisioner_get_capabilities(np, &caps);
network_provisioner_security_t sec = { .sec_ver = caps.sec_ver, .pop = "abcd1234" };
network_provisioner_set_security(np, &sec);
network_provisioner_establish_security(np);
network_provisioner_provision_wifi(np, &creds, NULL);
network_provisioner_stop_session(np);
network_provisioner_delete(np);
```
若安全方案已知，仍可用 `network_provisioner_start_session()` 一步完成。
BLE 控制器可以不直接创建传输，改用 `network_provisioner_create_ble()`，再调用 `network_provisioner_ble_scan()` / `network_provisioner_ble_connect_cfg()`。应用自己的端点用 `network_provisioner_add_endpoint()` 和 `network_provisioner_send()`。
**线程安全：** 同一实例的 API 非线程安全，请在单任务中串行调用。
## 依赖
```yaml
dependencies:
espressif/network_provisioner: "^2.0.0"
```
## 测试 / 示例
- 测试：`components/network_provisioner/test_apps`
- 示例：`examples/network_provisioner`（同一工程可选 SoftAP / BLE / Thread）
**支持目标：** ESP32 / ESP32-S3 / ESP32-C2 / ESP32-C3 / ESP32-C5 / ESP32-C6 / ESP32-C61 / ESP32-H2 / ESP32-P4
## 许可证
Apache-2.0，见 `license.txt`。
Links
- Homepage
-
Repository
be7379fd47a5c787ae50b3a0d6ce6d585ef65045
- Issues
- License
- Changelog
To add this component to your project, run:
download archive
idf.py add-dependency "espressif/network_provisioner^2.0.0"
Stats
-
Archive size ~ 55.12 KB
-
Downloaded in total 28 times
-
Weekly Downloads (All Versions)
-
This version: 0 times
Badge
