Bluetooth: A2DP Shell - Zephyr

Bluetooth: A2DP Shell #####################

The :code:a2dp command exposes parts of the A2DP API.

The following examples assume that you have two devices already connected.

.. _a2dp_conn_disconn:

A2DP Connection

Demonstrate the flow of creating an A2DP connection:

Both sides register A2DP callbacks using :code:a2dp register_cb.
Either side establishes an A2DP connection, which will create the AVDTP Signaling channel, using :code:a2dp connect.
Either side can get the ACL connection using :code:a2dp get_conn.
Either side can disconnect the A2DP connection using :code:a2dp disconnect.

.. tabs::

    .. group-tab:: Device A (initiator)

            .. code-block:: console

                    uart:~$ a2dp register_cb
                    success
                    uart:~$ a2dp connect
                    Bonded with XX:XX:XX:XX:XX:XX
                    Security changed: XX:XX:XX:XX:XX:XX level 2
                    a2dp connected
                    uart:~$ a2dp get_conn
                    a2dp conn is: 0xXXXXXXXX
                    uart:~$ a2dp disconnect
                    a2dp disconnected

    .. group-tab:: Device B (acceptor)

            .. code-block:: console

                    uart:~$ a2dp register_cb
                    success
                    <input `a2dp connect` in initiator side>
                    Connected: XX:XX:XX:XX:XX:XX
                    Bonded with XX:XX:XX:XX:XX:XX
                    Security changed: XX:XX:XX:XX:XX:XX level 2
                    a2dp connected
                    <input `a2dp disconnect` in initiator side>
                    a2dp disconnected

.. _a2dp_basic_operations:

Basic A2DP Operations

Demonstrate the flow of basic A2DP operations:

Source and Sink sides register stream endpoints using :code:a2dp register_ep source sbc and :code:a2dp register_ep sink sbc.
Create an A2DP connection based on :ref:a2dp connection <a2dp_conn_disconn>.
Initiator discovers remote device's stream endpoints using :code:a2dp discover_peer_eps 0x0104.
Initiator configures the stream to create the stream after discovering remote endpoints using :code:a2dp configure.
Initiator establishes the stream using :code:a2dp establish.
Sink sends delay report using :code:a2dp send_delay_report.
Initiator starts the media using :code:a2dp start.
Source tests media sending using :code:a2dp send_media to send one test packet data.
Initiator suspends the media using :code:a2dp suspend.
Initiator releases the media using :code:a2dp release.

.. note:: The initiator is the A2DP source role and the acceptor is the A2DP sink role in the following logs. The delay report can only be sent by the sink role. The media data can only be sent by the source role.

.. tabs::

    .. group-tab:: Device A (initiator)

            .. code-block:: console

                    uart:~$ a2dp register_ep source sbc
                    SBC source endpoint is registered
                    uart:~$ a2dp discover_peer_eps 0x0104
                    endpoint id: 1, (sink), (idle):
                      codec type: SBC
                      sample frequency:
                              44100
                              48000
                      channel mode:
                              Mono
                              Stereo
                              Joint-Stereo
                      Block Length:
                              16
                      Subbands:
                              8
                      Allocation Method:
                              Loudness
                      Bitpool Range: 18 - 35
                    uart:~$ a2dp configure
                    success to configure
                    stream configured
                    uart:~$ a2dp establish
                    success to establish
                    stream established
                    <input `a2dp send_delay_report` in sink side>
                    receive delay report and accept
                    received delay report: 1 1/10ms
                    uart:~$ a2dp start
                    success to start
                    stream started
                    uart:~$ a2dp send_media
                    frames num: 1, data length: 160
                    data: 1, 2, 3, 4, 5, 6 ......
                    uart:~$ a2dp suspend
                    success to suspend
                    stream suspended
                    uart:~$ a2dp release
                    success to release
                    stream released

    .. group-tab:: Device B (acceptor)

            .. code-block:: console

                    uart:~$ a2dp register_ep sink sbc
                    SBC sink endpoint is registered
                    <input `a2dp configure` in initiator side>
                    receive requesting config and accept
                    sample rate 44100Hz
                    stream configured
                    <input `a2dp establish` in initiator side>
                    receive requesting establishment and accept
                    stream established
                    uart:~$ a2dp send_delay_report
                    success to send report delay
                    <input `a2dp start` in initiator side>
                    receive requesting start and accept
                    stream started
                    <input `a2dp send_media` in source side>
                    received, num of frames: 1, data length: 160
                    data: 1, 2, 3, 4, 5, 6 ......
                    <input `a2dp suspend` in initiator side>
                    receive requesting suspend and accept
                    stream suspended
                    <input `a2dp release` in initiator side>
                    receive requesting release and accept
                    stream released

Abort Operation

Demonstrate the abort operation:

Establish an A2DP stream based on :ref:basic a2dp operations <a2dp_basic_operations>.
Initiator aborts the stream using :code:a2dp abort.

.. tabs::

    .. group-tab:: Device A (initiator)

            .. code-block:: console

                    uart:~$ a2dp abort
                    success to abort
                    stream released

    .. group-tab:: Device B (acceptor)

            .. code-block:: console

                    <input `a2dp abort` in initiator side>
                    receive requesting abort and accept
                    stream released

Get Configuration and Reconfigure Operation

Demonstrate the get configuration and reconfigure operations:

Establish an A2DP stream based on :ref:basic a2dp operations <a2dp_basic_operations>.
Initiator gets configuration using :code:a2dp get_config.
Initiator reconfigures the stream using :code:a2dp reconfigure.

.. tabs::

    .. group-tab:: Device A (initiator)

            .. code-block:: console

                    uart:~$ a2dp get_config
                    get config result: 0
                    sample rate 44100Hz
                    uart:~$ a2dp reconfigure
                    success to configure
                    stream configured

    .. group-tab:: Device B (acceptor)

            .. code-block:: console

                    <input `a2dp get_config` in initiator side>
                    receive get config request and accept
                    <input `a2dp reconfigure` in initiator side>
                    receive requesting reconfig and accept
                    sample rate 44100Hz
                    stream configured