/****************************************************************************** * * Copyright (C) 2009-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. * ******************************************************************************/ /******************************************************************************* * * Filename: btif_media.h * * Description: This is the audio module for the BTIF system. * *******************************************************************************/ #ifndef BTIF_MEDIA_H #define BTIF_MEDIA_H #include #include "bta_api.h" #include "bt_common.h" #include "btif_av_api.h" #include "audio_a2dp_hw.h" /******************************************************************************* ** Constants *******************************************************************************/ /* Generic part */ #define BTIF_SUCCESS 0 /** * AV (Audio Video source) Errors */ #define BTIF_ERROR_SRV_AV_NOT_ENABLED 700 /* AV is not enabled */ #define BTIF_ERROR_SRV_AV_FEEDING_NOT_SUPPORTED 701 /* Requested Feeding not supported */ #define BTIF_ERROR_SRV_AV_BUSY 702 /* Another operation ongoing */ #define BTIF_ERROR_SRV_AV_NOT_OPENED 703 /* No AV link opened */ #define BTIF_ERROR_SRV_AV_NOT_STARTED 704 /* AV is not started */ #define BTIF_ERROR_SRV_AV_CP_NOT_SUPPORTED 705 /* Content protection is not supported by all headsets */ /* Transcoding definition for TxTranscoding and RxTranscoding */ #define BTIF_MEDIA_TRSCD_OFF 0 #define BTIF_MEDIA_TRSCD_PCM_2_SBC 1 /* Tx */ /******************************************************************************* ** Data types *******************************************************************************/ typedef int tBTIF_STATUS; /* tBTIF_MEDIA_INIT_AUDIO msg structure */ typedef struct { BT_HDR hdr; UINT16 SamplingFreq; /* 16k, 32k, 44.1k or 48k*/ UINT8 ChannelMode; /* mono, dual, stereo or joint stereo*/ UINT8 NumOfSubBands; /* 4 or 8 */ UINT8 NumOfBlocks; /* 4, 8, 12 or 16*/ UINT8 AllocationMethod; /* loudness or SNR*/ UINT16 MtuSize; /* peer mtu size */ } tBTIF_MEDIA_INIT_AUDIO; #if (BTA_AV_INCLUDED == TRUE) /* tBTIF_MEDIA_UPDATE_AUDIO msg structure */ typedef struct { BT_HDR hdr; UINT16 MinMtuSize; /* Minimum peer mtu size */ UINT8 MaxBitPool; /* Maximum peer bitpool */ UINT8 MinBitPool; /* Minimum peer bitpool */ } tBTIF_MEDIA_UPDATE_AUDIO; /* tBTIF_MEDIA_INIT_AUDIO_FEEDING msg structure */ typedef struct { BT_HDR hdr; tBTIF_AV_FEEDING_MODE feeding_mode; tBTIF_AV_MEDIA_FEEDINGS feeding; } tBTIF_MEDIA_INIT_AUDIO_FEEDING; typedef struct { BT_HDR hdr; UINT8 codec_info[AVDT_CODEC_SIZE]; } tBTIF_MEDIA_SINK_CFG_UPDATE; #endif #ifdef USE_AUDIO_TRACK typedef enum { BTIF_MEDIA_FOCUS_NOT_GRANTED = 0, BTIF_MEDIA_FOCUS_GRANTED } btif_media_audio_focus_state; typedef struct { BT_HDR hdr; UINT8 focus_state; } tBTIF_MEDIA_SINK_FOCUS_UPDATE; #endif /******************************************************************************* ** Public functions *******************************************************************************/ /******************************************************************************* ** ** Function btif_av_task ** ** Description ** ** Returns void ** *******************************************************************************/ extern void btif_media_task(void); /******************************************************************************* ** ** Function btif_media_task_enc_init_req ** ** Description Request to initialize the media task encoder ** ** Returns TRUE is success ** *******************************************************************************/ extern BOOLEAN btif_media_task_enc_init_req(tBTIF_MEDIA_INIT_AUDIO * p_msg); /******************************************************************************* ** ** Function btif_media_task_enc_update_req ** ** Description Request to update the media task encoder ** ** Returns TRUE is success ** *******************************************************************************/ #if (BTA_AV_INCLUDED == TRUE) extern BOOLEAN btif_media_task_enc_update_req(tBTIF_MEDIA_UPDATE_AUDIO * p_msg); #endif /******************************************************************************* ** ** Function btif_media_task_start_aa_req ** ** Description Request to start audio encoding task ** ** Returns TRUE is success ** *******************************************************************************/ extern BOOLEAN btif_media_task_start_aa_req(void); /******************************************************************************* ** ** Function btif_media_task_stop_aa_req ** ** Description Request to stop audio encoding task ** ** Returns TRUE is success ** *******************************************************************************/ extern BOOLEAN btif_media_task_stop_aa_req(void); /******************************************************************************* ** ** Function btif_media_task_aa_rx_flush_req ** ** Description Request to flush audio decoding pipe ** ** Returns TRUE is success ** *******************************************************************************/ extern BOOLEAN btif_media_task_aa_rx_flush_req(void); /******************************************************************************* ** ** Function btif_media_task_aa_tx_flush_req ** ** Description Request to flush audio encoding pipe ** ** Returns TRUE is success ** *******************************************************************************/ extern BOOLEAN btif_media_task_aa_tx_flush_req(void); /******************************************************************************* ** ** Function btif_media_aa_readbuf ** ** Description Read an audio GKI buffer from the BTIF media TX queue ** ** Returns pointer on a GKI aa buffer ready to send ** *******************************************************************************/ extern BT_HDR *btif_media_aa_readbuf(void); /******************************************************************************* ** ** Function btif_media_sink_enque_buf ** ** Description This function is called by the av_co to fill A2DP Sink Queue ** ** ** Returns size of the queue *******************************************************************************/ UINT8 btif_media_sink_enque_buf(BT_HDR *p_buf); /******************************************************************************* ** ** Function btif_media_aa_writebuf ** ** Description Enqueue a Advance Audio media GKI buffer to be processed by btif media task. ** ** Returns TRUE is success ** *******************************************************************************/ extern void btif_media_aa_writebuf(BT_HDR *pBuf, UINT32 timestamp, UINT16 seq_num); /******************************************************************************* ** ** Function btif_media_av_writebuf ** ** Description Enqueue a video media GKI buffer to be processed by btif media task. ** ** Returns TRUE is success ** *******************************************************************************/ extern BOOLEAN btif_media_av_writebuf(UINT8 *p_media, UINT32 media_len, UINT32 timestamp, UINT16 seq_num); #if (BTA_AV_INCLUDED == TRUE) /******************************************************************************* ** ** Function btif_media_task_audio_feeding_init_req ** ** Description Request to initialize audio feeding ** ** Returns TRUE is success ** *******************************************************************************/ extern BOOLEAN btif_media_task_audio_feeding_init_req(tBTIF_MEDIA_INIT_AUDIO_FEEDING *p_msg); #endif /******************************************************************************* ** ** Function dump_codec_info ** ** Description Decode and display codec_info (for debug) ** ** Returns void ** *******************************************************************************/ extern void dump_codec_info(unsigned char *p_codec); /** * Local adaptation helper functions between btif and media task */ bool btif_a2dp_start_media_task(void); void btif_a2dp_stop_media_task(void); void btif_a2dp_on_init(void); void btif_a2dp_setup_codec(void); void btif_a2dp_on_idle(void); void btif_a2dp_on_open(void); BOOLEAN btif_a2dp_on_started(tBTA_AV_START *p_av, BOOLEAN pending_start); void btif_a2dp_ack_fail(void); void btif_a2dp_on_stop_req(void); void btif_a2dp_on_stopped(tBTA_AV_SUSPEND *p_av); void btif_a2dp_on_suspend(void); void btif_a2dp_on_suspended(tBTA_AV_SUSPEND *p_av); void btif_a2dp_set_tx_flush(BOOLEAN enable); void btif_a2dp_set_rx_flush(BOOLEAN enable); void btif_media_check_iop_exceptions(UINT8 *peer_bda); void btif_reset_decoder(UINT8 *p_av); void btif_a2dp_on_offload_started(tBTA_AV_STATUS status); int btif_a2dp_get_track_frequency(UINT8 frequency); int btif_a2dp_get_track_channel_count(UINT8 channeltype); void btif_a2dp_set_peer_sep(UINT8 sep); #ifdef USE_AUDIO_TRACK void btif_a2dp_set_audio_focus_state(btif_media_audio_focus_state state); void btif_a2dp_set_audio_track_gain(float gain); #endif void btif_debug_a2dp_dump(int fd); void btif_update_a2dp_metrics(void); #endif