设备配网

更新时间:2024-05-20 02:38:46下载pdf

智慧行业 App SDK 提供把智能设备配置上路由器或网关的能力。以常见的 Wi-Fi 快连为例,SDK 从云端获取配网 Token,再经由 App 来广播配网信息(路由 ID、密码和配网 Token)。智能设备接收到后,开始快速激活,同时连接到 App 和云端,开启设备上云的第一步。

功能说明

设备配网支撑的具体能力包括:

  • Wi-Fi 设备配网

    • Wi-Fi 快连模式(又称 EZ 模式)
    • 热点模式(又称 AP 模式)
  • 有线设备配网

  • 子设备配网

  • 扫设备二维码配网

  • 摄像头二维码配网

    摄像头二维码配网,即智能摄像机特有的二维码配网模式,参考 二维码配网

  • 蓝牙设备配网

    蓝牙设备配网的详情,参考 涂鸦蓝牙体系

名词解释

本文介绍设备配网过程中涉及到的部分名词,有关更多名词的说明,参考 名词解释

名词 说明
Wi-Fi 设备 采用涂鸦 Wi-Fi 模组连接路由器,和 App 以及云端进行数据交互的智能设备。
Wi-Fi 快连配网 又称快连模式。大致流程如下:
  1. App 把配网数据打包到 802.11 数据包的指定区域中,发送到周围环境。
  2. 智能设备的 Wi-Fi 模组处于混杂模式下,监听捕获网络中的所有报文。
  3. Wi-Fi 模组按照约定的协议数据格式,解析出 App 发出配网信息包。
热点配网 又称热点模式,手机作为 STA(Station)连接智能设备的热点,双方建立一个 Socket 连接,通过约定端口交互数据。
摄像头扫码配网 摄像头设备通过扫描 App 上的二维码,来获取配网数据信息。
有线设备 通过有线网络连接路由器的设备,例如 Zigbee 有线网关、有线摄像头等。
子设备 通过网关来与 App 以及云端数据交互的设备,例如 Zigbee 子设备。
Zigbee Zigbee 技术是一种近距离、低复杂度、低功耗、低速率、低成本的双向无线通讯技术。
主要用于距离短、功耗低且传输速率不高的各种电子设备之间进行数据传输,以及典型的有周期性数据、间歇性数据和低反应时间数据传输的应用。
Zigbee 网关 融合 Zigbee 网络中协调器和 Wi-Fi 功能的设备,负责 Zigbee 网络的组建及数据信息存储。
Zigbee 子设备 Zigbee 网络中的路由或者终端设备,负责数据转发或者终端控制响应。

版本适配

iOS 14 版本适配

从 iOS 14 版本开始,在设备配网、局域网本地控制时会触发 本地网络 权限弹窗。

  • 如果用户单击了 允许,App 才能够向本地局域网发送数据。
  • 如果用户单击了 拒绝,将无法使用相关功能。

目前,苹果没有提供任何 API 对此权限进行判断,建议您在相关功能无法正常使用时提示、引导用户检查 系统设置 中的 App 设置,确认是否开启了 本地网络 权限。

iOS 13 版本适配

从 iOS 13 版本开始,如果用户没有开启地理位置权限,在已开启 Wi-Fi 权限的前提下,[ThingSmartActivator currentWifiSSID] 将无法获取有效的 Wi-Fi SSID 或 BSSID。在此情况下,iOS 会返回下列默认值:

  • SSID:WLAN 或 Wi-Fi,针对中国大陆地区则是 WLAN
  • BSSID:"00:00:00:00:00:00"

建议您在 Wi-Fi 功能无法正常使用时,进行以下排查:

  1. 确认 App 已开启地理位置权限。
  2. 如果您通过系统方法获取的 BSSID 为 00:00:00:00:00:00,则可以判断为系统的默认返回。此时,您可以引导用户,例如手动输入 Wi-Fi 名称。