?今天我們來學習使用合宙Air708E開發板的MQTT通信基本功能。

一、MQTT介紹

MQTT是一種低開銷、低帶寬占用的即時通訊協議，可以用極少的代碼和帶寬為遠程設備提供實時可靠的消息服務。它適用于硬件性能低下的設備以及網絡狀況不佳的環境，因此在物聯網（IoT）小型設備和移動應用等方面有廣泛應用。

MQTT采用發布/訂閱通信模型，客戶端可以發布消息到主題（Topic），也可以訂閱主題來接收消息。這種模式解耦了消息的發送者和接收者。

MQTT的消息傳遞質量分為三種：最多一次（QoS0）不保證交付，至少一次（QoS1）確保至少到達但可能重復，只有一次（QoS2）確保僅到達一次。

二、演示功能概述

本demo通過使用AIR708E開發板，帶你快速體驗通過MQTT協議進行數據接收與發送。

三、準備硬件環境

3.1 AIR780E開發板

3.2 TYPE-C線快充線

四、準備軟件環境

注：以下軟件下載鏈接，請復制后，粘貼到瀏覽器URL地址欄進行下載；

4.1 MQTT.fx

MQTT客戶端軟件下載：

https://docs.openluat.com/air780e/luatos/app/socket/mqtt/

4.2 Luatools

Luatools日志打印與程序燒錄軟件下載：

https://doc.openluat.com/wiki/52?wiki_page_id=5071

4.3 core固件和源碼腳本

注：core固件，是基礎環境，該固件由合宙官方提供，用戶不可修改；源碼腳本，為應用程序，可由客戶自行修改；

五、軟硬件資料

●AIR708E開發板原理圖，打開Air780E產品手冊，訪問頁面中的《EVB_Air780X_V1.6.zip》

●API使用介紹說明

●AIR708E開發板使用說明，打開Air780E產品手冊，訪問頁面中的《Core_Air780E使用說明V1.0.5.pdf》

5.1 開發板按鈕與指示燈圖示與說明

?

?

5.2 硬件安裝與連接

5.2.1 SIM卡安裝

?

5.2.2 實物連接圖

?

注：開發板與電腦通過TYPE-C線連接，用于通信與供電，所以必須使用“支持快充”的TYPE-C線才可以；

六、代碼示例介紹

6.1 DEMO軟件流程圖

?

6.2 配置

6.2.1 MQTT的4個重要配置

• localmqtt_host="lbsmqtt.airm2m.com"（MQTT服務器地址，這里使用合宙提供公用測試服務器）
• localmqtt_port=1884（MQTT端口）
• localuser_name="user"（MQTT服務器登錄用戶名）
• localpassword="password"（MQTT服務器登錄密碼）

6.2.2 MQTT的2個重要主題

• localpub_topic="/luatos/pub/123"--..(mcu.unique_id():toHex())（設備發布主題，以下方源碼55行，可自行修改）
• localsub_topic="/luatos/sub/123"--..(mcu.unique_id():toHex())（設備訂閱主題，以下方源碼56行，可自行修改）

6.3 完整程序清單

注：完整復制后保存為main.lua，可直接使用

?

七、功能驗證

7.1 開機

按圖1所示通過TYPE-C線將開發板與電腦連接無誤后，開發板電源指示紅燈常亮，網絡指示燈滅，如下圖：

?

此時按下開機鍵，約2秒后釋放，等待幾秒網絡指示綠燈常亮，即開機成功，如下圖：

?

此時電腦設備管理器中會發現下圖所示幾個設備，即代表開機成功！

?

7.2 打開Luatool軟件工具并進入項目管理測試頁面

?

圖4

7.3 按序號步驟創建項目

?

?

7.4 按如下步驟進行程序燒錄

?

?

7.5 觀察下載過程后確認燒錄結果

?

?

7.6 查看調試日志，獲取設備發布與訂閱主題

?

7.7 打開MQTT客戶端MQTT.fx應用程序并配置

7.7.1 MQTT客戶端基本配置

ProfileName：合宙（可修改為你想要的名稱）

BrokerAddress：http://lbsmqtt.airm2m.com（合宙提供的免費測試服務器，也可修改為自己的服務器）

BrokerPort：1883（端口號）

UserName：user

Password：password

7.7.2 兩個重要主題

設備發布主題：861959068926349/up（設備向服務器發送數據使用）

設備訂閱主題：861959068926349/down（接收服務器數據主題）

?

7.8 訂閱設備主題

?

7.9 MQTT客戶端給開發板發送數據

?

7.10 查MQTT客戶端訂閱的設備數據

?

八、總結

至此，我們已使用AIR708E開發板完成了MQTT通信的基本功能。

?審核編輯 黃宇