SDK使用

设备端SDK的使用

对设备端SDK的使用分为如下几步:

• 修改编译配置进行编译, 详见设备端SDK的编译页面
• 获取编译好的SDK, 如成功存放在output/release/lib/*.a
• 将libiot_sdk.a libiot_platform.a等配合output/release/include/目录下的头文件, 加入您自己的工程使用

SDK编译产物说明

output/release/
+-- bin
+-- include
|   +-- exports
|   |   +-- qcloud_iot_export_err.h
|   |   +-- qcloud_iot_export_log.h
|   |   +-- qcloud_iot_export_mqtt.h
|   |   +-- qcloud_iot_export_shadow.h
|   +-- qcloud_iot_export.h
|   +-- qcloud_iot_import.h
+-- lib
|   +-- libiot_sdk.a
|   +-- libiot_platform.a
|   +-- libmbedcrypto.a
|   +-- libmbedtls.a
|   +-- libmbedx509.a
+-- src
    +-- makefile
    +-- mqtt-example.c

概要说明如下:

|文件 |说明| |include/iot_import.h |这个头文件中列出为SDK适配新硬件平台时, 需要实现的平台抽象层函数, 以HAL_()的方式命名; 编写平台抽象层实现时, 包含此头文件即可| |include/imports/iot_import_.h |这组头文件按功能模块分列各模块依赖的平台抽象层函数, 例如iot_import_coap.h中列出用CoAP协议通信需要实现的那些, 若不使用CoAP, 可直接忽略该文件| |include/iot_export.h |这个头文件中列出SDK能提供的所有用户级别API, 以IOT_()的方式命名, 也就是供用户调用编写业务应用程序的函数| |include/exports/iot_export_.h |这组头文件按功能模块分列各模块提供的用户级别API, 例如iot_export_coap.h中列出用CoAP协议通信时可用的那些, 若不使用CoAP, 可直接忽略该文件| |lib/libiot_sdk.a |这个二进制的压缩库文件就是编译好的所谓**"物联网套件设备端SDK"**, 它配合上面的include/iot_export.h文件, 分别提供API的接口实现和接口声明, 供用户link到自己的业务应用程序中| |src/Makefile |示例用Makefile, 演示得到lib/libiot_sdk.a之后, 如何在SDK之外链接它使用起来|