低功耗蓝牙库

在调用低功耗蓝牙中间件 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. AddCustomServicesCb 在您的应用程序中创建 IotBle _：

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