LBLEPeripheral

LBLEPeripheral 是一個代表在 LinkIt 7697 上面創建 BLE 周邊裝置的單件（Singleton）。開發者可以用這個單件來創造藍牙信標裝置，或是創造可以儲存各種資料特性的周邊裝置。

使用 LBLEPeripheral 可以分成幾個階段：

準備各種服務與資料特性：開發者須先設計好自己的周邊裝置會有哪些服務與資料特性，並將這些服務與資料特性定義為全域變數，如下：

// Define a simple GATT service with only 1 characteristic
LBLEService ledService("19B10010-E8F2-537E-4F6C-D104768A1214");
LBLECharacteristicInt switchCharacteristic("19B10011-E8F2-537E-4F6C-D104768A1214", LBLE_READ | LBLE_WRITE);

設定周邊裝置：需要將資料特性（Characteristic）加入對應的服務（Service）當中，然後將服務加入 LBLEPeripheral 之中：

  // Add characteristics into ledService
  ledService.addAttribute(switchCharacteristic);

  // Add service to GATT server (peripheral)
  LBLEPeripheral.addService(ledService);

  // start the GATT server - it is now 
  // available to connect
  LBLEPeripheral.begin();

接著，透過呼叫 LBLEPeripheral.begin() 啟動周邊裝置
最後，應該呼叫 LBLEPeripheral.advertise() 來進行廣播，這樣周圍的主控裝置才能知道此周邊裝置的存在。

Methods

addService()

begin()

advertise()

advertiseAsBeacon()

stopAdvertise()

notifyAll()

添加新的 GATT 服務。應該在呼叫 begin() 啟動 GATT 之前調用此 API。當 GATT 啟動之後，此 API 不起作用。

Syntax

LBLEPeripheral.addService(service);

Parameters

service: 要加入此周邊裝置的服務。注意的是，此物件會被周邊裝置的內部儲存結構參照，而不是複製一份，所以此物件必須一直處於有效的狀態，不能夠被摧毀。我們會建議，service 物件應該被定義在全域空間。

Returns

none

停止廣播。

Syntax

LBLEPeripheral.stopAdvertise();

Parameters

none

Returns

none

PreviousLBLECentral NextLBLEAdvertisementData

Last updated 3 years ago

// Define a simple GATT service with only 1 characteristic LBLEService ledService("19B10010-E8F2-537E-4F6C-D104768A1214"); LBLECharacteristicInt switchCharacteristic("19B10011-E8F2-537E-4F6C-D104768A1214", LBLE_READ | LBLE_WRITE);

// Add characteristics into ledService ledService.addAttribute(switchCharacteristic); // Add service to GATT server (peripheral) LBLEPeripheral.addService(ledService); // start the GATT server - it is now // available to connect LBLEPeripheral.begin();