设备属性、事件、服务

设备上报属性

上行（透传）

• 请求Topic：/sys/{productKey}/{deviceName}/thing/model/up_raw
• 响应Topic：/sys/{productKey}/{deviceName}/thing/model/up_raw_reply

请求数据为设备上报的原始报文。

示例如下：

0x00002233441232013fa00000

云端返回数据格式如下：

{
    "id":"123",
    "code":200,
    "data":{}
}

上行（Alink JSON）

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

Alink请求数据格式：

{
  "id": "123",
  "version": "1.0",
  "params": {
    "Power": {
      "value": "on",
      "time": 1524448722000
    },
    "WF": {
      "value": 23.6,
      "time": 1524448722000
    }
  },
  "method": "thing.event.property.post"
}

Alink响应数据格式：

{
  "id": "123",
  "code": 200,
  "data": {}
}

设备上报至平台的属性信息，可以使用规则引擎数据流转功能，转发至其他云产品。具体Topic和数据格式，请参见设备属性上报。

设置设备属性

通过调用SetDeviceProperty或SetDevicesProperty下发设置属性指令到设备。

下行（透传）

• 请求Topic：/sys/{productKey}/{deviceName}/thing/model/down_raw
• 响应Topic：/sys/{productKey}/{deviceName}/thing/model/down_raw_reply

下行（Alink JSON）

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

Alink请求数据格式：

{
  "id": "123",
  "version": "1.0",
  "params": {
    "temperature": "30.5"
  },
  "method": "thing.service.property.set"
}

Alink响应数据格式：

{
  "id": "123",
  "code": 200,
  "data": {}
}

您可以使用规则引擎数据流转功能，将属性设置返回的结果，转发至其它云产品。具体Topic和数据格式，请参见设备下行指令结果。

设备事件上报

上行（透传）

• 请求Topic：/sys/{productKey}/{deviceName}/thing/model/up_raw
• 响应Topic：/sys/{productKey}/{deviceName}/thing/model/up_raw_reply

请求数据为设备上报的原始报文，示例如下。

0xff0000007b00

云端返回数据格式如下：

{
    "id":"123",
    "code":200,
    "data":{}
}

上行（Alink JSON）

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

Alink请求数据格式：

{
  "id": "123",
  "version": "1.0",
  "params": {
    "value": {
      "Power": "on",
      "WF": "2"
    },
    "time": 1524448722000
  },
  "method": "thing.event.{tsl.event.identifier}.post"
}

{
      "Power": "on",
      "WF": "2"
    }

Alink响应数据格式：

{
  "id": "123",
  "code": 200,
  "data": {}
}

Alink格式示例

假设产品中定义了一个alarm事件，它的TSL描述如下：

{
  "schema": "https://iot-tsl.oss-cn-shanghai.aliyuncs.com/schema.json",
  "link": "/sys/${productKey}/airCondition/thing/",
  "profile": {
    "productKey": "${productKey}，请替换为您的ProductKey",
    "deviceName": "airCondition，请替换为您的Devicename"
  },
  "events": [
    {
      "identifier": "alarm",
      "name": "alarm",
      "desc": "风扇警报",
      "type": "alert",
      "required": true,
      "outputData": [
        {
          "identifier": "errorCode",
          "name": "错误码",
          "dataType": {
            "type": "text",
            "specs": {
              "length": "255"
            }
          }
        }
      ],
      "method": "thing.event.alarm.post"
    }
  ]
}

当设备上报事件时，Alink请求数据格式：

{
  "id": "123",
  "version": "1.0",
  "params": {
    "value": {
      "errorCode": "error"
    },
    "time": 1524448722000
  },
  "method": "thing.event.alarm.post"
}

设备上报至平台的事件信息，可以使用规则引擎数据流转功能，转发至其他云产品。具体Topic和数据格式，请参见设备上报事件。

设备服务调用（异步调用）

下行（透传）

• 请求Topic：/sys/{productKey}/{deviceName}/thing/model/down_raw
• 响应Topic：/sys/{productKey}/{deviceName}/thing/model/down_raw_reply

下行（Alink JSON）

• 请求Topic：/sys/{productKey}/{deviceName}/thing/service/{tsl.service.identifier}
• 响应Topic：/sys/{productKey}/{deviceName}/thing/service/{tsl.service.identifier}_reply

Alink请求数据格式：

{
  "id": "123",
  "version": "1.0",
  "params": {
    "Power": "on",
    "WF": "2"
  },
  "method": "thing.service.{tsl.service.identifier}"
}

{
      "Power": "on",
      "WF": "2"
    }

Alink响应数据格式：

{
  "id": "123",
  "code": 200,
  "data": {}
}

Alink格式示例

例如产品中定义了服务SetWeight，它的TSL描述如下：

