1.. _bluetooth-samples:
2
3Bluetooth samples
4#################
5
6To build any of the Bluetooth samples, follow the same steps as building
7any other Zephyr application. Refer to :ref:`bluetooth-dev` for more information.
8
9Many Bluetooth samples can be run on QEMU or Native POSIX with support for
10external Bluetooth Controllers. Refer to the :ref:`bluetooth-hw-setup` section
11for further details.
12
13Several of the bluetooth samples will build a Zephyr-based Controller that can
14then be used with any external Host (including Zephyr running natively or with
15QEMU or Native POSIX), those are named accordingly with an "HCI" prefix in the
16documentation and are prefixed with :literal:`hci_` in their folder names.
17
18.. note::
19   If you want to run any bluetooth sample on the nRF5340 device (build using
20   ``-DBOARD=nrf5340dk_nrf5340_cpuapp`` or
21   ``-DBOARD=nrf5340dk_nrf5340_cpuapp_ns``) you must also build
22   and program the corresponding sample for the nRF5340 network core
23   :ref:`bluetooth-hci-rpmsg-sample` which implements the Bluetooth
24   Low Energy controller.
25
26.. note::
27   The mutually-shared encryption key created during host-device paring may get
28   old after many test iterations.  If this happens, subsequent host-device
29   connections will fail. You can force a re-paring and new key to be created
30   by removing the device from the associated devices list on the host.
31
32.. toctree::
33   :maxdepth: 1
34   :glob:
35
36   **/*
37