鸿蒙开发实战：【蓝牙组件】

简介

蓝牙服务组件为设备提供接入与使用Bluetooth的相关接口，包括BLE设备gatt相关的操作，以及BLE广播、扫描等功能。

目录

/foundation/communication/bluetooth
├── interfaces                               # 接口代码
│    └── innerkits                           # 系统服务接口存放目录
│        ├── native_c                        # C接口存放目录
│        │   └── include                     # C接口定义目录
│        └── native_cpp                      # C++接口存放目录
│── sa_profile                               # 蓝牙服务定义目录
│── services                                 # 蓝牙服务代码目录
└── LICENSE                                  # 版权声明文件

约束

蓝牙服务组件使用C语言编写。

说明

现在提供的是BLE相关接口及GAP基本开关蓝牙的接口，其它接口暂不提供。

标准系统使用说明

标准系统提供C接口定义及服务和协议栈的代码，目前提供的只有BLE相关的接口，包括BLE设备gatt相关的操作，以及BLE广播、扫描等功能，其它A2DP，AVRCP，HFP等相关接口在后续增量发布。

标准系统使用目录如下：

轻量或小型系统使用说明

轻量或小型系统只提供C接口定义，目前只有BLE相关接口，包括BLE设备gatt相关的操作，以及BLE广播、扫描等功能，其它A2DP，AVRCP，HFP等相关接口在后续增量发布。

轻量或小型系统使用目录如下：

interfaces/innerkits/native_c/include

C接口使用说明

• 打开/关闭蓝牙：

/* 打开传统蓝牙 */
bool EnableBt(void);
/* 关闭传统蓝牙 */
bool DisableBt(void);
/* 打开低功耗蓝牙 */
bool EnableBle(void);
/* 关闭低功耗蓝牙 */
bool DisableBle(void);

• 获取蓝牙状态

/* 获取传统蓝牙状态 */
int GetBtState();
/* 判断低功耗蓝牙状态 */
bool IsBleEnabled();

• 获取本端Mac地址

/* 获取mac地址 */
bool GetLocalAddr(unsigned char *mac, unsigned int len);

• 设置本端设备名称

/* 设置本端设备名称 */
bool SetLocalName(unsigned char *localName, unsigned char length);

• 设备需要完成以下接口的开发步骤，以使能Gatt server功能并开启服务：

/* 初始化蓝牙协议栈 */
int InitBtStack(void);
int EnableBtStack(void);
/* 注册应用，appUuid由应用提供  */
int BleGattsRegister(BtUuid appUuid);
/* 添加服务 */
int BleGattsAddService(int serverId, BtUuid srvcUuid, bool isPrimary, int number);
/* 添加特征值 */
int BleGattsAddCharacteristic(int serverId, int srvcHandle, BtUuid characUuid, int properties, int permissions);
/* 添加描述符 */
int BleGattsAddDescriptor(int serverId, int srvcHandle, BtUuid descUuid, int permissions);
/* 开始服务 */
int BleGattsStartService(int serverId, int srvcHandle);

• 设备需要完成以下接口的开发步骤，以使能BLE广播的发送：

/* 设置广播数据 */
int BleSetAdvData(int advId, const BleConfigAdvData *data);
/* 开始发送广播 */
int BleStartAdv(int advId, const BleAdvParams *param);

• 若需要扫描功能，设备需要完成以下接口的开发步骤，以使能BLE扫描功能：

/* 设置扫描参数 */
int BleSetScanParameters(int clientId, BleScanParams *param);
/* 开始扫描 */
int BleStartScan(void);

审核编辑 黄宇