LE Central Extended Scan

LE central extended scan示例工程可以作为开发基于central角色的APP的框架。

特征：

在primary advertising channel ( LE 1M PHY / LE Coded PHY )对advertising数据包进行extended scan。
设定scan的duration或period scan。
可以作为master角色发起一条LE链路，PHY为 LE 1M PHY 、 LE 2M PHY 或 LE Coded PHY 。

简介

兼容性

使用LE Advertising Extensions的central设备可以与使用legacy advertising PDUs或extended advertising PDUs的设备通信，可以设置scan的持续时间。
若使用extended advertising PDUs，与不同蓝牙版本的对端设备的兼容性如下表所示：

使用LE Advertising Extensions的Central设备的兼容性
BT 5 Feature	BT 4.0	BT 4.1	BT 4.2	BT 5.0 (not use LE Advertising Extensions)	BT 5.0 (use LE Advertising Extensions)
LE Advertising Extensions	Y	Y	Y	Y	Y

环境需求

该示例支持以下开发工具包:

环境需求
Hardware Platforms	Board Name
RTL87x2G HDK	RTL87x2G EVB

该示例还需要一个设备运行一个Peripheral extended ADV 角色来对测。例如运行Peripheral extended advertising示例工程的另一块开发板。

更多要求，请参考快速入门。

硬件连线

请参考快速入门中的 EVB接口和模块。

该示例工程需要支持用户命令接口。具体连线介绍请参考 User Command Interface 中的 Data UART连接。

配置选项

APP配置选项

APP所有需要配置的内容在 samples\bluetooth\ble_bt5_central\src\app_flags.h 中，开发者可以根据实际需求配置。

/** @brief Configure coding scheme of LE Coded PHY: 0 - S = 2, 1 - S = 8 */
 #define LE_CODED_PHY_S8            0
 /** @brief Configure APP LE link number */
 #define APP_MAX_LINKS  1
 /** @brief Configure APP to recombine advertising data: 0 - Disable recombine advertising data feature, 1 - recombine advertising data */
 #define APP_RECOMBINE_ADV_DATA  0

开发者可以通过 APP_RECOMBINE_ADV_DATA 来配置APP重组advertising数据。Advertising数据重组的流程在代码介绍的 Advertising数据重组中进行介绍。

生成系统配置文件

开发者可以通过MPTool配置链接个数：

MPTool配置
Configurable Item	Value
LE Maser Link Num	≥ APP_MAX_LINKS

更多有关于MPTool配置的信息请参考快速入门中的生成System Config File 。

编译和下载

该示例可以在SDK文件夹中找到:

Keil

Project file: samples\bluetooth\ble_bt5_central\proj\rtl87x2g\mdk

GCC

Project file: samples\bluetooth\ble_bt5_central\proj\rtl87x2g\gcc

编译和运行该示例请遵循以下步骤:

打开项目文件。
要编译目标文件，请参考快速入门的编译APP Image 中列出的步骤。
编译成功后，目录 samples\bluetooth\ble_bt5_central\proj\rtl87x2g\mdk\bin 下会生成app bin文件 app_MP_sdk_xxx.bin 。
要下载app bin到 EVB ，请参考快速入门的 MPTool 中列出的步骤。
在EVB上按下reset键，程序将开始运行。

测试验证

将示例工程烧录到EVB后，开发者可以使用另一个运行 LE Peripheral Extended ADV 示例工程的开发板进行测试。

与另一块开发板对测

准备两块开发板分别命名为 DUT 和 Tester ，开发者可以使用 DebugAnalyzer 抓取Soc端Log 。

根据 Tester 的配置，将测试步骤分为两类： Primary Advertising Channel是LE 1M PHY，Secondary Advertising Channel是LE 2M PHY ； Primary Advertising Channel是LE Coded PHY，Secondary Advertising Channel是LE Coded PHY 。

Primary Advertising Channel是LE 1M PHY，Secondary Advertising Channel是LE 2M PHY

准备步骤

