NRF52832学习笔记（9）——GAP从机端广播

一、背景

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

1.1 蓝牙协议栈

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

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

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

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

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

1.2 从机广播

从机（外围设备）要被主机连接，那么它就必须先被主机发现。这个时候，从机设备把自身信息以广播形式发射出去。

比如设备A需要先进行广播，即 设备A（Advertiser） 不断发送如下广播信号，t 为广播间隔。每发送一次广播包，我们称其为一次 广播事件（advertising event），因此 t 也称为广播事件间隔，如下图所示。广播事件是一阵一阵的，每次会是有一个持续时间的，蓝牙芯片只有在广播事件期间才打开射频模块发射广播，这个时候功耗比较高，其余时间蓝牙芯片都处于idle待机状态，因此平均功耗就非常低。

当广播发出的时候，每一个广播事件包含三个广播包，即分别在 37/38/39 三个通道上同时广播相同的信息。下图 observer 为主机观察者，advertiser 就是从机广播。

二、配置广播参数

2.1 广播参数相关宏及变量

在 main.c 中

#define DEVICE_NAME                     "Nordic_Template"       /**< Name of device. Will be included in the advertising data. */
#define MANUFACTURER_NAME               "NordicSemiconductor"   /**< Manufacturer. Will be passed to Device Information Service. */
#define APP_ADV_INTERVAL                300                     /**< The advertising interval (in units of 0.625 ms. This value corresponds to 187.5 ms). */

#define APP_ADV_DURATION                0//18000                /**< The advertising duration (180 seconds) in units of 10 milliseconds. */

// YOUR_JOB: Use UUIDs for service(s) used in your application.
static ble_uuid_t m_adv_uuids[] =                                               /**< Universally unique service identifiers. */
{
    {BLE_UUID_DEVICE_INFORMATION_SERVICE, BLE_UUID_TYPE_BLE}
};

2.2 初始化广播参数

在 main.c 中

/**@brief Function for application main entry.
 */
int main(void)
{
    ···
    ···
    /*-------------------------- 蓝牙协议栈初始化 ---------------------------*/
    advertising_init();                 // 广播初始化
    /*-------------------------- 开启应用 ---------------------------*/
    // Start execution.
    NRF_LOG_INFO("Template example started."); 
    advertising_start(erase_bonds);    // 开启广播	

    // Enter main loop.
    for(;;)
    {
        idle_state_handle();
    }
}

2.2.1 advertising_init

/**@brief Function for initializing the Advertising functionality.
 */
static void advertising_init(void)
{
    ret_code_t err_code;
    ble_advertising_init_t init;

    memset(&init, 0, sizeof(init));
	
	// 初始化广播数据包内容
	init.advdata.name_type               = BLE_ADVDATA_FULL_NAME;  // 显示全名
    init.advdata.include_appearance      = true;  // 显示图标
    init.advdata.flags                   = BLE_GAP_ADV_FLAGS_LE_ONLY_GENERAL_DISC_MODE;
    init.advdata.uuids_complete.uuid_cnt = sizeof(m_adv_uuids) / sizeof(m_adv_uuids[0]);
    init.advdata.uuids_complete.p_uuids  = m_adv_uuids;

    init.config.ble_adv_fast_enabled  = true;              // 广播类型，快速广播				
    init.config.ble_adv_fast_interval = APP_ADV_INTERVAL;  // 广播间隔
    init.config.ble_adv_fast_timeout  = APP_ADV_DURATION;  // 广播超时时间，值0则保持一种广播模式不变

    init.evt_handler = on_adv_evt;

    err_code = ble_advertising_init(&m_advertising, &init);// 初始化广播，导入参数
    APP_ERROR_CHECK(err_code);

    ble_advertising_conn_cfg_tag_set(&m_advertising, APP_BLE_CONN_CFG_TAG);// 设置广播识别号
}

广播初始化实际上就是初始化两个结构体，一个是 &advdata 广播数据，一个是 &config 选择项。

