目錄

一. 準(zhǔn)備工作 2

1.1 需要準(zhǔn)備如下物品 2

1.2 EG20網(wǎng)關(guān)準(zhǔn)備工作 2

1.3 PLC準(zhǔn)備工作 2

1.4 電腦的準(zhǔn)備工作 3

二. MQTT網(wǎng)關(guān)登陸平臺(tái)配置步驟 4

2.1 登錄 4

2.2 網(wǎng)關(guān)概況 6

2.3 MQTT連接配置 6

2.4 數(shù)據(jù)傳輸配置 7

2.5 驅(qū)動(dòng)管理 7

2.6 變量管理 9

三. MQTT客戶(hù)端數(shù)據(jù)采集配置步驟 10

四. 注意事項(xiàng) 12

前言：MQTT是一個(gè)基于客戶(hù)端-服務(wù)器的消息發(fā)布/訂閱傳輸協(xié)議。MQTT協(xié)議的特點(diǎn)是輕量、簡(jiǎn)單、開(kāi)放和易于實(shí)現(xiàn)的，同時(shí)，西門(mén)子PLC廣泛應(yīng)于工業(yè)控制領(lǐng)域，是一款性能高、穩(wěn)定性強(qiáng)的PLC設(shè)備。

此文檔將介紹如何使用EG系列網(wǎng)關(guān)串口連接西門(mén)子200PLC，將PLC的數(shù)據(jù)通過(guò)MQTT協(xié)議傳輸?shù)綌?shù)據(jù)平臺(tái)，將PLC數(shù)據(jù)上云，實(shí)現(xiàn)遠(yuǎn)程監(jiān)控?cái)?shù)據(jù)的功能。

一、準(zhǔn)備工作

1.1 需要準(zhǔn)備如下物品

1. 西門(mén)子200或200smartPLC一臺(tái)（下文以200PLC為例，200smart串口使用方法相同）
2. EG網(wǎng)關(guān)一臺(tái)，天線和電源適配器（以下用EG20-MQ作為實(shí)例）。
3. SIM卡一張，有流量，大卡(移動(dòng)，聯(lián)通或者電信卡)。
4. 聯(lián)網(wǎng)電腦一臺(tái)（WinXP/Win7/Win8/Win10操作系統(tǒng)，并裝有MQTT客戶(hù)端軟件）。
5. 電工工具、導(dǎo)線若干。

1.2 EG20網(wǎng)關(guān)準(zhǔn)備工作

網(wǎng)關(guān)相關(guān)技術(shù)參數(shù)與使用說(shuō)明，可參考《EG20用戶(hù)使用手冊(cè)》。

1. 保證網(wǎng)關(guān)可以正常聯(lián)網(wǎng)，可通過(guò)4G卡（移動(dòng)/聯(lián)通/電信流量卡，大卡）聯(lián)網(wǎng)（需接上隨網(wǎng)關(guān)附帶的天線）或通過(guò)網(wǎng)線聯(lián)網(wǎng)（需將路由器出來(lái)的網(wǎng)線接到網(wǎng)關(guān)的WAN口）；
2. 網(wǎng)關(guān)接12V或24V直流電源，上電。（注意，電源正負(fù)極不要接反）。

1.3、PLC準(zhǔn)備工作

PLC連接電源（注意電源是24VDC還是220VAC），準(zhǔn)備一顆9針串口公頭，用兩顆導(dǎo)線分別焊接的3和8引腳（如下圖），將PLC Port0串口的3引腳連接EG20網(wǎng)關(guān)的“RS485A”端子，8引腳連接EG20網(wǎng)關(guān)的“RS485B”端子。也可以使用485轉(zhuǎn)232模塊將PLC連到網(wǎng)關(guān)的RS232口上。如使用Port1口，接線方式相同。不需要再做其他操作，接好線即可 。

1.4、電腦的準(zhǔn)備工作