使用MPTool将 DUT 地址设为[00:11:22:33:44:92]，然后编译Central extended scan示例工程并将images下载至 DUT。
首先将 ADVERTISING_PHY 设为 APP_PRIMARY_1M_SECONDARY_2M 。使用MPTool将 Tester 地址设为[00:11:22:33:44:91]，然后编译Peripheral extended advertising示例工程并下载images至 Tester。更多信息请参见 LE Peripheral Extended ADV 中的编译和下载。

更多关于如何修改 蓝牙地址 的细节请查阅快速入门中的生成System Config File 。

测试步骤

按 Tester 上的 reset 键， Tester 将开始发送可连接的非定向广播。

如果成功启动广播，会打印下面的 DebugAnalyser 日志。如果没有看到下列日志，说明广播启动失败。请检查软件和硬件环境。
[APP] !**GAP_MSG_LE_EXT_ADV_ENABLE:cause 0x0
[APP] !**app_handle_ext_adv_state_evt: adv_handle = 0 oldState = 1
[APP] !**app_handle_ext_adv_state_evt: adv_handle = 0 newState = 2
[APP] !**EXT_ADV_STATE_ADVERTISING: adv_handle 0, cause 0x0

按 DUT 上的 reset 键，开发者可以在电脑的串口助手工具端输入用户命令。

如果 DUT 成功启动且 serial port assistant tool 配置成功，开发者会看到如下日志。串口调试助手端会显示本地地址。如果没有看到下列日志，说明广播启动失败。请检查软件和硬件环境。
local bd addr: xx:xx:xx:xx:xx:xx
一条连线的测试流程如下:

Step

DUT user command

Description

DUT Log

1

escan 2 5

DUT scan mode设置为2，设备持续scanning的时间不能超过Duration参数。Scan PHYs设置为5 (LE 1M PHY和LE Coded PHY)。启动extended scanning且scanning时间不超过Duration，查看附近处于可发现状态且primary advertising channel是LE 1M PHY或LE Coded PHY的BLE设备的信息。

Serial port assistant tool shows:

GAP scan start

2

stopescan

DUT 停止extended scanning

Serial port assistant tool shows:

GAP scan stop

3

showdev

显示扫描设备列表

Serial port assistant tool shows:

dev list

……

RemoteBd[8] = [00:11:22:33:44:91]

……

4

condev 8 x001

对primary advertising channel为LE 1M PHY的connectable advertisements进行scan，并发起connection。Secondary advertising channel是LE 2M PHY，因此TX PHY和RX PHY类型均为LE 2M PHY。

Serial port assistant tool shows:

Connected success conn_id 0, tx_phy 2, rx_phy 2

5

showcon

显示连接信息

Serial port assistant tool shows:

conn_id 0 state 0x00000002 role 1

RemoteBd = [00:11:22:33:44:91] type = 0

active link num 1, idle link num 0

6

disc 0

与 Tester 断连

Serial port assistant tool shows:

Disconnect conn_id 0, dis_cause 0x00000116

7

condev 8 x001

与 Tester 回连

Serial port assistant tool shows:

Connected success conn_id 0, tx_phy 2, rx_phy 2

在上述 Step 2 中，当宏定义 APP_RECOMBINE_ADV_DATA 为1时，来自 Tester 的第一个advertising report如下。该advertising report表示 Tester 使用extended advertising PDUs发送Connectable Undirected Advertising，且primary advertising PHY是 LE 1M PHY ，secondary advertising PHY是 LE 2M PHY 。由于会收到更多的数据， DUT 启动重组流程并等待更多的数据。

[APP] app_gap_callback: cb_type = 0x50

[APP] !**GAP_MSG_LE_EXT_ADV_REPORT_INFO:connectable 1, scannable 0, direct 0, scan response 0, legacy 0, data status 0x1

[APP] !**GAP_MSG_LE_EXT_ADV_REPORT_INFO:event_type 0x1, bd_addr 00::11::22::33::44::00, addr_type 0, rssi -45, data_len 229

[APP] !**GAP_MSG_LE_EXT_ADV_REPORT_INFO:primary_phy 1, secondary_phy 2, adv_sid 0, tx_power 127, peri_adv_interval 0

[APP] !**GAP_MSG_LE_EXT_ADV_REPORT_INFO:direct_addr_type 0x0, direct_addr 00::00::00::00::00::00

