对于无屏的设备(如插座、灯泡等),用户无法通过输入Wi-Fi热点信息让设备接入网络,此时需要对这些设备进行配网操作。生活物联网平台为Wi-Fi设备提供了多种配网技术方案,使不具备人机交互能力的设备可以借助于一些特殊方式连上网络。
配网概述
配网是将路由器的Wi-Fi SSID和PASSWORD通过某种方式传递到终端设备,让终端设备可以接入Wi-Fi网络的过程。配网示意图如下所示。
通常情况下,用户使用App添加一个Wi-Fi设备的流程如下。
用户添加设备前的准备操作。 Wi-Fi设备配网(通过某种方式将目标AP的SSID和Password给到设备,使设备可连接上目标AP)。 用户账户与设备之间绑定。生活物联网平台提供了多种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)的配网流程如下。
设备开启自带的Wi-Fi热点。手机搜索并发现热点后,连接到该设备的热点。 建立连接通道后,手机将Wi-Fi热点(路由器)的SSID/密码发送给设备。 Wi-Fi设备使用该SSID/密码连接Wi-Fi热点(路由器)。零配配网
零配配网(zero-config)不需要用户在手机端输入Wi-Fi热点的SSID/密码,配网流程如下。
待配网设备向已连接Wi-Fi热点(路由器)的设备发送配网请求。 已连接Wi-Fi热点的设备向生活物联网平台上报新设备。 生活物联网平台向手机(App)获取待配网设备的信息。 手机向平台反馈待配网设备的详细信息。 平台向已连接Wi-Fi热点的设备下发对新设备配网的许可。 已连接Wi-Fi热点的设备向待配网设备推送Wi-Fi热点的SSID/密码信息。 待配网设备连接Wi-Fi热点。蓝牙辅助配网
蓝牙辅助配网(ble-config)方案无需区分手机的操作系统(iOS或Android的手机体验一样),且该方案的配网成功率和可靠性较高。使用该方案,设备需支持Wi-Fi与BLE双模通信能力。配网流程如下。
手机通过蓝牙连接待配网的双模设备。 手机通过蓝牙将Wi-Fi热点(路由器)的SSID/密码信息传送给设备。 设备连接Wi-Fi热点。一键配网
一键配网(smart-config)方案只需要用户输入Wi-Fi的密码即可。配网流程如下。
手机通过广播发送Wi-Fi热点的SSID/密码信息。 设备通过监听方式获取信息,并连接上网热点的方式。手机热点配网
手机启动一个预定义热点(例如:热点名为aha,密码为12345678),设备先连接到手机热点获取路由器上网热点信息,再连接上网热点的方式。该方案需要Wi-Fi切换相关的权限,如果没有授予权限可能会导致配网失败,建议将该方案作为备选方案。
手机启动一个预定义热点(例如:热点名为aha,密码为12345678),设备先连接到手机热点上。 手机将Wi-Fi热点的SSID/密码信息发送给Wi-Fi设备。 设备断开手机热点,连接Wi-Fi热点。摄像头扫码配网
摄像头扫码配网(webcam-config)针对拥有摄像头及二维码解码能力设备。配网流程如下。
通过App生成携带SSID、password等信息的二维码。 摄像头根据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"}