1 /******************************************************************************
2  *
3  *  Copyright (C) 2002-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 file contains interfaces which are internal to AVDTP.
22  *
23  ******************************************************************************/
24 #ifndef AVDT_INT_H
25 #define AVDT_INT_H
26 
27 #include "gki.h"
28 #include "avdt_api.h"
29 #include "avdtc_api.h"
30 #include "avdt_defs.h"
31 #include "l2c_api.h"
32 #include "btm_api.h"
33 
34 #ifndef AVDT_DEBUG
35 #define AVDT_DEBUG  FALSE
36 #endif
37 
38 /*****************************************************************************
39 ** constants
40 *****************************************************************************/
41 
42 /* channel types */
43 enum {
44     AVDT_CHAN_SIG,                  /* signaling channel */
45     AVDT_CHAN_MEDIA,                /* media channel */
46 #if AVDT_REPORTING == TRUE
47     AVDT_CHAN_REPORT,               /* reporting channel */
48 #endif
49     AVDT_CHAN_NUM_TYPES
50 };
51 
52 /* protocol service capabilities of this AVDTP implementation */
53 /* for now multiplexing will be used only for fragmentation */
54 #if ((AVDT_MULTIPLEXING == TRUE) && (AVDT_REPORTING == TRUE))
55 #define AVDT_PSC                (AVDT_PSC_TRANS | AVDT_PSC_MUX | AVDT_PSC_REPORT | AVDT_PSC_DELAY_RPT)
56 #define AVDT_LEG_PSC            (AVDT_PSC_TRANS | AVDT_PSC_MUX | AVDT_PSC_REPORT)
57 #else /* AVDT_MULTIPLEXING && AVDT_REPORTING  */
58 
59 #if (AVDT_MULTIPLEXING == TRUE)
60 #define AVDT_PSC                (AVDT_PSC_TRANS | AVDT_PSC_MUX | AVDT_PSC_DELAY_RPT)
61 #define AVDT_LEG_PSC            (AVDT_PSC_TRANS | AVDT_PSC_MUX)
62 #else /* AVDT_MULTIPLEXING */
63 
64 #if (AVDT_REPORTING == TRUE)
65 #define AVDT_PSC                (AVDT_PSC_TRANS | AVDT_PSC_REPORT | AVDT_PSC_DELAY_RPT)
66 #define AVDT_LEG_PSC            (AVDT_PSC_TRANS | AVDT_PSC_REPORT)
67 #else /* AVDT_REPORTING  */
68 #define AVDT_PSC                (AVDT_PSC_TRANS | AVDT_PSC_DELAY_RPT)
69 #define AVDT_LEG_PSC            (AVDT_PSC_TRANS)
70 #endif /* AVDT_REPORTING  */
71 
72 #endif /* AVDT_MULTIPLEXING */
73 
74 #endif /* AVDT_MULTIPLEXING && AVDT_REPORTING  */
75 
76 /* initiator/acceptor signaling roles */
77 #define AVDT_CLOSE_ACP          0
78 #define AVDT_CLOSE_INT          1
79 #define AVDT_OPEN_ACP           2
80 #define AVDT_OPEN_INT           3
81 
82 /* states for avdt_scb_verify */
83 #define AVDT_VERIFY_OPEN        0
84 #define AVDT_VERIFY_STREAMING   1
85 #define AVDT_VERIFY_SUSPEND     2
86 #define AVDT_VERIFY_START       3
87 
88 /* to distinguish CCB events from SCB events */
89 #define AVDT_CCB_MKR            0x80
90 
91 /* offset where AVDTP signaling message header starts in message  */
92 #define AVDT_HDR_OFFSET         (L2CAP_MIN_OFFSET + AVDT_NUM_SEPS)
93 
94 /* offset where AVDTP signaling message content starts;
95 ** use the size of a start header since it's the largest possible
96 ** layout of signaling message in a buffer is:
97 **
98 ** |  BT_HDR  | SCB handles | L2CAP + HCI header | AVDTP header | data ... |
99 **
100 ** Note that we "hide" the scb handles at the top of the message buffer.
101 */
102 #define AVDT_MSG_OFFSET         (L2CAP_MIN_OFFSET + AVDT_NUM_SEPS + AVDT_LEN_TYPE_START)
103 
104 /* scb transport channel connect timeout value */
105 #define AVDT_SCB_TC_CONN_TOUT   10
106 
107 /* scb transport channel disconnect timeout value */
108 #define AVDT_SCB_TC_DISC_TOUT   10
109 
110 /* maximum number of command retransmissions */
111 #ifndef AVDT_RET_MAX
112 #define AVDT_RET_MAX            1
113 #endif
114 
115 
116 /* ccb state machine states */
117 enum {
118     AVDT_CCB_IDLE_ST,
119     AVDT_CCB_OPENING_ST,
120     AVDT_CCB_OPEN_ST,
121     AVDT_CCB_CLOSING_ST
122 };
123 
124 /* state machine action enumeration list */
125 enum {
126     AVDT_CCB_CHAN_OPEN,
127     AVDT_CCB_CHAN_CLOSE,
128     AVDT_CCB_CHK_CLOSE,
129     AVDT_CCB_HDL_DISCOVER_CMD,
130     AVDT_CCB_HDL_DISCOVER_RSP,
131     AVDT_CCB_HDL_GETCAP_CMD,
132     AVDT_CCB_HDL_GETCAP_RSP,
133     AVDT_CCB_HDL_START_CMD,
134     AVDT_CCB_HDL_START_RSP,
135     AVDT_CCB_HDL_SUSPEND_CMD,
136     AVDT_CCB_HDL_SUSPEND_RSP,
137     AVDT_CCB_SND_DISCOVER_CMD,
138     AVDT_CCB_SND_DISCOVER_RSP,
139     AVDT_CCB_SND_GETCAP_CMD,
140     AVDT_CCB_SND_GETCAP_RSP,
141     AVDT_CCB_SND_START_CMD,
142     AVDT_CCB_SND_START_RSP,
143     AVDT_CCB_SND_SUSPEND_CMD,
144     AVDT_CCB_SND_SUSPEND_RSP,
145     AVDT_CCB_CLEAR_CMDS,
146     AVDT_CCB_CMD_FAIL,
147     AVDT_CCB_FREE_CMD,
148     AVDT_CCB_CONG_STATE,
149     AVDT_CCB_RET_CMD,
150     AVDT_CCB_SND_CMD,
151     AVDT_CCB_SND_MSG,
152     AVDT_CCB_SET_RECONN,
153     AVDT_CCB_CLR_RECONN,
154     AVDT_CCB_CHK_RECONN,
155     AVDT_CCB_CHK_TIMER,
156     AVDT_CCB_SET_CONN,
157     AVDT_CCB_SET_DISCONN,
158     AVDT_CCB_DO_DISCONN,
159     AVDT_CCB_LL_CLOSED,
160     AVDT_CCB_LL_OPENED,
161     AVDT_CCB_DEALLOC,
162     AVDT_CCB_NUM_ACTIONS
163 };
164 
165 #define AVDT_CCB_IGNORE     AVDT_CCB_NUM_ACTIONS
166 
167 /* ccb state machine events */
168 enum {
169     AVDT_CCB_API_DISCOVER_REQ_EVT,
170     AVDT_CCB_API_GETCAP_REQ_EVT,
171     AVDT_CCB_API_START_REQ_EVT,
172     AVDT_CCB_API_SUSPEND_REQ_EVT,
173     AVDT_CCB_API_DISCOVER_RSP_EVT,
174     AVDT_CCB_API_GETCAP_RSP_EVT,
175     AVDT_CCB_API_START_RSP_EVT,
176     AVDT_CCB_API_SUSPEND_RSP_EVT,
177     AVDT_CCB_API_CONNECT_REQ_EVT,
178     AVDT_CCB_API_DISCONNECT_REQ_EVT,
179     AVDT_CCB_MSG_DISCOVER_CMD_EVT,
180     AVDT_CCB_MSG_GETCAP_CMD_EVT,
181     AVDT_CCB_MSG_START_CMD_EVT,
182     AVDT_CCB_MSG_SUSPEND_CMD_EVT,
183     AVDT_CCB_MSG_DISCOVER_RSP_EVT,
184     AVDT_CCB_MSG_GETCAP_RSP_EVT,
185     AVDT_CCB_MSG_START_RSP_EVT,
186     AVDT_CCB_MSG_SUSPEND_RSP_EVT,
187     AVDT_CCB_RCVRSP_EVT,
188     AVDT_CCB_SENDMSG_EVT,
189     AVDT_CCB_RET_TOUT_EVT,
190     AVDT_CCB_RSP_TOUT_EVT,
191     AVDT_CCB_IDLE_TOUT_EVT,
192     AVDT_CCB_UL_OPEN_EVT,
193     AVDT_CCB_UL_CLOSE_EVT,
194     AVDT_CCB_LL_OPEN_EVT,
195     AVDT_CCB_LL_CLOSE_EVT,
196     AVDT_CCB_LL_CONG_EVT
197 };
198 
199 
200 /* scb state machine states; these state values are private to this module so
201 ** the scb state cannot be read or set by actions functions
202 */
203 enum {
204     AVDT_SCB_IDLE_ST,
205     AVDT_SCB_CONF_ST,
206     AVDT_SCB_OPENING_ST,
207     AVDT_SCB_OPEN_ST,
208     AVDT_SCB_STREAM_ST,
209     AVDT_SCB_CLOSING_ST
210 };
211 
212 /* state machine action enumeration list */
213 enum {
214     AVDT_SCB_HDL_ABORT_CMD,
215     AVDT_SCB_HDL_ABORT_RSP,
216     AVDT_SCB_HDL_CLOSE_CMD,
217     AVDT_SCB_HDL_CLOSE_RSP,
218     AVDT_SCB_HDL_GETCONFIG_CMD,
219     AVDT_SCB_HDL_GETCONFIG_RSP,
220     AVDT_SCB_HDL_OPEN_CMD,
221     AVDT_SCB_HDL_OPEN_REJ,
222     AVDT_SCB_HDL_OPEN_RSP,
223     AVDT_SCB_HDL_PKT,
224     AVDT_SCB_DROP_PKT,
225     AVDT_SCB_HDL_RECONFIG_CMD,
226     AVDT_SCB_HDL_RECONFIG_RSP,
227     AVDT_SCB_HDL_SECURITY_CMD,
228     AVDT_SCB_HDL_SECURITY_RSP,
229     AVDT_SCB_HDL_SETCONFIG_CMD,
230     AVDT_SCB_HDL_SETCONFIG_REJ,
231     AVDT_SCB_HDL_SETCONFIG_RSP,
232     AVDT_SCB_HDL_START_CMD,
233     AVDT_SCB_HDL_START_RSP,
234     AVDT_SCB_HDL_SUSPEND_CMD,
235     AVDT_SCB_HDL_SUSPEND_RSP,
236     AVDT_SCB_HDL_TC_CLOSE,
237 #if AVDT_REPORTING == TRUE
238     AVDT_SCB_HDL_TC_CLOSE_STO,
239 #endif
240     AVDT_SCB_HDL_TC_OPEN,
241 #if AVDT_REPORTING == TRUE
242     AVDT_SCB_HDL_TC_OPEN_STO,
243 #endif
244     AVDT_SCB_SND_DELAY_RPT_REQ,
245     AVDT_SCB_HDL_DELAY_RPT_CMD,
246     AVDT_SCB_HDL_DELAY_RPT_RSP,
247     AVDT_SCB_HDL_WRITE_REQ,
248     AVDT_SCB_SND_ABORT_REQ,
249     AVDT_SCB_SND_ABORT_RSP,
250     AVDT_SCB_SND_CLOSE_REQ,
251     AVDT_SCB_SND_STREAM_CLOSE,
252     AVDT_SCB_SND_CLOSE_RSP,
253     AVDT_SCB_SND_GETCONFIG_REQ,
254     AVDT_SCB_SND_GETCONFIG_RSP,
255     AVDT_SCB_SND_OPEN_REQ,
256     AVDT_SCB_SND_OPEN_RSP,
257     AVDT_SCB_SND_RECONFIG_REQ,
258     AVDT_SCB_SND_RECONFIG_RSP,
259     AVDT_SCB_SND_SECURITY_REQ,
260     AVDT_SCB_SND_SECURITY_RSP,
261     AVDT_SCB_SND_SETCONFIG_REQ,
262     AVDT_SCB_SND_SETCONFIG_REJ,
263     AVDT_SCB_SND_SETCONFIG_RSP,
264     AVDT_SCB_SND_TC_CLOSE,
265     AVDT_SCB_CB_ERR,
266     AVDT_SCB_CONG_STATE,
267     AVDT_SCB_REJ_STATE,
268     AVDT_SCB_REJ_IN_USE,
269     AVDT_SCB_REJ_NOT_IN_USE,
270     AVDT_SCB_SET_REMOVE,
271     AVDT_SCB_FREE_PKT,
272     AVDT_SCB_CLR_PKT,
273     AVDT_SCB_CHK_SND_PKT,
274     AVDT_SCB_TC_TIMER,
275     AVDT_SCB_CLR_VARS,
276     AVDT_SCB_DEALLOC,
277     AVDT_SCB_NUM_ACTIONS
278 };
279 
280 #define AVDT_SCB_IGNORE     AVDT_SCB_NUM_ACTIONS
281 
282 /* scb state machine events */
283 enum {
284     AVDT_SCB_API_REMOVE_EVT,
285     AVDT_SCB_API_WRITE_REQ_EVT,
286     AVDT_SCB_API_GETCONFIG_REQ_EVT,
287     AVDT_SCB_API_DELAY_RPT_REQ_EVT,
288     AVDT_SCB_API_SETCONFIG_REQ_EVT,
289     AVDT_SCB_API_OPEN_REQ_EVT,
290     AVDT_SCB_API_CLOSE_REQ_EVT,
291     AVDT_SCB_API_RECONFIG_REQ_EVT,
292     AVDT_SCB_API_SECURITY_REQ_EVT,
293     AVDT_SCB_API_ABORT_REQ_EVT,
294     AVDT_SCB_API_GETCONFIG_RSP_EVT,
295     AVDT_SCB_API_SETCONFIG_RSP_EVT,
296     AVDT_SCB_API_SETCONFIG_REJ_EVT,
297     AVDT_SCB_API_OPEN_RSP_EVT,
298     AVDT_SCB_API_CLOSE_RSP_EVT,
299     AVDT_SCB_API_RECONFIG_RSP_EVT,
300     AVDT_SCB_API_SECURITY_RSP_EVT,
301     AVDT_SCB_API_ABORT_RSP_EVT,
302     AVDT_SCB_MSG_SETCONFIG_CMD_EVT,
303     AVDT_SCB_MSG_GETCONFIG_CMD_EVT,
304     AVDT_SCB_MSG_OPEN_CMD_EVT,
305     AVDT_SCB_MSG_START_CMD_EVT,
306     AVDT_SCB_MSG_SUSPEND_CMD_EVT,
307     AVDT_SCB_MSG_CLOSE_CMD_EVT,
308     AVDT_SCB_MSG_ABORT_CMD_EVT,
309     AVDT_SCB_MSG_RECONFIG_CMD_EVT,
310     AVDT_SCB_MSG_SECURITY_CMD_EVT,
311     AVDT_SCB_MSG_DELAY_RPT_CMD_EVT,
312     AVDT_SCB_MSG_DELAY_RPT_RSP_EVT,
313     AVDT_SCB_MSG_SETCONFIG_RSP_EVT,
314     AVDT_SCB_MSG_GETCONFIG_RSP_EVT,
315     AVDT_SCB_MSG_OPEN_RSP_EVT,
316     AVDT_SCB_MSG_START_RSP_EVT,
317     AVDT_SCB_MSG_SUSPEND_RSP_EVT,
318     AVDT_SCB_MSG_CLOSE_RSP_EVT,
319     AVDT_SCB_MSG_ABORT_RSP_EVT,
320     AVDT_SCB_MSG_RECONFIG_RSP_EVT,
321     AVDT_SCB_MSG_SECURITY_RSP_EVT,
322     AVDT_SCB_MSG_SETCONFIG_REJ_EVT,
323     AVDT_SCB_MSG_OPEN_REJ_EVT,
324     AVDT_SCB_MSG_START_REJ_EVT,
325     AVDT_SCB_MSG_SUSPEND_REJ_EVT,
326     AVDT_SCB_TC_TOUT_EVT,
327     AVDT_SCB_TC_OPEN_EVT,
328     AVDT_SCB_TC_CLOSE_EVT,
329     AVDT_SCB_TC_CONG_EVT,
330     AVDT_SCB_TC_DATA_EVT,
331     AVDT_SCB_CC_CLOSE_EVT
332 };
333 
334 /* adaption layer number of stream routing table entries */
335 #if AVDT_REPORTING == TRUE
336 /* 2 channels(1 media, 1 report) for each SEP and one for signalling */
337 #define AVDT_NUM_RT_TBL     ((AVDT_NUM_SEPS<<1) + 1)
338 #else
339 #define AVDT_NUM_RT_TBL     (AVDT_NUM_SEPS + 1)
340 #endif
341 
342 /* adaption layer number of transport channel table entries - moved to target.h
343 #define AVDT_NUM_TC_TBL     (AVDT_NUM_SEPS + AVDT_NUM_LINKS) */
344 
345 /* "states" used in transport channel table */
346 #define AVDT_AD_ST_UNUSED   0       /* Unused - unallocated */
347 #define AVDT_AD_ST_IDLE     1       /* No connection */
348 #define AVDT_AD_ST_ACP      2       /* Waiting to accept a connection */
349 #define AVDT_AD_ST_INT      3       /* Initiating a connection */
350 #define AVDT_AD_ST_CONN     4       /* Waiting for connection confirm */
351 #define AVDT_AD_ST_CFG      5       /* Waiting for configuration complete */
352 #define AVDT_AD_ST_OPEN     6       /* Channel opened */
353 #define AVDT_AD_ST_SEC_INT  7       /* Security process as INT */
354 #define AVDT_AD_ST_SEC_ACP  8       /* Security process as ACP */
355 
356 /* Configuration flags. tAVDT_TC_TBL.cfg_flags */
357 #define AVDT_L2C_CFG_IND_DONE   (1<<0)
358 #define AVDT_L2C_CFG_CFM_DONE   (1<<1)
359 #define AVDT_L2C_CFG_CONN_INT   (1<<2)
360 #define AVDT_L2C_CFG_CONN_ACP   (1<<3)
361 
362 
363 /* result code for avdt_ad_write_req() (L2CA_DataWrite()) */
364 #define AVDT_AD_FAILED       L2CAP_DW_FAILED        /* FALSE */
365 #define AVDT_AD_SUCCESS      L2CAP_DW_SUCCESS       /* TRUE */
366 #define AVDT_AD_CONGESTED    L2CAP_DW_CONGESTED     /* 2 */
367 
368 /*****************************************************************************
369 ** data types
370 *****************************************************************************/
371 
372 /* msg union of all message parameter types */
373 typedef union {
374     tAVDT_EVT_HDR           hdr;
375     tAVDT_EVT_HDR           single;
376     tAVDT_SETCONFIG         config_cmd;
377     tAVDT_CONFIG            reconfig_cmd;
378     tAVDT_MULTI             multi;
379     tAVDT_SECURITY          security_cmd;
380     tAVDT_DISCOVER          discover_rsp;
381     tAVDT_CONFIG            svccap;
382     tAVDT_SECURITY          security_rsp;
383     tAVDT_DELAY_RPT         delay_rpt_cmd;
384 } tAVDT_MSG;
385 
386 /* data type for AVDT_CCB_API_DISCOVER_REQ_EVT */
387 typedef struct {
388     tAVDT_CTRL_CBACK    *p_cback;
389     tAVDT_SEP_INFO      *p_sep_info;
390     UINT8               num_seps;
391 } tAVDT_CCB_API_DISCOVER;
392 
393 /* data type for AVDT_CCB_API_GETCAP_REQ_EVT */
394 typedef struct {
395     tAVDT_EVT_HDR       single;
396     tAVDT_CTRL_CBACK    *p_cback;
397     tAVDT_CFG           *p_cfg;
398 } tAVDT_CCB_API_GETCAP;
399 
400 /* data type for AVDT_CCB_API_CONNECT_REQ_EVT */
401 typedef struct {
402     tAVDT_CTRL_CBACK    *p_cback;
403     UINT8               sec_mask;
404 } tAVDT_CCB_API_CONNECT;
405 
406 /* data type for AVDT_CCB_API_DISCONNECT_REQ_EVT */
407 typedef struct {
408     tAVDT_CTRL_CBACK    *p_cback;
409 } tAVDT_CCB_API_DISCONNECT;
410 
411 /* union associated with ccb state machine events */
412 typedef union {
413     tAVDT_CCB_API_DISCOVER      discover;
414     tAVDT_CCB_API_GETCAP        getcap;
415     tAVDT_CCB_API_CONNECT       connect;
416     tAVDT_CCB_API_DISCONNECT    disconnect;
417     tAVDT_MSG                   msg;
418     BOOLEAN                     llcong;
419     UINT8                       err_code;
420 } tAVDT_CCB_EVT;
421 
422 /* channel control block type */
423 typedef struct {
424     BD_ADDR             peer_addr;      /* BD address of peer */
425     TIMER_LIST_ENT      timer_entry;    /* CCB timer list entry */
426     BUFFER_Q            cmd_q;          /* Queue for outgoing command messages */
427     BUFFER_Q            rsp_q;          /* Queue for outgoing response and reject messages */
428     tAVDT_CTRL_CBACK    *proc_cback;    /* Procedure callback function */
429     tAVDT_CTRL_CBACK    *p_conn_cback;  /* Connection/disconnection callback function */
430     void                *p_proc_data;   /* Pointer to data storage for procedure */
431     BT_HDR              *p_curr_cmd;    /* Current command being sent awaiting response */
432     BT_HDR              *p_curr_msg;    /* Current message being sent */
433     BT_HDR              *p_rx_msg;      /* Current message being received */
434     BOOLEAN             allocated;      /* Whether ccb is allocated */
435     UINT8               state;          /* The CCB state machine state */
436     BOOLEAN             ll_opened;      /* TRUE if LL is opened */
437     BOOLEAN             proc_busy;      /* TRUE when a discover or get capabilities procedure in progress */
438     UINT8               proc_param;     /* Procedure parameter; either SEID for get capabilities or number of SEPS for discover */
439     BOOLEAN             cong;           /* Whether signaling channel is congested */
440     UINT8               label;          /* Message header "label" (sequence number) */
441     BOOLEAN             reconn;         /* If TRUE, reinitiate connection after transitioning from CLOSING to IDLE state */
442     UINT8               ret_count;      /* Command retransmission count */
443 } tAVDT_CCB;
444 
445 /* type for action functions */
446 typedef void (*tAVDT_CCB_ACTION)(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
447 
448 /* type for AVDT_SCB_API_WRITE_REQ_EVT */
449 typedef struct {
450     BT_HDR      *p_buf;
451     UINT32      time_stamp;
452 #if AVDT_MULTIPLEXING == TRUE
453     BUFFER_Q    frag_q;          /* Queue for outgoing media fragments. p_buf should be 0 */
454     UINT8       *p_data;
455     UINT32      data_len;
456 #endif
457     UINT8       m_pt;
458     tAVDT_DATA_OPT_MASK     opt;
459 } tAVDT_SCB_APIWRITE;
460 
461 /* type for AVDT_SCB_TC_CLOSE_EVT */
462 typedef struct {
463     UINT8           old_tc_state;       /* channel state before closed */
464     UINT8           tcid;               /* TCID  */
465     UINT8           type;               /* channel type */
466 } tAVDT_SCB_TC_CLOSE;
467 
468 /* type for scb event data */
469 typedef union {
470     tAVDT_MSG           msg;
471     tAVDT_SCB_APIWRITE  apiwrite;
472     tAVDT_DELAY_RPT     apidelay;
473     tAVDT_OPEN          open;
474     tAVDT_SCB_TC_CLOSE  close;
475     BOOLEAN             llcong;
476     BT_HDR              *p_pkt;
477 } tAVDT_SCB_EVT;
478 
479 /* stream control block type */
480 typedef struct {
481     tAVDT_CS        cs;             /* stream creation struct */
482     tAVDT_CFG       curr_cfg;       /* current configuration */
483     tAVDT_CFG       req_cfg;        /* requested configuration */
484     TIMER_LIST_ENT  timer_entry;    /* timer entry */
485     BT_HDR          *p_pkt;         /* packet waiting to be sent */
486     tAVDT_CCB       *p_ccb;         /* ccb associated with this scb */
487     UINT16          media_seq;      /* media packet sequence number */
488     BOOLEAN         allocated;      /* whether scb is allocated or unused */
489     BOOLEAN         in_use;         /* whether stream being used by peer */
490     BOOLEAN         sink_activated; /* A2DP Sink activated/de-activated from Application */
491     UINT8           role;           /* initiator/acceptor role in current procedure */
492     BOOLEAN         remove;         /* whether CB is marked for removal */
493     UINT8           state;          /* state machine state */
494     UINT8           peer_seid;      /* SEID of peer stream */
495     UINT8           curr_evt;       /* current event; set only by state machine */
496     BOOLEAN         cong;           /* Whether media transport channel is congested */
497     UINT8           close_code;     /* Error code received in close response */
498 #if AVDT_MULTIPLEXING == TRUE
499     BUFFER_Q        frag_q;         /* Queue for outgoing media fragments */
500     UINT32          frag_off;       /* length of already received media fragments */
501     UINT32          frag_org_len;   /* original length before fragmentation of receiving media packet */
502     UINT8           *p_next_frag;   /* next fragment to send */
503     UINT8           *p_media_buf;   /* buffer for media packet assigned by AVDT_SetMediaBuf */
504     UINT32          media_buf_len;  /* length of buffer for media packet assigned by AVDT_SetMediaBuf */
505 #endif
506 } tAVDT_SCB;
507 
508 /* type for action functions */
509 typedef void (*tAVDT_SCB_ACTION)(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
510 
511 /* adaption layer type for transport channel table */
512 typedef struct {
513     UINT16  peer_mtu;       /* L2CAP mtu of the peer device */
514     UINT16  my_mtu;         /* Our MTU for this channel */
515     UINT16  my_flush_to;    /* Our flush timeout for this channel */
516     UINT16  lcid;
517     UINT8   tcid;           /* transport channel id */
518     UINT8   ccb_idx;        /* channel control block associated with this tc */
519     UINT8   state;          /* transport channel state */
520     UINT8   cfg_flags;      /* L2CAP configuration flags */
521     UINT8   id;
522 } tAVDT_TC_TBL;
523 
524 /* adaption layer type for stream routing table */
525 typedef struct {
526     UINT16  lcid;           /* L2CAP LCID of the associated transport channel */
527     UINT8   scb_hdl;        /* stream control block associated with this tc */
528 } tAVDT_RT_TBL;
529 
530 
531 /* adaption layer control block */
532 typedef struct {
533     tAVDT_RT_TBL    rt_tbl[AVDT_NUM_LINKS][AVDT_NUM_RT_TBL];
534     tAVDT_TC_TBL    tc_tbl[AVDT_NUM_TC_TBL];
535     UINT8           lcid_tbl[MAX_L2CAP_CHANNELS];   /* map LCID to tc_tbl index */
536 } tAVDT_AD;
537 
538 /* Control block for AVDT */
539 typedef struct {
540     tAVDT_REG           rcb;                    /* registration control block */
541     tAVDT_CCB           ccb[AVDT_NUM_LINKS];    /* channel control blocks */
542     tAVDT_SCB           scb[AVDT_NUM_SEPS];     /* stream control blocks */
543     tAVDT_AD            ad;                     /* adaption layer control block */
544     tAVDTC_CTRL_CBACK   *p_conf_cback;          /* conformance callback function */
545     tAVDT_CCB_ACTION    *p_ccb_act;             /* pointer to CCB action functions */
546     tAVDT_SCB_ACTION    *p_scb_act;             /* pointer to SCB action functions */
547     tAVDT_CTRL_CBACK    *p_conn_cback;          /* connection callback function */
548     UINT8               trace_level;            /* trace level */
549 } tAVDT_CB;
550 
551 
552 /*****************************************************************************
553 ** function declarations
554 *****************************************************************************/
555 
556 /* CCB function declarations */
557 extern void avdt_ccb_init(void);
558 extern void avdt_ccb_event(tAVDT_CCB *p_ccb, UINT8 event, tAVDT_CCB_EVT *p_data);
559 extern tAVDT_CCB *avdt_ccb_by_bd(BD_ADDR bd_addr);
560 extern tAVDT_CCB *avdt_ccb_alloc(BD_ADDR bd_addr);
561 extern void avdt_ccb_dealloc(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
562 extern UINT8 avdt_ccb_to_idx(tAVDT_CCB *p_ccb);
563 extern tAVDT_CCB *avdt_ccb_by_idx(UINT8 idx);
564 
565 /* CCB action functions */
566 extern void avdt_ccb_chan_open(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
567 extern void avdt_ccb_chan_close(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
568 extern void avdt_ccb_chk_close(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
569 extern void avdt_ccb_hdl_discover_cmd(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
570 extern void avdt_ccb_hdl_discover_rsp(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
571 extern void avdt_ccb_hdl_getcap_cmd(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
572 extern void avdt_ccb_hdl_getcap_rsp(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
573 extern void avdt_ccb_hdl_start_cmd(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
574 extern void avdt_ccb_hdl_start_rsp(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
575 extern void avdt_ccb_hdl_suspend_cmd(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
576 extern void avdt_ccb_hdl_suspend_rsp(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
577 extern void avdt_ccb_snd_discover_cmd(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
578 extern void avdt_ccb_snd_discover_rsp(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
579 extern void avdt_ccb_snd_getcap_cmd(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
580 extern void avdt_ccb_snd_getcap_rsp(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
581 extern void avdt_ccb_snd_start_cmd(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
582 extern void avdt_ccb_snd_start_rsp(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
583 extern void avdt_ccb_snd_suspend_cmd(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
584 extern void avdt_ccb_snd_suspend_rsp(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
585 extern void avdt_ccb_clear_cmds(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
586 extern void avdt_ccb_cmd_fail(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
587 extern void avdt_ccb_free_cmd(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
588 extern void avdt_ccb_cong_state(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
589 extern void avdt_ccb_ret_cmd(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
590 extern void avdt_ccb_snd_cmd(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
591 extern void avdt_ccb_snd_msg(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
592 extern void avdt_ccb_set_reconn(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
593 extern void avdt_ccb_clr_reconn(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
594 extern void avdt_ccb_chk_reconn(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
595 extern void avdt_ccb_chk_timer(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
596 extern void avdt_ccb_set_conn(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
597 extern void avdt_ccb_set_disconn(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
598 extern void avdt_ccb_do_disconn(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
599 extern void avdt_ccb_ll_closed(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
600 extern void avdt_ccb_ll_opened(tAVDT_CCB *p_ccb, tAVDT_CCB_EVT *p_data);
601 
602 /* SCB function prototypes */
603 extern void avdt_scb_event(tAVDT_SCB *p_scb, UINT8 event, tAVDT_SCB_EVT *p_data);
604 extern void avdt_scb_init(void);
605 extern tAVDT_SCB *avdt_scb_alloc(tAVDT_CS *p_cs);
606 extern void avdt_scb_dealloc(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
607 extern UINT8 avdt_scb_to_hdl(tAVDT_SCB *p_scb);
608 extern tAVDT_SCB *avdt_scb_by_hdl(UINT8 hdl);
609 extern UINT8 avdt_scb_verify(tAVDT_CCB *p_ccb, UINT8 state, UINT8 *p_seid, UINT16 num_seid, UINT8 *p_err_code);
610 extern void avdt_scb_peer_seid_list(tAVDT_MULTI *p_multi);
611 extern UINT32 avdt_scb_gen_ssrc(tAVDT_SCB *p_scb);
612 
613 /* SCB action functions */
614 extern void avdt_scb_hdl_abort_cmd(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
615 extern void avdt_scb_hdl_abort_rsp(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
616 extern void avdt_scb_hdl_close_cmd(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
617 extern void avdt_scb_hdl_close_rsp(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
618 extern void avdt_scb_hdl_getconfig_cmd(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
619 extern void avdt_scb_hdl_getconfig_rsp(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
620 extern void avdt_scb_hdl_open_cmd(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
621 extern void avdt_scb_hdl_open_rej(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
622 extern void avdt_scb_hdl_open_rsp(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
623 extern void avdt_scb_hdl_pkt(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
624 extern void avdt_scb_drop_pkt(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
625 extern void avdt_scb_hdl_reconfig_cmd(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
626 extern void avdt_scb_hdl_reconfig_rsp(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
627 extern void avdt_scb_hdl_security_cmd(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
628 extern void avdt_scb_hdl_security_rsp(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
629 extern void avdt_scb_hdl_setconfig_cmd(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
630 extern void avdt_scb_hdl_setconfig_rej(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
631 extern void avdt_scb_hdl_setconfig_rsp(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
632 extern void avdt_scb_hdl_start_cmd(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
633 extern void avdt_scb_hdl_start_rsp(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
634 extern void avdt_scb_hdl_suspend_cmd(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
635 extern void avdt_scb_hdl_suspend_rsp(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
636 extern void avdt_scb_snd_delay_rpt_req(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
637 extern void avdt_scb_hdl_delay_rpt_cmd(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
638 extern void avdt_scb_hdl_delay_rpt_rsp(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
639 extern void avdt_scb_hdl_tc_close(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
640 extern void avdt_scb_hdl_tc_open(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
641 extern void avdt_scb_hdl_tc_close_sto(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
642 extern void avdt_scb_hdl_tc_open_sto(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
643 extern void avdt_scb_hdl_write_req(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
644 extern void avdt_scb_snd_abort_req(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
645 extern void avdt_scb_snd_abort_rsp(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
646 extern void avdt_scb_snd_close_req(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
647 extern void avdt_scb_snd_stream_close(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
648 extern void avdt_scb_snd_close_rsp(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
649 extern void avdt_scb_snd_getconfig_req(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
650 extern void avdt_scb_snd_getconfig_rsp(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
651 extern void avdt_scb_snd_open_req(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
652 extern void avdt_scb_snd_open_rsp(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
653 extern void avdt_scb_snd_reconfig_req(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
654 extern void avdt_scb_snd_reconfig_rsp(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
655 extern void avdt_scb_snd_security_req(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
656 extern void avdt_scb_snd_security_rsp(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
657 extern void avdt_scb_snd_setconfig_req(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
658 extern void avdt_scb_snd_setconfig_rej(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
659 extern void avdt_scb_snd_setconfig_rsp(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
660 extern void avdt_scb_snd_tc_close(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
661 extern void avdt_scb_cb_err(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
662 extern void avdt_scb_cong_state(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
663 extern void avdt_scb_rej_state(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
664 extern void avdt_scb_rej_in_use(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
665 extern void avdt_scb_rej_not_in_use(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
666 extern void avdt_scb_set_remove(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
667 extern void avdt_scb_free_pkt(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
668 extern void avdt_scb_chk_snd_pkt(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
669 extern void avdt_scb_clr_pkt(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
670 extern void avdt_scb_tc_timer(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
671 extern void avdt_scb_clr_vars(tAVDT_SCB *p_scb, tAVDT_SCB_EVT *p_data);
672 extern void avdt_scb_queue_frags(tAVDT_SCB *p_scb, UINT8 **pp_data, UINT32 *p_data_len, BUFFER_Q *pq);
673 
674 /* msg function declarations */
675 extern BOOLEAN avdt_msg_send(tAVDT_CCB *p_ccb, BT_HDR *p_msg);
676 extern void avdt_msg_send_cmd(tAVDT_CCB *p_ccb, void *p_scb, UINT8 sig_id, tAVDT_MSG *p_params);
677 extern void avdt_msg_send_rsp(tAVDT_CCB *p_ccb, UINT8 sig_id, tAVDT_MSG *p_params);
678 extern void avdt_msg_send_rej(tAVDT_CCB *p_ccb, UINT8 sig_id, tAVDT_MSG *p_params);
679 extern void avdt_msg_send_grej(tAVDT_CCB *p_ccb, UINT8 sig_id, tAVDT_MSG *p_params);
680 extern void avdt_msg_ind(tAVDT_CCB *p_ccb, BT_HDR *p_buf);
681 
682 /* adaption layer function declarations */
683 extern void avdt_ad_init(void);
684 extern UINT8 avdt_ad_type_to_tcid(UINT8 type, tAVDT_SCB *p_scb);
685 extern tAVDT_TC_TBL *avdt_ad_tc_tbl_by_st(UINT8 type, tAVDT_CCB *p_ccb, UINT8 state);
686 extern tAVDT_TC_TBL *avdt_ad_tc_tbl_by_lcid(UINT16 lcid);
687 extern tAVDT_TC_TBL *avdt_ad_tc_tbl_alloc(tAVDT_CCB *p_ccb);
688 extern UINT8 avdt_ad_tc_tbl_to_idx(tAVDT_TC_TBL *p_tbl);
689 extern void avdt_ad_tc_close_ind(tAVDT_TC_TBL *p_tbl, UINT16 reason);
690 extern void avdt_ad_tc_open_ind(tAVDT_TC_TBL *p_tbl);
691 extern void avdt_ad_tc_cong_ind(tAVDT_TC_TBL *p_tbl, BOOLEAN is_congested);
692 extern void avdt_ad_tc_data_ind(tAVDT_TC_TBL *p_tbl, BT_HDR *p_buf);
693 extern tAVDT_TC_TBL *avdt_ad_tc_tbl_by_type(UINT8 type, tAVDT_CCB *p_ccb, tAVDT_SCB *p_scb);
694 extern UINT8 avdt_ad_write_req(UINT8 type, tAVDT_CCB *p_ccb, tAVDT_SCB *p_scb, BT_HDR *p_buf);
695 extern void avdt_ad_open_req(UINT8 type, tAVDT_CCB *p_ccb, tAVDT_SCB *p_scb, UINT8 role);
696 extern void avdt_ad_close_req(UINT8 type, tAVDT_CCB *p_ccb, tAVDT_SCB *p_scb);
697 
698 extern void avdt_process_timeout(TIMER_LIST_ENT *p_tle);
699 
700 /*****************************************************************************
701 ** macros
702 *****************************************************************************/
703 
704 /* we store the scb and the label in the layer_specific field of the
705 ** current cmd
706 */
707 #define AVDT_BLD_LAYERSPEC(ls, msg, label) \
708             ls = (((label) << 4) | (msg))
709 
710 #define AVDT_LAYERSPEC_LABEL(ls)    ((UINT8)((ls) >> 4))
711 
712 #define AVDT_LAYERSPEC_MSG(ls)      ((UINT8)((ls) & 0x000F))
713 
714 /*****************************************************************************
715 ** global data
716 *****************************************************************************/
717 #ifdef __cplusplus
718 extern "C"
719 {
720 #endif
721 
722 /******************************************************************************
723 ** Main Control Block
724 *******************************************************************************/
725 #if AVDT_DYNAMIC_MEMORY == FALSE
726 extern tAVDT_CB  avdt_cb;
727 #else
728 extern tAVDT_CB *avdt_cb_ptr;
729 #define avdt_cb (*avdt_cb_ptr)
730 #endif
731 
732 
733 /* L2CAP callback registration structure */
734 extern const tL2CAP_APPL_INFO avdt_l2c_appl;
735 
736 /* reject message event lookup table */
737 extern const UINT8 avdt_msg_rej_2_evt[];
738 #ifdef __cplusplus
739 }
740 #endif
741 
742 #endif /* AVDT_INT_H */
743