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

停止蓝牙配网服务。

参数

返回值