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/qcloud_iot_import.h	这个头文件中列出为SDK适配新硬件平台时, 需要实现的平台抽象层函数, 以HAL_*()的方式命名; 编写平台抽象层实现时, 包含此头文件即可
include/qcloud_iot_export.h	这个头文件中列出SDK能提供的所有用户级别API, 以IOT_*()的方式命名, 也就是供用户调用编写业务应用程序的函数
include/exports/qcloud_iot_export_*.h	这组头文件按功能模块分列各模块提供的用户级别API, 例如qcloud_iot_export_mqtt.h中定义了MQTT的通信接口 可直接忽略该文件
lib/lib*.a	编译出的iotsdk iot平台sdk（由硬件抽象层编译得来），mbedtls相关库用于加密通信
src/makefile	示例用makefile, 演示得到lib/lib*.a之后, 如何在SDK之外链接它使用起来