.. _ble_radio_ntf_sample:

Bluetooth: Radio Notifications
##############################

.. contents::
   :local:
   :depth: 2

The Radio Notification sample demonstrates how you can use the :ref:`lib_ble_radio_notification` library using |BMlong|.

Requirements
************

The sample supports the following development kits:

.. tabs::

   .. group-tab:: Simple board variants

      The following board variants do **not** have DFU capabilities:

      .. include:: /includes/supported_boards_all_non-mcuboot_variants_s115.txt

      .. include:: /includes/supported_boards_all_non-mcuboot_variants_s145.txt

   .. group-tab:: MCUboot board variants

      The following board variants have DFU capabilities:

      .. include:: /includes/supported_boards_all_mcuboot_variants_s115.txt

      .. include:: /includes/supported_boards_all_mcuboot_variants_s145.txt

Overview
********

The sample initializes the radio notification library and registers a handler that triggers both when the radio is enabled and when it is disabled.
The handler then toggles **LED 2** based on the current state of the radio.

User interface
**************

LED 0:
  Lit when the device is initialized.

LED 1:
  Lit when a device is connected.

LED 2:
  ON when a "radio on" notification is received, OFF when a "radio off" notification is received.

Building and running
********************

This sample can be found under :file:`samples/bluetooth/ble_radio_notification/` in the |BMshort| folder structure.

For details on how to create, configure, and program a sample, see :ref:`getting_started_with_the_samples`.

Testing
=======

You can test this sample using `nRF Connect for Desktop`_ with the `Serial Terminal app`_.
Make sure that these are installed before starting the testing procedure.

1. Compile and program the application.
#. In the Serial Terminal, observe that the ``BLE Radio Notification sample initialized`` message is printed.
#. Observe that the **LED 2** blinks while the device is advertising and the radio is active.
#. Observe that the **LED 2** stops blinking when advertising stops.