如果产品定义了物模型，设备可以上报属性和事件信息，服务端可以下发设置属性和调用服务指令。
物模型（属性、事件、服务）数据格式，请参见什么是物模型。

设备上报属性或事件或服务流程

image.png

  • 设备使用物模型通信Topic，上报数据
  • 物联网IOT平台进行业务处理
  • 物联网IOT平台返回处理结果
  • 查看属性或事件信息

image.png

设备上报属性

  • 请求Topic：/sys/{productKey}/{deviceName}/thing/event/property/post

请求数据格式(AfuLink)：
{
“id”: “123”,
“version”: “1.0”,
“params”: {
“Power”: {
“value”: “on”,
“time”: 1524448722000
},
“WF”: {
“value”: 23.6,
“time”: 1524448722000
}
},
“method”: “thing.event.property.post”
}

  • 响应Topic：/sys/{productKey}/{deviceName}/thing/event/property/post_reply

响应数据格式：
{
“id”: “123”,
“code”: 200,
“data”: {}
}

请求参数说明
id String 消息ID号。String类型的数字，UUID，且每个消息ID在当前设备中具有唯一性。
version String 协议版本号，目前协议版本号唯一取值为1.0。
method String 请求方法。取值：thing.event.property.post。
params Object 请求参数。如以上示例中，设备上报了的两个属性Power（电源）和WF（工作电流）的信息。具体属性信息，包含属性上报时间（time）和上报的属性值（value）。如果是自定义模块属性，属性标识符格式为模块标识符:属性标识符（中间为英文冒号）。例如
image.png
time Long 属性上报时间，类型为UTC毫秒级时间。该参数为可选字段。根据您的业务场景决定消息中是否带时间戳。如果消息频繁，需根据时间戳判断消息顺序，建议消息中带有时间戳。
value Object 上报的属性值。

响应参数说明
id String 消息ID号，String类型的数字，UUID，且每个消息ID在当前设备中具有唯一性。
code Integer 结果状态码。 具体参考设备端通用code。
data Object 请求成功时，返回的数据。固定为空。

设备上报至平台的属性信息，可以通过服务端订阅流转转发到您的服务器。具体操作请参考

设置设备属性

  • 请求Topic：/sys/{productKey}/{deviceName}/thing/service/property/set

请求数据格式(AfuLink)：
{
“id”: “123”,
“version”: “1.0”,
“params”: {
“temperature”: “30.5”
},
“method”: “thing.service.property.set”
}

  • 响应Topic：/sys/{productKey}/{deviceName}/thing/service/property/set_reply

响应数据格式：
{
“id”: “123”,
“code”: 200,
“data”: {}
}

请求参数说明
id String 消息ID号，String类型的数字，UUID，且每个消息ID在当前设备中具有唯一性。
version String 协议版本号，目前协议版本号唯一取值为1.0。
params Object 属性设置参数。如以上示例中，设置属性：{ “temperature”: “30.5” }。如果是自定义模块属性，属性标识符格式为模块标识符:属性标识符（中间为英文冒号），例如{ “test:temperature”: “30.5” }。
method String 请求方法。取值：thing.service.property.set

响应参数说明
id String 消息ID号，String类型的数字，UUID，且每个消息ID在当前设备中具有唯一性。
code Integer 结果状态码。 具体参考设备端通用code。
data Object 请求成功时，返回的数据。固定为空。

设备上报至平台的属性信息，可以通过服务端订阅流转转发到您的服务器。具体操作请参考

设备上报事件

  • 默认模块请求Topic：/sys/{productKey}/{deviceName}/thing/event/{tsl.event.identifier}/post
  • 默认模块响应Topic：/sys/{productKey}/{deviceName}/thing/event/{tsl.event.identifier}/post_reply


  • 自定义模块请求Topic：/sys/{productKey}/{deviceName}/thing/event/{tsl.functionBlockId}:{tsl.event.identifier}/post
  • 自定义模块响应Topic：/sys/{productKey}/{deviceName}/thing/event/{tsl.functionBlockId}:{tsl.event.identifier}/post_reply

请求数据格式(AfuLink)：
{
“id”: “123”,
“version”: “1.0”,
“params”: {
“value”: {
“Power”: “on”,
“WF”: “2”
},
“time”: 1524448722000
},
“method”: “thing.event.{tsl.event.identifier}.post”
}

响应数据格式：
{
“id”: “123”,
“code”: 200,
“data”: {}
}

请求参数说明
id String 消息ID号。String类型的数字，UUID，且每个消息ID在当前设备中具有唯一性。
version String 协议版本号，目前协议版本号唯一取值为1.0。
method String 请求方法。默认模块取值为thing.event.{tsl.event.identifier}.post。自定义模块取值为thing.event.{tsl.functionBlockId}:{tsl.event.identifier}.post。{tsl.event.identifier}为物模型中定义的事件标识符，{tsl.functionBlockId}为自定义模块的标识符
params Object 上报事件的输出参数。
time Long 属性上报时间，类型为UTC毫秒级时间。该参数为可选字段。根据您的业务场景决定消息中是否带时间戳。如果消息频繁，需根据时间戳判断消息顺序，建议消息中带有时间戳。
value Object 事件的输出参数信息。如以上示例中的两个参数Power（电源）和WF（工作电流）的信息。列如：
image.png

响应参数说明
id String 消息ID号，String类型的数字，UUID，且每个消息ID在当前设备中具有唯一性。
code Integer 结果状态码。 具体参考设备端通用code。
data Object 请求成功时，返回的数据。固定为空。

事件上报示例：


设备服务调用

  • 默认模块请求Topic：/sys/{productKey}/{deviceName}/thing/service/{tsl.service.identifier}

  • 默认模块响应Topic：/sys/{productKey}/{deviceName}/thing/service/{tsl.service.identifier}_reply

  • 自定义模块请求Topic：/sys/{productKey}/{deviceName}/thing/service/{tsl.functionBlockId}:{tsl.service.identifier}

  • 自定义模块响应Topic：/sys/{productKey}/{deviceName}/thing/service/{tsl.functionBlockId}:{tsl.service.identifier}_reply

请求数据格式(AfuLink)：
{
“id”: “123”,
“version”: “1.0”,
“params”: {
“Power”: “on”,
“WF”: “2”
},
“method”: “thing.service.{tsl.service.identifier}”
}

响应数据格式：
{
“id”: “123”,
“code”: 200,
“data”: {}
}

请求参数说明
id String 消息ID号，String类型的数字，UUID，且每个消息ID在当前设备中具有唯一性。
version String 协议版本号，目前协议版本号唯一取值为1.0。
params Object 服务调用参数。包含服务标识符和服务的值。如以上示例中的两个参数Power（电源）和WF（工作电流）。如下
image.png
method String 请求方法。默认模块取值为thing.service.{tsl.service.identifier}。自定义模块取值为thing.service.{tsl.functionBlockId}:{tsl.service.identifier}。 {tsl.service.identifier}为物模型中定义的服务标识符，{tsl.functionBlockId}为自定义模块的标识符

响应参数说明
id String 消息ID号，String类型的数字，UUID，且每个消息ID在当前设备中具有唯一性。
code Integer 结果状态码。 具体参考设备端通用code。
data Object 请求成功时，返回的数据。固定为空。