Skip to content

README.rst

Latest commit

 

History

History
127 lines (97 loc) · 4.44 KB

README.rst

File metadata and controls

127 lines (97 loc) · 4.44 KB
Raw
.. ncs-sample::
   :title: Bluetooth: Channel Classification

This sample demonstrates LE Channel Classification reporting between a central and a peripheral.

Requirements

The sample supports the following development kits:

.. table-from-sample-yaml::

You can use any combination of the development kits mentioned above in your testing setup.

Additionally, the sample requires a connection to a computer with a serial terminal for each of the development kits.

Overview

When connected, the peripheral cycles through predefined host channel maps, changing every five seconds.

The central enables channel classification reporting using :c:func:`hci_vs_sdc_channel_reporting_enable` and handles the received reports in a local HCI VS event callback.

Building and running

Testing

After programming the sample to both development kits, test it by performing the following steps:

  1. Connect to both kits with a terminal emulator (for example, the `Serial Terminal app`_). See :ref:`test_and_optimize` for the required settings and steps.
  2. Reset both kits.
  3. In one of the terminal emulators, type c to start the application on the connected board in the central role.
  4. In the other terminal emulator, type p to start the application in the peripheral role.
  5. Observe that the kits establish a connection.
  6. On the peripheral, observe a new channel map printed every five seconds.
  7. On the central, observe matching channel maps applied from the received classification reports.

Sample output

  • Example peripheral output:

    *** Booting nRF Connect SDK v3.4.99-b15b0977d5d7 ***
*** Using Zephyr OS v4.4.99-bf52a9edec7e ***
I: Starting Bluetooth Channel Classification sample
I: SoftDevice Controller build revision:
I: 2e 0b 04 cf 06 5e 2e 8f |.....^..
I: a8 14 89 4d b6 1b 7a 8c |...M..z.
I: d4 e4 bb 1f             |....
I: HW Platform: Nordic Semiconductor (0x0002)
I: HW Variant: nRF54Lx (0x0005)
I: Firmware: Standard Bluetooth controller (0x00) Version 46.1035 Build 777914063
I: HCI transport: SDC
I: Identity: E9:A2:74:BE:64:BA (random)
I: HCI: version 6.3 (0x11) revision 0x306a, manufacturer 0x0059
I: LMP: version 6.3 (0x11) subver 0x306a
I: Bluetooth initialized
I: Choose device role - type c (central) or p (peripheral):
I:
I: Selected Peripheral
I: Advertising successfully started
I: Connected as peripheral
I: Using channel map 0
I: Peripheral channel map ff ff ff ff 1f
I: Using channel map 1
I: Peripheral channel map ff fb ef bf 1f
I: Using channel map 2
I: Peripheral channel map df 7f ff fd 1f

  • Example central output:

    *** Booting nRF Connect SDK v3.4.99-b15b0977d5d7 ***
*** Using Zephyr OS v4.4.99-bf52a9edec7e ***
I: Starting Bluetooth Channel Classification sample
I: SoftDevice Controller build revision:
I: 2e 0b 04 cf 06 5e 2e 8f |.....^..
I: a8 14 89 4d b6 1b 7a 8c |...M..z.
I: d4 e4 bb 1f             |....
I: HW Platform: Nordic Semiconductor (0x0002)
I: HW Variant: nRF54Lx (0x0005)
I: Firmware: Standard Bluetooth controller (0x00) Version 46.1035 Build 777914063
I: HCI transport: SDC
I: Identity: F1:6C:D4:5E:80:EA (random)
I: HCI: version 6.3 (0x11) revision 0x306a, manufacturer 0x0059
I: LMP: version 6.3 (0x11) subver 0x306a
I: Bluetooth initialized
I: Choose device role - type c (central) or p (peripheral):
I:
I: Selected Central
I: Scanning successfully started
I: Filters matched. Address: E9:A2:74:BE:64:BA (random) connectable: 1
I: Connected as central
I: Channel classification reporting enabled
I: Central channel map from report ff ff ff ff 1f
I: Central applied peripheral channel classification
I: Central channel map from report ff fb ef bf 1f
I: Central applied peripheral channel classification
I: Central channel map from report df 7f ff fd 1f

Dependencies

This sample uses the following |NCS| library:

This sample uses the following `sdk-nrfxlib`_ libraries:

In addition, it uses the following Zephyr libraries: