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
停止藍牙配網服務。
參數
無
返回值
無