接口介绍

设备接入地址为:tcp.ctwing.cn:8996

消息格式

应用层数据报文以1个字节的类型字段作为分割,平台支持登录、心跳、上下行业务数据等消息类型。消息携带的参数必须包含两个字节的参数长度

透传消息

消息类型 类型描述 消息格式 备注
0x01 登录请求 0x01 +deviceId_length(2字节) +deviceId +password_length(2字节) +password +version_length(2字节) +version deviceId是由产品ID和设备编号拼接而成的字符串; password由平台生成,在设备管理业务可以查看; version固定1.0
0x02 上行数据报文 0x02 +数据长度(2字节) +业务数据
0x03 下行数据报文 0x03 +数据长度(2字节) +业务数据
0x04 心跳 0x04 平台心跳周期为5分钟,设备需在5分钟内发送心跳报文
0x05 登录响应 0x05+结果码(2字节) 登录结果: 0 成功 1 未知错误 2 设备未注册 3 设备认证失败 4 设备已登录
0x06 心跳响应 0x06 平台回复终端心跳的响应

示例

登录请求

deviceId:10013378001

password:7Sfv-b_HDbLDyJ_K-0SkWqRGd-GE-b3rZp-upOr1kSU

version:1.0

登录请求编码为:01 000b 3130303133333738303031 002b 375366762d625f4844624c44794a5f4b2d30536b57715247642d47452d6233725a702d75704f72316b5355 0003 312e30

上行数据

业务数据:hello

上行数据报文编码为:02 0005 68656c6c6f

下行数据

业务数据:turn off

下行数据报文编码为:03 0008 7475726e206f6666

非透传消息

消息类型 类型描述 消息格式 备注
0x01 登录请求 0x01 +deviceId_length(2字节) +deviceId +password_length(2字节) +password +version_length(2字节) +version deviceId是由产品ID和设备编号拼接而成的字符串; password由平台生成,在设备管理业务可以查看; version固定1.1 业务数据非透传格式遵循物模型,上下行业务数据需要响应。
0x02 上行数据报文 0x02+数据长度(2字节)+msgid(2字节)+serviceid(2字节)+param1+params2+param3+…… 数据长度:从msgid开始,到报文结尾的长度;msgid:报文标识,由终端分配;serviceId:平台分配的服务ID;param:平台服务包含的属性
0x82 上行数据响应 0x82+数据长度(2字节)+msgid(2字节)+结果码(2字节) 数据长度:从msgid开始,到报文结尾的长度;msgid:报文标识,跟上行报文中msgid对应;结果码:0-成功、1-报文解析失败
0x03 下行数据报文 0x03+数据长度(2字节)+msgid(2字节)+serviceId(2字节)+param1+param2+param3+…… 数据长度:从msgid开始,到报文结尾的长度;msgid:报文标识,由平台分配;serviceId:平台分配的服务ID;param:平台服务包含的属性(参数)注:msgid字段即为指令的taskId
0x83 下行数据响应 0x83+数据长度(2字节)+msgid(2字节)+结果码(2字节)+serviceId(2字节)+param1+param2+param3+…… 数据长度:从msgid开始,到报文结尾的长度;msgid:报文标识,对应下行指令中的msgid;结果码:0-成功,不带serviceId和参数;1-成功,带serviceId和参数;2-下行数据处理失败,不带serviceId和参数
0x04 心跳 0x04 平台心跳周期为5分钟,设备需在5分钟内发送心跳报文
0x05 登录响应 0x05+结果码(2字节) 登录结果:0-成功;1-未知错误;2-设备未注册;3-设备认证失败
0x06 心跳响应 0x06 平台回复终端心跳报的响应

示例

登录请求

deviceId:10013378001

password:7Sfv-b_HDbLDyJ_K-0SkWqRGd-GE-b3rZp-upOr1kSU

version:1.1

登录请求编码为:

01 000b 3130303133333738303031 002b 375366762d625f4844624c44794a5f4b2d30536b57715247642d47452d6233725a702d75704f72316b5355 0003 312e31

上行数据

物模型如下:

上行数据报文编码为:02 000b 0001 0001 68656c6c6f 000a

上行数据响应报文编码为:82 0004 0001 0000

下行数据响应

物模型如下:

下行指令编码为:03 0009 0001 1f41 68656c6c6f

msgid为1,需要在响应中带回

指令响应编码为:83 000d 0001 0001 2329 68656c6c6f 000a

搜索结果 ""

    没有搜索结果 ""