设备接入 IoTDA设备接入 IoTDA

更新时间:2021/09/06 GMT+08:00
分享

消息结构体说明

转发设备上报的属性

根据定义的产品模型,上报设备属性至平台。结构体描述如下:
表1 属性上报规则转发结构体

参数名称

类型

描述

device_id

String

设备ID,用于唯一标识一个设备,在注册设备时由物联网平台分配获得。

services

services[]

设备物模型的属性定义。

表2 services结构体

参数名称

类型

描述

service_id

String

设备的服务ID,在设备关联的产品模型中定义。

properties

ObjectNode[]

设备按照物模型上报的具体数据。

event_time

String

设备数据上报的时间,格式:yyyymmddThhmmssZ,例如20151212T121212Z。

属性上报转发结构体示例:

{
     "device_id":"String",
     "services":[
         {
             "service_id":"String",
             "properties":{
                 "property1":"String"
             },
             "event_time":"yyyyMMddTHHmmssZ"
         },
         {
             "service_id":"String",
             "properties":{
                 "property2":"String"
             },
             "event_time":"yyyyMMddTHHmmssZ"
         }
     ]
}

转发设备上报的消息

设备上报给平台的消息,不解析消息体中的数据具体含义,直接透传给华为云其他服务。

表3 消息上报规则转发结构体

参数名称

类型

描述

deviceId

String

设备ID,用于唯一标识一个设备,在注册设备时由物联网平台分配获得。

productId

String

产品ID,用于唯一标识一个产品,在物联网平台创建产品后由平台分配获得。

topic

String

mqtt设备消息上报时的订阅主题topic

data

String

消息上报的具体内容,平台会将设备消息上报的结构体当成字符串放在data的value域。

消息上报转发结构体示例:
 {
     "deviceId":"string",
     "data":"string",
     "productId":"string",
     "topic":"string"
 }

转发下行消息结果

应用服务器在物联网平台创建下行信息结果的规则后,当消息状态变更时,平台将消息结果推送给华为云其他服务。

表4 下行消息的结果转发结构体

参数名称

类型

描述

resource

String

订阅的资源名称,取值为device.message.status。

event

String

订阅的资源事件,取值为update。

notify_data

ObjectNode

设备的自定义字段列表。

表5 notify_data结构体

参数名称

类型

描述

message_id

String

消息的序列号,唯一标识一条消息。

name

String

消息名称。

device_id

String

设备ID,用于唯一标识一个设备,在注册设备时由物联网平台分配获得。

status

String

设备消息状态,包含:DELIVERED,TIMEOUT,FAILED。

timestamp

String

消息更新时间,格式:yyyyMMdd'T'HHmmss'Z' UTC字符串,如:20151212T121212Z。

下行消息结果转发结构体示例:

 {
     "resource":"string",
     "event":"string",
     "notify_data":{
         "message_id":"string",
         "name":"string",
         "device_id":"string",
         "status":"string",
         "timestamp":"string"
    }
 }

转发设备状态

当直连设备的状态变更后,平台将变更状态的设备转发至华为云其他服务。

表6 设备状态变更转发结构体

参数名称

类型

描述

resource

String

订阅的资源名称,取值为device.status。

event

String

订阅的资源事件,取值为update。

notify_data

ObjectNode

设备的自定义字段列表。

表7 notify_data结构体

参数名称

类型

描述

app_id

String

资源空间ID

device_id

String

设备ID,用于唯一标识一个设备,在注册设备时由物联网平台分配获得。

status

String

设备状态。

  • ONLINE:设备在线

  • OFFLINE:设备离线

  • ABNORMAL:设备异常

timestamp

String

设备状态变化时间,格式:yyyyMMdd'T'HHmmss'Z' UTC字符串,如:20151212T121212Z。

设备状态变更转发结构体示例:

{
    "resource":"string",
    "event":"string",
    "notify_data":{
        "device_id":"string",
        "app_id":"string",
        "status":"string",
        "timestamp":"string"
    }
}
分享:

    相关文档

    相关产品