進(jìn)入藍(lán)蜂官網(wǎng)（[https://www.lanfengkeji.com/]），點(diǎn)擊【資源中心】→【技術(shù)手冊(cè)】→【藍(lán)蜂MQTT網(wǎng)關(guān)配置工具壓縮包】，如圖：

也可進(jìn)入如下地址進(jìn)行下載：

[https://download.s21i.faiusr.com/6318546/0/2/ABUIABBQGAAgmrfnkwYolNWLDw?f=%E8%93%9D%E8%9C%82MQTT%E7%BD%91%E5%85%B3%E9%85%8D%E7%BD%AE%E5%B7%A5%E5%85%B7%281%29.rar&v=1652153359]

※本客戶(hù)端為免安裝客戶(hù)端，下載后請(qǐng)使用解壓軟件進(jìn)行解壓縮操作，打開(kāi)解壓縮后的文件夾，雙擊“藍(lán)蜂MQTT網(wǎng)關(guān)配置工具.exe”文件，即可啟動(dòng)藍(lán)蜂MQTT網(wǎng)關(guān)配置工具。

__使用方式：__啟動(dòng)藍(lán)蜂MQTT網(wǎng)關(guān)配置工具，會(huì)開(kāi)啟命令行窗口并啟動(dòng)電腦內(nèi)默認(rèn)瀏覽器，在瀏覽器內(nèi)進(jìn)行配置操作，請(qǐng)勿關(guān)閉已打開(kāi)的命令行窗口，或修改瀏覽器內(nèi)地址，否則將無(wú)法正常使用配置工具。

__推薦瀏覽器：__Chrome瀏覽器，Edge瀏覽器，360瀏覽器。

__不推薦瀏覽器：__不推薦使用IE瀏覽器，火狐瀏覽器，世界之窗瀏覽器。

二、MQTT網(wǎng)關(guān)登陸平臺(tái)配置步驟

MQTT網(wǎng)關(guān)支持本地串口配置和遠(yuǎn)程無(wú)線配置兩種方式連接網(wǎng)關(guān)進(jìn)行配置。當(dāng)首次使用藍(lán)蜂網(wǎng)關(guān)進(jìn)行連接MQTT服務(wù)器時(shí)，必須使用電腦與網(wǎng)關(guān)232串口連接。

2.1登錄

2.1.1本地串口配置

使用本地串口配置方式，如圖：

使用232串口進(jìn)行本地配置，將網(wǎng)關(guān)的RS232口使用USB轉(zhuǎn)232線接到電腦串口上，同時(shí)填寫(xiě)配置參數(shù)，包括選擇通訊口，波特率，數(shù)據(jù)位，數(shù)據(jù)校驗(yàn)，停止位。默認(rèn)參數(shù)為115200，8，無(wú)，1。

【通訊口】：選擇正確的串口號(hào)，可在電腦的“設(shè)備管理器”中查看。

【讀取網(wǎng)關(guān)串口參數(shù)】：如果對(duì)于串口參數(shù)并不了解，可點(diǎn)擊“讀取網(wǎng)關(guān)串口參數(shù)”按鈕，客戶(hù)端會(huì)主動(dòng)搜索并填入已選中的串口的參數(shù)。前提是必須選擇正確的通訊口號(hào)。

【記住配置】：點(diǎn)擊“記住配置”按鈕后，會(huì)記住當(dāng)前配置，避免每次進(jìn)入時(shí)需要重新配置的問(wèn)題，再次進(jìn)入時(shí)可直接進(jìn)行連接操作。

點(diǎn)擊“立即連接”按鈕，稍等片刻即可進(jìn)入網(wǎng)關(guān)配置工具進(jìn)行配置。

2.1.2遠(yuǎn)程無(wú)線配置

當(dāng)網(wǎng)關(guān)已經(jīng)在本地配置成功連接MQTT服務(wù)器后，即可使用此功能。

可以通過(guò)MQTT平臺(tái)，使用遠(yuǎn)程無(wú)線方式配置網(wǎng)關(guān)，實(shí)現(xiàn)網(wǎng)關(guān)參數(shù)遠(yuǎn)程配置，如圖：

需填寫(xiě)對(duì)應(yīng)的參數(shù)：

【網(wǎng)關(guān)SN編號(hào)】：網(wǎng)關(guān)SN碼、為要連接的目標(biāo)網(wǎng)關(guān)。SN碼位于網(wǎng)關(guān)機(jī)身。

[]()【客戶(hù)端id】：[]()電腦登陸MQTT服務(wù)器的ID，隨機(jī)生成，也可以自行填寫(xiě)，最多50個(gè)字符，不能與其他設(shè)備設(shè)置的客戶(hù)端id重復(fù)。

【用戶(hù)名】【密碼】：登錄MQTT服務(wù)器的用戶(hù)名和密碼。需要MQTT服務(wù)器端提供。

【IP/域名】：MQTT服務(wù)器的地址。需要MQTT服務(wù)器端提供。

【端口】：MQTT推送的服務(wù)器地址的端口號(hào)。需要MQTT服務(wù)器端提供。

【超時(shí)時(shí)間】：客戶(hù)端連接服務(wù)器連接開(kāi)始到失敗的等待響應(yīng)時(shí)間。需要MQTT服務(wù)器端提供。

【心跳時(shí)間】：在沒(méi)有任何其他控制報(bào)文從客戶(hù)端發(fā)送給服務(wù)端的時(shí)間間隔。需要MQTT服務(wù)器端提供。

【SSL/TLS】：可選擇關(guān)閉認(rèn)證，單向認(rèn)證或雙向認(rèn)證。需要MQTT服務(wù)器端提供。

※單向認(rèn)證：指的是只有客戶(hù)端校驗(yàn)服務(wù)器的合法性，需要上傳服務(wù)器的根證書(shū)。

※雙向認(rèn)證：指的是相互校驗(yàn)，服務(wù)器需要校驗(yàn)每個(gè)客戶(hù)端，客戶(hù)端也需要校驗(yàn)服務(wù)器，需上傳服務(wù)器根證書(shū)和客戶(hù)端的公鑰和私鑰文件。

【記住配置】：點(diǎn)擊“記住配置”按鈕后，會(huì)記住當(dāng)前配置，避免每次進(jìn)入時(shí)需要重新配置的問(wèn)題，再次進(jìn)入時(shí)可直接進(jìn)行連接操作。

注：除【客戶(hù)端id】之外，其余參數(shù)均為MQTT服務(wù)器端提供，和網(wǎng)關(guān)登錄MQTT平臺(tái)的配置相同。

2.2 網(wǎng)關(guān)概況

當(dāng)連接成功后，即可進(jìn)入網(wǎng)關(guān)配置頁(yè)面，對(duì)網(wǎng)關(guān)進(jìn)行相應(yīng)的配置。

關(guān)于網(wǎng)關(guān)基本信息的具體介紹，見(jiàn)《藍(lán)蜂MQTT網(wǎng)關(guān)配置工具使用說(shuō)明V1.0》第4.1節(jié)。

關(guān)于日志設(shè)置，強(qiáng)烈建議在非調(diào)試階段關(guān)閉全部日志配置，長(zhǎng)時(shí)間開(kāi)啟日志會(huì)影響網(wǎng)關(guān)性能。

注意：EG20-MQ最多支持添加500個(gè)變量，16個(gè)驅(qū)動(dòng)。

2.3 MQTT連接配置

MQTT配置頁(yè)面可用于連接MQTT服務(wù)器以及設(shè)置是否開(kāi)啟透?jìng)鳌?shù)據(jù)采集異常上報(bào)和網(wǎng)關(guān)狀態(tài)上報(bào)。具體介紹內(nèi)容見(jiàn)《藍(lán)蜂MQTT網(wǎng)關(guān)配置工具使用說(shuō)明V1.0》第4.2節(jié)。