设置完广播参数后，通过函数 ble_advertising_init() 配置广播参数到协议栈中。

2.3 广播参数定义

&advdata 广播数据定义了广播的基本参数，比如名称类型，最短名称长度，设备模式，发射功率等等，不是所有参数你都需要在初始化函数中进行设置。根据需求选择。

/**@brief Advertising data structure. This structure contains all options and data needed for encoding and
 *        setting the advertising data. */
typedef struct
{
    ble_advdata_name_type_t      name_type;                           /**< Type of device name. */
    uint8_t                      short_name_len;                      /**< Length of short device name (if short type is specified). */
    bool                         include_appearance;                  /**< Determines if Appearance shall be included. */
    uint8_t                      flags;                               /**< Advertising data Flags field. */
    int8_t *                     p_tx_power_level;                    /**< TX Power Level field. */
    ble_advdata_uuid_list_t      uuids_more_available;                /**< List of UUIDs in the 'More Available' list. */
    ble_advdata_uuid_list_t      uuids_complete;                      /**< List of UUIDs in the 'Complete' list. */
    ble_advdata_uuid_list_t      uuids_solicited;                     /**< List of solicited UUIDs. */
    ble_advdata_conn_int_t *     p_slave_conn_int;                    /**< Slave Connection Interval Range. */
    ble_advdata_manuf_data_t *   p_manuf_specific_data;               /**< Manufacturer specific data. */
    ble_advdata_service_data_t * p_service_data_array;                /**< Array of Service data structures. */
    uint8_t                      service_data_count;                  /**< Number of Service data structures. */
    bool                         include_ble_device_addr;             /**< Determines if LE Bluetooth Device Address shall be included. */
    ble_advdata_le_role_t        le_role;                             /**< LE Role field. Included when different from @ref BLE_ADVDATA_ROLE_NOT_PRESENT. @warning This field can be used only for NFC. For BLE advertising, set it to NULL. */
    ble_advdata_tk_value_t *     p_tk_value;                          /**< Security Manager TK value field. Included when different from NULL. @warning This field can be used only for NFC. For BLE advertising, set it to NULL.*/
    uint8_t *                    p_sec_mgr_oob_flags;                 /**< Security Manager Out Of Band Flags field. Included when different from NULL. @warning This field can be used only for NFC. For BLE advertising, set it to NULL.*/
    ble_gap_lesc_oob_data_t *    p_lesc_data;                         /**< LE Secure Connections OOB data. Included when different from NULL. @warning This field can be used only for NFC. For BLE advertising, set it to NULL.*/
} ble_advdata_t;

2.3.1 名称类型name_type

设置广播里，显示广播名称的三种类型：

/**@brief Advertising data name type. This enumeration contains the options available for the device name inside
 *        the advertising data. */
typedef enum
{
    BLE_ADVDATA_NO_NAME,                                              /**< Include no device name in advertising data. */
    BLE_ADVDATA_SHORT_NAME,                                           /**< Include short device name in advertising data. */
    BLE_ADVDATA_FULL_NAME                                             /**< Include full device name in advertising data. */
} ble_advdata_name_type_t;

2.3.2 展示图标include_appearance

设置是否需要展示图标
init.advdata.include_appearance = true; // 显示图标

2.3.3 蓝牙设备模式flags

/**@defgroup BLE_GAP_ADV_FLAGS GAP Advertisement Flags
 * @{ */
