Linux设备如何接入阿里云IoT平台

女爷i 2022-09-12 14:58 180阅读 0赞

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0hhYVNUZWNo_size_16_color_FFFFFF_t_70][]

本文以在Ubuntu x86\_64系统上编译设备端C语言SDK为例，介绍设备上云的配置和开发过程。

## 前提条件 ##

在进行本示例配置前，您需要完成以下准备工作：

*  注册阿里云账号，并完成实名认证。
 *  开通物联网平台。关于物联网平台介绍，参见[物联网平台产品详情页][Link 1]。
 *  Ubuntu x86\_64开发环境（PC或服务器）。
 *  下载[设备端C SDK Demo][C SDK Demo]。

## 背景信息 ##

阿里云物联网平台官方发布的设备端C语言版本SDK可以直接运行于Linux系统，并通过MQTT协议接入物联网平台。

## 创建产品和设备 ##

在物联网平台注册产品和设备后，获取设备证书信息（ProductKey、DeviceName和DeviceSecret）。设备证书信息需配置到设备端SDK中。当设备请求连接物联网平台时，物联网平台会根据设备证书信息进行设备身份验证。

1.  [登录物联网平台控制台][Link 2]。
2.  创建产品。
    
    1.  在左侧导航栏，选择设备管理>产品。
    2.  在产品管理页，单击创建产品。
    3.  填入产品信息，单击确定。完成产品创建。
        
        ![新建产品][3d7a86ca3754756c127bb4bd4fb0c847.png]
3.  创建设备。
    
    1.  在左侧导航栏，选择设备。
    2.  在设备管理页，单击添加设备。
    3.  选择刚创建的产品，输入设备名称和备注名称，单击确定。完成设备创建。
        
        设备创建成功后，会弹出设备证书信息。您也可以在设备管理页，单击设备对应的查看按钮，进入设备详情页查看设备证书信息。

## 定义物模型 ##

物模型指将物理空间中的实体进行数字化，并在云端构建该实体的数据模型。在物联网平台中，定义物模型即定义产品功能（包括属性、事件、服务）。完成功能定义后，系统将自动生成该产品的物模型。

1.  编辑物模型。
    
    物联网平台提供的设备端C SDK Demo包中，包含一个完整的物模型JSON文件。本示例中，将该JSON文件导入为已创建产品的物模型。
    
    1.  [下载C SDK Demo包中的物模型JSON文件][C SDK Demo]。
    2.  解压Demo包后，打开src/dev\_model/examples目录下的model\_for\_examples.json文件。
        
        ![打开json文件][json]
    3.  将物模型JSON文件中的productKey的值替换为您在物联网平台上创建的产品ProductKey。
        
        ![替换ProductKey值][ProductKey]
        
        **说明** C SDK Demo包中的物模型JSON文件中，productKey对应的值只是一个示例代码，您需将其替换为您的产品ProductKey。
    4.  保存文件。
2.  导入物模型。
    
    将已经编辑好的物模型文件导入为产品的物模型。
    
    1.  在物联网平台控制台的左侧导航栏，选择设备管理>产品。
    2.  在产品管理页，找到之前创建的产品，单击对应的查看按钮。
    3.  在产品详情页功能定义页签下，单击导入物模型。
    4.  在弹出的对话框中，单击 上传文件，上传上一步中编辑好的物模型JSON文件，单击确定。
        
        ![导入物模型][08804fc854feae5917af1b5567d124a1.png]
    
    导入成功后，该文件定义的所有功能将显示在自定义功能列表中。
    
    ![自定义功能列表][784176e7b07473c68bae9987bd29e16e.png]

## 配置C版本SDK ##

在开发工具中，导入Demo，并修改配置文件中的信息为您的设备信息。配置成功后，设备接入物联网平台。

1.  配置设备证书信息。
    
    在SDK Demo中wrappers/os/ubuntu目录下的HAL\_OS\_linux.c文件中，修改设备证书信息为您的设备证书信息。
    
    ![修改设备证书信息][0671d5c14407522f1430f7359bcf4c08.png]
2.  编译SDK。
    
    在SDK根目录中，执行`make reconfig`，并选择3，然后make。
    
    ![编译SDK][SDK]
3.  运行测试。
    
    在SDK根目录中，执行`./output/release/bin/linkkit-example-solo`。执行结果如下图。
    
    ![测试运行][1efda3c2350c04663be3e99696a29653.png]
    
    SDK运行成功后，可在物联网平台控制台上设备对应的设备详情页，查看设备状态和设备上报的物模型数据。
    
    ![查看设备状态和物模型数据][ef74479e0f9f94ca2b3d90dbb8d6dfbb.png]
    
    **说明** 您可以在物联网平台控制台上监控运维>日志服务页，搜索和查看设备日志。
    
    ![搜索和查看设备日志][294856017aa119963cd3cec7f80e17ee.png]

## 名词解释 ##

*  **设备端SDK**
    
    阿里云物联网平台提供的Link Kit SDK即设备端SDK，用于设备端开发。设备需要支持TCP/IP协议栈才能集成Link Kit SDK。设备厂商将设备端SDK集成到设备上，设备便可通过该SDK安全地接入到阿里云物联网平台。目前，物联网平台提供六种设备端SDK：C SDK、Java SDK、Python SDK、Node.js SDK、Android SDK和iOS SDK。本示例使用的是C SDK。
    
    设备端SDK下载和使用说明，参见[设备接入Link Kit SDK][Link Kit SDK]。
 *  **设备证书**
    
    设备证书指ProductKey、DeviceName和DeviceSecret，是阿里云物联网平台认证设备的标识。设备证书信息不可泄露。
 *  **ProductKey**
    
    物联网平台为产品颁发的全局唯一标识。
 *  **DeviceName**
    
    在注册设备时，自定义的或系统自动生成的设备名称，具备产品维度内的唯一性。
 *  **DeviceSecret**
    
    物联网平台为设备颁发的设备密钥。

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0hhYVNUZWNo_size_16_color_FFFFFF_t_70]: /images/20220828/0c372c486c564972920870aaa1dae444.png
[Link 1]: https://www.aliyun.com/product/iot
[C SDK Demo]: https://code.aliyun.com/linkkit/c-sdk/repository/archive.zip?ref=v3.0.1
[Link 2]: https://iot.console.aliyun.com/
[3d7a86ca3754756c127bb4bd4fb0c847.png]: /images/20220828/8dc44086847b4e67bc0b1a895c513aec.png
[json]: /images/20220828/372bdfd0427043bfbdd2fda39b098014.png
[ProductKey]: /images/20220828/fe32a5a587c64fd8bb014a571e244940.png
[08804fc854feae5917af1b5567d124a1.png]: /images/20220828/06f118435ccc41829c2c8cc525788833.png
[784176e7b07473c68bae9987bd29e16e.png]: /images/20220828/71d849fad6244d4e9858169dc333dc94.png
[0671d5c14407522f1430f7359bcf4c08.png]: /images/20220828/def24955b07a48879cacdc0521f4783c.png
[SDK]: /images/20220828/41e65494dfaa41ad9f3e74c4538779f8.png
[1efda3c2350c04663be3e99696a29653.png]: /images/20220828/6a8e832f91b2479cb1018ed47af07140.png
[ef74479e0f9f94ca2b3d90dbb8d6dfbb.png]: /images/20220828/54a8d042e3f34b91810da0a6af9b1d1b.png
[294856017aa119963cd3cec7f80e17ee.png]: /images/20220828/920fe9de4a1147fcbd62eee2983bf586.png
[Link Kit SDK]: https://help.aliyun.com/product/93051.html