開放、平等、協(xié)作、快速、分享
點擊登錄控制臺打開SDK定制頁面,根據產品需要進行相應SDK功能選擇,點擊按鈕 “開始生成” 下載SDK,如下圖所示:說明 :
4.x 版本SDK的API接口與3.x/2.x 分支的API不兼容,使用3.x/2.x分支開發(fā)產品的客戶請繼續(xù)使用3.x/2.x分支進行產品開發(fā)
4.x目前尚未支持阿里云物聯(lián)網平臺提供的所有功能,在使用4.x分支開發(fā)產品前請查看功能是否滿足產品要求
支持通過設備預置密鑰的方式對設備進行認證,并支持動態(tài)注冊 支持通過ID2對設備進行認證 支持X.509對設備進行認證 包含對以下OS的適配: Linux FreeRTOS POSIX機制兼容的OS FreeRTOS 若設備使用的OS不支持上述OS,開發(fā)者需要對OS進行適配 客戶可以通過編寫makefile通過GNU Make來編譯代碼 客戶也可以通過編寫cmake來編譯SDK 對于集成IDE開發(fā)環(huán)境(比如Eclipse),客戶可以將SDK的代碼文件添加到IDE中進行編譯 ChangeLog.md 其中包含SDK中各個功能模塊的更新時間 components 根據客戶的選擇,在該目錄下會出現(xiàn)各種子模塊的目錄 core SDK的核心代碼文件 demos 存放各種功能的示例代碼 external 當需要使用TLS功能時,SDK使用了第三方的mbedtls,客戶可以使用其它的TLS庫來替換mbedtls portfiles SDK運行時與TCP/IP協(xié)議棧、與TLS庫的集成實現(xiàn) 客戶在移植SDK的時候,demos目錄可以不用加入編譯系統(tǒng),將其它目錄下面的代碼文件加入編譯系統(tǒng)進行編譯即可。 若SDK并未提供對指定系統(tǒng)下TCP/IP協(xié)議棧、TLS庫的移植,客戶需要自行實現(xiàn)portfiles下相關函數的移植。 SDK頭文件包含 然后再根據選擇的功能查看相應模塊編程手冊中指定包含的頭文件即可。比如如果設備使用MQTT協(xié)議與物聯(lián)網平臺通信,那么可以打開文檔“MQTT接入與數據通信”,該文檔中會明確說明需要包含頭文件SDK功能列表
目前SDK支持的功能如下表所示:功能模塊 功能說明 MQTT連云 設備可以通過MQTT連接阿里云物聯(lián)網平臺,并使用MQTT Topic進行設備與云端之間的數據收發(fā) HTTP連云 設備可以通過HTTP連接阿里云物聯(lián)網平臺,并上傳設備數據。注意:本種協(xié)議連接方式不支持物聯(lián)網平臺主動向設備發(fā)送數據。 設備認證 OS適配 物模型 使用屬性、事件、服務來對設備進行建模,云端APP開發(fā)時基于物模型對設備進行管理,而無需關心設備與物聯(lián)網平臺之間的數據交互格式 OTA 設備固件升級。 SDK只進行固件的獲取,開發(fā)者需要實現(xiàn)將固件寫入Flash/ROM中讓固件生效 時間同步 讓設備通過SDK獲取當前物聯(lián)網平臺的時間 RRPC 支持云端應用對設備的遠程同步調用 設備連接異常告警 當連接延時較大、或者丟包時進行報警 日志上報 提供日志實時上傳功能 設備引導服務 設備啟動時動態(tài)決定連接服務站點的能力,設備全球化部署時使用 SDK編譯說明
SDK以源文件方式進行輸出,客戶可以使用自己喜歡的方式編譯SDK,比如:
當用戶從阿里云物聯(lián)網平臺下載SDK之后,SDK的目錄結構如下所示:$ 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
其中:#include "aiot_state_api.h" #include "aiot_sysdep_api.h"
aiot_mqtt_api.h,
用戶在程序中加入相應的頭文件包含即可。