文章分享

開放、平等、協(xié)作、快速、分享

當(dāng)前位置:首頁>文章分享

SDK獲取及使用說明

摘錄:HCTech 無錫和控電子   時間:2020-08-07   訪問量:3384

點擊登錄控制臺打開SDK定制頁面,根據(jù)產(chǎn)品需要進(jìn)行相應(yīng)SDK功能選擇,點擊按鈕 “開始生成” 下載SDK,如下圖所示:文檔與工具說明 :

SDK功能列表

目前SDK支持的功能如下表所示:

功能模塊功能說明
MQTT連云設(shè)備可以通過MQTT連接阿里云物聯(lián)網(wǎng)平臺,并使用MQTT Topic進(jìn)行設(shè)備與云端之間的數(shù)據(jù)收發(fā)
HTTP連云設(shè)備可以通過HTTP連接阿里云物聯(lián)網(wǎng)平臺,并上傳設(shè)備數(shù)據(jù)。注意:本種協(xié)議連接方式不支持物聯(lián)網(wǎng)平臺主動向設(shè)備發(fā)送數(shù)據(jù)。
設(shè)備認(rèn)證
  • 支持通過設(shè)備預(yù)置密鑰的方式對設(shè)備進(jìn)行認(rèn)證,并支持動態(tài)注冊

  • 支持通過ID2對設(shè)備進(jìn)行認(rèn)證

  • 支持X.509對設(shè)備進(jìn)行認(rèn)證

OS適配

包含對以下OS的適配:

  1. Linux

  2. FreeRTOS

  3. POSIX機(jī)制兼容的OS

  4. FreeRTOS

若設(shè)備使用的OS不支持上述OS,開發(fā)者需要對OS進(jìn)行適配

物模型使用屬性、事件、服務(wù)來對設(shè)備進(jìn)行建模,云端APP開發(fā)時基于物模型對設(shè)備進(jìn)行管理,而無需關(guān)心設(shè)備與物聯(lián)網(wǎng)平臺之間的數(shù)據(jù)交互格式
OTA設(shè)備固件升級。 SDK只進(jìn)行固件的獲取,開發(fā)者需要實現(xiàn)將固件寫入Flash/ROM中讓固件生效
時間同步讓設(shè)備通過SDK獲取當(dāng)前物聯(lián)網(wǎng)平臺的時間
RRPC支持云端應(yīng)用對設(shè)備的遠(yuǎn)程同步調(diào)用
設(shè)備連接異常告警當(dāng)連接延時較大、或者丟包時進(jìn)行報警
日志上報提供日志實時上傳功能
設(shè)備引導(dǎo)服務(wù)設(shè)備啟動時動態(tài)決定連接服務(wù)站點的能力,設(shè)備全球化部署時使用

SDK編譯說明

SDK以源文件方式進(jìn)行輸出,客戶可以使用自己喜歡的方式編譯SDK,比如:
  • 客戶可以通過編寫makefile通過GNU Make來編譯代碼

  • 客戶也可以通過編寫cmake來編譯SDK

  • 對于集成IDE開發(fā)環(huán)境(比如Eclipse),客戶可以將SDK的代碼文件添加到IDE中進(jìn)行編譯

當(dāng)用戶從阿里云物聯(lián)網(wǎng)平臺下載SDK之后,SDK的目錄結(jié)構(gòu)如下所示:
$ ls -l total 20 -rwxrwxrwx 1 root root 1067  4月 26 14:14 ChangeLog.md drwxrwxrwx 1 root root 4096  4月 26 14:14 components drwxrwxrwx 1 root root 4096  4月 26 14:14 core drwxrwxrwx 1 root root 4096  4月 26 14:14 demos drwxrwxrwx 1 root root    0  4月 26 14:38 external -rwxrwxrwx 1 root root 1026  4月 26 14:14 Makefile drwxrwxrwx 1 root root    0  4月 26 14:14 portfiles
其中:
  • ChangeLog.md

    其中包含SDK中各個功能模塊的更新時間

  • components

    根據(jù)客戶的選擇,在該目錄下會出現(xiàn)各種子模塊的目錄

  • core

    SDK的核心代碼文件

  • demos

    存放各種功能的示例代碼

  • external

    當(dāng)需要使用TLS功能時,SDK使用了第三方的mbedtls,客戶可以使用其它的TLS庫來替換mbedtls

  • portfiles

    SDK運行時與TCP/IP協(xié)議棧、與TLS庫的集成實現(xiàn)

客戶在移植SDK的時候,demos目錄可以不用加入編譯系統(tǒng),將其它目錄下面的代碼文件加入編譯系統(tǒng)進(jìn)行編譯即可。

若SDK并未提供對指定系統(tǒng)下TCP/IP協(xié)議棧、TLS庫的移植,客戶需要自行實現(xiàn)portfiles下相關(guān)函數(shù)的移植。

SDK頭文件包含

用戶對SDK進(jìn)行初始化的可以參見LinkSDK/demos下面的示例文件,總的來說,用戶的程序首先需要包含頭文件:
#include "aiot_state_api.h" #include "aiot_sysdep_api.h"

然后再根據(jù)選擇的功能查看相應(yīng)模塊編程手冊中指定包含的頭文件即可。比如如果設(shè)備使用MQTT協(xié)議與物聯(lián)網(wǎng)平臺通信,那么可以打開文檔“MQTT接入與數(shù)據(jù)通信”,該文檔中會明確說明需要包含頭文件aiot_mqtt_api.h,用戶在程序中加入相應(yīng)的頭文件包含即可。


上一篇:Paho-MQTT C接入示例(阿里云)

下一篇:SSL與TLS有什么區(qū)別(最全面的知識點都在這)

在線咨詢

點擊這里給我發(fā)消息 售前咨詢專員

點擊這里給我發(fā)消息 售后服務(wù)專員

在線咨詢

免費通話

24小時免費咨詢

請輸入您的聯(lián)系電話,座機(jī)請加區(qū)號

免費通話

微信掃一掃

微信聯(lián)系
返回頂部