A2DP Source API
#include "src/classic/a2dp_source.h"
Audio/Video Distribution Transport Protocol A2DP Source is a device that streames media data.
a2dp_source_create_sdp_record
void a2dp_source_create_sdp_record(uint8_t * service, uint32_t service_record_handle, uint16_t supported_features, const char * service_name, const char * service_provider_name);
Create A2DP Source service record.
Parameters
- service
- service_record_handle
- supported_features: 16-bit bitmap, see AVDTP_SOURCE_SF_* values in avdtp.h
- service_name: or NULL for default value. Provide "" (empty string) to skip attribute
- service_provider_name: or NULL for default value. Provide "" (empty string) to skip attribute
a2dp_source_init
void a2dp_source_init(void);
Initialize up A2DP Source device.
a2dp_source_create_stream_endpoint
avdtp_stream_endpoint_t * a2dp_source_create_stream_endpoint(avdtp_media_type_t media_type, avdtp_media_codec_type_t media_codec_type,
const uint8_t *codec_capabilities, uint16_t codec_capabilities_len,
uint8_t * codec_configuration, uint16_t codec_configuration_len);
Create a stream endpoint of type SOURCE, and register media codec by specifying its capabilities and the default configuration.
Parameters
- media_type: See avdtp_media_type_t values in avdtp.h (audio, video or multimedia).
- media_codec_type: See avdtp_media_codec_type_t values in avdtp.h
- codec_capabilities: Media codec capabilities as defined in A2DP spec, section 4 - Audio Codec Interoperability Requirements.
- codec_capabilities_len Media: codec capabilities length.
- codec_configuration: Default media codec configuration.
- codec_configuration_len Media: codec configuration length.
Returns
- avdtp_stream_endpoint_t *: local_stream_endpoint
a2dp_source_finalize_stream_endpoint
void a2dp_source_finalize_stream_endpoint(avdtp_stream_endpoint_t * stream_endpoint);
@brief Unregister stream endpoint and free it's memory
@param stream_endpoint created by a2dp_source_create_stream_endpoint
a2dp_source_register_packet_handler
void a2dp_source_register_packet_handler(btstack_packet_handler_t callback);
Register callback for the A2DP Source client. It will receive following subevents of HCI_EVENT_A2DP_META HCI event type: - A2DP_SUBEVENT_STREAMING_CAN_SEND_MEDIA_PACKET_NOW: Indicates that the next media packet can be sent.
- A2DP_SUBEVENT_SIGNALING_CONNECTION_ESTABLISHED Received when signaling connection with a remote is established.
- A2DP_SUBEVENT_SIGNALING_CONNECTION_RELEASED Received when signaling connection with a remote is released
- A2DP_SUBEVENT_STREAM_ESTABLISHED Received when stream to a remote device is established.
- A2DP_SUBEVENT_STREAM_STARTED Received when stream is started.
- A2DP_SUBEVENT_STREAM_SUSPENDED Received when stream is paused.
- A2DP_SUBEVENT_STREAM_STOPED received when stream is aborted or stopped.
- A2DP_SUBEVENT_STREAM_RELEASED Received when stream is released.
- A2DP_SUBEVENT_SIGNALING_DELAY_REPORTING_CAPABILITY Currently the only capability that is passed to client
- A2DP_SUBEVENT_SIGNALING_CAPABILITIES_DONE Signals that all capabilities are reported
- A2DP_SUBEVENT_SIGNALING_DELAY_REPORT Delay report
- A2DP_SUBEVENT_SIGNALING_MEDIA_CODEC_SBC_CONFIGURATION SBC configuration
- A2DP_SUBEVENT_STREAMING_CAN_SEND_MEDIA_PACKET_NOW Signals that a media packet can be sent
- A2DP_SUBEVENT_COMMAND_REJECTED Command reject
Parameters
- callback
a2dp_source_establish_stream
uint8_t a2dp_source_establish_stream(bd_addr_t remote_addr, uint16_t *avdtp_cid);
Open stream.
Parameters
- remote_addr
- avdtp_cid: Assigned A2DP channel identifier used for further A2DP commands.
Returns
- uint8_t
a2dp_source_reconfigure_stream_sampling_frequency
uint8_t a2dp_source_reconfigure_stream_sampling_frequency(uint16_t a2dp_cid, uint32_t sampling_frequency);
Reconfigure stream.
Parameters
- local_seid : ID assigned to a local stream endpoint
- sampling_frequency: New sampling frequency to use. Cannot be called while stream is active
Returns
- uint8_t
a2dp_source_start_stream
uint8_t a2dp_source_start_stream(uint16_t a2dp_cid, uint8_t local_seid);
Start stream.
Parameters
- a2dp_cid: A2DP channel identifier.
- local_seid : ID of a local stream endpoint.
Returns
- uint8_t
a2dp_source_pause_stream
uint8_t a2dp_source_pause_stream(uint16_t a2dp_cid, uint8_t local_seid);
Pause stream.
Parameters
- a2dp_cid: A2DP channel identifier.
- local_seid: ID of a local stream endpoint.
Returns
- uint8_t
a2dp_source_stop_stream
uint8_t a2dp_source_stop_stream(uint16_t a2dp_cid, uint8_t local_seid);
Stop stream.
Parameters
- a2dp_cid: A2DP channel identifier.
- local_seid: ID of a local stream endpoint.
Returns
- uint8_t
a2dp_source_disconnect
uint8_t a2dp_source_disconnect(uint16_t a2dp_cid);
Release stream and disconnect from remote.
Parameters
- a2dp_cid: A2DP channel identifier.
Returns
- uint8_t
a2dp_source_stream_endpoint_request_can_send_now
void a2dp_source_stream_endpoint_request_can_send_now(uint16_t a2dp_cid, uint8_t local_seid);
Request to send a media packet. Packet can be then sent on reception of A2DP_SUBEVENT_STREAMING_CAN_SEND_MEDIA_PACKET_NOW event.
Parameters
- a2dp_cid: A2DP channel identifier.
- local_seid: ID of a local stream endpoint.
a2dp_max_media_payload_size
int a2dp_max_media_payload_size(uint16_t a2dp_cid, uint8_t local_seid);
Return maximal media payload size, does not include media header.
Parameters
- a2dp_cid: A2DP channel identifier.
- local_seid: ID of a local stream endpoint.
Returns
- int: max_media_payload_size_without_media_header
a2dp_source_stream_send_media_payload_rtp
uint8_t a2dp_source_stream_send_media_payload_rtp(uint16_t a2dp_cid, uint8_t local_seid, uint8_t marker, uint32_t timestamp,
uint8_t *payload, uint16_t payload_size);
Send media payload.
Parameters
- a2dp_cid: A2DP channel identifier.
- local_seid: ID of a local stream endpoint.
- marker
- timestamp: in sample rate units
- payload
- payload_size
- marker
Returns
- uint8_t: status
a2dp_source_stream_send_media_packet
uint8_t a2dp_source_stream_send_media_packet(uint16_t a2dp_cid, uint8_t local_seid, const uint8_t * packet, uint16_t size);
Send media packet
Parameters
- a2dp_cid: A2DP channel identifier.
- local_seid: ID of a local stream endpoint.
- packet
- size
Returns
- uint8_t: status
a2dp_source_set_config_sbc
uint8_t a2dp_source_set_config_sbc(uint16_t a2dp_cid, uint8_t local_seid, uint8_t remote_seid, const avdtp_configuration_sbc_t * configuration);
Select and configure SBC endpoint
Parameters
- a2dp_cid: A2DP channel identifier.
- local_seid: ID of a local stream endpoint.
- remote_seid: ID of a remote stream endpoint.
- configuration: SBC Configuration
Returns
- uint8_t: status
a2dp_source_set_config_mpeg_audio
uint8_t a2dp_source_set_config_mpeg_audio(uint16_t a2dp_cid, uint8_t local_seid, uint8_t remote_seid, const avdtp_configuration_mpeg_audio_t * configuration);
Select and configure MPEG AUDIO endpoint
Parameters
- a2dp_cid: A2DP channel identifier.
- local_seid: ID of a local stream endpoint.
- remote_seid: ID of a remote stream endpoint.
- configuration: MPEG AUDIO Configuration
Returns
- uint8_t: status
a2dp_source_set_config_mpeg_aac
uint8_t a2dp_source_set_config_mpeg_aac(uint16_t a2dp_cid, uint8_t local_seid, uint8_t remote_seid, const avdtp_configuration_mpeg_aac_t * configuration);
Select and configure MPEG AAC endpoint
Parameters
- a2dp_cid: A2DP channel identifier.
- local_seid: ID of a local stream endpoint.
- remote_seid: ID of a remote stream endpoint.
- configuration: MPEG AAC Configuration
Returns
- uint8_t: status
a2dp_source_set_config_mpegd_usac
uint8_t a2dp_source_set_config_mpegd_usac(uint16_t a2dp_cid, uint8_t local_seid, uint8_t remote_seid, const avdtp_configuration_mpegd_usac_t * configuration);
Select and configure MPEG-D USAC endpoint
Parameters
- a2dp_cid: A2DP channel identifier.
- local_seid: ID of a local stream endpoint.
- remote_seid: ID of a remote stream endpoint.
- configuration: MPEG-D USAC Configuration
Returns
- uint8_t: status
a2dp_source_set_config_atrac
uint8_t a2dp_source_set_config_atrac(uint16_t a2dp_cid, uint8_t local_seid, uint8_t remote_seid, const avdtp_configuration_atrac_t * configuration);
Select and configure ATRAC endpoint
Parameters
- a2dp_cid: A2DP channel identifier.
- local_seid: ID of a local stream endpoint.
- remote_seid: ID of a remote stream endpoint.
- configuration: ATRAC Configuration
Returns
- uint8_t: status
a2dp_source_set_config_other
uint8_t a2dp_source_set_config_other(uint16_t a2dp_cid, uint8_t local_seid, uint8_t remote_seid, const uint8_t * media_codec_information, uint8_t media_codec_information_len);
Select and configure Non-A2DP endpoint. Bytes 0-3 of codec information contain Vendor ID, bytes 4-5 contain Vendor Specific Codec ID (little endian)
Parameters
- a2dp_cid: A2DP channel identifier.
- local_seid: ID of a local stream endpoint.
- remote_seid: ID of a remote stream endpoint.
- media_codec_information
- media_codec_information_len
Returns
- uint8_t: status
a2dp_source_register_media_config_validator
void a2dp_source_register_media_config_validator(uint8_t (*callback)(const avdtp_stream_endpoint_t * stream_endpoint, const uint8_t * event, uint16_t size));
Register media configuration validator. Can reject insuitable configuration or report stream endpoint as currently busy
Note: validator has to return AVDTP error codes like: AVDTP_ERROR_CODE_SEP_IN_USE or AVDTP_ERROR_CODE_UNSUPPORTED_CONFIGURATION the callback receives the media configuration in the same format as the existing A2dP_SUBEVENT_SIGNALING_MEDIA_CODEC_SBC_CONFIGURATION and similar
Parameters
- callback
a2dp_source_deinit
void a2dp_source_deinit(void);
De-Init A2DP Source device.