[APP] !**app_handle_ext_adv_report: Old ext_adv_data->flag is 0, data status is 0x1

[APP] !**app_handle_ext_adv_report:First Data from bd_addr 00::11::22::33::44::00, data length is 229, and waiting more data

[APP] !**app_handle_ext_adv_report: New ext_adv_data->flag is 1

来自 Tester 最后一个advertising report如下。该advertising report表示数据是完整的。 Tester 完成advertising数据重组，来自 Tester 的advertising数据长度为 245 字节。

[APP] app_gap_callback: cb_type = 0x50

[APP] !**GAP_MSG_LE_EXT_ADV_REPORT_INFO:connectable 1, scannable 0, direct 0, scan response 0, legacy 0, data status 0x0

[APP] !**GAP_MSG_LE_EXT_ADV_REPORT_INFO:event_type 0x1, bd_addr 00::11::22::33::44::00, addr_type 0, rssi -45, data_len 16

[APP] !**GAP_MSG_LE_EXT_ADV_REPORT_INFO:primary_phy 1, secondary_phy 2, adv_sid 0, tx_power 127, peri_adv_interval 0

[APP] !**GAP_MSG_LE_EXT_ADV_REPORT_INFO:direct_addr_type 0x0, direct_addr 00::00::00::00::00::00

[APP] !**app_handle_ext_adv_report: Old ext_adv_data->flag is 1, data status is 0x0

[APP] !**app_handle_ext_adv_report: Data from bd_addr 00::11::22::33::44::00 is complete, event type is 0x1, total data length is 245

[APP] !**app_handle_ext_adv_report: First five datas are 0x2, 0x1, 0x5, 0x13, 0x9

[APP] !**app_handle_ext_adv_report: Last five datas are 0xd5, 0xd6, 0xd7, 0xd8, 0xd9

[APP] !**app_handle_ext_adv_report: New ext_adv_data->flag is 0

Primary Advertising Channel是LE Coded PHY，Secondary Advertising Channel是LE Coded PHY

测试步骤

使用MPTool将 DUT 地址设为[00:11:22:33:44:92]，然后编译Central Extended Scan示例工程并下载images至 DUT 。
首先，将 ADVERTISING_PHY 设为 APP_PRIMARY_CODED_SECONDARY_CODED 。使用MPTool将 Tester 地址设为[00:11:22:33:44:91]，然后编译Peripheral extended advertising示例工程并下载images至 Tester。更多信息请参见 LE Peripheral Extended ADV 中的编译和下载。

更多关于如何修改 蓝牙地址 的细节请查阅快速入门中的生成System Config File 。

测试步骤

按 Tester 上的 reset 键， Tester 将开始发送可连接的非定向广播。

如果成功启动广播，会打印下面的 DebugAnalyser 日志。如果没有看到下列日志，说明广播启动失败。请检查软件和硬件环境。
[APP] !**GAP_MSG_LE_EXT_ADV_ENABLE:cause 0x0
[APP] !**app_handle_ext_adv_state_evt: adv_handle = 0 oldState = 1
[APP] !**app_handle_ext_adv_state_evt: adv_handle = 0 newState = 2
[APP] !**EXT_ADV_STATE_ADVERTISING: adv_handle 0, cause 0x0

按 DUT 上的 reset 键，开发者可以在电脑的串口助手工具端输入用户命令。

如果 DUT 成功启动且 serial port assistant tool 配置成功，开发者会看到如下日志。串口调试助手端会显示本地地址。如果没有看到下列日志，说明广播启动失败。请检查软件和硬件环境。
local bd addr: xx:xx:xx:xx:xx:xx
一条连线的测试流程如下：

Step

DUT user command

Description

DUT Log

1

escan 0 5

DUT scan mode设置为0，设备持续scanning直到停止scanning。Scan PHYs设置为5 (LE 1M PHY和LE Coded PHY)。启动extended scanning，查看附近处于可发现状态且primary advertising channel是LE 1M PHY或LE Coded PHY的BLE设备的信息。

Serial port assistant tool shows:

GAP scan start

