金鴿 MQTT 的配置

操作步驟：（1）雙擊“金鴿 IoT”彈出金鴿 MQTT 配置框。（2）點擊啟用按鈕，

啟用金鴿 MQTT。默認(rèn)：關(guān)閉?；疑硎荆翰粏⒂?，綠色表示：啟用。（3）IP/域名：

1883.dtuip.com，默認(rèn)填寫好，不需要填寫。（4）端口：1883，默認(rèn)填寫好，不需要

填寫。（5）Client ID：填寫金鴿平臺的序列號，需要聯(lián)系銷售提供序列號。（6）用戶

名：MQTT，默認(rèn)填寫好，不需要填寫。（7）密碼：MQTTPW，默認(rèn)填寫好，不需要

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

（9）發(fā)布主題：填寫金鴿平臺的序列號，需要聯(lián)系銷售提供序列號。（10）上傳周

期：數(shù)據(jù)定時發(fā)布間隔時間，默認(rèn) 30S。（11）MQTT 數(shù)據(jù)補(bǔ)傳：是否啟用掉線數(shù)據(jù)補(bǔ)

傳，點擊按鈕啟用?；疑硎荆翰粏⒂茫G色表示：啟用。（12）選擇數(shù)據(jù)點上傳：在

配置框右邊的方框內(nèi)選擇要上傳的數(shù)據(jù)點，默認(rèn)空白表示全部上傳。（13）點擊“確

定”，確定金鴿 MQTT 的配置。（14）點擊“寫入配置”，網(wǎng)關(guān)設(shè)備重啟后，金鴿

MQTT 才啟用。重新打開配置軟件登錄設(shè)備，可以在基本信息頁面可以看到“金鴿

MQTT 上線狀態(tài)”的提示燈是綠色，表示金鴿 MQTT 已連接上。最右邊顯示從機(jī)設(shè)備

在線的狀態(tài)。

5.4.16 在金鴿云上查看和下發(fā)數(shù)據(jù)

在平臺上先配置數(shù)據(jù)點，在配置數(shù)據(jù)點的標(biāo)識符，標(biāo)識符與配置軟件的 MQTT 標(biāo)

識一致。部分?jǐn)?shù)據(jù)點配置如下。如：采集 S7-200SMART 數(shù)據(jù)點 VW0，在配置軟件上

的 MQTT 標(biāo)識為“VW0”，則金鴿云上讀寫標(biāo)識要為“VW0”。

5.4.17 金鴿 MQTT 的數(shù)據(jù)格式

MQTT Client 和 MQTT Client II 的“KingPigeon”JSON 數(shù)據(jù)格式和金鴿 MQTT 的

數(shù)據(jù)格式一樣詳情如下

1）設(shè)備發(fā)布消息中有效載荷數(shù)據(jù)格式

發(fā)布主題：序列號（對應(yīng)配置的發(fā)布主題設(shè)置項）

{

"sensorDatas": [

{

//布爾量

"flag": "Y0", //讀寫標(biāo)識

"switcher": 1 //數(shù)據(jù)類型及值

},

{

//數(shù)值型

"flag": "VW0", //讀寫標(biāo)識

"value": 8 //數(shù)據(jù)類型及值

},

{

//4G 模塊信號值

"flag": " signal_strength ", //讀寫標(biāo)識，標(biāo)識符固定不能修改

"value": 28 //數(shù)據(jù)類型及值

}

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

發(fā)報警時才有此標(biāo)識，定時上報數(shù)據(jù)無此標(biāo)識）

"state":"recovery", //報警恢復(fù)標(biāo)識符（報警恢復(fù)時才有此標(biāo)識，定時上報數(shù)據(jù)

無此標(biāo)識）

"gateway_indentify": "BeiLai Gateway" //網(wǎng)關(guān)名稱標(biāo)識符，上傳網(wǎng)關(guān)名稱

"time": "1622700769", //時間標(biāo)識符，數(shù)據(jù)發(fā)布的時間戳

"addTime": "2021-06-03 06:12:49" //時間標(biāo)識符，上傳網(wǎng)關(guān)的時間

"retransmit":"enable" //重傳標(biāo)識符，表示 MQTT 歷史數(shù)據(jù)（有重傳歷史數(shù)據(jù)時

才有此標(biāo)識，定時上報數(shù)據(jù)無此標(biāo)識）

}注：

//讀寫標(biāo)識：字符為"flag"，其后為"數(shù)據(jù)點的 MQTT 標(biāo)識符"，添加數(shù)據(jù)點時填寫

的 MQTT 標(biāo)識符，可以自主定義。

//數(shù)據(jù)類型及值：根據(jù)類型分為：

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

合）。

2、數(shù)值型數(shù)據(jù)：字符為"value"，其后為"具體數(shù)值"。

//報警、恢復(fù)標(biāo)識：字符為"state"，其后為"alarm"或"recovery"（alarm 代表報

警數(shù)據(jù)，recovery 代表報警恢復(fù)數(shù)據(jù)）。

//網(wǎng)關(guān)名稱標(biāo)識：字符為"gateway_indentify"，其后為"網(wǎng)關(guān)的名稱"。

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

//時間標(biāo)識：字符為"addtime"，其后為"網(wǎng)關(guān)的時間"。

//重傳標(biāo)識：字符為"retransmit"，其后為"enable"

網(wǎng)絡(luò)掉線期間采集到的數(shù)據(jù)會暫存在設(shè)備，在網(wǎng)絡(luò)恢復(fù)時重新發(fā)布，用“retransmit”字段標(biāo)識，表示歷史數(shù)據(jù)。（需要在配置界面上啟用數(shù)據(jù)補(bǔ)傳）

2）設(shè)備訂閱消息中有效載荷數(shù)據(jù)格式

訂閱主題：序列號/+（對應(yīng)配置的訂閱主題設(shè)置項）

（金鴿 2.0 下行發(fā)布報文用的主題名為“序列號/傳感器 ID”，所以設(shè)備訂閱主題

需要加上通配符“/+”，這樣才能收到平臺下發(fā)數(shù)據(jù)實現(xiàn)控制）

{

"sensorDatas":

[

{ //布爾量下發(fā)

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

"switcher":1, //數(shù)據(jù)類型及值

"flag":"Y0" //讀寫標(biāo)識

},

{ //數(shù)值型下發(fā)

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

"value":"10", //數(shù)據(jù)類型及值

"flag":"VW0" //讀寫標(biāo)識

}

],

"down":"down" //平臺下行報文標(biāo)識

}

注：

//平臺傳感器 ID：字符為"sensorsID"，其后為 ID 號（ID 由平臺自動生成），自

建平臺不用關(guān)心該項。

//數(shù)據(jù)類型及值：根據(jù)類型分為：

1、開關(guān)型數(shù)據(jù)：字符為"switcher"，其后為"0"或"1"（0 代表斷開，1 代表閉

合）

2、數(shù)值型數(shù)據(jù)：字符為"value"，其后為"具體數(shù)值"

//讀寫標(biāo)識：字符為"flag"，其后為"代表數(shù)據(jù)點的 MQTT 標(biāo)識"

//平臺下行報文標(biāo)識：字符為"down"，其后為"down"，代表此為平臺下行數(shù)據(jù)。

注意：布爾量下發(fā)值不帶雙引號，數(shù)值型下發(fā)的值要帶雙引號。