物联网设备配网与零配置接入实战

智能设备出厂没有 WiFi 密码，用户买到手要让它连上自家路由器。配网就是把「WiFi 名称 + 密码」安全地送进设备的过程，体验好坏直接决定产品能不能用起来。

配网做得好，用户三步完成；做得差，用户卡在扫码与输密码之间，退货率飙升。配网是物联网产品体验的第一道关。

配网不是技术问题，是第一印象问题。

SmartConfig 由乐鑫提出：手机连上路由器后，把 WiFi 密码编码进 UDP 广播报文，设备处于混杂监听模式抓取报文并解码。无需输入密码到设备，适合无屏幕设备。

// ESP32 SmartConfig 示例（Arduino 层）
WiFi.beginSmartConfig();
while (!WiFi.smartConfigDone()) {
  delay(500);
}
WiFi.stopSmartConfig();
// 配网完成后自动连接目标 WiFi

局限是依赖路由器不隔离广播、编码长度有限。实现时加超时与失败重试，并提示用户手机与设备尽量靠近。

AP 配网让设备自身开一个热点（如 SmartAP-XXXX），手机连上该热点后通过网页或 App 把家 WiFi 信息发给设备，设备拿到后关闭热点去连家网。

# AP 配网状态机
1. 设备进入配网模式，开启热点 SmartAP-XXXX
2. 手机连接该热点，打开配置页
3. 用户输入家 WiFi 名称与密码
4. 设备保存并切换连接家 WiFi
5. 配网成功，App 端刷新设备在线状态

AP 配网兼容性最好，几乎所有手机都能连热点；缺点是步骤多、超时保护要做足。

带蓝牙的设备用 BLE 配网体验最佳：手机 App 扫描到设备蓝牙，通过 GATT 服务把 WiFi 信息写入设备，还能顺带完成设备绑定与证书下发。

蓝牙配网适合中高端产品：交互反馈丰富、可做双向鉴权、配网与绑定一次完成。缺点是硬件成本略高、蓝牙协议栈调试工作量大。

扫码配网把 WiFi 信息编码进二维码，设备端摄像头扫码解析。适用于带摄像头的设备（如扫地机器人、智能门锁），或配合 App 扫码触发配网流程。

扫码内容要短：只放 SSID 与加密密钥的引用，真正密码通过安全通道下发。二维码有效期与次数限制防止被复用。