Home | History | Annotate | Download | only in l2cap
      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 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;
    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 (BD_ADDR bd_addr);
    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 extern BOOLEAN l2cble_init_direct_conn (tL2C_LCB *p_lcb);
    765 
    766 #endif
    767 
    768 #ifdef __cplusplus
    769 }
    770 #endif
    771 
    772 #endif
    773