前言

UIoT RT-Thread軟件包實(shí)現(xiàn)了IoT設(shè)備與UCloud UIoT Core物聯(lián)網(wǎng)通信云平臺(tái)連接，包含設(shè)備注冊(cè)、MQTT、設(shè)備影子、物模型、OTA、文件上傳等功能，開(kāi)發(fā)者進(jìn)行靈活裁剪。

軟件包的簡(jiǎn)介

軟件包架構(gòu)框圖

軟件包目錄結(jié)構(gòu)

依賴(lài)說(shuō)明

OTA功能需要fal軟件包

TLS功能需要mbedtls軟件包

資源占用

統(tǒng)計(jì)UCloudSDK資源占用分為兩種場(chǎng)景，分別為ROM和RAM占用最少和最多的示例，統(tǒng)計(jì)的時(shí)候包含RT-Thread操作系統(tǒng)及其他依賴(lài)的軟件包

測(cè)試平臺(tái)：

?測(cè)試平臺(tái)：STM32F767 + ESP8266

?測(cè)試IDE：MDK5

?優(yōu)化級(jí)別：o3

資源占用如下：

MQTT示例（使用了AT Device、SAL）:ROM83K RAM 31KOTA+TLS 示例（使用了ATDevice、SAL、FAL、mbedtls）:ROM 187K RAM 87K

軟件包的使用

方法一：通過(guò)ENV使用軟件包

1.打開(kāi)RT-Thread env開(kāi)發(fā)工具，使用 menuconfig選擇UIoT RT-Thread軟件包。

2.配置UIoT物聯(lián)網(wǎng)平臺(tái)認(rèn)證4要素（productSN、productSecret、deviceSN、deviceSecret），這4要素可以生成MQTT連接所需要的clientid、username、password。

認(rèn)證4要素，需要完成以下工作：

1）注冊(cè)UCloud平臺(tái)賬號(hào)，并完成實(shí)名認(rèn)證（否則無(wú)法使用）；（參加RT-Thread應(yīng)用創(chuàng)新設(shè)計(jì)大賽可申請(qǐng)800元體驗(yàn)金）

2）登錄UIoT物聯(lián)網(wǎng)平臺(tái)的控制臺(tái)，創(chuàng)建產(chǎn)品、創(chuàng)建設(shè)備

3）獲取平臺(tái)認(rèn)證4要素。

4）將4要素填寫(xiě)到如下圖的config中。

3.選擇需要使用的功能，軟件包功能介紹請(qǐng)參考文檔（https://docs.ucloud.cn/iot/uiot-core/product_introduction/function_introduction以上鏈接請(qǐng)復(fù)制至外部瀏覽器打開(kāi)）

4.軟件包配置選項(xiàng)詳細(xì)說(shuō)明：

Ucloud Device Config：填寫(xiě)當(dāng)前設(shè)備認(rèn)證要素，當(dāng)認(rèn)證模式為動(dòng)態(tài)認(rèn)證時(shí)，設(shè)備密鑰可以不填寫(xiě)
Enable Mqtt Link uiot-core Platform：使能mqtt連接云平臺(tái)功能。
Enable Ucloud Mqtt Sample：使能靜態(tài)注冊(cè)mqtt和注冊(cè)成功后收發(fā)消息的案例
Enable Ucloud Mqtt Dynamic Auth Sample: 使能動(dòng)態(tài)注冊(cè)mqtt和注冊(cè)成功后收發(fā)消息的案例
Enable Http Link uiot-core Platform：使能http連接云平臺(tái)功能,包括使用https上傳消息和上傳文件，只支持https，勾選會(huì)關(guān)聯(lián)選中mbedTLS軟件包。
Enable Ucloud Http Publish Sample：使能使用https向云平臺(tái)上傳消息的案例
Enable Ucloud Http Upload File Sample: 使能使用https向云平臺(tái)上傳一段buffer在云端保存成文件的案例
Enable Shadow：使能設(shè)備影子功能
Enable Ucloud Shadow Sample：使能設(shè)備影子的案例
Enable Dev Model：使能物模型功能
Enable Ucloud Dev Model Sample：使能物模型的案例
Enable Ota：使能遠(yuǎn)程升級(jí)版本的功能，若使能由于要使用flash的分區(qū)功能進(jìn)行ota升級(jí)，會(huì)關(guān)聯(lián)選中fal軟件包。
Enable Ucloud Ota Sample：使能遠(yuǎn)程升級(jí)版本的案例
Enable TLS：是否使能TLS，若使能，則會(huì)關(guān)聯(lián)選中mbedtls軟件包。
Enable Ucloud Debug: 使能調(diào)試打印輸出
Version (latest)：選擇軟件包的版本

5.保存配置：

6.下載軟件包，并生成MDK5工程：

7.生成MDK工程

方法二：通過(guò)RT-Thread studio使用UIoT RT-Thread軟件包

1.新建一個(gè)RT-Thread工程，添加UIoT RT-Thread軟件包。

2.配置軟件包

3.配置完成后保存生成代碼。

4.編譯下載至開(kāi)發(fā)板

通過(guò)MSH命令行運(yùn)行demo程序，上行數(shù)據(jù)

運(yùn)行mqtt_test_example，該示例連接UIoT-Core平臺(tái)，同時(shí)發(fā)送10條MQTT消息到UIoT物聯(lián)網(wǎng)云平臺(tái)。

在云平臺(tái)上可以查看相關(guān)日志，方便調(diào)試