对于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。 |