#define BLE_GAP_ADV_FLAG_LE_LIMITED_DISC_MODE         (0x01)   /**< LE Limited Discoverable Mode. */
#define BLE_GAP_ADV_FLAG_LE_GENERAL_DISC_MODE         (0x02)   /**< LE General Discoverable Mode. */
#define BLE_GAP_ADV_FLAG_BR_EDR_NOT_SUPPORTED         (0x04)   /**< BR/EDR not supported. */
#define BLE_GAP_ADV_FLAG_LE_BR_EDR_CONTROLLER         (0x08)   /**< Simultaneous LE and BR/EDR, Controller. */
#define BLE_GAP_ADV_FLAG_LE_BR_EDR_HOST               (0x10)   /**< Simultaneous LE and BR/EDR, Host. */
#define BLE_GAP_ADV_FLAGS_LE_ONLY_LIMITED_DISC_MODE   (BLE_GAP_ADV_FLAG_LE_LIMITED_DISC_MODE | BLE_GAP_ADV_FLAG_BR_EDR_NOT_SUPPORTED)   /**< LE Limited Discoverable Mode, BR/EDR not supported. */
#define BLE_GAP_ADV_FLAGS_LE_ONLY_GENERAL_DISC_MODE   (BLE_GAP_ADV_FLAG_LE_GENERAL_DISC_MODE | BLE_GAP_ADV_FLAG_BR_EDR_NOT_SUPPORTED)   /**< LE General Discoverable Mode, BR/EDR not supported. */
/**@} */

蓝牙模式设置通过 flags 来进行标识：
LE 是 BLE（低功耗蓝牙），BR/EDR 是 蓝牙基本速率/增强速率（传统蓝牙），一般为蓝牙耳机

• Bit0：LE 有限发现模式
• Bit1：LE 普通发现模式
• Bit2：不支持 BR/EDR 模式
• Bit3：同时支持 BLE 和 BR/EDR 模式（控制器）
• Bit3：同时支持 BLE 和 BR/EDR 模式（主机）

BLE设备通常设置两种情况：

• BLE_GAP_ADV_FLAGS_LE_ONLY_LIMITED_DISC_MODE：LE 有限发现模式和不支持 BR/EDR 模式。
• BLE_GAP_ADV_FLAGS_LE_ONLY_GENERAL_DISC_MODE：LE 普通发现模式和不支持 BR/EDR 模式。

2.4 广播模式配置

&config 定义了广播的模式配置，比如广播模式，广播间隔，广播时间等等

/**@brief   Options for the different advertisement modes.
 *
 * @details This structure is used to enable or disable advertising modes and to configure time-out
 *          periods and advertising intervals.
 */
typedef struct
{
    bool     ble_adv_on_disconnect_disabled;     /**< Enable or disable automatic return to advertising upon disconnecting.*/
    bool     ble_adv_whitelist_enabled;          /**< Enable or disable use of the whitelist. */
    bool     ble_adv_directed_high_duty_enabled; /**< Enable or disable high duty direct advertising mode. Can not be used together with extended advertising. */
    bool     ble_adv_directed_enabled;           /**< Enable or disable direct advertising mode. */
    bool     ble_adv_fast_enabled;               /**< Enable or disable fast advertising mode. */
    bool     ble_adv_slow_enabled;               /**< Enable or disable slow advertising mode. */
    uint32_t ble_adv_directed_interval;          /**< Advertising interval for directed advertising. */
    uint32_t ble_adv_directed_timeout;           /**< Time-out (number of tries) for direct advertising. */
    uint32_t ble_adv_fast_interval;              /**< Advertising interval for fast advertising. */
    uint32_t ble_adv_fast_timeout;               /**< Time-out (in units of 10ms) for fast advertising. */
    uint32_t ble_adv_slow_interval;              /**< Advertising interval for slow advertising. */
    uint32_t ble_adv_slow_timeout;               /**< Time-out (in units of 10ms) for slow advertising. */
    bool     ble_adv_extended_enabled;           /**< Enable or disable extended advertising. */
    uint32_t ble_adv_secondary_phy;              /**< PHY for the secondary (extended) advertising @ref BLE_GAP_PHYS (BLE_GAP_PHY_1MBPS, BLE_GAP_PHY_2MBPS or BLE_GAP_PHY_CODED). */
    uint32_t ble_adv_primary_phy;                /**< PHY for the primary advertising. @ref BLE_GAP_PHYS (BLE_GAP_PHY_1MBPS, BLE_GAP_PHY_2MBPS or BLE_GAP_PHY_CODED). */
} ble_adv_modes_config_t;

