{"id":24091617,"url":"https://github.com/ucloud/ucloud-iot-rtthread-package","last_synced_at":"2025-09-17T01:31:32.646Z","repository":{"id":45996291,"uuid":"232487768","full_name":"ucloud/ucloud-iot-rtthread-package","owner":"ucloud","description":"基于RT-Thread操作系统用于快速连接uiot-core的软件包","archived":true,"fork":false,"pushed_at":"2021-11-22T01:41:53.000Z","size":1834,"stargazers_count":6,"open_issues_count":1,"forks_count":3,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-04-17T21:12:10.320Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://www.rt-thread.org/document/site/","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ucloud.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-01-08T05:46:15.000Z","updated_at":"2023-01-28T02:44:56.000Z","dependencies_parsed_at":"2022-08-25T09:21:07.750Z","dependency_job_id":null,"html_url":"https://github.com/ucloud/ucloud-iot-rtthread-package","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ucloud%2Fucloud-iot-rtthread-package","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ucloud%2Fucloud-iot-rtthread-package/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ucloud%2Fucloud-iot-rtthread-package/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ucloud%2Fucloud-iot-rtthread-package/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ucloud","download_url":"https://codeload.github.com/ucloud/ucloud-iot-rtthread-package/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":233312637,"owners_count":18657080,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-01-10T07:44:38.257Z","updated_at":"2025-09-17T01:31:27.177Z","avatar_url":"https://github.com/ucloud.png","language":"C","readme":"##  UCloud IOT SDK for rt-thread Package \n## 1 介绍\n\nUCloud IOT SDK for rt-thread Package 是基于[UCloud设备端C-SDK](https://github.com/ucloud/ucloud-iot-device-sdk-c)在RThread环境开发的软件包，用于连接uiot-core物联网平台\n\n### 1.1 SDK架构图\n![](https://uiot.cn-sh2.ufileos.com/sdk%E6%9E%B6%E6%9E%84%E5%9B%BE.png)\n\n### 1.2 目录结构\n\n| 名称              | 说明 |\n| ----              | ---- |\n| docs              | 说明文档 |\n| ports             | 移植文件目录 |\n| samples           | 示例文件目录 |\n| uiot              | UCloud设备端C-SDK |\n| LICENSE           | 许可证文件 |\n| README.md         | 软件包使用说明 |\n| SConscript        | RT-Thread 默认的构建脚本 |\n\n### 1.3 许可证\n\n许可协议Apache 2.0。\n\n### 1.4 依赖\nOta功能需要fal软件包\n[ ] fal: Flash Abstraction Layer implement. Manage flash device and partition.  ---\u003e\nTls功能需要mbedtls软件包\n[ ] mbedtls: An portable and flexible SSL/TLS library  ----\n\n## 2 如何打开软件包\nmenuconfig配置\n- RT-Thread env开发工具中使用 `menuconfig` 软件包，配置产品及设备信息，\n路径如下：\n```\nRT-Thread online packages  ---\u003e\n    IoT - internet of things  ---\u003e\n        IoT Cloud  ---\u003e\n            [ ] ucloud_iot_sdk: Ucloud iot sdk for uiot-core platform.  ---\u003e\n              --- ucloud_iot_sdk:  Ucloud iot sdk for uiot-core platform \n                Ucloud Device Config  ---\u003e                  \n                [ ]   Enable Mqtt Link uiot-core Platform\n                [ ]   Enable Http Link uiot-core Platform\n                [ ]   Enable Ucloud Debug\n                Version (latest)  ---\u003e\t\n```\n\n## 3 软件包的使用\n根据产品需求选择合适的应用示例修改新增业务逻辑，也可新增例程编写新的业务逻辑。\n```\t\n    --- ucloud_iot_sdk: Ucloud iot sdk for uiot-core platform.\n          Ucloud Device Config  ---\u003e    \n    [*]   Enable Mqtt Link uiot-core Platform\n    [ ]     Enable Ucloud Mqtt Sample \n    [ ]     Enable Ucloud Mqtt Dynamic Auth Sample\n    [*]   Enable Http Link uiot-core Platform\n    [ ]     Enable Ucloud Http Publish Sample\n    [ ]     Enable Ucloud Http Upload File Sample\n    [*]   Enable Shadow      \n    [ ]     Enable Ucloud Shadow Sample\n    [*]   Enable Dev Model  \n    [ ]     Enable Ucloud Dev Model Sample\n    [*]   Enable Ota                                                                                                \n    [ ]     Enable Ucloud Ota Sample  \n    -*-   Enable Tls \n    [ ]   Enable Ucloud Debug\n          Version (latest)  ---\u003e\n```\n\n- 选项说明\n`Ucloud Device Config `：填写当前设备认证要素，当认证模式为动态认证时，设备密钥可以不填写\n\n`Enable Mqtt Link uiot-core Platform`：使能MQTT连接云平台功能。\n\n`Enable Ucloud Mqtt Sample`：使能静态注册mqtt和注册成功后收发消息的案例\n\n`Enable Ucloud Mqtt Dynamic Auth Sample`: 使能动态注册mqtt和注册成功后收发消息的案例\n\n`Enable Http Link uiot-core Platform`：使能HTTP连接云平台功能,包括使用https上传消息和上传文件，只支持https,勾选会关联选中mbedTLS软件包。\n\n`Enable Ucloud Http Publish Sample`：使能使用https向云平台上传消息的案例\n\n`Enable Ucloud Http Upload File Sample`: 使能使用https向云平台上传一段buffer在云端保存成文件的案例\n\n`Enable Shadow`：使能设备影子功能\n\n`Enable Ucloud Shadow Sample`：使能设备影子的案例\n\n`Enable Dev Model`：使能物模型功能\n\n`Enable Ucloud Dev Model Sample`：使能物模型的案例\n\n`Enable Ota`：使能远程升级版本的功能，若使能由于要使用flash的分区功能进行ota升级，会关联选中fal软件包。\n\n`Enable Ucloud Ota Sample`：使能远程升级版本的案例\n\n`Enable TLS`： 是否使能TLS，若使能，则会关联选中mbedTLS软件包。\n\n`Enable Ucloud Debug`: 使能调试打印输出\n\n`Version (latest)  ---\u003e`：选择软件包的版本\n\n- 使用 `pkgs --update` 命令下载需要使用的软件包\n\n### 2.2 编译及运行\n1. 使用命令 scons --target=xxx 输出对应的工程，编译 \n\n2. 打开生成的工程，编译下载到设备中\n\n### 2.3 运行demo程序\n系统启动后，在 MSH 中使用命令执行，以mqtt_sample为例：\n启动案例：mqtt_test_example start\n终止案例：mqtt_test_example stop\n\n执行输出：\nmsh /\u003emqtt_test_example start                                                                                                       \nestablish tcp connection with server(host='mqtt-cn-sh2.iot.ucloud.cn', port=[1883])                                                 \nmsh /\u003esuccess to establish tcp, fd=4                                                                                                \nCloud Device Construct Successsubscribe success, packet-id=2                                                                        \npublish success, packet-id=3                                                                                                        \nReceive Message With topicName:/fahnimwwvph259ag/3um7h4fdiigf2yyh/upload/event, payload:{\"test\": \"0\"}                               \npublish success, packet-id=4                                                                                                        \nReceive Message With topicName:/fahnimwwvph259ag/3um7h4fdiigf2yyh/upload/event, payload:{\"test\": \"1\"}                               \npublish success, packet-id=5                                                                                                        \nReceive Message With topicName:/fahnimwwvph259ag/3um7h4fdiigf2yyh/upload/event, payload:{\"test\": \"2\"}                               \npublish success, packet-id=6                                                                                                        \nReceive Message With topicName:/fahnimwwvph259ag/3um7h4fdiigf2yyh/upload/event, payload:{\"test\": \"3\"}                               \npublish success, packet-id=7                                                                                                        \nReceive Message With topicName:/fahnimwwvph259ag/3um7h4fdiigf2yyh/upload/event, payload:{\"test\": \"4\"}                               \npublish success, packet-id=8                                                                                                        \nReceive Message With topicName:/fahnimwwvph259ag/3um7h4fdiigf2yyh/upload/event, payload:{\"test\": \"5\"}                               \npublish success, packet-id=9                                                                                                        \nReceive Message With topicName:/fahnimwwvph259ag/3um7h4fdiigf2yyh/upload/event, payload:{\"test\": \"6\"}                               \npublish success, packet-id=10                                                                                                       \nReceive Message With topicName:/fahnimwwvph259ag/3um7h4fdiigf2yyh/upload/event, payload:{\"test\": \"7\"}                               \npublish success, packet-id=11                                                                                                       \nReceive Message With topicName:/fahnimwwvph259ag/3um7h4fdiigf2yyh/upload/event, payload:{\"test\": \"8\"}                               \npublish success, packet-id=12                                                                                                       \nReceive Message With topicName:/fahnimwwvph259ag/3um7h4fdiigf2yyh/upload/event, payload:{\"test\": \"9\"} \n\n\n\n\n\n\n\n","funding_links":[],"categories":["Packages"],"sub_categories":["IoT"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fucloud%2Fucloud-iot-rtthread-package","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fucloud%2Fucloud-iot-rtthread-package","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fucloud%2Fucloud-iot-rtthread-package/lists"}