{
  "schema": "https://iotx-tsl.oss-ap-southeast-1.aliyuncs.com/schema.json",
  "profile": {
    "productKey": "testProduct01"
  },
  "services": [
    {
      "outputData": [
        {
          "identifier": "OldWeight",
          "dataType": {
            "specs": {
              "unit": "kg",
              "min": "0",
              "max": "200",
              "step": "1"
            },
            "type": "double"
          },
          "name": "OldWeight"
        },
        {
          "identifier": "CollectTime",
          "dataType": {
            "specs": {
              "length": "2048"
            },
            "type": "text"
          },
          "name": "CollectTime"
        }
      ],
      "identifier": "SetWeight",
      "inputData": [
        {
          "identifier": "NewWeight",
          "dataType": {
            "specs": {
              "unit": "kg",
              "min": "0",
              "max": "200",
              "step": "1"
            },
            "type": "double"
          },
          "name": "NewWeight"
        }
      ],
      "method": "thing.service.SetWeight",
      "name": "设置重量",
      "required": false,
      "callType": "async"
    }
  ]
}

当调用服务时，Alink请求数据格式：

{
  "method": "thing.service.SetWeight",
  "id": "105917531",
  "params": {
    "NewWeight": 100.8
  },
  "version": "1.0.0"
}

Alink响应数据格式：

{
  "id": "105917531",
  "code": 200,
  "data": {
    "CollectTime": "1536228947682",
    "OldWeight": 100.101
  }
}

网关批量上报数据

网关类型的设备可以批量上报属性和事件，也可以代其子设备批量上报属性和事件。

上行（透传）

• 请求Topic：/sys/{productKey}/{deviceName}/thing/model/up_raw
• 响应Topic：/sys/{productKey}/{deviceName}/thing/model/up_raw_reply

请求数据为设备上报的原始报文，示例如下。

0xff0000007b00

云端返回数据格式如下：

{
  "id": "123",
  "code": 200,
  "data": {}
}

上行（Alink JSON）

• 请求Topic：/sys/{productKey}/{deviceName}/thing/event/property/pack/post
• 响应Topic：/sys/{productKey}/{deviceName}/thing/event/property/pack/post_reply

Alink 请求数据格式：

{
  "id": "123",
  "version": "1.0",
  "params": {
    "properties": {
      "Power": {
        "value": "on",
        "time": 1524448722000
      },
      "WF": {
        "value": { },
        "time": 1524448722000
      }
    },
    "events": {
      "alarmEvent1": {
        "value": {
          "param1": "on",
          "param2": "2"
        },
        "time": 1524448722000
      },
      "alertEvent2": {
        "value": {
          "param1": "on",
          "param2": "2"
        },
        "time": 1524448722000
      }
    },
    "subDevices": [
      {
        "identity": {
          "productKey": "",
          "deviceName": ""
        },
        "properties": {
          "Power": {
            "value": "on",
            "time": 1524448722000
          },
          "WF": {
            "value": { },
            "time": 1524448722000
          }
        },
        "events": {
          "alarmEvent1": {
            "value": {
              "param1": "on",
              "param2": "2"
            },
            "time": 1524448722000
          },
          "alertEvent2": {
            "value": {
              "param1": "on",
              "param2": "2"
            },
            "time": 1524448722000
          }
        }
      }
    ]
  },
  "method": "thing.event.property.pack.post"
}

Alink 响应数据格式：

{
  "id": "123",
  "code": 200,
  "data": {}
}

物模型历史数据上报

数据上行。

• 请求Topic：/sys/{productKey}/{deviceName}/thing/event/property/history/post
• 响应Topic：/sys/{productKey}/{deviceName}/thing/event/property/history/post_reply

Alink请求数据格式：

{
  "id": 123, 
  "version": "1.0", 
  "method": "thing.event.property.history.post", 
  "params": [
    {
      "identity": {
        "productKey": "", 
        "deviceName": ""
      }, 
      "properties": [
        {
          "Power": {
            "value": "on", 
            "time": 123456
          }, 
          "WF": {
            "value": "3", 
            "time": 123456
          }
        }, 
        {
          "Power": {
            "value": "on", 
            "time": 123456
          }, 
          "WF": {
            "value": "3", 
            "time": 123456
          }
        }
      ], 
      "events": [
        {
          "alarmEvent": {
            "value": {
              "Power": "on", 
              "WF": "2"
            }, 
            "time": 123456
          }, 
          "alertEvent": {
            "value": {
              "Power": "off", 
              "WF": "3"
            }, 
            "time": 123456
          }
        }
      ]
    }, 
    {
      "identity": {
        "productKey": "", 
        "deviceName": ""
      }, 
      "properties": [
        {
          "Power": {
            "value": "on", 
            "time": 123456
          }, 
          "WF": {
            "value": "3", 
            "time": 123456
          }
        }
      ], 
      "events": [
        {
          "alarmEvent": {
            "value": {
              "Power": "on", 
              "WF": "2"
            }, 
            "time": 123456
          }, 
          "alertEvent": {
            "value": {
              "Power": "off", 
              "WF": "3"
            }, 
            "time": 123456
          }
        }
      ]
    }
  ]
}

Alink响应数据格式：

{
    "id":"123",
    "code":200,
    "data":{}
}

设备上报至平台的物模型历史数据，可以使用规则引擎数据流转功能，转发至其他云产品。具体Topic和数据格式，请参见物模型历史数据格式。