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 */ 65 typedef 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 */ 80 typedef 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 */ 159 typedef 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 168 typedef 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 174 typedef 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 182 typedef 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 254 typedef struct 255 { 256 UINT8 state; 257 tL2CAP_UCD_CB_INFO cb_info; 258 } tL2C_UCD_REG; 259 #endif 260 261 typedef 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 */ 280 typedef 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 */ 349 typedef 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 367 typedef 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 */ 380 typedef 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 438 #define UPD_ENABLED 0 /* If peer requests update, we will change params */ 439 #define UPD_DISABLED 1 /* application requested not to update */ 440 #define UPD_PENDING 2 /* while updates are disabled, peer requested new parameters */ 441 #define UPD_UPDATED 3 /* peer updated connection parameters */ 442 UINT8 upd_disabled; 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 */ 462 typedef 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 */ 527 typedef 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 538 typedef 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 554 extern "C" { 555 #endif 556 557 558 /* L2CAP global data 559 ************************************ 560 */ 561 #if (!defined L2C_DYNAMIC_MEMORY) || (L2C_DYNAMIC_MEMORY == FALSE) 562 L2C_API extern tL2C_CB l2cb; 563 #else 564 L2C_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 */ 572 extern void l2c_init (void); 573 extern void l2c_process_timeout (TIMER_LIST_ENT *p_tle); 574 extern UINT8 l2c_data_write (UINT16 cid, BT_HDR *p_data, UINT16 flag); 575 extern void l2c_rcv_acl_data (BT_HDR *p_msg); 576 extern void l2c_process_held_packets (BOOLEAN timed_out); 577 578 /* Functions provided by l2c_utils.c 579 ************************************ 580 */ 581 extern tL2C_LCB *l2cu_allocate_lcb (BD_ADDR p_bd_addr, BOOLEAN is_bonding); 582 extern BOOLEAN l2cu_start_post_bond_timer (UINT16 handle); 583 extern void l2cu_release_lcb (tL2C_LCB *p_lcb); 584 extern tL2C_LCB *l2cu_find_lcb_by_bd_addr (BD_ADDR p_bd_addr); 585 extern tL2C_LCB *l2cu_find_lcb_by_handle (UINT16 handle); 586 extern void l2cu_update_lcb_4_bonding (BD_ADDR p_bd_addr, BOOLEAN is_bonding); 587 588 extern UINT8 l2cu_get_conn_role (tL2C_LCB *p_this_lcb); 589 extern BOOLEAN l2cu_set_acl_priority (BD_ADDR bd_addr, UINT8 priority, BOOLEAN reset_after_rs); 590 591 extern void l2cu_enqueue_ccb (tL2C_CCB *p_ccb); 592 extern void l2cu_dequeue_ccb (tL2C_CCB *p_ccb); 593 extern void l2cu_change_pri_ccb (tL2C_CCB *p_ccb, tL2CAP_CHNL_PRIORITY priority); 594 595 extern tL2C_CCB *l2cu_allocate_ccb (tL2C_LCB *p_lcb, UINT16 cid); 596 extern void l2cu_release_ccb (tL2C_CCB *p_ccb); 597 extern tL2C_CCB *l2cu_find_ccb_by_cid (tL2C_LCB *p_lcb, UINT16 local_cid); 598 extern tL2C_CCB *l2cu_find_ccb_by_remote_cid (tL2C_LCB *p_lcb, UINT16 remote_cid); 599 extern void l2cu_adj_id (tL2C_LCB *p_lcb, UINT8 adj_mask); 600 601 extern void l2cu_send_peer_cmd_reject (tL2C_LCB *p_lcb, UINT16 reason, 602 UINT8 rem_id,UINT16 p1, UINT16 p2); 603 extern void l2cu_send_peer_connect_req (tL2C_CCB *p_ccb); 604 extern void l2cu_send_peer_connect_rsp (tL2C_CCB *p_ccb, UINT16 result, UINT16 status); 605 extern void l2cu_send_peer_config_req (tL2C_CCB *p_ccb, tL2CAP_CFG_INFO *p_cfg); 606 extern void l2cu_send_peer_config_rsp (tL2C_CCB *p_ccb, tL2CAP_CFG_INFO *p_cfg); 607 extern void l2cu_send_peer_config_rej (tL2C_CCB *p_ccb, UINT8 *p_data, UINT16 data_len, UINT16 rej_len); 608 extern void l2cu_send_peer_disc_req (tL2C_CCB *p_ccb); 609 extern void l2cu_send_peer_disc_rsp (tL2C_LCB *p_lcb, UINT8 remote_id, UINT16 local_cid, UINT16 remote_cid); 610 extern void l2cu_send_peer_echo_req (tL2C_LCB *p_lcb, UINT8 *p_data, UINT16 data_len); 611 extern void l2cu_send_peer_echo_rsp (tL2C_LCB *p_lcb, UINT8 id, UINT8 *p_data, UINT16 data_len); 612 extern void l2cu_send_peer_info_rsp (tL2C_LCB *p_lcb, UINT8 id, UINT16 info_type); 613 extern void l2cu_reject_connection (tL2C_LCB *p_lcb, UINT16 remote_cid, UINT8 rem_id, UINT16 result); 614 extern void l2cu_send_peer_info_req (tL2C_LCB *p_lcb, UINT16 info_type); 615 extern void l2cu_set_acl_hci_header (BT_HDR *p_buf, tL2C_CCB *p_ccb); 616 extern void l2cu_check_channel_congestion (tL2C_CCB *p_ccb); 617 extern void l2cu_disconnect_chnl (tL2C_CCB *p_ccb); 618 619 #if (L2CAP_NON_FLUSHABLE_PB_INCLUDED == TRUE) 620 extern void l2cu_set_non_flushable_pbf(BOOLEAN); 621 #endif 622 623 #if (BLE_INCLUDED == TRUE) 624 extern void l2cu_send_peer_ble_par_req (tL2C_LCB *p_lcb, UINT16 min_int, UINT16 max_int, UINT16 latency, UINT16 timeout); 625 extern void l2cu_send_peer_ble_par_rsp (tL2C_LCB *p_lcb, UINT16 reason, UINT8 rem_id); 626 #endif 627 628 extern BOOLEAN l2cu_initialize_fixed_ccb (tL2C_LCB *p_lcb, UINT16 fixed_cid, tL2CAP_FCR_OPTS *p_fcr); 629 extern void l2cu_no_dynamic_ccbs (tL2C_LCB *p_lcb); 630 extern 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) 636 void l2c_ucd_delete_sec_pending_q(tL2C_LCB *p_lcb); 637 void l2c_ucd_enqueue_pending_out_sec_q(tL2C_CCB *p_ccb, void *p_data); 638 BOOLEAN l2c_ucd_check_pending_info_req(tL2C_CCB *p_ccb); 639 BOOLEAN l2c_ucd_check_pending_out_sec_q(tL2C_CCB *p_ccb); 640 void l2c_ucd_send_pending_out_sec_q(tL2C_CCB *p_ccb); 641 void l2c_ucd_discard_pending_out_sec_q(tL2C_CCB *p_ccb); 642 BOOLEAN l2c_ucd_check_pending_in_sec_q(tL2C_CCB *p_ccb); 643 void l2c_ucd_send_pending_in_sec_q(tL2C_CCB *p_ccb); 644 void l2c_ucd_discard_pending_in_sec_q(tL2C_CCB *p_ccb); 645 BOOLEAN l2c_ucd_check_rx_pkts(tL2C_LCB *p_lcb, BT_HDR *p_msg); 646 BOOLEAN l2c_ucd_process_event(tL2C_CCB *p_ccb, UINT16 event, void *p_data); 647 #endif 648 649 #if (BLE_INCLUDED == TRUE) 650 extern void l2cu_send_peer_ble_par_req (tL2C_LCB *p_lcb, UINT16 min_int, UINT16 max_int, UINT16 latency, UINT16 timeout); 651 extern void l2cu_send_peer_ble_par_rsp (tL2C_LCB *p_lcb, UINT16 reason, UINT8 rem_id); 652 #endif 653 654 extern BOOLEAN l2cu_initialize_fixed_ccb (tL2C_LCB *p_lcb, UINT16 fixed_cid, tL2CAP_FCR_OPTS *p_fcr); 655 extern void l2cu_no_dynamic_ccbs (tL2C_LCB *p_lcb); 656 extern void l2cu_process_fixed_chnl_resp (tL2C_LCB *p_lcb); 657 658 659 /* Functions provided for Broadcom Aware 660 **************************************** 661 */ 662 extern BOOLEAN l2cu_check_feature_req (tL2C_LCB *p_lcb, UINT8 id, UINT8 *p_data, UINT16 data_len); 663 extern void l2cu_check_feature_rsp (tL2C_LCB *p_lcb, UINT8 id, UINT8 *p_data, UINT16 data_len); 664 extern void l2cu_send_feature_req (tL2C_CCB *p_ccb); 665 666 extern tL2C_RCB *l2cu_allocate_rcb (UINT16 psm); 667 extern tL2C_RCB *l2cu_find_rcb_by_psm (UINT16 psm); 668 extern void l2cu_release_rcb (tL2C_RCB *p_rcb); 669 670 extern UINT8 l2cu_process_peer_cfg_req (tL2C_CCB *p_ccb, tL2CAP_CFG_INFO *p_cfg); 671 extern void l2cu_process_peer_cfg_rsp (tL2C_CCB *p_ccb, tL2CAP_CFG_INFO *p_cfg); 672 extern void l2cu_process_our_cfg_req (tL2C_CCB *p_ccb, tL2CAP_CFG_INFO *p_cfg); 673 extern void l2cu_process_our_cfg_rsp (tL2C_CCB *p_ccb, tL2CAP_CFG_INFO *p_cfg); 674 675 extern void l2cu_device_reset (void); 676 extern tL2C_LCB *l2cu_find_lcb_by_state (tL2C_LINK_STATE state); 677 extern BOOLEAN l2cu_lcb_disconnecting (void); 678 679 extern BOOLEAN l2cu_create_conn (tL2C_LCB *p_lcb); 680 extern BOOLEAN l2cu_create_conn_after_switch (tL2C_LCB *p_lcb); 681 extern BT_HDR *l2cu_get_next_buffer_to_send (tL2C_LCB *p_lcb); 682 extern void l2cu_resubmit_pending_sec_req (BD_ADDR p_bda); 683 extern void l2cu_initialize_amp_ccb (tL2C_LCB *p_lcb); 684 extern void l2cu_adjust_out_mps (tL2C_CCB *p_ccb); 685 686 /* Functions provided by l2c_link.c 687 ************************************ 688 */ 689 extern BOOLEAN l2c_link_hci_conn_req (BD_ADDR bd_addr); 690 extern BOOLEAN l2c_link_hci_conn_comp (UINT8 status, UINT16 handle, BD_ADDR p_bda); 691 extern BOOLEAN l2c_link_hci_disc_comp (UINT16 handle, UINT8 reason); 692 extern BOOLEAN l2c_link_hci_qos_violation (UINT16 handle); 693 extern void l2c_link_timeout (tL2C_LCB *p_lcb); 694 extern void l2c_info_timeout (tL2C_LCB *p_lcb); 695 extern void l2c_link_check_send_pkts (tL2C_LCB *p_lcb, tL2C_CCB *p_ccb, BT_HDR *p_buf); 696 extern void l2c_link_adjust_allocation (void); 697 extern void l2c_link_process_num_completed_pkts (UINT8 *p); 698 extern void l2c_link_process_num_completed_blocks (UINT8 controller_id, UINT8 *p, UINT16 evt_len); 699 extern void l2c_link_processs_num_bufs (UINT16 num_lm_acl_bufs); 700 extern UINT8 l2c_link_pkts_rcvd (UINT16 *num_pkts, UINT16 *handles); 701 extern void l2c_link_role_changed (BD_ADDR bd_addr, UINT8 new_role, UINT8 hci_status); 702 extern void l2c_link_sec_comp (BD_ADDR p_bda, void *p_ref_data, UINT8 status); 703 extern void l2c_link_segments_xmitted (BT_HDR *p_msg); 704 extern void l2c_pin_code_request (BD_ADDR bd_addr); 705 extern void l2c_link_adjust_chnl_allocation (void); 706 707 #if (BLE_INCLUDED == TRUE) 708 extern 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) 712 extern 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 */ 720 L2C_API extern void l2cu_set_info_rsp_mask (UINT32 mask); 721 #endif 722 723 /* Functions provided by l2c_csm.c 724 ************************************ 725 */ 726 extern void l2c_csm_execute (tL2C_CCB *p_ccb, UINT16 event, void *p_data); 727 728 L2C_API extern BT_HDR *l2cap_link_chk_pkt_start(BT_HDR *); /* Called at start of rcv to check L2CAP segmentation */ 729 L2C_API extern BOOLEAN l2cap_link_chk_pkt_end (void); /* Called at end of rcv to check L2CAP segmentation */ 730 731 L2C_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 */ 737 extern void l2c_fcr_cleanup (tL2C_CCB *p_ccb); 738 extern void l2c_fcr_proc_pdu (tL2C_CCB *p_ccb, BT_HDR *p_buf); 739 extern void l2c_fcr_proc_tout (tL2C_CCB *p_ccb); 740 extern void l2c_fcr_proc_ack_tout (tL2C_CCB *p_ccb); 741 extern void l2c_fcr_send_S_frame (tL2C_CCB *p_ccb, UINT16 function_code, UINT16 pf_bit); 742 extern BT_HDR *l2c_fcr_clone_buf (BT_HDR *p_buf, UINT16 new_offset, UINT16 no_of_bytes, UINT8 pool); 743 extern BOOLEAN l2c_fcr_is_flow_controlled (tL2C_CCB *p_ccb); 744 extern BT_HDR *l2c_fcr_get_next_xmit_sdu_seg (tL2C_CCB *p_ccb, UINT16 max_packet_length); 745 extern void l2c_fcr_start_timer (tL2C_CCB *p_ccb); 746 747 /* Configuration negotiation */ 748 extern UINT8 l2c_fcr_chk_chan_modes (tL2C_CCB *p_ccb); 749 extern BOOLEAN l2c_fcr_adj_our_req_options (tL2C_CCB *p_ccb, tL2CAP_CFG_INFO *p_cfg); 750 extern void l2c_fcr_adj_our_rsp_options (tL2C_CCB *p_ccb, tL2CAP_CFG_INFO *p_peer_cfg); 751 extern BOOLEAN l2c_fcr_renegotiate_chan(tL2C_CCB *p_ccb, tL2CAP_CFG_INFO *p_cfg); 752 extern UINT8 l2c_fcr_process_peer_cfg_req(tL2C_CCB *p_ccb, tL2CAP_CFG_INFO *p_cfg); 753 extern void l2c_fcr_adj_monitor_retran_timeout (tL2C_CCB *p_ccb); 754 extern void l2c_fcr_stop_timer (tL2C_CCB *p_ccb); 755 756 /* Functions provided by l2c_ble.c 757 ************************************ 758 */ 759 #if (BLE_INCLUDED == TRUE) 760 extern BOOLEAN l2cble_create_conn (tL2C_LCB *p_lcb); 761 extern void l2cble_process_sig_cmd (tL2C_LCB *p_lcb, UINT8 *p, UINT16 pkt_len); 762 extern 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); 764 765 #endif 766 767 #ifdef __cplusplus 768 } 769 #endif 770 771 #endif 772