LISA Bluetooth 组件
===================
简介
----
LISA Bluetooth 是一个蓝牙初始化和管理组件，封装了 BLE 协议栈的初始化流程，提供统一的 API 接口，支持自定义广播数据、扫描响应数据以及 GAP 配置。
主要特性
--------
- **统一初始化**：提供 ``lisa_bluetooth_init()`` 接口，简化协议栈启动流程。
- **自定义广播数据**：支持通过弱符号覆盖机制自定义广播数据。
- **自定义扫描响应**：支持通过弱符号覆盖机制自定义扫描响应数据。
- **自定义 GAP 配置**：支持自定义 MAC 地址、设备名称等 GAP 参数。
- **广播控制**：提供简单的广播开启和停止接口。
API 参考
--------
核心函数
~~~~~~~~
.. c:function:: int lisa_bluetooth_init(void)
初始化蓝牙协议栈。
:return: 0 成功，非 0 失败。
.. c:function:: uint8_t app_ble_adv_start(uint8_t adv_id, uint8_t adv_type)
开启 BLE 广播。
:param adv_id: 广播 ID。
:param adv_type: 广播类型 (参考 ``enum app_adv_type``)。
:return: 状态码。
.. c:function:: uint8_t app_ble_adv_stop(uint8_t adv_id)
停止 BLE 广播。
:param adv_id: 广播 ID。
:return: 状态码。
自定义接口 (Weak Symbols)
~~~~~~~~~~~~~~~~~~~~~~~~~
用户可以在应用程序中实现以下函数来覆盖默认行为。
.. c:function:: const uint8_t* lisa_bt_get_adv_data(uint8_t *len)
获取自定义广播数据。
:param len: [输出] 数据长度指针。
:return: 指向广播数据的指针。
.. c:function:: const uint8_t* lisa_bt_get_scan_rsp_data(uint8_t *len)
获取自定义扫描响应数据。
:param len: [输出] 数据长度指针。
:return: 指向扫描响应数据的指针。
.. c:function:: void lisa_bt_gap_config(ble_gap_cfg_t *cfg)
配置 GAP 参数（如 MAC 地址、设备名称）。
:param cfg: [输入/输出] GAP 配置结构体指针。
使用示例
--------
自定义广播数据和 GAP 配置
~~~~~~~~~~~~~~~~~~~~~~~~~
.. code-block:: c
#include "lisa_bluetooth.h"
#include "bt_app_if.h"
#include <string.h>
// 自定义广播数据
static const uint8_t user_adv_data[] = {
0x02, 0x01, 0x06, // Flags
0x09, 0x09, 'M', 'Y', '_', 'B', 'L', 'E', // Local Name
};
const uint8_t* lisa_bt_get_adv_data(uint8_t *len)
{
*len = sizeof(user_adv_data);
return user_adv_data;
}
// 自定义 GAP 配置
void lisa_bt_gap_config(ble_gap_cfg_t *cfg)
{
// 设置自定义 MAC 地址
uint8_t mac[6] = {0x11, 0x22, 0x33, 0x44, 0x55, 0x66};
memcpy(cfg->addr.addr, mac, 6);
// 设置设备名称
const char *name = "MY_DEVICE";
cfg->name_len = strlen(name);
if (cfg->name_len > sizeof(cfg->name)) {
cfg->name_len = sizeof(cfg->name);
}
memcpy(cfg->name, name, cfg->name_len);
}
int main(void)
{
// 初始化蓝牙
lisa_bluetooth_init();
// 开启广播
app_ble_adv_start(0, BLE_ADV_GEN);
// ...
}
