消息转发说明

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

设备名称,格式为:${manufacturer}_${deviceModel}_${deviceId}

instanceId

String

设备所属实例的ID。

iotId

String

设备在物联网平台内的唯一标识。

licensePlateColour

String

车牌颜色。取值符合标准JT/T 808协议要求即可。详细说明,请参见JT/T 808的2019版本协议

licensePlateNumber

String

车牌号。

manufacturer

String

设备所属的厂商ID信息。

productKey

String

设备所属产品的唯一标识。

status

String

设备状态,固定取值register,表示设备注册。

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协议云网关,取值jt808

status

String

设备状态。

  • online:上线。

  • offline:离线。

iotId

String

设备在平台内的唯一标识。

offlineReasonCode

Integer

设备下线时,返回的错误码。详细说明,请参见设备行为错误码

productKey

String

设备所属产品的唯一标识。

deviceName

String

设备名称。

lastTime

String

该参数为历史存量字段,已无实际意义。

utcLastTime

String

time

String

设备上、下线的时间。

收到消息的顺序不是实际设备上下线时间排序。设备上下线顺序需按照time具体值排序。

例如,您依次收到3条消息:

  1. 上线:2018-08-31 10:02:28.195

  2. 下线:2018-08-31 10:01:28.195

  3. 下线:2018-08-31 10:03:28.195

这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

设备上报的消息包含设备上报的headerbody信息,分为透传数据、位置信息汇报和定位数据上传。

header

Object

设备上报的头消息。

  • messageId:消息ID。

  • version:协议版本。

  • phone:手机号。

  • serialNumber:设备上报的消息流水号, 取值范围为0~65535,设备按照发送消息顺序循环累加。

messageIdversionphone取值符合标准JT/T 808协议要求即可。详细说明,请参见JT/T 808的2019版本协议

body

Object

设备上报的具体消息。

  • data:消息的具体内容,内容为Base64格式。

  • type:透传消息类型。示例中65代表0x41,表示串口1透传消息。

消息符合标准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

设备名称,格式为:${manufacturer}_${deviceModel}_${deviceId}

instanceId

String

设备所属实例的ID。

iotId

String

设备在物联网平台内的唯一标识。

licensePlateColour

String

车牌颜色。取值符合标准JT/T 808协议要求即可。详细说明,请参见JT/T 808的2019版本协议

licensePlateNumber

String

车牌号。

manufacturer

String

设备所属的厂商ID信息。

productKey

String

设备所属产品的唯一标识。

status

String

设备状态,固定取值unregister,表示设备注销。

tenantId

String

设备所属用户ID。