389 lines
15 KiB
C
389 lines
15 KiB
C
/******************************************************************************
|
|
*
|
|
* 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.
|
|
**
|
|
*******************************************************************************/
|
|
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.
|
|
**
|
|
*******************************************************************************/
|
|
extern void bta_av_co_audio_disc_res(tBTA_AV_HNDL hndl, UINT8 num_seps,
|
|
UINT8 num_snk, UINT8 num_src, BD_ADDR addr, UINT16 uuid_local);
|
|
|
|
/*******************************************************************************
|
|
**
|
|
** 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.
|
|
**
|
|
*******************************************************************************/
|
|
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.
|
|
**
|
|
*******************************************************************************/
|
|
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.
|
|
**
|
|
*******************************************************************************/
|
|
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
|
|
**
|
|
*******************************************************************************/
|
|
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, UINT8 t_local_sep, UINT8 avdt_handle);
|
|
|
|
/*******************************************************************************
|
|
**
|
|
** 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
|
|
**
|
|
*******************************************************************************/
|
|
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
|
|
**
|
|
*******************************************************************************/
|
|
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
|
|
**
|
|
*******************************************************************************/
|
|
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
|
|
**
|
|
*******************************************************************************/
|
|
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
|
|
**
|
|
*******************************************************************************/
|
|
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
|
|
**
|
|
*******************************************************************************/
|
|
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
|
|
**
|
|
*******************************************************************************/
|
|
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
|
|
**
|
|
*******************************************************************************/
|
|
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
|
|
**
|
|
*******************************************************************************/
|
|
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.
|
|
**
|
|
*******************************************************************************/
|
|
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*).
|
|
**
|
|
*******************************************************************************/
|
|
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
|
|
**
|
|
*******************************************************************************/
|
|
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
|
|
**
|
|
*******************************************************************************/
|
|
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
|
|
**
|
|
*******************************************************************************/
|
|
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
|
|
**
|
|
*******************************************************************************/
|
|
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
|
|
**
|
|
*******************************************************************************/
|
|
extern void bta_av_co_video_delay(tBTA_AV_HNDL hndl, UINT16 delay);
|
|
|
|
#endif /* BTA_AV_CO_H */
|