一、背景

链路层（LL）控制设备的射频状态，有五个设备状态：待机、广播、扫描、初始化和连接。

广播为广播数据包，而扫描则是监听广播。

GAP通信中角色，中心设备（Central - 主机）用来扫描和连接 外围设备（Peripheral - 从机）。

大部分情况下外围设备通过广播自己来让中心设备发现自己，并建立 GATT 连接，从而进行更多的数据交换。

也有些情况是不需要连接的，只要外设广播自己的数据即可，用这种方式主要目的是让外围设备，把自己的信息发送给多个中心设备。

本篇是关于配置以及启动或关闭广播的流程，广播自定义数据包查看CC2640R2F学习笔记（19）——GAP从机端广播自定义数据

二、配置广播参数

2.1 广播参数相关宏

// Advertising interval when device is discoverable (units of 625us, 160=100ms)
#define DEFAULT_ADVERTISING_INTERVAL          160   

// Limited discoverable mode advertises for 30.72s, and then stops
// General discoverable mode advertises indefinitely
#define DEFAULT_DISCOVERABLE_MODE             GAP_ADTYPE_FLAGS_GENERAL

2.2 广播相关变量

// 扫描响应包
static uint8_t scanRspData[] =
{
  // complete name
  0x05,                             // length of this data
  GAP_ADTYPE_LOCAL_NAME_COMPLETE,
  'B', 'A', 'N', 'D',

  // Tx power level
  0x02,                             // length of this data
  GAP_ADTYPE_POWER_LEVEL,
  0                                 // 0dBm
};

// 广播数据包
// GAP - Advertisement data (max size = 31 bytes, though this is
// best kept short to conserve power while advertisting)
static uint8_t advertData[] =
{
  // Flags; this sets the device to use limited discoverable
  // mode (advertises for 30 seconds at a time) instead of general
  // discoverable mode (advertises indefinitely)
  0x02,                             // length of this data
  GAP_ADTYPE_FLAGS,
  DEFAULT_DISCOVERABLE_MODE | GAP_ADTYPE_FLAGS_BREDR_NOT_SUPPORTED,

  // service UUID, to notify central devices what services are included
  // in this peripheral
  0x03,                             // length of this data
  GAP_ADTYPE_16BIT_MORE,            // some of the UUID's, but not all
  LO_UINT16(SIMPLEPROFILE_SERV_UUID),
  HI_UINT16(SIMPLEPROFILE_SERV_UUID)
};

2.3 配置GAP参数值

以SDK2.4 multi_role工程为例，在 multi_role_init() 初始化多角色应用程序函数中，

/*===================================== 从机 =====================================*/
/*------------------- 广播参数 -------------------*/
uint16_t advInt = DEFAULT_ADVERTISING_INTERVAL;             // 广播间隔，间隔越大功耗越低
GAP_SetParamValue(TGAP_LIM_DISC_ADV_INT_MIN, advInt);
GAP_SetParamValue(TGAP_LIM_DISC_ADV_INT_MAX, advInt);
GAP_SetParamValue(TGAP_GEN_DISC_ADV_INT_MIN, advInt);
GAP_SetParamValue(TGAP_GEN_DISC_ADV_INT_MAX, advInt);
GAP_SetParamValue(TGAP_CONN_ADV_INT_MIN, advInt);
GAP_SetParamValue(TGAP_CONN_ADV_INT_MAX, advInt);

2.4 配置GAP角色规范（Role Profile）

以SDK2.4 multi_role工程为例，在 multi_role_init() 初始化多角色应用程序函数中，

/*===================================== 从机 =====================================*/
/*------------------- 广播参数 -------------------*/
uint8_t initialAdvertEnable = TRUE;                         // 是否开机广播
uint16_t advertOffTime = 0;

// 设置开机广播
GAPRole_SetParameter(GAPROLE_ADVERT_ENABLED, sizeof(uint8_t), &initialAdvertEnable, NULL);
// By setting this to zero, the device will go into the waiting state after
// being discoverable for 30.72 second, and will not being advertising again
// until the enabler is set back to TRUE
GAPRole_SetParameter(GAPROLE_ADVERT_OFF_TIME, sizeof(uint16_t), &advertOffTime, NULL);

// 设置扫描响应包内容
GAPRole_SetParameter(GAPROLE_SCAN_RSP_DATA, sizeof(scanRspData), scanRspData, NULL);

// 设置广播包内容
GAPRole_SetParameter(GAPROLE_ADVERT_DATA, sizeof(advertData), advertData, NULL);

三、执行广播

3.1 执行广播函数

原mr_doAdvertise函数修改后

/**
 @brief 执行广播函数
 @param index 1 - 开启广播；0 - 关闭广播
 @return TRUE - 成功；FALSE - 失败
*/
bool mr_doAdvertise(uint8_t index)
{
    uint8_t adv;

    if(!index)                                                          // 关闭广播
    {
        adv = FALSE;
        GAPRole_SetParameter(GAPROLE_ADVERT_ENABLED, sizeof(uint8_t), &adv, NULL);
    }
    else                                                                // 开启广播
    {
        adv = TRUE;
        GAPRole_SetParameter(GAPROLE_ADVERT_ENABLED, sizeof(uint8_t), &adv, NULL);
    }

    return TRUE;
}

四、广播相关事件

在执行完开启广播函数或者停止广播函数后，会产生相应的事件。以SDK2.4 multi_role工程为例，在 multi_role_processRoleEvent() 处理多角色事件函数中，

4.1 开启广播事件

switch(pEvent->gap.opcode)
{
    /*===================================== 开启广播事件 =====================================*/
    case GAP_MAKE_DISCOVERABLE_DONE_EVENT:
    {
        /* Display_print0(dispHandle, MR_ROW_ADV, 0, "Advertising"); */
    }
    break;
}

4.2 关闭广播事件

switch(pEvent->gap.opcode)
{
    /*===================================== 关闭广播事件 =====================================*/
    case GAP_END_DISCOVERABLE_DONE_EVENT:
    {
        if(linkDB_NumActive() < maxNumBleConns)
        {
            /* Display_print0(dispHandle, MR_ROW_ADV, 0, "Ready to Advertise"); */
        }
        else
        {
            /* Display_print0(dispHandle, MR_ROW_ADV, 0, "Can't Adv : Max conns reached"); */
        }
    }
    break;
}

• 由 Leung 写于 2019 年 3 月 28 日

• 参考：simplelink_cc2640r2_sdk_2_40_00_32 [提取码:3pg6]

CC2640R2F学习笔记（11）——GAP从机端广播