zephyr

History

Emil Gydesen 3e634268d6 Bluetooth: ISO: Introduce bt_iso_chan_send_ts The bt_iso_chan_send function could take an optional timestamp by using 0 as an indicator. The issue with this approach was that a timestamp value of 0 is valid, and could cause potential issue with syncing streams in a group. To fully support transmitting with and without timestamp, bt_iso_chan_send_ts has been introduced, which is the only function of the two (bt_iso_chan_send being the other) that supports timestamps. A new function, rather than adding a boolean to the existing, was chosen as it simplifies the individual functions as well as making it more explicit what the function does. Since the bt_iso_chan_send function is used by LE audio, both the BAP and CAP send functions have similarly been updated. Likewise, all tests and samples have been updated to use the updated function(s), and BT_ISO_TIMESTAMP_NONE has been removed. Signed-off-by: Emil Gydesen <emil.gydesen@nordicsemi.no>		2024-02-12 13:13:10 +01:00
..
boards	…
src	Bluetooth: ISO: Introduce bt_iso_chan_send_ts	2024-02-12 13:13:10 +01:00
CMakeLists.txt	…
Kconfig.sysbuild	samples/bluetooth: sysbuild: Add Kconfig setting for HCI IPC inclusion	2023-11-27 12:19:56 +00:00
README.rst	…
overlay-bt_ll_sw_split.conf	…
prj.conf	Bluetooth: audio: ascs: Retry ASE state notifications on error	2023-11-15 10:03:07 +01:00
sample.yaml	…
sysbuild.cmake	samples/bluetooth: Reduce sysbuild boilerplate	2023-12-02 07:53:11 -05:00

README.rst

.. _bluetooth_unicast_audio_server:

Bluetooth: Unicast Audio Server
###############################

Overview
********

Application demonstrating the LE Audio unicast server functionality.
Starts advertising and awaits connection from a LE Audio unicast client.

This sample can be found under
:zephyr_file:`samples/bluetooth/unicast_audio_server` in the Zephyr tree.

Check the :ref:`bluetooth samples section <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 `-DOVERLAY_CONFIG=overlay-bt_ll_sw_split.conf` to enable the required ISO
feature support.

Building for an nrf52840dk
--------------------------

.. zephyr-app-commands::
:zephyr-app: samples/bluetooth/unicast_audio_server/
:board: nrf52840dk_nrf52840
:goals: build
:gen-args: -DOVERLAY_CONFIG=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:

.. zephyr-app-commands::
:zephyr-app: samples/bluetooth/unicast_audio_server/
:board: nrf5340dk_nrf5340_cpuapp
:goals: build
:west-args: --sysbuild

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

.. zephyr-app-commands::
:zephyr-app: samples/bluetooth/unicast_audio_server/
:board: nrf5340dk_nrf5340_cpuapp
:goals: build

In that case you can pair this application core image with the
:ref:`hci_ipc sample <bluetooth-hci-ipc-sample>`
:zephyr_file:`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:

.. zephyr-app-commands::
:zephyr-app: samples/bluetooth/unicast_audio_server/
:board: nrf52_bsim
:goals: build
:gen-args: -DOVERLAY_CONFIG=overlay-bt_ll_sw_split.conf

Note this will produce a Linux executable in `./build/zephyr/zephyr.exe`.
For more information, check :ref:`this board documentation <nrf52_bsim>`.

Building for a simulated nrf5340bsim
------------------------------------

.. zephyr-app-commands::
:zephyr-app: samples/bluetooth/unicast_audio_server/
:board: nrf5340bsim_nrf5340_cpuapp
:goals: build
:west-args: --sysbuild