Gitiles
Code Review Sign In
gerrit-public.fairphone.software / fp2-dev / platform / system / bt / bf51271f145204a0489597ccd9c851daa7ee0ad7 / . / stack / l2cap / l2c_int.h
blob: 72d554448050b13dd3808264f17f89672120e2dc [file] [log] [blame]
The Android Open Source Project5738f832012-12-12 16:00:35 -0800[diff] [blame]1/******************************************************************************
2 *
3 * Copyright (C) 1999-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 L2CAP internal definitions
22 *
23 ******************************************************************************/
24#ifndef L2C_INT_H
25#define L2C_INT_H
26
27#include "l2c_api.h"
28#include "l2cdefs.h"
29#include "gki.h"
30#include "btm_api.h"
31
32#define L2CAP_MIN_MTU 48 /* Minimum acceptable MTU is 48 bytes */
33
34/* Timeouts. Since L2CAP works off a 1-second list, all are in seconds.
35*/
36#define L2CAP_LINK_ROLE_SWITCH_TOUT 10 /* 10 seconds */
37#define L2CAP_LINK_CONNECT_TOUT 60 /* 30 seconds */
38#define L2CAP_LINK_CONNECT_TOUT_EXT 120 /* 120 seconds */
39#define L2CAP_ECHO_RSP_TOUT 30 /* 30 seconds */
40#define L2CAP_LINK_FLOW_CONTROL_TOUT 2 /* 2 seconds */
41#define L2CAP_LINK_DISCONNECT_TOUT 30 /* 30 seconds */
42
43#ifndef L2CAP_CHNL_CONNECT_TOUT /* BTIF needs to override for internal project needs */
44#define L2CAP_CHNL_CONNECT_TOUT 60 /* 60 seconds */
45#endif
46
47#define L2CAP_CHNL_CONNECT_TOUT_EXT 120 /* 120 seconds */
48#define L2CAP_CHNL_CFG_TIMEOUT 30 /* 30 seconds */
49#define L2CAP_CHNL_DISCONNECT_TOUT 10 /* 10 seconds */
50#define L2CAP_DELAY_CHECK_SM4 2 /* 2 seconds */
51#define L2CAP_WAIT_INFO_RSP_TOUT 3 /* 3 seconds */
52#define L2CAP_WAIT_UNPARK_TOUT 2 /* 2 seconds */
53#define L2CAP_LINK_INFO_RESP_TOUT 2 /* 2 seconds */
54#define L2CAP_BLE_LINK_CONNECT_TOUT 30 /* 30 seconds */
55
56/* quick timer uses millisecond unit */
57#define L2CAP_DEFAULT_RETRANS_TOUT 2000 /* 2000 milliseconds */
58#define L2CAP_DEFAULT_MONITOR_TOUT 12000 /* 12000 milliseconds */
59#define L2CAP_FCR_ACK_TOUT 200 /* 200 milliseconds */
60
61/* Define the possible L2CAP channel states. The names of
62** the states may seem a bit strange, but they are taken from
63** the Bluetooth specification.
64*/
65typedef enum
66{
67 CST_CLOSED, /* Channel is in clodes state */
68 CST_ORIG_W4_SEC_COMP, /* Originator waits security clearence */
69 CST_TERM_W4_SEC_COMP, /* Acceptor waits security clearence */
70 CST_W4_L2CAP_CONNECT_RSP, /* Waiting for peer conenct response */
71 CST_W4_L2CA_CONNECT_RSP, /* Waiting for upper layer connect rsp */
72 CST_CONFIG, /* Negotiating configuration */
73 CST_OPEN, /* Data transfer state */
74 CST_W4_L2CAP_DISCONNECT_RSP, /* Waiting for peer disconnect rsp */
75 CST_W4_L2CA_DISCONNECT_RSP /* Waiting for upper layer disc rsp */
76} tL2C_CHNL_STATE;
77
78/* Define the possible L2CAP link states
79*/
80typedef enum
81{
82 LST_DISCONNECTED,
83 LST_CONNECT_HOLDING,
84 LST_CONNECTING_WAIT_SWITCH,
85 LST_CONNECTING,
86 LST_CONNECTED,
87 LST_DISCONNECTING
88} tL2C_LINK_STATE;
89
90
91
92/* Define input events to the L2CAP link and channel state machines. The names
93** of the events may seem a bit strange, but they are taken from
94** the Bluetooth specification.
95*/
96#define L2CEVT_LP_CONNECT_CFM 0 /* Lower layer connect confirm */
97#define L2CEVT_LP_CONNECT_CFM_NEG 1 /* Lower layer connect confirm (failed) */
98#define L2CEVT_LP_CONNECT_IND 2 /* Lower layer connect indication */
99#define L2CEVT_LP_DISCONNECT_IND 3 /* Lower layer disconnect indication */
100#define L2CEVT_LP_QOS_CFM 4 /* Lower layer QOS confirmation */
101#define L2CEVT_LP_QOS_CFM_NEG 5 /* Lower layer QOS confirmation (failed)*/
102#define L2CEVT_LP_QOS_VIOLATION_IND 6 /* Lower layer QOS violation indication */
103
104#define L2CEVT_SEC_COMP 7 /* Security cleared successfully */
105#define L2CEVT_SEC_COMP_NEG 8 /* Security procedure failed */
106
107#define L2CEVT_L2CAP_CONNECT_REQ 10 /* Peer connection request */
108#define L2CEVT_L2CAP_CONNECT_RSP 11 /* Peer connection response */
109#define L2CEVT_L2CAP_CONNECT_RSP_PND 12 /* Peer connection response pending */
110#define L2CEVT_L2CAP_CONNECT_RSP_NEG 13 /* Peer connection response (failed) */
111#define L2CEVT_L2CAP_CONFIG_REQ 14 /* Peer configuration request */
112#define L2CEVT_L2CAP_CONFIG_RSP 15 /* Peer configuration response */
113#define L2CEVT_L2CAP_CONFIG_RSP_NEG 16 /* Peer configuration response (failed) */
114#define L2CEVT_L2CAP_DISCONNECT_REQ 17 /* Peer disconnect request */
115#define L2CEVT_L2CAP_DISCONNECT_RSP 18 /* Peer disconnect response */
116#define L2CEVT_L2CAP_INFO_RSP 19 /* Peer information response */
117#define L2CEVT_L2CAP_DATA 20 /* Peer data */
118
119#define L2CEVT_L2CA_CONNECT_REQ 21 /* Upper layer connect request */
120#define L2CEVT_L2CA_CONNECT_RSP 22 /* Upper layer connect response */
121#define L2CEVT_L2CA_CONNECT_RSP_NEG 23 /* Upper layer connect response (failed)*/
122#define L2CEVT_L2CA_CONFIG_REQ 24 /* Upper layer config request */
123#define L2CEVT_L2CA_CONFIG_RSP 25 /* Upper layer config response */
124#define L2CEVT_L2CA_CONFIG_RSP_NEG 26 /* Upper layer config response (failed) */
125#define L2CEVT_L2CA_DISCONNECT_REQ 27 /* Upper layer disconnect request */
126#define L2CEVT_L2CA_DISCONNECT_RSP 28 /* Upper layer disconnect response */
127#define L2CEVT_L2CA_DATA_READ 29 /* Upper layer data read */
128#define L2CEVT_L2CA_DATA_WRITE 30 /* Upper layer data write */
129#define L2CEVT_L2CA_FLUSH_REQ 31 /* Upper layer flush */
130
131#define L2CEVT_TIMEOUT 32 /* Timeout */
132#define L2CEVT_SEC_RE_SEND_CMD 33 /* btm_sec has enough info to proceed */
133
134#define L2CEVT_ACK_TIMEOUT 34 /* RR delay timeout */
135
136
137/* Bitmask to skip over Broadcom feature reserved (ID) to avoid sending two
138 successive ID values, '0' id only or both */
139#define L2CAP_ADJ_BRCM_ID 0x1
140#define L2CAP_ADJ_ZERO_ID 0x2
141#define L2CAP_ADJ_ID 0x3
142
143/* Return values for l2cu_process_peer_cfg_req() */
144#define L2CAP_PEER_CFG_UNACCEPTABLE 0
145#define L2CAP_PEER_CFG_OK 1
146#define L2CAP_PEER_CFG_DISCONNECT 2
147
148/* eL2CAP option constants */
149#define L2CAP_MIN_RETRANS_TOUT 2000 /* Min retransmission timeout if no flush timeout or PBF */
150#define L2CAP_MIN_MONITOR_TOUT 12000 /* Min monitor timeout if no flush timeout or PBF */
151
152#define L2CAP_MAX_FCR_CFG_TRIES 2 /* Config attempts before disconnecting */
153
154/* Only compiled in when in test mode. Production devices must not include
155*/
156#if L2CAP_CORRUPT_ERTM_PKTS == TRUE
157
158/* These are used for conformance and corruption testing only */
159typedef struct
160{
161 BOOLEAN in_use; /* TRUE if test in progress */
162 UINT8 type; /* Type of test to run or turns off random test */
163 UINT8 freq; /* One-shot or random */
164 BOOLEAN is_rx; /* TRUE if incoming packets */
165 UINT16 count; /* How many I-frames to drop in a row; used only with one-shot tests */
166} tL2C_FCR_TEST_CFG;
167
168typedef struct
169{
170 BOOLEAN in_use; /* TRUE if test in progress */
171 UINT8 skip_sframe_count; /* Number of S-Frames to skip sending */
172} tL2C_FCR_CFM_TEST_CB;
173
174typedef struct
175{
176 tL2C_FCR_TEST_CFG cfg; /* Current corruption test configuration */
177 tL2C_FCR_CFM_TEST_CB cfm; /* Conformance test structure */
178} tL2C_FCR_TEST_CB;
179
180#endif /* L2CAP_CORRUPT_ERTM_PKTS == TRUE */
181
182typedef struct
183{
184 UINT8 next_tx_seq; /* Next sequence number to be Tx'ed */
185 UINT8 last_rx_ack; /* Last sequence number ack'ed by the peer */
186 UINT8 next_seq_expected; /* Next peer sequence number expected */
187 UINT8 last_ack_sent; /* Last peer sequence number ack'ed */
188 UINT8 num_tries; /* Number of retries to send a packet */
189 UINT8 max_held_acks; /* Max acks we can hold before sending */
190
191 BOOLEAN remote_busy; /* TRUE if peer has flowed us off */
192 BOOLEAN local_busy; /* TRUE if we have flowed off the peer */
193
194 BOOLEAN rej_sent; /* Reject was sent */
195 BOOLEAN srej_sent; /* Selective Reject was sent */
196 BOOLEAN wait_ack; /* Transmitter is waiting ack (poll sent) */
197 BOOLEAN rej_after_srej; /* Send a REJ when SREJ clears */
198
199 BOOLEAN send_f_rsp; /* We need to send an F-bit response */
200
201 UINT16 rx_sdu_len; /* Length of the SDU being received */
202 BT_HDR *p_rx_sdu; /* Buffer holding the SDU being received */
203 BUFFER_Q waiting_for_ack_q; /* Buffers sent and waiting for peer to ack */
204 BUFFER_Q srej_rcv_hold_q; /* Buffers rcvd but held pending SREJ rsp */
205 BUFFER_Q retrans_q; /* Buffers being retransmitted */
206
207 TIMER_LIST_ENT ack_timer; /* Timer delaying RR */
208 TIMER_LIST_ENT mon_retrans_timer; /* Timer Monitor or Retransmission */
209
210#if (L2CAP_ERTM_STATS == TRUE)
211 UINT32 connect_tick_count; /* Time channel was established */
212 UINT32 ertm_pkt_counts[2]; /* Packets sent and received */
213 UINT32 ertm_byte_counts[2]; /* Bytes sent and received */
214 UINT32 s_frames_sent[4]; /* S-frames sent (RR, REJ, RNR, SREJ) */
215 UINT32 s_frames_rcvd[4]; /* S-frames rcvd (RR, REJ, RNR, SREJ) */
216 UINT32 xmit_window_closed; /* # of times the xmit window was closed */
217 UINT32 controller_idle; /* # of times less than 2 packets in controller */
218 /* when the xmit window was closed */
219 UINT32 pkts_retransmitted; /* # of packets that were retransmitted */
220 UINT32 retrans_touts; /* # of retransmission timouts */
221 UINT32 xmit_ack_touts; /* # of xmit ack timouts */
222
223#define L2CAP_ERTM_STATS_NUM_AVG 10
224#define L2CAP_ERTM_STATS_AVG_NUM_SAMPLES 100
225 UINT32 ack_delay_avg_count;
226 UINT32 ack_delay_avg_index;
227 UINT32 throughput_start;
228 UINT32 throughput[L2CAP_ERTM_STATS_NUM_AVG];
229 UINT32 ack_delay_avg[L2CAP_ERTM_STATS_NUM_AVG];
230 UINT32 ack_delay_min[L2CAP_ERTM_STATS_NUM_AVG];
231 UINT32 ack_delay_max[L2CAP_ERTM_STATS_NUM_AVG];
232 UINT32 ack_q_count_avg[L2CAP_ERTM_STATS_NUM_AVG];
233 UINT32 ack_q_count_min[L2CAP_ERTM_STATS_NUM_AVG];
234 UINT32 ack_q_count_max[L2CAP_ERTM_STATS_NUM_AVG];
235#endif
236
237#if L2CAP_CORRUPT_ERTM_PKTS == TRUE
238 tL2C_FCR_TEST_CB test_cb; /* Used for SVT and UPF testing */
239#endif
240
241} tL2C_FCRB;
242
243
244/* Define a registration control block. Every application (e.g. RFCOMM, SDP,
245** TCS etc) that registers with L2CAP is assigned one of these.
246*/
247#if (L2CAP_UCD_INCLUDED == TRUE)
248#define L2C_UCD_RCB_ID 0x00
249#define L2C_UCD_STATE_UNUSED 0x00
250#define L2C_UCD_STATE_W4_DATA 0x01
251#define L2C_UCD_STATE_W4_RECEPTION 0x02
252#define L2C_UCD_STATE_W4_MTU 0x04
253
254typedef struct
255{
256 UINT8 state;
257 tL2CAP_UCD_CB_INFO cb_info;
258} tL2C_UCD_REG;
259#endif
260
261typedef struct
262{
263 BOOLEAN in_use;
264 UINT16 psm;
265 UINT16 real_psm; /* This may be a dummy RCB for an o/b connection but */
266 /* this is the real PSM that we need to connect to */
267#if (L2CAP_UCD_INCLUDED == TRUE)
268 tL2C_UCD_REG ucd;
269#endif
270
271 tL2CAP_APPL_INFO api;
272} tL2C_RCB;
273
274
275/* Define a channel control block (CCB). There may be many channel control blocks
276** between the same two Bluetooth devices (i.e. on the same link).
277** Each CCB has unique local and remote CIDs. All channel control blocks on
278** the same physical link and are chained together.
279*/
280typedef struct t_l2c_ccb
281{
282 BOOLEAN in_use; /* TRUE when in use, FALSE when not */
283 tL2C_CHNL_STATE chnl_state; /* Channel state */
284
285 struct t_l2c_ccb *p_next_ccb; /* Next CCB in the chain */
286 struct t_l2c_ccb *p_prev_ccb; /* Previous CCB in the chain */
287 struct t_l2c_linkcb *p_lcb; /* Link this CCB is assigned to */
288
289 UINT16 local_cid; /* Local CID */
290 UINT16 remote_cid; /* Remote CID */
291
292 TIMER_LIST_ENT timer_entry; /* CCB Timer List Entry */
293
294 tL2C_RCB *p_rcb; /* Registration CB for this Channel */
295
296#define IB_CFG_DONE 0x01
297#define OB_CFG_DONE 0x02
298#define RECONFIG_FLAG 0x04 /* True after initial configuration */
299#define CFG_DONE_MASK (IB_CFG_DONE | OB_CFG_DONE)
300
301 UINT8 config_done; /* Configuration flag word */
302 UINT8 local_id; /* Transaction ID for local trans */
303 UINT8 remote_id; /* Transaction ID for local */
304
305#define CCB_FLAG_NO_RETRY 0x01 /* no more retry */
306#define CCB_FLAG_SENT_PENDING 0x02 /* already sent pending response */
307 UINT8 flags;
308
309 tL2CAP_CFG_INFO our_cfg; /* Our saved configuration options */
310 tL2CAP_CH_CFG_BITS peer_cfg_bits; /* Store what peer wants to configure */
311 tL2CAP_CFG_INFO peer_cfg; /* Peer's saved configuration options */
312
313 BUFFER_Q xmit_hold_q; /* Transmit data hold queue */
314
315 BOOLEAN cong_sent; /* Set when congested status sent */
316 UINT16 buff_quota; /* Buffer quota before sending congestion */
317
318 tL2CAP_CHNL_PRIORITY ccb_priority; /* Channel priority */
319 tL2CAP_CHNL_DATA_RATE tx_data_rate; /* Channel Tx data rate */
320 tL2CAP_CHNL_DATA_RATE rx_data_rate; /* Channel Rx data rate */
321
322 /* Fields used for eL2CAP */
323 tL2CAP_ERTM_INFO ertm_info;
324 tL2C_FCRB fcrb;
325 UINT16 tx_mps; /* TX MPS adjusted based on current controller */
326 UINT16 max_rx_mtu;
327 UINT8 fcr_cfg_tries; /* Max number of negotiation attempts */
328 BOOLEAN peer_cfg_already_rejected; /* If mode rejected once, set to TRUE */
329 BOOLEAN out_cfg_fcr_present; /* TRUE if cfg response shoulkd include fcr options */
330
331#define L2CAP_CFG_FCS_OUR 0x01 /* Our desired config FCS option */
332#define L2CAP_CFG_FCS_PEER 0x02 /* Peer's desired config FCS option */
333#define L2CAP_BYPASS_FCS (L2CAP_CFG_FCS_OUR | L2CAP_CFG_FCS_PEER)
334 UINT8 bypass_fcs;
335
336#if (L2CAP_NON_FLUSHABLE_PB_INCLUDED == TRUE)
337 BOOLEAN is_flushable; /* TRUE if channel is flushable */
338#endif
339
340#if (L2CAP_NUM_FIXED_CHNLS > 0) || (L2CAP_UCD_INCLUDED == TRUE)
341 UINT16 fixed_chnl_idle_tout; /* Idle timeout to use for the fixed channel */
342#endif
343
344} tL2C_CCB;
345
346/***********************************************************************
347** Define a queue of linked CCBs.
348*/
349typedef struct
350{
351 tL2C_CCB *p_first_ccb; /* The first channel in this queue */
352 tL2C_CCB *p_last_ccb; /* The last channel in this queue */
353} tL2C_CCB_Q;
354
355#if (L2CAP_ROUND_ROBIN_CHANNEL_SERVICE == TRUE)
356
357/* Round-Robin service for the same priority channels */
358#define L2CAP_NUM_CHNL_PRIORITY 3 /* Total number of priority group (high, medium, low)*/
359#define L2CAP_CHNL_PRIORITY_WEIGHT 5 /* weight per priority for burst transmission quota */
360#define L2CAP_GET_PRIORITY_QUOTA(pri) ((L2CAP_NUM_CHNL_PRIORITY - (pri)) * L2CAP_CHNL_PRIORITY_WEIGHT)
361
362/* CCBs within the same LCB are served in round robin with priority */
363/* It will make sure that low priority channel (for example, HF signaling on RFCOMM) */
364/* can be sent to headset even if higher priority channel (for example, AV media channel) */
365/* is congested. */
366
367typedef struct
368{
369 tL2C_CCB *p_serve_ccb; /* current serving ccb within priority group */
370 tL2C_CCB *p_first_ccb; /* first ccb of priority group */
371 UINT8 num_ccb; /* number of channels in priority group */
372 UINT8 quota; /* burst transmission quota */
373} tL2C_RR_SERV;
374
375#endif /* (L2CAP_ROUND_ROBIN_CHANNEL_SERVICE == TRUE) */
376
377/* Define a link control block. There is one link control block between
378** this device and any other device (i.e. BD ADDR).
379*/
380typedef struct t_l2c_linkcb
381{
382 BOOLEAN in_use; /* TRUE when in use, FALSE when not */
383 tL2C_LINK_STATE link_state;
384
385 TIMER_LIST_ENT timer_entry; /* Timer list entry for timeout evt */
386 UINT16 handle; /* The handle used with LM */
387
388 tL2C_CCB_Q ccb_queue; /* Queue of CCBs on this LCB */
389
390 tL2C_CCB *p_pending_ccb; /* ccb of waiting channel during link disconnect */
391 TIMER_LIST_ENT info_timer_entry; /* Timer entry for info resp timeout evt */
392 BD_ADDR remote_bd_addr; /* The BD address of the remote */
393
394 UINT8 link_role; /* Master or slave */
395 UINT8 id;
396 tL2CA_ECHO_RSP_CB *p_echo_rsp_cb; /* Echo response callback */
397 UINT16 idle_timeout; /* Idle timeout */
398 BOOLEAN is_bonding; /* True - link active only for bonding */
399
400 UINT16 link_flush_tout; /* Flush timeout used */
401
402 UINT16 link_xmit_quota; /* Num outstanding pkts allowed */
403 UINT16 sent_not_acked; /* Num packets sent but not acked */
404
405 BOOLEAN partial_segment_being_sent; /* Set TRUE when a partial segment */
406 /* is being sent. */
407 BOOLEAN w4_info_rsp; /* TRUE when info request is active */
408 UINT8 info_rx_bits; /* set 1 if received info type */
409 UINT32 peer_ext_fea; /* Peer's extended features mask */
410 BUFFER_Q link_xmit_data_q; /* Transmit data buffer queue */
411
412 UINT8 peer_chnl_mask[L2CAP_FIXED_CHNL_ARRAY_SIZE];
413#if (L2CAP_UCD_INCLUDED == TRUE)
414 UINT16 ucd_mtu; /* peer MTU on UCD */
415 BUFFER_Q ucd_out_sec_pending_q; /* Security pending outgoing UCD packet */
416 BUFFER_Q ucd_in_sec_pending_q; /* Security pending incoming UCD packet */
417#endif
418
419#if (L2CAP_HOST_FLOW_CTRL == TRUE)
420 UINT16 link_pkts_unacked; /* Packets received but not acked */
421 UINT16 link_ack_thresh; /* Threshold at which to ack pkts */
422#endif
423
424 BT_HDR *p_hcit_rcv_acl; /* Current HCIT ACL buf being rcvd */
425 UINT16 idle_timeout_sv; /* Save current Idle timeout */
426 UINT8 acl_priority; /* L2C_PRIORITY_NORMAL or L2C_PRIORITY_HIGH */
427 tL2CA_NOCP_CB *p_nocp_cb; /* Num Cmpl pkts callback */
428
429#if (L2CAP_NUM_FIXED_CHNLS > 0)
430 tL2C_CCB *p_fixed_ccbs[L2CAP_NUM_FIXED_CHNLS];
431 UINT16 disc_reason;
432#endif
433
434#if (BLE_INCLUDED == TRUE)
435 BOOLEAN is_ble_link;
436 tBLE_ADDR_TYPE ble_addr_type;
437
Zhihai Xu15d0a0c2013-12-17 20:33:09 -0800[diff] [blame]438#define L2C_BLE_CONN_UPDATE_DISABLE 0x1 /* disable update connection parameters */
439#define L2C_BLE_NEW_CONN_PARAM 0x2 /* new connection parameter to be set */
440#define L2C_BLE_UPDATE_PENDING 0x4 /* waiting for connection update finished */
441#define L2C_BLE_NOT_DEFAULT_PARAM 0x8 /* not using default connection parameters */
442 UINT8 upd_status;
The Android Open Source Project5738f832012-12-12 16:00:35 -0800[diff] [blame]443
444 UINT16 min_interval; /* parameters as requested by peripheral */
445 UINT16 max_interval;
446 UINT16 latency;
447 UINT16 timeout;
448
449#endif
450
451#if (L2CAP_ROUND_ROBIN_CHANNEL_SERVICE == TRUE)
452 /* each priority group is limited burst transmission */
453 /* round robin service for the same priority channels */
454 tL2C_RR_SERV rr_serv[L2CAP_NUM_CHNL_PRIORITY];
455 UINT8 rr_pri; /* current serving priority group */
456#endif
457
458} tL2C_LCB;
459
460/* Define the L2CAP control structure
461*/
462typedef struct
463{
464 UINT8 l2cap_trace_level;
465 UINT16 controller_xmit_window; /* Total ACL window for all links */
466
467 UINT16 round_robin_quota; /* Round-robin link quota */
468 UINT16 round_robin_unacked; /* Round-robin unacked */
469 BOOLEAN check_round_robin; /* Do a round robin check */
470
471 BOOLEAN is_cong_cback_context;
472
473 tL2C_LCB lcb_pool[MAX_L2CAP_LINKS]; /* Link Control Block pool */
474 tL2C_CCB ccb_pool[MAX_L2CAP_CHANNELS]; /* Channel Control Block pool */
475 tL2C_RCB rcb_pool[MAX_L2CAP_CLIENTS]; /* Registration info pool */
476
477 tL2C_CCB *p_free_ccb_first; /* Pointer to first free CCB */
478 tL2C_CCB *p_free_ccb_last; /* Pointer to last free CCB */
479
480 UINT8 desire_role; /* desire to be master/slave when accepting a connection */
481 BOOLEAN disallow_switch; /* FALSE, to allow switch at create conn */
482 UINT16 num_lm_acl_bufs; /* # of ACL buffers on controller */
483 UINT16 idle_timeout; /* Idle timeout */
484
485 BUFFER_Q rcv_hold_q; /* Recv pending queue */
486 TIMER_LIST_ENT rcv_hold_tle; /* Timer list entry for rcv hold */
487
488 tL2C_LCB *p_cur_hcit_lcb; /* Current HCI Transport buffer */
489 UINT16 num_links_active; /* Number of links active */
490
491#if (L2CAP_NON_FLUSHABLE_PB_INCLUDED == TRUE)
492 UINT16 non_flushable_pbf; /* L2CAP_PKT_START_NON_FLUSHABLE if controller supports */
493 /* Otherwise, L2CAP_PKT_START */
494 BOOLEAN is_flush_active; /* TRUE if an HCI_Enhanced_Flush has been sent */
495#endif
496
497#if L2CAP_CONFORMANCE_TESTING == TRUE
498 UINT32 test_info_resp; /* Conformance testing needs a dynamic response */
499#endif
500
501#if (L2CAP_NUM_FIXED_CHNLS > 0)
502 tL2CAP_FIXED_CHNL_REG fixed_reg[L2CAP_NUM_FIXED_CHNLS]; /* Reg info for fixed channels */
503#endif
504
505#if (BLE_INCLUDED == TRUE)
506 BOOLEAN is_ble_connecting;
507 BD_ADDR ble_connecting_bda;
508 UINT16 controller_le_xmit_window; /* Total ACL window for all links */
509 UINT16 num_lm_ble_bufs; /* # of ACL buffers on controller */
510#endif
511
512 tL2CA_ECHO_DATA_CB *p_echo_data_cb; /* Echo data callback */
513
514#if (defined(L2CAP_HIGH_PRI_CHAN_QUOTA_IS_CONFIGURABLE) && (L2CAP_HIGH_PRI_CHAN_QUOTA_IS_CONFIGURABLE == TRUE))
515 UINT16 high_pri_min_xmit_quota; /* Minimum number of ACL credit for high priority link */
516#endif /* (L2CAP_HIGH_PRI_CHAN_QUOTA_IS_CONFIGURABLE == TRUE) */
517
518 UINT16 dyn_psm;
519} tL2C_CB;
520
521
522
523/* Define a structure that contains the information about a connection.
524** This structure is used to pass between functions, and not all the
525** fields will always be filled in.
526*/
527typedef struct
528{
529 BD_ADDR bd_addr; /* Remote BD address */
530 UINT8 status; /* Connection status */
531 UINT16 psm; /* PSM of the connection */
532 UINT16 l2cap_result; /* L2CAP result */
533 UINT16 l2cap_status; /* L2CAP status */
534 UINT16 remote_cid; /* Remote CID */
535} tL2C_CONN_INFO;
536
537
538typedef void (tL2C_FCR_MGMT_EVT_HDLR) (UINT8, tL2C_CCB *);
539
540/* The offset in a buffer that L2CAP will use when building commands.
541*/
542#define L2CAP_SEND_CMD_OFFSET 0
543
544
545/* Number of ACL buffers to use for high priority channel
546*/
547#if (!defined(L2CAP_HIGH_PRI_CHAN_QUOTA_IS_CONFIGURABLE) || (L2CAP_HIGH_PRI_CHAN_QUOTA_IS_CONFIGURABLE == FALSE))
548#define L2CAP_HIGH_PRI_MIN_XMIT_QUOTA_A (L2CAP_HIGH_PRI_MIN_XMIT_QUOTA)
549#else
550#define L2CAP_HIGH_PRI_MIN_XMIT_QUOTA_A (l2cb.high_pri_min_xmit_quota)
551#endif
552
553#ifdef __cplusplus
554extern "C" {
555#endif
556
557
558/* L2CAP global data
559************************************
560*/
561#if (!defined L2C_DYNAMIC_MEMORY) || (L2C_DYNAMIC_MEMORY == FALSE)
562L2C_API extern tL2C_CB l2cb;
563#else
564L2C_API extern tL2C_CB *l2c_cb_ptr;
565#define l2cb (*l2c_cb_ptr)
566#endif
567
568
569/* Functions provided by l2c_main.c
570************************************
571*/
572extern void l2c_init (void);
573extern void l2c_process_timeout (TIMER_LIST_ENT *p_tle);
574extern UINT8 l2c_data_write (UINT16 cid, BT_HDR *p_data, UINT16 flag);
575extern void l2c_rcv_acl_data (BT_HDR *p_msg);
576extern void l2c_process_held_packets (BOOLEAN timed_out);
577
578/* Functions provided by l2c_utils.c
579************************************
580*/
581extern tL2C_LCB *l2cu_allocate_lcb (BD_ADDR p_bd_addr, BOOLEAN is_bonding);
582extern BOOLEAN l2cu_start_post_bond_timer (UINT16 handle);
583extern void l2cu_release_lcb (tL2C_LCB *p_lcb);
584extern tL2C_LCB *l2cu_find_lcb_by_bd_addr (BD_ADDR p_bd_addr);
585extern tL2C_LCB *l2cu_find_lcb_by_handle (UINT16 handle);
586extern void l2cu_update_lcb_4_bonding (BD_ADDR p_bd_addr, BOOLEAN is_bonding);
587
Zhihai Xua934f012013-10-07 15:11:22 -0700[diff] [blame]588extern UINT8 l2cu_get_conn_role (BD_ADDR bd_addr);
The Android Open Source Project5738f832012-12-12 16:00:35 -0800[diff] [blame]589extern BOOLEAN l2cu_set_acl_priority (BD_ADDR bd_addr, UINT8 priority, BOOLEAN reset_after_rs);
590
591extern void l2cu_enqueue_ccb (tL2C_CCB *p_ccb);
592extern void l2cu_dequeue_ccb (tL2C_CCB *p_ccb);
593extern void l2cu_change_pri_ccb (tL2C_CCB *p_ccb, tL2CAP_CHNL_PRIORITY priority);
594
595extern tL2C_CCB *l2cu_allocate_ccb (tL2C_LCB *p_lcb, UINT16 cid);
596extern void l2cu_release_ccb (tL2C_CCB *p_ccb);
597extern tL2C_CCB *l2cu_find_ccb_by_cid (tL2C_LCB *p_lcb, UINT16 local_cid);
598extern tL2C_CCB *l2cu_find_ccb_by_remote_cid (tL2C_LCB *p_lcb, UINT16 remote_cid);
599extern void l2cu_adj_id (tL2C_LCB *p_lcb, UINT8 adj_mask);
600
601extern void l2cu_send_peer_cmd_reject (tL2C_LCB *p_lcb, UINT16 reason,
602 UINT8 rem_id,UINT16 p1, UINT16 p2);
603extern void l2cu_send_peer_connect_req (tL2C_CCB *p_ccb);
604extern void l2cu_send_peer_connect_rsp (tL2C_CCB *p_ccb, UINT16 result, UINT16 status);
605extern void l2cu_send_peer_config_req (tL2C_CCB *p_ccb, tL2CAP_CFG_INFO *p_cfg);
606extern void l2cu_send_peer_config_rsp (tL2C_CCB *p_ccb, tL2CAP_CFG_INFO *p_cfg);
607extern void l2cu_send_peer_config_rej (tL2C_CCB *p_ccb, UINT8 *p_data, UINT16 data_len, UINT16 rej_len);
608extern void l2cu_send_peer_disc_req (tL2C_CCB *p_ccb);
609extern void l2cu_send_peer_disc_rsp (tL2C_LCB *p_lcb, UINT8 remote_id, UINT16 local_cid, UINT16 remote_cid);
610extern void l2cu_send_peer_echo_req (tL2C_LCB *p_lcb, UINT8 *p_data, UINT16 data_len);
611extern void l2cu_send_peer_echo_rsp (tL2C_LCB *p_lcb, UINT8 id, UINT8 *p_data, UINT16 data_len);
612extern void l2cu_send_peer_info_rsp (tL2C_LCB *p_lcb, UINT8 id, UINT16 info_type);
613extern void l2cu_reject_connection (tL2C_LCB *p_lcb, UINT16 remote_cid, UINT8 rem_id, UINT16 result);
614extern void l2cu_send_peer_info_req (tL2C_LCB *p_lcb, UINT16 info_type);
615extern void l2cu_set_acl_hci_header (BT_HDR *p_buf, tL2C_CCB *p_ccb);
616extern void l2cu_check_channel_congestion (tL2C_CCB *p_ccb);
617extern void l2cu_disconnect_chnl (tL2C_CCB *p_ccb);
618
619#if (L2CAP_NON_FLUSHABLE_PB_INCLUDED == TRUE)
620extern void l2cu_set_non_flushable_pbf(BOOLEAN);
621#endif
622
623#if (BLE_INCLUDED == TRUE)
624extern void l2cu_send_peer_ble_par_req (tL2C_LCB *p_lcb, UINT16 min_int, UINT16 max_int, UINT16 latency, UINT16 timeout);
625extern void l2cu_send_peer_ble_par_rsp (tL2C_LCB *p_lcb, UINT16 reason, UINT8 rem_id);
626#endif
627
628extern BOOLEAN l2cu_initialize_fixed_ccb (tL2C_LCB *p_lcb, UINT16 fixed_cid, tL2CAP_FCR_OPTS *p_fcr);
629extern void l2cu_no_dynamic_ccbs (tL2C_LCB *p_lcb);
630extern void l2cu_process_fixed_chnl_resp (tL2C_LCB *p_lcb);
631
632/* Functions provided by l2c_ucd.c
633************************************
634*/
635#if (L2CAP_UCD_INCLUDED == TRUE)
636void l2c_ucd_delete_sec_pending_q(tL2C_LCB *p_lcb);
637void l2c_ucd_enqueue_pending_out_sec_q(tL2C_CCB *p_ccb, void *p_data);
638BOOLEAN l2c_ucd_check_pending_info_req(tL2C_CCB *p_ccb);
639BOOLEAN l2c_ucd_check_pending_out_sec_q(tL2C_CCB *p_ccb);
640void l2c_ucd_send_pending_out_sec_q(tL2C_CCB *p_ccb);
641void l2c_ucd_discard_pending_out_sec_q(tL2C_CCB *p_ccb);
642BOOLEAN l2c_ucd_check_pending_in_sec_q(tL2C_CCB *p_ccb);
643void l2c_ucd_send_pending_in_sec_q(tL2C_CCB *p_ccb);
644void l2c_ucd_discard_pending_in_sec_q(tL2C_CCB *p_ccb);
645BOOLEAN l2c_ucd_check_rx_pkts(tL2C_LCB *p_lcb, BT_HDR *p_msg);
646BOOLEAN l2c_ucd_process_event(tL2C_CCB *p_ccb, UINT16 event, void *p_data);
647#endif
648
649#if (BLE_INCLUDED == TRUE)
650extern void l2cu_send_peer_ble_par_req (tL2C_LCB *p_lcb, UINT16 min_int, UINT16 max_int, UINT16 latency, UINT16 timeout);
651extern void l2cu_send_peer_ble_par_rsp (tL2C_LCB *p_lcb, UINT16 reason, UINT8 rem_id);
652#endif
653
654extern BOOLEAN l2cu_initialize_fixed_ccb (tL2C_LCB *p_lcb, UINT16 fixed_cid, tL2CAP_FCR_OPTS *p_fcr);
655extern void l2cu_no_dynamic_ccbs (tL2C_LCB *p_lcb);
656extern void l2cu_process_fixed_chnl_resp (tL2C_LCB *p_lcb);
657
658
659/* Functions provided for Broadcom Aware
660****************************************
661*/
662extern BOOLEAN l2cu_check_feature_req (tL2C_LCB *p_lcb, UINT8 id, UINT8 *p_data, UINT16 data_len);
663extern void l2cu_check_feature_rsp (tL2C_LCB *p_lcb, UINT8 id, UINT8 *p_data, UINT16 data_len);
664extern void l2cu_send_feature_req (tL2C_CCB *p_ccb);
665
666extern tL2C_RCB *l2cu_allocate_rcb (UINT16 psm);
667extern tL2C_RCB *l2cu_find_rcb_by_psm (UINT16 psm);
668extern void l2cu_release_rcb (tL2C_RCB *p_rcb);
669
670extern UINT8 l2cu_process_peer_cfg_req (tL2C_CCB *p_ccb, tL2CAP_CFG_INFO *p_cfg);
671extern void l2cu_process_peer_cfg_rsp (tL2C_CCB *p_ccb, tL2CAP_CFG_INFO *p_cfg);
672extern void l2cu_process_our_cfg_req (tL2C_CCB *p_ccb, tL2CAP_CFG_INFO *p_cfg);
673extern void l2cu_process_our_cfg_rsp (tL2C_CCB *p_ccb, tL2CAP_CFG_INFO *p_cfg);
674
675extern void l2cu_device_reset (void);
676extern tL2C_LCB *l2cu_find_lcb_by_state (tL2C_LINK_STATE state);
677extern BOOLEAN l2cu_lcb_disconnecting (void);
678
679extern BOOLEAN l2cu_create_conn (tL2C_LCB *p_lcb);
680extern BOOLEAN l2cu_create_conn_after_switch (tL2C_LCB *p_lcb);
681extern BT_HDR *l2cu_get_next_buffer_to_send (tL2C_LCB *p_lcb);
682extern void l2cu_resubmit_pending_sec_req (BD_ADDR p_bda);
683extern void l2cu_initialize_amp_ccb (tL2C_LCB *p_lcb);
684extern void l2cu_adjust_out_mps (tL2C_CCB *p_ccb);
685
686/* Functions provided by l2c_link.c
687************************************
688*/
689extern BOOLEAN l2c_link_hci_conn_req (BD_ADDR bd_addr);
690extern BOOLEAN l2c_link_hci_conn_comp (UINT8 status, UINT16 handle, BD_ADDR p_bda);
691extern BOOLEAN l2c_link_hci_disc_comp (UINT16 handle, UINT8 reason);
692extern BOOLEAN l2c_link_hci_qos_violation (UINT16 handle);
693extern void l2c_link_timeout (tL2C_LCB *p_lcb);
694extern void l2c_info_timeout (tL2C_LCB *p_lcb);
695extern void l2c_link_check_send_pkts (tL2C_LCB *p_lcb, tL2C_CCB *p_ccb, BT_HDR *p_buf);
696extern void l2c_link_adjust_allocation (void);
697extern void l2c_link_process_num_completed_pkts (UINT8 *p);
698extern void l2c_link_process_num_completed_blocks (UINT8 controller_id, UINT8 *p, UINT16 evt_len);
699extern void l2c_link_processs_num_bufs (UINT16 num_lm_acl_bufs);
700extern UINT8 l2c_link_pkts_rcvd (UINT16 *num_pkts, UINT16 *handles);
701extern void l2c_link_role_changed (BD_ADDR bd_addr, UINT8 new_role, UINT8 hci_status);
702extern void l2c_link_sec_comp (BD_ADDR p_bda, void *p_ref_data, UINT8 status);
703extern void l2c_link_segments_xmitted (BT_HDR *p_msg);
704extern void l2c_pin_code_request (BD_ADDR bd_addr);
705extern void l2c_link_adjust_chnl_allocation (void);
706
707#if (BLE_INCLUDED == TRUE)
708extern void l2c_link_processs_ble_num_bufs (UINT16 num_lm_acl_bufs);
709#endif
710
711#if ((BTM_PWR_MGR_INCLUDED == TRUE) && L2CAP_WAKE_PARKED_LINK == TRUE)
712extern BOOLEAN l2c_link_check_power_mode ( tL2C_LCB *p_lcb );
713#define L2C_LINK_CHECK_POWER_MODE(x) l2c_link_check_power_mode ((x))
714#else
715#define L2C_LINK_CHECK_POWER_MODE(x) (FALSE)
716#endif
717
718#if L2CAP_CONFORMANCE_TESTING == TRUE
719/* Used only for conformance testing */
720L2C_API extern void l2cu_set_info_rsp_mask (UINT32 mask);
721#endif
722
723/* Functions provided by l2c_csm.c
724************************************
725*/
726extern void l2c_csm_execute (tL2C_CCB *p_ccb, UINT16 event, void *p_data);
727
728L2C_API extern BT_HDR *l2cap_link_chk_pkt_start(BT_HDR *); /* Called at start of rcv to check L2CAP segmentation */
729L2C_API extern BOOLEAN l2cap_link_chk_pkt_end (void); /* Called at end of rcv to check L2CAP segmentation */
730
731L2C_API extern void l2c_enqueue_peer_data (tL2C_CCB *p_ccb, BT_HDR *p_buf);
732
733
734/* Functions provided by l2c_fcr.c
735************************************
736*/
737extern void l2c_fcr_cleanup (tL2C_CCB *p_ccb);
738extern void l2c_fcr_proc_pdu (tL2C_CCB *p_ccb, BT_HDR *p_buf);
739extern void l2c_fcr_proc_tout (tL2C_CCB *p_ccb);
740extern void l2c_fcr_proc_ack_tout (tL2C_CCB *p_ccb);
741extern void l2c_fcr_send_S_frame (tL2C_CCB *p_ccb, UINT16 function_code, UINT16 pf_bit);
742extern BT_HDR *l2c_fcr_clone_buf (BT_HDR *p_buf, UINT16 new_offset, UINT16 no_of_bytes, UINT8 pool);
743extern BOOLEAN l2c_fcr_is_flow_controlled (tL2C_CCB *p_ccb);
744extern BT_HDR *l2c_fcr_get_next_xmit_sdu_seg (tL2C_CCB *p_ccb, UINT16 max_packet_length);
745extern void l2c_fcr_start_timer (tL2C_CCB *p_ccb);
746
747/* Configuration negotiation */
748extern UINT8 l2c_fcr_chk_chan_modes (tL2C_CCB *p_ccb);
749extern BOOLEAN l2c_fcr_adj_our_req_options (tL2C_CCB *p_ccb, tL2CAP_CFG_INFO *p_cfg);
750extern void l2c_fcr_adj_our_rsp_options (tL2C_CCB *p_ccb, tL2CAP_CFG_INFO *p_peer_cfg);
751extern BOOLEAN l2c_fcr_renegotiate_chan(tL2C_CCB *p_ccb, tL2CAP_CFG_INFO *p_cfg);
752extern UINT8 l2c_fcr_process_peer_cfg_req(tL2C_CCB *p_ccb, tL2CAP_CFG_INFO *p_cfg);
753extern void l2c_fcr_adj_monitor_retran_timeout (tL2C_CCB *p_ccb);
754extern void l2c_fcr_stop_timer (tL2C_CCB *p_ccb);
755
756/* Functions provided by l2c_ble.c
757************************************
758*/
759#if (BLE_INCLUDED == TRUE)
760extern BOOLEAN l2cble_create_conn (tL2C_LCB *p_lcb);
761extern void l2cble_process_sig_cmd (tL2C_LCB *p_lcb, UINT8 *p, UINT16 pkt_len);
762extern void l2cble_conn_comp (UINT16 handle, UINT8 role, BD_ADDR bda, tBLE_ADDR_TYPE type,
763 UINT16 conn_interval, UINT16 conn_latency, UINT16 conn_timeout);
Ganesh Ganapathi Battaead3cde2013-02-05 15:22:31 -0800[diff] [blame]764extern BOOLEAN l2cble_init_direct_conn (tL2C_LCB *p_lcb);
The Android Open Source Project5738f832012-12-12 16:00:35 -0800[diff] [blame]765
766#endif
767
768#ifdef __cplusplus
769}
770#endif
771
772#endif