1.. zephyr:code-sample:: bluetooth_hci_ipc
2   :name: HCI IPC
3   :relevant-api: hci_raw bluetooth
4
5   Expose a Bluetooth controller to another device or CPU using the IPC subsystem.
6
7Overview
8********
9
10This sample exposes :ref:`bluetooth_controller` support
11to another device or CPU using IPC subsystem.
12
13Requirements
14************
15
16* A board with IPC subsystem and Bluetooth LE support
17
18Building and Running
19********************
20
21This sample can be found under :zephyr_file:`samples/bluetooth/hci_ipc`
22in the Zephyr tree.
23
24To use this application, you need a board with a Bluetooth controller
25and IPC support.
26You can then build this application and flash it onto your board in
27the usual way. See :ref:`boards` for board-specific building and
28programming information.
29
30To test this sample, you need a separate device/CPU that acts as Bluetooth
31HCI IPC peer.
32This sample is compatible with the HCI IPC driver provided by
33Zephyr's Bluetooth :ref:`bt_hci_drivers` core. See the
34:kconfig:option:`CONFIG_BT_HCI_IPC` configuration option for more information.
35
36You might need to adjust the Kconfig configuration of this sample to make it
37compatible with the peer application. For example, :kconfig:option:`CONFIG_BT_MAX_CONN`
38must be equal to the maximum number of connections supported by the peer application.
39
40Refer to :zephyr:code-sample-category:`bluetooth` for general information about Bluetooth samples.
41