設備監控

MQTT

伺服器連線位址:iot.cht.com.tw,連接埠1883 與 8883 (TLS 加密連線)

裝置狀態監控

伺服器連線位址:iot.cht.com.tw,連接埠1883 與 8883 (TLS 加密連線)
由裝置主動上傳HeartBeat訊息讓系統依據頻率資訊判斷設備狀態
協定名稱
發送 HeartBeat
Topic
/v1/device/${device_id}/heartbeat
協定描述
發送 HeartBeat
模式

Publish

帳號與密碼
username: PROJECT_KEY or DEVICE_KEY
password: PROJECT_KEY or DEVICE_KEY
Message 說明
{ "pulse": "1000" }
備註
1.pulse 裝置發送訊息間隔時間
2.project key 為專案的專屬金鑰,可以從專案管理 > 權限資料查詢得知
3.device key 為裝置專屬的金鑰,可以從裝置管理查詢得知
4.MQTT QoS 傳輸品質目前支援 QoS 0 最多傳送一次(at most once)模式。
5.MQTT 在網路階層架構中屬於應用層,它產生訊息並交給下一層(TCP)處理, MQTT 本身並不清楚最底層的網路是否壅塞甚至斷線,因此 MQTT 不保證能百分之百交付訊息。

協定名稱
訂閱 HeartBeat 通知
Topic
/v1/device/${device_id}/heartbeat
協定描述
訂閱 HeartBeat 通知
模式

Subscribe

帳號與密碼
username: PROJECT_KEY or DEVICE_KEY
password: PROJECT_KEY or DEVICE_KEY
Response 說明
{ "pulse": "1000", "from": "223.140.31.51", "last": "2016-03-30T08:28:47.532Z", "time": "2016-03-30T09:28:47.532Z", "type": "Lost", "deviceId": "853435970" }
備註
1.pulse 裝置發送訊息間隔時間
2.from 裝置最後一次發送訊息IP
3.last 裝置最後一次發送訊息時間
4.time 目前時間
5.type 裝置狀態 [Live: 裝置第一次連上IoT智慧聯網大平台並開始傳送HeartBeat時。Lost: 沒有在時間內收到通知。ReLive: 裝置中斷HeartBeat後,重新連回IoT智慧聯網大平台時。LastInfo: 裝置最後一次HeartBeat的資訊]
6.project key 為專案的專屬金鑰,可以從專案管理 > 權限資料查詢得知
7.device key 為裝置專屬的金鑰,可以從裝置管理查詢得知
8.MQTT QoS 傳輸品質目前支援 QoS 0 最多傳送一次(at most once)模式。
9.MQTT 訂閱通知訊息的反應時間會依據平台目前訊息量多寡而影響快慢,平均 3秒內可接收到通知訊息。
10.MQTT 在網路階層架構中屬於應用層,它產生訊息並交給下一層(TCP)處理, MQTT 本身並不清楚最底層的網路是否壅塞甚至斷線,因此 MQTT 不保證能百分之百交付訊息。

設備主動狀態監控

伺服器連線位址:iot.cht.com.tw,連接埠1883 與 8883 (TLS 加密連線)
由系統主動透過設備上傳感測數據頻率判斷設備狀態
協定名稱
訂閱設備主動監控狀態
Topic
/v1/device/${device_id}/active
協定描述
訂閱設備主動監控狀態
模式

Subscribe

帳號與密碼
username: PROJECT_KEY or DEVICE_KEY
password: PROJECT_KEY or DEVICE_KEY
Response 說明
start 狀態
{ "deviceId": "786727741", "status": "start", "createTime": "2019-07-10T02:55:12.512Z" }
online 狀態
{ "deviceId": "786727741", "status": "online", "lastDataTime": "2019-07-10T02:55:17.000Z", "createTime": "2019-07-10T02:55:18.031Z" }
abnormal 狀態
{ "deviceId": "786727741", "status": "abnormal", "record": 2, "lastDataTime": "2019-07-10T02:56:45.000Z", "createTime": "2019-07-10T02:58:09.106Z" }
offline 狀態
{ "deviceId": "786727741", "status": "offline", "lastDataTime": "2019-07-10T03:35:37.000Z", "createTime": "2019-07-10T03:38:10.069Z" }
stop 狀態
{ "deviceId": "786727741", "status": "stop", "createTime": "2019-07-10T03:40:43.585Z" }
備註
1.deviceId 為設備編號
2. status 為設備主動監控狀態,狀態分為: start 啟動設備主動監控狀態; online: 設備上線狀態; offline: 設備離線狀態; abnormal: 設備接收數據頻率異常狀態; stop: 設備停止主動監控狀態
3. record 異常頻率資訊(指定週期內接收到的感測數據筆數)
4. lastDataTime 最後一筆收到設備資料時間
5. createTime 設備主動監控狀態判斷時間
6.project key 為專案的專屬金鑰,可以從專案管理 > 權限資料查詢得知
7.device key 為裝置專屬的金鑰,可以從裝置管理查詢得知
8.MQTT QoS 傳輸品質目前支援 QoS 0 最多傳送一次(at most once)模式。
9.MQTT 在網路階層架構中屬於應用層,它產生訊息並交給下一層(TCP)處理, MQTT 本身並不清楚最底層的網路是否壅塞甚至斷線,因此 MQTT 不保證能百分之百交付訊息。