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