网关联网 SDK FAQ

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

智能生活 App 上搜索不到设备？

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

SDK 会占用那些端口？

分别是 8883、6667、6668、6669、443、6681、6608 和 6682 端口。

SDK 下载固件是否支持断点续传？

支持。

网关和 App 无法建立局域网通信？

按以下步骤排查：

确认 6667、6668 端口是否被其他进程占用。
确认手机 IP 地址和设备 IP 地址是否处于同一个网段。
确认设备是否分享给多人，设备最多可以和三台手机建立局域网通信。
检查 get_ip 接口实现，传给 SDK 的 IP 字段是否正确。

功能点上报常见报错原因？

如果检查和产品的功能点定义一致时，仍然报错，需要将设备重新配网可解决。

设备在配网时，会从云端获取设备的功能点信息（schema）并保存在本地 DB 文件中，调试中功能点定义进行了更新后，设备需要重新配网以同步本地 DB 文件中的信息。

上报数值不在定义的范围内，报错如下：
```
[04-17 08:58:48 TUYA Err][smart_frame.c:2267] value check fail 3 25 50 350
```
以上日志表明 DP 数值校验失败，上报的数值为 25，DP 定义的数值范围为 50~350。

如下图，请登录涂鸦开发者平台检查对应功能点定义的数值范围：

上报的功能点类型和定义的不一致：

[04-17 09:08:48 TUYA Err][smart_frame.c:251] dparr[0] type not match.2 1

以上日志表明上报的 DP 类型为 2，实际定义的 DP 类型值为 1。

DP 类型值定义：

// dp schema type
typedef BYTE_T DP_PROP_TP_E;
#define PROP_BOOL 0
#define PROP_VALUE 1
#define PROP_STR 2
#define PROP_ENUM 3
#define PROP_BITMAP 4

提示功能点没有发现：
```
[04-17 08:48:30 TUYA Err][smart_frame.c:246] devid:xxx dparr[0]:4 not find, continue.
```
以上日志表明 DPID 为 4 的功能点不存在，请登录涂鸦开发者平台检查是否定义此功能点。

手机下发 DP 指令控制设备时，为何在设备日志查询不到记录？

手机和设备处于同一局域网下时，手机 DP 指令的下发，优先走局域网下发。

设备日志查询操作说明请参考设备日志查询（支持单个设备使用行为查询）
。

子设备绑定的接口的参数要怎么定义？

接口原型为 tuya_iot_gw_bind_dev(tp, uddd, id, pk, ver)。

tp：为子设备类型，可选参数如下。

#define DEV_ZB_SNGL 2           // zigbee single device，Zigbee 设备
#define DEV_INFRARED_SNGL 3     // infrared single device，红外子设备
#define DEV_OTHER_SNGL 4        // other single device，开发者自研设备均采用此类型
#define DEV_BLE_SNGL 5          // ble single device，蓝牙设备

uddd：32 位无符号整型，用户自定义参数，一般用于区分同一类设备，便于应用层判断处理。
id：子设备的设备 ID 信息，网关下每个设备要唯一，不能重复，一般可用设备的 Mac 地址或者芯片的 ID，最长支持 25 个字符长度。
pk：子设备的 PID，涂鸦开发者平台创建产品后生成
ver：子设备的固件版本，格式为 XX.XX.XX(0 ≤ X ≤ 9)，用于子设备的 OTA 升级的版本管理。

网关正在进行自身的 OTA 时，能否同时进行子设备的 OTA 升级？

不可以。同一时间内只有一个升级线程在进行，结束后才可运行另一个。

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

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

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