简介
蓝牙服务组件为设备提供接入与使用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);