簡介

藍牙服務組件為設備提供接入與使用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);

審核編輯 黃宇