對于JT/T 808協(xié)議云網關設備,設備注冊、注銷和上報數據的消息,可通過物聯網平臺規(guī)則引擎的云產品流轉功能轉發(fā)到服務端(用戶的服務器)。設備上報數據消息可通過規(guī)則引擎的AMQP訂閱功能推送至服務端。本文介紹通過規(guī)則引擎進行消息轉發(fā)的使用說明,及對應消息的Topic和數據格式。
使用說明
配置引擎規(guī)則時,您需注意以下事項:
- 僅支持在新版云產品流轉功能下,為云網關設備配置數據流轉規(guī)則。具體操作,請參見配置數據流轉解析器。
JT/T 808協(xié)議云網關設備不具備Topic訂閱能力,所以不支持將JT/T 808協(xié)議云網關設備數據流轉至另一個Topic。
云產品流轉的數據源,僅支持自定義、設備狀態(tài)變化通知和設備生命周期變更,配置自定義數據源時,需您手動輸入廠商ID、設備型號和設備ID。具體操作,請參見創(chuàng)建數據源。
- 服務端訂閱中僅支持推送設備上報消息、設備狀態(tài)變化通知和設備生命周期變更的數據。具體操作,請參見配置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協(xié)議要求即可。詳細說明,請參見JT/T 808的2019版本協(xié)議。 |
licensePlateNumber | String | 車牌號。 |
manufacturer | String | 設備所屬的廠商ID信息。 |
productKey | String | 設備所屬產品的唯一標識。 |
status | String | 設備狀態(tài),固定取值 |
tenantId | String | 設備所屬用戶ID。 |
設備上下線狀態(tài)
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協(xié)議云網關,取值 |
status | String | 設備狀態(tài)。
|
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協(xié)議要求即可。詳細說明,請參見JT/T 808的2019版本協(xié)議。 |
body | Object | 設備上報的具體消息。
消息符合標準JT/T 808協(xié)議要求即可。詳細說明,請參見JT/T 808的2019版本協(xié)議。 |
設備注銷通知
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協(xié)議要求即可。詳細說明,請參見JT/T 808的2019版本協(xié)議。 |
licensePlateNumber | String | 車牌號。 |
manufacturer | String | 設備所屬的廠商ID信息。 |
productKey | String | 設備所屬產品的唯一標識。 |
status | String | 設備狀態(tài),固定取值 |
tenantId | String | 設備所屬用戶ID。 |