CCP Call Control Server APIs

Functions
int	bt_ccp_call_control_server_register_bearer (const struct bt_tbs_register_param *param, struct bt_ccp_call_control_server_bearer **bearer)
	Register a Telephone Bearer.
int	bt_ccp_call_control_server_unregister_bearer (struct bt_ccp_call_control_server_bearer *bearer)
	Unregister a Telephone Bearer.
int	bt_ccp_call_control_server_set_bearer_provider_name (struct bt_ccp_call_control_server_bearer *bearer, const char *name)
	Set a new bearer provider name.
int	bt_ccp_call_control_server_get_bearer_provider_name (struct bt_ccp_call_control_server_bearer *bearer, const char **name)
	Get the bearer provider name.

Detailed Description

Function Documentation

bt_ccp_call_control_server_get_bearer_provider_name()

int bt_ccp_call_control_server_get_bearer_provider_name	(	struct bt_ccp_call_control_server_bearer *	bearer,
		const char **	name )

#include <zephyr/bluetooth/audio/ccp.h>

Get the bearer provider name.

Parameters

[in]	bearer	The bearer to get the name for.
[out]	name	Pointer that will be updated to be the bearer provider name.

Return values

0	Success
-EINVAL	bearer or name is NULL
-EFAULT	bearer is not registered

bt_ccp_call_control_server_register_bearer()

int bt_ccp_call_control_server_register_bearer	(	const struct bt_tbs_register_param *	param,
		struct bt_ccp_call_control_server_bearer **	bearer )

#include <zephyr/bluetooth/audio/ccp.h>

Register a Telephone Bearer.

This will register a Telephone Bearer Service (TBS) (or a Generic Telephone Bearer service (GTBS)) with the provided parameters.

As per the TBS specification, the GTBS shall be instantiated for the feature, and as such a GTBS shall always be registered before any TBS can be registered. Similarly, all TBS shall be unregistered before the GTBS can be unregistered with bt_ccp_call_control_server_unregister_bearer().

Parameters

[in]	param	The parameters to initialize the bearer.
[out]	bearer	Pointer to the initialized bearer.

Return values

0	Success
-EINVAL	param contains invalid data
-EALREADY	param.gtbs is true and GTBS has already been registered
-EAGAIN	param.gtbs is false and GTBS has not been registered
-ENOMEM	param.gtbs is false and no more TBS can be registered (see CONFIG_BT_TBS_BEARER_COUNT)
-ENOEXEC	The service failed to be registered

bt_ccp_call_control_server_set_bearer_provider_name()

int bt_ccp_call_control_server_set_bearer_provider_name	(	struct bt_ccp_call_control_server_bearer *	bearer,
		const char *	name )

#include <zephyr/bluetooth/audio/ccp.h>

Set a new bearer provider name.

Parameters

bearer	The bearer to set the name for.
name	The new bearer provider name.

Return values

0	Success
-EINVAL	bearer or name is NULL, or name is the empty string or name is larger than CONFIG_BT_TBS_MAX_PROVIDER_NAME_LENGTH
-EFAULT	bearer is not registered

bt_ccp_call_control_server_unregister_bearer()

int bt_ccp_call_control_server_unregister_bearer

(

struct bt_ccp_call_control_server_bearer *

bearer

)

#include <zephyr/bluetooth/audio/ccp.h>

Unregister a Telephone Bearer.

This will unregister a Telephone Bearer Service (TBS) (or a Generic Telephone Bearer service (GTBS)) with the provided parameters. The bearer shall be registered first by bt_ccp_call_control_server_register_bearer() before it can be unregistered.

All TBS shall be unregistered before the GTBS can be unregistered with.

Parameters

bearer

The bearer to unregister.

Return values

0	Success
-EINVAL	bearer is NULL
-EALREADY	The bearer is not registered
-ENOEXEC	The service failed to be unregistered