[TOC] ## 前言 本方案以MQTT.fx客戶端軟件為例介紹如何接入創恒云平臺，接收和下發設備數據，MQTT.fx是一款基于Eclipse Paho，使用Java語言編寫的MQTT客戶端工具，支持通過Topic訂閱和發布消息。下面以MQTT.fx為例，介紹使用第三方軟件以MQTT協議接入云平臺，實現Modbus、西門子PPI、三菱FX等協議的PLC數據的讀取和寫入。 ## 前提條件 通過MQTT接入設備數據，需要在平臺加入添加通道和點表，并可以通過平臺正常獲取到PLC數據。該文檔面向開發人員，需掌握MQTT協議、JSON數據格式、PLC點表配置方法。 ## 一、獲取MQTT服務參數 登陸創恒云新平臺 https://cloud.truhigh.com，點擊左側菜單欄“MQTT服務”，獲取到MQTT連接的域名（Broker Address）、端口號（Broker Port）參數。  **獲取MQTT服務用戶名和密碼** 點擊MQTT服務的用戶按鈕，進入用戶列表頁面，最后一條為權限最高的系統用戶。 *(如果需要按權限分配給不同的用戶，可以新建用戶，并為用戶分配特定的訪問策略。)*  ## 二、配置MQTT.fx的連接參數，連接MQTT服務 1. 下載并安裝MQTT.fx軟件，請訪問[MQTT.fx官網](https://mqttfx.jensd.de/index.php/download) 2. 打開MQTT.fx軟件，設置連接參數 **說明：** 設置參數時，請確保參數值中或參數值的前后均沒有空格。  4. 取消TLS認證  5. 點擊“OK”保存參數后，點擊“Connect”按鈕，接入創恒云平臺。 ## 三、網關數據上報主題 **Modbus**: BOX/${deviceId}/event/property/post/${nDeviceId} **PPI**: BOX/${deviceid}/event/property/post/ppi/{nDeviceId} **三菱FX**: BOX/${deviceid}/event/property/post/fx/{nDeviceId} | 參數 | 說明 | | --- | --- | | deviceid | 網關ID，可在平臺界面找到（見附錄II） | | nDeviceId | 設備ID（PLC ID），可在平臺界面找到（見附錄II） | 網關采集到的數據將按照點表設置，按以下格式上報的相應主題。參數格式不區分協議，即無論是PPI數據還是modbus數據，將統一封裝成以下格式 ``` { "time": 1575971814027, "params": { "name1": value1, "name2": value2, "name3": value3, "name4": value4 } } ``` | 參數 | 說明 | | --- | --- | | time | UTC時間 | | name | 對應點表內設置的點的名稱 | | value | 采集到的PLC對應點的數據（具體數據類型根據點表配置不同而不同） | ## 四、網關數據下發主題 創恒云平臺或第三方云平臺通過對以下主題發送數據實現PLC數據的修改 **Modbus**: BOX/${deviceId}/event/property/set/${nDeviceId} **PPI**: BOX/${deviceid}/event/ppi/set/${nDeviceId} **三菱FX**: BOX/${deviceid}/event/fx/set/${nDeviceId} | 參數 | 說明 | | --- | --- | | deviceid | 網關ID，可在平臺界面找到（見附錄II） | | nDeviceId | 設備ID（PLC ID），可在平臺界面找到（見附錄II） | 格式： ``` { "id": "12312312312312", "params": { "name": value } } ``` 參數說明： | 參數 | 說明 | | --- | --- | | id | 隨機字符串，確定消息的唯一性 | | name | 對應點表內設置的點的名稱 | | value | 采集到的PLC對應點的數據（具體數據類型根據點表配置不同而不同） | ## 五、網關數據下發后，網關上報確認結果主題 **Modbus**: BOX/${deviceId}/event/property/setResult/${nDeviceId} **PPI**: BOX/${deviceid}/event/ppi/setResult/${nDeviceId} **三菱FX**: BOX/${deviceid}/event/fx/setResult/${nDeviceId} | 參數 | 說明 | | --- | --- | | deviceid | 網關ID，可在平臺界面找到（見附錄II） | | nDeviceId | 設備ID（PLC ID），可在平臺界面找到（見附錄II） | **主題內容格式：** ``` { "id": "12312312312312", "result": { "name": value } } ``` | 參數 | 說明 | | --- | --- | | id | 隨機字符串，確定消息的唯一性(與數據下發的ID相同) | | name | 對應點表內設置的點的名稱 | | value | 錯誤碼，只有0代表下發成功（具體錯誤碼見附錄） | ## 附錄 [附錄I、錯誤碼說明](errroCode.md) [附錄II、獲取網關ID和設備ID](getID.md)