低功耗藍牙程式庫

在呼叫低功耗藍牙中介軟體 API 之前，請初始化任何低功耗藍牙硬體驅動程式。

啟用低功耗藍牙。

以 IotBLE_Init() 初始化中介軟體。

在呼叫 API 前初始化任何低功耗藍牙硬體驅動程式。驅動程式初始化並不屬於低功耗藍牙低階 API。

低功耗藍牙低階 API 提供啟用/停用呼叫低功耗藍牙堆疊的功能，以最佳化電源和資源。呼叫 API 之前，您必須啟用低功耗藍牙。

const BTInterface_t * pxIface = BTGetBluetoothInterface();
xStatus = pxIface->pxEnable( 0 );

藍牙管理員包含低功耗藍牙和藍牙傳統常用的 API。接著必須初始化常用管理員的回呼。

xStatus = xBTInterface.pxBTInterface->pxBtManagerInit( &xBTManagerCb );

低功耗藍牙轉接器放在常用 API 之上。您必須初始化其回呼，如同您初始化常用 API 一般。

xBTInterface.pxBTLeAdapterInterface = ( BTBleAdapter_t * ) xBTInterface.pxBTInterface->pxGetLeAdapter();
xStatus = xBTInterface.pxBTLeAdapterInterface->pxBleAdapterInit( &xBTBleAdapterCb );

註冊新的使用者應用程式。

xBTInterface.pxBTLeAdapterInterface->pxRegisterBleApp( pxAppUuid );

初始化 GATT 伺服器的回呼。

xBTInterface.pxGattServerInterface = ( BTGattServerInterface_t * ) xBTInterface.pxBTLeAdapterInterface->ppvGetGattServerInterface();
xBTInterface.pxGattServerInterface->pxGattServerInit( &xBTGattServerCb );

在初始化低功耗藍牙轉接器之後，您可以新增 GATT 伺服器。您一次只能註冊一部 GATT 伺服器。

xStatus = xBTInterface.pxGattServerInterface->pxRegisterServer( pxAppUuid );

設定應用程式屬性，像是僅限安全連線和 MTU 大小。

xStatus = xBTInterface.pxBTInterface->pxSetDeviceProperty( &pxProperty[ usIndex ] );

在您的應用程式中設定廣告 UUID：

static const BTUuid_t _advUUID =
{
    .uu.uu128 = IOT_BLE_ADVERTISING_UUID,
    .ucType   = eBTuuidType128
};

然後定義 IotBle_SetCustomAdvCb 回呼函式：

void IotBle_SetCustomAdvCb( IotBleAdvertisementParams_t * pAdvParams,  IotBleAdvertisementParams_t * pScanParams)
{
    memset(pAdvParams, 0, sizeof(IotBleAdvertisementParams_t));
    memset(pScanParams, 0, sizeof(IotBleAdvertisementParams_t));

    /* Set advertisement message */
    pAdvParams->pUUID1 = &_advUUID;
    pAdvParams->nameType = BTGattAdvNameNone;

    /* This is the scan response, set it back to true. */
    pScanParams->setScanRsp = true;
    pScanParams->nameType = BTGattAdvNameComplete;
}

此回呼會在廣告訊息中傳送 UUID 訊息，並在掃描回應中傳送完整名稱。

開啟 vendors/vendor/boards/board/aws_demos/config_files/iot_ble_config.h，並將 IOT_BLE_SET_CUSTOM_ADVERTISEMENT_MSG 設為 1。這會觸發 IotBle_SetCustomAdvCb 回呼。

為服務的特性和描述項建立 UUID：

#define xServiceUUID_TYPE \
{\
    .uu.uu128 = gattDemoSVC_UUID, \
    .ucType   = eBTuuidType128 \
}
#define xCharCounterUUID_TYPE \
{\
    .uu.uu128 = gattDemoCHAR_COUNTER_UUID,\
    .ucType   = eBTuuidType128\
}
#define xCharControlUUID_TYPE \
{\
    .uu.uu128 = gattDemoCHAR_CONTROL_UUID,\
    .ucType   = eBTuuidType128\
}
#define xClientCharCfgUUID_TYPE \
{\
    .uu.uu16 = gattDemoCLIENT_CHAR_CFG_UUID,\
    .ucType  = eBTuuidType16\
}

建立緩衝以註冊特性和描述項的處理常式：

static uint16_t usHandlesBuffer[egattDemoNbAttributes];

建立屬性表格。若要節省一些 RAM，請將表格定義為 const。

static const BTAttribute_t pxAttributeTable[] = {
     {    
         .xServiceUUID =  xServiceUUID_TYPE
     },
    {
         .xAttributeType = eBTDbCharacteristic,
         .xCharacteristic = 
         {
              .xUuid = xCharCounterUUID_TYPE,
              .xPermissions = ( IOT_BLE_CHAR_READ_PERM ),
              .xProperties = ( eBTPropRead | eBTPropNotify )
          }
     },
     {
         .xAttributeType = eBTDbDescriptor,
         .xCharacteristicDescr =
         {
             .xUuid = xClientCharCfgUUID_TYPE,
             .xPermissions = ( IOT_BLE_CHAR_READ_PERM | IOT_BLE_CHAR_WRITE_PERM )
          }
     },
    {
         .xAttributeType = eBTDbCharacteristic,
         .xCharacteristic = 
         {
              .xUuid = xCharControlUUID_TYPE,
              .xPermissions = ( IOT_BLE_CHAR_READ_PERM | IOT_BLE_CHAR_WRITE_PERM  ),
              .xProperties = ( eBTPropRead | eBTPropWrite )
          }
     }
};

建立一系列的回呼。此回呼陣列必須遵循上述表格陣列所定義的相同順序。

例如，如果存取 xCharCounterUUID_TYPE 時 vReadCounter 被觸發了，而存取 xCharControlUUID_TYPE 時 vWriteCommand 被觸發了，則依下列內容定義陣列：

static const IotBleAttributeEventCallback_t pxCallBackArray[egattDemoNbAttributes] =
    {
  NULL,
  vReadCounter,
  vEnableNotification,
  vWriteCommand
};

建立服務：

static const BTService_t xGattDemoService = 
{
  .xNumberOfAttributes = egattDemoNbAttributes,
  .ucInstId = 0,
  .xType = eBTServiceTypePrimary,
  .pusHandlesBuffer = usHandlesBuffer,
  .pxBLEAttributes = (BTAttribute_t *)pxAttributeTable
};

使用您在上一步驟建立的結構來呼叫 API IotBle_CreateService。中介軟體會同步所有服務的建立，所以在 IotBle_AddCustomServicesCb 回呼觸發時，任何新的服務都必須已完成定義。

1. 在 vendors/vendor/boards/board/aws_demos/config_files/iot_ble_config.h 中將 IOT_BLE_ADD_CUSTOM_SERVICES 設為 1。

2. 在應用程式中建立 IotBle_AddCustomServicesCb：

   void IotBle_AddCustomServicesCb(void)
   {
       BTStatus_t xStatus;
       /* Select the handle buffer. */
       xStatus = IotBle_CreateService( (BTService_t *)&xGattDemoService, (IotBleAttributeEventCallback_t *)pxCallBackArray );
   }