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 Tls                                                                                            
    [ ]   Enable Ucloud Mqtt Sample 
    [ ]   Enable Shadow      
    [ ]     Enable Ucloud Shadow Sample
    [ ]   Enable Dev Model  
    [ ]     Enable Ucloud Dev Model Sample
    [ ]   Enable Ota                                                                                                
    [ ]     Enable Ucloud Ota Sample  
    [ ]   Enable Ucloud Debug
          Version (latest)  --->

• 选项说明

Enable mqtt：使能MQTT功能。

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

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

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

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

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

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

Enable Shadow：使能设备影子功能

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

Enable Dev Model：使能物模型功能

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

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

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

Enable Ucloud Debug: 使能打印输出

Version (latest) --->：

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

2.2 编译及运行

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

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

2.4 运行demo程序

系统启动后，在 MSH 中使用命令执行，以mqtt_sample为例： 启动案例：mqtt_test_example start 终止案例：mqtt_test_example stop

执行输出： msh />mqtt_test_example start
establish tcp connection with server(host='mqtt-cn-sh2.iot.ucloud.cn', port=[1883])
msh />success to establish tcp, fd=4
Cloud Device Construct Successsubscribe success, packet-id=2
publish success, packet-id=3
Receive Message With topicName:/fahnimwwvph259ag/3um7h4fdiigf2yyh/upload/event, payload:{"test": "0"}
publish success, packet-id=4
Receive Message With topicName:/fahnimwwvph259ag/3um7h4fdiigf2yyh/upload/event, payload:{"test": "1"}
publish success, packet-id=5
Receive Message With topicName:/fahnimwwvph259ag/3um7h4fdiigf2yyh/upload/event, payload:{"test": "2"}
publish success, packet-id=6
Receive Message With topicName:/fahnimwwvph259ag/3um7h4fdiigf2yyh/upload/event, payload:{"test": "3"}
publish success, packet-id=7
Receive Message With topicName:/fahnimwwvph259ag/3um7h4fdiigf2yyh/upload/event, payload:{"test": "4"}
publish success, packet-id=8
Receive Message With topicName:/fahnimwwvph259ag/3um7h4fdiigf2yyh/upload/event, payload:{"test": "5"}
publish success, packet-id=9
Receive Message With topicName:/fahnimwwvph259ag/3um7h4fdiigf2yyh/upload/event, payload:{"test": "6"}
publish success, packet-id=10
Receive Message With topicName:/fahnimwwvph259ag/3um7h4fdiigf2yyh/upload/event, payload:{"test": "7"}
publish success, packet-id=11
Receive Message With topicName:/fahnimwwvph259ag/3um7h4fdiigf2yyh/upload/event, payload:{"test": "8"}
publish success, packet-id=12
Receive Message With topicName:/fahnimwwvph259ag/3um7h4fdiigf2yyh/upload/event, payload:{"test": "9"}