5.1.1.3 BLE Scanning Extended Advertisements

Recommended Readings

1. Getting Started with Application Building Blocks – See Building Block Examples from Related Links.

2. Getting Started with Peripheral Building Blocks – See Central Devices from Related Links.

3. FreeRTOS and BLE Stack Setup – See Central - FreeRTOS BLE Stack and App Initialize from Related Links.

4. BLE Software Specification – See MPLAB® Harmony Wireless BLE in Reference Documentation from Related Links.

Hardware Requirement

SDK Setup

Software Requirement

To install Tera Term tool, refer to the Tera Term web page in Reference Documentation from Related Links.

Smart phone App

None

Programming the Precompiled Hex File or Application Example

Using MPLAB® X IPE:

1. Central Device – Import and program the precompiled hex file: <Harmony Content Path>\wireless_apps_pic32_bz6\apps\ble\building_blocks\central\scan_ext_adv\precompiled_hex.
2. Peripheral Device – Import and program the precompiled hex file: <Harmony Content Path>\wireless_apps_pic32_bz6\apps\ble\building_blocks\peripheral\ext_adv\precompiled_hex.
3. For detailed steps, refer to Programming a Device in MPLAB® IPE in Reference Documentation from Related Links.
   Note: Ensure to choose the correct Device and Tool information.

Using MPLAB® X IDE:

1. Perform the following the steps mentioned in Running a Precompiled Example. For more information, refer to Running a Precompiled Application Example from Related Links.
2. Central Device – Open and program the application scan_ext_adv.X located in <Harmony Content Path>\wireless_apps_pic32_bz6\apps\ble\building_blocks\central\scan_ext_adv\firmware.
3. Peripheral Device – Open and program the application ext_adv.X located in <<Harmony Content Path>\wireless_apps_pic32_bz6\apps\ble\building_blocks\peripheral\ext_adv\firmware.

4. For more details on how to find the Harmony Content Path, refer to Installing the MCC Plugin from Related Links.

Demo Description

This application example enables users to do scanning of extended advertisements (ADV_EXT_IND, ADV_AUX_IND PDU's). Scanning of CODED PHY (125 kbps) is enabled by default in the application. After programming the application example, on Reset “ExtAdv Scan Enable Success” will be printed in the terminal window and if there is a broadcaster sending extended advertisements the Blue LED will toggle. If this broadcaster is another PIC32WM-BZ6204UE module programmed with “ext_adv.X” example it will print the application data sent in auxiliary packet - ADV_AUX_IND on TeraTerm. Toggling of Blue LED denotes the reception of extended advertisements.

Testing

Users must use another PIC32-BZ6 Curiosity board configured as BLE Extended Advertisements, see BLE Extended Advertisements from Related Links.

This section assumes that a user has already programmed the ext_adv and scan_ext_adv application on two PIC32-BZ6 Curiosity boards.

Data from advertiser is sent every 20 secs, Blue LED is toggled when the observer device receives these extended advertisements.

Developing the Application from Scratch using MCC

1. Create a new harmony project. For more details, see Creating a New MCC Harmony Project from Related Links.
2. Import component configuration – This step helps users setup the basic components and configuration required to develop this application. The imported file is of format .mc3 and is located in the path <Harmony Content Path>\wireless_apps_pic32_bz6\apps\ble\building_blocks\central\scan_ext_adv\firmware\scan_ext_adv.X\.
   Note: Import and export functionality of component configuration will help users to start from a known working setup of configuration.
3. Accept dependencies or satisfiers when prompted.
4. Verify if the project graph window has all the expected configuration.

   

Verifying Scan Configuration

1. Click on the BLE_Stack component in project graph, to open component configuration and configure as illustrated in the following figure.

   

Generating a Code

For more details on code generation, refer to MPLAB Code Configurator (MCC) Code Generation from Related Links.

Files and Routines Automatically Generated by the MCC

After generating the program source from MCC interface by clicking Generate Code, the BLE configuration can be found in the following project directories

Initialization routines for OSAL, RF System, and BLE System are auto-generated by the MCC. See OSAL Libraries Help in Reference Documentation from Related Links. Initialization routine executed during program initialization can be found in the project file.C.

The BLE stack initialization routine excuted during application initialization can be found in project files. This initialization routine is automatically generated by the MCC. This call initializes and configures the GAP, GATT, SMP, L2CAP and BLE middleware layers.

Configuration for scanning extended advertisements is autogenerated

Note: app.c is auto generated and has a state machine based application code sample. Users can use this template to develop their application.

Header Files

• ble_gap.h(Header Files\config\default\ble\lib\include\) - This header file contains BLE GAP functions and is automatically included in the app.c file

Function Calls

MCC generates and adds the code to initialize the BLE Stack GAP, GATT, L2CAP and SMP in APP_BleStackInit() function

• APP_BleStackInit() is the API that will be called inside the applications initial state APP_STATE_INIT in app.c

User Application Development

Include

• Include the user action. For more information, refer to User Action from Related Links.
• definitions.h in all the files where UART will be used to print debug information

Note: definitions.h is not specific to just UART peripheral, instead it must be included in all application source files where peripheral functionality will be exercised

Enabling Scanning of Extended Advertisement

• BLE_GAP_SetExtScanningEnable (BLE_GAP_SCAN_MODE_OBSERVER, &extScan);

API's mentioned in this section are called in the Applications initial state - APP_STATE_INIT in app.c

// Enable Scanning the Ext Adv
uint16_t ret;
BLE_GAP_ExtScanningEnable_T extScan;
extScan.duration = 0x0;
extScan.enable = true;
extScan.filterDuplicates = BLE_GAP_SCAN_FD_ENABLE;
extScan.period = 0x0000;
ret = BLE_GAP_SetExtScanningEnable(BLE_GAP_SCAN_MODE_OBSERVER, &extScan );
if (ret == MBA_RES_SUCCESS)
       SERCOM0_USART_Write((uint8_t *)"ExtAdv Scan Enable Success\r\n", 28);

Configuring LED

Open the “Pin Configuration”

Verify the following Pin Settings

Scanning Results

• BLE_GAP_EVT_EXT_ADV_REPORT event is generated upon finding advertisements on legacy channels

// code snippet to print ext adv data
    // GPIO will toggle if it can scan any EXT ADV PDU near based on BLE_GAP_SCAN_PHY chosen
    GPIOB_REGS->GPIO_PORTINV = 0x08;
    // length value of 19 is chosen as a filter as ext_adv example sends 19 bytes of data
    // user can modify filter mechanism based on their requirements
    if (p_event->eventField.evtExtAdvReport.length == 19)
    {
        SERCOM0_USART_Write((uint8_t *)"\r\n", 2);
        SERCOM0_USART_Write(&p_event->eventField.evtExtAdvReport.advData[5], 9);
    }

Where to Go from Here

See Central Devices from Related Links.