设备配网步骤:
联网单品设备配网的主要过程主要分为两个步骤:
1.设备获取ssid,password, token 配网三要素信息后连入网络。
2.设备将自身信息,token等信息发送至云端,请求激活绑定。
根据获取配网信息的方式不同,有以下几种配网类型
设备获取ssid,password, token配网三要素的渠道不一样,我们将常见配网方式分成以下几种类型:
EZ配网(Easy-Connect)
我们也会经常叫快闪配网(设备的配网指示灯一般处于快闪状态)/一键配网。EZ配网是通过SmartConfig 技术原理实现的,设备需要支持monitor模式(也称为混杂模式, sniffer),即设备有监听当前环境中数据包的能力,并从中解析出有效信息。优势:
用户的操作相对更少,更加方便。
不足:
会存在手机,路由器兼容性问题,会出现在某些手机或者路由下配网成功率极低的情况。因为设备是从收到的收连续多包的数据中解析出配网信息,如果通信质量不佳,其中有一包数据丢失,可能就会导致数据解析失败,开始进入下一轮循环。
设备串口打印的关键日志:检测到EZ引导报文片段:EZ Header Find
检测到完整的EZ引导报文:EZ Header Complete.
锁定EZ信道,开始接收数据报文:EZ Lock Chan
数据报文接收完整,配网信息接收完毕:Netcfg Finish.
锁定信道后,配网信息接收超时:wifi network config timeout, try again
常见问题:
在上述图片中的第4步中,路由器不转发包,导致空中的有效数据包骤减,大大降低了配网成功率。
备注说明:
因为配网兼容性,安全性等问题,3.5.0及以上的联网单品开发框架(双模设备)已经下架该功能。建议开发者用使用蓝牙配网。
AP 配网
AP(Access Point):无线接入点,是一个无线网络的创建者,是网络的中心节点。简单来讲就像是无线路由器一样,设备打开后进入AP模式,在手机的网络列表里面,可以搜索到类似SmartLife_XXX的名字。
设备WIFI工作在AP(热点)模式(慢闪),手机用WIFI连上设备的热点,组成局域网,手机发送需要连接路由的ssid,pwd以及token至设备,设备接收到后,根据ssid和password连上对应的路由器,然后设备直接和云端通讯,通过token进行注册绑定,完成配网。优势:
配网成功率高
安全性高,稳定性好
不足:
由于AP 配网模式交互相对复杂,还需要用再跳转Wi-Fi列表页面让用户选择设备热点点击连接,影响配网体验。
一次只能进行配一个设备,无法一次配对多个设备。
设备串口打印的关键日志:启动AP配网:ap cfg start
轮询UDP报文超时(10s):lan listen select timeout
接收到UDP配网报文:recv udp packets
UDP报文开始解析:start AP rcv_parse
UDP报文解析成功,接收到正确的配网信息:Ap Netcfg Finish
UDP报文解析失败
报文长度错误:Frame is Too Big
报文格式错误:check tail fails
报文解密失败:lan parse data fail
常见问题:
设备热点已经被其他App连接,所以导致连接设备热点被拒绝。(默认1个连接)
蓝牙配网
针对 BLE + Wi-Fi双模设备, 配网数据还可以通过蓝牙连接传输至设备。涂鸦智能App在连接上设备的蓝牙模块后,将随机生成的App随机密钥通过蓝牙发送给设备,设备在收到App随机密钥后随机生成设备随机密钥并发送给App,App在收到设备随机密钥后经过一定的加密算法得出协商密钥,用于配网信息的加密。随后App将上述加密后的配网信息发送给设备,设备返回解密成功。优势:
配网成功率高
用户操作简单
不足:
存在手机蓝牙兼容性问题
一次配网仅可以配一个
设备串口打印的关键日志:APP与设备建立蓝牙连接:Ble Connected
APP与设备配对成功:PAIR_REQ ok
设备正确接收到配网报文:Rev Net Cfg
APP与设备建立蓝牙连接后,如果APP在30s内没有进行配对,则设备主动断开连接:device no permit to connect, disconect
常见问题:
手机蓝牙兼容性问题导致无法稳定连接。APP连上设备蓝牙后,反复断开,日志形如:Ble Disonnected
设备激活流程
上面说的几种配网方式,当设备拿到配网信息后,走的激活流程都是一致的。设备连上路由,然后调用激活接口。设备激活成功后,连接MQTT,设备上线。
设备串口打印的关键日志:
开始激活:token activate start
获取激活URL:token activate get cloud url
激活设备:token activate get meta
激活成功:token activate parse meta
MQTT上线:mqtt connect success
MQTT上线失败:mqtt disconnected
激活失败,没有超时的话则重试:activate backoff
激活失败,超时退出:activate timeout
常见问题:
配网获取到的SSID/PWD错误,无法连接路由器:wifi connect err
其他配网常见问题排查指南:
https://developer.tuya.com/cn/docs/iot- ... nggovmyubu
有任何问题,欢迎发帖讨论~