Home | History | Annotate | Download | only in btm
      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 the main Bluetooth Manager (BTM) internal
     22  *  definitions.
     23  *
     24  ******************************************************************************/
     25 #ifndef BTM_INT_H
     26 #define BTM_INT_H
     27 
     28 #include "bt_target.h"
     29 #include "gki.h"
     30 #include "hcidefs.h"
     31 
     32 #if RFCOMM_INCLUDED == TRUE
     33 #include "rfcdefs.h"
     34 #endif
     35 
     36 #include "btm_api.h"
     37 
     38 #if (BLE_INCLUDED == TRUE)
     39 #include "btm_ble_int.h"
     40 #if (SMP_INCLUDED == TRUE)
     41 #include "smp_api.h"
     42 #endif
     43 #endif
     44 
     45 #if BTM_MAX_LOC_BD_NAME_LEN > 0
     46 typedef char tBTM_LOC_BD_NAME[BTM_MAX_LOC_BD_NAME_LEN + 1];
     47 #endif
     48 
     49 #define  BTM_ACL_IS_CONNECTED(bda)   (btm_bda_to_acl (bda) != NULL)
     50 
     51 /* Definitions for Server Channel Number (SCN) management
     52 */
     53 #define BTM_MAX_SCN      PORT_MAX_RFC_PORTS
     54 
     55 /* Definition for number of the remote device role saved
     56 */
     57 #define BTM_ROLE_DEVICE_NUM      4
     58 
     59 /* Define masks for supported and exception 2.0 ACL packet types
     60 */
     61 #define BTM_ACL_SUPPORTED_PKTS_MASK      (HCI_PKT_TYPES_MASK_DM1        | \
     62                                           HCI_PKT_TYPES_MASK_DH1        | \
     63                                           HCI_PKT_TYPES_MASK_DM3        | \
     64                                           HCI_PKT_TYPES_MASK_DH3        | \
     65                                           HCI_PKT_TYPES_MASK_DM5        | \
     66                                           HCI_PKT_TYPES_MASK_DH5)
     67 
     68 #define BTM_ACL_EXCEPTION_PKTS_MASK      (HCI_PKT_TYPES_MASK_NO_2_DH1   | \
     69                                           HCI_PKT_TYPES_MASK_NO_3_DH1   | \
     70                                           HCI_PKT_TYPES_MASK_NO_2_DH3   | \
     71                                           HCI_PKT_TYPES_MASK_NO_3_DH3   | \
     72                                           HCI_PKT_TYPES_MASK_NO_2_DH5   | \
     73                                           HCI_PKT_TYPES_MASK_NO_3_DH5)
     74 
     75 #define BTM_EPR_AVAILABLE(p) ((HCI_ATOMIC_ENCRYPT_SUPPORTED((p)->peer_lmp_features[HCI_EXT_FEATURES_PAGE_0]) && \
     76                                HCI_ATOMIC_ENCRYPT_SUPPORTED(btm_cb.devcb.local_lmp_features[HCI_EXT_FEATURES_PAGE_0])) \
     77                                ? TRUE : FALSE)
     78 
     79 #define BTM_IS_BRCM_CONTROLLER() (btm_cb.devcb.local_version.manufacturer == LMP_COMPID_BROADCOM)
     80 
     81 /* Define the ACL Management control structure
     82 */
     83 typedef struct
     84 {
     85     UINT16          hci_handle;
     86     UINT16          pkt_types_mask;
     87     UINT16          restore_pkt_types;  /* when coming in/out of SCO connection restore the packet types */
     88     UINT16          clock_offset;
     89     BD_ADDR         remote_addr;
     90     DEV_CLASS       remote_dc;
     91     BD_NAME         remote_name;
     92 
     93     UINT16          manufacturer;
     94     UINT16          lmp_subversion;
     95     UINT16          link_super_tout;
     96     BD_FEATURES     peer_lmp_features[HCI_EXT_FEATURES_PAGE_MAX + 1];    /* Peer LMP Extended features mask table for the device */
     97     UINT8           num_read_pages;
     98     UINT8           lmp_version;
     99 
    100     BOOLEAN         in_use;
    101     UINT8           link_role;
    102     BOOLEAN         link_up_issued;     /* True if busy_level link up has been issued */
    103 
    104 #define BTM_ACL_SWKEY_STATE_IDLE                0
    105 #define BTM_ACL_SWKEY_STATE_MODE_CHANGE         1
    106 #define BTM_ACL_SWKEY_STATE_ENCRYPTION_OFF      2
    107 #define BTM_ACL_SWKEY_STATE_SWITCHING           3
    108 #define BTM_ACL_SWKEY_STATE_ENCRYPTION_ON       4
    109 #define BTM_ACL_SWKEY_STATE_IN_PROGRESS         5
    110     UINT8           switch_role_state;
    111     UINT8           change_key_state;
    112 
    113 #define BTM_ACL_ENCRYPT_STATE_IDLE              0
    114 #define BTM_ACL_ENCRYPT_STATE_ENCRYPT_OFF       1   /* encryption turning off */
    115 #define BTM_ACL_ENCRYPT_STATE_TEMP_FUNC         2   /* temporarily off for change link key or role switch */
    116 #define BTM_ACL_ENCRYPT_STATE_ENCRYPT_ON        3   /* encryption turning on */
    117     UINT8           encrypt_state;                  /* overall BTM encryption state */
    118 
    119 #if BTM_PWR_MGR_INCLUDED == FALSE
    120     UINT8           mode;
    121 #endif /* BTM_PWR_MGR_INCLUDED */
    122 #if BLE_INCLUDED == TRUE
    123     UINT8           is_le_link;
    124     BD_ADDR         conn_addr;              /* local device address used for this connection */
    125     UINT8           conn_addr_type;         /* local device address type for this connection */
    126     BD_ADDR         active_remote_addr;     /* remote address used on this connection */
    127     UINT8           active_remote_addr_type;         /* local device address type for this connection */
    128     BD_FEATURES     peer_le_features;       /* Peer LE Used features mask for the device */
    129 
    130 #endif
    131 
    132 } tACL_CONN;
    133 
    134 /*****************************************************
    135 ** TIMER Definitions
    136 ******************************************************/
    137 #define TT_DEV_RESET     1
    138 #define TT_DEV_RLN       2
    139 #define TT_DEV_RLNKP     4              /* Read Link Policy Settings */
    140 
    141 /* Define the Device Management control structure
    142 */
    143 typedef struct
    144 {
    145     tBTM_DEV_STATUS_CB  *p_dev_status_cb;   /* Device status change callback        */
    146     tBTM_VS_EVT_CB      *p_vend_spec_cb[BTM_MAX_VSE_CALLBACKS];     /* Register for vendor specific events  */
    147 
    148     tBTM_CMPL_CB        *p_stored_link_key_cmpl_cb;   /* Read/Write/Delete stored link key    */
    149 
    150     TIMER_LIST_ENT       reset_timer;
    151     tBTM_CMPL_CB        *p_reset_cmpl_cb;   /* Callback function to be called       */
    152                                             /* when startup of the device is done   */
    153     TIMER_LIST_ENT       rln_timer;
    154     tBTM_CMPL_CB        *p_rln_cmpl_cb;     /* Callback function to be called when  */
    155                                             /* read local name function complete    */
    156     TIMER_LIST_ENT       rlinkp_timer;
    157     tBTM_CMPL_CB        *p_rlinkp_cmpl_cb;  /* Callback function to be called when  */
    158                                             /* read link policy function completes  */
    159     TIMER_LIST_ENT       rssi_timer;
    160     tBTM_CMPL_CB        *p_rssi_cmpl_cb;    /* Callback function to be called when  */
    161                                             /* read rssi function completes         */
    162     TIMER_LIST_ENT       lnk_quality_timer;
    163     tBTM_CMPL_CB        *p_lnk_qual_cmpl_cb;/* Callback function to be called when  */
    164                                             /* read link quality function completes */
    165     TIMER_LIST_ENT       txpwer_timer;
    166     tBTM_CMPL_CB        *p_txpwer_cmpl_cb;    /* Callback function to be called when  */
    167                                             /* read inq tx power function completes  */
    168 
    169     TIMER_LIST_ENT       qossu_timer;
    170     tBTM_CMPL_CB        *p_qossu_cmpl_cb;   /* Callback function to be called when  */
    171                                             /* qos setup function completes         */
    172 
    173     tBTM_ROLE_SWITCH_CMPL switch_role_ref_data;
    174     tBTM_CMPL_CB        *p_switch_role_cb;  /* Callback function to be called when  */
    175                                             /* requested switch role is completed   */
    176 
    177     tBTM_CHANGE_KEY_CMPL chg_link_key_ref_data;
    178     tBTM_CMPL_CB        *p_chg_link_key_cb; /* Callback function to be called when  */
    179                                             /* change of link key is completed      */
    180 
    181     TIMER_LIST_ENT       tx_power_timer;
    182     tBTM_CMPL_CB        *p_tx_power_cmpl_cb;/* Callback function to be called       */
    183 
    184     BD_ADDR              local_addr;        /* BD_ADDR of the local device          */
    185     tBTM_VERSION_INFO    local_version;     /* Local Version Information            */
    186     DEV_CLASS            dev_class;         /* Local device class                   */
    187 
    188     /* Local LMP Extended features mask table for the device */
    189     BD_FEATURES          local_lmp_features[HCI_EXT_FEATURES_PAGE_MAX + 1];
    190 
    191 #if BLE_INCLUDED == TRUE
    192     BD_ADDR                 read_tx_pwr_addr;   /* read TX power target address     */
    193     BD_FEATURES             local_le_features;  /* Local LE Supported features mask for the device */
    194 
    195     tBTM_BLE_LOCAL_ID_KEYS  id_keys;        /* local BLE ID keys                    */
    196     BT_OCTET16              er;             /* BLE encryption key                   */
    197 
    198 #if BTM_BLE_CONFORMANCE_TESTING == TRUE
    199     BOOLEAN                 no_disc_if_pair_fail;
    200     BOOLEAN			        enable_test_mac_val;
    201     BT_OCTET8               test_mac;
    202     BOOLEAN			        enable_test_local_sign_cntr;
    203     UINT32			        test_local_sign_cntr;
    204 #endif
    205 
    206 #if BLE_INCLUDED == TRUE
    207     tBTM_CMPL_CB        *p_le_test_cmd_cmpl_cb;   /* Callback function to be called when
    208                                                   LE test mode command has been sent successfully */
    209 #endif
    210 
    211 #endif  /* BLE_INCLUDED */
    212 
    213 #define BTM_DEV_STATE_WAIT_RESET_CMPLT  0
    214 #define BTM_DEV_STATE_WAIT_AFTER_RESET  1
    215 #define BTM_DEV_STATE_READY             2
    216 
    217     UINT8                state;
    218     tBTM_IO_CAP          loc_io_caps;       /* IO capability of the local device */
    219     BOOLEAN              loc_auth_req;      /* the auth_req flag  */
    220     BD_FEATURES          brcm_features;     /* Broadcom specific features bit mask  */
    221 
    222 #define BTM_RE_READ_1ST_PAGE            0x01            /* Set it if you set at least one of "..._HOST_MAY_SUPP_..." bits */
    223 #define BTM_HOST_MAY_SUPP_SSP           0x02
    224 #define BTM_HOST_MAY_SUPP_LE            0x04
    225 #define BTM_HOST_MAY_SUPP_SIMULT_BR_LE  0x08
    226     UINT8               lmp_features_host_may_support;  /* The flags of LMP features host may support via BR/EDR ctrlr + BTM_RE_READ_1ST_PAGE */
    227     UINT8               supported_cmds[HCI_NUM_SUPP_COMMANDS_BYTES]; /* Supported Commands bit field */
    228 
    229 } tBTM_DEVCB;
    230 
    231 
    232 /* Define the structures and constants used for inquiry
    233 */
    234 
    235 /* Definitions of limits for inquiries */
    236 #define BTM_PER_INQ_MIN_MAX_PERIOD      HCI_PER_INQ_MIN_MAX_PERIOD
    237 #define BTM_PER_INQ_MAX_MAX_PERIOD      HCI_PER_INQ_MAX_MAX_PERIOD
    238 #define BTM_PER_INQ_MIN_MIN_PERIOD      HCI_PER_INQ_MIN_MIN_PERIOD
    239 #define BTM_PER_INQ_MAX_MIN_PERIOD      HCI_PER_INQ_MAX_MIN_PERIOD
    240 #define BTM_MAX_INQUIRY_LENGTH          HCI_MAX_INQUIRY_LENGTH
    241 #define BTM_MIN_INQUIRY_LEN             0x01
    242 
    243 #define BTM_MIN_INQ_TX_POWER    -70
    244 #define BTM_MAX_INQ_TX_POWER    20
    245 
    246 #if BTM_USE_INQ_RESULTS_FILTER == TRUE
    247 typedef struct
    248 {
    249     UINT32          inq_count;          /* Used for determining if a response has already been      */
    250                                         /* received for the current inquiry operation. (We do not   */
    251                                         /* want to flood the caller with multiple responses from    */
    252                                         /* the same device.                                         */
    253     BD_ADDR         bd_addr;
    254 } tINQ_BDADDR;
    255 #endif
    256 
    257 typedef struct
    258 {
    259     UINT32          time_of_resp;
    260     UINT32          inq_count;          /* "timestamps" the entry with a particular inquiry count   */
    261                                         /* Used for determining if a response has already been      */
    262                                         /* received for the current inquiry operation. (We do not   */
    263                                         /* want to flood the caller with multiple responses from    */
    264                                         /* the same device.                                         */
    265     tBTM_INQ_INFO   inq_info;
    266     BOOLEAN         in_use;
    267 
    268 #if (BLE_INCLUDED == TRUE)
    269     BOOLEAN         scan_rsp;
    270 #endif
    271 } tINQ_DB_ENT;
    272 
    273 
    274 enum
    275 {
    276     INQ_NONE,
    277     INQ_LE_OBSERVE,
    278     INQ_GENERAL
    279 };
    280 typedef UINT8 tBTM_INQ_TYPE;
    281 
    282 typedef struct
    283 {
    284     tBTM_CMPL_CB *p_remname_cmpl_cb;
    285 
    286 #define BTM_EXT_RMT_NAME_TIMEOUT    40
    287 
    288 
    289     TIMER_LIST_ENT  rmt_name_timer_ent;
    290 
    291     UINT16           discoverable_mode;
    292     UINT16           connectable_mode;
    293     UINT16           page_scan_window;
    294     UINT16           page_scan_period;
    295     UINT16           inq_scan_window;
    296     UINT16           inq_scan_period;
    297     UINT16           inq_scan_type;
    298     UINT16           page_scan_type;        /* current page scan type */
    299     tBTM_INQ_TYPE    scan_type;
    300 
    301     BD_ADDR          remname_bda;           /* Name of bd addr for active remote name request */
    302 #define BTM_RMT_NAME_INACTIVE       0
    303 #define BTM_RMT_NAME_EXT            0x1     /* Initiated through API */
    304 #define BTM_RMT_NAME_SEC            0x2     /* Initiated internally by security manager */
    305 #define BTM_RMT_NAME_INQ            0x4     /* Remote name initiated internally by inquiry */
    306     BOOLEAN          remname_active;        /* State of a remote name request by external API */
    307 
    308     tBTM_CMPL_CB    *p_inq_cmpl_cb;
    309     tBTM_INQ_RESULTS_CB *p_inq_results_cb;
    310     tBTM_CMPL_CB    *p_inq_ble_cmpl_cb;     /*completion callback exclusively for LE Observe*/
    311     tBTM_INQ_RESULTS_CB *p_inq_ble_results_cb;/*results callback exclusively for LE observe*/
    312     tBTM_CMPL_CB    *p_inqfilter_cmpl_cb;   /* Called (if not NULL) after inquiry filter completed */
    313     tBTM_INQ_DB_CHANGE_CB *p_inq_change_cb; /* Inquiry database changed callback    */
    314     UINT32           inq_counter;           /* Counter incremented each time an inquiry completes */
    315                                             /* Used for determining whether or not duplicate devices */
    316                                             /* have responded to the same inquiry */
    317     TIMER_LIST_ENT   inq_timer_ent;
    318 #if BTM_USE_INQ_RESULTS_FILTER == TRUE
    319     tINQ_BDADDR     *p_bd_db;               /* Pointer to memory that holds bdaddrs */
    320     UINT16           num_bd_entries;        /* Number of entries in database */
    321     UINT16           max_bd_entries;        /* Maximum number of entries that can be stored */
    322 #endif
    323     tINQ_DB_ENT      inq_db[BTM_INQ_DB_SIZE];
    324     tBTM_INQ_PARMS   inqparms;              /* Contains the parameters for the current inquiry */
    325     tBTM_INQUIRY_CMPL inq_cmpl_info;        /* Status and number of responses from the last inquiry */
    326 
    327     UINT16           per_min_delay;         /* Current periodic minimum delay */
    328     UINT16           per_max_delay;         /* Current periodic maximum delay */
    329     BOOLEAN          inqfilt_active;
    330     UINT8            pending_filt_complete_event; /* to take care of btm_event_filter_complete corresponding to */
    331                                                   /* inquiry that has been cancelled*/
    332     UINT8            inqfilt_type;          /* Contains the inquiry filter type (BD ADDR, COD, or Clear) */
    333 
    334 #define BTM_INQ_INACTIVE_STATE      0
    335 #define BTM_INQ_CLR_FILT_STATE      1   /* Currently clearing the inquiry filter preceeding the inquiry request */
    336                                         /* (bypassed if filtering is not used)                                  */
    337 #define BTM_INQ_SET_FILT_STATE      2   /* Sets the new filter (or turns off filtering) in this state */
    338 #define BTM_INQ_ACTIVE_STATE        3   /* Actual inquiry or periodic inquiry is in progress */
    339 #define BTM_INQ_REMNAME_STATE       4   /* Remote name requests are active  */
    340 
    341     UINT8            state;             /* Current state that the inquiry process is in */
    342     UINT8            inq_active;        /* Bit Mask indicating type of inquiry is active */
    343     BOOLEAN          no_inc_ssp;        /* TRUE, to stop inquiry on incoming SSP */
    344 #if (defined(BTA_HOST_INTERLEAVE_SEARCH) && BTA_HOST_INTERLEAVE_SEARCH == TRUE)
    345     btm_inq_state    next_state;        /*interleaving state to determine next mode to be inquired*/
    346 #endif
    347 } tBTM_INQUIRY_VAR_ST;
    348 
    349 /* The MSB of the clock offset field indicates that the offset is valid if TRUE */
    350 #define BTM_CLOCK_OFFSET_VALID      0x8000
    351 
    352 /* Define the structures needed by security management
    353 */
    354 
    355 #define BTM_SEC_INVALID_HANDLE  0xFFFF
    356 
    357 typedef UINT8 *BTM_BD_NAME_PTR;                        /* Pointer to Device name */
    358 
    359 /* Security callback is called by this unit when security
    360 **   procedures are completed.  Parameters are
    361 **              BD Address of remote
    362 **              Result of the operation
    363 */
    364 typedef tBTM_SEC_CBACK tBTM_SEC_CALLBACK;
    365 
    366 typedef void (tBTM_SCO_IND_CBACK) (UINT16 sco_inx) ;
    367 
    368 /* MACROs to convert from SCO packet types mask to ESCO and back */
    369 #define BTM_SCO_PKT_TYPE_MASK   (   HCI_PKT_TYPES_MASK_HV1      \
    370                                  |  HCI_PKT_TYPES_MASK_HV2      \
    371                                  |  HCI_PKT_TYPES_MASK_HV3)
    372 
    373 /* Mask defining only the SCO types of an esco packet type */
    374 #define BTM_ESCO_PKT_TYPE_MASK  (   HCI_ESCO_PKT_TYPES_MASK_HV1 \
    375                                  |  HCI_ESCO_PKT_TYPES_MASK_HV2 \
    376                                  |  HCI_ESCO_PKT_TYPES_MASK_HV3)
    377 
    378 #define BTM_SCO_2_ESCO(scotype)  ((UINT16)(((scotype) & BTM_SCO_PKT_TYPE_MASK) >> 5))
    379 #define BTM_ESCO_2_SCO(escotype) ((UINT16)(((escotype) & BTM_ESCO_PKT_TYPE_MASK) << 5))
    380 
    381 /* Define masks for supported and exception 2.0 SCO packet types
    382 */
    383 #define BTM_SCO_SUPPORTED_PKTS_MASK      (HCI_ESCO_PKT_TYPES_MASK_HV1       | \
    384                                           HCI_ESCO_PKT_TYPES_MASK_HV2       | \
    385                                           HCI_ESCO_PKT_TYPES_MASK_HV3       | \
    386                                           HCI_ESCO_PKT_TYPES_MASK_EV3       | \
    387                                           HCI_ESCO_PKT_TYPES_MASK_EV4       | \
    388                                           HCI_ESCO_PKT_TYPES_MASK_EV5)
    389 
    390 #define BTM_SCO_EXCEPTION_PKTS_MASK      (HCI_ESCO_PKT_TYPES_MASK_NO_2_EV3  | \
    391                                           HCI_ESCO_PKT_TYPES_MASK_NO_3_EV3  | \
    392                                           HCI_ESCO_PKT_TYPES_MASK_NO_2_EV5  | \
    393                                           HCI_ESCO_PKT_TYPES_MASK_NO_3_EV5)
    394 
    395 
    396 #define BTM_SCO_ROUTE_UNKNOWN       0xff
    397 
    398 /* Define the structure that contains (e)SCO data */
    399 typedef struct
    400 {
    401     tBTM_ESCO_CBACK    *p_esco_cback;   /* Callback for eSCO events     */
    402     tBTM_ESCO_PARAMS    setup;
    403     tBTM_ESCO_DATA      data;           /* Connection complete information */
    404     UINT8               hci_status;
    405 } tBTM_ESCO_INFO;
    406 
    407 /* Define the structure used for SCO Management
    408 */
    409 typedef struct
    410 {
    411     tBTM_ESCO_INFO   esco;              /* Current settings             */
    412 #if BTM_SCO_HCI_INCLUDED == TRUE
    413     BUFFER_Q         xmit_data_q;       /* SCO data transmitting queue  */
    414 #endif
    415     tBTM_SCO_CB     *p_conn_cb;         /* Callback for when connected  */
    416     tBTM_SCO_CB     *p_disc_cb;         /* Callback for when disconnect */
    417     UINT16           state;             /* The state of the SCO link    */
    418     UINT16           hci_handle;        /* HCI Handle                   */
    419     BOOLEAN          is_orig;           /* TRUE if the originator       */
    420     BOOLEAN          rem_bd_known;      /* TRUE if remote BD addr known */
    421 
    422 } tSCO_CONN;
    423 
    424 /* SCO Management control block */
    425 typedef struct
    426 {
    427     tBTM_SCO_IND_CBACK  *app_sco_ind_cb;
    428 #if BTM_SCO_HCI_INCLUDED == TRUE
    429     tBTM_SCO_DATA_CB     *p_data_cb;        /* Callback for SCO data over HCI */
    430     UINT32               xmit_window_size; /* Total SCO window in bytes  */
    431 #endif
    432     tSCO_CONN            sco_db[BTM_MAX_SCO_LINKS];
    433     tBTM_ESCO_PARAMS     def_esco_parms;
    434     BD_ADDR              xfer_addr;
    435     UINT16               sco_disc_reason;
    436     BOOLEAN              esco_supported;    /* TRUE if 1.2 cntlr AND supports eSCO links */
    437     tBTM_SCO_TYPE        desired_sco_mode;
    438     tBTM_SCO_TYPE        xfer_sco_type;
    439     tBTM_SCO_PCM_PARAM   sco_pcm_param;
    440     tBTM_SCO_CODEC_TYPE  codec_in_use;      /* None, CVSD, MSBC, etc. */
    441 #if BTM_SCO_HCI_INCLUDED == TRUE
    442 	tBTM_SCO_ROUTE_TYPE	 sco_path;
    443 #endif
    444 
    445 } tSCO_CB;
    446 
    447 
    448 #if BTM_SCO_INCLUDED == TRUE
    449 extern void     btm_set_sco_ind_cback( tBTM_SCO_IND_CBACK *sco_ind_cb );
    450 extern void     btm_accept_sco_link(UINT16 sco_inx, tBTM_ESCO_PARAMS *p_setup,
    451                                     tBTM_SCO_CB *p_conn_cb, tBTM_SCO_CB *p_disc_cb);
    452 extern void     btm_reject_sco_link(UINT16 sco_inx );
    453 extern void btm_sco_chk_pend_rolechange (UINT16 hci_handle);
    454 #else
    455 #define btm_accept_sco_link(sco_inx, p_setup, p_conn_cb, p_disc_cb)
    456 #define btm_reject_sco_link(sco_inx)
    457 #define btm_set_sco_ind_cback(sco_ind_cb)
    458 #define btm_sco_chk_pend_rolechange(hci_handle)
    459 #endif  /* BTM_SCO_INCLUDED */
    460 
    461 /*
    462 ** Define structure for Security Service Record.
    463 ** A record exists for each service registered with the Security Manager
    464 */
    465 typedef struct
    466 {
    467     UINT32          mx_proto_id;        /* Service runs over this multiplexer protocol */
    468     UINT32          orig_mx_chan_id;    /* Channel on the multiplexer protocol    */
    469     UINT32          term_mx_chan_id;    /* Channel on the multiplexer protocol    */
    470     UINT16          psm;                /* L2CAP PSM value */
    471     UINT16          security_flags;     /* Bitmap of required security features */
    472     UINT8           service_id;         /* Passed in authorization callback */
    473 #if (L2CAP_UCD_INCLUDED == TRUE)
    474     UINT16          ucd_security_flags; /* Bitmap of required security features for UCD */
    475 #endif
    476 #if BTM_SEC_SERVICE_NAME_LEN > 0
    477     UINT8           orig_service_name[BTM_SEC_SERVICE_NAME_LEN + 1];
    478     UINT8           term_service_name[BTM_SEC_SERVICE_NAME_LEN + 1];
    479 #endif
    480 } tBTM_SEC_SERV_REC;
    481 
    482 #if BLE_INCLUDED == TRUE
    483 /* LE Security information of device in Slave Role */
    484 typedef struct
    485 {
    486     BT_OCTET16          irk;            /* peer diverified identity root */
    487     BT_OCTET16          ltk;            /* peer long term key */
    488     BT_OCTET16          csrk;           /* peer SRK peer device used to secured sign local data  */
    489 
    490     BT_OCTET8           rand;           /* random vector for LTK generation */
    491     UINT16              ediv;           /* LTK diversifier of this slave device */
    492     UINT16              div;            /* local DIV  to generate local LTK=d1(ER,DIV,0) and CSRK=d1(ER,DIV,1)  */
    493     UINT8               sec_level;      /* local pairing security level */
    494     UINT8               key_size;       /* key size of the LTK delivered to peer device */
    495     UINT8               srk_sec_level;  /* security property of peer SRK for this device */
    496     UINT8               local_csrk_sec_level;  /* security property of local CSRK for this device */
    497 
    498     UINT32              counter;        /* peer sign counter for verifying rcv signed cmd */
    499     UINT32              local_counter;  /* local sign counter for sending signed write cmd*/
    500 }tBTM_SEC_BLE_KEYS;
    501 
    502 #endif  /* BLE_INCLUDED */
    503 
    504 typedef struct
    505 {
    506     tBLE_ADDR_TYPE      ble_addr_type;  /* LE device type: public or random address */
    507     tBLE_ADDR_TYPE      static_addr_type;   /* static address type */
    508     BD_ADDR             static_addr;    /* static address */
    509 
    510 #if SMP_INCLUDED == TRUE
    511     tBTM_LE_KEY_TYPE    key_type;       /* bit mask of valid key types in record */
    512     tBTM_SEC_BLE_KEYS   keys;           /* LE device security info in slave rode */
    513 #endif
    514 } tBTM_SEC_BLE;
    515 
    516 /*
    517 ** Define structure for Security Device Record.
    518 ** A record exists for each device authenticated with this device
    519 */
    520 typedef struct
    521 {
    522     tBTM_SEC_SERV_REC   *p_cur_service;
    523     tBTM_SEC_CALLBACK   *p_callback;
    524     void                *p_ref_data;
    525     UINT32               timestamp;         /* Timestamp of the last connection   */
    526     UINT32               trusted_mask[BTM_SEC_SERVICE_ARRAY_SIZE];  /* Bitwise OR of trusted services     */
    527     UINT16               hci_handle;        /* Handle to connection when exists   */
    528     UINT16               clock_offset;      /* Latest known clock offset          */
    529     BD_ADDR              bd_addr;           /* BD_ADDR of the device              */
    530     DEV_CLASS            dev_class;         /* DEV_CLASS of the device            */
    531     LINK_KEY             link_key;          /* Device link key                    */
    532 
    533 #define BTM_SEC_AUTHORIZED      BTM_SEC_FLAG_AUTHORIZED     /* 0x01 */
    534 #define BTM_SEC_AUTHENTICATED   BTM_SEC_FLAG_AUTHENTICATED  /* 0x02 */
    535 #define BTM_SEC_ENCRYPTED       BTM_SEC_FLAG_ENCRYPTED      /* 0x04 */
    536 #define BTM_SEC_NAME_KNOWN      0x08
    537 #define BTM_SEC_LINK_KEY_KNOWN  BTM_SEC_FLAG_LKEY_KNOWN /* 0x10 */
    538 #define BTM_SEC_LINK_KEY_AUTHED 0x20
    539 #define BTM_SEC_ROLE_SWITCHED   0x40
    540 #define BTM_SEC_IN_USE          0x80
    541 
    542     UINT8           sec_flags;          /* Current device security state      */
    543 
    544     tBTM_BD_NAME    sec_bd_name;        /* User friendly name of the device. (may be truncated to save space in dev_rec table) */
    545     BD_FEATURES     features[HCI_EXT_FEATURES_PAGE_MAX + 1];           /* Features supported by the device */
    546     UINT8           num_read_pages;
    547 
    548 #define BTM_SEC_STATE_IDLE              0
    549 #define BTM_SEC_STATE_AUTHENTICATING    1
    550 #define BTM_SEC_STATE_ENCRYPTING        2
    551 #define BTM_SEC_STATE_GETTING_NAME      3
    552 #define BTM_SEC_STATE_AUTHORIZING       4
    553 #define BTM_SEC_STATE_SWITCHING_ROLE    5
    554 #define BTM_SEC_STATE_DISCONNECTING     6
    555 #define BTM_SEC_STATE_DELAY_FOR_ENC     7   /* delay to check for encryption to work around controller problems */
    556 
    557     UINT8       sec_state;              /* Operating state                    */
    558     BOOLEAN     is_originator;          /* TRUE if device is originating connection */
    559 #if (L2CAP_UCD_INCLUDED == TRUE)
    560     BOOLEAN     is_ucd;                 /* TRUE if device is sending or receiving UCD */
    561                                         /* if incoming security failed, received UCD will be discarded */
    562 #endif
    563     BOOLEAN     role_master;            /* TRUE if current mode is master     */
    564     UINT16      security_required;      /* Security required for connection   */
    565     BOOLEAN     link_key_not_sent;      /* link key notification has not been sent waiting for name */
    566     UINT8       link_key_type;          /* Type of key used in pairing   */
    567     BOOLEAN     link_key_changed;       /* Changed link key during current connection */
    568 
    569 #define BTM_MAX_PRE_SM4_LKEY_TYPE   BTM_LKEY_TYPE_REMOTE_UNIT /* the link key type used by legacy pairing */
    570 
    571 #define BTM_SM4_UNKNOWN     0x00
    572 #define BTM_SM4_KNOWN       0x10
    573 #define BTM_SM4_TRUE        0x11
    574 #define BTM_SM4_REQ_PEND    0x08        /* set this bit when getting remote features */
    575 #define BTM_SM4_UPGRADE     0x04        /* set this bit when upgrading link key */
    576 #define BTM_SM4_RETRY       0x02        /* set this bit to retry on HCI_ERR_KEY_MISSING or HCI_ERR_LMP_ERR_TRANS_COLLISION */
    577 #define BTM_SM4_DD_ACP      0x20        /* set this bit to indicate peer initiated dedicated bonding */
    578 #define BTM_SM4_CONN_PEND   0x40        /* set this bit to indicate accepting acl conn; to be cleared on btm_acl_created */
    579     UINT8       sm4;                    /* BTM_SM4_TRUE, if the peer supports SM4 */
    580     tBTM_IO_CAP rmt_io_caps;            /* IO capability of the peer device */
    581     BOOLEAN     rmt_auth_req;           /* the auth_req flag as in the IO caps rsp evt */
    582 
    583 #if (BLE_INCLUDED == TRUE)
    584     UINT8               enc_key_size;           /* current link encryption key size */
    585     tBTM_SEC_BLE        ble;
    586     tBT_DEVICE_TYPE     device_type;
    587     tBTM_LE_CONN_PRAMS  conn_params;
    588 #endif
    589 
    590 // btla-specific ++
    591 #if BTM_DISC_DURING_RS == TRUE
    592 #define BTM_SEC_RS_NOT_PENDING          0           /* Role Switch not in progress */
    593 #define BTM_SEC_RS_PENDING              1           /* Role Switch in progress */
    594 #define BTM_SEC_DISC_PENDING            2           /* Disconnect is pending */
    595     UINT8           rs_disc_pending;
    596 #endif
    597 // btla-specific --
    598 #define BTM_SEC_NO_LAST_SERVICE_ID      0
    599     UINT8           last_author_service_id;         /* ID of last serviced authorized: Reset after each l2cap connection */
    600 
    601 } tBTM_SEC_DEV_REC;
    602 
    603 #define BTM_SEC_IS_SM4(sm) ((BOOLEAN)(BTM_SM4_TRUE == ((sm)&BTM_SM4_TRUE)))
    604 #define BTM_SEC_IS_SM4_LEGACY(sm) ((BOOLEAN)(BTM_SM4_KNOWN == ((sm)&BTM_SM4_TRUE)))
    605 #define BTM_SEC_IS_SM4_UNKNOWN(sm) ((BOOLEAN)(BTM_SM4_UNKNOWN == ((sm)&BTM_SM4_TRUE)))
    606 
    607 
    608 /*
    609 ** Define device configuration structure
    610 */
    611 typedef struct
    612 {
    613 #if BTM_MAX_LOC_BD_NAME_LEN > 0
    614     tBTM_LOC_BD_NAME bd_name;                    /* local Bluetooth device name */
    615 #endif
    616     BOOLEAN          pin_type;                   /* TRUE if PIN type is fixed */
    617     UINT8            pin_code_len;               /* Bonding information */
    618     PIN_CODE         pin_code;                   /* PIN CODE if pin type is fixed */
    619     BOOLEAN          connectable;                /* If TRUE page scan should be enabled */
    620     UINT8            def_inq_scan_mode;          /* ??? limited/general/none */
    621 } tBTM_CFG;
    622 
    623 #if BTM_PWR_MGR_INCLUDED == TRUE
    624 enum
    625 {
    626     BTM_PM_ST_ACTIVE  = BTM_PM_STS_ACTIVE,
    627     BTM_PM_ST_HOLD    = BTM_PM_STS_HOLD,
    628     BTM_PM_ST_SNIFF   = BTM_PM_STS_SNIFF,
    629     BTM_PM_ST_PARK    = BTM_PM_STS_PARK,
    630     BTM_PM_ST_PENDING = BTM_PM_STS_PENDING
    631 };
    632 typedef UINT8 tBTM_PM_STATE;
    633 
    634 enum
    635 {
    636     BTM_PM_SET_MODE_EVT,    /* Set power mode API is called. */
    637     BTM_PM_UPDATE_EVT,
    638     BTM_PM_RD_MODE_EVT     /* Read power mode API is called. */
    639 };
    640 typedef UINT8 tBTM_PM_EVENT;
    641 
    642 typedef struct
    643 {
    644     UINT16          event;
    645     UINT16          len;
    646     UINT8           link_ind;
    647 } tBTM_PM_MSG_DATA;
    648 
    649 typedef struct
    650 {
    651     UINT8 hci_status;
    652     UINT8 mode;
    653     UINT16 interval;
    654 } tBTM_PM_MD_CHG_DATA;
    655 
    656 typedef struct
    657 {
    658     UINT8          pm_id;      /* the entity that calls SetPowerMode API */
    659     tBTM_PM_PWR_MD *p_pmd;
    660 } tBTM_PM_SET_MD_DATA;
    661 
    662 typedef struct
    663 {
    664     void        *p_data;
    665     UINT8        link_ind;
    666 } tBTM_PM_SM_DATA;
    667 
    668 typedef struct
    669 {
    670     tBTM_PM_PWR_MD req_mode[BTM_MAX_PM_RECORDS+1]; /* the desired mode and parameters of the connection*/
    671     tBTM_PM_PWR_MD set_mode;  /* the mode and parameters sent down to the host controller. */
    672     UINT16         interval;  /* the interval from last mode change event. */
    673 #if (BTM_SSR_INCLUDED == TRUE)
    674     UINT16         max_lat;   /* stored SSR maximum latency */
    675     UINT16         min_rmt_to;/* stored SSR minimum remote timeout */
    676     UINT16         min_loc_to;/* stored SSR minimum local timeout */
    677 #endif
    678     tBTM_PM_STATE  state;     /* contains the current mode of the connection */
    679     BOOLEAN        chg_ind;   /* a request change indication */
    680 } tBTM_PM_MCB;
    681 
    682 #define BTM_PM_REC_NOT_USED 0
    683 typedef struct
    684 {
    685     tBTM_PM_STATUS_CBACK *cback;/* to notify the registered party of mode change event */
    686     UINT8                 mask; /* registered request mask. 0, if this entry is not used */
    687 } tBTM_PM_RCB;
    688 #endif  /* BTM_PWR_MGR_INCLUDED */
    689 
    690 enum
    691 {
    692     BTM_BLI_ACL_UP_EVT,
    693     BTM_BLI_ACL_DOWN_EVT,
    694     BTM_BLI_PAGE_EVT,
    695     BTM_BLI_PAGE_DONE_EVT,
    696     BTM_BLI_INQ_EVT,
    697     BTM_BLI_INQ_CANCEL_EVT,
    698     BTM_BLI_INQ_DONE_EVT
    699 };
    700 typedef UINT8 tBTM_BLI_EVENT;
    701 
    702 /* Pairing State */
    703 enum
    704 {
    705     BTM_PAIR_STATE_IDLE,                        /* Idle                                         */
    706     BTM_PAIR_STATE_GET_REM_NAME,                /* Getting the remote name (to check for SM4)   */
    707     BTM_PAIR_STATE_WAIT_PIN_REQ,                /* Started authentication, waiting for PIN req (PIN is pre-fetched) */
    708     BTM_PAIR_STATE_WAIT_LOCAL_PIN,              /* Waiting for local PIN code                   */
    709     BTM_PAIR_STATE_WAIT_NUMERIC_CONFIRM,        /* Waiting user 'yes' to numeric confirmation   */
    710     BTM_PAIR_STATE_KEY_ENTRY,                   /* Key entry state (we are a keyboard)          */
    711     BTM_PAIR_STATE_WAIT_LOCAL_OOB_RSP,          /* Waiting for local response to peer OOB data  */
    712     BTM_PAIR_STATE_WAIT_LOCAL_IOCAPS,           /* Waiting for local IO capabilities and OOB data */
    713     BTM_PAIR_STATE_INCOMING_SSP,                /* Incoming SSP (got peer IO caps when idle)    */
    714     BTM_PAIR_STATE_WAIT_AUTH_COMPLETE,          /* All done, waiting authentication cpmplete    */
    715     BTM_PAIR_STATE_WAIT_DISCONNECT              /* Waiting to disconnect the ACL                */
    716 };
    717 typedef UINT8 tBTM_PAIRING_STATE;
    718 
    719 #define BTM_PAIR_FLAGS_WE_STARTED_DD    0x01    /* We want to do dedicated bonding              */
    720 #define BTM_PAIR_FLAGS_PEER_STARTED_DD  0x02    /* Peer initiated dedicated bonding             */
    721 #define BTM_PAIR_FLAGS_DISC_WHEN_DONE   0x04
    722 #define BTM_PAIR_FLAGS_PIN_REQD         0x08    /* set this bit when pin_callback is called     */
    723 #define BTM_PAIR_FLAGS_PRE_FETCH_PIN    0x10    /* set this bit when pre-fetch pin     */
    724 #define BTM_PAIR_FLAGS_REJECTED_CONNECT 0x20    /* set this bit when rejected incoming connection  */
    725 #define BTM_PAIR_FLAGS_WE_CANCEL_DD     0x40    /* set this bit when cancelling a bonding procedure */
    726 
    727 typedef struct
    728 {
    729     BOOLEAN             is_mux;
    730     BD_ADDR             bd_addr;
    731     UINT16              psm;
    732     BOOLEAN             is_orig;
    733     tBTM_SEC_CALLBACK   *p_callback;
    734     void                *p_ref_data;
    735     UINT32              mx_proto_id;
    736     UINT32              mx_chan_id;
    737 } tBTM_SEC_QUEUE_ENTRY;
    738 
    739 #if (L2CAP_UCD_INCLUDED == TRUE)
    740 
    741 #define CONN_ORIENT_TERM                0x00    /* incoming connection oriented */
    742 #define CONN_ORIENT_ORIG                0x01    /* outgoing connection oriented */
    743 #define CONNLESS_TERM                   0x02    /* incoming connectionless      */
    744 #define CONNLESS_ORIG                   0x03    /* outgoing connectionless      */
    745 #define CONNECTION_TYPE_ORIG_MASK       0x01    /* mask for direction           */
    746 #define CONNECTION_TYPE_CONNLESS_MASK   0x02    /* mask for connectionless or not */
    747 typedef UINT8 CONNECTION_TYPE;
    748 
    749 #else
    750 
    751 #define CONN_ORIENT_TERM                FALSE
    752 #define CONN_ORIENT_ORIG                TRUE
    753 typedef BOOLEAN CONNECTION_TYPE;
    754 
    755 #endif /* (L2CAP_UCD_INCLUDED == TRUE) */
    756 
    757 /* Define a structure to hold all the BTM data
    758 */
    759 
    760 #define BTM_STATE_BUFFER_SIZE  5                  /* size of state buffer */
    761 
    762 #if (BTM_PCM2_INCLUDED == TRUE)
    763 /* Define pcm2_action           */
    764 enum
    765 {
    766     BTM_PCM2_ACT_NONE,
    767     BTM_PCM2_ACT_SENT_ARC,
    768     BTM_PCM2_READ_PARAM,
    769     BTM_PCM2_WRITE_PARAM,
    770 };
    771 typedef UINT8 tBTM_PCM2_ACTION;
    772 #endif
    773 
    774 typedef struct
    775 {
    776     tBTM_CFG    cfg;                        /* Device configuration */
    777 
    778     /****************************************************
    779     **      ACL Management
    780     ****************************************************/
    781     tACL_CONN   acl_db[MAX_L2CAP_LINKS];
    782 #if( RFCOMM_INCLUDED==TRUE)
    783     UINT8       btm_scn[BTM_MAX_SCN];        /* current SCNs: TRUE if SCN is in use */
    784 #endif
    785     UINT16      btm_def_link_policy;
    786     UINT16      btm_def_link_super_tout;
    787 
    788 #if (defined(BTM_BUSY_LEVEL_CHANGE_INCLUDED) && BTM_BUSY_LEVEL_CHANGE_INCLUDED == TRUE)
    789     tBTM_BL_EVENT_MASK     bl_evt_mask;
    790     tBTM_BL_CHANGE_CB     *p_bl_changed_cb;    /* Callback for when Busy Level changed */
    791 #else
    792     tBTM_ACL_DB_CHANGE_CB *p_acl_changed_cb;    /* Callback for when ACL DB changed */
    793 #endif
    794 
    795     tBTM_LSTO_CBACK       *p_lsto_cback;  /* for link supervision timeout change event */
    796 
    797     /****************************************************
    798     **      Power Management
    799     ****************************************************/
    800 #if BTM_PWR_MGR_INCLUDED == TRUE
    801     tBTM_PM_MCB pm_mode_db[MAX_L2CAP_LINKS];   /* per ACL link */
    802     tBTM_PM_RCB pm_reg_db[BTM_MAX_PM_RECORDS+1]; /* per application/module */
    803     UINT8       pm_pend_link;  /* the index of acl_db, which has a pending PM cmd */
    804     UINT8       pm_pend_id;    /* the id pf the module, which has a pending PM cmd */
    805 #endif /* BTM_PWR_MGR_INCLUDED == TRUE */
    806 
    807     /*****************************************************
    808     **      Device control
    809     *****************************************************/
    810     tBTM_DEVCB  devcb;
    811 
    812     /*****************************************************
    813     **      BLE Device controllers
    814     *****************************************************/
    815 #if (BLE_INCLUDED == TRUE)
    816     tBTM_BLE_CB             ble_ctr_cb;
    817 
    818     UINT16                  enc_handle;
    819     BT_OCTET8               enc_rand;   /* received rand value from LTK request*/
    820     UINT16                  ediv;       /* received ediv value from LTK request */
    821     UINT8                   key_size;
    822 #endif
    823 
    824                                             /* Packet types supported by the local device */
    825     UINT16      btm_acl_pkt_types_supported;
    826     UINT16      btm_sco_pkt_types_supported;
    827 
    828 
    829     /*****************************************************
    830     **      Inquiry
    831     *****************************************************/
    832     tBTM_INQUIRY_VAR_ST     btm_inq_vars;
    833     tBTM_FILTER_CB          *p_inq_filter_cb;   /* Callback that can be set if host */
    834                                                 /* wants to verify inquiry filters */
    835 
    836     /*****************************************************
    837     **      SCO Management
    838     *****************************************************/
    839 #if BTM_SCO_INCLUDED == TRUE
    840     tSCO_CB             sco_cb;
    841 #endif
    842 
    843     /*****************************************************
    844     **      Security Management
    845     *****************************************************/
    846     tBTM_APPL_INFO          api;
    847 
    848 #define BTM_SEC_MAX_RMT_NAME_CALLBACKS  2
    849     tBTM_RMT_NAME_CALLBACK  *p_rmt_name_callback[BTM_SEC_MAX_RMT_NAME_CALLBACKS];
    850 
    851     tBTM_FILTER_CB          *p_conn_filter_cb;  /* Callback that can be set if host */
    852                                                 /* wants to verify connectability filters*/
    853 
    854     tBTM_SEC_DEV_REC        *p_collided_dev_rec;
    855     TIMER_LIST_ENT           sec_collision_tle;
    856     UINT32                   collision_start_time;
    857     UINT32                   max_collision_delay;
    858     UINT32                   dev_rec_count;      /* Counter used for device record timestamp */
    859     UINT8                    security_mode;
    860     BOOLEAN                  pairing_disabled;
    861     BOOLEAN                  connect_only_paired;
    862     BOOLEAN                  security_mode_changed;  /* mode changed during bonding */
    863     BOOLEAN                  pin_type_changed;       /* pin type changed during bonding */
    864     BOOLEAN                  sec_req_pending;       /*   TRUE if a request is pending */
    865 // btla-specific ++
    866 #ifdef PORCHE_PAIRING_CONFLICT
    867     UINT8                    pin_code_len_saved;     /* for legacy devices */
    868 #endif
    869 // btla-specific --
    870 
    871     UINT8                    pin_code_len;  /* for legacy devices */
    872     PIN_CODE                 pin_code;      /* for legacy devices */
    873     tBTM_PAIRING_STATE       pairing_state; /* The current pairing state    */
    874     UINT8                    pairing_flags; /* The current pairing flags    */
    875     BD_ADDR                  pairing_bda;   /* The device currently pairing */
    876     TIMER_LIST_ENT           pairing_tle;   /* Timer for pairing process    */
    877     UINT16                   disc_handle;   /* for legacy devices */
    878     UINT8                    disc_reason;   /* for legacy devices */
    879     tBTM_SEC_SERV_REC        sec_serv_rec[BTM_SEC_MAX_SERVICE_RECORDS];
    880     tBTM_SEC_DEV_REC         sec_dev_rec[BTM_SEC_MAX_DEVICE_RECORDS];
    881     tBTM_SEC_SERV_REC       *p_out_serv;
    882     tBTM_MKEY_CALLBACK      *mkey_cback;
    883 
    884     BD_ADDR                  connecting_bda;
    885     DEV_CLASS                connecting_dc;
    886 
    887     UINT8                   first_disabled_channel;
    888     UINT8                   last_disabled_channel;
    889 
    890     UINT8                   acl_disc_reason;
    891     UINT8                   trace_level;
    892 #if (defined(BTM_BUSY_LEVEL_CHANGE_INCLUDED) && BTM_BUSY_LEVEL_CHANGE_INCLUDED == TRUE)
    893     UINT8                   num_acl;    /* num of active ACL links */
    894     UINT8                   busy_level; /* the current busy level */
    895     BOOLEAN                 is_paging;  /* TRUE, if paging is in progess */
    896     BOOLEAN                 is_inquiry; /* TRUE, if inquiry is in progess */
    897 #endif
    898     BUFFER_Q                page_queue;
    899     BOOLEAN                 paging;
    900     BOOLEAN                 discing;
    901     BUFFER_Q                sec_pending_q;  /* pending sequrity requests in tBTM_SEC_QUEUE_ENTRY format */
    902 
    903 #if  (!defined(BT_TRACE_VERBOSE) || (BT_TRACE_VERBOSE == FALSE))
    904     char state_temp_buffer[BTM_STATE_BUFFER_SIZE];
    905 #endif
    906 
    907 #if (defined(BTM_PCM2_INCLUDED) && BTM_PCM2_INCLUDED == TRUE)
    908     UINT16                  sys_features;
    909     UINT8                   pcm2_params[BRCM_PCM2_SETUP_WRITE_SIZE];
    910     tBTM_PCM2_ACTION        pcm2_action;
    911 #endif
    912 
    913     BD_ADDR previous_connected_remote_addr[BTM_ROLE_DEVICE_NUM];
    914     UINT8   previous_connected_role[BTM_ROLE_DEVICE_NUM];
    915     UINT8   front; /* front index of the role table */
    916 } tBTM_CB;
    917 
    918 
    919 #ifdef __cplusplus
    920 extern "C"
    921 {
    922 #endif
    923 
    924 #if BTM_DYNAMIC_MEMORY == FALSE
    925 BTM_API extern tBTM_CB  btm_cb;
    926 #else
    927 BTM_API extern tBTM_CB *btm_cb_ptr;
    928 #define btm_cb (*btm_cb_ptr)
    929 #endif
    930 
    931 /* Internal functions provided by btm_main.c
    932 ********************************************
    933 */
    934 extern void         btm_init (void);
    935 
    936 /* Internal functions provided by btm_inq.c
    937 *******************************************
    938 */
    939 extern tBTM_STATUS  btm_initiate_rem_name (BD_ADDR remote_bda,
    940                                            tBTM_INQ_INFO *p_cur,
    941                                            UINT8 origin, UINT32 timeout,
    942                                            tBTM_CMPL_CB *p_cb);
    943 
    944 extern void         btm_process_remote_name (BD_ADDR bda, BD_NAME name, UINT16 evt_len,
    945                                              UINT8 hci_status);
    946 extern void         btm_inq_rmt_name_failed(void);
    947 
    948 /* Inquiry related functions */
    949 extern void         btm_clr_inq_db (BD_ADDR p_bda);
    950 extern void         btm_inq_db_init (void);
    951 extern void         btm_process_inq_results (UINT8 *p, UINT8 inq_res_mode);
    952 extern void         btm_process_inq_complete (UINT8 status, UINT8 mode);
    953 extern void         btm_event_filter_complete (UINT8 *p);
    954 extern void         btm_inq_stop_on_ssp(void);
    955 extern void         btm_inq_clear_ssp(void);
    956 extern tINQ_DB_ENT *btm_inq_db_find (BD_ADDR p_bda);
    957 extern BOOLEAN      btm_inq_find_bdaddr (BD_ADDR p_bda);
    958 
    959 #if (BTM_EIR_CLIENT_INCLUDED == TRUE)
    960 extern BOOLEAN btm_lookup_eir(BD_ADDR_PTR p_rem_addr);
    961 #endif
    962 
    963 /* Internal functions provided by btm_acl.c
    964 ********************************************
    965 */
    966 extern void         btm_acl_init (void);
    967 extern void         btm_acl_timeout (TIMER_LIST_ENT  *p_tle);
    968 extern void         btm_acl_created (BD_ADDR bda, DEV_CLASS dc, BD_NAME bdn,
    969                                      UINT16 hci_handle, UINT8 link_role, UINT8 is_le_link);
    970 extern void         btm_acl_removed (BD_ADDR bda);
    971 extern void         btm_acl_device_down (void);
    972 extern void         btm_acl_update_busy_level (tBTM_BLI_EVENT event);
    973 extern void         btm_acl_link_key_change (UINT16 handle, UINT8 status);
    974 
    975 extern void         btm_cont_rswitch_or_chglinkkey (tACL_CONN *p,
    976                                                     tBTM_SEC_DEV_REC *p_dev_rec,
    977                                                     UINT8 hci_status);
    978 
    979 extern UINT8        btm_handle_to_acl_index (UINT16 hci_handle);
    980 extern void         btm_read_link_policy_complete (UINT8 *p);
    981 extern void         btm_read_rssi_complete (UINT8 *p);
    982 extern void         btm_read_tx_power_complete (UINT8 *p, BOOLEAN is_ble);
    983 extern void         btm_read_link_quality_complete (UINT8 *p);
    984 extern tBTM_STATUS  btm_set_packet_types (tACL_CONN *p, UINT16 pkt_types);
    985 extern void         btm_process_clk_off_comp_evt (UINT16 hci_handle, UINT16 clock_offset);
    986 extern void         btm_acl_role_changed (UINT8 hci_status, BD_ADDR bd_addr, UINT8 new_role);
    987 extern void         btm_acl_encrypt_change (UINT16 handle, UINT8 status, UINT8 encr_enable);
    988 BTM_API extern UINT16       btm_get_acl_disc_reason_code (void);
    989 BTM_API extern tBTM_STATUS  btm_remove_acl (BD_ADDR bd_addr);
    990 extern void         btm_read_remote_features_complete (UINT8 *p);
    991 extern void         btm_read_remote_ext_features_complete (UINT8 *p);
    992 extern void         btm_read_remote_ext_features_failed (UINT8 status, UINT16 handle);
    993 extern void         btm_read_remote_version_complete (UINT8 *p);
    994 // btla-specific ++
    995 extern void         btm_acl_chk_peer_pkt_type_support (tACL_CONN *p, UINT16 *p_pkt_type);
    996 // btla-specific --
    997 /* Read maximum data packet that can be sent over current connection */
    998 extern UINT16 btm_get_max_packet_size (BD_ADDR addr);
    999 extern tACL_CONN *btm_bda_to_acl (BD_ADDR bda);
   1000 extern BOOLEAN    btm_acl_notif_conn_collision (BD_ADDR bda);
   1001 
   1002 #if BTM_PWR_MGR_INCLUDED == FALSE
   1003 extern void         btm_process_mode_change (UINT8 hci_status, UINT16 hci_handle, UINT8 mode,
   1004                                              UINT16 interval);
   1005 
   1006 /* Internal functions provided by btm_pm.c
   1007 ********************************************
   1008 */
   1009 #else
   1010 extern void btm_pm_reset(void);
   1011 extern void btm_pm_sm_alloc(UINT8 ind);
   1012 extern void btm_pm_proc_cmd_status(UINT8 status);
   1013 extern void btm_pm_proc_mode_change (UINT8 hci_status, UINT16 hci_handle, UINT8 mode,
   1014                                      UINT16 interval);
   1015 extern void btm_pm_proc_ssr_evt (UINT8 *p, UINT16 evt_len);
   1016 #if BTM_SCO_INCLUDED == TRUE
   1017 extern void btm_sco_chk_pend_unpark (UINT8 hci_status, UINT16 hci_handle);
   1018 #else
   1019 #define btm_sco_chk_pend_unpark(hci_status, hci_handle)
   1020 #endif /* BTM_SCO_INCLUDED */
   1021 #endif /* BTM_PWR_MGR_INCLUDED == FALSE */
   1022 extern void btm_qos_setup_complete (UINT8 status, UINT16 handle, FLOW_SPEC *p_flow);
   1023 
   1024 
   1025 /* Internal functions provided by btm_sco.c
   1026 ********************************************
   1027 */
   1028 extern void btm_sco_init (void);
   1029 extern void btm_sco_connected (UINT8 hci_status, BD_ADDR bda, UINT16 hci_handle,
   1030                                tBTM_ESCO_DATA *p_esco_data);
   1031 extern void btm_esco_proc_conn_chg (UINT8 status, UINT16 handle, UINT8 tx_interval,
   1032                                     UINT8 retrans_window, UINT16 rx_pkt_len,
   1033                                     UINT16 tx_pkt_len);
   1034 extern void btm_sco_conn_req (BD_ADDR bda,  DEV_CLASS dev_class, UINT8 link_type);
   1035 extern void btm_sco_removed (UINT16 hci_handle, UINT8 reason);
   1036 extern void btm_sco_acl_removed (BD_ADDR bda);
   1037 extern void btm_route_sco_data (BT_HDR *p_msg);
   1038 extern BOOLEAN btm_is_sco_active (UINT16 handle);
   1039 extern void btm_remove_sco_links (BD_ADDR bda);
   1040 extern BOOLEAN btm_is_sco_active_by_bdaddr (BD_ADDR remote_bda);
   1041 
   1042 extern tBTM_SCO_TYPE btm_read_def_esco_mode (tBTM_ESCO_PARAMS *p_parms);
   1043 extern UINT16  btm_find_scb_by_handle (UINT16 handle);
   1044 extern void btm_sco_flush_sco_data(UINT16 sco_inx);
   1045 
   1046 /* Internal functions provided by btm_devctl.c
   1047 **********************************************
   1048 */
   1049 extern void btm_dev_init (void);
   1050 extern void btm_dev_absent (void);
   1051 extern void btm_dev_timeout (TIMER_LIST_ENT *p_tle);
   1052 extern void btm_reset_complete (void);
   1053 extern void btm_read_local_version_complete (UINT8 *p, UINT16 evt_len);
   1054 extern void btm_read_hci_buf_size_complete (UINT8 *p, UINT16 evt_len);
   1055 extern void btm_read_local_supported_cmds_complete (UINT8 *p);
   1056 extern void btm_read_local_features_complete (UINT8 *p, UINT16 evt_len);
   1057 extern void btm_read_local_ext_features_complete (UINT8 *p, UINT16 evt_len);
   1058 extern void btm_read_local_name_complete (UINT8 *p, UINT16 evt_len);
   1059 extern void btm_read_local_addr_complete (UINT8 *p, UINT16 evt_len);
   1060 extern  void btm_reset_ctrlr_complete (void);
   1061 extern void btm_write_simple_paring_mode_complete (UINT8 *p);
   1062 extern void btm_write_le_host_supported_complete (UINT8 *p);
   1063 
   1064 #if (BLE_INCLUDED == TRUE)
   1065 extern void btm_read_ble_buf_size_complete (UINT8 *p, UINT16 evt_len);
   1066 extern void btm_read_ble_local_supported_features_complete (UINT8 *p, UINT16 evt_len);
   1067 extern void btm_read_white_list_size_complete(UINT8 *p, UINT16 evt_len);
   1068 extern void btm_ble_add_2_white_list_complete(UINT8 status);
   1069 extern void btm_ble_remove_from_white_list_complete(UINT8 *p, UINT16 evt_len);
   1070 extern void btm_ble_clear_white_list_complete(UINT8 *p, UINT16 evt_len);
   1071 #endif  /* BLE_INCLUDED */
   1072 
   1073 /* Vendor Specific Command complete evt handler */
   1074 extern void btm_vsc_complete (UINT8 *p, UINT16 cc_opcode, UINT16 evt_len,
   1075                               tBTM_CMPL_CB *p_vsc_cplt_cback);
   1076 extern void btm_inq_db_reset (void);
   1077 extern void btm_vendor_specific_evt (UINT8 *p, UINT8 evt_len);
   1078 extern UINT8 btm_get_hci_version (void);
   1079 extern void btm_read_stored_link_key_complete (UINT8 *p);
   1080 extern void btm_write_stored_link_key_complete (UINT8 *p);
   1081 extern void btm_delete_stored_link_key_complete (UINT8 *p);
   1082 extern void btm_return_link_keys_evt (tBTM_RETURN_LINK_KEYS_EVT *result);
   1083 extern void btm_report_device_status (tBTM_DEV_STATUS status);
   1084 
   1085 
   1086 /* Internal functions provided by btm_dev.c
   1087 **********************************************
   1088 */
   1089 extern BOOLEAN btm_dev_support_switch (BD_ADDR bd_addr);
   1090 extern UINT8 btm_get_voice_coding_support (void);
   1091 
   1092 extern tBTM_SEC_DEV_REC  *btm_sec_alloc_dev (BD_ADDR bd_addr);
   1093 extern void               btm_sec_free_dev (tBTM_SEC_DEV_REC *p_dev_rec);
   1094 extern tBTM_SEC_DEV_REC  *btm_find_dev (BD_ADDR bd_addr);
   1095 extern tBTM_SEC_DEV_REC  *btm_find_or_alloc_dev (BD_ADDR bd_addr);
   1096 extern tBTM_SEC_DEV_REC  *btm_find_dev_by_handle (UINT16 handle);
   1097 
   1098 /* Internal functions provided by btm_sec.c
   1099 **********************************************
   1100 */
   1101 extern BOOLEAN btm_dev_support_switch (BD_ADDR bd_addr);
   1102 extern tBTM_STATUS  btm_sec_l2cap_access_req (BD_ADDR bd_addr, UINT16 psm,
   1103                                        UINT16 handle, CONNECTION_TYPE conn_type,
   1104                                        tBTM_SEC_CALLBACK *p_callback, void *p_ref_data);
   1105 extern tBTM_STATUS  btm_sec_mx_access_request (BD_ADDR bd_addr, UINT16 psm, BOOLEAN is_originator,
   1106                                         UINT32 mx_proto_id, UINT32 mx_chan_id,
   1107                                         tBTM_SEC_CALLBACK *p_callback, void *p_ref_data);
   1108 extern void  btm_sec_conn_req (UINT8 *bda, UINT8 *dc);
   1109 extern void btm_create_conn_cancel_complete (UINT8 *p);
   1110 extern void btm_proc_lsto_evt(UINT16 handle, UINT16 timeout);
   1111 extern void btm_read_linq_tx_power_complete (UINT8 *p);
   1112 
   1113 extern void  btm_sec_init (UINT8 sec_mode);
   1114 extern void  btm_sec_dev_reset (void);
   1115 extern void  btm_sec_abort_access_req (BD_ADDR bd_addr);
   1116 extern void  btm_sec_auth_complete (UINT16 handle, UINT8 status);
   1117 extern void  btm_sec_mkey_comp_event (UINT16 handle, UINT8 status, UINT8 key_flg);
   1118 extern void  btm_sec_encrypt_change (UINT16 handle, UINT8 status, UINT8 encr_enable);
   1119 extern void  btm_sec_connected (UINT8 *bda, UINT16 handle, UINT8 status, UINT8 enc_mode);
   1120 extern tBTM_STATUS btm_sec_disconnect (UINT16 handle, UINT8 reason);
   1121 extern void  btm_sec_disconnected (UINT16 handle, UINT8 reason);
   1122 extern void  btm_sec_rmt_name_request_complete (UINT8 *bd_addr, UINT8 *bd_name, UINT8 status);
   1123 extern void  btm_sec_rmt_host_support_feat_evt (UINT8 *p);
   1124 extern void  btm_io_capabilities_req (UINT8 *p);
   1125 extern void  btm_io_capabilities_rsp (UINT8 *p);
   1126 extern void  btm_proc_sp_req_evt (tBTM_SP_EVT event, UINT8 *p);
   1127 extern void  btm_keypress_notif_evt (UINT8 *p);
   1128 extern void  btm_simple_pair_complete (UINT8 *p);
   1129 extern void  btm_sec_link_key_notification (UINT8 *p_bda, UINT8 *p_link_key, UINT8 key_type);
   1130 extern void  btm_sec_link_key_request (UINT8 *p_bda);
   1131 extern void  btm_sec_pin_code_request (UINT8 *p_bda);
   1132 extern void  btm_sec_update_clock_offset (UINT16 handle, UINT16 clock_offset);
   1133 extern void  btm_sec_dev_rec_cback_event (tBTM_SEC_DEV_REC *p_dev_rec, UINT8 res);
   1134 
   1135 #if BLE_INCLUDED == TRUE
   1136 extern void  btm_sec_clear_ble_keys (tBTM_SEC_DEV_REC  *p_dev_rec);
   1137 extern  BOOLEAN btm_sec_find_bonded_dev (UINT8 start_idx, UINT8 *p_found_idx, tBTM_SEC_DEV_REC *p_rec);
   1138 extern BOOLEAN btm_sec_is_a_bonded_dev (BD_ADDR bda);
   1139 extern BOOLEAN btm_sec_is_le_capable_dev (BD_ADDR bda);
   1140 #endif /* BLE_INCLUDED */
   1141 
   1142 extern tINQ_DB_ENT *btm_inq_db_new (BD_ADDR p_bda);
   1143 
   1144 #if BTM_OOB_INCLUDED == TRUE
   1145 extern void  btm_rem_oob_req (UINT8 *p);
   1146 extern void  btm_read_local_oob_complete (UINT8 *p);
   1147 #else
   1148 #define btm_rem_oob_req(p)
   1149 #define btm_read_local_oob_complete(p)
   1150 #endif
   1151 
   1152 extern void  btm_acl_resubmit_page (void);
   1153 extern void  btm_acl_reset_paging (void);
   1154 extern void  btm_acl_paging (BT_HDR *p, BD_ADDR dest);
   1155 extern void  btm_acl_set_discing (BOOLEAN discing);
   1156 extern UINT8 btm_sec_clr_service_by_psm (UINT16 psm);
   1157 extern void  btm_sec_clr_temp_auth_service (BD_ADDR bda);
   1158 
   1159 #ifdef __cplusplus
   1160 }
   1161 #endif
   1162 
   1163 #endif
   1164 
   1165