bta/include/bta_api.h

   1 /******************************************************************************
   2  *
   3  *  Copyright (C) 2003-2014 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 is the public interface file for BTA, Broadcom's Bluetooth
  22  *  application layer for mobile phones.
  23  *
  24  ******************************************************************************/
  25 #ifndef BTA_API_H
  26 #define BTA_API_H
  27
  28 #include "data_types.h"
  29 #include "bt_target.h"
  30 #include "bt_types.h"
  31 #include "btm_api.h"
  32 #include "uipc_msg.h"
  33
  34 #if BLE_INCLUDED == TRUE
  35 #include "btm_ble_api.h"
  36 #endif
  37
  38 /*****************************************************************************
  39 **  Constants and data types
  40 *****************************************************************************/
  41
  42 /* Status Return Value */
  43 #define BTA_SUCCESS             0           /* Successful operation. */
  44 #define BTA_FAILURE             1           /* Generic failure. */
  45 #define BTA_PENDING             2           /* API cannot be completed right now */
  46 #define BTA_BUSY                3
  47 #define BTA_NO_RESOURCES        4
  48 #define BTA_WRONG_MODE          5
  49
  50 typedef UINT8 tBTA_STATUS;
  51
  52 /*
  53  * Service ID
  54  *
  55  * NOTES: When you add a new Service ID for BTA AND require to change the value of BTA_MAX_SERVICE_ID,
  56  *        make sure that the correct security ID of the new service from Security service definitions (btm_api.h)
  57  *        should be added to bta_service_id_to_btm_srv_id_lkup_tbl table in bta_dm_act.c.
  58  */
  59
  60 #define BTA_RES_SERVICE_ID      0           /* Reserved */
  61 #define BTA_SPP_SERVICE_ID      1           /* Serial port profile. */
  62 #define BTA_DUN_SERVICE_ID      2           /* Dial-up networking profile. */
  63 #define BTA_A2DP_SOURCE_SERVICE_ID      3   /* A2DP Source profile. */
  64 #define BTA_LAP_SERVICE_ID      4           /* LAN access profile. */
  65 #define BTA_HSP_SERVICE_ID      5           /* Headset profile. */
  66 #define BTA_HFP_SERVICE_ID      6           /* Hands-free profile. */
  67 #define BTA_OPP_SERVICE_ID      7           /* Object push  */
  68 #define BTA_FTP_SERVICE_ID      8           /* File transfer */
  69 #define BTA_CTP_SERVICE_ID      9           /* Cordless Terminal */
  70 #define BTA_ICP_SERVICE_ID      10          /* Intercom Terminal */
  71 #define BTA_SYNC_SERVICE_ID     11          /* Synchronization */
  72 #define BTA_BPP_SERVICE_ID      12          /* Basic printing profile */
  73 #define BTA_BIP_SERVICE_ID      13          /* Basic Imaging profile */
  74 #define BTA_PANU_SERVICE_ID     14          /* PAN User */
  75 #define BTA_NAP_SERVICE_ID      15          /* PAN Network access point */
  76 #define BTA_GN_SERVICE_ID       16          /* PAN Group Ad-hoc networks */
  77 #define BTA_SAP_SERVICE_ID      17          /* SIM Access profile */
  78 #define BTA_A2DP_SERVICE_ID     18          /* A2DP Sink */
  79 #define BTA_AVRCP_SERVICE_ID    19          /* A/V remote control */
  80 #define BTA_HID_SERVICE_ID      20          /* HID */
  81 #define BTA_VDP_SERVICE_ID      21          /* Video distribution */
  82 #define BTA_PBAP_SERVICE_ID     22          /* PhoneBook Access Server*/
  83 #define BTA_HSP_HS_SERVICE_ID   23          /* HFP HS role */
  84 #define BTA_HFP_HS_SERVICE_ID   24          /* HSP HS role */
  85 #define BTA_MAP_SERVICE_ID      25          /* Message Access Profile */
  86 #define BTA_MN_SERVICE_ID       26          /* Message Notification Service */
  87 #define BTA_HDP_SERVICE_ID      27          /* Health Device Profile */
  88 #define BTA_PCE_SERVICE_ID      28          /* PhoneBook Access Client*/
  89
  90 #if BLE_INCLUDED == TRUE && BTA_GATT_INCLUDED == TRUE
  91 /* BLE profile service ID */
  92 #define BTA_BLE_SERVICE_ID      29          /* GATT profile */
  93
  94 // btla-specific ++
  95 #define BTA_USER_SERVICE_ID     30          /* User requested UUID */
  96
  97 #define BTA_MAX_SERVICE_ID      31
  98 // btla-specific --
  99 #else
 100 #define BTA_USER_SERVICE_ID     29          /* User requested UUID */
 101 #define BTA_MAX_SERVICE_ID      30
 102 #endif
 103 /* service IDs (BTM_SEC_SERVICE_FIRST_EMPTY + 1) to (BTM_SEC_MAX_SERVICES - 1)
 104  * are used by BTA JV */
 105 #define BTA_FIRST_JV_SERVICE_ID     (BTM_SEC_SERVICE_FIRST_EMPTY + 1)
 106 #define BTA_LAST_JV_SERVICE_ID      (BTM_SEC_MAX_SERVICES - 1)
 107
 108 typedef UINT8 tBTA_SERVICE_ID;
 109
 110 /* Service ID Mask */
 111 #define BTA_RES_SERVICE_MASK        0x00000001  /* Reserved */
 112 #define BTA_SPP_SERVICE_MASK        0x00000002  /* Serial port profile. */
 113 #define BTA_DUN_SERVICE_MASK        0x00000004  /* Dial-up networking profile. */
 114 #define BTA_FAX_SERVICE_MASK        0x00000008  /* Fax profile. */
 115 #define BTA_LAP_SERVICE_MASK        0x00000010  /* LAN access profile. */
 116 #define BTA_HSP_SERVICE_MASK        0x00000020  /* HSP AG role. */
 117 #define BTA_HFP_SERVICE_MASK        0x00000040  /* HFP AG role */
 118 #define BTA_OPP_SERVICE_MASK        0x00000080  /* Object push  */
 119 #define BTA_FTP_SERVICE_MASK        0x00000100  /* File transfer */
 120 #define BTA_CTP_SERVICE_MASK        0x00000200  /* Cordless Terminal */
 121 #define BTA_ICP_SERVICE_MASK        0x00000400  /* Intercom Terminal */
 122 #define BTA_SYNC_SERVICE_MASK       0x00000800  /* Synchronization */
 123 #define BTA_BPP_SERVICE_MASK        0x00001000  /* Print server */
 124 #define BTA_BIP_SERVICE_MASK        0x00002000  /* Basic Imaging */
 125 #define BTA_PANU_SERVICE_MASK       0x00004000  /* PAN User */
 126 #define BTA_NAP_SERVICE_MASK        0x00008000  /* PAN Network access point */
 127 #define BTA_GN_SERVICE_MASK         0x00010000  /* PAN Group Ad-hoc networks */
 128 #define BTA_SAP_SERVICE_MASK        0x00020000  /* PAN Group Ad-hoc networks */
 129 #define BTA_A2DP_SERVICE_MASK       0x00040000  /* Advanced audio distribution */
 130 #define BTA_AVRCP_SERVICE_MASK      0x00080000  /* A/V remote control */
 131 #define BTA_HID_SERVICE_MASK        0x00100000  /* HID */
 132 #define BTA_VDP_SERVICE_MASK        0x00200000  /* Video distribution */
 133 #define BTA_PBAP_SERVICE_MASK       0x00400000  /* Phone Book Server */
 134 #define BTA_HSP_HS_SERVICE_MASK     0x00800000  /* HFP HS role */
 135 #define BTA_HFP_HS_SERVICE_MASK     0x01000000  /* HSP HS role */
 136 #define BTA_MAS_SERVICE_MASK        0x02000000  /* Message Access Profile */
 137 #define BTA_MN_SERVICE_MASK         0x04000000  /* Message Notification Profile */
 138 #define BTA_HL_SERVICE_MASK         0x08000000  /* Health Device Profile */
 139 #define BTA_PCE_SERVICE_MASK        0x10000000  /* Phone Book Client */
 140
 141 #if BLE_INCLUDED == TRUE && BTA_GATT_INCLUDED == TRUE
 142 #define BTA_BLE_SERVICE_MASK        0x20000000  /* GATT based service */
 143 // btla-specific ++
 144 #define BTA_USER_SERVICE_MASK       0x40000000  /* Message Notification Profile */
 145 // btla-specific --
 146 #else
 147 // btla-specific ++
 148 #define BTA_USER_SERVICE_MASK       0x20000000  /* Message Notification Profile */
 149 // btla-specific --
 150 #endif
 151
 152 #if BLE_INCLUDED == TRUE && BTA_GATT_INCLUDED == TRUE
 153 #define BTA_ALL_SERVICE_MASK        0x3FFFFFFF  /* All services supported by BTA. */
 154 #else
 155 #define BTA_ALL_SERVICE_MASK        0x1FFFFFFF  /* All services supported by BTA. */
 156 #endif
 157
 158 typedef UINT32 tBTA_SERVICE_MASK;
 159
 160 /* extended service mask, including mask with one or more GATT UUID */
 161 typedef struct
 162 {
 163     tBTA_SERVICE_MASK   srvc_mask;
 164     UINT8               num_uuid;
 165     tBT_UUID            *p_uuid;
 166 }tBTA_SERVICE_MASK_EXT;
 167
 168 /* Security Setting Mask */
 169 #define BTA_SEC_NONE            BTM_SEC_NONE                                         /* No security. */
 170 #define BTA_SEC_AUTHORIZE       (BTM_SEC_IN_AUTHORIZE )                              /* Authorization required (only needed for out going connection )*/
 171 #define BTA_SEC_AUTHENTICATE    (BTM_SEC_IN_AUTHENTICATE | BTM_SEC_OUT_AUTHENTICATE) /* Authentication required. */
 172 #define BTA_SEC_ENCRYPT         (BTM_SEC_IN_ENCRYPT | BTM_SEC_OUT_ENCRYPT)           /* Encryption required. */
 173
 174 typedef UINT8 tBTA_SEC;
 175
 176 /* Ignore for Discoverable, Connectable, Pairable and Connectable Paired only device modes */
 177
 178 #define BTA_DM_IGNORE           0xFF
 179
 180 #define BTA_ALL_APP_ID          0xFF
 181
 182 /* Discoverable Modes */
 183 #define BTA_DM_NON_DISC         BTM_NON_DISCOVERABLE        /* Device is not discoverable. */
 184 #define BTA_DM_GENERAL_DISC     BTM_GENERAL_DISCOVERABLE    /* General discoverable. */
 185 #define BTA_DM_LIMITED_DISC     BTM_LIMITED_DISCOVERABLE    /* Limited discoverable. */
 186 #if ((defined BLE_INCLUDED) && (BLE_INCLUDED == TRUE))
 187 #define BTA_DM_BLE_NON_DISCOVERABLE        BTM_BLE_NON_DISCOVERABLE        /* Device is not LE discoverable */
 188 #define BTA_DM_BLE_GENERAL_DISCOVERABLE    BTM_BLE_GENERAL_DISCOVERABLE    /* Device is LE General discoverable */
 189 #define BTA_DM_BLE_LIMITED_DISCOVERABLE    BTM_BLE_LIMITED_DISCOVERABLE    /* Device is LE Limited discoverable */
 190 #endif
 191 typedef UINT16 tBTA_DM_DISC;        /* this discoverability mode is a bit mask among BR mode and LE mode */
 192
 193 /* Connectable Modes */
 194 #define BTA_DM_NON_CONN         BTM_NON_CONNECTABLE         /* Device is not connectable. */
 195 #define BTA_DM_CONN             BTM_CONNECTABLE             /* Device is connectable. */
 196 #if ((defined BLE_INCLUDED) && (BLE_INCLUDED == TRUE))
 197 #define BTA_DM_BLE_NON_CONNECTABLE      BTM_BLE_NON_CONNECTABLE     /* Device is LE non-connectable. */
 198 #define BTA_DM_BLE_CONNECTABLE          BTM_BLE_CONNECTABLE         /* Device is LE connectable. */
 199 #endif
 200
 201 // btla-specific ++
 202 typedef UINT16 tBTA_DM_CONN;
 203
 204 #define BTA_TRANSPORT_UNKNOWN   0
 205 #define BTA_TRANSPORT_BR_EDR    BT_TRANSPORT_BR_EDR
 206 #define BTA_TRANSPORT_LE        BT_TRANSPORT_LE
 207 typedef tBT_TRANSPORT tBTA_TRANSPORT;
 208
 209 /* Pairable Modes */
 210 #define BTA_DM_PAIRABLE         1
 211 #define BTA_DM_NON_PAIRABLE     0
 212
 213 /* Connectable Paired Only Mode */
 214 #define BTA_DM_CONN_ALL         0
 215 #define BTA_DM_CONN_PAIRED      1
 216
 217 /* Inquiry Modes */
 218 #define BTA_DM_INQUIRY_NONE             BTM_INQUIRY_NONE            /*No BR inquiry. */
 219 #define BTA_DM_GENERAL_INQUIRY  BTM_GENERAL_INQUIRY         /* Perform general inquiry. */
 220 #define BTA_DM_LIMITED_INQUIRY  BTM_LIMITED_INQUIRY         /* Perform limited inquiry. */
 221
 222 #if ((defined BLE_INCLUDED) && (BLE_INCLUDED == TRUE))
 223 #define BTA_BLE_INQUIRY_NONE    BTM_BLE_INQUIRY_NONE
 224 #define BTA_BLE_GENERAL_INQUIRY BTM_BLE_GENERAL_INQUIRY      /* Perform LE general inquiry. */
 225 #define BTA_BLE_LIMITED_INQUIRY BTM_BLE_LIMITED_INQUIRY      /* Perform LE limited inquiry. */
 226 #endif
 227 typedef UINT8 tBTA_DM_INQ_MODE;
 228
 229 /* Inquiry Filter Type */
 230 #define BTA_DM_INQ_CLR          BTM_CLR_INQUIRY_FILTER          /* Clear inquiry filter. */
 231 #define BTA_DM_INQ_DEV_CLASS    BTM_FILTER_COND_DEVICE_CLASS    /* Filter on device class. */
 232 #define BTA_DM_INQ_BD_ADDR      BTM_FILTER_COND_BD_ADDR         /* Filter on a specific  BD address. */
 233
 234 typedef UINT8 tBTA_DM_INQ_FILT;
 235
 236 /* Authorize Response */
 237 #define BTA_DM_AUTH_PERM        0      /* Authorized for future connections to the service */
 238 #define BTA_DM_AUTH_TEMP        1      /* Authorized for current connection only */
 239 #define BTA_DM_NOT_AUTH         2      /* Not authorized for the service */
 240
 241 typedef UINT8 tBTA_AUTH_RESP;
 242
 243 /* M/S preferred roles */
 244 #define BTA_ANY_ROLE          0x00
 245 #define BTA_MASTER_ROLE_PREF  0x01
 246 #define BTA_MASTER_ROLE_ONLY  0x02
 247
 248 typedef UINT8 tBTA_PREF_ROLES;
 249
 250 enum
 251 {
 252
 253     BTA_DM_NO_SCATTERNET,        /* Device doesn't support scatternet, it might
 254                                     support "role switch during connection" for
 255                                     an incoming connection, when it already has
 256                                     another connection in master role */
 257     BTA_DM_PARTIAL_SCATTERNET,   /* Device supports partial scatternet. It can have
 258                                     simulateous connection in Master and Slave roles
 259                                     for short period of time */
 260     BTA_DM_FULL_SCATTERNET       /* Device can have simultaneous connection in master
 261                                     and slave roles */
 262
 263 };
 264
 265
 266 /* Inquiry filter device class condition */
 267 typedef struct
 268 {
 269     DEV_CLASS       dev_class;        /* device class of interest */
 270     DEV_CLASS       dev_class_mask;   /* mask to determine the bits of device class of interest */
 271 } tBTA_DM_COD_COND;
 272
 273
 274 /* Inquiry Filter Condition */
 275 typedef union
 276 {
 277     BD_ADDR              bd_addr;            /* BD address of  device to filter. */
 278     tBTA_DM_COD_COND     dev_class_cond;     /* Device class filter condition */
 279 } tBTA_DM_INQ_COND;
 280
 281 /* Inquiry Parameters */
 282 typedef struct
 283 {
 284     tBTA_DM_INQ_MODE    mode;           /* Inquiry mode, limited or general. */
 285     UINT8               duration;       /* Inquiry duration in 1.28 sec units. */
 286     UINT8               max_resps;      /* Maximum inquiry responses.  Set to zero for unlimited responses. */
 287     BOOLEAN             report_dup;     /* report duplicated inquiry response with higher RSSI value */
 288     tBTA_DM_INQ_FILT    filter_type;    /* Filter condition type. */
 289     tBTA_DM_INQ_COND    filter_cond;    /* Filter condition data. */
 290 #if (defined(BTA_HOST_INTERLEAVE_SEARCH) && BTA_HOST_INTERLEAVE_SEARCH == TRUE)
 291     UINT8               intl_duration[4];/*duration array storing the interleave scan's time portions*/
 292 #endif
 293 } tBTA_DM_INQ;
 294
 295 typedef struct
 296 {
 297     UINT8   bta_dm_eir_min_name_len;        /* minimum length of local name when it is shortened */
 298 #if (BTA_EIR_CANNED_UUID_LIST == TRUE)
 299     UINT8   bta_dm_eir_uuid16_len;          /* length of 16-bit UUIDs */
 300     UINT8  *bta_dm_eir_uuid16;              /* 16-bit UUIDs */
 301 #else
 302     UINT32  uuid_mask[BTM_EIR_SERVICE_ARRAY_SIZE]; /* mask of UUID list in EIR */
 303 #endif
 304     INT8   *bta_dm_eir_inq_tx_power;        /* Inquiry TX power         */
 305     UINT8   bta_dm_eir_flag_len;            /* length of flags in bytes */
 306     UINT8  *bta_dm_eir_flags;               /* flags for EIR */
 307     UINT8   bta_dm_eir_manufac_spec_len;    /* length of manufacturer specific in bytes */
 308     UINT8  *bta_dm_eir_manufac_spec;        /* manufacturer specific */
 309     UINT8   bta_dm_eir_additional_len;      /* length of additional data in bytes */
 310     UINT8  *bta_dm_eir_additional;          /* additional data */
 311 } tBTA_DM_EIR_CONF;
 312
 313 #if BLE_INCLUDED == TRUE
 314 /* ADV data flag bit definition used for BTM_BLE_AD_TYPE_FLAG */
 315 #define BTA_BLE_LIMIT_DISC_FLAG     BTM_BLE_LIMIT_DISC_FLAG
 316 #define BTA_BLE_GEN_DISC_FLAG       BTM_BLE_GEN_DISC_FLAG
 317 #define BTA_BLE_BREDR_NOT_SPT       BTM_BLE_BREDR_NOT_SPT
 318 #define BTA_BLE_DMT_CONTROLLER_SPT  BTM_BLE_DMT_CONTROLLER_SPT
 319 #define BTA_BLE_DMT_HOST_SPT        BTM_BLE_DMT_HOST_SPT
 320 #define BTA_BLE_NON_LIMIT_DISC_FLAG BTM_BLE_NON_LIMIT_DISC_FLAG
 321 #define BTA_BLE_ADV_FLAG_MASK       BTM_BLE_ADV_FLAG_MASK
 322 #define BTA_BLE_LIMIT_DISC_MASK     BTM_BLE_LIMIT_DISC_MASK
 323
 324 /* ADV data bit mask */
 325 #define BTA_BLE_AD_BIT_DEV_NAME        BTM_BLE_AD_BIT_DEV_NAME
 326 #define BTA_BLE_AD_BIT_FLAGS           BTM_BLE_AD_BIT_FLAGS
 327 #define BTA_BLE_AD_BIT_MANU            BTM_BLE_AD_BIT_MANU
 328 #define BTA_BLE_AD_BIT_TX_PWR          BTM_BLE_AD_BIT_TX_PWR
 329 #define BTA_BLE_AD_BIT_INT_RANGE       BTM_BLE_AD_BIT_INT_RANGE
 330 #define BTA_BLE_AD_BIT_SERVICE         BTM_BLE_AD_BIT_SERVICE
 331 #define BTA_BLE_AD_BIT_APPEARANCE      BTM_BLE_AD_BIT_APPEARANCE
 332 #define BTA_BLE_AD_BIT_PROPRIETARY     BTM_BLE_AD_BIT_PROPRIETARY
 333 #define BTA_DM_BLE_AD_BIT_SERVICE_SOL     BTM_BLE_AD_BIT_SERVICE_SOL
 334 #define BTA_DM_BLE_AD_BIT_SERVICE_DATA    BTM_BLE_AD_BIT_SERVICE_DATA
 335 #define BTA_DM_BLE_AD_BIT_SIGN_DATA       BTM_BLE_AD_BIT_SIGN_DATA
 336 #define BTA_DM_BLE_AD_BIT_SERVICE_128SOL  BTM_BLE_AD_BIT_SERVICE_128SOL
 337 #define BTA_DM_BLE_AD_BIT_PUBLIC_ADDR     BTM_BLE_AD_BIT_PUBLIC_ADDR
 338 #define BTA_DM_BLE_AD_BIT_RANDOM_ADDR     BTM_BLE_AD_BIT_RANDOM_ADDR
 339 #define BTA_DM_BLE_AD_BIT_SERVICE_128     BTM_BLE_AD_BIT_SERVICE_128      /*128-bit Service UUIDs*/
 340
 341 typedef  tBTM_BLE_AD_MASK  tBTA_BLE_AD_MASK;
 342
 343 /* slave preferred connection interval range */
 344 typedef struct
 345 {
 346     UINT16  low;
 347     UINT16  hi;
 348
 349 }tBTA_BLE_INT_RANGE;
 350
 351 /* Service tag supported in the device */
 352 typedef struct
 353 {
 354     UINT8       num_service;
 355     BOOLEAN     list_cmpl;
 356     UINT16      *p_uuid;
 357 }tBTA_BLE_SERVICE;
 358
 359
 360 typedef struct
 361 {
 362     UINT8       len;
 363     UINT8      *p_val;
 364 }tBTA_BLE_MANU;
 365
 366 typedef struct
 367 {
 368     UINT8       adv_type;
 369     UINT8       len;
 370     UINT8       *p_val;     /* number of len byte */
 371 }tBTA_BLE_PROP_ELEM;
 372
 373 /* vendor proprietary adv type */
 374 typedef struct
 375 {
 376     UINT8                   num_elem;
 377     tBTA_BLE_PROP_ELEM      *p_elem;
 378 }tBTA_BLE_PROPRIETARY;
 379
 380 typedef struct
 381 {
 382     tBT_UUID    service_uuid;
 383     UINT8       len;
 384     UINT8      *p_val;
 385 }tBTA_BLE_SERVICE_DATA;
 386
 387 typedef tBTM_BLE_128SERVICE tBTA_BLE_128SERVICE;
 388 typedef tBTM_BLE_32SERVICE  tBTA_BLE_32SERVICE;
 389
 390 typedef struct
 391 {
 392     tBTA_BLE_INT_RANGE      int_range;          /* slave prefered conn interval range */
 393     tBTA_BLE_MANU           *p_manu;            /* manufacturer data */
 394     tBTA_BLE_SERVICE        *p_services;        /* 16 bits services */
 395     tBTA_BLE_128SERVICE     *p_services_128b;   /* 128 bits service */
 396     tBTA_BLE_32SERVICE      *p_service_32b;     /* 32 bits Service UUID */
 397     tBTA_BLE_SERVICE        *p_sol_services;    /* 16 bits services Solicitation UUIDs */
 398     tBTA_BLE_32SERVICE      *p_sol_service_32b; /* List of 32 bit Service Solicitation UUIDs */
 399     tBTA_BLE_128SERVICE     *p_sol_service_128b;/* List of 128 bit Service Solicitation UUIDs */
 400     tBTA_BLE_PROPRIETARY    *p_proprietary;     /* proprietary data */
 401     tBTA_BLE_SERVICE_DATA   *p_service_data;    /* service data */
 402     UINT16                  appearance;         /* appearance data */
 403     UINT8                   flag;
 404     UINT8                   tx_power;
 405 }tBTA_BLE_ADV_DATA;
 406
 407 typedef void (tBTA_SET_ADV_DATA_CMPL_CBACK) (tBTA_STATUS status);
 408
 409 /* advertising channel map */
 410 #define BTA_BLE_ADV_CHNL_37 BTM_BLE_ADV_CHNL_37
 411 #define BTA_BLE_ADV_CHNL_38 BTM_BLE_ADV_CHNL_38
 412 #define BTA_BLE_ADV_CHNL_39 BTM_BLE_ADV_CHNL_39
 413 typedef tBTM_BLE_ADV_CHNL_MAP tBTA_BLE_ADV_CHNL_MAP; /* use as a bit mask */
 414
 415 /* advertising filter policy */
 416 typedef tBTM_BLE_AFP   tBTA_BLE_AFP;
 417
 418 /* adv event type */
 419 #define BTA_BLE_CONNECT_EVT         BTM_BLE_CONNECT_EVT     /* Connectable undirected advertising */
 420 #define BTA_BLE_CONNECT_DIR_EVT     BTM_BLE_CONNECT_DIR_EVT /* Connectable directed advertising */
 421 #define BTA_BLE_DISCOVER_EVT        BTM_BLE_DISCOVER_EVT    /* Scannable undirected advertising */
 422 #define BTA_BLE_NON_CONNECT_EVT     BTM_BLE_NON_CONNECT_EVT /* Non connectable undirected advertising */
 423 typedef UINT8 tBTA_BLE_ADV_EVT;
 424
 425 /* adv tx power level */
 426 #define BTA_BLE_ADV_TX_POWER_MIN        0           /* minimum tx power */
 427 #define BTA_BLE_ADV_TX_POWER_LOW        1           /* low tx power     */
 428 #define BTA_BLE_ADV_TX_POWER_MID        2           /* middle tx power  */
 429 #define BTA_BLE_ADV_TX_POWER_UPPER      3           /* upper tx power   */
 430 #define BTA_BLE_ADV_TX_POWER_MAX        4           /* maximum tx power */
 431 typedef UINT8 tBTA_BLE_ADV_TX_POWER;
 432
 433 /* advertising instance parameters */
 434 typedef struct
 435 {
 436     UINT16                  adv_int_min;            /* minimum adv interval */
 437     UINT16                  adv_int_max;            /* maximum adv interval */
 438     tBTA_BLE_ADV_EVT        adv_type;               /* adv event type */
 439     tBTA_BLE_ADV_CHNL_MAP   channel_map;            /* adv channel map */
 440     tBTA_BLE_AFP            adv_filter_policy;      /* advertising filter policy */
 441     tBTA_BLE_ADV_TX_POWER   tx_power;               /* adv tx power */
 442 }tBTA_BLE_ADV_PARAMS;
 443
 444 /* These are the fields returned in each device adv packet.  It
 445 ** is returned in the results callback if registered.
 446 */
 447 typedef struct
 448 {
 449     UINT8               conn_mode;
 450     tBTA_BLE_AD_MASK    ad_mask;        /* mask of the valid adv data field */
 451     UINT8               flag;
 452     UINT8               tx_power_level;
 453     UINT8               remote_name_len;
 454     UINT8               *p_remote_name;
 455     tBTA_BLE_SERVICE    service;
 456 } tBTA_BLE_INQ_DATA;
 457
 458 enum
 459 {
 460     BTA_BLE_SCAN_MODE_PASS=1,
 461     BTA_BLE_SCAN_MODE_ACTI=2,
 462     BTA_BLE_SCAN_MODE_PASS_ACTI=3
 463 };
 464 typedef UINT8 tBTA_BLE_SCAN_MODE;
 465
 466 enum
 467 {
 468     BTA_BLE_DISCARD_OLD_ITEMS=0,
 469     BTA_BLE_DISCARD_LOWER_RSSI_ITEMS=1
 470 };
 471 typedef UINT8 tBTA_BLE_DISCARD_RULE;
 472
 473 enum
 474 {
 475     BTA_BLE_ADV_SEEN_FIRST_TIME=0,
 476     BTA_BLE_ADV_TRACKING_TIMEOUT=1
 477 };
 478 typedef UINT8 tBTA_BLE_ADV_CHANGE_REASON;
 479
 480 enum
 481 {
 482     BTA_BLE_BATCH_SCAN_ENB_EVT      = 1,
 483     BTA_BLE_BATCH_SCAN_CFG_STRG_EVT = 2,
 484     BTA_BLE_BATCH_SCAN_DATA_EVT     = 3,
 485     BTA_BLE_BATCH_SCAN_THRES_EVT    = 4,
 486     BTA_BLE_BATCH_SCAN_PARAM_EVT    = 5,
 487     BTA_BLE_BATCH_SCAN_DIS_EVT      = 6
 488 };
 489 typedef tBTM_BLE_BATCH_SCAN_EVT tBTA_BLE_BATCH_SCAN_EVT;
 490
 491 typedef tBTM_BLE_TRACK_ADV_ACTION tBTA_BLE_TRACK_ADV_ACTION;
 492 #endif
 493
 494 /* BLE customer specific feature function type definitions */
 495 /* data type used on customer specific feature for RSSI monitoring */
 496 #define BTA_BLE_RSSI_ALERT_HI        0
 497 #define BTA_BLE_RSSI_ALERT_RANGE     1
 498 #define BTA_BLE_RSSI_ALERT_LO        2
 499 typedef UINT8 tBTA_DM_BLE_RSSI_ALERT_TYPE;
 500
 501 #define BTA_BLE_RSSI_ALERT_NONE             BTM_BLE_RSSI_ALERT_NONE             /*      (0) */
 502 #define BTA_BLE_RSSI_ALERT_HI_BIT               BTM_BLE_RSSI_ALERT_HI_BIT               /*      (1) */
 503 #define BTA_BLE_RSSI_ALERT_RANGE_BIT    BTM_BLE_RSSI_ALERT_RANGE_BIT    /*      (1 << 1) */
 504 #define BTA_BLE_RSSI_ALERT_LO_BIT               BTM_BLE_RSSI_ALERT_LO_BIT               /*      (1 << 2) */
 505 typedef UINT8     tBTA_DM_BLE_RSSI_ALERT_MASK;
 506
 507
 508 typedef void (tBTA_DM_BLE_RSSI_CBACK) (BD_ADDR bd_addr, tBTA_DM_BLE_RSSI_ALERT_TYPE alert_type, INT8 rssi);
 509
 510 /* max number of filter spot for different filter type */
 511 #define BTA_DM_BLE_MAX_UUID_FILTER     BTM_BLE_MAX_UUID_FILTER    /* 8 */
 512 #define BTA_DM_BLE_MAX_ADDR_FILTER     BTM_BLE_MAX_ADDR_FILTER    /* 8 */
 513 #define BTA_DM_BLE_PF_STR_COND_MAX     BTM_BLE_PF_STR_COND_MAX    /* 4    apply to manu data , or local name */
 514 #define BTA_DM_BLE_PF_STR_LEN_MAX      BTM_BLE_PF_STR_LEN_MAX  /* match for first 20 bytes */
 515
 516 #define BTA_DM_BLE_PF_LOGIC_OR              0
 517 #define BTA_DM_BLE_PF_LOGIC_AND             1
 518 typedef UINT8 tBTA_DM_BLE_PF_LOGIC_TYPE;
 519
 520 enum
 521 {
 522     BTA_DM_BLE_SCAN_COND_ADD,
 523     BTA_DM_BLE_SCAN_COND_DELETE,
 524     BTA_DM_BLE_SCAN_COND_CLEAR = 2
 525 };
 526 typedef UINT8 tBTA_DM_BLE_SCAN_COND_OP;
 527
 528 /* ADV payload filtering vendor specific call event */
 529 enum
 530 {
 531     BTA_BLE_SCAN_PF_ENABLE_EVT = 7,
 532     BTA_BLE_SCAN_PF_COND_EVT
 533 };
 534
 535 /* filter selection bit index  */
 536 #define BTA_DM_BLE_PF_ADDR_FILTER          BTM_BLE_PF_ADDR_FILTER
 537 #define BTA_DM_BLE_PF_SRVC_DATA            BTM_BLE_PF_SRVC_DATA
 538 #define BTA_DM_BLE_PF_SRVC_UUID            BTM_BLE_PF_SRVC_UUID
 539 #define BTA_DM_BLE_PF_SRVC_SOL_UUID        BTM_BLE_PF_SRVC_SOL_UUID
 540 #define BTA_DM_BLE_PF_LOCAL_NAME           BTM_BLE_PF_LOCAL_NAME
 541 #define BTA_DM_BLE_PF_MANU_DATA            BTM_BLE_PF_MANU_DATA
 542 #define BTA_DM_BLE_PF_SRVC_DATA_PATTERN    BTM_BLE_PF_SRVC_DATA_PATTERN
 543 #define BTA_DM_BLE_PF_TYPE_ALL             BTM_BLE_PF_TYPE_ALL
 544 #define BTA_DM_BLE_PF_TYPE_MAX             BTM_BLE_PF_TYPE_MAX
 545 typedef UINT8   tBTA_DM_BLE_PF_COND_TYPE;
 546
 547 typedef union
 548 {
 549       UINT16              uuid16_mask;
 550       UINT32              uuid32_mask;
 551       UINT8               uuid128_mask[LEN_UUID_128];
 552 }tBTA_DM_BLE_PF_COND_MASK;
 553
 554 typedef struct
 555 {
 556     tBLE_BD_ADDR                *p_target_addr;     /* target address, if NULL, generic UUID filter */
 557     tBT_UUID                    uuid;           /* UUID condition */
 558     tBTA_DM_BLE_PF_LOGIC_TYPE   cond_logic;    /* AND/OR */
 559     tBTA_DM_BLE_PF_COND_MASK    *p_uuid_mask;           /* UUID condition mask, if NULL, match exact as UUID condition */
 560 }tBTA_DM_BLE_PF_UUID_COND;
 561
 562 typedef struct
 563 {
 564     UINT8                   data_len;       /* <= 20 bytes */
 565     UINT8                   *p_data;
 566 }tBTA_DM_BLE_PF_LOCAL_NAME_COND;
 567
 568 typedef struct
 569 {
 570     UINT16                  company_id;     /* company ID */
 571     UINT8                   data_len;       /* <= 20 bytes */
 572     UINT8                   *p_pattern;
 573     UINT16                  company_id_mask; /* UUID value mask */
 574     UINT8                   *p_pattern_mask; /* Manufacturer data matching mask, same length
 575                                                 as data pattern, set to all 0xff, match exact data */
 576 }tBTA_DM_BLE_PF_MANU_COND;
 577
 578 typedef struct
 579 {
 580     UINT16                  uuid;     /* service ID */
 581     UINT8                   data_len;       /* <= 20 bytes */
 582     UINT8                   *p_pattern;
 583     UINT8                   *p_pattern_mask; /* Service data matching mask, same length
 584                                                 as data pattern, set to all 0xff, match exact data */
 585 }tBTA_DM_BLE_PF_SRVC_PATTERN_COND;
 586
 587 typedef union
 588 {
 589     tBLE_BD_ADDR                            target_addr;
 590     tBTA_DM_BLE_PF_LOCAL_NAME_COND             local_name; /* lcoal name filtering */
 591     tBTA_DM_BLE_PF_MANU_COND                   manu_data;  /* manufactuer data filtering */
 592     tBTA_DM_BLE_PF_UUID_COND                   srvc_uuid;  /* service UUID filtering */
 593     tBTA_DM_BLE_PF_UUID_COND                   solicitate_uuid;   /* solicitated service UUID filtering */
 594     tBTA_DM_BLE_PF_SRVC_PATTERN_COND           srvc_data;      /* service data pattern */
 595 }tBTA_DM_BLE_PF_COND_PARAM;
 596
 597 typedef UINT8 tBTA_DM_BLE_PF_FILT_INDEX;
 598 typedef UINT8 tBTA_DM_BLE_PF_AVBL_SPACE;
 599
 600 typedef INT8 tBTA_DM_RSSI_VALUE;
 601 typedef UINT8 tBTA_DM_LINK_QUALITY_VALUE;
 602
 603
 604 /* signal strength mask */
 605 #define BTA_SIG_STRENGTH_RSSI_MASK          1
 606 #define BTA_SIG_STRENGTH_LINK_QUALITY_MASK  2
 607
 608 typedef UINT8 tBTA_SIG_STRENGTH_MASK;
 609
 610
 611 /* Security Callback Events */
 612 #define BTA_DM_ENABLE_EVT               0       /* Enable Event */
 613 #define BTA_DM_DISABLE_EVT              1       /* Disable Event */
 614 #define BTA_DM_PIN_REQ_EVT              2       /* PIN request. */
 615 #define BTA_DM_AUTH_CMPL_EVT            3       /* Authentication complete indication. */
 616 #define BTA_DM_AUTHORIZE_EVT            4       /* Authorization request. */
 617 #define BTA_DM_LINK_UP_EVT              5       /* Connection UP event */
 618 #define BTA_DM_LINK_DOWN_EVT            6       /* Connection DOWN event */
 619 #define BTA_DM_SIG_STRENGTH_EVT         7       /* Signal strength for bluetooth connection */
 620 #define BTA_DM_BUSY_LEVEL_EVT           8       /* System busy level */
 621 #define BTA_DM_BOND_CANCEL_CMPL_EVT     9       /* Bond cancel complete indication */
 622 #define BTA_DM_SP_CFM_REQ_EVT           10      /* Simple Pairing User Confirmation request. */
 623 #define BTA_DM_SP_KEY_NOTIF_EVT         11      /* Simple Pairing Passkey Notification */
 624 #define BTA_DM_SP_RMT_OOB_EVT           12      /* Simple Pairing Remote OOB Data request. */
 625 #define BTA_DM_SP_KEYPRESS_EVT          13      /* Key press notification event. */
 626 #define BTA_DM_ROLE_CHG_EVT             14      /* Role Change event. */
 627 #define BTA_DM_BLE_KEY_EVT              15      /* BLE SMP key event for peer device keys */
 628 #define BTA_DM_BLE_SEC_REQ_EVT          16      /* BLE SMP security request */
 629 #define BTA_DM_BLE_PASSKEY_NOTIF_EVT    17      /* SMP passkey notification event */
 630 #define BTA_DM_BLE_PASSKEY_REQ_EVT      18      /* SMP passkey request event */
 631 #define BTA_DM_BLE_OOB_REQ_EVT          19      /* SMP OOB request event */
 632 #define BTA_DM_BLE_LOCAL_IR_EVT         20      /* BLE local IR event */
 633 #define BTA_DM_BLE_LOCAL_ER_EVT         21      /* BLE local ER event */
 634 // btla-specific ++
 635 #define BTA_DM_BLE_AUTH_CMPL_EVT        22      /* BLE Auth complete */
 636 // btla-specific --
 637 #define BTA_DM_DEV_UNPAIRED_EVT         23
 638 #define BTA_DM_HW_ERROR_EVT             24      /* BT Chip H/W error */
 639 #define BTA_DM_LE_FEATURES_READ         25      /* Cotroller specific LE features are read */
 640 #define BTA_DM_ENER_INFO_READ           26      /* Energy info read */
 641 typedef UINT8 tBTA_DM_SEC_EVT;
 642
 643 /* Structure associated with BTA_DM_ENABLE_EVT */
 644 typedef struct
 645 {
 646     BD_ADDR         bd_addr;            /* BD address of local device. */
 647     tBTA_STATUS    status;
 648 } tBTA_DM_ENABLE;
 649
 650 /* Structure associated with BTA_DM_PIN_REQ_EVT */
 651 typedef struct
 652 {
 653     /* Note: First 3 data members must be, bd_addr, dev_class, and bd_name in order */
 654     BD_ADDR         bd_addr;            /* BD address peer device. */
 655     DEV_CLASS       dev_class;          /* Class of Device */
 656     BD_NAME         bd_name;            /* Name of peer device. */
 657 } tBTA_DM_PIN_REQ;
 658
 659 /* BLE related definition */
 660
 661 #define BTA_DM_AUTH_FAIL_BASE                   (HCI_ERR_MAX_ERR + 10)
 662 #define BTA_DM_AUTH_CONVERT_SMP_CODE(x)        (BTA_DM_AUTH_FAIL_BASE + (x))
 663 #define BTA_DM_AUTH_SMP_PASSKEY_FAIL             BTA_DM_AUTH_CONVERT_SMP_CODE (SMP_PASSKEY_ENTRY_FAIL)
 664 #define BTA_DM_AUTH_SMP_OOB_FAIL                (BTA_DM_AUTH_FAIL_BASE + SMP_OOB_FAIL)
 665 #define BTA_DM_AUTH_SMP_PAIR_AUTH_FAIL          (BTA_DM_AUTH_FAIL_BASE + SMP_PAIR_AUTH_FAIL)
 666 #define BTA_DM_AUTH_SMP_CONFIRM_VALUE_FAIL      (BTA_DM_AUTH_FAIL_BASE + SMP_CONFIRM_VALUE_ERR)
 667 #define BTA_DM_AUTH_SMP_PAIR_NOT_SUPPORT        (BTA_DM_AUTH_FAIL_BASE + SMP_PAIR_NOT_SUPPORT)
 668 #define BTA_DM_AUTH_SMP_ENC_KEY_SIZE            (BTA_DM_AUTH_FAIL_BASE + SMP_ENC_KEY_SIZE)
 669 #define BTA_DM_AUTH_SMP_INVALID_CMD             (BTA_DM_AUTH_FAIL_BASE + SMP_INVALID_CMD)
 670 #define BTA_DM_AUTH_SMP_UNKNOWN_ERR             (BTA_DM_AUTH_FAIL_BASE + SMP_PAIR_FAIL_UNKNOWN)
 671 #define BTA_DM_AUTH_SMP_REPEATED_ATTEMPT        (BTA_DM_AUTH_FAIL_BASE + SMP_REPEATED_ATTEMPTS)
 672 #define BTA_DM_AUTH_SMP_INTERNAL_ERR            (BTA_DM_AUTH_FAIL_BASE + SMP_PAIR_INTERNAL_ERR)
 673 #define BTA_DM_AUTH_SMP_UNKNOWN_IO              (BTA_DM_AUTH_FAIL_BASE + SMP_UNKNOWN_IO_CAP)
 674 #define BTA_DM_AUTH_SMP_INIT_FAIL               (BTA_DM_AUTH_FAIL_BASE + SMP_INIT_FAIL)
 675 #define BTA_DM_AUTH_SMP_CONFIRM_FAIL            (BTA_DM_AUTH_FAIL_BASE + SMP_CONFIRM_FAIL)
 676 #define BTA_DM_AUTH_SMP_BUSY                    (BTA_DM_AUTH_FAIL_BASE + SMP_BUSY)
 677 #define BTA_DM_AUTH_SMP_ENC_FAIL                (BTA_DM_AUTH_FAIL_BASE + SMP_ENC_FAIL)
 678 #define BTA_DM_AUTH_SMP_RSP_TIMEOUT             (BTA_DM_AUTH_FAIL_BASE + SMP_RSP_TIMEOUT)
 679
 680 /* connection parameter boundary value and dummy value */
 681 #define BTA_DM_BLE_SCAN_INT_MIN          BTM_BLE_SCAN_INT_MIN
 682 #define BTA_DM_BLE_SCAN_INT_MAX          BTM_BLE_SCAN_INT_MAX
 683 #define BTA_DM_BLE_SCAN_WIN_MIN          BTM_BLE_SCAN_WIN_MIN
 684 #define BTA_DM_BLE_SCAN_WIN_MAX          BTM_BLE_SCAN_WIN_MAX
 685 #define BTA_DM_BLE_CONN_INT_MIN          BTM_BLE_CONN_INT_MIN
 686 #define BTA_DM_BLE_CONN_INT_MAX          BTM_BLE_CONN_INT_MAX
 687 #define BTA_DM_BLE_CONN_LATENCY_MAX      BTM_BLE_CONN_LATENCY_MAX
 688 #define BTA_DM_BLE_CONN_SUP_TOUT_MIN     BTM_BLE_CONN_SUP_TOUT_MIN
 689 #define BTA_DM_BLE_CONN_SUP_TOUT_MAX     BTM_BLE_CONN_SUP_TOUT_MAX
 690 #define BTA_DM_BLE_CONN_PARAM_UNDEF      BTM_BLE_CONN_PARAM_UNDEF  /* use this value when a specific value not to be overwritten */
 691
 692
 693 #define BTA_LE_KEY_PENC      BTM_LE_KEY_PENC  /* encryption information of peer device */
 694 #define BTA_LE_KEY_PID       BTM_LE_KEY_PID   /* identity key of the peer device */
 695 #define BTA_LE_KEY_PCSRK     BTM_LE_KEY_PCSRK   /* peer SRK */
 696 #define BTA_LE_KEY_LENC      BTM_LE_KEY_LENC        /* master role security information:div */
 697 #define BTA_LE_KEY_LID       BTM_LE_KEY_LID         /* master device ID key */
 698 #define BTA_LE_KEY_LCSRK     BTM_LE_KEY_LCSRK        /* local CSRK has been deliver to peer */
 699 typedef UINT8 tBTA_LE_KEY_TYPE; /* can be used as a bit mask */
 700
 701
 702 typedef tBTM_LE_PENC_KEYS  tBTA_LE_PENC_KEYS ;
 703 typedef tBTM_LE_PCSRK_KEYS tBTA_LE_PCSRK_KEYS;
 704 typedef tBTM_LE_LENC_KEYS  tBTA_LE_LENC_KEYS  ;
 705 typedef tBTM_LE_LCSRK_KEYS tBTA_LE_LCSRK_KEYS ;
 706 typedef tBTM_LE_PID_KEYS   tBTA_LE_PID_KEYS ;
 707
 708 typedef union
 709 {
 710     tBTA_LE_PENC_KEYS   penc_key;       /* received peer encryption key */
 711     tBTA_LE_PCSRK_KEYS  psrk_key;       /* received peer device SRK */
 712     tBTA_LE_PID_KEYS    pid_key;        /* peer device ID key */
 713     tBTA_LE_LENC_KEYS   lenc_key;       /* local encryption reproduction keys LTK = = d1(ER,DIV,0)*/
 714     tBTA_LE_LCSRK_KEYS  lcsrk_key;      /* local device CSRK = d1(ER,DIV,1)*/
 715 }tBTA_LE_KEY_VALUE;
 716
 717 #define BTA_BLE_LOCAL_KEY_TYPE_ID         1
 718 #define BTA_BLE_LOCAL_KEY_TYPE_ER         2
 719 typedef UINT8 tBTA_DM_BLE_LOCAL_KEY_MASK;
 720
 721 typedef struct
 722 {
 723     BT_OCTET16       ir;
 724     BT_OCTET16       irk;
 725     BT_OCTET16       dhk;
 726 }tBTA_BLE_LOCAL_ID_KEYS;
 727
 728 #define BTA_DM_SEC_GRANTED              BTA_SUCCESS
 729 #define BTA_DM_SEC_PAIR_NOT_SPT         BTA_DM_AUTH_SMP_PAIR_NOT_SUPPORT
 730 #define BTA_DM_SEC_REP_ATTEMPTS         BTA_DM_AUTH_SMP_REPEATED_ATTEMPT
 731 typedef UINT8 tBTA_DM_BLE_SEC_GRANT;
 732
 733
 734 #define BTA_DM_BLE_ONN_NONE             BTM_BLE_CONN_NONE
 735 #define BTA_DM_BLE_CONN_AUTO            BTM_BLE_CONN_AUTO
 736 #define BTA_DM_BLE_CONN_SELECTIVE       BTM_BLE_CONN_SELECTIVE
 737 typedef UINT8 tBTA_DM_BLE_CONN_TYPE;
 738
 739 typedef BOOLEAN (tBTA_DM_BLE_SEL_CBACK)(BD_ADDR random_bda, UINT8 *p_remote_name);
 740
 741 /* Structure associated with BTA_DM_BLE_SEC_REQ_EVT */
 742 typedef struct
 743 {
 744     BD_ADDR         bd_addr;        /* peer address */
 745     BD_NAME         bd_name;        /* peer device name */
 746 } tBTA_DM_BLE_SEC_REQ;
 747
 748 typedef struct
 749 {
 750     BD_ADDR                 bd_addr;        /* peer address */
 751     tBTM_LE_KEY_TYPE        key_type;
 752     tBTM_LE_KEY_VALUE       key_value;
 753 }tBTA_DM_BLE_KEY;
 754
 755 /* Structure associated with BTA_DM_AUTH_CMPL_EVT */
 756 typedef struct
 757 {
 758     BD_ADDR         bd_addr;            /* BD address peer device. */
 759     BD_NAME         bd_name;            /* Name of peer device. */
 760     BOOLEAN         key_present;        /* Valid link key value in key element */
 761     LINK_KEY        key;                /* Link key associated with peer device. */
 762     UINT8           key_type;           /* The type of Link Key */
 763     BOOLEAN         success;            /* TRUE of authentication succeeded, FALSE if failed. */
 764 #if BLE_INCLUDED == TRUE
 765     BOOLEAN         privacy_enabled;    /* used for BLE device only */
 766 #endif
 767     UINT8           fail_reason;        /* The HCI reason/error code for when success=FALSE */
 768
 769 } tBTA_DM_AUTH_CMPL;
 770
 771
 772 /* Structure associated with BTA_DM_AUTHORIZE_EVT */
 773 typedef struct
 774 {
 775     BD_ADDR         bd_addr;            /* BD address peer device. */
 776     BD_NAME         bd_name;            /* Name of peer device. */
 777     tBTA_SERVICE_ID service;            /* Service ID to authorize. */
 778 // btla-specific ++
 779     DEV_CLASS      dev_class;
 780 // btla-specific --
 781 } tBTA_DM_AUTHORIZE;
 782
 783 /* Structure associated with BTA_DM_LINK_UP_EVT */
 784 typedef struct
 785 {
 786     BD_ADDR         bd_addr;            /* BD address peer device. */
 787 #if BLE_INCLUDED == TRUE
 788     tBTA_TRANSPORT  link_type;
 789 #endif
 790 } tBTA_DM_LINK_UP;
 791
 792 /* Structure associated with BTA_DM_LINK_DOWN_EVT */
 793 typedef struct
 794 {
 795     BD_ADDR         bd_addr;            /* BD address peer device. */
 796     UINT8           status;             /* connection open/closed */
 797     BOOLEAN         is_removed;         /* TRUE if device is removed when link is down */
 798 #if BLE_INCLUDED == TRUE
 799     tBTA_TRANSPORT  link_type;
 800 #endif
 801 } tBTA_DM_LINK_DOWN;
 802
 803 /* Structure associated with BTA_DM_ROLE_CHG_EVT */
 804 typedef struct
 805 {
 806     BD_ADDR         bd_addr;            /* BD address peer device. */
 807     UINT8           new_role;           /* the new connection role */
 808 } tBTA_DM_ROLE_CHG;
 809
 810 /* Structure associated with BTA_DM_SIG_STRENGTH_EVT */
 811 typedef struct
 812 {
 813     BD_ADDR         bd_addr;            /* BD address peer device. */
 814     tBTA_SIG_STRENGTH_MASK mask;        /* mask for the values that are valid */
 815     tBTA_DM_RSSI_VALUE  rssi_value;
 816     tBTA_DM_LINK_QUALITY_VALUE link_quality_value;
 817
 818 } tBTA_DM_SIG_STRENGTH;
 819
 820 /* Structure associated with BTA_DM_BUSY_LEVEL_EVT */
 821 typedef struct
 822 {
 823     UINT8           level;     /* when paging or inquiring, level is 10.
 824                                     Otherwise, the number of ACL links */
 825     UINT8           level_flags; /* indicates individual flags */
 826 } tBTA_DM_BUSY_LEVEL;
 827
 828 #define BTA_IO_CAP_OUT      BTM_IO_CAP_OUT      /* DisplayOnly */
 829 #define BTA_IO_CAP_IO       BTM_IO_CAP_IO       /* DisplayYesNo */
 830 #define BTA_IO_CAP_IN       BTM_IO_CAP_IN       /* KeyboardOnly */
 831 #define BTA_IO_CAP_NONE     BTM_IO_CAP_NONE     /* NoInputNoOutput */
 832 typedef tBTM_IO_CAP     tBTA_IO_CAP;
 833
 834 #define BTA_AUTH_SP_NO    BTM_AUTH_SP_NO      /* 0 MITM Protection Not Required - Single Profile/non-bonding
 835                                                 Numeric comparison with automatic accept allowed */
 836 #define BTA_AUTH_SP_YES   BTM_AUTH_SP_YES     /* 1 MITM Protection Required - Single Profile/non-bonding
 837                                                 Use IO Capabilities to determine authentication procedure */
 838 #define BTA_AUTH_AP_NO    BTM_AUTH_AP_NO      /* 2 MITM Protection Not Required - All Profiles/dedicated bonding
 839                                                 Numeric comparison with automatic accept allowed */
 840 #define BTA_AUTH_AP_YES   BTM_AUTH_AP_YES     /* 3 MITM Protection Required - All Profiles/dedicated bonding
 841                                                 Use IO Capabilities to determine authentication procedure */
 842 #define BTA_AUTH_SPGB_NO  BTM_AUTH_SPGB_NO    /* 4 MITM Protection Not Required - Single Profiles/general bonding
 843                                                 Numeric comparison with automatic accept allowed */
 844 #define BTA_AUTH_SPGB_YES BTM_AUTH_SPGB_YES   /* 5 MITM Protection Required - Single Profiles/general bonding
 845                                                 Use IO Capabilities to determine authentication procedure */
 846 typedef tBTM_AUTH_REQ   tBTA_AUTH_REQ;
 847
 848 #define BTA_AUTH_DD_BOND    BTM_AUTH_DD_BOND  /* 2 this bit is set for dedicated bonding */
 849 #define BTA_AUTH_GEN_BOND   BTM_AUTH_SPGB_NO  /* 4 this bit is set for general bonding */
 850 #define BTA_AUTH_BONDS      BTM_AUTH_BONDS    /* 6 the general/dedicated bonding bits  */
 851
 852 #define BTA_LE_AUTH_NO_BOND    BTM_LE_AUTH_REQ_NO_BOND  /* 0*/
 853 #define BTA_LE_AUTH_BOND       BTM_LE_AUTH_REQ_BOND     /* 1 << 0 */
 854 #define BTA_LE_AUTH_REQ_MITM   BTM_LE_AUTH_REQ_MITM    /* 1 << 2 */
 855 typedef tBTM_LE_AUTH_REQ       tBTA_LE_AUTH_REQ;       /* combination of the above bit pattern */
 856
 857 #define BTA_OOB_NONE        BTM_OOB_NONE
 858 #define BTA_OOB_PRESENT     BTM_OOB_PRESENT
 859 #if BTM_OOB_INCLUDED == TRUE
 860 #define BTA_OOB_UNKNOWN     BTM_OOB_UNKNOWN
 861 #endif
 862 typedef tBTM_OOB_DATA   tBTA_OOB_DATA;
 863
 864 /* Structure associated with BTA_DM_SP_CFM_REQ_EVT */
 865 typedef struct
 866 {
 867     /* Note: First 3 data members must be, bd_addr, dev_class, and bd_name in order */
 868     BD_ADDR         bd_addr;        /* peer address */
 869     DEV_CLASS       dev_class;      /* peer CoD */
 870     BD_NAME         bd_name;        /* peer device name */
 871     UINT32          num_val;        /* the numeric value for comparison. If just_works, do not show this number to UI */
 872     BOOLEAN         just_works;     /* TRUE, if "Just Works" association model */
 873     tBTA_AUTH_REQ   loc_auth_req;   /* Authentication required for local device */
 874     tBTA_AUTH_REQ   rmt_auth_req;   /* Authentication required for peer device */
 875     tBTA_IO_CAP     loc_io_caps;    /* IO Capabilities of local device */
 876     tBTA_AUTH_REQ   rmt_io_caps;    /* IO Capabilities of remote device */
 877 } tBTA_DM_SP_CFM_REQ;
 878
 879 enum
 880 {
 881     BTA_SP_KEY_STARTED,         /* passkey entry started */
 882     BTA_SP_KEY_ENTERED,         /* passkey digit entered */
 883     BTA_SP_KEY_ERASED,          /* passkey digit erased */
 884     BTA_SP_KEY_CLEARED,         /* passkey cleared */
 885     BTA_SP_KEY_COMPLT           /* passkey entry completed */
 886 };
 887 typedef UINT8   tBTA_SP_KEY_TYPE;
 888
 889 /* Structure associated with BTA_DM_SP_KEYPRESS_EVT */
 890 typedef struct
 891 {
 892     BD_ADDR             bd_addr;        /* peer address */
 893     tBTA_SP_KEY_TYPE   notif_type;
 894 }tBTA_DM_SP_KEY_PRESS;
 895
 896 /* Structure associated with BTA_DM_SP_KEY_NOTIF_EVT */
 897 typedef struct
 898 {
 899     /* Note: First 3 data members must be, bd_addr, dev_class, and bd_name in order */
 900     BD_ADDR         bd_addr;        /* peer address */
 901     DEV_CLASS       dev_class;      /* peer CoD */
 902     BD_NAME         bd_name;        /* peer device name */
 903     UINT32          passkey;        /* the numeric value for comparison. If just_works, do not show this number to UI */
 904 } tBTA_DM_SP_KEY_NOTIF;
 905
 906 /* Structure associated with BTA_DM_SP_RMT_OOB_EVT */
 907 typedef struct
 908 {
 909     /* Note: First 3 data members must be, bd_addr, dev_class, and bd_name in order */
 910     BD_ADDR         bd_addr;        /* peer address */
 911     DEV_CLASS       dev_class;      /* peer CoD */
 912     BD_NAME         bd_name;        /* peer device name */
 913 } tBTA_DM_SP_RMT_OOB;
 914
 915 /* Structure associated with BTA_DM_BOND_CANCEL_CMPL_EVT */
 916 typedef struct
 917 {
 918     tBTA_STATUS     result;    /* TRUE of bond cancel succeeded, FALSE if failed. */
 919 } tBTA_DM_BOND_CANCEL_CMPL;
 920
 921 /* Union of all security callback structures */
 922 typedef union
 923 {
 924     tBTA_DM_ENABLE      enable;         /* BTA enabled */
 925     tBTA_DM_PIN_REQ     pin_req;        /* PIN request. */
 926     tBTA_DM_AUTH_CMPL   auth_cmpl;      /* Authentication complete indication. */
 927     tBTA_DM_AUTHORIZE   authorize;      /* Authorization request. */
 928     tBTA_DM_LINK_UP     link_up;       /* ACL connection down event */
 929     tBTA_DM_LINK_DOWN   link_down;       /* ACL connection down event */
 930     tBTA_DM_SIG_STRENGTH sig_strength;  /* rssi and link quality value */
 931     tBTA_DM_BUSY_LEVEL  busy_level;     /* System busy level */
 932     tBTA_DM_SP_CFM_REQ  cfm_req;        /* user confirm request */
 933     tBTA_DM_SP_KEY_NOTIF key_notif;     /* passkey notification */
 934     tBTA_DM_SP_RMT_OOB  rmt_oob;        /* remote oob */
 935     tBTA_DM_BOND_CANCEL_CMPL bond_cancel_cmpl; /* Bond Cancel Complete indication */
 936     tBTA_DM_SP_KEY_PRESS   key_press;   /* key press notification event */
 937     tBTA_DM_ROLE_CHG     role_chg;       /* role change event */
 938     tBTA_DM_BLE_SEC_REQ  ble_req;        /* BLE SMP related request */
 939     tBTA_DM_BLE_KEY      ble_key;        /* BLE SMP keys used when pairing */
 940     tBTA_BLE_LOCAL_ID_KEYS  ble_id_keys;  /* IR event */
 941     BT_OCTET16              ble_er;       /* ER event data */
 942 } tBTA_DM_SEC;
 943
 944 /* Security callback */
 945 typedef void (tBTA_DM_SEC_CBACK)(tBTA_DM_SEC_EVT event, tBTA_DM_SEC *p_data);
 946
 947 #define BTA_BLE_MULTI_ADV_ILLEGAL 0
 948
 949 /* multi adv callback event */
 950 #define BTA_BLE_MULTI_ADV_ENB_EVT           1
 951 #define BTA_BLE_MULTI_ADV_DISABLE_EVT       2
 952 #define BTA_BLE_MULTI_ADV_PARAM_EVT         3
 953 #define BTA_BLE_MULTI_ADV_DATA_EVT          4
 954
 955 typedef UINT8 tBTA_BLE_MULTI_ADV_EVT;
 956
 957 /* multi adv callback */
 958 typedef void (tBTA_BLE_MULTI_ADV_CBACK)(tBTA_BLE_MULTI_ADV_EVT event,
 959                                         UINT8 inst_id, void *p_ref, tBTA_STATUS status);
 960 typedef UINT32 tBTA_DM_BLE_REF_VALUE;
 961
 962 #define BTA_DM_BLE_PF_ENABLE_EVT       BTM_BLE_PF_ENABLE
 963 #define BTA_DM_BLE_PF_CONFIG_EVT       BTM_BLE_PF_CONFIG
 964 typedef UINT8 tBTA_DM_BLE_PF_EVT;
 965
 966 typedef UINT8   tBTA_DM_BLE_PF_COND_TYPE;
 967
 968 #define BTA_DM_BLE_PF_LOGIC_OR              0
 969 #define BTA_DM_BLE_PF_LOGIC_AND             1
 970 typedef UINT8 tBTA_DM_BLE_PF_LOGIC_TYPE;
 971
 972 #define BTA_DM_BLE_PF_ENABLE       1
 973 #define BTA_DM_BLE_PF_CONFIG       2
 974 typedef UINT8 tBTA_DM_BLE_PF_ACTION;
 975
 976 typedef UINT8 tBTA_DM_BLE_PF_FILT_INDEX;
 977
 978 typedef UINT8 tBTA_DM_BLE_PF_AVBL_SPACE;
 979
 980 /* Config callback */
 981 typedef void (tBTA_DM_BLE_PF_CFG_CBACK) (tBTA_DM_BLE_PF_ACTION action,
 982                                          tBTA_DM_BLE_PF_COND_TYPE cfg_cond,
 983                                          tBTA_DM_BLE_PF_AVBL_SPACE avbl_space, tBTA_STATUS status,
 984                                          tBTA_DM_BLE_REF_VALUE ref_value);
 985 /* Param callback */
 986 typedef void (tBTA_DM_BLE_PF_PARAM_CBACK) (UINT8 action_type, tBTA_DM_BLE_PF_AVBL_SPACE avbl_space,
 987                                            tBTA_DM_BLE_REF_VALUE ref_value, tBTA_STATUS status);
 988
 989 /* Status callback */
 990 typedef void (tBTA_DM_BLE_PF_STATUS_CBACK) (UINT8 action, tBTA_STATUS status,
 991                                             tBTA_DM_BLE_REF_VALUE ref_value);
 992
 993
 994 #define BTA_DM_BLE_PF_BRDCAST_ADDR_FILT  1
 995 #define BTA_DM_BLE_PF_SERV_DATA_CHG_FILT 2
 996 #define BTA_DM_BLE_PF_SERV_UUID          4
 997 #define BTA_DM_BLE_PF_SERV_SOLC_UUID     8
 998 #define BTA_DM_BLE_PF_LOC_NAME_CHECK    16
 999 #define BTA_DM_BLE_PF_MANUF_NAME_CHECK  32
