The latest development version of this page may be more current than this released 4.0.0 version.

Basic Audio Profile (BAP) Unicast Audio Client

Browse source code on GitHub

Overview

Application demonstrating the BAP Unicast Client functionality. Scans for and connects to a BAP Unicast Server and establishes an audio stream.

This sample can be found under samples/bluetooth/bap_unicast_client in the Zephyr tree.

Check the Bluetooth samples for general information.

Requirements

  • BlueZ running on the host, or

  • A board with Bluetooth Low Energy 5.2 support

Building and Running

When building targeting an nrf52 series board with the Zephyr Bluetooth Controller, use -DEXTRA_CONF_FILE=overlay-bt_ll_sw_split.conf to enable the required ISO feature support.

Building for an nrf52840dk

# From the root of the zephyr repository
west build -b nrf52840dk/nrf52840 samples/bluetooth/bap_unicast_client/ -- -DEXTRA_CONF_FILE=overlay-bt_ll_sw_split.conf

Building for an nrf5340dk

You can build both the application core image and an appropriate controller image for the network core with:

# From the root of the zephyr repository
west build -b nrf5340dk/nrf5340/cpuapp --sysbuild samples/bluetooth/bap_unicast_client/

If you prefer to only build the application core image, you can do so by doing instead:

# From the root of the zephyr repository
west build -b nrf5340dk/nrf5340/cpuapp samples/bluetooth/bap_unicast_server/

In that case you can pair this application core image with the HCI IPC sample samples/bluetooth/hci_ipc/nrf5340_cpunet_iso-bt_ll_sw_split.conf configuration.

Building for a simulated nrf52_bsim

Similarly to how you would for real HW, you can do:

# From the root of the zephyr repository
west build -b nrf52_bsim samples/bluetooth/bap_unicast_client/ -- -DEXTRA_CONF_FILE=overlay-bt_ll_sw_split.conf

Note this will produce a Linux executable in ./build/zephyr/zephyr.exe. For more information, check this board documentation.

Building for a simulated nrf5340bsim

# From the root of the zephyr repository
west build -b nrf5340bsim/nrf5340/cpuapp --sysbuild samples/bluetooth/bap_unicast_client/

See also

Bluetooth APIs
Bluetooth Audio
Bluetooth Basic Audio Profile
Connection management