对于JT/T 808协议云网关设备,设备注册、注销和上报数据的消息,可通过物联网平台规则引擎的云产品流转功能转发到服务端(用户的服务器)。设备上报数据消息可通过规则引擎的AMQP订阅功能推送至服务端。本文介绍通过规则引擎进行消息转发的使用说明,及对应消息的Topic和数据格式。
使用说明
配置引擎规则时,您需注意以下事项:
- 仅支持在新版云产品流转功能下,为云网关设备配置数据流转规则。具体操作,请参见配置数据流转解析器。
- JT/T 808协议云网关设备不具备Topic订阅能力,所以不支持将JT/T 808协议云网关设备数据流转至另一个Topic。 
- 云产品流转的数据源,仅支持自定义、设备状态变化通知和设备生命周期变更,配置自定义数据源时,需您手动输入厂商ID、设备型号和设备ID。具体操作,请参见创建数据源。 
- 服务端订阅中仅支持推送设备上报消息、设备状态变化通知和设备生命周期变更的数据。具体操作,请参见配置AMQP服务端订阅。
设备注册通知
Topic:/sys/${productKey}/${deviceName}/device/identity/register。
payload: {
    "createTime": 1669968170000,
    "deviceId": "device05",
    "deviceModel": "model1",
    "deviceName": "manufactor_model1_device05",
    "instanceId": "iotx-o****",
    "iotId": "PkhDL********00101",
    "licensePlateColour": "1",
    "licensePlateNumber": "浙A****",
    "manufacturer": "manufactor",
    "productKey": "a16h****",
    "status": "register",
    "tenantId": "58CAC7******37C956"
}| 参数 | 数据类型 | 说明 | 
| payload | Object | 设备注册消息,其下包含设备注册的详细信息。 | 
| createTime | Long | 设备注册的开始时间。 | 
| deviceId | String | 用户注册的设备ID。 | 
| deviceModel | String | 用户注册的设备型号。 | 
| deviceName | String | 设备名称,格式为: | 
| instanceId | String | 设备所属实例的ID。 | 
| iotId | String | 设备在物联网平台内的唯一标识。 | 
| licensePlateColour | String | 车牌颜色。取值符合标准JT/T 808协议要求即可。详细说明,请参见JT/T 808的2019版本协议。 | 
| licensePlateNumber | String | 车牌号。 | 
| manufacturer | String | 设备所属的厂商ID信息。 | 
| productKey | String | 设备所属产品的唯一标识。 | 
| status | String | 设备状态,固定取值 | 
| tenantId | String | 设备所属用户ID。 | 
设备上下线状态
Topic:/sys/${productKey}/${deviceName}/device/status/notify。
- 设备上线的数据格式: - { "protocol": "jt808", "status":"online", "iotId":"4z819VQHk6VSLmmBJfrf00107e****", "productKey":"al12345****", "deviceName":"deviceName1234", "time":"2018-08-31 15:32:28.205", "utcTime":"2018-08-31T07:32:28.205Z", "lastTime":"2018-08-31 15:32:28.195", "utcLastTime":"2018-08-31T07:32:28.195Z", "clientIp":"192.0.2.1" }
- 设备下线的数据格式: - { "protocol": "jt808", "status":"offline", "iotId":"4z819VQHk6VSLmmBJfrf00107e****", "offlineReasonCode":427, "productKey":"al12345****", "deviceName":"deviceName1234", "time":"2018-08-31 15:32:28.205", "utcTime":"2018-08-31T07:32:28.205Z", "lastTime":"2018-08-31 15:32:28.195", "utcLastTime":"2018-08-31T07:32:28.195Z", "clientIp":"192.0.2.1" }
参数说明:
| 参数 | 类型 | 说明 | 
| protocol | String | JT/T 808协议云网关,取值 | 
| status | String | 设备状态。 
 | 
| iotId | String | 设备在平台内的唯一标识。 | 
| offlineReasonCode | Integer | 设备下线时,返回的错误码。详细说明,请参见设备行为错误码。 | 
| productKey | String | 设备所属产品的唯一标识。 | 
| deviceName | String | 设备名称。 | 
| lastTime | String | 该参数为历史存量字段,已无实际意义。 | 
| utcLastTime | String | |
| time | String | 设备上、下线的时间。 收到消息的顺序不是实际设备上下线时间排序。设备上下线顺序需按照time具体值排序。 例如,您依次收到3条消息: 
 这3条消息展示了,设备先下线,再上线,最后下线的过程。 | 
| utcTime | String | 设备上、下线的UTC时间。 | 
| clientIp | String | 设备公网出口IP。 | 
设备上报数据
Topic:/sys/${productKey}/${deviceName}/device/message/uplink
payload: {
    header:{
        messageId:"",
        version:"",
        phone:"",
        serialNumber:""
    },
    body:{
        data:"dGVzdDEyMw==",
        type: 65
    }
}| 参数 | 数据类型 | 说明 | 
| payload | Object | 设备上报的消息包含设备上报的header和body信息,分为透传数据、位置信息汇报和定位数据上传。 | 
| header | Object | 设备上报的头消息。 
 messageId、version和phone取值符合标准JT/T 808协议要求即可。详细说明,请参见JT/T 808的2019版本协议。 | 
| body | Object | 设备上报的具体消息。 
 消息符合标准JT/T 808协议要求即可。详细说明,请参见JT/T 808的2019版本协议。 | 
设备注销通知
Topic:/sys/${productKey}/${deviceName}/device/identity/unregister。
payload: {
    "createTime": 1669968170000,
    "deviceId": "device05",
    "deviceModel": "model1",
    "deviceName": "manufactor_model1_device05",
    "instanceId": "iotx-o****",
    "iotId": "PkhDL********00101",
    "licensePlateColour": "1",
    "licensePlateNumber": "浙A****",
    "manufacturer": "manufactor",
    "productKey": "a16h****",
    "status": "register",
    "tenantId": "58CAC7******37C956"
}| 参数 | 数据类型 | 说明 | 
| payload | Object | 设备注销消息,其下包含设备注销的详细信息。 | 
| createTime | Long | 设备注销的开始时间。 | 
| deviceId | String | 设备ID。 | 
| deviceModel | String | 设备型号。 | 
| deviceName | String | 设备名称,格式为: | 
| instanceId | String | 设备所属实例的ID。 | 
| iotId | String | 设备在物联网平台内的唯一标识。 | 
| licensePlateColour | String | 车牌颜色。取值符合标准JT/T 808协议要求即可。详细说明,请参见JT/T 808的2019版本协议。 | 
| licensePlateNumber | String | 车牌号。 | 
| manufacturer | String | 设备所属的厂商ID信息。 | 
| productKey | String | 设备所属产品的唯一标识。 | 
| status | String | 设备状态,固定取值 | 
| tenantId | String | 设备所属用户ID。 |