金鴿 MQTT 的配置

操作步驟：

(1)雙擊“金鴿 IoT”彈出金鴿 MQTT 配置框。

(2)點擊啟用按鈕，啟用金鴿 MQTT。默認：關閉。灰色表示：不啟用，綠色表示：啟用。

(3)IP/域名：1883.dtuip.com，默認填寫好，不需要填寫。

(4)端口：1883，默認填寫好，不需要

填寫。

(5)Client ID：填寫金鴿平臺的序列號，需要聯系銷售提供序列號。

(6)用戶名：MQTT，默認填寫好，不需要填寫。

(7)密碼：MQTTPW，默認填寫好，不需要填寫。

(8)訂閱主題：填寫格式：金鴿平臺的序列號/+，需要聯系銷售提供序列號。

(9)發布主題：填寫金鴿平臺的序列號，需要聯系銷售提供序列號。

(10)上傳周期：數據定時發布間隔時間，默認 30S。

(11)MQTT 數據補傳：是否啟用掉線數據補傳，點擊按鈕啟用。灰色表示：不啟用，綠色表示：啟用。

(12)選擇數據點上傳：在配置框右邊的方框內選擇要上傳的數據點，默認空白表示全部上傳。

(13)點擊“確定”，確定金鴿 MQTT 的配置。

(14)點擊“寫入配置”，網關設備重啟后，金鴿MQTT 才啟用。重新打開配置軟件登錄設備，可以在基本信息頁面可以看到“金鴿MQTT 上線狀態”的提示燈是綠色，表示金鴿 MQTT 已連接上。最右邊顯示從機設備在線的狀態。

5.4.16 在金鴿云上查看和下發數據

在平臺上先配置數據點，在配置數據點的標識符，標識符與配置軟件的 MQTT 標識一致。部分數據點配置如下。如：采集 S7-200SMART 數據點 VW0，在配置軟件上的 MQTT 標識為“VW0”，則金鴿云上讀寫標識要為“VW0”。

5.4.17 金鴿 MQTT 的數據格式

MQTT Client 和 MQTT Client II 的“KingPigeon”JSON 數據格式和金鴿 MQTT 的數據格式一樣詳情如下

1)設備發布消息中有效載荷數據格式

發布主題：序列號(對應配置的發布主題設置項)

{

"sensorDatas": [

{

//布爾量

"flag": "Y0", //讀寫標識

"switcher": 1 //數據類型及值

},

{

//數值型

"flag": "VW0", //讀寫標識

"value": 8 //數據類型及值

},

{

//4G 模塊信號值

"flag": " signal_strength ", //讀寫標識，標識符固定不能修改

"value": 28 //數據類型及值

}

]"state":"alarm", //報警標識符(配置軟件“報警與事件”配置有報警事件，觸

發報警時才有此標識，定時上報數據無此標識)

"state":"recovery", //報警恢復標識符(報警恢復時才有此標識，定時上報數據無此標識)

"gateway_indentify": "BeiLai Gateway" //網關名稱標識符，上傳網關名稱

"time": "1622700769", //時間標識符，數據發布的時間戳

"addTime": "2021-06-03 06:12:49" //時間標識符，上傳網關的時間

"retransmit":"enable" //重傳標識符，表示 MQTT 歷史數據(有重傳歷史數據時才有此標識，定時上報數據無此標識)

}注：

//讀寫標識：字符為"flag"，其后為"數據點的 MQTT 標識符"，添加數據點時填寫的 MQTT 標識符，可以自主定義。

//數據類型及值：根據類型分為：

1、布爾量數據：字符為"switcher"，其后為"0"或"1"(0 代表斷開，1 代表閉合)。

2、數值型數據：字符為"value"，其后為"具體數值"。

//報警、恢復標識：字符為"state"，其后為"alarm"或"recovery"(alarm 代表報警數據，recovery 代表報警恢復數據)。

//網關名稱標識：字符為"gateway_indentify"，其后為"網關的名稱"。

//時間標識：字符為"time"，其后為"具體的上報時間戳"。

//時間標識：字符為"addtime"，其后為"網關的時間"。

//重傳標識：字符為"retransmit"，其后為"enable"

網絡掉線期間采集到的數據會暫存在設備，在網絡恢復時重新發布，用“retransmit”字段標識，表示歷史數據。(需要在配置界面上啟用數據補傳)

2)設備訂閱消息中有效載荷數據格式

訂閱主題：序列號/+(對應配置的訂閱主題設置項)

(金鴿 2.0 下行發布報文用的主題名為“序列號/傳感器 ID”，所以設備訂閱主題需要加上通配符“/+”，這樣才能收到平臺下發數據實現控制)

{

"sensorDatas":

[

{ //布爾量下發

"sensorsId": 211267, //平臺傳感器 ID

"switcher":1, //數據類型及值

"flag":"Y0" //讀寫標識

},

{ //數值型下發

"sensorsId": 160239, //平臺傳感器 ID

"value":"10", //數據類型及值

"flag":"VW0" //讀寫標識

}

],

"down":"down" //平臺下行報文標識

}

注：

//平臺傳感器 ID：字符為"sensorsID"，其后為 ID 號(ID 由平臺自動生成)，自建平臺不用關心該項。

//數據類型及值：根據類型分為：

1、開關型數據：字符為"switcher"，其后為"0"或"1"(0 代表斷開，1 代表閉合)

2、數值型數據：字符為"value"，其后為"具體數值"

//讀寫標識：字符為"flag"，其后為"代表數據點的 MQTT 標識"

//平臺下行報文標識：字符為"down"，其后為"down"，代表此為平臺下行數據。

注意：布爾量下發值不帶雙引號，數值型下發的值要帶雙引號。

審核編輯：湯梓紅