合作伙伴工作台
注册

业务数据开发

登录报文

设备创建时,平台为每个设备分配了设备ID和特征串,设备登录时需要使用。设备可通过MQTT的Connect报文进行登录,具体参数填写如下:

参数

说明

ClientId

必填。填写平台添加设备时生成的设备ID。

Username

必填。建议填写为天翼物联网平台(AIoT)用户名。

Password

必填。填写平台为设备自动分配的特征串。

 

非透传设备

对于非透传产品下创建的设备,用户可以在产品里的“服务定义”标签页里查看物模型属性和服务,使用平台物模型进行终端适配开发,也可以在自定义功能里新增属性或服务来丰富设备功能。

l  “服务定义”标签页里的属性列表,即为之后可进行规则引擎的数据列表,原则上需在上报服务报文中涵盖相应的属性才能使用后续规则引擎的能力。

l  “服务定义”标签页里的服务列表,主要有数据上报、事件上报、指令下发、指令下发响应4种服务类型,每一条服务唯一对应一个Topic主题,服务标识符就是Topic主题名称。设备的业务数据需根据定义,进行Topic的填写。同时,Payload部分的JSON结构体,需按照物模型定义的key/value值填写,否则可能会出现数据不合法而丢弃的现象。

服务类型

服务说明

Payload示例

数据上报

服务列表中“数据上报”类型的服务,平台会生成相应Topic,Publish报文的Topic字段填写相应服务标识,且支持QoS0/1/2三种质量等级的数据上报。

{"data":"AB"}

其中,data为数据上报服务携带属性标识,AB为该属性具体值。

事件上报

服务列表中“事件上报”类型的服务,平台会生成相应Topic,Publish报文的Topic字段填写相应服务标识,且支持QoS0/1/2三种质量等级上报。

{"event":"AB"}

其中,event为事件上报服务携带属性标识,AB为该属性具体值。

指令下发

服务列表中“指令下发”类型的服务,平台会生成相应Topic,并会自动为每个MQTT设备订阅这些Topic主题,平台下发的所有指令质量等级为QoS1。

{"taskId":1,"payload":{"cmd":"AB"}}

其中,taskId是指令ID,由平台分配,具有全局唯一性。payload字段内为实际下发的指令内容,cmd为指令下发服务携带属性标识,AB为该属性具体值。

指令下发响应

服务列表中“指令下发响应”类型的服务,平台会生成相应Topic,Publish报文的Topic字段填写相应服务标识,且支持QoS0/1/2三种质量等级上报。

{"taskId":1,"resultPayload":{"rsp":"AB"}}

其中,taskId需与平台指令下发中的一致,设备可在指令报文中直接获取。resultPayload字段内为具体回复的业务层数据,rsp为指令下发响应服务携带属性标识,AB为该属性具体值。

 

透传设备

对于透传产品下创建的设备,产品里没有“服务定义”标签页,仅支持数据上报及指令下发两种业务数据交互。

服务类型

服务说明

Payload示例

数据上报

用户可在Publish报文的Topic字段填写任意主题,且支持QoS0/1/2三种质量等级数据上报。

{"data":"AB"}

指令下发

平台会自动为每个MQTT设备订阅device_control主题,平台下发的所有指令均为此主题,且质量等级为QoS1。设备端需支持对device_control主题报文的处理。

平台不支持对透传设备指令响应的处理,原则上没有下发指令的上行响应报文,若有需要,用户需自行在应用侧做区分处理。

用户需在指令下发框内填入完整的JSON结构体。

{"cmd":"AB"}


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