配网绑定

更新时间:2023-09-28 02:41:26下载pdf

配网绑定包含 配网绑定 两个流程。配网是指通过引导,完成设备连接路由器的过程,而绑定是指设备配网后通过访问涂鸦服务,完成注册和绑定。为了方便表述,本文将配网绑定简称为配网。

当前 IPC 开发框架提供多种配网方式,满足不同业务需求。

配网方式

IPC 开发框架提供配网能力如下:

配网方式 说明
局域网绑定 App 和设备处于同一局域网内且设备可以访问广域网。
热点(AP)配网 设备生成一个 Wi-Fi 热点,按照 App 引导,手机连接到此热点,传输路由器信息给设备,完成设备配网。
蓝牙配网 设备支持 Wi-Fi 和蓝牙,通过蓝牙和手机交换配网信息,完成设备配网。
摄像头扫码配网 App 生成二维码,设备扫描二维码进行配网。
扫码激活绑定 设备已经接入广域网,同时生成短码,可将生成短码贴在机身或者通过屏显二维码呈现,App 扫描二维码完成设备配网。

常见问题

设备启动无法进入配网状态,如何排查?

  1. 确认 tuya_ipc_init_sdktuya_ipc_start_sdk 接口调用无明显错误返回。
  2. 确认配网模式(TUYA_IPC_PARING_MODE_E)和连接模式(TUYA_IPC_LINK_TYPE_E)设置符合产品定义。
  3. 确认 tkl_wifi.ctkl_wired.c 适配 API 都正常。
  4. tkl_wifi_init(WIFI_EVENT_CB cb)tkl_wired_set_status_cb(TKL_WIRED_STATUS_CHANGE_CB cb),回调接口在网络状态发生变化时主动给 SDK 正确的状态。

设备同时支持有线和无线,配网模式和连接模式推荐如何设置?

  • 配网模式设置为:PARING_MODE_WIFI_AP
  • 连接模式设置为:TUYA_IPC_LINK_WIFI | TUYA_IPC_LINK_WIRE
  • 需要适配 tkl_wifi.ctkl_wired.c

设备同时支持无线 + 蓝牙,有线 + 无线 + 蓝牙,配网模式和连接模式推荐如何设置?

  • 配网模式设置为:PARING_MODE_WIFI_AP
  • 连接模式设置为:TUYA_IPC_LINK_WIFI | TUYA_IPC_LINK_WIRE | TUYA_IPC_LINK_BT
  • 需要适配 tkl_wifi.ctkl_wired.ctkl_bluetooth.h

4G 设备如何设置配网模式和连接模式?

  • 对于 4G 设备,推荐使用扫码激活绑定或者摄像头扫码配网。
  • 配网模式设置为:PARING_MODE_WIRED
  • 连接模式设置为:TUYA_IPC_LINK_WIRE

配网过程中 MQTT 日志打印 mqtt topics cnt 1 之后无任何 MQTT 相关日志输出,设备无法激活入网。为什么?

  1. 确认 tkl_mutex_create_init 接口是否支持递归,需要支持递归。
  2. 确认其他 TKL 接口平台适配是否有差异,建议走查一遍。

设备同时支持有线和无线,需要动态切换网络。如何实现?

  1. 设备启动调用 tuya_ipc_start_sdk 接口后,调用 mqc_set_connection_switch(TRUE)
  2. 调用 tkl_wifi_init(WIFI_EVENT_CB cb)tkl_wired_set_status_cb(TKL_WIRED_STATUS_CHANGE_CB cb),在网络状态发生变化时,需要调用回调接口主动给 SDK 发送正确的状态。