/****************************************************************************** * * Copyright (C) 2003-2012 Broadcom Corporation * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at: * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * ******************************************************************************/ /****************************************************************************** * * This is the interface file for advanced audio/video call-out functions. * ******************************************************************************/ #ifndef BTA_AV_CO_H #define BTA_AV_CO_H #include "l2c_api.h" #include "bta_av_api.h" /***************************************************************************** ** Constants and data types *****************************************************************************/ /* TRUE to use SCMS-T content protection */ #ifndef BTA_AV_CO_CP_SCMS_T #define BTA_AV_CO_CP_SCMS_T FALSE #endif /* the content protection IDs assigned by BT SIG */ #define BTA_AV_CP_SCMS_T_ID 0x0002 #define BTA_AV_CP_DTCP_ID 0x0001 #define BTA_AV_CP_LOSC 2 #define BTA_AV_CP_INFO_LEN 3 #define BTA_AV_CP_SCMS_COPY_MASK 3 #define BTA_AV_CP_SCMS_COPY_FREE 2 #define BTA_AV_CP_SCMS_COPY_ONCE 1 #define BTA_AV_CP_SCMS_COPY_NEVER 0 #define BTA_AV_CO_DEFAULT_AUDIO_OFFSET AVDT_MEDIA_OFFSET enum { BTA_AV_CO_ST_INIT, BTA_AV_CO_ST_IN, BTA_AV_CO_ST_OUT, BTA_AV_CO_ST_OPEN, BTA_AV_CO_ST_STREAM }; /* data type for the Audio Codec Information*/ typedef struct { UINT16 bit_rate; /* SBC encoder bit rate in kbps */ UINT16 bit_rate_busy; /* SBC encoder bit rate in kbps */ UINT16 bit_rate_swampd;/* SBC encoder bit rate in kbps */ UINT8 busy_level; /* Busy level indicating the bit-rate to be used */ UINT8 codec_info[AVDT_CODEC_SIZE]; UINT8 codec_type; /* Codec type */ } tBTA_AV_AUDIO_CODEC_INFO; /******************************************************************************* ** ** Function bta_av_co_audio_init ** ** Description This callout function is executed by AV when it is ** started by calling BTA_AvEnable(). This function can be ** used by the phone to initialize audio paths or for other ** initialization purposes. ** ** ** Returns Stream codec and content protection capabilities info. ** *******************************************************************************/ BTA_API extern BOOLEAN bta_av_co_audio_init(UINT8 *p_codec_type, UINT8 *p_codec_info, UINT8 *p_num_protect, UINT8 *p_protect_info, UINT8 index); /******************************************************************************* ** ** Function bta_av_co_audio_disc_res ** ** Description This callout function is executed by AV to report the ** number of stream end points (SEP) were found during the ** AVDT stream discovery process. ** ** ** Returns void. ** *******************************************************************************/ BTA_API extern void bta_av_co_audio_disc_res(tBTA_AV_HNDL hndl, UINT8 num_seps, UINT8 num_snk, BD_ADDR addr); /******************************************************************************* ** ** Function bta_av_co_video_disc_res ** ** Description This callout function is executed by AV to report the ** number of stream end points (SEP) were found during the ** AVDT stream discovery process. ** ** ** Returns void. ** *******************************************************************************/ BTA_API extern void bta_av_co_video_disc_res(tBTA_AV_HNDL hndl, UINT8 num_seps, UINT8 num_snk, BD_ADDR addr); /******************************************************************************* ** ** Function bta_av_co_audio_getconfig ** ** Description This callout function is executed by AV to retrieve the ** desired codec and content protection configuration for the ** audio stream. ** ** ** Returns Stream codec and content protection configuration info. ** *******************************************************************************/ BTA_API extern UINT8 bta_av_co_audio_getconfig(tBTA_AV_HNDL hndl, tBTA_AV_CODEC codec_type, UINT8 *p_codec_info, UINT8 *p_sep_info_idx, UINT8 seid, UINT8 *p_num_protect, UINT8 *p_protect_info); /******************************************************************************* ** ** Function bta_av_co_video_getconfig ** ** Description This callout function is executed by AV to retrieve the ** desired codec and content protection configuration for the ** video stream. ** ** ** Returns Stream codec and content protection configuration info. ** *******************************************************************************/ BTA_API extern UINT8 bta_av_co_video_getconfig(tBTA_AV_HNDL hndl, tBTA_AV_CODEC codec_type, UINT8 *p_codec_info, UINT8 *p_sep_info_idx, UINT8 seid, UINT8 *p_num_protect, UINT8 *p_protect_info); /******************************************************************************* ** ** Function bta_av_co_audio_setconfig ** ** Description This callout function is executed by AV to set the ** codec and content protection configuration of the audio stream. ** ** ** Returns void ** *******************************************************************************/ BTA_API extern void bta_av_co_audio_setconfig(tBTA_AV_HNDL hndl, tBTA_AV_CODEC codec_type, UINT8 *p_codec_info, UINT8 seid, BD_ADDR addr, UINT8 num_protect, UINT8 *p_protect_info); /******************************************************************************* ** ** Function bta_av_co_video_setconfig ** ** Description This callout function is executed by AV to set the ** codec and content protection configuration of the video stream. ** ** ** Returns void ** *******************************************************************************/ BTA_API extern void bta_av_co_video_setconfig(tBTA_AV_HNDL hndl, tBTA_AV_CODEC codec_type, UINT8 *p_codec_info, UINT8 seid, BD_ADDR addr, UINT8 num_protect, UINT8 *p_protect_info); /******************************************************************************* ** ** Function bta_av_co_audio_open ** ** Description This function is called by AV when the audio stream connection ** is opened. ** BTA-AV maintains the MTU of A2DP streams. ** If this is the 2nd audio stream, mtu is the smaller of the 2 ** streams. ** ** Returns void ** *******************************************************************************/ BTA_API extern void bta_av_co_audio_open(tBTA_AV_HNDL hndl, tBTA_AV_CODEC codec_type, UINT8 *p_codec_info, UINT16 mtu); /******************************************************************************* ** ** Function bta_av_co_video_open ** ** Description This function is called by AV when the video stream connection ** is opened. ** ** ** Returns void ** *******************************************************************************/ BTA_API extern void bta_av_co_video_open(tBTA_AV_HNDL hndl, tBTA_AV_CODEC codec_type, UINT8 *p_codec_info, UINT16 mtu); /******************************************************************************* ** ** Function bta_av_co_audio_close ** ** Description This function is called by AV when the audio stream connection ** is closed. ** BTA-AV maintains the MTU of A2DP streams. ** When one stream is closed and no other audio stream is open, ** mtu is reported as 0. ** Otherwise, the MTU remains open is reported. ** ** Returns void ** *******************************************************************************/ BTA_API extern void bta_av_co_audio_close(tBTA_AV_HNDL hndl, tBTA_AV_CODEC codec_type, UINT16 mtu); /******************************************************************************* ** ** Function bta_av_co_video_close ** ** Description This function is called by AV when the video stream connection ** is closed. ** ** ** Returns void ** *******************************************************************************/ BTA_API extern void bta_av_co_video_close(tBTA_AV_HNDL hndl, tBTA_AV_CODEC codec_type, UINT16 mtu); /******************************************************************************* ** ** Function bta_av_co_audio_start ** ** Description This function is called by AV when the audio streaming data ** transfer is started. ** ** ** Returns void ** *******************************************************************************/ BTA_API extern void bta_av_co_audio_start(tBTA_AV_HNDL hndl, tBTA_AV_CODEC codec_type, UINT8 *p_codec_info, BOOLEAN *p_no_rtp_hdr); /******************************************************************************* ** ** Function bta_av_co_video_start ** ** Description This function is called by AV when the video streaming data ** transfer is started. ** ** ** Returns void ** *******************************************************************************/ BTA_API extern void bta_av_co_video_start(tBTA_AV_HNDL hndl, tBTA_AV_CODEC codec_type, UINT8 *p_codec_info, BOOLEAN *p_no_rtp_hdr); /******************************************************************************* ** ** Function bta_av_co_audio_stop ** ** Description This function is called by AV when the audio streaming data ** transfer is stopped. ** ** ** Returns void ** *******************************************************************************/ BTA_API extern void bta_av_co_audio_stop(tBTA_AV_HNDL hndl, tBTA_AV_CODEC codec_type); /******************************************************************************* ** ** Function bta_av_co_video_stop ** ** Description This function is called by AV when the video streaming data ** transfer is stopped. ** ** ** Returns void ** *******************************************************************************/ BTA_API extern void bta_av_co_video_stop(tBTA_AV_HNDL hndl, tBTA_AV_CODEC codec_type); /******************************************************************************* ** ** Function bta_av_co_audio_src_data_path ** ** Description This function is called to get the next data buffer from ** the audio codec ** ** Returns NULL if data is not ready. ** Otherwise, a GKI buffer (BT_HDR*) containing the audio data. ** *******************************************************************************/ BTA_API extern void * bta_av_co_audio_src_data_path(tBTA_AV_CODEC codec_type, UINT32 *p_len, UINT32 *p_timestamp); /******************************************************************************* ** ** Function bta_av_co_video_src_data_path ** ** Description This function is called to get the next data buffer from ** the video codec. ** ** Returns NULL if data is not ready. ** Otherwise, a video data buffer (UINT8*). ** *******************************************************************************/ BTA_API extern void * bta_av_co_video_src_data_path(tBTA_AV_CODEC codec_type, UINT32 *p_len, UINT32 *p_timestamp); /******************************************************************************* ** ** Function bta_av_co_audio_drop ** ** Description An Audio packet is dropped. . ** It's very likely that the connected headset with this handle ** is moved far away. The implementation may want to reduce ** the encoder bit rate setting to reduce the packet size. ** ** Returns void ** *******************************************************************************/ BTA_API extern void bta_av_co_audio_drop(tBTA_AV_HNDL hndl); /******************************************************************************* ** ** Function bta_av_co_video_report_conn ** ** Description This function is called by AV when the reporting channel is ** opened (open=TRUE) or closed (open=FALSE). ** ** Returns void ** *******************************************************************************/ BTA_API extern void bta_av_co_video_report_conn (BOOLEAN open, UINT8 avdt_handle); /******************************************************************************* ** ** Function bta_av_co_video_report_rr ** ** Description This function is called by AV when a Receiver Report is ** received ** ** Returns void ** *******************************************************************************/ BTA_API extern void bta_av_co_video_report_rr (UINT32 packet_lost); /******************************************************************************* ** ** Function bta_av_co_audio_delay ** ** Description This function is called by AV when the audio stream connection ** needs to send the initial delay report to the connected SRC. ** ** ** Returns void ** *******************************************************************************/ BTA_API extern void bta_av_co_audio_delay(tBTA_AV_HNDL hndl, UINT16 delay); /******************************************************************************* ** ** Function bta_av_co_video_delay ** ** Description This function is called by AV when the video stream connection ** needs to send the initial delay report to the connected SRC. ** ** ** Returns void ** *******************************************************************************/ BTA_API extern void bta_av_co_video_delay(tBTA_AV_HNDL hndl, UINT16 delay); #endif /* BTA_AV_CO_H */