Breeze協議提供基于藍牙鏈路連接阿里云IoT的安全通道和服務,并且提供藍牙輔助配網功能(通過BLE鏈路獲取AP的SSID和password)。基本SDK API在breeze_export.h中,藍牙配網的接口API在breeze_awss_export.h中。

breeze_start

啟動breeze SDK服務。用戶使用此接口初始化和啟動breeze服務。

參數

名稱 類型 描述
dev_conf device_config 初始化Breeze SDK的信息,包含設備信息,回調函數等。

返回值

0-成功;-1-失敗

breeze_end

停止breeze服務,用戶調用此接口停止breeze服務。

參數

返回值

0-成功;-1-失敗

breeze_post

推送設備端狀態數據至移動端,使用BLE indicate方式。

參數

名稱 類型 描述
buffer uint8_t* 數據指針。
length uint32_t 數據長度,byte數。

返回值

0-成功;其他錯誤值-失敗

breeze_post_fast

和breeze_post類似,推送設備端狀態數據至移動端,區別在于使用BLE notify方式。

參數

名稱 類型 描述
buffer uint8_t* 數據指針。
length uint32_t 數據長度,byte數。

返回值

0-成功;其他錯誤值-失敗

breeze_post_ext

設備端上報帶有cmd字段的數據至移動端。

參數

名稱 類型 描述
buffer uint8_t* 數據指針。
length uint32_t 數據長度,byte數。
cmd uint8_t 推送給移動端的cmd類型。

返回值

0-成功;其他錯誤值-失敗

breeze_append_adv_data

廣播內容增加用戶自定義數據。

參數

名稱 類型 描述
buffer uint8_t* 數據指針。
length uint32_t 數據長度,byte數。

返回值

breeze_restart_advertising

SDK重啟藍牙廣播。

參數

返回值

breeze_awss_init

該接口對藍牙配網SDK進行初始化。在用戶業務邏輯初始化階段調用。

參數

名稱 類型 描述
cb apinfo_ready_cb 為設備完成WiFi信息(SSID、密碼)獲取后的回調函數,由用戶定義/提供,并由SDK完成調用。
info breeze_dev_info_t 為設備信息,包括ProductID,Product Key,Product Secret,Device Name,Device Secret等字段,由用戶提供。

返回值

breeze_awss_end

停止藍牙配網服務。

參數

返回值