合作伙伴工作台
注册

消息格式

应用层业务数据可实现包括业务数据上报、业务指令下发、设备事件上报等功能。

消息上下行通过/t/d传送.

平台既支持数据透传也支持非透传(物模型)。对于非透传设备,数据格式仅支持紧凑二进制。


非透传

非透传设备上报的业务数据,平台需要对业务数据按照物模型定义进行解析,因此数据格式必须遵守平台关于业务数据格式的约定,目前仅支持紧凑二进制格式。

业务数据上报、事件上报、无线参数上报的Data字段编码格式:

2bytes

n bytes(Payload)

ServiceID

Parameter1

Parameter2

……


说明:

参数名称

参数类型

类型说明

参数说明

ServiceID

Unsigned Integer(2)

必选定长

服务ID

Payload

Binary


业务数据(二进制格式)


• ServiceID:必填字段,2Bytes,填写平台分配的服务ID

• Payload:类型为Binary,Parameter1、Parameter2等需要按照对应服务的属性列表的顺序填写,Parameter的类型要与属性类型一致。

业务指令下发、指令下发响应的Data字段编码格式:

2bytes

2bytes

n bytes(Payload)



ServiceID

TaskID

Parameter1

Parameter2

……


参数名称

参数类型

类型说明

参数说明

ServiceID

Unsigned Integer(2)

必选定长

服务ID

TaskID

Unsigned Integer(2)

必选定长

任务ID

Payload

Binary


指令或指令响应数据(二进制格式)


•ServiceID:必填字段,2Bytes,填写平台分配的服务ID

•TaskID:必填字段,2Bytes,由平台分配,用于关联下发指令和回复响应,指令和响应中的TaskID必须一致

•Payload:类型为Binary,按照服务定义的属性(或参数)进行编码和解码

示例1、设备数据上报

服务类型

服务标识

服务ID

属性顺序

属性标识符

属性类型

属性长度

数据上报

up

1

1

seq

无符号整型

2




2

data1

定长字符串

5




3

data2

变长字符串

/


数据上报服务ID:1

•属性1:2个字节的整型,值为100

•属性2:5个字节的定长字符串,值为"hello"

•属性3:变长字符串"world"。

首先需要将属性值转换为十六进制:

•属性1十进制整型100的十六进制为0x0064

•属性2定长字符串"hello"转换为十六进制为:0x68656C6C6F(参照ASCII码表转换)

•属性3字符串"world"转化为十六进制为:0x776F726C64,由于该属性为变长字段,还需要在属性前加上2个字节的无符号整型表示长度,即属性3变长字符串的最终编码为0x0005776F726C64。

编码过程为:

•ServiceID:0x0001

•Payload:0x006468656C6C6F0005776F726C64

因此/t/d数据上报内容为:0001006468656C6C6F0005776F726C64


示例2、指令下发和响应

服务类型

服务标识

服务ID

参数顺序

参数标识符

参数类型

参数长度

指令下发

dn

8001

1

cmd

无符号整型

1

指令下发响应

rsp

9001

1

time

定长字符串

12


指令下发服务ID:8001

TaskID:1

参数1:1个字节无符号整型。参数值为1:1--获取当前时间,0--时钟同步。

编码过程为:

•ServiceID:0x1F41

•TaskID:0x0001

•Payload:0x01

因此/t/d指令下发内容为:1F41000101,解析出指令内容为“获取当前时间”,设备需要将系统时间通过响应发给平台。

指令响应的服务ID:9001

TaskID:1

参数1:12字节的定长字符串。值为当前时间点"202010261600"。

编码过程为

•ServiceID:0x2329

•TaskID:0x0001

•Payload:0x323032303130323631363030

因此/t/d指令响应内容为:23290001323032303130323631363030


透传

AEP对/t/d的Data字段不进行解析,支持任意格式的业务数据的透传,平台收到后直接对数据进行base64加密处理。





这篇文档是否帮助您解决了问题?
如果您愿意进一步帮助我们改进文档 ,请留下您的联系方式。