芯耀
408
要想與OneNET服務器相連，我們首先要了解一下什么是MQTT。
MQTT簡介
MQTT (Message Queuing Telemetry Transport )，是由IBM開發(fā)的輕量級消息傳輸協(xié)議，相比其他通訊協(xié)議，MQTT更適合物聯(lián)網(wǎng)場景。
在MQTT中，主要有三個角色：
| 角色 | 說明 |
|---|---|
| 發(fā)布者（Publish） | 發(fā)送消息的一方，可以為一個應用程序或一臺設備 |
| 代理（Broker）（服務器） | 管理消息隊列的一方，位于消息發(fā)布者和訂閱者之間 |
| 訂閱者（Subscribe） | 訂閱主題的一方，主要用于接收消息 |
MQTT傳輸?shù)南⒎譃椋褐黝}（Topic--區(qū)分不同消息）和負載（payload--消息內容）兩部分。
MQTT協(xié)議采用發(fā)布/訂閱（Publish/Subscribe）模式，MQTT是應用層的協(xié)議，其底層為TCP協(xié)議，TCP是傳輸層協(xié)議，云端（服務器端）通過主題（Topic）的方式管理各個物聯(lián)網(wǎng)設備的訂閱，實現(xiàn)將設備與設備之間消息進行轉發(fā)。
MQTT協(xié)議適合場景：
- 客戶端數(shù)量眾多每次消息傳輸?shù)臄?shù)據(jù)量不大協(xié)議占用資源小，能夠方便移植到單片機等硬件上提供不同等級的“服務質量--Qos”在低帶寬、高延遲、不可靠的網(wǎng)絡和資源有限的硬件環(huán)境下，進行相對可靠的數(shù)據(jù)傳輸支持一對多的消息分發(fā)
一般物聯(lián)網(wǎng)平臺都是支持MQTT協(xié)議的，比如我們今天要接入的OneNET——中國移動物聯(lián)網(wǎng)開放平臺，也是支持MQTT協(xié)議的，具體支持的協(xié)議包括以下幾種：
我們今天就看看基于MQTT協(xié)議，如何能夠接入OneNET服務器。
MQTT.fx簡介
OneNET平臺相當于MQTT中的Broker（服務器），要想實現(xiàn)與OneNET平臺連接，我們需要一個客戶端，而MQTT.fx是目前最常用的MQTT客戶端，我們使用的MQTT.fx的版本為1.7.1。
MQTT.fx軟件下載后，默認安裝即可，安裝完畢的軟件界面如下：
創(chuàng)建產品和設備
注冊并登錄 OneNET 平臺的控制臺，網(wǎng)址為：
https://open.iot.10086.cn/console/
在后臺的 文檔中心-->MQTT物聯(lián)網(wǎng)套件(新版)-->快速入門 版塊：
我們找到如下有用信息：
創(chuàng)建產品
參考官網(wǎng)文檔：
https://open.iot.10086.cn/doc/mqtt/book/get-start/product&device/createProduct.html
創(chuàng)建設備
參考官方文檔：
https://open.iot.10086.cn/doc/mqtt/book/get-start/product&device/createDevice.html
我們按照上面網(wǎng)文教程創(chuàng)建一個產品和一個測試設備：
服務器地址
OneNET物聯(lián)網(wǎng)平臺的地址和端口在下面鏈接獲?。?/p>
https://open.iot.10086.cn/doc/iot_platform/book/device-connect&manager/MQTT/mqtt-device-development.html
Broker Address：studio-mqtt.heclouds.com
Broker Port：1883
進入與MQTT服務器連接配置界面之后，將地址和端口填寫到下圖所示位置：
其他部分配置信息說明：
Profile Name：可以隨便命名，我命名為：OneNET
Profile Type：保持默認設置，MQTT Broker
Broker Address：MQTT服務器的地址，studio-mqtt.heclouds.com
Broker Port：服務器端口，1883
Client ID：客戶端ID，此處填寫 設備名稱 ：XiaoHaLED
General 標簽下的內容，MQTT Version后面的復選框取消，其他默認即可。
填寫用戶憑證信息
在 User Credentials 標簽頁下面，需要我們填寫 User Name 和 Password 。
其中，User Name 就是產品管理頁面的產品ID ，對應我創(chuàng)建的測試設備就是：hg8zt6E3LP 。
Password 處應該填寫鑒權信息，此處即為一個token。
生成token
token的介紹
token算法詳解參考下面鏈接：
https://open.iot.10086.cn/doc/mqtt/book/manual/auth/token.html
token生成工具
OneNET提供了token生成的上位機軟件，可以通過下面鏈接下載并使用：
https://open.iot.10086.cn/doc/mqtt/book/manual/auth/tool.html
其中：res：products/{pid}/devices/{device_name}
上面是 res 的值由產品ID和設備名稱組成，通過上面我們知道，我們創(chuàng)建的測試設備的產品ID值為：hg8zt6E3LP ，設備名稱 的值為：XiaoHaLED 。
所以，最終res 的值為：products/hg8zt6E3LP/devices/XiaoHaLED
et：expiration time ，表示過期時間，此時間要求大于當前時間，為了避免太快過期，可以適當加大此參數(shù)數(shù)值，此處為unix時間。
簡單來說，unix時間戳就是從1970年1月1日（UTC/GMT的午夜）開始所經(jīng)過的秒數(shù)。
除了使用程序獲得當前unix時間以外，還可以使用網(wǎng)上現(xiàn)成的 unix時間戳 << >> 北京時間 轉換的在線工具完成，比如下面的網(wǎng)址即可：
https://tool.lu/timestamp/
2021-12-27 16:38:28 <==> et：1640594308
key：這個參數(shù)就是 產品key 這個參數(shù)，所在位置如下圖所示：
其他參數(shù)默認即可。
將上面得到的 res 、 et 、 key 代入 token計算工具 軟件中，點擊 Generate 按鈕：
生成的字符串即為 User Credentials 標簽頁下面， Password 文本框內需要填寫的內容，即填寫如下內容：
version=2018-10-31&res=products%2Fhg8zt6E3LP%2Fdevices%2FXiaoHaLED&et=1640594308&method=md5&sign=yBG2008b6SMfxiW6q6KmnA%3D%3D
其他參數(shù)默認即可，然后點擊 OK 退出配置頁面。
連接OneNET服務器
下圖下拉列表中，選擇剛剛創(chuàng)建的Profile Name：OneNET，點擊“Connect”按鈕，成功連接至OneNET平臺服務器，效果如下圖所示：
連接之后，我們查看OneNET控制臺，在 設備接入與管理-->設備管理 頁面，可以看到 XiaoHaLED 設備已經(jīng)處于在線狀態(tài)。
好了，我們已經(jīng)順利連接上了OneNET服務器，今天的分享就到這里，用這個 MQTT.fx 軟件也可以連接其他物聯(lián)網(wǎng)平臺，比如阿里云物聯(lián)網(wǎng)平臺，感興趣的可以自己試試哈~
