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

配网概述

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

jt31

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

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

Wi-Fi配网方式对比

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

jt33
配网方式 配网技术 简要说明 补充说明
设备热点配网(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)的配网流程如下。

设备热点配网
  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会将完整二维码信息(二维码中携带的信息如下表所示)回调并开启局域网监听,您需要展现二维码并监听配网结果。

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"}