网关扩展 SDK FAQ

更新时间：2024-11-20 08:51:29下载pdf

SDK 无法获取 COO ver？

问题描述：运行 SDK 后日志一直打印如下错误。

[01-01 18:12:31 TUYA Warn][tuya_z3.c:19931] Zigbee COO ver is not get.
[01-01 18:12:31 TUYA Warn][z3_wrapper.c:108] tuya_z3_getZigbeeVer, ret: -1

问题原因：网关主控与涂鸦 Zigbee 模组串口无法建立通信。
排查方法：
1. 检查网关主控与涂鸦 Zigbee 模组串口硬件引脚连接是否正常，RTS/CTS 引脚请记得连接。
2. 检查代码中串口参数配置是否正确，.tty_device 和 tty_baudrate。
3. 检查网关主控串口驱动是否正常。

涂鸦智能 App 上搜索不到设备？

请检查手机和网关是否处于同一局域网下，可在网关系统下用 ping 手机的 IP 地址验证。

如何获取网关的 Zigbee 信道？

SDK 启动后会在 .storage_path 变量指定的目录下生成 zigbeeNetInfo.txt 文件，里面保存有 Zigbee 信道和 PanID 等 Zigbee 网络配置信息，如下：

$ cat zigbeeNetInfo.txt 
Node ID:0
Pan ID:0x0044			# Zigbee 网络的PanID
Radio Channel:15		# Zigbee 信道
Radio Power:13
Extended Pan Id: 158F733C2F2325A6
EUI64: F1F2D3FEFFD76B08
Global Key: A2 42 0D D6 50 DD 3B C3 1E CD BD 82 8A 19 E4 92
Global FC:0xFFFFFFFF
Network Key: A5 DA 43 DE 24 A3 7D 54 7A 6B 32 F1 EF 01 E3 A6
Network FC:0x00005001
Network Sequence Number:0x00

如何解决 SDK 日志显示 4366 无法配网？

问题原因：数据存在重复激活。
排查方法：
1. 检查面板界面已加载，如存在旧面板界面解绑并且清除数据。
2. 更换 UUID 和 Authkey，然后删除 .db 文件，并清除缓存，再重新配网。

SDK 获取子设备列表会调用哪个接口？

tuya_user_iot_misc_dev_traversal

网关出现多次下线要如何解决？

问题原因：普通设备云端有限流机制。无法一直快速不停地触发。如进行长时间快速触发，云端后续10秒将停止接收。

目前有两种情况会触发：
- 连续执行 2 秒一次，持续 20 秒以上。
- 连续执行 5 秒一次，持续 60 秒以上。
排查方法：
检查设备是否不停地发送数据。

SDK 日志显示 NCP 报错要如何解决？

问题描述
[2021/6/16 19:50:22] ASH_FLAG TUYA check, abnormal_data_num:0.
[2021/6/16 19:50:22] ASH disconnected: EZSP_ASH_ERROR_XON_XOFF
[2021/6/16 19:50:22] NCP status: EZSP_NO_ERROR
问题原因：模组重启导致
排查方法：
1. 数据 CRC 校验失败，超过 3 次就对 NCP 进行了重启。此外当一些错误累计到阈值，会认为 NCP 异常，进而重启 NCP。
2. EZSP_ASH_ERROR_XON_XOFF：表示主控芯片流控驱动可能有问题，检查主控芯片流控驱动。

网关动作没有下发，日志频繁 tx66 错误要如何解决

排查方法：
1. 信号质量:LastHopLqi
  - 优：>200
  - 良：150~200
  - 一般：100~150
  - 差：<100
2. 上报：建议平均流量不要大于每秒10个

模组如何读取版本？

通过 tuya_user_iot_zig_ncp_ver 接口读取。

查询子设备，在线和离线状态有哪些接口？

tuya_user_iot_misc_dev_online_status

App 显示空白页该如何操作？

问题描述：App 对设备进行配网时可以发现当前 Zigbee 网关，但是配网失败，且 App 上无错误日志，只显示一个空白界面？
排查方法：检查日志是否显示 “errorCode:PRODUCT_OTA_CHANNEL_CONFIG”，如果是，则需要对开发者平台升级通道进行检查，并添加模组固件，选择升级通道号为 0。

以上不能解决我的问题怎么办？

请登录涂鸦开发者平台，提交技术工单。为能快速了解到您的问题，建议您按如下格式描述您的问题：

问题背景：例如，我是某某公司的设备端工程师，在对接涂鸦网关扩展 SDK 开发网关。
问题描述：尽可能详细描述您的问题是在什么条件出现的，故障现象是？能否复现？
问题附件：有故障现场截图或日志请上传附件。