Wi-Fi设备配网方案介绍 / 四六文摘

对于无屏的设备（如插座、灯泡等），用户无法通过输入Wi-Fi热点信息让设备接入网络，此时需要对这些设备进行配网操作。生活物联网平台为Wi-Fi设备提供了多种配网技术方案，使不具备人机交互能力的设备可以借助于一些特殊方式连上网络。

配网概述

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

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

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


配网方式	配网技术	简要说明	补充说明
设备热点配网（dev-ap-config）	手机连设备热点传数据	App连接设备起的热点传输配网信息给设备	推荐使用该配网方式
零配配网（zero-config）	Wi-Fi管理帧传数据	已配网设备传输配网信息给待配网设备	当前环境中，具有可以为待配设备进行配网的设备，该方案无需用户输入Wi-Fi密码，推荐您使用
蓝牙辅助配网（ble-config）	BLE（Bluetooth）传数据	App通过蓝牙通道传输配网信息给设备	设备必须支持Wi-Fi与BLE双模通信（combo chip），推荐您使用该配网方式
一键配网（smart-config或广播配网）	广播密文包长编码（bcast）	App通过广播报文传输配网信息给设备	-
	P2P密文编码（p2p）	App通过P2P报文传输配网信息给设备	仅Android支持，SSID和Password的长度之和不能大于32Byte（部分三星手机不能大于25Byte）
	组播密文编码（mcast）	App通过组播报文传输配网信息给设备	-
手机热点配网（phone-ap-config）	手机起热点，设备连接传数据	App起固定热点，设备自动发起连接，通过连接通道传输配网信息	iOS需要手动设置热点再切回App
摄像头扫码配网（webcam-config）	摄像头扫码解析数据	App生成二维码，放置于摄像头设备前识别解析其中的配网信息	设备须具备摄像头，且支持二维码解码能力

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

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

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

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

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

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

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


Key	描述	是否必选
v	version，版本号，区分为阿里的二维码规则，当前为Ali_1	必选
s	ssid，家庭路由SSID	必选
p	password，家庭路由密码	必选
b	BSSID，家庭路由的BSSID信息，Hex String，解决gbk编码等问题	必选
t	token，绑定需要的Token信息，3 Bytes random string	可选

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

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