首次拿到網(wǎng)關(guān)需要進(jìn)行MQTT連接配置，MQTT連接配置可用于配置連接的MQTT服務(wù)器的參數(shù)。配置完成后，網(wǎng)關(guān)即可連接MQTT服務(wù)器，如圖：

【客戶(hù)端id】：為網(wǎng)關(guān)登錄MQTT服務(wù)器的ID，默認(rèn)為網(wǎng)關(guān)SN編號(hào)，可根據(jù)需求可自行修改，為網(wǎng)關(guān)登錄MQTT平臺(tái)的ID。不能與其他設(shè)備設(shè)置的客戶(hù)端id重復(fù)。

【用戶(hù)名】【密碼】：登錄MQTT服務(wù)器的用戶(hù)名和密碼。需要MQTT服務(wù)器端提供。

【IP/域名】：MQTT服務(wù)器的地址。需要MQTT服務(wù)器端提供。

【端口】：MQTT推送的服務(wù)器地址的端口號(hào)。需要MQTT服務(wù)器端提供。

【超時(shí)時(shí)間】：客戶(hù)端連接服務(wù)器連接開(kāi)始到失敗的等待響應(yīng)時(shí)間。需要MQTT服務(wù)器端提供。

【心跳時(shí)間】：在沒(méi)有任何其他控制報(bào)文從客戶(hù)端發(fā)送給服務(wù)端的時(shí)間間隔。需要MQTT服務(wù)器端提供。

