Wi-Fi设备配网方案介绍

配网概述

配网是将路由器的Wi-Fi SSID和PASSWORD通过某种方式传递到终端设备，让终端设备可以接入Wi-Fi网络的过程。配网示意图如下所示。

通常情况下，用户使用App添加一个Wi-Fi设备的流程如下。

1. 用户添加设备前的准备操作。
2. Wi-Fi设备配网（通过某种方式将目标AP的SSID和Password给到设备，使设备可连接上目标AP）。
3. 用户账户与设备之间绑定。

Wi-Fi配网方式对比

生活物联网平台提供了多种Wi-Fi设备的配网方式（各种方式的对比如下表所示），Wi-Fi设备配网方式的总体场景示意图如下。

设备热点配网

设备热点配网（dev-ap-config）的配网流程如下。

1. 设备开启自带的Wi-Fi热点。手机搜索并发现热点后，连接到该设备的热点。
2. 建立连接通道后，手机将Wi-Fi热点（路由器）的SSID/密码发送给设备。
3. Wi-Fi设备使用该SSID/密码连接Wi-Fi热点（路由器）。

零配配网

零配配网（zero-config）不需要用户在手机端输入Wi-Fi热点的SSID/密码，配网流程如下。

1. 待配网设备向已连接Wi-Fi热点（路由器）的设备发送配网请求。
2. 已连接Wi-Fi热点的设备向生活物联网平台上报新设备。
3. 生活物联网平台向手机（App）获取待配网设备的信息。
4. 手机向平台反馈待配网设备的详细信息。
5. 平台向已连接Wi-Fi热点的设备下发对新设备配网的许可。
6. 已连接Wi-Fi热点的设备向待配网设备推送Wi-Fi热点的SSID/密码信息。
7. 待配网设备连接Wi-Fi热点。

蓝牙辅助配网

蓝牙辅助配网（ble-config）方案无需区分手机的操作系统（iOS或Android的手机体验一样），且该方案的配网成功率和可靠性较高。使用该方案，设备需支持Wi-Fi与BLE双模通信能力。配网流程如下。

1. 手机通过蓝牙连接待配网的双模设备。
2. 手机通过蓝牙将Wi-Fi热点（路由器）的SSID/密码信息传送给设备。
3. 设备连接Wi-Fi热点。

一键配网

一键配网（smart-config）方案只需要用户输入Wi-Fi的密码即可。配网流程如下。

1. 手机通过广播发送Wi-Fi热点的SSID/密码信息。
2. 设备通过监听方式获取信息，并连接上网热点的方式。

手机热点配网

手机启动一个预定义热点（例如：热点名为aha，密码为12345678），设备先连接到手机热点获取路由器上网热点信息，再连接上网热点的方式。该方案需要Wi-Fi切换相关的权限，如果没有授予权限可能会导致配网失败，建议将该方案作为备选方案。

1. 手机启动一个预定义热点（例如：热点名为aha，密码为12345678），设备先连接到手机热点上。
2. 手机将Wi-Fi热点的SSID/密码信息发送给Wi-Fi设备。
3. 设备断开手机热点，连接Wi-Fi热点。

摄像头扫码配网

摄像头扫码配网（webcam-config）针对拥有摄像头及二维码解码能力设备。配网流程如下。

1. 通过App生成携带SSID、password等信息的二维码。
2. 摄像头根据App的二维码画面解码出信息，连接路由器。

您将SSID、password信息传入SDK后，SDK会将完整二维码信息（二维码中携带的信息如下表所示）回调并开启局域网监听，您需要展现二维码并监听配网结果。

二维码按JSON规则拼接，示例如下。

{"v":"Ali_1","s":"Router","p":"12345678","b":"EC26CAB68CC","t":"93DAB7"}