README.rst
1.. zephyr:code-sample:: bluetooth_bap_broadcast_source
2 :name: Basic Audio Profile (BAP) Broadcast Audio Source
3 :relevant-api: bluetooth bt_audio bt_bap
4
5 Use BAP Broadcast Source functionality.
6
7Overview
8********
9
10Application demonstrating the BAP Broadcast Source functionality.
11Will start advertising extended advertising with audio flags, periodic advertising with the
12Broadcast Audio Source Endpoint (BASE) and finally the BIGinfo together with
13(mock) Audio (ISO) data.
14
15The BAP Broadcast Source will reset every 30 seconds to show the full API.
16
17Check the :zephyr:code-sample-category:`bluetooth` samples for general information.
18
19Requirements
20************
21
22* BlueZ running on the host, or
23* A board with Bluetooth Low Energy 5.2 support
24
25Building and Running
26********************
27
28When building targeting an nrf52 series board with the Zephyr Bluetooth Controller,
29use ``-DEXTRA_CONF_FILE=overlay-bt_ll_sw_split.conf`` to enable the required ISO
30feature support.
31The sample defaults to sequential packing of BIS subevents, add
32``-DCONFIG_ISO_PACKING_INTERLEAVED=y`` to use interleaved packing.
33
34Building for an nrf5340dk
35-------------------------
36
37You can build both the application core image and an appropriate controller image for the network
38core with:
39
40.. zephyr-app-commands::
41 :zephyr-app: samples/bluetooth/bap_broadcast_source/
42 :board: nrf5340dk/nrf5340/cpuapp
43 :goals: build
44 :west-args: --sysbuild
45
46If you prefer to only build the application core image, you can do so by doing instead:
47
48.. zephyr-app-commands::
49 :zephyr-app: samples/bluetooth/bap_broadcast_source/
50 :board: nrf5340dk/nrf5340/cpuapp
51 :goals: build
52
53In that case you can pair this application core image with the
54:zephyr:code-sample:`bluetooth_hci_ipc` sample
55:zephyr_file:`samples/bluetooth/hci_ipc/nrf5340_cpunet_iso-bt_ll_sw_split.conf` configuration.
56
57Building for a simulated nrf5340bsim
58------------------------------------
59
60Similarly to how you would for real HW, you can do:
61
62.. zephyr-app-commands::
63 :zephyr-app: samples/bluetooth/bap_broadcast_source/
64 :board: nrf5340bsim/nrf5340/cpuapp
65 :goals: build
66 :west-args: --sysbuild
67
68Note this will produce a Linux executable in :file:`./build/zephyr/zephyr.exe`.
69For more information, check :ref:`this board documentation <nrf5340bsim>`.
70
71Building for a simulated nrf52_bsim
72-----------------------------------
73
74.. zephyr-app-commands::
75 :zephyr-app: samples/bluetooth/bap_broadcast_source/
76 :board: nrf52_bsim
77 :goals: build
78 :gen-args: -DEXTRA_CONF_FILE=overlay-bt_ll_sw_split.conf
79