【SSL/TLS】：可選擇關(guān)閉認(rèn)證，單向認(rèn)證或雙向認(rèn)證。需要MQTT服務(wù)器端提供。

※單向認(rèn)證：指的是只有客戶(hù)端校驗(yàn)服務(wù)器的合法性，需要上傳服務(wù)器的根證書(shū)；

※雙向認(rèn)證：指的是相互校驗(yàn)，服務(wù)器需要校驗(yàn)每個(gè)客戶(hù)端，客戶(hù)端也需要校驗(yàn)服務(wù)器，需上傳服務(wù)器根證書(shū)和客戶(hù)端的公鑰和私鑰文件。

注：除【客戶(hù)端id】之外，其余參數(shù)均為MQTT服務(wù)器端提供，和遠(yuǎn)程登陸頁(yè)的配置相同。

2.4 數(shù)據(jù)傳輸配置

數(shù)據(jù)傳輸配置中包含【數(shù)據(jù)上報(bào)配置】、【寫(xiě)變量配置】、【讀變量配置】。其中有默認(rèn)的格式，可以直接使用，也可以根據(jù)自己的MQTT平臺(tái)配置進(jìn)行適配和修改，具體內(nèi)容見(jiàn)《藍(lán)蜂MQTT網(wǎng)關(guān)配置工具使用說(shuō)明V1.0》第4.3節(jié)。

數(shù)據(jù)上報(bào)主題默認(rèn)為：data/report/${sn}

寫(xiě)變量請(qǐng)求主題默認(rèn)為：write/req/{sn} 寫(xiě)變量響應(yīng)主題默認(rèn)為write/resp/{sn}

讀變量請(qǐng)求主題默認(rèn)為：read/req/{sn} 讀變量響應(yīng)主題默認(rèn)為read/resp/{sn}

主題支持使用通配符

（1）主題可以使用類(lèi)似于${sn}的通配符替代網(wǎng)關(guān)sn

（2）通配符支持所有的系統(tǒng)變量

2.5 驅(qū)動(dòng)管理

驅(qū)動(dòng)管理用來(lái)配置網(wǎng)關(guān)與下位機(jī)的驅(qū)動(dòng)管理，支持創(chuàng)建/編輯，刪除驅(qū)動(dòng)，設(shè)置通訊口配置信息等，如圖。由于是第一次配置，此處為空，需要進(jìn)行添加驅(qū)動(dòng)的操作。

