BLE Periodic Advertisement Sync Example

Source code path: example/ble/periodic_adv_sync

Supported Platforms

This example demonstrates the usage of periodic advertisement synchronization.

After boot, use finsh command “diss sync create” to create periodic advertisement sync. If created successfully, you can see “PER_ADV_SYNC created [idx]” in the log, where idx is the allocated handle.
Use finsh command “diss scan start [is_dup] [scan_interval] [scan_window] [duration]” to start scan to search for periodic advertisements.
1. Command example: “diss scan start 1 60 30 30000”. This command will scan continuously for 30 seconds.
2. If a periodic advertisement is found, it will print “Periodic adv found addr_type [type], addr:0xXX:XX:XX:XX:XX:XX, adv_sid:[adv_sid]”.
To establish periodic advertisement synchronization, use finsh command “diss sync start [addr] [addr_type] [adv_sid] [sync_to]”, where addr, addr_type and adv_sid are the address, address type and advertisement SID printed after finding the periodic advertisement; sync_to represents the sync timeout in units of 10ms
1. Example: “diss sync start be:56:44:33:22:c2 0 0 80”
2. Since establishing periodic advertisement sync requires scan to be enabled, the 30-second scan set by the previous command may have stopped when establishing periodic advertisement sync. If scan has stopped, you can see “Scan stopped” in the log. When scan is stopped, you need to restart scan.
3. After periodic advertisement sync is established, it will print “PER_ADV_SYNC established(addr)” and “per_adv_data:”

Before running this example, prepare:

Enable Bluetooth (BLUETOOTH):
- Path: Sifli middleware → Bluetooth
- Enable: Enable bluetooth
  - Macro switch: CONFIG_BLUETOOTH
  - Description: Enables Bluetooth functionality
Enable GAP Central:

Path: Sifli middleware → Bluetooth → Bluetooth service → BLE service
- Enable: Enable BLE GAP central role
  - Macro switch: CONFIG_BLE_GAP_CENTRAL
  - Description: Switch for BLE CENTRAL (central device). When enabled, it provides scanning and active connection initiation with peripherals.

Enable NVDS:
- Path: Sifli middleware → Bluetooth → Bluetooth service → Common service
- Enable: Enable NVDS synchronous
  - Macro switch: CONFIG_BSP_BLE_NVDS_SYNC
  - Description: Bluetooth NVDS synchronization. When Bluetooth is configured to HCPU, BLE NVDS can be accessed synchronously, so enable this option; when Bluetooth is configured to LCPU, this option needs to be disabled.

Switch to the example project directory and run the scons command to compile:

> scons --board=eh-lb525 -j32

Switch to the example project/build_xx directory and run uart_download.bat, then select the port as prompted to download:

$ ./uart_download.bat

     Uart Download

please input the serial port num:5

For detailed compilation and download steps, please refer to the Quick Start Guide.

After the example starts:

It can search for periodic advertisements and establish periodic advertisement synchronization.