6.2 Multiprotocol Bluetooth® LE Provisioning MCC Component

Overview

Component Configuration

For the combo application configuration as “THREAD”, user can choose between Full Thread Device (FTD) or Minimal Thread Device (MTD) as the device roles. For the “MTD” selection, the user can enable the “Sleepy End Device” option to allow sleep mode in the “MTD”.

Project Generation with Component

This section is designed to guide users through the process of creating a Bluetooth LE+THREAD multiprotocol project using MPLAB Code Configurator.

This section provides details on the steps required to develop an application based on the Bluetooth LE Provisioning MCC component, using MCC.

1. Create a new MCC Harmony Project. For more details, refer to Creating a New MCC Harmony Project section from Related Links

2. From the “Device Resources” field, go to Harmony>Wireless>System Services>BLE PROVISIONING

   

3. Click on the plus symbol on the BLE PROVISIONING component, as illustrated in the above image.
4. Upon selection, user will receive a prompt for auto-activation and auto-connect request of different component dependencies. Select Yes to add all the dependent components and also for all attachment auto-connect requests.

   

   

   Right Click on TIME component on project graph for selecting the timer source (TMR>TC0), select any of the timer. The project graph will resemble the following image.

   

   

5. Click on the BLE PROVISIONING, and open Configuration Options to set up the component according to the needs. Follow the steps outlined in the Component Configuration section.

   

6. Click on the BLE Stack, open Configuration Options and,
   1. Expand BLE Stack>Generic Access Profile (GAP)>Advertising>Advertising Data> to ensure "Local Name" is disabled and “Service Data” is enabled. Update the “Service UUID” as 0xDAFE and “Service Data” as 0xFF03
   2. Expand BLE Stack>Generic Access Profile (GAP)>Advertising>Scan Response Data> to ensure "Local Name" is enabled
   3. Expand BLE Stack>Generic Access Profile (GAP)>Device Name to update the “Device Name” as per the application requirement.
   4. Expand BLE Stack>Generic Access Profile (GAP)>Advertising to update the “Advertising Interval” as per the application requirement.

   

7. If the device is enabled as “Sleep End Device”. Select Plugins:>Clock Configurations and configure as illustrated in the following image

   

   

   Open Project Graph, and click on the Device Support, open Configuration Options and,

   1. Expand Device Support>Enable PMU Mode Setting> to ensure "Enable PMU Mode Setting" is enabled and set the “PMU mode” to BUCK_PWM mode (PMU_MODE_BUCK_PWM) to achieve lower power consumption.

   

   Note: This step is applicable only if the device is enabled as a “Sleep End Device (SED)”.
8. If console prints is required, user can add a “CONSOLE” component to facilitate application console prints.

   1. Go to “Device Resources” field, and navigate to Libraries>Harmony>System Services and select CONSOLE

      

   2. In the project graph, right click on ◇ UART>Satisfiers>SERCOM0 to add and connect the SERCOM0 component.

      

   3. Click on the SERCOM0, open Configuration Options and, to change “Receive Pinout” and “Transmit Pinout” as illustrated in the following figure.

      

   4. Perform the following to configure the “SERCOM0” to enable the Direct High Speed.
      1. In Project Graph, click the System component to open Configuration Options.
      2. To locate “SERCOM0 Direct (High Speed) Pin Enable (SCOM0_HSEN)”, navigate to System>Device & Project Configuration>WBZ451 Device Configuration>Generate Fuse Settings>DEVCFG1
      3. Select DIRECT from the drop-down list as illustrated in the following figure.

      

9. Click on Generate Tab for code generation. Upon code generation, BLE provisioning Component related source files will be added to the project. For more details on code generation, refer to Code Generation section from Related Links.

10. Once generation completes the header and source files of BLE provision service will be added under project’s Header and Source files based on the configuration.

    

11. Manual code configurations is required for the following files:

    1. app.c File
       1. Open app.c file and include the header files app_prov.h (#include "app_prov/app_prov.h").
       2. In app.c file, within the APP_Tasks function add the following code snippet after the APP_BleStackInit() call, as illustrated in the following figure.

       APP_Prov_TRPS_Init();
       APP_Prov_TRPS_CommissionOnReset();

       

    2. app_ble_handler.c File
       1. Open app_ble_handler.c file (located in Source Files>app_ble>app_ble_handler.c), and include the header file app_ble_conn_handler.h (#include "../app_ble_conn_handler.h").
       2. In app_ble_handler.c file, within the APP_BleGapEvtHandler function add the following code snippet as illustrated in the following figure.

           APP_BleGapConnEvtHandler(p_event);
          

       3. In app_ble_handler.c file, within the APP_BleSmpEvtHandler function add the following code snippet as illustrated in the following figure.

             if (p_event->eventField.evtPairingComplete.status != BLE_SMP_PAIRING_SUCCESS)
                      {
                          BLE_GAP_Disconnect(p_event->eventField.evtPairingComplete.connHandle, GAP_DISC_REASON_REMOTE_TERMINATE);              
                      }

          

    3. app_trsps_handler.c File
       1. Open app_trsps_handler.c file (located in Source Files>app_ble>app_trsps_handler.c), and include the header file app_trps.h(#include "#include "app_trps/app_trps.h").
       2. In app_trsps_handler.c file, within the APP_TrspsEvtHandler() function add the following code snippet as illustrated in the following figure.

          APP_TRPS_EventHandler(p_event);

          

    4. app_user_edits.c File
       1. Comment out or remove the #error line. Update the freertos_hooks.c as mentioned in app_user_edits.c file. For more details , refer to Users Action section from Related Links.
    5. Switch to MPLAB X IDE window and Build Project. The project must compile successfully. If user encounters the following error “c:166: undefined reference to `g_adcTiming08” when adding the BLE Stack, enable the "Remove unused sections" option in the project properties under xc32-ld options.

       

       

Protocol Exchange