【通訊口配置】：點(diǎn)擊通訊口配置下面有3個(gè)通訊端口項(xiàng)，【RS232】、【RS485】和【LAN】，分別對(duì)應(yīng)網(wǎng)關(guān)上的3個(gè)數(shù)據(jù)通訊端口，3個(gè)通訊口可以同時(shí)和下位機(jī)進(jìn)行通訊?？砂凑招枰獙?duì)相應(yīng)通訊口進(jìn)行配置。

我們需要使用RS485與PLC進(jìn)行通訊，所以需要配置RS485參數(shù)，西門(mén)子默認(rèn)串口參數(shù)為9600、8、偶、1。

[]()【+新增】：點(diǎn)擊此處創(chuàng)建驅(qū)動(dòng)，可根據(jù)實(shí)際使用需求進(jìn)行選擇填寫(xiě)。

【驅(qū)動(dòng)名稱(chēng)】：自定義。不限中英文，不限標(biāo)點(diǎn)符號(hào)，包括空格，最大支持20個(gè)字。

【品牌】、【型號(hào)】：根據(jù)需要選擇品牌型號(hào)，網(wǎng)關(guān)會(huì)根據(jù)您選擇的品牌型號(hào)的專(zhuān)有協(xié)議跟設(shè)備進(jìn)行通訊。本案例連接西門(mén)子200PLC，所以【品牌】選擇“西門(mén)子”，【型號(hào)】選擇“PPI”。

【設(shè)備地址】：必填項(xiàng)，和PLC中設(shè)置的地址一致。如果找不到從站，可以去PLC中程序中讀取。西門(mén)子默認(rèn)為2。

完成后點(diǎn)擊確定即可看到新創(chuàng)建的驅(qū)動(dòng)。

2.6 變量管理

變量管理可用來(lái)配置網(wǎng)關(guān)數(shù)據(jù)變量，支持新增、編輯、導(dǎo)入、導(dǎo)出、復(fù)制等功能。由于是第一次配置，此處為空，需要進(jìn)行新增變量的操作。

支持變量的復(fù)制/導(dǎo)入/導(dǎo)出功能，使用【復(fù)制】可以快速添加變量。如果變量較多，可以先點(diǎn)擊【導(dǎo)出】，在導(dǎo)出文件中進(jìn)行修改，修改完成后再點(diǎn)擊【導(dǎo)入】即可。具體內(nèi)容介紹見(jiàn)《藍(lán)蜂MQTT網(wǎng)關(guān)配置工具使用說(shuō)明V1.0》第4.5.2節(jié)和4.5.3節(jié)。

※變量介紹：

【儀表、PLC】：必填，選擇剛才創(chuàng)建的西門(mén)子200即可。

【變量表示（key）】：必填，自定義即可。注意不能有重復(fù)的名稱(chēng)。

【寄存器類(lèi)型】：必填，填寫(xiě)對(duì)應(yīng)西門(mén)子200PLC的寄存器類(lèi)型。

【寄存器地址】：必填，地址填寫(xiě)時(shí)不帶寄存區(qū)標(biāo)志符，與實(shí)際寄存器地址一致。例如，Q0.0寫(xiě)0.0，M10.0寫(xiě)10.0，VD200寫(xiě)200。具體可見(jiàn)下方地址表示例。

【數(shù)據(jù)類(lèi)型】：必填，根據(jù)實(shí)際需要選擇即可。

【死區(qū)設(shè)置】：具體內(nèi)容見(jiàn)后方“？”。

【讀寫(xiě)方式】：可根據(jù)需求自行修改該寄存器的讀寫(xiě)方式，默認(rèn)為只讀。

【采集公式】：可根據(jù)需求自行編寫(xiě)公式，需要使用英文字符。具體內(nèi)容介紹見(jiàn)《藍(lán)蜂MQTT網(wǎng)關(guān)配置工具使用說(shuō)明V1.0》第4.5.4節(jié)。