2.4.1 广播模式

• directed_high_duty 高速连接任务模式：利用的就是 BLE 中的直连广播，该模式是为了快速重连上刚刚断开的配对设备。比如利用在快速重连上意外断开的设备，已达到无缝恢复的目的。这种模式只有在扩展广播被关闭下才能够使用。扩展广播是蓝牙5.0新特性

• directed 定向广播模式：这种方式比高速模式的广播周期要低。

• fast 快速广播模式：就是普通的广播，不过连接间隔我们可以设置的快一点。

• slow 慢速广播模式：普通广播，连接间隔设置的慢一点。

• idle 空闲模式：停止广播。

2.4.2 广播间隔

广播包的广播时间间隔，不同的广播类型下都有自己对应的广播间隔。
工程中设置为：init.config.ble_adv_fast_interval = APP_ADV_INTERVAL;

2.4.3 广播时间

超过这个时间会发生广播超时处理，不同的广播类型下都有自己对应的广播时间。
工程中设置为：init.config.ble_adv_fast_timeout = APP_ADV_DURATION;

三、执行广播

在从机的 ble_app_template 工程的 main.c 中，在广播初始化程序里设置为 init.config.ble_adv_fast_enabled = true; 广播类型为快速广播。那么开始广播时就直接进入快速广播。整个启动过程交给了主函数中 advertising_start() 中的 ble_advertising_start() 来实现。

3.1 advertising_start

未绑定情况下，开启广播。进入 ble_advertising_start() 。

/**@brief Function for starting advertising.
 */
void advertising_start(bool erase_bonds)
{
    if(erase_bonds == true)
    {
        delete_bonds();
        // Advertising is started by PM_EVT_PEERS_DELETED_SUCEEDED event
    }
    else
    {
        ret_code_t err_code = ble_advertising_start(&m_advertising, BLE_ADV_MODE_FAST);

        APP_ERROR_CHECK(err_code);
    }
}

3.2 ble_advertising_start

根据实参 BLE_ADV_MODE_FAST 在 switch case 中启动快速广播