1000 #define BTA_DM_BLE_PF_SERV_DATA_CHECK   64
1001 typedef UINT16 tBTA_DM_BLE_PF_FEAT_SEL;
1002
1003 #define BTA_DM_BLE_PF_LIST_LOGIC_OR   1
1004 #define BTA_DM_BLE_PF_LIST_LOGIC_AND  2
1005 typedef UINT16 tBTA_DM_BLE_PF_LIST_LOGIC_TYPE;
1006
1007 #define BTA_DM_BLE_PF_FILT_LOGIC_OR   0
1008 #define BTA_DM_BLE_PF_FILT_LOGIC_AND  1
1009 typedef UINT16 tBTA_DM_BLE_PF_FILT_LOGIC_TYPE;
1010
1011 typedef UINT8  tBTA_DM_BLE_PF_RSSI_THRESHOLD;
1012 typedef UINT8  tBTA_DM_BLE_PF_DELIVERY_MODE;
1013 typedef UINT16 tBTA_DM_BLE_PF_TIMEOUT;
1014 typedef UINT8  tBTA_DM_BLE_PF_TIMEOUT_CNT;
1015
1016 typedef struct
1017 {
1018     tBTA_DM_BLE_PF_FEAT_SEL feat_seln;
1019     tBTA_DM_BLE_PF_LIST_LOGIC_TYPE list_logic_type;
1020     tBTA_DM_BLE_PF_FILT_LOGIC_TYPE filt_logic_type;
1021     tBTA_DM_BLE_PF_RSSI_THRESHOLD  rssi_high_thres;
1022     tBTA_DM_BLE_PF_RSSI_THRESHOLD  rssi_low_thres;
1023     tBTA_DM_BLE_PF_DELIVERY_MODE dely_mode;
1024     tBTA_DM_BLE_PF_TIMEOUT found_timeout;
1025     tBTA_DM_BLE_PF_TIMEOUT lost_timeout;
1026     tBTA_DM_BLE_PF_TIMEOUT_CNT found_timeout_cnt;
1027 } tBTA_DM_BLE_PF_FILT_PARAMS;
1028
1029 /* Vendor Specific Command Callback */
1030 typedef tBTM_VSC_CMPL_CB        tBTA_VENDOR_CMPL_CBACK;
1031
1032 /* Search callback events */
1033 #define BTA_DM_INQ_RES_EVT              0       /* Inquiry result for a peer device. */
1034 #define BTA_DM_INQ_CMPL_EVT             1       /* Inquiry complete. */
1035 #define BTA_DM_DISC_RES_EVT             2       /* Discovery result for a peer device. */
1036 #define BTA_DM_DISC_BLE_RES_EVT         3       /* Discovery result for BLE GATT based servoce on a peer device. */
1037 #define BTA_DM_DISC_CMPL_EVT            4       /* Discovery complete. */
1038 #define BTA_DM_DI_DISC_CMPL_EVT         5       /* Discovery complete. */
1039 #define BTA_DM_SEARCH_CANCEL_CMPL_EVT   6       /* Search cancelled */
1040
1041 typedef UINT8 tBTA_DM_SEARCH_EVT;
1042
1043 #define BTA_DM_INQ_RES_IGNORE_RSSI      BTM_INQ_RES_IGNORE_RSSI /* 0x7f RSSI value not supplied (ignore it) */
1044
1045 /* Structure associated with BTA_DM_INQ_RES_EVT */
1046 typedef struct
1047 {
1048     BD_ADDR         bd_addr;                /* BD address peer device. */
1049     DEV_CLASS       dev_class;              /* Device class of peer device. */
1050     BOOLEAN         remt_name_not_required; /* Application sets this flag if it already knows the name of the device */
1051                                             /* If the device name is known to application BTA skips the remote name request */
1052     BOOLEAN         is_limited;             /* TRUE, if the limited inquiry bit is set in the CoD */
1053     INT8            rssi;                   /* The rssi value */
1054     UINT8           *p_eir;                 /* received EIR */
1055 #if (BLE_INCLUDED == TRUE)
1056     UINT8               inq_result_type;
1057     UINT8               ble_addr_type;
1058     tBTM_BLE_EVT_TYPE   ble_evt_type;
1059     tBT_DEVICE_TYPE     device_type;
1060     UINT8               flag;
1061 #endif
1062
1063 } tBTA_DM_INQ_RES;
1064
1065 /* Structure associated with BTA_DM_INQ_CMPL_EVT */
1066 typedef struct
1067 {
1068     UINT8           num_resps;          /* Number of inquiry responses. */
1069 } tBTA_DM_INQ_CMPL;
1070
1071 /* Structure associated with BTA_DM_DI_DISC_CMPL_EVT */
1072 typedef struct
1073 {
1074     BD_ADDR             bd_addr;        /* BD address peer device. */
1075     UINT8               num_record;     /* Number of DI record */
1076     tBTA_STATUS         result;
1077 } tBTA_DM_DI_DISC_CMPL;
1078
1079 /* Structure associated with BTA_DM_DISC_RES_EVT */
1080 typedef struct
1081 {
1082     BD_ADDR             bd_addr;        /* BD address peer device. */
1083     BD_NAME             bd_name;        /* Name of peer device. */
1084     tBTA_SERVICE_MASK   services;       /* Services found on peer device. */
1085 // btla-specific ++
1086     UINT8           *   p_raw_data;     /* Raw data for discovery DB */
1087     UINT32              raw_data_size;  /* size of raw data */
1088     tBT_DEVICE_TYPE     device_type;    /* device type in case it is BLE device */
1089     UINT32              num_uuids;
1090     UINT8               *p_uuid_list;
1091 // btla-specific --
1092     tBTA_STATUS         result;
1093 } tBTA_DM_DISC_RES;
1094
1095 /* Structure associated with tBTA_DM_DISC_BLE_RES */
1096 typedef struct
1097 {
1098     BD_ADDR             bd_addr;        /* BD address peer device. */
1099     BD_NAME             bd_name;        /* Name of peer device. */
1100     tBT_UUID            service;        /* GATT based Services UUID found on peer device. */
1101 } tBTA_DM_DISC_BLE_RES;
1102
1103
1104 /* Union of all search callback structures */
1105 typedef union
1106 {
1107     tBTA_DM_INQ_RES     inq_res;        /* Inquiry result for a peer device. */
1108     tBTA_DM_INQ_CMPL    inq_cmpl;       /* Inquiry complete. */
1109     tBTA_DM_DISC_RES    disc_res;       /* Discovery result for a peer device. */
1110     tBTA_DM_DISC_BLE_RES    disc_ble_res;   /* discovery result for GATT based service */
1111     tBTA_DM_DI_DISC_CMPL    di_disc;        /* DI discovery result for a peer device */
1112
1113 } tBTA_DM_SEARCH;
1114
1115 /* Search callback */
1116 typedef void (tBTA_DM_SEARCH_CBACK)(tBTA_DM_SEARCH_EVT event, tBTA_DM_SEARCH *p_data);
1117
1118 /* Execute call back */
1119 typedef void (tBTA_DM_EXEC_CBACK) (void * p_param);
1120
1121 /* Encryption callback*/
1122 typedef void (tBTA_DM_ENCRYPT_CBACK) (BD_ADDR bd_addr, tBTA_TRANSPORT transport, tBTA_STATUS result);
1123
1124 #if BLE_INCLUDED == TRUE
1125 #define BTA_DM_BLE_SEC_NONE         BTM_BLE_SEC_NONE
1126 #define BTA_DM_BLE_SEC_ENCRYPT      BTM_BLE_SEC_ENCRYPT
1127 #define BTA_DM_BLE_SEC_NO_MITM      BTM_BLE_SEC_ENCRYPT_NO_MITM
1128 #define BTA_DM_BLE_SEC_MITM         BTM_BLE_SEC_ENCRYPT_MITM
1129 typedef tBTM_BLE_SEC_ACT            tBTA_DM_BLE_SEC_ACT;
1130
1131 typedef tBTM_BLE_TX_TIME_MS         tBTA_DM_BLE_TX_TIME_MS;
1132 typedef tBTM_BLE_RX_TIME_MS         tBTA_DM_BLE_RX_TIME_MS;
1133 typedef tBTM_BLE_IDLE_TIME_MS       tBTA_DM_BLE_IDLE_TIME_MS;
1134 typedef tBTM_BLE_ENERGY_USED        tBTA_DM_BLE_ENERGY_USED;
1135
1136 #define BTA_DM_CONTRL_UNKNOWN 0       /* Unknown state */
1137 #define BTA_DM_CONTRL_ACTIVE  1       /* ACL link on, SCO link ongoing, sniff mode */
1138 #define BTA_DM_CONTRL_SCAN    2       /* Scan state - paging/inquiry/trying to connect*/
1139 #define BTA_DM_CONTRL_IDLE    3       /* Idle state - page scan, LE advt, inquiry scan */
1140
1141 typedef UINT8 tBTA_DM_CONTRL_STATE;
1142
1143
1144 typedef void (tBTA_BLE_SCAN_THRESHOLD_CBACK)(tBTA_DM_BLE_REF_VALUE ref_value);
1145
1146 typedef void (tBTA_BLE_SCAN_REP_CBACK) (tBTA_DM_BLE_REF_VALUE ref_value, UINT8 report_format,
1147                                         UINT8 num_records, UINT16 data_len,
1148                                         UINT8* p_rep_data, tBTA_STATUS status);
1149
1150 typedef void (tBTA_BLE_SCAN_SETUP_CBACK) (tBTA_BLE_BATCH_SCAN_EVT evt,
1151                                           tBTA_DM_BLE_REF_VALUE ref_value,
1152                                           tBTA_STATUS status);
1153
1154 typedef void (tBTA_BLE_TRACK_ADV_CMPL_CBACK)(int action, tBTA_STATUS status,
1155                                              tBTA_DM_BLE_PF_AVBL_SPACE avbl_space,
1156                                              tBTA_DM_BLE_REF_VALUE ref_value);
1157
1158 typedef void (tBTA_BLE_TRACK_ADV_CBACK)(int filt_index, tBLE_ADDR_TYPE addr_type, BD_ADDR bda,
1159                                         int adv_state, tBTA_DM_BLE_REF_VALUE ref_value);
1160
1161 typedef void (tBTA_BLE_ENERGY_INFO_CBACK)(tBTA_DM_BLE_TX_TIME_MS tx_time,
1162                                           tBTA_DM_BLE_RX_TIME_MS rx_time,
1163                                           tBTA_DM_BLE_IDLE_TIME_MS idle_time,
1164                                           tBTA_DM_BLE_ENERGY_USED  energy_used,
1165                                           tBTA_DM_CONTRL_STATE ctrl_state,
1166                                           tBTA_STATUS status);
1167
1168 #else
1169 typedef UINT8                       tBTA_DM_BLE_SEC_ACT;
1170 #endif
1171
1172 /* Maximum service name length */
1173 #define BTA_SERVICE_NAME_LEN    35
1174 #define BTA_SERVICE_DESP_LEN    BTA_SERVICE_NAME_LEN
1175 #define BTA_PROVIDER_NAME_LEN   BTA_SERVICE_NAME_LEN
1176
1177
1178 /* link policy masks  */
1179 #define BTA_DM_LP_SWITCH        HCI_ENABLE_MASTER_SLAVE_SWITCH
1180 #define BTA_DM_LP_HOLD          HCI_ENABLE_HOLD_MODE
1181 #define BTA_DM_LP_SNIFF         HCI_ENABLE_SNIFF_MODE
1182 #define BTA_DM_LP_PARK          HCI_ENABLE_PARK_MODE
1183 typedef UINT16 tBTA_DM_LP_MASK;
1184
1185 /* power mode actions  */
1186 #define BTA_DM_PM_NO_ACTION    0x00       /* no change to the current pm setting */
1187 #define BTA_DM_PM_PARK         0x10       /* prefers park mode */
1188 #define BTA_DM_PM_SNIFF        0x20       /* prefers sniff mode */
1189 #define BTA_DM_PM_SNIFF1       0x21       /* prefers sniff1 mode */
1190 #define BTA_DM_PM_SNIFF2       0x22       /* prefers sniff2 mode */
1191 #define BTA_DM_PM_SNIFF3       0x23       /* prefers sniff3 mode */
1192 #define BTA_DM_PM_SNIFF4       0x24       /* prefers sniff4 mode */
1193 #define BTA_DM_PM_SNIFF5       0x25       /* prefers sniff5 mode */
1194 #define BTA_DM_PM_SNIFF6       0x26       /* prefers sniff6 mode */
1195 #define BTA_DM_PM_SNIFF7       0x27       /* prefers sniff7 mode */
1196 #define BTA_DM_PM_SNIFF_USER0  0x28       /* prefers user-defined sniff0 mode (testtool only) */
1197 #define BTA_DM_PM_SNIFF_USER1  0x29       /* prefers user-defined sniff1 mode (testtool only) */
1198 #define BTA_DM_PM_ACTIVE       0x40       /* prefers active mode */
1199 #define BTA_DM_PM_RETRY        0x80       /* retry power mode based on current settings */
1200 #define BTA_DM_PM_NO_PREF      0x01       /* service has no prefernce on power mode setting. eg. connection to service got closed */
1201
1202 typedef UINT8 tBTA_DM_PM_ACTTION;
1203
1204 /* index to bta_dm_ssr_spec */
1205 #define BTA_DM_PM_SSR0          0
1206 #define BTA_DM_PM_SSR1          1       /* BTA_DM_PM_SSR1 will be dedicated for
1207                                         HH SSR setting entry, no other profile can use it */
1208 #define BTA_DM_PM_SSR2          2
1209 #define BTA_DM_PM_SSR3          3
1210 #define BTA_DM_PM_SSR4          4
1211 #define BTA_DM_PM_SSR5          5
1212 #define BTA_DM_PM_SSR6          6
1213
1214 #define BTA_DM_PM_NUM_EVTS      9
1215
1216 #ifndef BTA_DM_PM_PARK_IDX
1217 #define BTA_DM_PM_PARK_IDX      5 /* the actual index to bta_dm_pm_md[] for PARK mode */
1218 #endif
1219
1220 #ifndef BTA_DM_PM_SNIFF_A2DP_IDX
1221 #define BTA_DM_PM_SNIFF_A2DP_IDX      BTA_DM_PM_SNIFF
1222 #endif
1223
1224 #ifndef BTA_DM_PM_SNIFF_HD_IDLE_IDX
1225 #define BTA_DM_PM_SNIFF_HD_IDLE_IDX   BTA_DM_PM_SNIFF2
1226 #endif
1227
1228 #ifndef BTA_DM_PM_SNIFF_SCO_OPEN_IDX
1229 #define BTA_DM_PM_SNIFF_SCO_OPEN_IDX  BTA_DM_PM_SNIFF3
1230 #endif
1231
1232 #ifndef BTA_DM_PM_SNIFF_HD_ACTIVE_IDX
1233 #define BTA_DM_PM_SNIFF_HD_ACTIVE_IDX BTA_DM_PM_SNIFF4
1234 #endif
1235
1236 #ifndef BTA_DM_PM_SNIFF_HH_OPEN_IDX
1237 #define BTA_DM_PM_SNIFF_HH_OPEN_IDX BTA_DM_PM_SNIFF2
1238 #endif
1239
1240 #ifndef BTA_DM_PM_SNIFF_HH_ACTIVE_IDX
1241 #define BTA_DM_PM_SNIFF_HH_ACTIVE_IDX BTA_DM_PM_SNIFF2
1242 #endif
1243
1244 #ifndef BTA_DM_PM_SNIFF_HH_IDLE_IDX
1245 #define BTA_DM_PM_SNIFF_HH_IDLE_IDX BTA_DM_PM_SNIFF2
1246 #endif
1247
1248
1249 #ifndef BTA_DM_PM_HH_OPEN_DELAY
1250 #define BTA_DM_PM_HH_OPEN_DELAY 30000
1251 #endif
1252
1253 #ifndef BTA_DM_PM_HH_ACTIVE_DELAY
1254 #define BTA_DM_PM_HH_ACTIVE_DELAY 30000
1255 #endif
1256
1257 #ifndef BTA_DM_PM_HH_IDLE_DELAY
1258 #define BTA_DM_PM_HH_IDLE_DELAY 30000
1259 #endif
1260
1261 /* The Sniff Parameters defined below must be ordered from highest
1262  * latency (biggest interval) to lowest latency.  If there is a conflict
1263  * among the connected services the setting with the lowest latency will
1264  * be selected.  If a device should override a sniff parameter then it
1265  * must insure that order is maintained.
1266  */
1267 #ifndef BTA_DM_PM_SNIFF_MAX
1268 #define BTA_DM_PM_SNIFF_MAX      800
1269 #define BTA_DM_PM_SNIFF_MIN      400
1270 #define BTA_DM_PM_SNIFF_ATTEMPT  4
1271 #define BTA_DM_PM_SNIFF_TIMEOUT  1
1272 #endif
1273
1274 #ifndef BTA_DM_PM_SNIFF1_MAX
1275 #define BTA_DM_PM_SNIFF1_MAX     400
1276 #define BTA_DM_PM_SNIFF1_MIN     200
1277 #define BTA_DM_PM_SNIFF1_ATTEMPT 4
1278 #define BTA_DM_PM_SNIFF1_TIMEOUT 1
1279 #endif
1280
1281 #ifndef BTA_DM_PM_SNIFF2_MAX
1282 #define BTA_DM_PM_SNIFF2_MAX     180
1283 #define BTA_DM_PM_SNIFF2_MIN     150
1284 #define BTA_DM_PM_SNIFF2_ATTEMPT 4
1285 #define BTA_DM_PM_SNIFF2_TIMEOUT 1
1286 #endif
1287
1288 #ifndef BTA_DM_PM_SNIFF3_MAX
1289 #define BTA_DM_PM_SNIFF3_MAX     150
1290 #define BTA_DM_PM_SNIFF3_MIN     50
1291 #define BTA_DM_PM_SNIFF3_ATTEMPT 4
1292 #define BTA_DM_PM_SNIFF3_TIMEOUT 1
1293 #endif
1294
1295 #ifndef BTA_DM_PM_SNIFF4_MAX
1296 #define BTA_DM_PM_SNIFF4_MAX     54
1297 #define BTA_DM_PM_SNIFF4_MIN     30
1298 #define BTA_DM_PM_SNIFF4_ATTEMPT 4
1299 #define BTA_DM_PM_SNIFF4_TIMEOUT 1
1300 #endif
1301
1302 #ifndef BTA_DM_PM_PARK_MAX
1303 #define BTA_DM_PM_PARK_MAX       800
1304 #define BTA_DM_PM_PARK_MIN       400
1305 #define BTA_DM_PM_PARK_ATTEMPT   0
1306 #define BTA_DM_PM_PARK_TIMEOUT   0
1307 #endif
1308
1309
1310 /* Switch callback events */
1311 #define BTA_DM_SWITCH_CMPL_EVT      0       /* Completion of the Switch API */
1312
1313 typedef UINT8 tBTA_DM_SWITCH_EVT;
1314 typedef void (tBTA_DM_SWITCH_CBACK)(tBTA_DM_SWITCH_EVT event, tBTA_STATUS status);
1315
1316 /* Audio routing out configuration */
1317 #define BTA_DM_ROUTE_NONE       0x00    /* No Audio output */
1318 #define BTA_DM_ROUTE_DAC        0x01    /* routing over analog output */
1319 #define BTA_DM_ROUTE_I2S        0x02    /* routing over digital (I2S) output */
1320 #define BTA_DM_ROUTE_BT_MONO    0x04    /* routing over SCO */
1321 #define BTA_DM_ROUTE_BT_STEREO  0x08    /* routing over BT Stereo */
1322 #define BTA_DM_ROUTE_HOST       0x10    /* routing over Host */
1323 #define BTA_DM_ROUTE_FMTX       0x20    /* routing over FMTX */
1324 #define BTA_DM_ROUTE_FMRX       0x40    /* routing over FMRX */
1325 #define BTA_DM_ROUTE_BTSNK      0x80    /* routing over BT SNK */
1326
1327 typedef UINT8 tBTA_DM_ROUTE_PATH;
1328
1329
1330 /* Device Identification (DI) data structure
1331 */
1332 /* Used to set the DI record */
1333 typedef tSDP_DI_RECORD          tBTA_DI_RECORD;
1334 /* Used to get the DI record */
1335 typedef tSDP_DI_GET_RECORD      tBTA_DI_GET_RECORD;
1336 /* SDP discovery database */
1337 typedef tSDP_DISCOVERY_DB       tBTA_DISCOVERY_DB;
1338
1339 #ifndef         BTA_DI_NUM_MAX
1340 #define         BTA_DI_NUM_MAX       3
1341 #endif
1342
1343 /* Device features mask definitions */
1344 #define BTA_FEATURE_BYTES_PER_PAGE  BTM_FEATURE_BYTES_PER_PAGE
1345 #define BTA_EXT_FEATURES_PAGE_MAX   BTM_EXT_FEATURES_PAGE_MAX
1346 /* ACL type
1347 */
1348 #define BTA_DM_LINK_TYPE_BR_EDR    0x01
1349 #define BTA_DM_LINK_TYPE_LE        0x02
1350 #define BTA_DM_LINK_TYPE_ALL       0xFF
1351 typedef UINT8 tBTA_DM_LINK_TYPE;
1352
1353 #define IMMEDIATE_DELY_MODE  0x00
1354 #define ONFOUND_DELY_MODE    0x01
1355 #define BATCH_DELY_MODE      0x02
1356 #define ALLOW_ALL_FILTER     0x00
1357 #define LOWEST_RSSI_VALUE     129
1358
1359 /*****************************************************************************
1360 **  External Function Declarations
1361 *****************************************************************************/
1362 #ifdef __cplusplus
1363 extern "C"
1364 {
1365 #endif
1366
1367 /*******************************************************************************
1368 **
1369 ** Function         BTA_EnableBluetooth
1370 **
1371 ** Description      This function initializes BTA and prepares BTA and the
1372 **                  Bluetooth protocol stack for use.  This function is
1373 **                  typically called at startup or when Bluetooth services
1374 **                  are required by the phone.  This function must be called
1375 **                  before calling any other API function.
1376 **
1377 **
1378 ** Returns          BTA_SUCCESS if successful.
1379 **                  BTA_FAIL if internal failure.
1380 **
1381 *******************************************************************************/
1382 BTA_API extern tBTA_STATUS BTA_EnableBluetooth(tBTA_DM_SEC_CBACK *p_cback);
1383
1384 /*******************************************************************************
1385 **
1386 ** Function         BTA_DisableBluetooth
1387 **
1388 ** Description      This function disables BTA and the Bluetooth protocol
1389 **                  stack.  It is called when BTA is no longer being used
1390 **                  by any application in the system.
1391 **
1392 **
1393 ** Returns          void
1394 **
1395 *******************************************************************************/
1396 BTA_API extern tBTA_STATUS BTA_DisableBluetooth(void);
1397
1398 /*******************************************************************************
1399 **
1400 ** Function         BTA_EnableTestMode
1401 **
1402 ** Description      Enables bluetooth device under test mode
1403 **
1404 **
1405 ** Returns          tBTA_STATUS
1406 **
1407 *******************************************************************************/
1408 BTA_API extern tBTA_STATUS BTA_EnableTestMode(void);
1409
1410 /*******************************************************************************
1411 **
1412 ** Function         BTA_DisableTestMode
1413 **
1414 ** Description      Disable bluetooth device under test mode
1415 **
1416 **
1417 ** Returns          None
1418 **
1419 *******************************************************************************/
1420 BTA_API extern void BTA_DisableTestMode(void);
1421
1422 /*******************************************************************************
1423 **
1424 ** Function         BTA_DmIsDeviceUp
1425 **
1426 ** Description      This function tests whether the Bluetooth module is up
1427 **                  and ready.  This is a direct execution function that
1428 **                  may lock task scheduling on some platforms.
1429 **
1430 **
1431 ** Returns          TRUE if the module is ready.
1432 **                  FALSE if the module is not ready.
1433 **
1434 *******************************************************************************/
1435 BTA_API extern BOOLEAN BTA_DmIsDeviceUp(void);
1436
1437 /*******************************************************************************
1438 **
1439 ** Function         BTA_DmSetDeviceName
1440 **
1441 ** Description      This function sets the Bluetooth name of the local device.
1442 **
1443 **
1444 ** Returns          void
1445 **
1446 *******************************************************************************/
1447 BTA_API extern void BTA_DmSetDeviceName(char *p_name);
1448
1449 /*******************************************************************************
1450 **
1451 ** Function         BTA_DmSetVisibility
1452 **
1453 ** Description      This function sets the Bluetooth connectable,discoverable,
1454 **                  pairable and conn paired only modesmodes of the local device.
1455 **                  This controls whether other Bluetooth devices can find and connect to
1456 **                  the local device.
1457 **
1458 **
1459 ** Returns          void
1460 **
1461 *******************************************************************************/
1462 BTA_API extern void BTA_DmSetVisibility(tBTA_DM_DISC disc_mode, tBTA_DM_CONN conn_mode, UINT8 pairable_mode, UINT8 conn_filter);
1463
1464 /*******************************************************************************
1465 **
1466 ** Function         BTA_DmSetScanParam
1467 **
1468 ** Description      This function sets the parameters for page scan and
1469 **                  inquiry scan.
1470 **
1471 **
1472 ** Returns          void
1473 **
1474 *******************************************************************************/
1475 BTA_API extern void BTA_DmSetScanParam (UINT16 page_scan_interval, UINT16 page_scan_window,
1476                                   UINT16 inquiry_scan_interval, UINT16 inquiry_scan_window);
1477
1478 /*******************************************************************************
1479 **
1480 ** Function         BTA_DmSetAfhChannels
1481 **
1482 ** Description      This function sets the AFH first and
1483 **                  last disable channel, so channels within
1484 **                  that range are disabled.
1485 **                  In order to use this API, BTM_BYPASS_AMP_AUTO_AFH must be set
1486 **                  to be TRUE
1487 **
1488 ** Returns          void
1489 **
1490 *******************************************************************************/
1491 BTA_API extern void BTA_DmSetAfhChannels(UINT8 first, UINT8 last);
1492
1493
1494 /*******************************************************************************
1495 **
1496 ** Function         BTA_DmVendorSpecificCommand
1497 **
1498 ** Description      This function sends the vendor specific command
1499 **                  to the controller
1500 **
1501 **
1502 ** Returns          tBTA_STATUS
1503 **
1504 *******************************************************************************/
1505 BTA_API extern tBTA_STATUS BTA_DmVendorSpecificCommand (UINT16 opcode, UINT8 param_len,UINT8 *p_param_buf, tBTA_VENDOR_CMPL_CBACK *p_cback);
1506
1507
1508 /*******************************************************************************
1509 **
1510 ** Function         BTA_DmSearch
1511 **
1512 ** Description      This function searches for peer Bluetooth devices.  It
1513 **                  first performs an inquiry; for each device found from the
1514 **                  inquiry it gets the remote name of the device.  If
1515 **                  parameter services is nonzero, service discovery will be
1516 **                  performed on each device for the services specified.
1517 **
1518 **
1519 ** Returns          void
1520 **
1521 *******************************************************************************/
1522 BTA_API extern void BTA_DmSearch(tBTA_DM_INQ *p_dm_inq, tBTA_SERVICE_MASK services,
1523                                  tBTA_DM_SEARCH_CBACK *p_cback);
1524
1525 /*******************************************************************************
1526 **
1527 ** Function         BTA_DmSearchCancel
1528 **
1529 ** Description      This function cancels a search that has been initiated
1530 **                  by calling BTA_DmSearch().
1531 **
1532 **
1533 ** Returns          void
1534 **
1535 *******************************************************************************/
1536 BTA_API extern void BTA_DmSearchCancel(void);
1537
1538 /*******************************************************************************
1539 **
1540 ** Function         BTA_DmDiscover
1541 **
1542 ** Description      This function performs service discovery for the services
1543 **                  of a particular peer device.
1544 **
1545 **
1546 ** Returns          void
1547 **
1548 *******************************************************************************/
1549 BTA_API extern void BTA_DmDiscover(BD_ADDR bd_addr, tBTA_SERVICE_MASK services,
1550                                    tBTA_DM_SEARCH_CBACK *p_cback, BOOLEAN sdp_search);
1551
1552 // btla-specific ++
1553 /*******************************************************************************
1554 **
1555 ** Function         BTA_DmDiscoverUUID
1556 **
1557 ** Description      This function performs service discovery for the services
1558 **                  of a particular peer device.
1559 **
1560 **
1561 ** Returns          void
1562 **
1563 *******************************************************************************/
1564 BTA_API extern void BTA_DmDiscoverUUID(BD_ADDR bd_addr, tSDP_UUID *uuid,
1565                     tBTA_DM_SEARCH_CBACK *p_cback, BOOLEAN sdp_search);
1566
1567 /*******************************************************************************
1568 **
1569 ** Function         BTA_DmGetCachedRemoteName
1570 **
1571 ** Description      Retieve cached remote name if available
1572 **
1573 ** Returns          BTA_SUCCESS if cached name was retrieved
1574 **                  BTA_FAILURE if cached name is not available
1575 **
1576 *******************************************************************************/
1577 tBTA_STATUS BTA_DmGetCachedRemoteName(BD_ADDR remote_device, UINT8 **pp_cached_name);
1578 // btla-specific --
1579
1580 /*******************************************************************************
1581 **
1582 ** Function         BTA_DmIsMaster
1583 **
1584 ** Description      This function checks if the local device is the master of
1585 **                  the link to the given device
1586 **
1587 ** Returns          TRUE if master.
1588 **                  FALSE if not.
1589 **
1590 *******************************************************************************/
1591 BTA_API extern BOOLEAN BTA_DmIsMaster(BD_ADDR bd_addr);
1592
1593 /*******************************************************************************
1594 **
1595 ** Function         BTA_DmBond
1596 **
1597 ** Description      This function initiates a bonding procedure with a peer
1598 **                  device.  The bonding procedure enables authentication
1599 **                  and optionally encryption on the Bluetooth link.
1600 **
1601 **
1602 ** Returns          void
1603 **
1604 *******************************************************************************/
1605 BTA_API extern void BTA_DmBond(BD_ADDR bd_addr);
1606
1607 /*******************************************************************************
1608 **
1609 ** Function         BTA_DmBondByTransport
1610 **
1611 ** Description      This function initiates a bonding procedure with a peer
1612 **                  device by designated transport.  The bonding procedure enables
1613 **                  authentication and optionally encryption on the Bluetooth link.
1614 **
1615 **
1616 ** Returns          void
1617 **
1618 *******************************************************************************/
1619 BTA_API extern void BTA_DmBondByTransport(BD_ADDR bd_addr, tBTA_TRANSPORT transport);
1620
1621
1622 /*******************************************************************************
1623 **
1624 ** Function         BTA_DmBondCancel
1625 **
1626 ** Description      This function cancels a bonding procedure with a peer
1627 **                  device.
1628 **
1629 **
1630 ** Returns          void
1631 **
1632 *******************************************************************************/
1633 BTA_API extern void BTA_DmBondCancel(BD_ADDR bd_addr);
1634
1635 /*******************************************************************************
1636 **
1637 ** Function         BTA_DmPinReply
1638 **
1639 ** Description      This function provides a PIN when one is requested by DM
1640 **                  during a bonding procedure.  The application should call
1641 **                  this function after the security callback is called with
1642 **                  a BTA_DM_PIN_REQ_EVT.
1643 **
1644 **
1645 ** Returns          void
1646 **
1647 *******************************************************************************/
1648 BTA_API extern void BTA_DmPinReply(BD_ADDR bd_addr, BOOLEAN accept, UINT8 pin_len,
1649                                    UINT8 *p_pin);
1650
1651 /*******************************************************************************
1652 **
1653 ** Function         BTA_DmLinkPolicy
1654 **
1655 ** Description      This function sets/clears the link policy mask to the given
1656 **                  bd_addr.
1657 **                  If clearing the sniff or park mode mask, the link is put
1658 **                  in active mode.
1659 **
1660 ** Returns          void
1661 **
1662 *******************************************************************************/
1663 BTA_API extern void BTA_DmLinkPolicy(BD_ADDR bd_addr, tBTA_DM_LP_MASK policy_mask,
1664                                      BOOLEAN set);
1665
1666 #if (BTM_OOB_INCLUDED == TRUE)
1667 /*******************************************************************************
1668 **
1669 ** Function         BTA_DmLocalOob
1670 **
1671 ** Description      This function retrieves the OOB data from local controller.
1672 **                  The result is reported by bta_dm_co_loc_oob().
1673 **
1674 ** Returns          void
1675 **
1676 *******************************************************************************/
1677 BTA_API extern void BTA_DmLocalOob(void);
1678 #endif /* BTM_OOB_INCLUDED */
1679
1680 /*******************************************************************************
1681 **
1682 ** Function         BTA_DmConfirm
1683 **
1684 ** Description      This function accepts or rejects the numerical value of the
1685 **                  Simple Pairing process on BTA_DM_SP_CFM_REQ_EVT
1686 **
1687 ** Returns          void
1688 **
1689 *******************************************************************************/
1690 BTA_API extern void BTA_DmConfirm(BD_ADDR bd_addr, BOOLEAN accept);
1691
1692 /*******************************************************************************
1693 **
1694 ** Function         BTA_DmPasskeyCancel
1695 **
1696 ** Description      This function is called to cancel the simple pairing process
1697 **                  reported by BTA_DM_SP_KEY_NOTIF_EVT
1698 **
1699 ** Returns          void
1700 **
1701 *******************************************************************************/
1702 BTA_API extern void BTA_DmPasskeyCancel(BD_ADDR bd_addr);
1703
1704 /*******************************************************************************
1705 **
1706 ** Function         BTA_DmAddDevice
1707 **
1708 ** Description      This function adds a device to the security database list
1709 **                  of peer devices. This function would typically be called
1710 **                  at system startup to initialize the security database with
1711 **                  known peer devices.  This is a direct execution function
1712 **                  that may lock task scheduling on some platforms.
1713 **
1714 ** Returns          void
1715 **
1716 *******************************************************************************/
1717 BTA_API extern void BTA_DmAddDevice(BD_ADDR bd_addr, DEV_CLASS dev_class,
1718                                     LINK_KEY link_key, tBTA_SERVICE_MASK trusted_mask,
1719                                     BOOLEAN is_trusted, UINT8 key_type,
1720                                     tBTA_IO_CAP io_cap);
1721
1722 /*******************************************************************************
1723 **
1724 ** Function         BTA_DmAddDevWithName
1725 **
1726 ** Description      This function is newer version of  BTA_DmAddDevice()
1727 **                  which added bd_name and features as input parameters.
1728 **
1729 **
1730 ** Returns          void
1731 **
1732 ** Note:            features points to the remote device features array.
1733 **                  The array size is
1734 **                  BTA_FEATURE_BYTES_PER_PAGE * (BTA_EXT_FEATURES_PAGE_MAX + 1)
1735 **
1736 *******************************************************************************/
1737 BTA_API extern void BTA_DmAddDevWithName (BD_ADDR bd_addr, DEV_CLASS dev_class,
1738                                       BD_NAME bd_name, UINT8 *features,
1739                                       LINK_KEY link_key, tBTA_SERVICE_MASK trusted_mask,
1740                                       BOOLEAN is_trusted, UINT8 key_type, tBTA_IO_CAP io_cap);
1741
1742 /*******************************************************************************
1743 **
1744 ** Function         BTA_DmRemoveDevice
1745 **
1746 ** Description      This function removes a device from the security database.
1747 **                  This is a direct execution function that may lock task
1748 **                  scheduling on some platforms.
1749 **
1750 **
1751 ** Returns          BTA_SUCCESS if successful.
1752 **                  BTA_FAIL if operation failed.
1753 **
1754 *******************************************************************************/
1755 BTA_API extern tBTA_STATUS BTA_DmRemoveDevice(BD_ADDR bd_addr);
1756
1757 /*******************************************************************************
1758 **
1759 ** Function         BTA_DmAuthorizeReply
1760 **
1761 ** Description      This function provides an authorization reply when
1762 **                  authorization is requested by BTA.  The application calls
1763 **                  this function after the security callback is called with
1764 **                  a BTA_DM_AUTHORIZE_EVT.
1765 **
1766 **
1767 ** Returns          void
1768 **
1769 *******************************************************************************/
1770 BTA_API extern void BTA_DmAuthorizeReply(BD_ADDR bd_addr, tBTA_SERVICE_ID service,
1771                                          tBTA_AUTH_RESP response);
1772
1773 /*******************************************************************************
1774 **
1775 ** Function         BTA_DmSignalStrength
1776 **
1777 ** Description      This function initiates RSSI and channnel quality
1778 **                  measurments. BTA_DM_SIG_STRENGTH_EVT is sent to
1779 **                  application with the values of RSSI and channel
1780 **                  quality
1781 **
1782 **
1783 ** Returns          void
1784 **
1785 *******************************************************************************/
1786 BTA_API extern void BTA_DmSignalStrength(tBTA_SIG_STRENGTH_MASK mask, UINT16 period, BOOLEAN start);
1787
1788 /*******************************************************************************
1789 **
1790 ** Function         BTA_DmWriteInqTxPower
1791 **
1792 ** Description      This command is used to write the inquiry transmit power level
1793 **                  used to transmit the inquiry (ID) data packets.
1794 **
1795 ** Parameters       tx_power - tx inquiry power to use, valid value is -70 ~ 20
1796
1797 ** Returns          void
1798 **
1799 *******************************************************************************/
1800 BTA_API extern void BTA_DmWriteInqTxPower(INT8 tx_power);
1801
1802 /*******************************************************************************
1803 **
1804 ** Function         BTA_DmEirAddUUID
1805 **
1806 ** Description      This function is called to add UUID into EIR.
1807 **
1808 ** Parameters       tBT_UUID - UUID
1809 **
1810 ** Returns          None
1811 **
1812 *******************************************************************************/
1813 BTA_API extern void BTA_DmEirAddUUID (tBT_UUID *p_uuid);
1814
1815 /*******************************************************************************
1816 **
1817 ** Function         BTA_DmEirRemoveUUID
1818 **
1819 ** Description      This function is called to remove UUID from EIR.
1820 **
1821 ** Parameters       tBT_UUID - UUID
1822 **
1823 ** Returns          None
1824 **
1825 *******************************************************************************/
1826 BTA_API extern void BTA_DmEirRemoveUUID (tBT_UUID *p_uuid);
1827
1828 /*******************************************************************************
1829 **
1830 ** Function         BTA_DmSetEIRConfig
1831 **
1832 ** Description      This function is called to override the BTA default EIR parameters.
1833 **                  This funciton is only valid in a system where BTU & App task
1834 **                  are in the same memory space.
1835 **
1836 ** Parameters       Pointer to User defined EIR config
1837 **
1838 ** Returns          None
1839 **
1840 *******************************************************************************/
1841 BTA_API extern void BTA_DmSetEIRConfig (tBTA_DM_EIR_CONF *p_eir_cfg);
1842
1843 /*******************************************************************************
1844 **
1845 ** Function         BTA_CheckEirData
1846 **
1847 ** Description      This function is called to get EIR data from significant part.
1848 **
1849 ** Parameters       p_eir - pointer of EIR significant part
1850 **                  type   - finding EIR data type
1851 **                  p_length - return the length of EIR data
1852 **
1853 ** Returns          pointer of EIR data
1854 **
1855 *******************************************************************************/
1856 BTA_API extern UINT8 *BTA_CheckEirData( UINT8 *p_eir, UINT8 tag, UINT8 *p_length );
1857
1858 /*******************************************************************************
1859 **
1860 ** Function         BTA_GetEirService
1861 **
1862 ** Description      This function is called to get BTA service mask from EIR.
1863 **
1864 ** Parameters       p_eir - pointer of EIR significant part
1865 **                  p_services - return the BTA service mask
1866 **
1867 ** Returns          None
1868 **
1869 *******************************************************************************/
1870 BTA_API extern void BTA_GetEirService( UINT8 *p_eir, tBTA_SERVICE_MASK *p_services );
1871
1872 /*******************************************************************************
1873 **
1874 ** Function         BTA_DmUseSsr
1875 **
1876 ** Description      This function is called to check if the connected peer device
1877 **                  supports SSR or not.
1878 **
1879 ** Returns          TRUE, if SSR is supported
1880 **
1881 *******************************************************************************/
1882 BTA_API extern BOOLEAN BTA_DmUseSsr( BD_ADDR bd_addr );
1883
1884 /*******************************************************************************
1885 **
1886 ** Function         BTA_DmGetConnectionState
1887 **
1888 ** Description      Returns whether the remote device is currently connected.
1889 **
1890 ** Returns          0 if the device is NOT connected.
1891 **
1892 *******************************************************************************/
1893 BTA_API extern UINT16 BTA_DmGetConnectionState( BD_ADDR bd_addr );
1894
1895
1896 /*******************************************************************************
1897 **
1898 ** Function         BTA_DmSetLocalDiRecord
1899 **
1900 ** Description      This function adds a DI record to the local SDP database.
1901 **
1902 ** Returns          BTA_SUCCESS if record set sucessfully, otherwise error code.
1903 **
1904 *******************************************************************************/
1905 BTA_API extern tBTA_STATUS BTA_DmSetLocalDiRecord( tBTA_DI_RECORD *p_device_info,
1906                                   UINT32 *p_handle );
1907
1908 /*******************************************************************************
1909 **
1910 ** Function         BTA_DmGetLocalDiRecord
1911 **
1912 ** Description      Get a specified DI record to the local SDP database. If no
1913 **                  record handle is provided, the primary DI record will be
1914 **                  returned.
1915 **
1916 ** Returns          BTA_SUCCESS if record set sucessfully, otherwise error code.
1917 **
1918 *******************************************************************************/
1919 BTA_API extern tBTA_STATUS BTA_DmGetLocalDiRecord( tBTA_DI_GET_RECORD *p_device_info,
1920                                   UINT32 *p_handle );
1921
1922 /*******************************************************************************
1923 **
1924 ** Function         BTA_DmDiDiscover
1925 **
1926 ** Description      This function queries a remote device for DI information.
1927 **
1928 ** Returns          None.
1929 **
1930 *******************************************************************************/
1931 BTA_API extern void BTA_DmDiDiscover( BD_ADDR remote_device, tBTA_DISCOVERY_DB *p_db,
1932                        UINT32 len, tBTA_DM_SEARCH_CBACK *p_cback );
1933
1934 /*******************************************************************************
1935 **
1936 ** Function         BTA_DmGetDiRecord
1937 **
1938 ** Description      This function retrieves a remote device's DI record from
1939 **                  the specified database.
1940 **
1941 ** Returns          None.
1942 **
1943 *******************************************************************************/
1944 BTA_API extern tBTA_STATUS BTA_DmGetDiRecord( UINT8 get_record_index, tBTA_DI_GET_RECORD *p_device_info,
1945                         tBTA_DISCOVERY_DB *p_db );
1946
1947 /*******************************************************************************
1948 **
1949 **
1950 ** Function         BTA_DmCloseACL
1951 **
1952 ** Description      This function force to close an ACL connection and remove the
1953 **                  device from the security database list of known devices.
1954 **
1955 ** Parameters:      bd_addr       - Address of the peer device
1956 **                  remove_dev    - remove device or not after link down
1957 **                  transport     - which transport to close
1958
1959 **
1960 ** Returns          void.
1961 **
1962 *******************************************************************************/
1963 BTA_API extern void BTA_DmCloseACL(BD_ADDR bd_addr, BOOLEAN remove_dev, tBTA_TRANSPORT transport);
1964
1965 /*******************************************************************************
1966 **
1967 ** Function         BTA_SysFeatures
1968 **
1969 ** Description      This function is called to set system features.
1970 **
1971 ** Returns          void
1972 **
1973 *******************************************************************************/
1974 BTA_API extern void BTA_SysFeatures (UINT16 sys_features);
1975
1976 /*******************************************************************************
1977 **
1978 ** Function         bta_dmexecutecallback
1979 **
1980 ** Description      This function will request BTA to execute a call back in the context of BTU task
1981 **                  This API was named in lower case because it is only intended
1982 **                  for the internal customers(like BTIF).
1983 **
1984 ** Returns          void
1985 **
1986 *******************************************************************************/
1987 BTA_API extern void bta_dmexecutecallback (tBTA_DM_EXEC_CBACK* p_callback, void * p_param);
1988
1989 #if (BTM_SCO_HCI_INCLUDED == TRUE)
1990 /*******************************************************************************
1991 **
1992 ** Function         BTA_DmPcmInitSamples
1993 **
1994 ** Description      initialize the down sample converter.
1995 **
1996 **                  src_sps: original samples per second (source audio data)
1997 **                            (ex. 44100, 48000)
1998 **                  bits: number of bits per pcm sample (16)
1999 **                  n_channels: number of channels (i.e. mono(1), stereo(2)...)
2000 **
2001 ** Returns          none
2002 **
2003 *******************************************************************************/
2004 BTA_API extern void BTA_DmPcmInitSamples (UINT32 src_sps, UINT32 bits, UINT32 n_channels);
2005
2006 /**************************************************************************************
2007 ** Function         BTA_DmPcmResample
2008 **
2009 ** Description      Down sampling utility to convert higher sampling rate into 8K/16bits
2010 **                  PCM samples.
2011 **
2012 ** Parameters       p_src: pointer to the buffer where the original sampling PCM
2013 **                              are stored.
2014 **                  in_bytes:  Length of the input PCM sample buffer in byte.
2015 **                  p_dst:      pointer to the buffer which is to be used to store
2016 **                              the converted PCM samples.
2017 **
2018 **
2019 ** Returns          INT32: number of samples converted.
2020 **
2021 **************************************************************************************/
2022 BTA_API extern INT32 BTA_DmPcmResample (void *p_src, UINT32 in_bytes, void *p_dst);
2023 #endif
2024
2025 #if ((defined BLE_INCLUDED) && (BLE_INCLUDED == TRUE))
2026 /* BLE related API functions */
2027 /*******************************************************************************
2028 **
2029 ** Function         BTA_DmBleSecurityGrant
2030 **
2031 ** Description      Grant security request access.
2032 **
2033 ** Parameters:      bd_addr          - BD address of the peer
2034 **                  res              - security grant status.
2035 **
2036 ** Returns          void
2037 **
2038 *******************************************************************************/
2039 BTA_API extern void BTA_DmBleSecurityGrant(BD_ADDR bd_addr, tBTA_DM_BLE_SEC_GRANT res);
2040
2041
2042
2043 /*******************************************************************************
2044 **
2045 ** Function         BTA_DmBleSetBgConnType
2046 **
2047 ** Description      This function is called to set BLE connectable mode for a
2048 **                  peripheral device.
2049 **
2050 ** Parameters       bg_conn_type: it can be auto connection, or selective connection.
2051 **                  p_select_cback: callback function when selective connection procedure
2052 **                              is being used.
2053 **
2054 ** Returns          void
2055 **
2056 *******************************************************************************/
2057 BTA_API extern void BTA_DmBleSetBgConnType(tBTA_DM_BLE_CONN_TYPE bg_conn_type, tBTA_DM_BLE_SEL_CBACK *p_select_cback);
2058
2059 /*******************************************************************************
2060 **
2061 ** Function         BTA_DmBlePasskeyReply
2062 **
2063 ** Description      Send BLE SMP passkey reply.
2064 **
2065 ** Parameters:      bd_addr          - BD address of the peer
2066 **                  accept           - passkey entry sucessful or declined.
2067 **                  passkey          - passkey value, must be a 6 digit number,
2068 **                                     can be lead by 0.
2069 **
2070 ** Returns          void
2071 **
2072 *******************************************************************************/
2073 BTA_API extern void BTA_DmBlePasskeyReply(BD_ADDR bd_addr, BOOLEAN accept, UINT32 passkey);
2074
2075 /*******************************************************************************
2076 **
2077 ** Function         BTA_DmAddBleDevice
2078 **
2079 ** Description      Add a BLE device.  This function will be normally called
2080 **                  during host startup to restore all required information
2081 **                  for a LE device stored in the NVRAM.
2082 **
2083 ** Parameters:      bd_addr          - BD address of the peer
2084 **                  dev_type         - Remote device's device type.
2085 **                  addr_type        - LE device address type.
2086 **
2087 ** Returns          void
2088 **
2089 *******************************************************************************/
2090 BTA_API extern void BTA_DmAddBleDevice(BD_ADDR bd_addr, tBLE_ADDR_TYPE addr_type,
2091                                        tBT_DEVICE_TYPE dev_type);
2092
2093
2094 /*******************************************************************************
2095 **
2096 ** Function         BTA_DmAddBleKey
2097 **
2098 ** Description      Add/modify LE device information.  This function will be
2099 **                  normally called during host startup to restore all required
2100 **                  information stored in the NVRAM.
2101 **
2102 ** Parameters:      bd_addr          - BD address of the peer
2103 **                  p_le_key         - LE key values.
2104 **                  key_type         - LE SMP key type.
2105 **
2106 ** Returns          void
2107 **
2108 *******************************************************************************/
2109 BTA_API extern void BTA_DmAddBleKey (BD_ADDR bd_addr,
2110                                      tBTA_LE_KEY_VALUE *p_le_key,
2111                                      tBTA_LE_KEY_TYPE key_type);
2112
2113 /*******************************************************************************
2114 **
2115 ** Function         BTA_DmSetBlePrefConnParams
2116 **
2117 ** Description      This function is called to set the preferred connection
2118 **                  parameters when default connection parameter is not desired.
2119 **
2120 ** Parameters:      bd_addr          - BD address of the peripheral
2121 **                  min_conn_int     - minimum preferred connection interval
2122 **                  max_conn_int     - maximum preferred connection interval
2123 **                  slave_latency    - preferred slave latency
2124 **                  supervision_tout - preferred supervision timeout
2125 **
2126 **
2127 ** Returns          void
2128 **
2129 *******************************************************************************/
2130 BTA_API extern void BTA_DmSetBlePrefConnParams(BD_ADDR bd_addr,
2131                                UINT16 min_conn_int, UINT16 max_conn_int,
2132                                UINT16 slave_latency, UINT16 supervision_tout );
2133
2134 /*******************************************************************************
2135 **
2136 ** Function         BTA_DmSetBleConnScanParams
2137 **
2138 ** Description      This function is called to set scan parameters used in
2139 **                  BLE connection request
2140 **
2141 ** Parameters:      bd_addr          - BD address of the peripheral
2142 **                  scan_interval    - scan interval
2143 **                  scan_window      - scan window
2144 **
2145 ** Returns          void
2146 **
2147 *******************************************************************************/
2148 BTA_API extern void BTA_DmSetBleConnScanParams(UINT16 scan_interval,
2149                                                UINT16 scan_window );
2150
2151 /*******************************************************************************
2152 **
2153 ** Function         BTA_DmSetBleAdvParams
2154 **
2155 ** Description      This function sets the advertising parameters BLE functionality.
2156 **                  It is to be called when device act in peripheral or broadcaster
2157 **                  role.
2158 **
2159 ** Parameters:      adv_int_min    - adv interval minimum
2160 **                  adv_int_max    - adv interval max
2161 **                  p_dir_bda      - directed adv initator address
2162 **
2163 ** Returns          void
2164 **
2165 *******************************************************************************/
2166 BTA_API extern void BTA_DmSetBleAdvParams (UINT16 adv_int_min, UINT16 adv_int_max,
2167                                            tBLE_BD_ADDR *p_dir_bda);
2168 /*******************************************************************************
2169 **
2170 ** Function         BTA_DmSearchExt
2171 **
2172 ** Description      This function searches for peer Bluetooth devices. It performs
2173 **                  an inquiry and gets the remote name for devices. Service
2174 **                  discovery is done if services is non zero
2175 **
2176 ** Parameters       p_dm_inq: inquiry conditions
2177 **                  services: if service is not empty, service discovery will be done.
2178 **                            for all GATT based service condition, put num_uuid, and
2179 **                            p_uuid is the pointer to the list of UUID values.
2180 **                  p_cback: callback functino when search is completed.
2181 **
2182 **
2183 **
2184 ** Returns          void
2185 **
2186 *******************************************************************************/
2187 BTA_API extern void BTA_DmSearchExt(tBTA_DM_INQ *p_dm_inq, tBTA_SERVICE_MASK_EXT *p_services,
2188                                     tBTA_DM_SEARCH_CBACK *p_cback);
2189
2190 /*******************************************************************************
2191 **
2192 ** Function         BTA_DmDiscoverExt
2193 **
2194 ** Description      This function does service discovery for services of a
2195 **                  peer device. When services.num_uuid is 0, it indicates all
2196 **                  GATT based services are to be searched; other wise a list of
2197 **                  UUID of interested services should be provided through
2198 **                  services.p_uuid.
2199 **
2200 **
2201 **
2202 ** Returns          void
2203 **
2204 *******************************************************************************/
2205 BTA_API extern void BTA_DmDiscoverExt(BD_ADDR bd_addr, tBTA_SERVICE_MASK_EXT *p_services,
2206                                     tBTA_DM_SEARCH_CBACK *p_cback, BOOLEAN sdp_search);
2207
2208 /*******************************************************************************
2209 **
2210 ** Function         BTA_DmDiscoverByTransport
2211 **
2212 ** Description      This function does service discovery on particular transport
2213 **                  for services of a
2214 **                  peer device. When services.num_uuid is 0, it indicates all
2215 **                  GATT based services are to be searched; other wise a list of
2216 **                  UUID of interested services should be provided through
2217 **                  p_services->p_uuid.
2218 **
2219 **
2220 **
2221 ** Returns          void
2222 **
2223 *******************************************************************************/
2224 BTA_API extern void BTA_DmDiscoverByTransport(BD_ADDR bd_addr, tBTA_SERVICE_MASK_EXT *p_services,
2225                                               tBTA_DM_SEARCH_CBACK *p_cback, BOOLEAN sdp_search,
2226                                               tBTA_TRANSPORT transport);
2227
2228 /*******************************************************************************
2229 **
2230 ** Function         BTA_DmSetEncryption
2231 **
2232 ** Description      This function is called to ensure that connection is
2233 **                  encrypted.  Should be called only on an open connection.
2234 **                  Typically only needed for connections that first want to
2235 **                  bring up unencrypted links, then later encrypt them.
2236 **
2237 ** Parameters:      bd_addr       - Address of the peer device
2238 **                  transport     - transport of the link to be encruypted
2239 **                  p_callback    - Pointer to callback function to indicat the
2240 **                                  link encryption status
2241 **                  sec_act       - This is the security action to indicate
2242 **                                  what knid of BLE security level is required for
2243 **                                  the BLE link if the BLE is supported
2244 **                                  Note: This parameter is ignored for the BR/EDR link
2245 **                                        or the BLE is not supported
2246 **
2247 ** Returns          void
2248 **
2249 **
2250 *******************************************************************************/
2251 BTA_API extern void BTA_DmSetEncryption(BD_ADDR bd_addr, tBTA_TRANSPORT transport,
2252                                         tBTA_DM_ENCRYPT_CBACK *p_callback,
2253                                          tBTA_DM_BLE_SEC_ACT sec_act);
2254
2255
2256 /*******************************************************************************
2257 **
2258 ** Function         BTA_DmBleObserve
2259 **
2260 ** Description      This procedure keep the device listening for advertising
2261 **                  events from a broadcast device.
2262 **
2263 ** Parameters       start: start or stop observe.
2264 **                  duration : Duration of the scan. Continuous scan if 0 is passed
2265 **                  p_results_cb: Callback to be called with scan results
2266 **
2267 ** Returns          void
2268 **
2269 *******************************************************************************/
2270 BTA_API extern void BTA_DmBleObserve(BOOLEAN start, UINT8 duration,
2271                                            tBTA_DM_SEARCH_CBACK *p_results_cb);
2272
2273
2274 #endif
2275
2276 // btla-specific ++
2277 /*******************************************************************************
2278 **
2279 ** Function         BTA_DmSetAfhChannelAssessment
2280 **
2281 ** Description      This function is called to set the channel assessment mode on or off
2282 **
2283 ** Returns          status
2284 **
2285 *******************************************************************************/
2286 BTA_API extern void BTA_DmSetAfhChannelAssessment (BOOLEAN enable_or_disable);
2287
2288 #if BLE_INCLUDED == TRUE
2289 // btla-specific --
2290 /*******************************************************************************
2291 **
2292 ** Function         BTA_DmBleConfigLocalPrivacy
2293 **
2294 ** Description      Enable/disable privacy on the local device
2295 **
2296 ** Parameters:      privacy_enable   - enable/disabe privacy on remote device.
2297 **
2298 ** Returns          void
2299 **
2300 *******************************************************************************/
2301 BTA_API extern void BTA_DmBleConfigLocalPrivacy(BOOLEAN privacy_enable);
2302
2303 /*******************************************************************************
2304 **
2305 ** Function         BTA_DmBleEnableRemotePrivacy
2306 **
2307 ** Description      Enable/disable privacy on a remote device
2308 **
2309 ** Parameters:      bd_addr          - BD address of the peer
2310 **                  privacy_enable   - enable/disabe privacy on remote device.
2311 **
2312 ** Returns          void
2313 **
2314 *******************************************************************************/
2315 BTA_API extern void BTA_DmBleEnableRemotePrivacy(BD_ADDR bd_addr, BOOLEAN privacy_enable);
2316
2317
2318 /*******************************************************************************
2319 **
2320 ** Function         BTA_DmBleSetAdvConfig
2321 **
2322 ** Description      This function is called to override the BTA default ADV parameters.
2323 **
2324 ** Parameters       Pointer to User defined ADV data structure
2325 **
2326 ** Returns          None
2327 **
2328 *******************************************************************************/
2329 BTA_API extern void BTA_DmBleSetAdvConfig (tBTA_BLE_AD_MASK data_mask,
2330                                            tBTA_BLE_ADV_DATA *p_adv_cfg,
2331                                            tBTA_SET_ADV_DATA_CMPL_CBACK *p_adv_data_cback);
2332
2333 /*******************************************************************************
2334 **
2335 ** Function         BTA_DmBleSetScanRsp
2336 **
2337 ** Description      This function is called to override the BTA scan response.
2338 **
2339 ** Parameters       Pointer to User defined ADV data structure
2340 **
2341 ** Returns          None
2342 **
2343 *******************************************************************************/
2344 BTA_API extern void BTA_DmBleSetScanRsp (tBTA_BLE_AD_MASK data_mask,
2345                                          tBTA_BLE_ADV_DATA *p_adv_cfg,
2346                                          tBTA_SET_ADV_DATA_CMPL_CBACK *p_adv_data_cback);
2347
2348 /*******************************************************************************
2349 **
2350 ** Function         BTA_DmBleBroadcast
2351 **
2352 ** Description      This function starts or stops LE broadcasting.
2353 **
2354 ** Parameters       start: start or stop broadcast.
2355 **
2356 ** Returns          None
2357 **
2358 *******************************************************************************/
2359 BTA_API extern void BTA_DmBleBroadcast (BOOLEAN start);
2360
2361
2362 /*******************************************************************************
2363 **
2364 ** Function         BTA_BleEnableAdvInstance
2365 **
2366 ** Description      This function enables the Multi ADV instance feature
2367 **
2368 ** Parameters       p_params Pointer to ADV param user defined structure
2369 **                  p_cback  Pointer to Multi ADV callback structure
2370 **                  p_ref - Reference pointer
2371 **
2372 ** Returns          None
2373 **
2374 *******************************************************************************/
2375 BTA_API extern void BTA_BleEnableAdvInstance (tBTA_BLE_ADV_PARAMS *p_params,
2376                                 tBTA_BLE_MULTI_ADV_CBACK *p_cback,void *p_ref);
2377
2378 /*******************************************************************************
2379 **
2380 ** Function         BTA_BleUpdateAdvInstParam
2381 **
2382 ** Description      This function updates the Multi ADV instance params
2383 **
2384 ** Parameters       inst_id Instance ID
2385 **                  p_params Pointer to ADV param user defined structure
2386 **
2387 ** Returns          None
2388 **
2389 *******************************************************************************/
2390 BTA_API extern void BTA_BleUpdateAdvInstParam (UINT8 inst_id,
2391                                 tBTA_BLE_ADV_PARAMS *p_params);
2392
2393 /*******************************************************************************
2394 **
2395 ** Function         BTA_BleCfgAdvInstData
2396 **
2397 ** Description      This function is called to configure the ADV instance data
2398 **
2399 ** Parameters       inst_id - Instance ID
2400 **                  is_scan_rsp - Boolean value Scan response
2401 **                  Pointer to User defined ADV data structure
2402 ** Returns          None
2403 **
2404 *******************************************************************************/
2405 BTA_API extern void BTA_BleCfgAdvInstData (UINT8 inst_id, BOOLEAN is_scan_rsp,
2406                                 tBTA_BLE_AD_MASK data_mask, tBTA_BLE_ADV_DATA *p_data);
2407
2408 /*******************************************************************************
2409 **
2410 ** Function         BTA_BleDisableAdvInstance
2411 **
2412 ** Description      This function is called to disable the ADV instance
2413 **
2414 ** Parameters       inst_id - Instance ID to be disabled
2415 **
2416 ** Returns          None
2417 **
2418 *******************************************************************************/
2419 BTA_API extern void BTA_BleDisableAdvInstance(UINT8 inst_id);
2420
2421 /*******************************************************************************
2422 **
2423 ** Function         BTA_DmBleUpdateConnectionParams
2424 **
2425 ** Description      Update connection parameters, can only be used when connection is up.
2426 **
2427 ** Parameters:      bd_addr   - BD address of the peer
2428 **                  min_int   -     minimum connection interval, [0x0004~ 0x4000]
2429 **                  max_int   -     maximum connection interval, [0x0004~ 0x4000]
2430 **                  latency   -     slave latency [0 ~ 500]
2431 **                  timeout   -     supervision timeout [0x000a ~ 0xc80]
2432 **
2433 ** Returns          void
2434 **
2435 *******************************************************************************/
2436 BTA_API extern void BTA_DmBleUpdateConnectionParams(BD_ADDR bd_addr, UINT16 min_int,
2437                                    UINT16 max_int, UINT16 latency, UINT16 timeout);
2438
2439 /*******************************************************************************
2440 **
2441 ** Function         BTA_DmBleSetStorageParams
2442 **
2443 ** Description      This function is called to set the storage parameters
2444 **
2445 ** Parameters       batch_scan_full_max -Max storage space (in %) allocated to full scanning
2446 **                  batch_scan_trunc_max -Max storage space (in %) allocated to truncated scanning
2447 **                  batch_scan_notify_threshold - Setup notification level based on total space
2448 **                  consumed by both pools. Setting it to 0 will disable threshold notification
2449 **                  p_setup_cback - Setup callback
2450 **                  p_thres_cback - Threshold callback
2451 **                  p_rep_cback - Reports callback
2452 **                  ref_value - Reference value
2453 **
2454 ** Returns           None
2455 **
2456 *******************************************************************************/
2457 BTA_API extern void BTA_DmBleSetStorageParams(UINT8 batch_scan_full_max,
2458                                          UINT8 batch_scan_trunc_max,
2459                                          UINT8 batch_scan_notify_threshold,
2460                                          tBTA_BLE_SCAN_SETUP_CBACK *p_setup_cback,
2461                                          tBTA_BLE_SCAN_THRESHOLD_CBACK *p_thres_cback,
2462                                          tBTA_BLE_SCAN_REP_CBACK* p_rep_cback,
2463                                          tBTA_DM_BLE_REF_VALUE ref_value);
2464
2465 /*******************************************************************************
2466 **
2467 ** Function         BTA_DmBleEnableBatchScan
2468 **
2469 ** Description      This function is called to enable the batch scan
2470 **
2471 ** Parameters       scan_mode -Batch scan mode
2472 **                  scan_interval - Scan interval
2473 **                  scan_window - Scan window
2474 **                  discard_rule -Discard rules
2475 **                  addr_type - Address type
2476 **                  ref_value - Reference value
2477 **
2478 ** Returns           None
2479 **
2480 *******************************************************************************/
2481 BTA_API extern void BTA_DmBleEnableBatchScan(tBTA_BLE_SCAN_MODE scan_mode,
2482                                          UINT32 scan_interval, UINT32 scan_window,
2483                                          tBTA_BLE_DISCARD_RULE discard_rule,
2484                                          tBLE_ADDR_TYPE        addr_type,
2485                                          tBTA_DM_BLE_REF_VALUE ref_value);
2486
2487 /*******************************************************************************
2488 **
2489 ** Function         BTA_DmBleReadScanReports
2490 **
2491 ** Description      This function is called to read the batch scan reports
2492 **
2493 ** Parameters       scan_mode -Batch scan mode
2494 **                  ref_value - Reference value
2495 **
2496 ** Returns          None
2497 **
2498 *******************************************************************************/
2499 BTA_API extern void BTA_DmBleReadScanReports(tBTA_BLE_SCAN_MODE scan_type,
2500                                              tBTA_DM_BLE_REF_VALUE ref_value);
2501
2502 /*******************************************************************************
2503 **
2504 ** Function         BTA_DmBleDisableBatchScan
2505 **
2506 ** Description      This function is called to disable the batch scanning
2507 **
2508 ** Parameters       ref_value - Reference value
2509 **
2510 ** Returns          None
2511 **
2512 *******************************************************************************/
2513 BTA_API extern void BTA_DmBleDisableBatchScan(tBTA_DM_BLE_REF_VALUE ref_value);
2514
2515 /*******************************************************************************
2516 **
2517 ** Function         BTA_DmEnableScanFilter
2518 **
2519 ** Description      This function is called to enable the adv data payload filter
2520 **
2521 ** Parameters       action - enable or disable the APCF feature
2522 **                  p_cmpl_cback - Command completed callback
2523 **                  ref_value - Reference value
2524 **
2525 ** Returns          void
2526 **
2527 *******************************************************************************/
2528 BTA_API extern void BTA_DmEnableScanFilter(UINT8 action,
2529                                         tBTA_DM_BLE_PF_STATUS_CBACK *p_cmpl_cback,
2530                                         tBTA_DM_BLE_REF_VALUE ref_value);
2531
2532 /*******************************************************************************
2533 **
2534 ** Function         BTA_DmBleScanFilterSetup
2535 **
2536 ** Description      This function is called to setup the filter params
2537 **
2538 ** Parameters       p_target: enable the filter condition on a target device; if NULL
2539 **                  filt_index - Filter index
2540 **                  p_filt_params -Filter parameters
2541 **                  ref_value - Reference value
2542 **                  action - Add, delete or clear
2543 **                  p_cmpl_back - Command completed callback
2544 **
2545 ** Returns          void
2546 **
2547 *******************************************************************************/
2548 BTA_API extern void BTA_DmBleScanFilterSetup(UINT8 action,
2549                                                    tBTA_DM_BLE_PF_FILT_INDEX filt_index,
2550                                                    tBTA_DM_BLE_PF_FILT_PARAMS *p_filt_params,
2551                                                    tBLE_BD_ADDR *p_target,
2552                                                    tBTA_DM_BLE_PF_PARAM_CBACK *p_cmpl_cback,
2553                                                    tBTA_DM_BLE_REF_VALUE ref_value);
2554
2555 /*******************************************************************************
2556 **
2557 ** Function         BTA_DmBleCfgFilterCondition
2558 **
2559 ** Description      This function is called to configure the adv data payload filter
2560 **                  condition.
2561 **
2562 ** Parameters       action: to read/write/clear
2563 **                  cond_type: filter condition type
2564 **                  filt_index - Filter index
2565 **                  p_cond: filter condition parameter
2566 **                  p_cmpl_back - Command completed callback
2567 **                  ref_value - Reference value
2568 **
2569 ** Returns          void
2570 **
2571 *******************************************************************************/
2572 BTA_API extern void BTA_DmBleCfgFilterCondition(tBTA_DM_BLE_SCAN_COND_OP action,
2573                                                  tBTA_DM_BLE_PF_COND_TYPE cond_type,
2574                                                  tBTA_DM_BLE_PF_FILT_INDEX filt_index,
2575                                                  tBTA_DM_BLE_PF_COND_PARAM *p_cond,
2576                                                  tBTA_DM_BLE_PF_CFG_CBACK *p_cmpl_cback,
2577                                                  tBTA_DM_BLE_REF_VALUE ref_value);
2578
2579
2580 /*******************************************************************************
2581 **
2582 ** Function         BTA_DmBleTrackAdvertiser
2583 **
2584 ** Description      This function is called to track the advertiser
2585 **
2586 ** Parameters    ref_value - Reference value
2587 **               p_track_adv_cback - ADV callback
2588 **
2589 ** Returns          None
2590 **
2591 *******************************************************************************/
2592 BTA_API extern void BTA_DmBleTrackAdvertiser(tBTA_DM_BLE_REF_VALUE ref_value,
2593                             tBTA_BLE_TRACK_ADV_CBACK *p_track_adv_cback);
2594
2595 /*******************************************************************************
2596 **
2597 ** Function         BTA_DmBleGetEnergyInfo
2598 **
2599 ** Description      This function is called to obtain the energy info
2600 **
2601 ** Parameters       p_cmpl_cback - Command complete callback
2602 **
2603 ** Returns          void
2604 **
2605 *******************************************************************************/
2606 BTA_API extern void BTA_DmBleGetEnergyInfo(tBTA_BLE_ENERGY_INFO_CBACK *p_cmpl_cback);
2607
2608 /*******************************************************************************
2609 **
2610 ** Function         BTA_BrcmInit
2611 **
2612 ** Description      This function initializes Broadcom specific VS handler in BTA
2613 **
2614 ** Returns          void
2615 **
2616 *******************************************************************************/
2617 BTA_API extern void BTA_VendorInit  (void);
2618
2619 /*******************************************************************************
2620 **
2621 ** Function         BTA_BrcmCleanup
2622 **
2623 ** Description      This function frees up Broadcom specific VS specific dynamic memory
2624 **
2625 ** Returns          void
2626 **
2627 *******************************************************************************/
2628 BTA_API extern void BTA_VendorCleanup (void);
2629
2630 #endif
2631
2632 #ifdef __cplusplus
2633 }
2634 #endif
2635
2636 #endif /* BTA_API_H */
2637