2

stopescan

DUT 停止extended scanning

Serial port assistant tool shows:

GAP scan stop

3

showdev

显示扫描设备列表

Serial port assistant tool shows:

dev list

……

RemoteBd[3] = [47:78:39:48:32:1a]

RemoteBd[4] = [00:11:22:33:44:91]

4

condev 4 x100

对primary advertising channel为LE Coded PHY的connectable advertisements进行scan，并发起connection。Secondary advertising channel是LE Coded PHY，因此TX PHY和RX PHY类型均为LE Coded PHY。

Serial port assistant tool shows:

Connected success conn_id 0, tx_phy 3, rx_phy 3

5

showcon

显示连接信息

Serial port assistant tool shows:

ShowCon conn_id 0 state 0x00000002 role 1

RemoteBd = [00:11:22:33:44:91] type = 0

active link num 1, idle link num 0

6

dis 0

与 Tester 断线

Serial port assistant tool shows:

Disconnect conn_id 0, dis_cause 0x00000116

7

condev 4 x100

与 Tester 回连

Serial port assistant tool shows:

Connected success conn_id 0, tx_phy 3, rx_phy 3

在上述 Step 2，当宏定义 APP_RECOMBINE_ADV_DATA 为1时，来自 Tester 的第一个advertising report如下。该advertising report表示 Tester 使用extended advertising PDUs发送可连接非定向广播，且primary advertising PHY是 LE Coded PHY ，secondary advertising PHY是 LE Coded PHY 。由于会收到更多的数据， Tester 启动重组流程并等待更多的数据。

[APP] app_gap_callback: cb_type = 0x50

[APP] !**GAP_MSG_LE_EXT_ADV_REPORT_INFO:connectable 1, scannable 0, direct 0, scan response 0, legacy 0, data status 0x1

[APP] !**GAP_MSG_LE_EXT_ADV_REPORT_INFO:event_type 0x1, bd_addr 00::11::22::33::44::00, addr_type 0, rssi -41, data_len 229

[APP] !**GAP_MSG_LE_EXT_ADV_REPORT_INFO:primary_phy 3, secondary_phy 3, adv_sid 0, tx_power 127, peri_adv_interval 0

[APP] !**GAP_MSG_LE_EXT_ADV_REPORT_INFO:direct_addr_type 0x0, direct_addr 00::00::00::00::00::00

[APP] !**app_handle_ext_adv_report: Old ext_adv_data->flag is 0, data status is 0x1

[APP] !**app_handle_ext_adv_report:First Data from bd_addr 00::11::22::33::44::00, data length is 229, and waiting more data

[APP] !**app_handle_ext_adv_report: New ext_adv_data->flag is 1

来自 Tester 最后一个advertising report如下。该advertising report表示数据是完整的。 DUT 完成advertising数据重组，来自 Tester 的advertising数据长度为 245 字节。

[APP] app_gap_callback: cb_type = 0x50

[APP] !**GAP_MSG_LE_EXT_ADV_REPORT_INFO:connectable 1, scannable 0, direct 0, scan response 0, legacy 0, data status 0x0

[APP] !**GAP_MSG_LE_EXT_ADV_REPORT_INFO:event_type 0x1, bd_addr 00::11::22::33::44::00, addr_type 0, rssi -41, data_len 16

[APP] !**GAP_MSG_LE_EXT_ADV_REPORT_INFO:primary_phy 3, secondary_phy 3, adv_sid 0, tx_power 127, peri_adv_interval 0

[APP] !**GAP_MSG_LE_EXT_ADV_REPORT_INFO:direct_addr_type 0x0, direct_addr 00::00::00::00::00::00

[APP] !**app_handle_ext_adv_report: Old ext_adv_data->flag is 1, data status is 0x0

代码介绍

本章将按照以下几个部分进行介绍：

源码路径。
BT Host介绍。
初始化中介绍可配参数和Bluetooth Host初始化。
GAP消息处理中介绍本示例工程的GAP消息处理。
GAP回调函数处理中介绍本示例工程的GAP回调函数处理。
Advertising数据重组中介绍Advertising数据重组的流程。

源码路径

