mirror of
				https://github.com/0xFEEDC0DE64/arduino-esp32.git
				synced 2025-10-31 14:11:42 +01:00 
			
		
		
		
	
		
			
				
	
	
		
			394 lines
		
	
	
		
			15 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			394 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"
 | |
| 
 | |
| #if (BTA_AV_INCLUDED == TRUE)
 | |
| 
 | |
| /*****************************************************************************
 | |
| **  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 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_INCLUDED == TRUE
 | |
| 
 | |
| #endif /* BTA_AV_CO_H */
 |