1@page linksdk linksdk
2
3[更正文档](https://gitee.com/alios-things/linksdk/edit/master/README.md)      [贡献说明](https://help.aliyun.com/document_detail/302301.html)
4
5# 概述
6
7Link SDK由阿里云提供给设备厂商，由设备厂商集成到设备上后通过该SDK将设备安全地接入到阿里云IoT物联网平台，继而让设备可以被阿里云IoT物联网平台进行管理。设备需要支持TCP/IP协议栈才能集成Link SDK。另外Zigbee、433、KNX这样的非IP设备需要通过网关设备接入到阿里云IoT物联网平台，网关设备需要集成Link SDK。
8
9说明:Link SDK以前名称为Link Kit SDK，现更名为Link SDK。
10
11该组件支持以下功能：
12- MQTT连云
13- HTTP连云
14- 设备认证
15- 物模型
16- 时间同步
17- RRPC
18- 设备连接异常告警
19- 日志上报
20- 设备引导服务
21- 子设备管理
22- 设备诊断
23- OTA(在AliOS THings场景建议使用OS自带OTA)
24
25更多详情，请参考阿里云Link SDK[说明文档](https://help.aliyun.com/document_detail/163755.html?spm=a2c4g.11186623.6.558.38557748p9kUy6) 。
26
27## 版权信息
28> Apache 2.0 License
29
30## 目录结构
31```tree
32.
33├── ChangeLog.md           #变更日志
34├── components
35│   ├── bootstrap          #设备引导服务
36│   ├── data-model         #物模型
37│   ├── devinfo            #设备信息
38│   ├── diag               #设备诊断
39│   ├── dynreg             #基于HTTP动态注册
40│   ├── dynreg-mqtt        #基于MQTT的动态注册
41│   ├── logpost            #日志上报
42│   ├── ntp                #ntp时间
43│   ├── ota                #ota功能
44│   ├── shadow             #设备影子
45│   └── subdev             #子设备
46├── core
47│   ├── aiot_http_api.c    #HTTP核心api实现
48│   ├── aiot_http_api.h    #HTTP对外头文件
49│   ├── aiot_mqtt_api.c    #MQTT核心api实现
50│   ├── aiot_mqtt_api.h    #MQTT对外头文件
51│   ├── aiot_state_api.c   #状态码
52│   ├── aiot_state_api.h   #状态码头文件
53│   ├── aiot_sysdep_api.h  #系统相关头文件
54│   ├── README.md
55│   ├── sysdep             #系统相关实现
56│   └── utils              #工具类接口
57├── external
58│   ├── ali_ca_cert.c      #cert证书
59│   └── README.md
60├── package.yaml           #编译文件
61├── portfiles
62│   ├── aiot_port          #AliOS Things适配层
63│   └── README.md
64└── README.md
65```
66
67## 依赖组件
68
69* osal_aos
70* cjson
71* mbedtls
72
73# 常用配置
74无
75
76# API说明
77
78请参考阿里云Link SDK[编程手册](https://help.aliyun.com/document_detail/163764.html?spm=a2c4g.11186623.6.568.3d00316fqDi9YJ)。
79
80# 使用示例
81solutions中提供了以下demo供用户选择使用：
82- [link_sdk_demo 物模型单品用例](https://g.alicdn.com/alios-things-3.3/doc/linksdk_demo.html)
83- [link_sdk_gateway_demo 物模型网关代理子设备上云用例](https://g.alicdn.com/alios-things-3.3/doc/linksdk_gateway_demo.html)
84
85
86## 添加组件
87默认仅使能能物模型及网关子设备功能。如需编译其他功能，请在package.yaml中包含对应的头文件路径及源码编译路径。如需使能动态注册：
88```yaml
89source_file:
90  - "components/dynreg/*.c"
91
92include:
93  - components/dynreg
94
95```
96# FAQ
97
98常见问题可参考阿里云官网设备接入[常见问题](https://help.aliyun.com/document_detail/96598.html?spm=a2c4g.11186623.6.554.2042557fWpe2Ps)。
99