工程目录: samples\bluetooth\ble_bt5_central\proj
源码目录: samples\bluetooth\ble_bt5_central\src

Central extended scan示例工程中的源文件当前被分为几个组，如下所示：

└── Project: bt5_central
    └── secure_only_app
        └── Device                   includes startup code
        ├── CMSE Library             Non-secure callable lib
        ├── Lib                      includes all binary symbol files that user application is built on
            ├── ROM_NS.lib
            └── lowerstack.lib
            └── rtl87x2g_sdk.lib
            └── gap_utils.lib
        ├── peripheral               includes all peripheral drivers and module code used by the application
        ├── Profile                  includes LE profiles or services used by the sample application
        └── APP                      includes the ble_bt5_central user application implementation
            ├── app_task.c
            ├── main.c
            ├── bt5_central_app.c
            ├── link_mgr.c
            ├── user_cmd.c
            ├── data_uart.c
            └── data_cmd_parse.c

示例工程使用与 bt_host_0_0 匹配的默认GAP lib，请参阅文档 BT Host Image 中的 GAP Lib的使用方法以获取更多信息。

BT Host介绍

示例工程使用 bt_host_0_0 中的默认BT Host image，更多信息可参阅 BT Host Image 。

关于BT Host所支持的蓝牙功能的详细信息，请参阅文件 bin\rtl87x2g\bt_host_image\bt_host_0_0\bt_host_config.h。

初始化

当EVB启动并且芯片复位时， main 函数将被调用，它执行以下初始化函数：

int main(void)
{
   board_init();
   le_gap_init(APP_MAX_LINKS);
   gap_lib_init();
   app_le_gap_init();
   pwr_mgr_init();
   task_init();
   os_sched_start();

   return 0;
 }

le_gap_init() 用于初始化GAP并配置链接个数。
app_le_gap_init() 用于初始化GAP参数，开发者可以自行配置以下参数：Device name和device appearance，LE Advertising Extensions参数，GAP Bond Manager参数（请参考 LE Host 章节 Device Name和Device Appearance的配置，章节 LE Advertising Extensions参数的配置，章节 Bond Manager参数的配置）。

void app_le_gap_init(void)
{
   /* Device name and device appearance */
   ......

   /* GAP Bond Manager parameters */
   ......

   /* LE Advertising Extensions parameters */
   bool use_extended = true;

   /* Allocate memory for recombining advertising data */
#if APP_RECOMBINE_ADV_DATA
   ext_adv_data = os_mem_zalloc(RAM_TYPE_DATA_ON, sizeof(T_EXT_ADV_DATA));
   ext_adv_data->flag = false;
#endif

   le_set_gap_param(GAP_PARAM_DEFAULT_DATA_LEN_MAX_TX_OCTETS, sizeof(max_data_len_tx_oct),
                   &max_data_len_tx_oct);
   le_set_gap_param(GAP_PARAM_DEFAULT_DATA_LEN_MAX_TX_TIME, sizeof(max_data_len_tx_time),
                   &max_data_len_tx_time);

   /* Set device name and device appearance */
   le_set_gap_param(GAP_PARAM_DEVICE_NAME, GAP_DEVICE_NAME_LEN, device_name);
   le_set_gap_param(GAP_PARAM_APPEARANCE, sizeof(appearance), &appearance);

   /* Setup the GAP Bond Manager */
   gap_set_param(GAP_PARAM_BOND_PAIRING_MODE, sizeof(auth_pair_mode), &auth_pair_mode);
   gap_set_param(GAP_PARAM_BOND_AUTHEN_REQUIREMENTS_FLAGS, sizeof(auth_flags), &auth_flags);
   gap_set_param(GAP_PARAM_BOND_IO_CAPABILITIES, sizeof(auth_io_cap), &auth_io_cap);
   gap_set_param(GAP_PARAM_BOND_OOB_ENABLED, sizeof(auth_oob), &auth_oob);
   le_bond_set_param(GAP_PARAM_BOND_FIXED_PASSKEY, sizeof(auth_fix_passkey), &auth_fix_passkey);
   le_bond_set_param(GAP_PARAM_BOND_FIXED_PASSKEY_ENABLE, sizeof(auth_use_fix_passkey),
                     &auth_use_fix_passkey);
   le_bond_set_param(GAP_PARAM_BOND_SEC_REQ_REQUIREMENT, sizeof(auth_sec_req_flags),
                     &auth_sec_req_flags);

   /* Use LE Advertising Extensions */
   le_set_gap_param(GAP_PARAM_USE_EXTENDED_ADV, sizeof(use_extended), &use_extended);

   /* Register gap message callback */
   le_register_app_cb(app_gap_callback);
}