uint32_t ble_advertising_start(ble_advertising_t * const p_advertising,
                               ble_adv_mode_t            advertising_mode)
{
    uint32_t ret;

    if (p_advertising->initialized == false)
    {
        return NRF_ERROR_INVALID_STATE;
    }

    p_advertising->adv_mode_current = advertising_mode;

    memset(&p_advertising->peer_address, 0, sizeof(p_advertising->peer_address));

    if (  ((p_advertising->adv_modes_config.ble_adv_directed_high_duty_enabled) && (p_advertising->adv_mode_current == BLE_ADV_MODE_DIRECTED_HIGH_DUTY))
        ||((p_advertising->adv_modes_config.ble_adv_directed_enabled)           && (p_advertising->adv_mode_current == BLE_ADV_MODE_DIRECTED_HIGH_DUTY))
        ||((p_advertising->adv_modes_config.ble_adv_directed_enabled)           && (p_advertising->adv_mode_current == BLE_ADV_MODE_DIRECTED))
       )
    {
        if (p_advertising->evt_handler != NULL)
        {
            p_advertising->peer_addr_reply_expected = true;
            p_advertising->evt_handler(BLE_ADV_EVT_PEER_ADDR_REQUEST);
        }
        else
        {
            p_advertising->peer_addr_reply_expected = false;
        }
    }

    p_advertising->adv_mode_current = adv_mode_next_avail_get(p_advertising, advertising_mode);

    // Fetch the whitelist.
    if ((p_advertising->evt_handler != NULL) &&
        (p_advertising->adv_mode_current == BLE_ADV_MODE_FAST || p_advertising->adv_mode_current == BLE_ADV_MODE_SLOW) &&
        (p_advertising->adv_modes_config.ble_adv_whitelist_enabled) &&
        (!p_advertising->whitelist_temporarily_disabled))
    {
        p_advertising->whitelist_in_use         = false;
        p_advertising->whitelist_reply_expected = true;
        p_advertising->evt_handler(BLE_ADV_EVT_WHITELIST_REQUEST);
    }
    else
    {
        p_advertising->whitelist_reply_expected = false;
    }

    // Initialize advertising parameters with default values.
    memset(&p_advertising->adv_params, 0, sizeof(p_advertising->adv_params));

    p_advertising->adv_params.properties.type = BLE_GAP_ADV_TYPE_CONNECTABLE_SCANNABLE_UNDIRECTED;

    // Use 1MBIT as primary phy if no phy was selected.
    if (phy_is_valid(&p_advertising->adv_modes_config.ble_adv_primary_phy))
    {
        p_advertising->adv_params.primary_phy = p_advertising->adv_modes_config.ble_adv_primary_phy;
    }
    else
    {
        p_advertising->adv_params.primary_phy = BLE_GAP_PHY_1MBPS;
    }

    if (p_advertising->adv_modes_config.ble_adv_extended_enabled)
    {
        // Use 1MBIT as secondary phy if no phy was selected.
        if (phy_is_valid(&p_advertising->adv_modes_config.ble_adv_primary_phy))
        {
            p_advertising->adv_params.secondary_phy = p_advertising->adv_modes_config.ble_adv_secondary_phy;
        }
        else
        {
            p_advertising->adv_params.secondary_phy = BLE_GAP_PHY_1MBPS;
        }
    }
    p_advertising->adv_params.filter_policy = BLE_GAP_ADV_FP_ANY;

    // Set advertising parameters and events according to selected advertising mode.
    switch (p_advertising->adv_mode_current)
    {
        case BLE_ADV_MODE_DIRECTED_HIGH_DUTY:
            ret = set_adv_mode_directed_high_duty(p_advertising, &p_advertising->adv_params);
            break;

        case BLE_ADV_MODE_DIRECTED:
            ret = set_adv_mode_directed(p_advertising, &p_advertising->adv_params);
            break;

        case BLE_ADV_MODE_FAST:
            ret = set_adv_mode_fast(p_advertising, &p_advertising->adv_params);
            break;

        case BLE_ADV_MODE_SLOW:
            ret = set_adv_mode_slow(p_advertising, &p_advertising->adv_params);
            break;

        case BLE_ADV_MODE_IDLE:
            p_advertising->adv_evt = BLE_ADV_EVT_IDLE;
            break;

        default:
            break;
    }

    if (p_advertising->adv_mode_current != BLE_ADV_MODE_IDLE)
    {

        ret = sd_ble_gap_adv_set_configure(&p_advertising->adv_handle, p_advertising->p_adv_data, &p_advertising->adv_params);
        if (ret != NRF_SUCCESS)
        {
            return ret;
        }
        ret = sd_ble_gap_adv_start(p_advertising->adv_handle, p_advertising->conn_cfg_tag);

        if (ret != NRF_SUCCESS)
        {
            return ret;
        }
    }

    if (p_advertising->evt_handler != NULL)
    {
        p_advertising->evt_handler(p_advertising->adv_evt);
    }

    return NRF_SUCCESS;
}

但是，我们蓝牙设备不可能一直广播下去，这样很费电，我们需要动态的切换广播状态这个工作由 广播回调函数 完成，在 BLE_ADVERTISING_H 文件中

这个是回调函数必须有的部分，其中 ble_advertising_on_ble_evt() 广播蓝牙回调事件函数是主要作用。

比如我们程序开始设置为快速广播，那么在超时后进入下一级慢速模式。如果是慢速广播，超时进入无效模式。在函数中我们只设置了快速广播超时时间，其他几种广播超时时间没有设置，那么就默认为0，那么整个状态就变为 快速广播超时的TIMEOUT时间内没有连接—> 进入慢速广播—> 立即进入无效模式

