当前位置：首页 > article >正文

WiFi配网流程—SmartConfig 配网流程

article 2026/4/28 6:16:23

📌 SmartConfig 配网流程

👉 阶段 1：设备进入配网模式

👉 阶段 2：手机 App 发送 Wi-Fi 配置信息

👉 阶段 3：设备解析 Wi-Fi 配置，连接家庭网络

👉 阶段 4：App 检测设备是否上线，完成配网

📌 SmartConfig 配网技术架构

📌 SmartConfig 配网的核心技术

📌 SmartConfig 配网的优缺点

🔍 SmartConfig vs Soft-AP vs BLE配网

SmartConfig 配网的核心思路是：
📡 让手机充当“信息广播器”，使用 UDP 广播/组播 Wi-Fi SSID & 密码，让设备被动监听并解析出 Wi-Fi 信息，完成自动联网。

🔹 过程

设备启动后，检测 Wi-Fi 连接状态：
- 若已有 Wi-Fi 配置，尝试连接已存 Wi-Fi；
- 若无 Wi-Fi 配置（首次使用或长按复位），进入 SmartConfig 配网模式。
设备切换到 Wi-Fi 监听模式（Promiscuous Mode），开始监听所有 Wi-Fi 报文。
设备等待 App 通过广播 / 组播方式发送 Wi-Fi 配置数据。

🔹 技术要点
✅ 监听模式（Promiscuous Mode）：设备捕获所有 Wi-Fi 包（非正常连接模式）。
✅ 无需 Soft-AP 热点：设备不创建 Wi-Fi 热点，用户无需手动切换网络。

🔹 过程

🔹 常见编码方式：

AirKiss（微信版）：
- 采用 UDP 变长包编码，通过 Wi-Fi 广播 SSID & 密码。
- 设备通过数据包的长度变化，解码出 SSID 和密码。
EZ Mode（涂鸦版）：
- 采用 UDP 固定长度数据包 + MAC 地址索引方式。
- 设备根据收到的 Wi-Fi 包信息，解析 SSID & 密码。
SmartConfig（ESP8266 / TI）：
- 采用 UDP 变频调制，通过特定 Wi-Fi 信道序列传输 SSID & 密码。
- 设备监听 Wi-Fi 信道变化，解析配网数据。

🔹 技术要点
✅ UDP 广播 / 组播 方式，允许设备无需连接 Wi-Fi 即可接收数据。
✅ 不同设备的兼容性：部分低端路由器 可能会丢弃异常 UDP 包，导致 SmartConfig 失败。

🔹 过程

🔹 技术要点
✅ 设备进入 STA 模式 连接 Wi-Fi。
✅ Wi-Fi 连接成功后上报状态，App 通过局域网或云端获取状态
✅ 设备会将 Wi-Fi 配网信息存储到 Flash（NVS），确保断电后仍可记住 Wi-Fi 连接。

🔹 过程

设备连接 Wi-Fi 成功后，自动连接云端服务器或在局域网广播自身信息。
App 通过以下方式发现设备：
- 局域网 UDP 组播 / mDNS / SSDP 发现。
- 设备云端注册（MQTT / HTTP 上报上线状态）。
设备上线后，App 提示用户配网成功，用户可正常控制设备。

🔹 技术要点
✅ UDP 广播 / mDNS 设备发现。
✅ MQTT / HTTP 设备云端注册。

[ 设备 (Wi-Fi 监听模式) ]↓  (监听 Wi-Fi 广播)
[ App 通过 UDP 发送 Wi-Fi 配置 ]↓  (设备解析 SSID/密码)
[ 设备加入家庭 Wi-Fi ]↓  (局域网发现 / 云端注册)
[ 设备上线，配网成功 ]

配网方式	是否需要手动切 Wi-Fi	连接稳定性	设备要求	适用场景
SmartConfig（AirKiss / EZ Mode）	❌ 不需要	可能不稳定（受干扰）	设备需支持 UDP 配网	适用于 Wi-Fi 设备
Soft-AP 配网	✅ 需要	稳定	设备需支持 Wi-Fi	适用于 Wi-Fi 设备
BLE 配网	❌ 不需要	稳定	设备需支持 BLE	适用于 Wi-Fi + BLE 设备