WiFi配网流程—SmartConfig 配网流程
目录
📌 SmartConfig 配网流程
👉 阶段 1:设备进入配网模式
👉 阶段 2:手机 App 发送 Wi-Fi 配置信息
👉 阶段 3:设备解析 Wi-Fi 配置,连接家庭网络
👉 阶段 4:App 检测设备是否上线,完成配网
📌 SmartConfig 配网技术架构
📌 SmartConfig 配网的核心技术
📌 SmartConfig 配网的优缺点
🔍 SmartConfig vs Soft-AP vs BLE配网
📌 SmartConfig 配网流程
SmartConfig 配网的核心思路是:
📡 让手机充当“信息广播器”,使用 UDP 广播/组播 Wi-Fi SSID & 密码,让设备被动监听并解析出 Wi-Fi 信息,完成自动联网。
👉 阶段 1:设备进入配网模式
🔹 过程
- 设备启动后,检测 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 热点,用户无需手动切换网络。
👉 阶段 2:手机 App 发送 Wi-Fi 配置信息
🔹 过程
- 用户打开 App,选择 SmartConfig 配网模式。
- App 获取当前已连接的 Wi-Fi SSID,并提示用户输入 Wi-Fi 密码。
- App 通过 Wi-Fi UDP 广播 / 组播 方式,将 SSID 和密码编码到 Wi-Fi 数据包中,并不断发送。
- 设备监听网络中的 Wi-Fi 包,并解析出 SSID 和密码。
🔹 常见编码方式:
-
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 失败。
👉 阶段 3:设备解析 Wi-Fi 配置,连接家庭网络
🔹 过程
- 设备解析 Wi-Fi 数据包,获取 SSID 和密码。
- 设备关闭监听模式(Promiscuous Mode),切换到 STA 模式。
- 设备尝试连接目标 Wi-Fi:
- 连接成功,获取路由器分配的 IP 地址。
- 连接失败,可能返回 SmartConfig 模式,等待用户重新发送数据。
- 设备上报 Wi-Fi 连接状态:
- 可通过 MQTT / HTTP 向云端上报状态。
- 可通过 UDP 广播 在局域网内通知 App。
🔹 技术要点
✅ 设备进入 STA 模式 连接 Wi-Fi。
✅ Wi-Fi 连接成功后上报状态,App 通过局域网或云端获取状态
✅ 设备会将 Wi-Fi 配网信息存储到 Flash(NVS),确保断电后仍可记住 Wi-Fi 连接。
👉 阶段 4:App 检测设备是否上线,完成配网
🔹 过程
- 设备连接 Wi-Fi 成功后,自动连接云端服务器或在局域网广播自身信息。
- App 通过以下方式发现设备:
- 局域网 UDP 组播 / mDNS / SSDP 发现。
- 设备云端注册(MQTT / HTTP 上报上线状态)。
- 设备上线后,App 提示用户配网成功,用户可正常控制设备。
🔹 技术要点
✅ UDP 广播 / mDNS 设备发现。
✅ MQTT / HTTP 设备云端注册。
📌 SmartConfig 配网技术架构
[ 设备 (Wi-Fi 监听模式) ]
↓ (监听 Wi-Fi 广播)
[ App 通过 UDP 发送 Wi-Fi 配置 ]
↓ (设备解析 SSID/密码)
[ 设备加入家庭 Wi-Fi ]
↓ (局域网发现 / 云端注册)
[ 设备上线,配网成功 ]
📌 SmartConfig 配网的核心技术
技术 | 作用 |
---|---|
Wi-Fi 监听模式(Promiscuous Mode) | 设备在不连接 Wi-Fi 的情况下捕获数据包 |
UDP 广播 / 组播 | App 通过 UDP 发送 Wi-Fi 配置 |
Wi-Fi 包长编码 | 设备解析 UDP 包,获取 Wi-Fi SSID 和密码 |
STA 模式 | 设备连接家庭 Wi-Fi |
mDNS / SSDP | 设备在局域网中发现 |
MQTT / WebSocket / HTTP | 设备云端上报状态 |
📌 SmartConfig 配网的优缺点
优点 | 缺点 |
---|---|
用户无需手动切换 Wi-Fi,体验更流畅 | 部分路由器丢弃 UDP 广播包,可能导致配网失败 |
适用于无屏设备(如智能灯泡、插座) | 配网成功率依赖 Wi-Fi 网络环境 |
可同时配网多个设备 | 无法兼容 5GHz 设备(只能 2.4GHz) |
🔍 SmartConfig vs Soft-AP vs BLE配网
配网方式 | 是否需要手动切 Wi-Fi | 连接稳定性 | 设备要求 | 适用场景 |
---|---|---|---|---|
SmartConfig(AirKiss / EZ Mode) | ❌ 不需要 | 可能不稳定(受干扰) | 设备需支持 UDP 配网 | 适用于 Wi-Fi 设备 |
Soft-AP 配网 | ✅ 需要 | 稳定 | 设备需支持 Wi-Fi | 适用于 Wi-Fi 设备 |
BLE 配网 | ❌ 不需要 | 稳定 | 设备需支持 BLE | 适用于 Wi-Fi + BLE 设备 |