ble_advertising_start 开始广播函数每次在超时的时候会调用 adv_mode_next_get 函数，这个函数调用一次会把模式自动加1。

/**@brief Function for checking the next advertising mode.
 *
 * @param[in] adv_mode Current advertising mode.
 */
static ble_adv_mode_t adv_mode_next_get(ble_adv_mode_t adv_mode)
{
    return (ble_adv_mode_t)((adv_mode + 1) % BLE_ADV_MODES);
}

设置广播模式的时候是递进设置的，高速定向广播---> 普通定向广播---> 快速广播---> 慢速广播---> 无效广播 每一级模式到达超时时间后会进入到下一级广播模式。

3.3 on_adv_evt

在 main.c 中，on_adv_evt 为广播事件处理函数，设置广播模式成功后执行对应操作，在蓝牙样例工程里由于没有慢速超时时间，实际上只需用到了两种状态，快速广播和无效广播。在 case 中可以加入自己的一些操作，如快速广播开始后，LED灯会闪烁，而无效广播模式会进入休眠模式。

/**@brief Function for handling advertising events.
 *
 * @details This function will be called for advertising events which are passed to the application.
 *
 * @param[in] ble_adv_evt  Advertising event.
 */
static void on_adv_evt(ble_adv_evt_t ble_adv_evt)
{
    ret_code_t err_code;

    switch(ble_adv_evt)
    {
        case BLE_ADV_EVT_FAST:  // 快速广播模式
            NRF_LOG_INFO("Fast advertising.");
            err_code = bsp_indication_set(BSP_INDICATE_ADVERTISING);
            APP_ERROR_CHECK(err_code);
            break;

        case BLE_ADV_EVT_IDLE:  // 无效模式 
            sleep_mode_enter();
            break;

        default:
            break;
    }
}

四、不进入IDLE无效模式

广播模式的切换主要就是广播超时处理，如果没有这个超时时间，就不会切换到下一个模式，保持在一种广播模式不变。

把 APP_ADV_DURATION 设置为 0 即可。

五、扫描响应包

广播包有两种：广播数据包（Advertising Data）和扫描相应包（Scan Response），其中广播数据包是每个设备必须广播的，而扫描响应包是可选的。

每个包都是 31 个字节，数据包中分为有效数据（significant）和无效数据（non-significant）两部分。

• 有效数据部分：包含若干个广播数据单元，称为 AD Structure。AD Structure 的组成是：第一个字节是长度值 Len，表示接下来的 Len 个字节是数据部分。数据部分的第一个字节表示数据的类型 AD Type，剩下的 Len - 1 个字节是真正的数据 AD Data。其中 AD Type 非常关键，决定了 AD Data 的数据代表的是什么和怎么解析。
• 无效数据部分：因为广播包的长度必须是 31 个字节，如果有效数据部分不到 31 个字节，剩下的就用 0 补全。这部分的数据是无效的，解析时忽略即可。

而扫描响应包是为了给广播一个额外的 31 字节数据，用于主机 主动扫描 情况下，反馈数据使用。

比如私有任务的 128bit UUID，我们需要反馈给主机的时候，我们可以采用下面这种方式配置：

设置广播数据包和扫描响应包的数据长度，最长为 31 字节。


程序下载后，使用 nrf connect app 进行扫描，这个 APP 不点击连接，可以点击广播信息，实现主动扫描方式。


用抓捕器抓取，会出现扫描请求包，请求后出现一个扫描响应包。

扫描响应包 ScanRspData 里 11 和 07 分别表述空白字段和 128bit UUID

后面的内容就是该 UUID 的数值了。这样就广播了一个额外的 31 个字节来扩展广播内容。

---

• 由 Leung 写于 2020 年 2 月 6 日

• 参考：青风电子社区