測(cè)試環(huán)境：stm32F401RCT6、RT-Thread版本: v4.1.0、RT-Thread Studio版本: 2.2.6、網(wǎng)絡(luò)硬件使用ec800m移植at_socket使用sal框架。

1、添加網(wǎng)絡(luò)硬件
RyanMqtt依賴SAL框架 / LWIP。

此步驟不做過(guò)多解釋，是lwip就用lwip，是at設(shè)備就用at_socket。推薦所有平臺(tái)都使用SAL框架（RyanMqtt軟件包會(huì)自動(dòng)使能）。

2、添加RyanMqtt
這里使用的Studio開(kāi)發(fā)環(huán)境，點(diǎn)擊 RT-Thread Settings，選擇添加軟件包，搜索RyanMqtt添加。

開(kāi)啟RyanMqtt msh示例，版本建議選擇latest (latest包含了最新的錯(cuò)誤修復(fù)和特性，推送前都經(jīng)過(guò)測(cè)試的。但是rt-thread使用gitee鏡像，同步需要1-3天，如果要使用最新latest版本請(qǐng)修改為github源)

添加后如下圖所示，直接編譯然后燒錄

3、使用msh測(cè)試?yán)?br /> 網(wǎng)絡(luò)硬件必須要能連接到網(wǎng)絡(luò)，否則mqtt沒(méi)有任何意義
編譯燒錄后在串口終端輸入 “help” / table鍵，打印shell命令信息，查看是否有mqtt命令，如下圖所示。

注：沒(méi)有mqtt命令的請(qǐng)查看RyanMqtt軟件包是否開(kāi)啟了msh示例

接著我們輸入 “mqtt” / “mqtt help” 命令，打印信息如下圖所示

可以看到msh示例程序給出的部分mqtt功能命令，左側(cè)為mqtt示例命令，中間為命令介紹，右側(cè)為需要傳遞的參數(shù)。

接下來(lái)我們依次試試每個(gè)命令的功能。

mqtt state （打印mqtt客戶端狀態(tài)）
打印當(dāng)前mqtt的狀態(tài)。狀態(tài)定義為

typedef enum
{
    RyanMqttInvalidState = -1, // 無(wú)效狀態(tài)
    RyanMqttInitState = 0,     // 初始化狀態(tài)
    RyanMqttStartState,        // 開(kāi)始狀態(tài)
    RyanMqttConnectState,      // 連接狀態(tài)
    RyanMqttDisconnectState,   // 斷開(kāi)連接狀態(tài)
    RyanMqttReconnectState,    // 重新連接狀態(tài)
} RyanMqttState_e;

讓我們嘗試一下
無(wú)效狀態(tài)，因?yàn)槲覀冞€沒(méi)有調(diào)用連接函數(shù)，mqtt客戶端還沒(méi)有被初始化，所以為無(wú)效狀態(tài)

mqtt connect （mqtt連接服務(wù)器）
連接mqtt服務(wù)器，可以看到參數(shù)為null。連接服務(wù)器的配置信息在RyanMqttTest.c文件的頭部，如下所示
修改下面配置信息來(lái)連接你的mqtt服務(wù)器，”broker.emqx.io” 為emqx的開(kāi)放mqtt服務(wù)器。
注意：mqtt客戶端id必須唯一，請(qǐng)務(wù)必進(jìn)行修改！

讓我們嘗試一下connect

可以看到打印了一條 “mqtt連接成功回調(diào)” 。為什么會(huì)打印呢？ 這我們就要看看mqtt connect命令做了什么？
首先我們要找到cmdTab，這里存放了示例的所有命令。

我們點(diǎn)擊connect示例對(duì)應(yīng)的函數(shù) “MqttConnect”秘密就發(fā)生在mqttConfig的回調(diào)函數(shù)和注冊(cè)事件中。我們?cè)谧?cè)事件回調(diào)中選擇了所有事件，其中就包括了mqtt連接成功事件。如下圖所示
當(dāng)mqtt連接成功時(shí)就會(huì)調(diào)用mqttConfig中的mqttEventHandle函數(shù)指針。在mqttEventHandle內(nèi)部我們打印了一條 “mqtt連接成功回調(diào)”

回調(diào)函數(shù)內(nèi)部

可注冊(cè)的回調(diào)事件定義為

mqtt disc （mqtt斷開(kāi)連接服務(wù)器）
主動(dòng)斷開(kāi)mqtt服務(wù)器的連接，使用效果如下，回調(diào)函數(shù)中打印了 “mqtt斷開(kāi)連接回調(diào)”
圖中 “204” 為斷開(kāi)連接事件的eventData，可查看可注冊(cè)的回調(diào)事件定義對(duì)于eventData的定義。
注：為什么斷開(kāi)連接后會(huì)自動(dòng)重連呢？ 我們?cè)谡{(diào)用connect示例的時(shí)候使能了 “自動(dòng)重連” 并定義了重連時(shí)間。

mqtt reconnect （mqtt斷開(kāi)連接時(shí)重新連接服務(wù)器）
當(dāng)我們沒(méi)有使能 “自動(dòng)重連” 時(shí)，我們可以手動(dòng)調(diào)用 RyanMqttReconnect 函數(shù)來(lái)進(jìn)行重連
注：如果mqtt客戶端不為 RyanMqttDisconnectState 狀態(tài)，此接口不會(huì)進(jìn)行任何操作

mqtt destory （mqtt銷毀客戶端）
銷毀mqtt客戶端，釋放mqtt客戶端申請(qǐng)的所有資源。

銷毀mqtt客戶端因?yàn)榘踩珕?wèn)題，設(shè)置為異步操作，當(dāng)接收到 RyanMqttEventDestoryBefore 事件后才真正開(kāi)始銷毀。真正開(kāi)始銷毀速度非?？?！就只是釋放資源。
至于最多要多長(zhǎng)時(shí)間才可以銷毀？如果網(wǎng)絡(luò)層移植的沒(méi)有問(wèn)題，最長(zhǎng)時(shí)間為初始化config里的recvTimeout

注：客戶端需要初始化后的才可以被銷毀，否則會(huì)忽視

mqtt pub （mqtt發(fā)布消息）
根據(jù)命令提示，需要傳入 主題、消息等級(jí)、發(fā)送內(nèi)容、發(fā)送條數(shù)、間隔時(shí)間(可以為0)
這里我們使用 mqttx工具來(lái)做上位機(jī)

使用命令：mqtt pub testup 2 hello 10 0