AliOS Things从1.2.0版本开始支持蓝牙协议栈(BLE)，及基于蓝牙协议栈的应用层开发框架。本文分为三部分对蓝牙组件进行介绍：
- 蓝牙组件
- 蓝牙协议栈介绍及接口说明
- 应用开发框架介绍及示例说明
蓝牙组件
AliOS Things v1.2.0支持蓝牙4.2，提供完整的host端低功耗蓝牙协议栈支持。主要包括三部分内容：协议层API，蓝牙协议栈，HCI (Host Controller Interface)驱动接口。当开发者拿到一个全新平台的时候，需要完成HCI接口与AliOS Things提供的蓝牙协议栈的对接。目前，AliOS Things已经完成在乐鑫ESP32上面蓝牙协议栈部分的对接，开发者可以直接基于协议层API进行上层应用开发。
从应用开发者的角度，BLE应用开发过程中，经常会遇到的烦恼是蓝牙协议栈概念及细节的理解。为了解决应用业务开发者的烦恼，AliOS-Things设计与开发了BLE应用开发框架。期望开发者在使用了我们的应用开发框架后，能够极简的进行业务逻辑开发，再也不用纠缠于BLE协议栈概念及细节。
综上，AliOS Things蓝牙组件总体结构如下图所示。
蓝牙协议栈及接口
AliOS Things v1.2.0支持低功耗蓝牙主要包括以下功能：
- Generic Access Profile (GAP)
- Generic Attribute Profile (GATT)
- 清晰的HCI驱动层抽象
主要提供以下接口：
- GAP
- GATT
- Logical Link Control and Adaptation Protocol (L2CAP)
- HCI驱动
蓝牙协议栈在快速迭代中，后续会开发更多功能及接口。
应用开发框架及接口
AliOS Things BLE应用开发框架主要针对GATT Server，即peripheral，主要完成以下功能：
- 维护开发者添加的属性和特性
- GATT (Generic Attribute Profile)相关读，写，通知，指示和连接
通过实现上述两项功能，为开发者提供清晰简单的应用开发接口，接口主要包括以下功能：
- 创建外设应用开发框架对象
- 创建和添加属性到BLE协议栈，即GATT
- 广播Attribute
- 回复和更新Central设备的请求和订阅信息
我们已经在庆科mk3239上支持了创建外设应用框架对象接口，发布添加属性接口，广播接口。开发者可以在创建了外设应用开发框架对象后，借助于接口轻松添加属性，完成服务的广播，连接的建立和信息的更新。我们正在丰富上述接口功能并提供全部功能，并将已经在mk3239上支持的应用开发能力做到与平台无关，让使用其他蓝牙芯片的开发者也能够享受到极简开发的快乐。
AliOS Things应用层规范接口的定义，可以在framework/bluetooth/ble_app_framework/ble_app_framework.h文件中找到。下面对应用层接口作一些说明：
ble_peripheral_init
- 接口定义：
peripheral_hdl_t ble_peripheral_init(
peripheral_init_t *p,
ble_peripheral_conn_cb_t c,
ble_peripheral_disconn_cb_t disc,
const uint8_t *gatt_db,
int db_len);- 接口说明：
该函数用于初始化peripheral设备服务，包括协议栈初始化、设备初始化、GATT属性数据库初始化。设备初始化相关的参数由参数p指定，GATT属性数据库由参数gatt_db和db_len指定。参数c和disc分别指定有客户端设备连接时和断开连接时的回调函数。该函数返回值是对应peripheral设备的handle，handle可以用于标识peripheral设备及其属性。
ble_peripheral_deinit
- 接口定义：
void ble_peripheral_deinit(peripheral_hdl_t hdl); - 接口说明：
该接口是接口ble_peripheral_init的反向操作，用于注销peripheral设备初始化和协议栈初始化等操作。
ble_adv_start
- 接口定义：
void ble_adv_start(
ble_adv_complete_cb_t adv_handler,
const char *manufacture,
peripheral_hdl_t hdl);- 接口说明：
该接口用于启动广播。参数adv_handler指定广播结束时的回调函数，参数manufacture指定设备的厂商名信息。广播的信息（服务、属性等）在初始化函数的GATT数据库中设定。
ble_adv_stop
-
接口定义：
void ble_adv_stop(); - 接口说明：
该接口停止广播。
ble_attr_add
- 接口定义：
ble_gatt_attr_t *ble_attr_add(
uint16_t hdl,
uint16_t val_len,
const uint8_t *val);- 接口说明：
该接口用于添加peripheral设备属性值。参数hdl指定属性句柄，val指定属性值，val_len指定属性值的长度（以字节为单位）。该函数返回值为一个ble_gatt_attr_t类型的结构体，用于后续对该属性的操作。
ble_attr_indicate
- 接口定义：
void ble_attr_indicate(
ble_gatt_attr_t *attr,
peripheral_hdl_t hdl,
uint16_t len,
const uint8_t *data);- 接口说明：
该接口用于向客户端设备发送指示（indication）。参数attr表明指示对应的属性，hdl表明peripheral设备对应的handle，data指定需要指示的数据，len指定数据长度。
ble_attr_notify
- 接口定义：
void ble_attr_notify(
ble_gatt_attr_t *attr,
peripheral_hdl_t hdl,
uint16_t len,
const uint8_t *data);- 接口说明：
该函数功能与ble_attr_indicate类似，区别在于发送通知（notification）。
基于BLE应用框架的示例说明
AliOS Things目前提供了2个BLE示例sample，位于目录example/bluetooth/目录中。这2个sample均基于BLE应用框架和接口。下面对这2个sample作一些说明。
ble_advertisements
该示例sample展示了如何开发基于BLE应用框架和接口的应用。
第一步，初始化peripheral设备。
peripheral_init_t p = {BLE_DEVICE_NAME, 0, 1};
hdl = ble_peripheral_init(&p, connection_handler, disconnection_handler,
adv_gatt_db, sizeof(adv_gatt_db));
peripheral_init_t中指定了设备名、最大连接数等信息。GATT数据库在adv_gatt_db中指定，包含了GATT服务、GAP服务、设备信息服务及他们的属性。
第二步，发布广播。广播的内容包括厂商名、第一步中指定的设备信息服务等。
ble_adv_start(adv_complete_cb, MANUFACURE_NAME, hdl);
ble_show_system_time
该示例程序是另外一个简单的基于BLE应用框架和接口的sample。该示例在上一个示例的基础上，增加了一个用户自定义服务（TIME Service），并为该服务添加了一个属性值，用于显示系统启动时长。
下面的代码展示了该示例程序的主要流程：
static void indicate_handler(void *arg)
{
struct indicate_arg_s *ind = (struct indicate_arg_s *)arg;
long long time = aos_now_ms();
ble_attr_indicate(ind->attr, ind->hdl, sizeof(time), (uint8_t *)&time);
aos_post_delayed_action(1000, indicate_handler, arg);
}
int application_start( void )
{
peripheral_hdl_t hdl;
ble_gatt_attr_t *attr;
struct indicate_arg_s ind_arg;
peripheral_init_t p = {BLE_DEVICE_NAME, 0, 1};
hdl = ble_peripheral_init(&p, connection_handler, disconnection_handler,
adv_gatt_db, sizeof(adv_gatt_db));
ble_adv_start(adv_complete_cb, MANUFACURE_NAME, hdl);
attr = ble_attr_add(HDLC_TIME_OUT_VALUE, 0, NULL);
ind_arg.hdl = hdl;
ind_arg.attr = attr;
aos_post_delayed_action(1000, indicate_handler, &ind_arg);
aos_loop_run();
return 0;
}
第一步，初始化peripheral设备。
第二步，启动广播。
第三步，添加时间属性的值。
第四步，每隔1s发送一次指示，该指示包含系统启动时长信息。
小结
目前，AliOS Things蓝牙组件提供了一些最基础的功能模块，开发者可以基于现有功能直接基于AliOS Things进行蓝牙开发。后续，我们会随着AliOS Things快速迭代，持续更新，主要包括：
- 升级到蓝牙5.0
- 支持更加丰富的应用开发示例和接口
- 支持SIG BLE mesh
- AliOS Things uMesh支持蓝牙
- 支持更多的平台运行AliOS Things蓝牙协议栈
更多关于AliOS Things及蓝牙组件信息，请戳https://github.com/alibaba/AliOS-Things。
