本篇博文最後修改時間：2016年11月11日，09:31。

一、簡介

本文介紹在應用層如何開啟廣播，且解析協議棧在此操作後做了什麼。

二、實驗平臺

協議棧版本：BLE-CC254x-1.4.0

編譯軟體：IAR 8.20.2

硬體平臺：Amart RF開發板（主晶片CC2541）

三、

博主：甜甜的大香瓜

宣告：喝水不忘挖井人，轉載請註明出處。

原文地址：http://blog.csdn.NET/feilusia

聯絡方式：[email protected]

香瓜BLE之CC2541群：127442605

香瓜BLE之CC2640群：557278427

香瓜BLE之Android群：541462902

五、基礎知識

暫無

六、實驗步驟

1、開啟廣播（simpleBLEPeripheral.c的SimpleBLEPeripheral_Init中）

在應用層開啟廣播功能其實非常簡單，只要把TRUE傳給GAPRole_SetParameter函式中的GAPROLE_ADVERT_ENABLED就可以了。

七、解析協議棧在開啟廣播的操作後做了什麼

1、GAPRole_SetParameter函式中的GAPROLE_ADVERT_ENABLED

    case GAPROLE_ADVERT_ENABLED:
      if ( len == sizeof( uint8 ) )
      {
        uint8 oldAdvEnabled = gapRole_AdvEnabled;
        gapRole_AdvEnabled = *((uint8*)pValue);

        if ( (oldAdvEnabled) && (gapRole_AdvEnabled == FALSE) )
        {
          // Turn off Advertising
          if ( gapRole_state == GAPROLE_ADVERTISING )
          {
            VOID GAP_EndDiscoverable( gapRole_TaskID );
          }
        }
        else if ( (oldAdvEnabled == FALSE) && (gapRole_AdvEnabled) )
        {
          // Turn on Advertising
          if ( (gapRole_state == GAPROLE_STARTED)
              || (gapRole_state == GAPROLE_WAITING)
              || (gapRole_state == GAPROLE_WAITING_AFTER_TIMEOUT) )
          {
            VOID osal_set_event( gapRole_TaskID, START_ADVERTISING_EVT );
          }
        }
      }
      else
      {
        ret = bleInvalidRange;
      }
      break;
 

其中gapRole_AdvEnabled預設是TRUE

static uint8  gapRole_AdvEnabled = TRUE;

首先，每次進到這個函式裡，就會把gapRole_AdvEnabled的值儲存到oldAdvEnabled，再把新的狀態寫到gapRole_AdvEnabled。也就是這兩句：

        uint8 oldAdvEnabled = gapRole_AdvEnabled;
        gapRole_AdvEnabled = *((uint8*)pValue);

其次，對oldAdvEnabled（舊的廣播開關狀態）和gapRole_AdvEnabled（新傳入的廣播開關狀態）這兩個變數進行了判斷：

1）在廣播狀態下，想關閉廣播----->關閉廣播

2）在不廣播的狀態下，想開啟廣播--->開啟廣播

然而程式碼中並沒有將另外兩種情況編寫進來，也就是

3）在廣播狀態下，還想開啟廣播

4）在不廣播的狀態下，還想關閉廣播

協議棧把這兩種情況劃入了else的bleInvalidRange。

第2）種情況的開廣播，呼叫了gapRole_TaskID任務中的START_ADVERTISING_EVT事件。

        else if ( (oldAdvEnabled == FALSE) && (gapRole_AdvEnabled) )
        {
          // Turn on Advertising
          if ( (gapRole_state == GAPROLE_STARTED)
              || (gapRole_state == GAPROLE_WAITING)
              || (gapRole_state == GAPROLE_WAITING_AFTER_TIMEOUT) )
          {
            VOID osal_set_event( gapRole_TaskID, START_ADVERTISING_EVT );
          }
        }

2、START_ADVERTISING_EVT事件

  if ( events & START_ADVERTISING_EVT )
  {
    if ( gapRole_AdvEnabled )
    {
      gapAdvertisingParams_t params;

      // Setup advertisement parameters
      params.eventType = gapRole_AdvEventType;
      params.initiatorAddrType = gapRole_AdvDirectType;
      VOID osal_memcpy( params.initiatorAddr, gapRole_AdvDirectAddr, B_ADDR_LEN );
      params.channelMap = gapRole_AdvChanMap;
      params.filterPolicy = gapRole_AdvFilterPolicy;

      if ( GAP_MakeDiscoverable( gapRole_TaskID, ¶ms ) != SUCCESS )
      {
        gapRole_state = GAPROLE_ERROR;
        
        // Notify the application with the new state change
        if ( pGapRoles_AppCGs && pGapRoles_AppCGs->pfnStateChange )
        {
          pGapRoles_AppCGs->pfnStateChange( gapRole_state );
        }
      }
    }
    return ( events ^ START_ADVERTISING_EVT );
  }

如果廣播不成功，則會呼叫函式指標pGapRoles_AppCGs指向的回撥函式，並且傳入引數GAPROLE_ERROR，以此來通知應用層廣播不成功。

那麼呼叫的又是哪個回撥函式呢？

追蹤一下pGapRoles_AppCGs發現有個註冊回撥函式的函式

/*********************************************************************
 * @brief   Does the device initialization.
 *
 * Public function defined in peripheral.h.
 */
bStatus_t GAPRole_StartDevice( gapRolesCBs_t *pAppCallbacks )
{
  if ( gapRole_state == GAPROLE_INIT )
  {
    // Clear all of the Application callbacks
    if ( pAppCallbacks )
    {
      pGapRoles_AppCGs = pAppCallbacks;
    }

    // Start the GAP
    gapRole_SetupGAP();

    return ( SUCCESS );
  }
  else
  {
    return ( bleAlreadyInRequestedMode );
  }
}

再追蹤一下這個註冊函式，發現在應用層的SBP_START_DEVICE_EVT事件中對此進行了註冊

  if ( events & SBP_START_DEVICE_EVT )
  {
    // Start the Device
    VOID GAPRole_StartDevice( &simpleBLEPeripheral_PeripheralCBs );

    // Start Bond Manager
    VOID GAPBondMgr_Register( &simpleBLEPeripheral_BondMgrCBs );

    // Set timer for first periodic event
    osal_start_timerEx( simpleBLEPeripheral_TaskID, SBP_PERIODIC_EVT, SBP_PERIODIC_EVT_PERIOD );

    return ( events ^ SBP_START_DEVICE_EVT );
  }

所以當廣播開啟不成功之後，會呼叫simpleBLEPeripheral_PeripheralCBs的回撥函式peripheralStateNotificationCB的GAPROLE_ERROR

// GAP Role Callbacks
static gapRolesCBs_t simpleBLEPeripheral_PeripheralCBs =
{
  peripheralStateNotificationCB,  // Profile State Change Callbacks
  NULL                            // When a valid RSSI is read from controller (not used by application)
};

    case GAPROLE_ERROR:
      {
        #if (defined HAL_LCD) && (HAL_LCD == TRUE)
          HalLcdWriteString( "Error",  HAL_LCD_LINE_3 );
        #endif // (defined HAL_LCD) && (HAL_LCD == TRUE)
      }
      break;

到此，廣播過程就結束了，很簡單吧，哈哈。