更多关于LE GAP初始化和启动流程的信息可以查阅 LE Host 中的 GAP参数的初始化。

GAP消息处理

任何时候当APP从GAP层接收到GAP消息时，函数 app_handle_gap_msg 会被调用。更多关于GAP消息的信息可以查阅 LE Host 中的蓝牙状态消息。

当收到 GAP_MSG_LE_CONN_STATE_CHANGE 消息时，APP将更新link状态。

void app_handle_conn_state_evt(uint8_t conn_id, T_GAP_CONN_STATE new_state, uint16_t disc_cause)
{
   APP_PRINT_INFO4("app_handle_conn_state_evt: conn_id %d, conn_state(%d -> %d), disc_cause 0x%x",
                   conn_id, gap_conn_state, new_state, disc_cause);
   switch (new_state)
   {
   case GAP_CONN_STATE_DISCONNECTED:
       {
           if ((disc_cause != (HCI_ERR | HCI_ERR_REMOTE_USER_TERMINATE))
               && (disc_cause != (HCI_ERR | HCI_ERR_LOCAL_HOST_TERMINATE)))
           {
               APP_PRINT_ERROR1("app_handle_conn_state_evt: connection lost cause 0x%x", disc_cause);
           }
       }
       data_uart_print("Disconnect conn_id %d, dis_cause 0x%x\r\n", conn_id, disc_cause);
       break;
   case GAP_CONN_STATE_CONNECTED:
       {
           uint8_t tx_phy;
           uint8_t rx_phy;
           uint16_t conn_interval;
           uint16_t conn_latency;
           uint16_t conn_supervision_timeout;
           uint8_t  remote_bd[6];
           T_GAP_REMOTE_ADDR_TYPE remote_bd_type;
           le_get_conn_param(GAP_PARAM_CONN_INTERVAL, &conn_interval, conn_id);
           le_get_conn_param(GAP_PARAM_CONN_LATENCY, &conn_latency, conn_id);
           le_get_conn_param(GAP_PARAM_CONN_TIMEOUT, &conn_supervision_timeout, conn_id);
           le_get_conn_addr(conn_id, remote_bd, (uint8_t *)&remote_bd_type);
           APP_PRINT_INFO5("GAP_CONN_STATE_CONNECTED:remote_bd %s, remote_addr_type %d, conn_interval 0x%x, conn_latency 0x%x, conn_supervision_timeout 0x%x",
                           TRACE_BDADDR(remote_bd), remote_bd_type,
                           conn_interval, conn_latency, conn_supervision_timeout);

           le_get_conn_param(GAP_PARAM_CONN_TX_PHY_TYPE, &tx_phy, conn_id);
           le_get_conn_param(GAP_PARAM_CONN_RX_PHY_TYPE, &rx_phy, conn_id);
           data_uart_print("Connected success conn_id %d, tx_phy %d, rx_phy %d\r\n", conn_id, tx_phy, rx_phy);
       }
       break;
   default:
       break;
   }
   gap_conn_state = new_state;
 }

GAP回调函数处理

app_gap_callback() 用于处理GAP回调函数消息，更多关于GAP回调函数的信息参见 LE Host 中的 Bluetooth LE GAP回调函数。

若设备启动extended scan之后收到advertising数据或scan response数据，GAP层将使用 GAP_MSG_LE_EXT_ADV_REPORT_INFO 消息通知APP。示例代码如下：

