全部產品
Search
文件中心

IoT Platform:訊息轉寄說明

更新時間:Jun 30, 2024

對於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。