地址表示例：

至此，藍(lán)蜂MQTT網(wǎng)關(guān)配置工具配置完成，可使用MQTT客戶(hù)端進(jìn)行讀取相關(guān)變量。

三、MQTT客戶(hù)端數(shù)據(jù)采集配置步驟

步驟一：在變量管理中，我們添加如下變量：

步驟二：在藍(lán)蜂MQTT網(wǎng)關(guān)配置工具中點(diǎn)擊數(shù)據(jù)傳輸配置-數(shù)據(jù)上報(bào)配置，設(shè)置數(shù)據(jù)上報(bào)配置參數(shù)，如圖，此案例中上報(bào)主題為“wz”，自動(dòng)上報(bào)時(shí)間設(shè)置為10S。

步驟三：打開(kāi)電腦的MQTTX軟件（也可以使用其他軟件，本文以MQTTX軟件展示），登錄MQTT平臺(tái)。MQTTX軟件配置如下：

步驟四：添加訂閱消息。

步驟五：設(shè)置完成后即可點(diǎn)擊查看數(shù)據(jù)，如下圖。

至此，PLC數(shù)據(jù)已經(jīng)成功上傳到MQTT服務(wù)器，用戶(hù)可以使用任意MQTT客戶(hù)端軟件或者其他工具讀取此PLC的數(shù)據(jù)。

如需要遠(yuǎn)程讀取、修改PLC數(shù)據(jù)，上報(bào)狀態(tài)信息，使用透?jìng)鞴δ?，方法?lèi)似。具體操作方法，參考內(nèi)容見(jiàn)《藍(lán)蜂MQTT網(wǎng)關(guān)配置工具使用說(shuō)明V1.0》第6節(jié)。

配置工具使用的是默認(rèn)腳本，如需要修改，具體操作方法，參考內(nèi)容見(jiàn)《藍(lán)蜂MQTT網(wǎng)關(guān)配置工具使用說(shuō)明V1.0》第7節(jié)。

四、注意事項(xiàng)

1、EG20-MQ網(wǎng)關(guān)不支持web配置頁(yè)，不能設(shè)置交換機(jī)和路由器模式。

2、在打開(kāi)藍(lán)蜂MQTT網(wǎng)關(guān)配置工具之后，請(qǐng)勿關(guān)閉已打開(kāi)的命令行窗口，或修改瀏覽器內(nèi)地址，否則將無(wú)法正常使用配置工具。

3、在線配置MQTT平臺(tái)參數(shù)時(shí)，電腦和網(wǎng)關(guān)需要同時(shí)訪問(wèn)到相同的MQTT平臺(tái)，否則無(wú)法在線配置。

4、同一臺(tái)電腦，mqtt方式登錄后，一次只能操作一個(gè)網(wǎng)關(guān)（如同時(shí)打開(kāi)多個(gè)網(wǎng)頁(yè)，同時(shí)連接不同的網(wǎng)關(guān)，客戶(hù)端是不支持的）。

5、如果串口232是7位時(shí)，串口連接點(diǎn)擊升級(jí)，升級(jí)成功客戶(hù)端不會(huì)提示升級(jí)成功，但是網(wǎng)關(guān)實(shí)際會(huì)升級(jí)成功。

6、藍(lán)蜂MQTT網(wǎng)關(guān)配置工具的網(wǎng)關(guān)編碼格式為UTF-8。

7、兼容性：win7, win10, win11系統(tǒng)，不支持winxp及更低版本windows系統(tǒng)，不支持linux、MacOS、android和ios系統(tǒng)。

河北藍(lán)蜂信息科技有限公司

公司電話：0311-68025711

技術(shù)支持：400-808-6168
官方網(wǎng)站：www.lanfengkeji.com

審核編輯 黃宇