ucloud-iot-rtthread-package/docs/quick_start.md

快速入门示例

为了快速的让您了解如何将您的设备连接到物联网平台，我们通过一个智能空调向云平台上报温度和湿度作为示例讲解。

操作步骤

创建产品与设备

将设备接入物联网平台的第一步是在平台创建产品。产品相当于某一类设备的集合，该类设备具有相同的功能，您可以根据产品批量管理对应设备。

1. 注册UCloud云服务
2. 登录进入UCloud物联网平台

3. 创建产品

   • 点击<创建产品>，创建一个产品，为其命名，点击<确定>；
   • 创建完成后，点击产品的详情，可以对产品进行相应的配置。
     

1. 创建设备

   • 根据创建设备文档及页面提示，依次点击<详情>、点击<设备管理>、<添加设备>、<随机生成>、<生成设备个数1个>、<确定>；
     

1. 记录设备注册信息

   • 点击添加的设备，打开设备详情页，准备好设备注册相关信息，设备注册信息包含：产品序列号 设备序列号 设备密码，需要妥善保管好，后续测试需要使用。
     
     

建立设备与平台的连接

这里使用基于rtthread操作系统的软件包，快速将设备接入到物联网平台。

在C-SDK的目录sample/mqtt/中，通过修改例程mqtt_sample.c来介绍如何使用C-SDK。

配置设备信息

通过rtthread的env配置工具配置产品和设备信息。

1. 打开mqtt sample

   	--- 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                                                                                                                                                                                                                                                                                                          
   		  Version (latest)  --->
   

2.配置产品设备认证三要素

	Ucloud Device Config	--->
	[*] Device Config  ---- 
	(5xaptnq5is1xt45c) Config Product SN
	(tycfyk7697ra5jqs) Config Device SN                                                                           
	(6kh48wf6oq5xktir) Config Device Secret

1. 保存配置

2. 编译生成版本，下载到开发板中，系统启动后，在 MSH 中使用命令执行，

   msh />mqtt_test_example start 
   

3. 查看日志

平台提供日志管理功能可以查看设备行为以及所有经过平台流转的上行或下行的数据。

设备上下线

![设备上线](/images/设备上线.png)

设备上行消息

![设备上行消息](/images/设备上行消息.png)

设备下行消息

![设备下行消息](/images/设备下行消息.png)