騰訊云-MQTT.fx 接入指南
操作場(chǎng)景
MQTT.fx 是目前主流的 MQTT 桌面客戶端，它支持 Windows、 Mac、Linux 操作系統(tǒng)，可以快速驗(yàn)證是否可與 IoT Cloud 進(jìn)行連接，并發(fā)布或訂閱消息。更多 MQTT 協(xié)議介紹請(qǐng)參見 MQTT 協(xié)議介紹。本文檔主要介紹 MQTT.fx 如何與騰訊云 IoT Cloud 交互。本文以 MQTT.fx 1.7.0 for Mac 版本為例。
操作步驟
連接 IoT Cloud
打開 MQTT.fx 下載頁面，找到適合的版本，下載并安裝 MQTT.fx 客戶端。
打開 MQTT.fx 客戶端程序，單擊【設(shè)置】。
進(jìn)入設(shè)置頁面，并單擊【+】，創(chuàng)建一個(gè)新的配置文件。
填寫 Connection Profile 相關(guān)信息和 General 信息。
填寫 User Credentials 信息。
說明：User Name ：MQTT 協(xié)議字段，按照物聯(lián)網(wǎng)通信約束填入：產(chǎn)品 ID + 設(shè)備名 + SDKAppID + connid。（創(chuàng)建完產(chǎn)品即可在產(chǎn)品列表頁和產(chǎn)品詳情頁查看 ProductID）如："9B17RZW2EZgate_dev01;12010126;12345"，僅替換示例中的產(chǎn)品 ID + 設(shè)備名即可，后面的兩個(gè)參數(shù)本身由物聯(lián)網(wǎng)通信接入 SDK 自動(dòng)生成，所以這里填寫固定測(cè)試值。
Password ：Password 必須填寫，由于 mqtt.fx 默認(rèn)將密碼標(biāo)志位設(shè)為 true，所以需要填寫一個(gè)任意的非空字符串作為密碼，否則無法連接到物聯(lián)云通信后臺(tái)。而實(shí)際接入物聯(lián)云后臺(tái)時(shí)，鑒權(quán)是根據(jù)證書認(rèn)證，此處隨機(jī)填寫的密碼不會(huì)作為接入憑證。
選擇開啟 SSL/TLS，勾選 Self signed Certificates，上傳相關(guān)內(nèi)容。
注意：由于 IoT Cloud 使用安全加密鏈路，因此還需要設(shè)置 SSL/TLS 信息。MQTT.fx 不支持對(duì)稱加密 PSK，本文僅演示非對(duì)稱加密連接設(shè)置。
完成以上步驟設(shè)置后，單擊【Apply】和【OK】進(jìn)行保存，并在配置文件框中選擇剛才創(chuàng)建的文件名，單擊【Connect】。
當(dāng)右上角圓形圖標(biāo)為綠色時(shí)，說明已連接 IoT Cloud 成功，可進(jìn)行發(fā)布和訂閱操作。
參數(shù)說明
上文涉及到的相關(guān)參數(shù)及文件說明，請(qǐng)參考下表：
| 參數(shù) | 說明 |
|---|---|
| Profile Name | 配置文件保存為的名稱。 |
| Broker Address | MQTT 服務(wù)器連接地址，廣州域設(shè)備填入：PRODUCT_ID.iotcloud.tencentdevices.com，這里 PRODUCT_ID 為變量參數(shù)，用戶需填入創(chuàng)建產(chǎn)品時(shí)自動(dòng)生成的產(chǎn)品 ID，例如 9B17RZW2EZ.iotcloud.tencentdevices.com |
| Broker Port | MQTT 服務(wù)器連接端口，填入：8883。 本文主要針對(duì)證書認(rèn)證類型的產(chǎn)品，端口必須是8883；如果您想通過1883接口接入，建議使用密鑰認(rèn)證型產(chǎn)品自行接入，詳情請(qǐng)參考 設(shè)備基于 MQTT 接入 進(jìn)行接入。 |
| Client ID | MQTT 協(xié)議字段，按照物聯(lián)網(wǎng)通信約束填入：產(chǎn)品 ID + 設(shè)備名，例如："9B17RZW2EZgate_dev01 "，9B17RZW2EZ 是產(chǎn)品 ID，gate_dev01 是設(shè)備名。 |
| Connection Timeout | 連接超時(shí)時(shí)間秒。 |
| Keep Alive Interval | 心跳間隔時(shí)間秒。 |
| Auto Reconnect | 斷網(wǎng)自動(dòng)重連。 |
| 文件 | 說明 |
|---|---|
| CA File | 根證書，單擊 ca.crt 鏈接下載文件。 |
| Client Certificate File | 客戶端證書文件，即設(shè)備證書，在證書認(rèn)證產(chǎn)品中創(chuàng)建設(shè)備時(shí)下載，詳情請(qǐng)查看 設(shè)備接入準(zhǔn)備。 |
| Client Key File | 客戶端密鑰文件，即設(shè)備密鑰，在證書認(rèn)證產(chǎn)品中創(chuàng)建設(shè)備時(shí)下載，詳情請(qǐng)查看 設(shè)備接入準(zhǔn)備。 |
| PEM Formatted | 由于物聯(lián)網(wǎng)通信根證書、設(shè)備證書、設(shè)備密鑰均由 openssl 生成使用 PEM 格式，而 MQTT.fx 是 Java 客戶端，所以不識(shí)別 PEM 證書，這里需要勾選由該客戶端自動(dòng)轉(zhuǎn)換為 Java 識(shí)別的 JKS 格式。 |
發(fā)布消息
選擇客戶端 Publish Tab，輸入主題名稱、Qos 等級(jí)，單擊【Publish】進(jìn)行發(fā)布。發(fā)布結(jié)果可通過 云日志 查詢。
訂閱主題
選擇客戶端 Subscribe Tab，輸入主題名稱、Qos 等級(jí)，單擊【Subscribe】進(jìn)行主題訂閱，訂閱結(jié)果可通過 云日志 查詢。
售前咨詢專員
