Bluetooth Low Energy 라이브러리

Bluetooth Low Energy 미들웨어 API를 호출하기 전에 Bluetooth Low Energy 하드웨어 드라이버를 초기화합니다.

Bluetooth Low Energy를 활성화합니다.

IotBLE_Init()를 사용하여 미들웨어를 초기화합니다.

API를 호출하기 전에 모든 Bluetooth Low Energy 하드웨어 드라이버를 초기화합니다. 드라이버 초기화는 Bluetooth Low Energy 하위 수준 API의 일부가 아닙니다.

Bluetooth Low Energy 하위 수준 API는 전력 및 리소스를 최적화하기 위해 Bluetooth Low Energy 스택에 활성화/비활성화 호출을 제공합니다. API를 호출하기 전에 Bluetooth Low Energy를 활성화해야 합니다.

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

Bluetooth 관리자에는 Bluetooth Low Energy와 Bluetooth classic 모두에 공통인 API가 포함되어 있습니다. 공통 관리자에 대한 콜백은 두 번째로 초기화해야 합니다.

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

Bluetooth Low Energy 어댑터는 공통 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 );

Bluetooth Low Energy 어댑터를 초기화한 후 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 );
   }