UCloud IOT SDK for rt-thread Package

1 介绍

UCloud IOT SDK for rt-thread Package 是基于UCloud设备端C-SDK在RThread环境开发的软件包，用于连接uiot-core物联网平台

1.1 SDK架构图

1.2 目录结构

名称	说明
uiot	UCloud设备端C-SDK
ports	移植文件目录
samples	示例目录
├─mqtt	静态注册收发消息示例
├─dynamic_auth	动态注册示例
├─dev_model	物模型示例
├─ota	ota升级示例
├─shadow	设备影子示例
docs	说明文档
LICENSE	许可证文件
README.md	软件包使用说明
SConscript	RT-Thread 默认的构建脚本

1.3 许可证

许可协议Apache 2.0。

1.4 依赖

Tls功能需要mbedtls软件包 [ ] mbedtls: An portable and flexible SSL/TLS library ----

ota功能需要ota_downloader [ ] ota_downloader: The firmware downloader which using on RT-Thread OTA component --->

2 如何打开软件包

menuconfig配置

• RT-Thread env开发工具中使用 menuconfig 软件包，配置产品及设备信息， 路径如下：

RT-Thread online packages  --->
	IoT - internet of things  --->
		IoT Cloud  --->
			[ ] ucloud-iot-sdk: ucloud iot sdk for uiot-core platform.  --->
			  --- ucloud-iothub:  ucloud iot sdk for uiot-core platform 
				[ ]   Enable Mqtt 
				ucloud Device Config  --->  
				Version (latest)  --->	

3 软件包的使用

根据产品需求选择合适的应用示例修改新增业务逻辑，也可新增例程编写新的业务逻辑。

	--- ucloud-iot-sdk: ucloud iot sdk for uiot-core platform.
	[*]   Enable mqtt                                                                                             
		Auth Mode (Enable Static Register)  --->                                                               
			Ucloud Device Config  --->                                                                                 
	[ ]   Enable Shadow                                                                                        
	[ ]   Enable Dev Model                                                                                      
	[ ]   Enable Ota                                                                                                
	[ ]   Enable Tls                                                                                            
	[ ]   Enable Ucloud Mqtt Sample                                                                                 
	[ ]   Enable Ucloud Shadow Sample                                                                          
	[ ]   Enable Ucloud Dev Model Sample                                                                        
	[ ]   Enable Ucloud Ota Sample                                                                              
		  Version (latest)  --->

• 选项说明

Enable mqtt：使能MQTT功能。

Auth Mode (Enable static register)：认证模式，分为静态认证和动态认证模式, (括号内为当前选择的模式)。

Enable Static Register：静态注册模式使用产品号，设备号，设备密钥认证

Enable Dynamic Register：动态注册模式使用产品号，设备号，产品密钥认证

Ucloud Device Config ：根据认证模式填写当前设备认证要素，动态认证时，设备密钥可以不填写

Enable Shadow：使能设备影子功能

Enable Dev Model：使能物模型功能

Enable Ota：使能远程升级版本的功能，若使能，则会关联选中ota_downloader软件包。

Enable TLS： 是否使能TLS，若使能，则会关联选中mbedTLS软件包。

Enable Ucloud Mqtt Sample：使能mqtt收发消息的案例

Enable Ucloud Shadow Sample：使能物模型的案例

Enable Ucloud Dev Model Sample：使能物模型的案例

Enable Ucloud Ota Sample：使能远程升级版本的案例

Version (latest) --->：

• 使用 pkgs --update 命令下载软件包

2.2 创建可订阅可发布的Topic

案例中使用的topic为订阅/接收权限的topic需要在云平台上将/{ProductSN}/{DeviceSN}/set增加权限

2.3 编译及运行

1. 使用命令 scons --target=xxx 输出对应的工程，编译

2. 打开生成的工程，编译下载到设备中

2.4 运行demo程序

系统启动后，在 MSH 中使用命令执行：