1.. zephyr:code-sample-category:: bluetooth
2   :name: Bluetooth
3
4   These samples demonstrate the use of Bluetooth in Zephyr.
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 :ref:`native_sim <native_sim>` 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_sim``), 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   :zephyr:code-sample:`bluetooth_hci_ipc` 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.. zephyr:code-sample-listing::
33   :categories: bluetooth
34   :live-search:
35