前言

UIoT RT-Thread軟件包實現了IoT設備與UCloud UIoT Core物聯網通信云平臺連接，包含設備注冊、MQTT、設備影子、物模型、OTA、文件上傳等功能，開發者進行靈活裁剪。

軟件包的簡介

軟件包架構框圖

軟件包目錄結構

依賴說明

OTA功能需要fal軟件包

TLS功能需要mbedtls軟件包

資源占用

統計UCloudSDK資源占用分為兩種場景，分別為ROM和RAM占用最少和最多的示例，統計的時候包含RT-Thread操作系統及其他依賴的軟件包

測試平臺：

?測試平臺：STM32F767 + ESP8266

?測試IDE：MDK5

?優化級別：o3

資源占用如下：

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

軟件包的使用

方法一：通過ENV使用軟件包

1.打開RT-Thread env開發工具，使用 menuconfig選擇UIoT RT-Thread軟件包。

2.配置UIoT物聯網平臺認證4要素（productSN、productSecret、deviceSN、deviceSecret），這4要素可以生成MQTT連接所需要的clientid、username、password。

認證4要素，需要完成以下工作：

1）注冊UCloud平臺賬號，并完成實名認證（否則無法使用）；（參加RT-Thread應用創新設計大賽可申請800元體驗金）

2）登錄UIoT物聯網平臺的控制臺，創建產品、創建設備

3）獲取平臺認證4要素。

4）將4要素填寫到如下圖的config中。

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

4.軟件包配置選項詳細說明：

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

5.保存配置：

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

7.生成MDK工程

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

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

2.配置軟件包

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

4.編譯下載至開發板

通過MSH命令行運行demo程序，上行數據

運行mqtt_test_example，該示例連接UIoT-Core平臺，同時發送10條MQTT消息到UIoT物聯網云平臺。

在云平臺上可以查看相關日志，方便調試