.. _buttons_sample:

Buttons
#######

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

The Buttons sample demonstrates how to configure and use buttons with event handling on the nRF54L15 DK.

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


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

Button 0:
  Prints out an event message.

Button 1:
  Prints out an event message.

Button 2:
  Prints out an event message.

Button 3:
  Prints out an event message and terminates the program.

LED 0:
   Lit when the device is initialized.

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

This sample can be found under :file:`samples/peripherals/buttons/` 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 by performing the following steps:

1. Compile and program the application.
#. Observe that the ``Buttons sample started`` message is printed.
#. Observe that the ``Buttons sample initialized, press Button 3 to terminate`` message is printed.
#. Press the buttons on the development kit.
   Observe the application printing a message when the buttons are pressed.
#. Press Button 3 on the development kit to terminate the application.