T_APP_RESULT app_gap_callback(uint8_t cb_type, void *p_cb_data)
{
   T_APP_RESULT result = APP_RESULT_SUCCESS;
   T_LE_CB_DATA *p_data = (T_LE_CB_DATA *)p_cb_data;

   APP_PRINT_TRACE1("app_gap_callback: cb_type = 0x%x", cb_type);

   switch (cb_type)
   {
   case GAP_MSG_LE_EXT_ADV_REPORT_INFO:
      ......
      link_mgr_add_device(p_data->p_le_ext_adv_report_info->bd_addr,
                           p_data->p_le_ext_adv_report_info->addr_type);

#if APP_RECOMBINE_ADV_DATA
      if (!(p_data->p_le_ext_adv_report_info->event_type & GAP_EXT_ADV_REPORT_BIT_USE_LEGACY_ADV))
      {
            /* If the advertisement uses extended advertising PDUs, recombine advertising data. */
            app_handle_ext_adv_report(p_data->p_le_ext_adv_report_info->event_type,
                                    p_data->p_le_ext_adv_report_info->data_status, p_data->p_le_ext_adv_report_info->bd_addr,
                                    p_data->p_le_ext_adv_report_info->data_len, p_data->p_le_ext_adv_report_info->p_data);
      }
#endif
      break;
   ......
}

Advertising数据重组

Advertising数据的重组实现对一组advertising数据或scan response数据的重组，在下次重组之前会删除已重组的advertising数据。该重组流程可以作为开发同时重组多组advertising data的框架。

在GAP初始化时申请用于重组advertising数据的内存，示例代码如下:

void app_le_gap_init(void)
{
   ......
   /* Allocate memory for recombining advertising data */
#if APP_RECOMBINE_ADV_DATA
   ext_adv_data = os_mem_zalloc(RAM_TYPE_DATA_ON, sizeof(T_EXT_ADV_DATA));
   ext_adv_data->flag = false;
#endif
   ......
}
//Message data structure is T_EXT_ADV_DATA.
typedef struct
{
   uint8_t      bd_addr[GAP_BD_ADDR_LEN];           /**< remote BD */
   bool
   flag;                               /**< flag of recombining advertising data, true: recombining, false: waiting extended advertising PDUs */
   uint16_t     event_type;                         /**< advertising event type */
   uint16_t     data_len;                           /**< length of recombined advertising data */
   uint8_t      p_data[APP_MAX_EXT_ADV_TOTAL_LEN];  /**< recombined advertising data */
} T_EXT_ADV_DATA;

APP在 app_gap_callback() 中处理 GAP_MSG_LE_EXT_ADV_REPORT_INFO 消息，该消息表示收到advertising数据或scan response数据，处理流程参见 GAP回调函数处理。

若该extended advertising report表示使用的是extended advertising PDU，APP将调用 app_handle_ext_adv_report() 以重组advertising数据。以下章节描述advertising数据的重组流程，相关代码参见 bt5_central_app.c 的 app_handle_ext_adv_report() 函数。

GAP_EXT_ADV_EVT_DATA_STATUS_COMPLETE

GAP_EXT_ADV_EVT_DATA_STATUS_COMPLETE 表示数据是完整的。Data status为 GAP_EXT_ADV_EVT_DATA_STATUS_COMPLETE 的advertising report的处理流程如图所示：

GAP_EXT_ADV_EVT_DATA_STATUS_MORE

GAP_EXT_ADV_EVT_DATA_STATUS_MORE 表示数据是不完整的且将会收到更多的数据。Data status为 GAP_EXT_ADV_EVT_DATA_STATUS_MORE 的advertising report的处理流程如图所示：

在处理data status为 GAP_EXT_ADV_EVT_DATA_STATUS_MORE 的advertising report之后，APP需要等待advertising report以完成重组。data status为 GAP_EXT_ADV_EVT_DATA_STATUS_COMPLETE 的advertising report表示重组已完成。

GAP_EXT_ADV_EVT_DATA_STATUS_TRUNCATED

GAP_EXT_ADV_EVT_DATA_STATUS_TRUNCATED 表示数据是不完整，数据是截断的。若具有截断数据的advertising report是APP等待的report，APP将通过重置重组参数以终止当前的重组流程，并等待advertising report以启动下一次重组流程。