doc/connectivity/bluetooth/shell/audio/ccp.rst

Bluetooth: Call Control Profile Shell
#####################################

Call Control Server
*******************
The Call Control Server is a role that typically resides on devices that can make calls,
including calls from apps such as Skype, e.g. (smart)phones and PCs,
which are typically GAP Central devices.

Using the Call Control Server
=============================
The Server can be controlled locally, or by a remote device (when in a call). For
example a remote device may initiate a call to the server,
or the Server may initiate a call to remote device, without a client.

For all commands that take an optional :code:`index`, if the index is not supplied then it defaults
to :code:`0` which is the GTBS bearer.

.. code-block:: console

   ccp_call_control_server --help
   ccp_call_control_server - Bluetooth CCP Call Control Server shell commands
   Subcommands:
     init             : Initialize CCP Call Control Server
     set_bearer_name  : Set bearer name [index] <name>
     get_bearer_name  : Get bearer name [index]


Example Usage
=============

Setup
-----

.. code-block:: console

   uart:~$ bt init
   uart:~$ ccp_call_control_server init
   Registered GTBS bearer
   Registered bearer[1]
   uart:~$ bt connect xx:xx:xx:xx:xx:xx public

Setting and getting the bearer name
-----------------------------------

.. code-block:: console

   uart:~$ ccp_call_control_server get_bearer_name
   Bearer[0] name: Generic TBS
   uart:~$ ccp_call_control_server set_bearer_name "New name"
   Bearer[0] name: New name
   uart:~$ ccp_call_control_server get_bearer_name
   Bearer[0] name: New name
   uart:~$ ccp_call_control_server get_bearer_name 1
   Bearer[1] name: Telephone Bearer #1
   uart:~$ ccp_call_control_server set_bearer_name 1 "New TBS name"
   Bearer[1] name: New TBS name
   uart:~$ ccp_call_control_server get_bearer_name 1
   Bearer[1] name: New TBS name


Call Control Client
*******************
The Call Control Client is a role that typically resides on resource constrained devices such as
earbuds or headsets.

Using the Call Control Client
=============================
The Client can control a remote CCP server device.
For example a remote device may have an incoming call that can be accepted by the Client.

.. code-block:: console

   uart:~$ ccp_call_control_client --help
   ccp_call_control_client - Bluetooth CCP Call Control Client shell commands
   Subcommands:
     discover  : Discover GTBS and TBS on remote device

Example Usage when connected
============================

.. code-block:: console

   uart:~$ ccp_call_control_client discover
   Discovery completed with GTBS and 1 TBS bearers

.. code-block:: console

   uart:~$ ccp_call_control_client read_bearer_name
   Bearer 0x20046254 name: Generic TBS
   uart:~$ ccp_call_control_client read_bearer_name 1
   Bearer 0x20046256 name: Telephone Bearer #1