OSCHINA-MIRROR/openharmony-communication

Bluetooth

Введение
Структура каталогов
Ограничения
Использование
- Стандартная система
- Мини или малая система
- C API

Введение

Модуль Bluetooth предоставляет API для доступа и использования сервисов Bluetooth, таких как API для операций Generic Attribute Profile (GATT), Bluetooth Low Energy (BLE) рекламы и сканирования.

Структура каталогов

/foundation/communication/bluetooth
├── interfaces                              # API код
│   └── innerkits                           # Системные сервисные API
│       ├── native_c                        # C API
│       │   └── include                     # Заголовочные файлы для C API
│       └── native_cpp                      # C++ API
├── sa_profile                              # Профиль способности сервиса
└── services                                # Код сервиса Bluetooth
└── LICENSE                                  # Файл декларации лицензии

Ограничения

Модуль Bluetooth должен быть скомпилирован на языке C.

Использование

Предоставляются только связанные с BLE API и основные API Bluetooth Generic Access Profile (GAP).

Стандартная система

Для стандартной системы предоставляется определение C API, а также код стека службы и протокола. В настоящее время предоставляются только связанные с BLE API, включая API для операций GATT на устройствах BLE, BLE рекламы и сканирования. Другие API, такие как API, связанные с A2DP, AVRCP и HFP, будут постепенно предоставляться позже.

Каталоги для стандартной системы:

interfaces/

sa_profile/

services/

Мини или малая система

Только C API для BLE, такие как API для операций GATT, BLE рекламы и сканирования, предоставляются для мини и малых систем. Другие API, такие как API, связанные с A2DP, AVRCP и HFP, будут постепенно предоставляться позже.

Каталог для мини или стандартной системы:

interfaces/innerkits/native_c/include

C API

Включение или отключение Bluetooth.

/* Включить классический Bluetooth.*/
bool EnableBt(void);
/* Отключить классический Bluetooth. */
bool DisableBt(void);
/* Включить BLE. */
bool EnableBle(void);
/* Отключить BLE. */
bool DisableBle(void);

Получение статуса Bluetooth.

/* Получить статус классического Bluetooth. */
int GetBtState();
/* Проверить, включён ли BLE. */
bool IsBleEnabled();

Получение локального MAC-адреса.

/* Получить MAC-адрес. */
bool GetLocalAddr(unsigned char *mac, unsigned int len);

Установка имени локального устройства.

/* Установить имя локального устройства.*/
bool SetLocalName(unsigned char *localName, unsigned char length);

Включение функции сервера GATT и запуск службы GATT.

/* Инициализировать стек протокола Bluetooth. */
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);
/* Запустить службу GATT. */
int BleGattsStartService(int serverId, int srvcHandle);

Включение рекламы BLE.