bta_av_co.h revision 5738f83aeb59361a0a2eda2460113f6dc9194271 
1/******************************************************************************
2 *
3 *  Copyright (C) 2003-2012 Broadcom Corporation
4 *
5 *  Licensed under the Apache License, Version 2.0 (the "License");
6 *  you may not use this file except in compliance with the License.
7 *  You may obtain a copy of the License at:
8 *
9 *  http://www.apache.org/licenses/LICENSE-2.0
10 *
11 *  Unless required by applicable law or agreed to in writing, software
12 *  distributed under the License is distributed on an "AS IS" BASIS,
13 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 *  See the License for the specific language governing permissions and
15 *  limitations under the License.
16 *
17 ******************************************************************************/
18
19/******************************************************************************
20 *
21 *  This is the interface file for advanced audio/video call-out functions.
22 *
23 ******************************************************************************/
24#ifndef BTA_AV_CO_H
25#define BTA_AV_CO_H
26
27#include "l2c_api.h"
28#include "bta_av_api.h"
29
30/*****************************************************************************
31**  Constants and data types
32*****************************************************************************/
33
34/* TRUE to use SCMS-T content protection */
35#ifndef BTA_AV_CO_CP_SCMS_T
36#define BTA_AV_CO_CP_SCMS_T     FALSE
37#endif
38
39/* the content protection IDs assigned by BT SIG */
40#define BTA_AV_CP_SCMS_T_ID     0x0002
41#define BTA_AV_CP_DTCP_ID       0x0001
42
43#define BTA_AV_CP_LOSC                  2
44#define BTA_AV_CP_INFO_LEN              3
45
46#define BTA_AV_CP_SCMS_COPY_MASK        3
47#define BTA_AV_CP_SCMS_COPY_FREE        2
48#define BTA_AV_CP_SCMS_COPY_ONCE        1
49#define BTA_AV_CP_SCMS_COPY_NEVER       0
50
51#define BTA_AV_CO_DEFAULT_AUDIO_OFFSET      AVDT_MEDIA_OFFSET
52
53enum
54{
55    BTA_AV_CO_ST_INIT,
56    BTA_AV_CO_ST_IN,
57    BTA_AV_CO_ST_OUT,
58    BTA_AV_CO_ST_OPEN,
59    BTA_AV_CO_ST_STREAM
60};
61
62
63/* data type for the Audio Codec Information*/
64typedef struct
65{
66    UINT16  bit_rate;       /* SBC encoder bit rate in kbps */
67    UINT16  bit_rate_busy;  /* SBC encoder bit rate in kbps */
68    UINT16  bit_rate_swampd;/* SBC encoder bit rate in kbps */
69    UINT8   busy_level;     /* Busy level indicating the bit-rate to be used */
70    UINT8   codec_info[AVDT_CODEC_SIZE];
71    UINT8   codec_type;     /* Codec type */
72} tBTA_AV_AUDIO_CODEC_INFO;
73
74/*******************************************************************************
75**
76** Function         bta_av_co_audio_init
77**
78** Description      This callout function is executed by AV when it is
79**                  started by calling BTA_AvEnable().  This function can be
80**                  used by the phone to initialize audio paths or for other
81**                  initialization purposes.
82**
83**
84** Returns          Stream codec and content protection capabilities info.
85**
86*******************************************************************************/
87BTA_API extern BOOLEAN bta_av_co_audio_init(UINT8 *p_codec_type, UINT8 *p_codec_info,
88                                   UINT8 *p_num_protect, UINT8 *p_protect_info, UINT8 index);
89
90/*******************************************************************************
91**
92** Function         bta_av_co_audio_disc_res
93**
94** Description      This callout function is executed by AV to report the
95**                  number of stream end points (SEP) were found during the
96**                  AVDT stream discovery process.
97**
98**
99** Returns          void.
100**
101*******************************************************************************/
102BTA_API extern void bta_av_co_audio_disc_res(tBTA_AV_HNDL hndl, UINT8 num_seps,
103                                             UINT8 num_snk, BD_ADDR addr);
104
105/*******************************************************************************
106**
107** Function         bta_av_co_video_disc_res
108**
109** Description      This callout function is executed by AV to report the
110**                  number of stream end points (SEP) were found during the
111**                  AVDT stream discovery process.
112**
113**
114** Returns          void.
115**
116*******************************************************************************/
117BTA_API extern void bta_av_co_video_disc_res(tBTA_AV_HNDL hndl, UINT8 num_seps,
118                                             UINT8 num_snk, BD_ADDR addr);
119
120/*******************************************************************************
121**
122** Function         bta_av_co_audio_getconfig
123**
124** Description      This callout function is executed by AV to retrieve the
125**                  desired codec and content protection configuration for the
126**                  audio stream.
127**
128**
129** Returns          Stream codec and content protection configuration info.
130**
131*******************************************************************************/
132BTA_API extern UINT8 bta_av_co_audio_getconfig(tBTA_AV_HNDL hndl, tBTA_AV_CODEC codec_type,
133                                         UINT8 *p_codec_info, UINT8 *p_sep_info_idx, UINT8 seid,
134                                         UINT8 *p_num_protect, UINT8 *p_protect_info);
135
136/*******************************************************************************
137**
138** Function         bta_av_co_video_getconfig
139**
140** Description      This callout function is executed by AV to retrieve the
141**                  desired codec and content protection configuration for the
142**                  video stream.
143**
144**
145** Returns          Stream codec and content protection configuration info.
146**
147*******************************************************************************/
148BTA_API extern UINT8 bta_av_co_video_getconfig(tBTA_AV_HNDL hndl, tBTA_AV_CODEC codec_type,
149                                         UINT8 *p_codec_info, UINT8 *p_sep_info_idx, UINT8 seid,
150                                         UINT8 *p_num_protect, UINT8 *p_protect_info);
151
152/*******************************************************************************
153**
154** Function         bta_av_co_audio_setconfig
155**
156** Description      This callout function is executed by AV to set the
157**                  codec and content protection configuration of the audio stream.
158**
159**
160** Returns          void
161**
162*******************************************************************************/
163BTA_API extern void bta_av_co_audio_setconfig(tBTA_AV_HNDL hndl, tBTA_AV_CODEC codec_type,
164                                        UINT8 *p_codec_info, UINT8 seid, BD_ADDR addr,
165                                        UINT8 num_protect, UINT8 *p_protect_info);
166
167/*******************************************************************************
168**
169** Function         bta_av_co_video_setconfig
170**
171** Description      This callout function is executed by AV to set the
172**                  codec and content protection configuration of the video stream.
173**
174**
175** Returns          void
176**
177*******************************************************************************/
178BTA_API extern void bta_av_co_video_setconfig(tBTA_AV_HNDL hndl, tBTA_AV_CODEC codec_type,
179                                        UINT8 *p_codec_info, UINT8 seid, BD_ADDR addr,
180                                        UINT8 num_protect, UINT8 *p_protect_info);
181
182/*******************************************************************************
183**
184** Function         bta_av_co_audio_open
185**
186** Description      This function is called by AV when the audio stream connection
187**                  is opened.
188**                  BTA-AV maintains the MTU of A2DP streams.
189**                  If this is the 2nd audio stream, mtu is the smaller of the 2
190**                  streams.
191**
192** Returns          void
193**
194*******************************************************************************/
195BTA_API extern void bta_av_co_audio_open(tBTA_AV_HNDL hndl,
196                                         tBTA_AV_CODEC codec_type, UINT8 *p_codec_info,
197                                         UINT16 mtu);
198
199/*******************************************************************************
200**
201** Function         bta_av_co_video_open
202**
203** Description      This function is called by AV when the video stream connection
204**                  is opened.
205**
206**
207** Returns          void
208**
209*******************************************************************************/
210BTA_API extern void bta_av_co_video_open(tBTA_AV_HNDL hndl,
211                                         tBTA_AV_CODEC codec_type, UINT8 *p_codec_info,
212                                         UINT16 mtu);
213
214/*******************************************************************************
215**
216** Function         bta_av_co_audio_close
217**
218** Description      This function is called by AV when the audio stream connection
219**                  is closed.
220**                  BTA-AV maintains the MTU of A2DP streams.
221**                  When one stream is closed and no other audio stream is open,
222**                  mtu is reported as 0.
223**                  Otherwise, the MTU remains open is reported.
224**
225** Returns          void
226**
227*******************************************************************************/
228BTA_API extern void bta_av_co_audio_close(tBTA_AV_HNDL hndl, tBTA_AV_CODEC codec_type,
229                                          UINT16 mtu);
230
231/*******************************************************************************
232**
233** Function         bta_av_co_video_close
234**
235** Description      This function is called by AV when the video stream connection
236**                  is closed.
237**
238**
239** Returns          void
240**
241*******************************************************************************/
242BTA_API extern void bta_av_co_video_close(tBTA_AV_HNDL hndl, tBTA_AV_CODEC codec_type,
243                                          UINT16 mtu);
244
245/*******************************************************************************
246**
247** Function         bta_av_co_audio_start
248**
249** Description      This function is called by AV when the audio streaming data
250**                  transfer is started.
251**
252**
253** Returns          void
254**
255*******************************************************************************/
256BTA_API extern void bta_av_co_audio_start(tBTA_AV_HNDL hndl, tBTA_AV_CODEC codec_type,
257        UINT8 *p_codec_info, BOOLEAN *p_no_rtp_hdr);
258
259/*******************************************************************************
260**
261** Function         bta_av_co_video_start
262**
263** Description      This function is called by AV when the video streaming data
264**                  transfer is started.
265**
266**
267** Returns          void
268**
269*******************************************************************************/
270BTA_API extern void bta_av_co_video_start(tBTA_AV_HNDL hndl, tBTA_AV_CODEC codec_type,
271        UINT8 *p_codec_info, BOOLEAN *p_no_rtp_hdr);
272
273/*******************************************************************************
274**
275** Function         bta_av_co_audio_stop
276**
277** Description      This function is called by AV when the audio streaming data
278**                  transfer is stopped.
279**
280**
281** Returns          void
282**
283*******************************************************************************/
284BTA_API extern void bta_av_co_audio_stop(tBTA_AV_HNDL hndl, tBTA_AV_CODEC codec_type);
285
286/*******************************************************************************
287**
288** Function         bta_av_co_video_stop
289**
290** Description      This function is called by AV when the video streaming data
291**                  transfer is stopped.
292**
293**
294** Returns          void
295**
296*******************************************************************************/
297BTA_API extern void bta_av_co_video_stop(tBTA_AV_HNDL hndl, tBTA_AV_CODEC codec_type);
298
299/*******************************************************************************
300**
301** Function         bta_av_co_audio_src_data_path
302**
303** Description      This function is called to get the next data buffer from
304**                  the audio codec
305**
306** Returns          NULL if data is not ready.
307**                  Otherwise, a GKI buffer (BT_HDR*) containing the audio data.
308**
309*******************************************************************************/
310BTA_API extern void * bta_av_co_audio_src_data_path(tBTA_AV_CODEC codec_type,
311                                                    UINT32 *p_len, UINT32 *p_timestamp);
312
313/*******************************************************************************
314**
315** Function         bta_av_co_video_src_data_path
316**
317** Description      This function is called to get the next data buffer from
318**                  the video codec.
319**
320** Returns          NULL if data is not ready.
321**                  Otherwise, a video data buffer (UINT8*).
322**
323*******************************************************************************/
324BTA_API extern void * bta_av_co_video_src_data_path(tBTA_AV_CODEC codec_type,
325                                                    UINT32 *p_len, UINT32 *p_timestamp);
326
327/*******************************************************************************
328**
329** Function         bta_av_co_audio_drop
330**
331** Description      An Audio packet is dropped. .
332**                  It's very likely that the connected headset with this handle
333**                  is moved far away. The implementation may want to reduce
334**                  the encoder bit rate setting to reduce the packet size.
335**
336** Returns          void
337**
338*******************************************************************************/
339BTA_API extern void bta_av_co_audio_drop(tBTA_AV_HNDL hndl);
340
341/*******************************************************************************
342**
343** Function         bta_av_co_video_report_conn
344**
345** Description      This function is called by AV when the reporting channel is
346**                  opened (open=TRUE) or closed (open=FALSE).
347**
348** Returns          void
349**
350*******************************************************************************/
351BTA_API extern void bta_av_co_video_report_conn (BOOLEAN open, UINT8 avdt_handle);
352
353/*******************************************************************************
354**
355** Function         bta_av_co_video_report_rr
356**
357** Description      This function is called by AV when a Receiver Report is
358**                  received
359**
360** Returns          void
361**
362*******************************************************************************/
363BTA_API extern void bta_av_co_video_report_rr (UINT32 packet_lost);
364
365/*******************************************************************************
366**
367** Function         bta_av_co_audio_delay
368**
369** Description      This function is called by AV when the audio stream connection
370**                  needs to send the initial delay report to the connected SRC.
371**
372**
373** Returns          void
374**
375*******************************************************************************/
376BTA_API extern void bta_av_co_audio_delay(tBTA_AV_HNDL hndl, UINT16 delay);
377
378/*******************************************************************************
379**
380** Function         bta_av_co_video_delay
381**
382** Description      This function is called by AV when the video stream connection
383**                  needs to send the initial delay report to the connected SRC.
384**
385**
386** Returns          void
387**
388*******************************************************************************/
389BTA_API extern void bta_av_co_video_delay(tBTA_AV_HNDL hndl, UINT16 delay);
390
391#endif /* BTA_AV_CO_H */
392
393