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     UINT8           fail_reason;        /* The HCI reason/error code for when success=FALSE */
 765
 766 } tBTA_DM_AUTH_CMPL;
 767
 768
 769 /* Structure associated with BTA_DM_AUTHORIZE_EVT */
 770 typedef struct
 771 {
 772     BD_ADDR         bd_addr;            /* BD address peer device. */
 773     BD_NAME         bd_name;            /* Name of peer device. */
 774     tBTA_SERVICE_ID service;            /* Service ID to authorize. */
 775 // btla-specific ++
 776     DEV_CLASS      dev_class;
 777 // btla-specific --
 778 } tBTA_DM_AUTHORIZE;
 779
 780 /* Structure associated with BTA_DM_LINK_UP_EVT */
 781 typedef struct
 782 {
 783     BD_ADDR         bd_addr;            /* BD address peer device. */
 784 #if BLE_INCLUDED == TRUE
 785     tBTA_TRANSPORT  link_type;
 786 #endif
 787 } tBTA_DM_LINK_UP;
 788
 789 /* Structure associated with BTA_DM_LINK_DOWN_EVT */
 790 typedef struct
 791 {
 792     BD_ADDR         bd_addr;            /* BD address peer device. */
 793     UINT8           status;             /* connection open/closed */
 794     BOOLEAN         is_removed;         /* TRUE if device is removed when link is down */
 795 #if BLE_INCLUDED == TRUE
 796     tBTA_TRANSPORT  link_type;
 797 #endif
 798 } tBTA_DM_LINK_DOWN;
 799
 800 /* Structure associated with BTA_DM_ROLE_CHG_EVT */
 801 typedef struct
 802 {
 803     BD_ADDR         bd_addr;            /* BD address peer device. */
 804     UINT8           new_role;           /* the new connection role */
 805 } tBTA_DM_ROLE_CHG;
 806
 807 /* Structure associated with BTA_DM_SIG_STRENGTH_EVT */
 808 typedef struct
 809 {
 810     BD_ADDR         bd_addr;            /* BD address peer device. */
 811     tBTA_SIG_STRENGTH_MASK mask;        /* mask for the values that are valid */
 812     tBTA_DM_RSSI_VALUE  rssi_value;
 813     tBTA_DM_LINK_QUALITY_VALUE link_quality_value;
 814
 815 } tBTA_DM_SIG_STRENGTH;
 816
 817 /* Structure associated with BTA_DM_BUSY_LEVEL_EVT */
 818 typedef struct
 819 {
 820     UINT8           level;     /* when paging or inquiring, level is 10.
 821                                     Otherwise, the number of ACL links */
 822     UINT8           level_flags; /* indicates individual flags */
 823 } tBTA_DM_BUSY_LEVEL;
 824
 825 #define BTA_IO_CAP_OUT      BTM_IO_CAP_OUT      /* DisplayOnly */
 826 #define BTA_IO_CAP_IO       BTM_IO_CAP_IO       /* DisplayYesNo */
 827 #define BTA_IO_CAP_IN       BTM_IO_CAP_IN       /* KeyboardOnly */
 828 #define BTA_IO_CAP_NONE     BTM_IO_CAP_NONE     /* NoInputNoOutput */
 829 typedef tBTM_IO_CAP     tBTA_IO_CAP;
 830
 831 #define BTA_AUTH_SP_NO    BTM_AUTH_SP_NO      /* 0 MITM Protection Not Required - Single Profile/non-bonding
 832                                                 Numeric comparison with automatic accept allowed */
 833 #define BTA_AUTH_SP_YES   BTM_AUTH_SP_YES     /* 1 MITM Protection Required - Single Profile/non-bonding
 834                                                 Use IO Capabilities to determine authentication procedure */
 835 #define BTA_AUTH_AP_NO    BTM_AUTH_AP_NO      /* 2 MITM Protection Not Required - All Profiles/dedicated bonding
 836                                                 Numeric comparison with automatic accept allowed */
 837 #define BTA_AUTH_AP_YES   BTM_AUTH_AP_YES     /* 3 MITM Protection Required - All Profiles/dedicated bonding
 838                                                 Use IO Capabilities to determine authentication procedure */
 839 #define BTA_AUTH_SPGB_NO  BTM_AUTH_SPGB_NO    /* 4 MITM Protection Not Required - Single Profiles/general bonding
 840                                                 Numeric comparison with automatic accept allowed */
 841 #define BTA_AUTH_SPGB_YES BTM_AUTH_SPGB_YES   /* 5 MITM Protection Required - Single Profiles/general bonding
 842                                                 Use IO Capabilities to determine authentication procedure */
 843 typedef tBTM_AUTH_REQ   tBTA_AUTH_REQ;
 844
 845 #define BTA_AUTH_DD_BOND    BTM_AUTH_DD_BOND  /* 2 this bit is set for dedicated bonding */
 846 #define BTA_AUTH_GEN_BOND   BTM_AUTH_SPGB_NO  /* 4 this bit is set for general bonding */
 847 #define BTA_AUTH_BONDS      BTM_AUTH_BONDS    /* 6 the general/dedicated bonding bits  */
 848
 849 #define BTA_LE_AUTH_NO_BOND    BTM_LE_AUTH_REQ_NO_BOND  /* 0*/
 850 #define BTA_LE_AUTH_BOND       BTM_LE_AUTH_REQ_BOND     /* 1 << 0 */
 851 #define BTA_LE_AUTH_REQ_MITM   BTM_LE_AUTH_REQ_MITM    /* 1 << 2 */
 852 typedef tBTM_LE_AUTH_REQ       tBTA_LE_AUTH_REQ;       /* combination of the above bit pattern */
 853
 854 #define BTA_OOB_NONE        BTM_OOB_NONE
 855 #define BTA_OOB_PRESENT     BTM_OOB_PRESENT
 856 #if BTM_OOB_INCLUDED == TRUE
 857 #define BTA_OOB_UNKNOWN     BTM_OOB_UNKNOWN
 858 #endif
 859 typedef tBTM_OOB_DATA   tBTA_OOB_DATA;
 860
 861 /* Structure associated with BTA_DM_SP_CFM_REQ_EVT */
 862 typedef struct
 863 {
 864     /* Note: First 3 data members must be, bd_addr, dev_class, and bd_name in order */
 865     BD_ADDR         bd_addr;        /* peer address */
 866     DEV_CLASS       dev_class;      /* peer CoD */
 867     BD_NAME         bd_name;        /* peer device name */
 868     UINT32          num_val;        /* the numeric value for comparison. If just_works, do not show this number to UI */
 869     BOOLEAN         just_works;     /* TRUE, if "Just Works" association model */
 870     tBTA_AUTH_REQ   loc_auth_req;   /* Authentication required for local device */
 871     tBTA_AUTH_REQ   rmt_auth_req;   /* Authentication required for peer device */
 872     tBTA_IO_CAP     loc_io_caps;    /* IO Capabilities of local device */
 873     tBTA_AUTH_REQ   rmt_io_caps;    /* IO Capabilities of remote device */
 874 } tBTA_DM_SP_CFM_REQ;
 875
 876 enum
 877 {
 878     BTA_SP_KEY_STARTED,         /* passkey entry started */
 879     BTA_SP_KEY_ENTERED,         /* passkey digit entered */
 880     BTA_SP_KEY_ERASED,          /* passkey digit erased */
 881     BTA_SP_KEY_CLEARED,         /* passkey cleared */
 882     BTA_SP_KEY_COMPLT           /* passkey entry completed */
 883 };
 884 typedef UINT8   tBTA_SP_KEY_TYPE;
 885
 886 /* Structure associated with BTA_DM_SP_KEYPRESS_EVT */
 887 typedef struct
 888 {
 889     BD_ADDR             bd_addr;        /* peer address */
 890     tBTA_SP_KEY_TYPE   notif_type;
 891 }tBTA_DM_SP_KEY_PRESS;
 892
 893 /* Structure associated with BTA_DM_SP_KEY_NOTIF_EVT */
 894 typedef struct
 895 {
 896     /* Note: First 3 data members must be, bd_addr, dev_class, and bd_name in order */
 897     BD_ADDR         bd_addr;        /* peer address */
 898     DEV_CLASS       dev_class;      /* peer CoD */
 899     BD_NAME         bd_name;        /* peer device name */
 900     UINT32          passkey;        /* the numeric value for comparison. If just_works, do not show this number to UI */
 901 } tBTA_DM_SP_KEY_NOTIF;
 902
 903 /* Structure associated with BTA_DM_SP_RMT_OOB_EVT */
 904 typedef struct
 905 {
 906     /* Note: First 3 data members must be, bd_addr, dev_class, and bd_name in order */
 907     BD_ADDR         bd_addr;        /* peer address */
 908     DEV_CLASS       dev_class;      /* peer CoD */
 909     BD_NAME         bd_name;        /* peer device name */
 910 } tBTA_DM_SP_RMT_OOB;
 911
 912 /* Structure associated with BTA_DM_BOND_CANCEL_CMPL_EVT */
 913 typedef struct
 914 {
 915     tBTA_STATUS     result;    /* TRUE of bond cancel succeeded, FALSE if failed. */
 916 } tBTA_DM_BOND_CANCEL_CMPL;
 917
 918 /* Union of all security callback structures */
 919 typedef union
 920 {
 921     tBTA_DM_ENABLE      enable;         /* BTA enabled */
 922     tBTA_DM_PIN_REQ     pin_req;        /* PIN request. */
 923     tBTA_DM_AUTH_CMPL   auth_cmpl;      /* Authentication complete indication. */
 924     tBTA_DM_AUTHORIZE   authorize;      /* Authorization request. */
 925     tBTA_DM_LINK_UP     link_up;       /* ACL connection down event */
 926     tBTA_DM_LINK_DOWN   link_down;       /* ACL connection down event */
 927     tBTA_DM_SIG_STRENGTH sig_strength;  /* rssi and link quality value */
 928     tBTA_DM_BUSY_LEVEL  busy_level;     /* System busy level */
 929     tBTA_DM_SP_CFM_REQ  cfm_req;        /* user confirm request */
 930     tBTA_DM_SP_KEY_NOTIF key_notif;     /* passkey notification */
 931     tBTA_DM_SP_RMT_OOB  rmt_oob;        /* remote oob */
 932     tBTA_DM_BOND_CANCEL_CMPL bond_cancel_cmpl; /* Bond Cancel Complete indication */
 933     tBTA_DM_SP_KEY_PRESS   key_press;   /* key press notification event */
 934     tBTA_DM_ROLE_CHG     role_chg;       /* role change event */
 935     tBTA_DM_BLE_SEC_REQ  ble_req;        /* BLE SMP related request */
 936     tBTA_DM_BLE_KEY      ble_key;        /* BLE SMP keys used when pairing */
 937     tBTA_BLE_LOCAL_ID_KEYS  ble_id_keys;  /* IR event */
 938     BT_OCTET16              ble_er;       /* ER event data */
 939 } tBTA_DM_SEC;
 940
 941 /* Security callback */
 942 typedef void (tBTA_DM_SEC_CBACK)(tBTA_DM_SEC_EVT event, tBTA_DM_SEC *p_data);
 943
 944 #define BTA_BLE_MULTI_ADV_ILLEGAL 0
 945
 946 /* multi adv callback event */
 947 #define BTA_BLE_MULTI_ADV_ENB_EVT           1
 948 #define BTA_BLE_MULTI_ADV_DISABLE_EVT       2
 949 #define BTA_BLE_MULTI_ADV_PARAM_EVT         3
 950 #define BTA_BLE_MULTI_ADV_DATA_EVT          4
 951
 952 typedef UINT8 tBTA_BLE_MULTI_ADV_EVT;
 953
 954 /* multi adv callback */
 955 typedef void (tBTA_BLE_MULTI_ADV_CBACK)(tBTA_BLE_MULTI_ADV_EVT event,
 956                                         UINT8 inst_id, void *p_ref, tBTA_STATUS status);
 957 typedef UINT32 tBTA_DM_BLE_REF_VALUE;
 958
 959 #define BTA_DM_BLE_PF_ENABLE_EVT       BTM_BLE_PF_ENABLE
 960 #define BTA_DM_BLE_PF_CONFIG_EVT       BTM_BLE_PF_CONFIG
 961 typedef UINT8 tBTA_DM_BLE_PF_EVT;
 962
 963 #define BTA_DM_BLE_PF_ENABLE       1
 964 #define BTA_DM_BLE_PF_CONFIG       2
 965 typedef UINT8 tBTA_DM_BLE_PF_ACTION;
 966
 967 /* Config callback */
 968 typedef void (tBTA_DM_BLE_PF_CFG_CBACK) (tBTA_DM_BLE_PF_ACTION action,
 969                                          tBTA_DM_BLE_PF_COND_TYPE cfg_cond,
 970                                          tBTA_DM_BLE_PF_AVBL_SPACE avbl_space, tBTA_STATUS status,
 971                                          tBTA_DM_BLE_REF_VALUE ref_value);
 972 /* Param callback */
 973 typedef void (tBTA_DM_BLE_PF_PARAM_CBACK) (UINT8 action_type, tBTA_DM_BLE_PF_AVBL_SPACE avbl_space,
 974                                            tBTA_DM_BLE_REF_VALUE ref_value, tBTA_STATUS status);
 975
 976 /* Status callback */
 977 typedef void (tBTA_DM_BLE_PF_STATUS_CBACK) (UINT8 action, tBTA_STATUS status,
 978                                             tBTA_DM_BLE_REF_VALUE ref_value);
 979
 980
 981 #define BTA_DM_BLE_PF_BRDCAST_ADDR_FILT  1
 982 #define BTA_DM_BLE_PF_SERV_DATA_CHG_FILT 2
 983 #define BTA_DM_BLE_PF_SERV_UUID          4
 984 #define BTA_DM_BLE_PF_SERV_SOLC_UUID     8
 985 #define BTA_DM_BLE_PF_LOC_NAME_CHECK    16
 986 #define BTA_DM_BLE_PF_MANUF_NAME_CHECK  32
 987 #define BTA_DM_BLE_PF_SERV_DATA_CHECK   64
 988 typedef UINT16 tBTA_DM_BLE_PF_FEAT_SEL;
 989
 990 #define BTA_DM_BLE_PF_LIST_LOGIC_OR   1
 991 #define BTA_DM_BLE_PF_LIST_LOGIC_AND  2
 992 typedef UINT16 tBTA_DM_BLE_PF_LIST_LOGIC_TYPE;
 993
 994 #define BTA_DM_BLE_PF_FILT_LOGIC_OR   0
 995 #define BTA_DM_BLE_PF_FILT_LOGIC_AND  1
 996 typedef UINT16 tBTA_DM_BLE_PF_FILT_LOGIC_TYPE;
 997
 998 typedef UINT8  tBTA_DM_BLE_PF_RSSI_THRESHOLD;
 999 typedef UINT8  tBTA_DM_BLE_PF_DELIVERY_MODE;
1000 typedef UINT16 tBTA_DM_BLE_PF_TIMEOUT;
1001 typedef UINT8  tBTA_DM_BLE_PF_TIMEOUT_CNT;
1002
1003 typedef struct
1004 {
1005     tBTA_DM_BLE_PF_FEAT_SEL feat_seln;
1006     tBTA_DM_BLE_PF_LIST_LOGIC_TYPE list_logic_type;
1007     tBTA_DM_BLE_PF_FILT_LOGIC_TYPE filt_logic_type;
1008     tBTA_DM_BLE_PF_RSSI_THRESHOLD  rssi_high_thres;
1009     tBTA_DM_BLE_PF_RSSI_THRESHOLD  rssi_low_thres;
1010     tBTA_DM_BLE_PF_DELIVERY_MODE dely_mode;
1011     tBTA_DM_BLE_PF_TIMEOUT found_timeout;
1012     tBTA_DM_BLE_PF_TIMEOUT lost_timeout;
1013     tBTA_DM_BLE_PF_TIMEOUT_CNT found_timeout_cnt;
1014 } tBTA_DM_BLE_PF_FILT_PARAMS;
1015
1016 /* Vendor Specific Command Callback */
1017 typedef tBTM_VSC_CMPL_CB        tBTA_VENDOR_CMPL_CBACK;
1018
1019 /* Search callback events */
1020 #define BTA_DM_INQ_RES_EVT              0       /* Inquiry result for a peer device. */
1021 #define BTA_DM_INQ_CMPL_EVT             1       /* Inquiry complete. */
1022 #define BTA_DM_DISC_RES_EVT             2       /* Discovery result for a peer device. */
1023 #define BTA_DM_DISC_BLE_RES_EVT         3       /* Discovery result for BLE GATT based servoce on a peer device. */
1024 #define BTA_DM_DISC_CMPL_EVT            4       /* Discovery complete. */
1025 #define BTA_DM_DI_DISC_CMPL_EVT         5       /* Discovery complete. */
1026 #define BTA_DM_SEARCH_CANCEL_CMPL_EVT   6       /* Search cancelled */
1027
1028 typedef UINT8 tBTA_DM_SEARCH_EVT;
1029
1030 #define BTA_DM_INQ_RES_IGNORE_RSSI      BTM_INQ_RES_IGNORE_RSSI /* 0x7f RSSI value not supplied (ignore it) */
1031
1032 /* Structure associated with BTA_DM_INQ_RES_EVT */
1033 typedef struct
1034 {
1035     BD_ADDR         bd_addr;                /* BD address peer device. */
1036     DEV_CLASS       dev_class;              /* Device class of peer device. */
1037     BOOLEAN         remt_name_not_required; /* Application sets this flag if it already knows the name of the device */
1038                                             /* If the device name is known to application BTA skips the remote name request */
1039     BOOLEAN         is_limited;             /* TRUE, if the limited inquiry bit is set in the CoD */
1040     INT8            rssi;                   /* The rssi value */
1041     UINT8           *p_eir;                 /* received EIR */
1042 #if (BLE_INCLUDED == TRUE)
1043     UINT8               inq_result_type;
1044     UINT8               ble_addr_type;
1045     tBTM_BLE_EVT_TYPE   ble_evt_type;
1046     tBT_DEVICE_TYPE     device_type;
1047     UINT8               flag;
1048 #endif
1049
1050 } tBTA_DM_INQ_RES;
1051
1052 /* Structure associated with BTA_DM_INQ_CMPL_EVT */
1053 typedef struct
1054 {
1055     UINT8           num_resps;          /* Number of inquiry responses. */
1056 } tBTA_DM_INQ_CMPL;
1057
1058 /* Structure associated with BTA_DM_DI_DISC_CMPL_EVT */
1059 typedef struct
1060 {
1061     BD_ADDR             bd_addr;        /* BD address peer device. */
1062     UINT8               num_record;     /* Number of DI record */
1063     tBTA_STATUS         result;
1064 } tBTA_DM_DI_DISC_CMPL;
1065
1066 /* Structure associated with BTA_DM_DISC_RES_EVT */
1067 typedef struct
1068 {
1069     BD_ADDR             bd_addr;        /* BD address peer device. */
1070     BD_NAME             bd_name;        /* Name of peer device. */
1071     tBTA_SERVICE_MASK   services;       /* Services found on peer device. */
1072 // btla-specific ++
1073     UINT8           *   p_raw_data;     /* Raw data for discovery DB */
1074     UINT32              raw_data_size;  /* size of raw data */
1075     tBT_DEVICE_TYPE     device_type;    /* device type in case it is BLE device */
1076     UINT32              num_uuids;
1077     UINT8               *p_uuid_list;
1078 // btla-specific --
1079     tBTA_STATUS         result;
1080 } tBTA_DM_DISC_RES;
1081
1082 /* Structure associated with tBTA_DM_DISC_BLE_RES */
1083 typedef struct
1084 {
1085     BD_ADDR             bd_addr;        /* BD address peer device. */
1086     BD_NAME             bd_name;        /* Name of peer device. */
1087     tBT_UUID            service;        /* GATT based Services UUID found on peer device. */
1088 } tBTA_DM_DISC_BLE_RES;
1089
1090
1091 /* Union of all search callback structures */
1092 typedef union
1093 {
1094     tBTA_DM_INQ_RES     inq_res;        /* Inquiry result for a peer device. */
1095     tBTA_DM_INQ_CMPL    inq_cmpl;       /* Inquiry complete. */
1096     tBTA_DM_DISC_RES    disc_res;       /* Discovery result for a peer device. */
1097     tBTA_DM_DISC_BLE_RES    disc_ble_res;   /* discovery result for GATT based service */
1098     tBTA_DM_DI_DISC_CMPL    di_disc;        /* DI discovery result for a peer device */
1099
1100 } tBTA_DM_SEARCH;
1101
1102 /* Search callback */
1103 typedef void (tBTA_DM_SEARCH_CBACK)(tBTA_DM_SEARCH_EVT event, tBTA_DM_SEARCH *p_data);
1104
1105 /* Execute call back */
1106 typedef void (tBTA_DM_EXEC_CBACK) (void * p_param);
1107
1108 /* Encryption callback*/
1109 typedef void (tBTA_DM_ENCRYPT_CBACK) (BD_ADDR bd_addr, tBTA_TRANSPORT transport, tBTA_STATUS result);
1110
1111 #if BLE_INCLUDED == TRUE
1112 #define BTA_DM_BLE_SEC_NONE         BTM_BLE_SEC_NONE
1113 #define BTA_DM_BLE_SEC_ENCRYPT      BTM_BLE_SEC_ENCRYPT
1114 #define BTA_DM_BLE_SEC_NO_MITM      BTM_BLE_SEC_ENCRYPT_NO_MITM
1115 #define BTA_DM_BLE_SEC_MITM         BTM_BLE_SEC_ENCRYPT_MITM
1116 typedef tBTM_BLE_SEC_ACT            tBTA_DM_BLE_SEC_ACT;
1117
1118 typedef tBTM_BLE_TX_TIME_MS         tBTA_DM_BLE_TX_TIME_MS;
1119 typedef tBTM_BLE_RX_TIME_MS         tBTA_DM_BLE_RX_TIME_MS;
1120 typedef tBTM_BLE_IDLE_TIME_MS       tBTA_DM_BLE_IDLE_TIME_MS;
1121 typedef tBTM_BLE_ENERGY_USED        tBTA_DM_BLE_ENERGY_USED;
1122
1123 #define BTA_DM_CONTRL_UNKNOWN 0       /* Unknown state */
1124 #define BTA_DM_CONTRL_ACTIVE  1       /* ACL link on, SCO link ongoing, sniff mode */
1125 #define BTA_DM_CONTRL_SCAN    2       /* Scan state - paging/inquiry/trying to connect*/
1126 #define BTA_DM_CONTRL_IDLE    3       /* Idle state - page scan, LE advt, inquiry scan */
1127
1128 typedef UINT8 tBTA_DM_CONTRL_STATE;
1129
1130
1131 typedef void (tBTA_BLE_SCAN_THRESHOLD_CBACK)(tBTA_DM_BLE_REF_VALUE ref_value);
1132
1133 typedef void (tBTA_BLE_SCAN_REP_CBACK) (tBTA_DM_BLE_REF_VALUE ref_value, UINT8 report_format,
1134                                         UINT8 num_records, UINT16 data_len,
1135                                         UINT8* p_rep_data, tBTA_STATUS status);
1136
1137 typedef void (tBTA_BLE_SCAN_SETUP_CBACK) (tBTA_BLE_BATCH_SCAN_EVT evt,
1138                                           tBTA_DM_BLE_REF_VALUE ref_value,
1139                                           tBTA_STATUS status);
1140
1141 typedef void (tBTA_BLE_TRACK_ADV_CMPL_CBACK)(int action, tBTA_STATUS status,
1142                                              tBTA_DM_BLE_PF_AVBL_SPACE avbl_space,
1143                                              tBTA_DM_BLE_REF_VALUE ref_value);
1144
1145 typedef void (tBTA_BLE_TRACK_ADV_CBACK)(int filt_index, tBLE_ADDR_TYPE addr_type, BD_ADDR bda,
1146                                         int adv_state, tBTA_DM_BLE_REF_VALUE ref_value);
1147
1148 typedef void (tBTA_BLE_ENERGY_INFO_CBACK)(tBTA_DM_BLE_TX_TIME_MS tx_time,
1149                                           tBTA_DM_BLE_RX_TIME_MS rx_time,
1150                                           tBTA_DM_BLE_IDLE_TIME_MS idle_time,
1151                                           tBTA_DM_BLE_ENERGY_USED  energy_used,
1152                                           tBTA_DM_CONTRL_STATE ctrl_state,
1153                                           tBTA_STATUS status);
1154
1155 #else
1156 typedef UINT8                       tBTA_DM_BLE_SEC_ACT;
1157 #endif
1158
1159 /* Maximum service name length */
1160 #define BTA_SERVICE_NAME_LEN    35
1161 #define BTA_SERVICE_DESP_LEN    BTA_SERVICE_NAME_LEN
1162 #define BTA_PROVIDER_NAME_LEN   BTA_SERVICE_NAME_LEN
1163
1164
1165 /* link policy masks  */
1166 #define BTA_DM_LP_SWITCH        HCI_ENABLE_MASTER_SLAVE_SWITCH
1167 #define BTA_DM_LP_HOLD          HCI_ENABLE_HOLD_MODE
1168 #define BTA_DM_LP_SNIFF         HCI_ENABLE_SNIFF_MODE
1169 #define BTA_DM_LP_PARK          HCI_ENABLE_PARK_MODE
1170 typedef UINT16 tBTA_DM_LP_MASK;
1171
1172 /* power mode actions  */
1173 #define BTA_DM_PM_NO_ACTION    0x00       /* no change to the current pm setting */
1174 #define BTA_DM_PM_PARK         0x10       /* prefers park mode */
1175 #define BTA_DM_PM_SNIFF        0x20       /* prefers sniff mode */
1176 #define BTA_DM_PM_SNIFF1       0x21       /* prefers sniff1 mode */
1177 #define BTA_DM_PM_SNIFF2       0x22       /* prefers sniff2 mode */
1178 #define BTA_DM_PM_SNIFF3       0x23       /* prefers sniff3 mode */
1179 #define BTA_DM_PM_SNIFF4       0x24       /* prefers sniff4 mode */
1180 #define BTA_DM_PM_SNIFF5       0x25       /* prefers sniff5 mode */
1181 #define BTA_DM_PM_SNIFF6       0x26       /* prefers sniff6 mode */
1182 #define BTA_DM_PM_SNIFF7       0x27       /* prefers sniff7 mode */
1183 #define BTA_DM_PM_SNIFF_USER0  0x28       /* prefers user-defined sniff0 mode (testtool only) */
1184 #define BTA_DM_PM_SNIFF_USER1  0x29       /* prefers user-defined sniff1 mode (testtool only) */
1185 #define BTA_DM_PM_ACTIVE       0x40       /* prefers active mode */
1186 #define BTA_DM_PM_RETRY        0x80       /* retry power mode based on current settings */
1187 #define BTA_DM_PM_NO_PREF      0x01       /* service has no prefernce on power mode setting. eg. connection to service got closed */
1188
1189 typedef UINT8 tBTA_DM_PM_ACTTION;
1190
1191 /* index to bta_dm_ssr_spec */
1192 #define BTA_DM_PM_SSR0          0
1193 #define BTA_DM_PM_SSR1          1       /* BTA_DM_PM_SSR1 will be dedicated for
1194                                         HH SSR setting entry, no other profile can use it */
1195 #define BTA_DM_PM_SSR2          2
1196 #define BTA_DM_PM_SSR3          3
1197 #define BTA_DM_PM_SSR4          4
1198 #define BTA_DM_PM_SSR5          5
1199 #define BTA_DM_PM_SSR6          6
1200
1201 #define BTA_DM_PM_NUM_EVTS      9
1202
1203 #ifndef BTA_DM_PM_PARK_IDX
1204 #define BTA_DM_PM_PARK_IDX      5 /* the actual index to bta_dm_pm_md[] for PARK mode */
1205 #endif
1206
1207 #ifndef BTA_DM_PM_SNIFF_A2DP_IDX
1208 #define BTA_DM_PM_SNIFF_A2DP_IDX      BTA_DM_PM_SNIFF
1209 #endif
1210
1211 #ifndef BTA_DM_PM_SNIFF_HD_IDLE_IDX
1212 #define BTA_DM_PM_SNIFF_HD_IDLE_IDX   BTA_DM_PM_SNIFF2
1213 #endif
1214
1215 #ifndef BTA_DM_PM_SNIFF_SCO_OPEN_IDX
1216 #define BTA_DM_PM_SNIFF_SCO_OPEN_IDX  BTA_DM_PM_SNIFF3
1217 #endif
1218
1219 #ifndef BTA_DM_PM_SNIFF_HD_ACTIVE_IDX
1220 #define BTA_DM_PM_SNIFF_HD_ACTIVE_IDX BTA_DM_PM_SNIFF4
1221 #endif
1222
1223 #ifndef BTA_DM_PM_SNIFF_HH_OPEN_IDX
1224 #define BTA_DM_PM_SNIFF_HH_OPEN_IDX BTA_DM_PM_SNIFF2
1225 #endif
1226
1227 #ifndef BTA_DM_PM_SNIFF_HH_ACTIVE_IDX
1228 #define BTA_DM_PM_SNIFF_HH_ACTIVE_IDX BTA_DM_PM_SNIFF2
1229 #endif
1230
1231 #ifndef BTA_DM_PM_SNIFF_HH_IDLE_IDX
1232 #define BTA_DM_PM_SNIFF_HH_IDLE_IDX BTA_DM_PM_SNIFF2
1233 #endif
1234
1235
1236 #ifndef BTA_DM_PM_HH_OPEN_DELAY
1237 #define BTA_DM_PM_HH_OPEN_DELAY 30000
1238 #endif
1239
1240 #ifndef BTA_DM_PM_HH_ACTIVE_DELAY
1241 #define BTA_DM_PM_HH_ACTIVE_DELAY 30000
1242 #endif
1243
1244 #ifndef BTA_DM_PM_HH_IDLE_DELAY
1245 #define BTA_DM_PM_HH_IDLE_DELAY 30000
1246 #endif
1247
1248 /* The Sniff Parameters defined below must be ordered from highest
1249  * latency (biggest interval) to lowest latency.  If there is a conflict
1250  * among the connected services the setting with the lowest latency will
1251  * be selected.  If a device should override a sniff parameter then it
1252  * must insure that order is maintained.
1253  */
1254 #ifndef BTA_DM_PM_SNIFF_MAX
1255 #define BTA_DM_PM_SNIFF_MAX      800
1256 #define BTA_DM_PM_SNIFF_MIN      400
1257 #define BTA_DM_PM_SNIFF_ATTEMPT  4
1258 #define BTA_DM_PM_SNIFF_TIMEOUT  1
1259 #endif
1260
1261 #ifndef BTA_DM_PM_SNIFF1_MAX
1262 #define BTA_DM_PM_SNIFF1_MAX     400
1263 #define BTA_DM_PM_SNIFF1_MIN     200
1264 #define BTA_DM_PM_SNIFF1_ATTEMPT 4
1265 #define BTA_DM_PM_SNIFF1_TIMEOUT 1
1266 #endif
1267
1268 #ifndef BTA_DM_PM_SNIFF2_MAX
1269 #define BTA_DM_PM_SNIFF2_MAX     180
1270 #define BTA_DM_PM_SNIFF2_MIN     150
1271 #define BTA_DM_PM_SNIFF2_ATTEMPT 4
1272 #define BTA_DM_PM_SNIFF2_TIMEOUT 1
1273 #endif
1274
1275 #ifndef BTA_DM_PM_SNIFF3_MAX
1276 #define BTA_DM_PM_SNIFF3_MAX     150
1277 #define BTA_DM_PM_SNIFF3_MIN     50
1278 #define BTA_DM_PM_SNIFF3_ATTEMPT 4
1279 #define BTA_DM_PM_SNIFF3_TIMEOUT 1
1280 #endif
1281
1282 #ifndef BTA_DM_PM_SNIFF4_MAX
1283 #define BTA_DM_PM_SNIFF4_MAX     54
1284 #define BTA_DM_PM_SNIFF4_MIN     30
1285 #define BTA_DM_PM_SNIFF4_ATTEMPT 4
1286 #define BTA_DM_PM_SNIFF4_TIMEOUT 1
1287 #endif
1288
1289 #ifndef BTA_DM_PM_PARK_MAX
1290 #define BTA_DM_PM_PARK_MAX       800
1291 #define BTA_DM_PM_PARK_MIN       400
1292 #define BTA_DM_PM_PARK_ATTEMPT   0
1293 #define BTA_DM_PM_PARK_TIMEOUT   0
1294 #endif
1295
1296
1297 /* Switch callback events */
1298 #define BTA_DM_SWITCH_CMPL_EVT      0       /* Completion of the Switch API */
1299
1300 typedef UINT8 tBTA_DM_SWITCH_EVT;
1301 typedef void (tBTA_DM_SWITCH_CBACK)(tBTA_DM_SWITCH_EVT event, tBTA_STATUS status);
1302
1303 /* Audio routing out configuration */
1304 #define BTA_DM_ROUTE_NONE       0x00    /* No Audio output */
1305 #define BTA_DM_ROUTE_DAC        0x01    /* routing over analog output */
1306 #define BTA_DM_ROUTE_I2S        0x02    /* routing over digital (I2S) output */
1307 #define BTA_DM_ROUTE_BT_MONO    0x04    /* routing over SCO */
1308 #define BTA_DM_ROUTE_BT_STEREO  0x08    /* routing over BT Stereo */
1309 #define BTA_DM_ROUTE_HOST       0x10    /* routing over Host */
1310 #define BTA_DM_ROUTE_FMTX       0x20    /* routing over FMTX */
1311 #define BTA_DM_ROUTE_FMRX       0x40    /* routing over FMRX */
1312 #define BTA_DM_ROUTE_BTSNK      0x80    /* routing over BT SNK */
1313
1314 typedef UINT8 tBTA_DM_ROUTE_PATH;
1315
1316
1317 /* Device Identification (DI) data structure
1318 */
1319 /* Used to set the DI record */
1320 typedef tSDP_DI_RECORD          tBTA_DI_RECORD;
1321 /* Used to get the DI record */
1322 typedef tSDP_DI_GET_RECORD      tBTA_DI_GET_RECORD;
1323 /* SDP discovery database */
1324 typedef tSDP_DISCOVERY_DB       tBTA_DISCOVERY_DB;
1325
1326 #ifndef         BTA_DI_NUM_MAX
1327 #define         BTA_DI_NUM_MAX       3
1328 #endif
1329
1330 /* Device features mask definitions */
1331 #define BTA_FEATURE_BYTES_PER_PAGE  BTM_FEATURE_BYTES_PER_PAGE
1332 #define BTA_EXT_FEATURES_PAGE_MAX   BTM_EXT_FEATURES_PAGE_MAX
1333 /* ACL type
1334 */
1335 #define BTA_DM_LINK_TYPE_BR_EDR    0x01
1336 #define BTA_DM_LINK_TYPE_LE        0x02
1337 #define BTA_DM_LINK_TYPE_ALL       0xFF
1338 typedef UINT8 tBTA_DM_LINK_TYPE;
1339
1340 #define IMMEDIATE_DELY_MODE  0x00
1341 #define ONFOUND_DELY_MODE    0x01
1342 #define BATCH_DELY_MODE      0x02
1343 #define ALLOW_ALL_FILTER     0x00
1344 #define LOWEST_RSSI_VALUE     129
1345
1346 /*****************************************************************************
1347 **  External Function Declarations
1348 *****************************************************************************/
1349 #ifdef __cplusplus
1350 extern "C"
1351 {
1352 #endif
1353
1354 /*******************************************************************************
1355 **
1356 ** Function         BTA_EnableBluetooth
1357 **
1358 ** Description      This function initializes BTA and prepares BTA and the
1359 **                  Bluetooth protocol stack for use.  This function is
1360 **                  typically called at startup or when Bluetooth services
1361 **                  are required by the phone.  This function must be called
1362 **                  before calling any other API function.
1363 **
1364 **
1365 ** Returns          BTA_SUCCESS if successful.
1366 **                  BTA_FAIL if internal failure.
1367 **
1368 *******************************************************************************/
1369 BTA_API extern tBTA_STATUS BTA_EnableBluetooth(tBTA_DM_SEC_CBACK *p_cback);
1370
1371 /*******************************************************************************
1372 **
1373 ** Function         BTA_DisableBluetooth
1374 **
1375 ** Description      This function disables BTA and the Bluetooth protocol
1376 **                  stack.  It is called when BTA is no longer being used
1377 **                  by any application in the system.
1378 **
1379 **
1380 ** Returns          void
1381 **
1382 *******************************************************************************/
1383 BTA_API extern tBTA_STATUS BTA_DisableBluetooth(void);
1384
1385 /*******************************************************************************
1386 **
1387 ** Function         BTA_EnableTestMode
1388 **
1389 ** Description      Enables bluetooth device under test mode
1390 **
1391 **
1392 ** Returns          tBTA_STATUS
1393 **
1394 *******************************************************************************/
1395 BTA_API extern tBTA_STATUS BTA_EnableTestMode(void);
1396
1397 /*******************************************************************************
1398 **
1399 ** Function         BTA_DisableTestMode
1400 **
1401 ** Description      Disable bluetooth device under test mode
1402 **
1403 **
1404 ** Returns          None
1405 **
1406 *******************************************************************************/
1407 BTA_API extern void BTA_DisableTestMode(void);
1408
1409 /*******************************************************************************
1410 **
1411 ** Function         BTA_DmIsDeviceUp
1412 **
1413 ** Description      This function tests whether the Bluetooth module is up
1414 **                  and ready.  This is a direct execution function that
1415 **                  may lock task scheduling on some platforms.
1416 **
1417 **
1418 ** Returns          TRUE if the module is ready.
1419 **                  FALSE if the module is not ready.
1420 **
1421 *******************************************************************************/
1422 BTA_API extern BOOLEAN BTA_DmIsDeviceUp(void);
1423
1424 /*******************************************************************************
1425 **
1426 ** Function         BTA_DmSetDeviceName
1427 **
1428 ** Description      This function sets the Bluetooth name of the local device.
1429 **
1430 **
1431 ** Returns          void
1432 **
1433 *******************************************************************************/
1434 BTA_API extern void BTA_DmSetDeviceName(char *p_name);
1435
1436 /*******************************************************************************
1437 **
1438 ** Function         BTA_DmSetVisibility
1439 **
1440 ** Description      This function sets the Bluetooth connectable,discoverable,
1441 **                  pairable and conn paired only modesmodes of the local device.
1442 **                  This controls whether other Bluetooth devices can find and connect to
1443 **                  the local device.
1444 **
1445 **
1446 ** Returns          void
1447 **
1448 *******************************************************************************/
1449 BTA_API extern void BTA_DmSetVisibility(tBTA_DM_DISC disc_mode, tBTA_DM_CONN conn_mode, UINT8 pairable_mode, UINT8 conn_filter);
1450
1451 /*******************************************************************************
1452 **
1453 ** Function         BTA_DmSetScanParam
1454 **
1455 ** Description      This function sets the parameters for page scan and
1456 **                  inquiry scan.
1457 **
1458 **
1459 ** Returns          void
1460 **
1461 *******************************************************************************/
1462 BTA_API extern void BTA_DmSetScanParam (UINT16 page_scan_interval, UINT16 page_scan_window,
1463                                   UINT16 inquiry_scan_interval, UINT16 inquiry_scan_window);
1464
1465 /*******************************************************************************
1466 **
1467 ** Function         BTA_DmSetAfhChannels
1468 **
1469 ** Description      This function sets the AFH first and
1470 **                  last disable channel, so channels within
1471 **                  that range are disabled.
1472 **                  In order to use this API, BTM_BYPASS_AMP_AUTO_AFH must be set
1473 **                  to be TRUE
1474 **
1475 ** Returns          void
1476 **
1477 *******************************************************************************/
1478 BTA_API extern void BTA_DmSetAfhChannels(UINT8 first, UINT8 last);
1479
1480
1481 /*******************************************************************************
1482 **
1483 ** Function         BTA_DmVendorSpecificCommand
1484 **
1485 ** Description      This function sends the vendor specific command
1486 **                  to the controller
1487 **
1488 **
1489 ** Returns          tBTA_STATUS
1490 **
1491 *******************************************************************************/
1492 BTA_API extern tBTA_STATUS BTA_DmVendorSpecificCommand (UINT16 opcode, UINT8 param_len,UINT8 *p_param_buf, tBTA_VENDOR_CMPL_CBACK *p_cback);
1493
1494
1495 /*******************************************************************************
1496 **
1497 ** Function         BTA_DmSearch
1498 **
1499 ** Description      This function searches for peer Bluetooth devices.  It
1500 **                  first performs an inquiry; for each device found from the
1501 **                  inquiry it gets the remote name of the device.  If
1502 **                  parameter services is nonzero, service discovery will be
1503 **                  performed on each device for the services specified.
1504 **
1505 **
1506 ** Returns          void
1507 **
1508 *******************************************************************************/
1509 BTA_API extern void BTA_DmSearch(tBTA_DM_INQ *p_dm_inq, tBTA_SERVICE_MASK services,
1510                                  tBTA_DM_SEARCH_CBACK *p_cback);
1511
1512 /*******************************************************************************
1513 **
1514 ** Function         BTA_DmSearchCancel
1515 **
1516 ** Description      This function cancels a search that has been initiated
1517 **                  by calling BTA_DmSearch().
1518 **
1519 **
1520 ** Returns          void
1521 **
1522 *******************************************************************************/
1523 BTA_API extern void BTA_DmSearchCancel(void);
1524
1525 /*******************************************************************************
1526 **
1527 ** Function         BTA_DmDiscover
1528 **
1529 ** Description      This function performs service discovery for the services
1530 **                  of a particular peer device.
1531 **
1532 **
1533 ** Returns          void
1534 **
1535 *******************************************************************************/
1536 BTA_API extern void BTA_DmDiscover(BD_ADDR bd_addr, tBTA_SERVICE_MASK services,
1537                                    tBTA_DM_SEARCH_CBACK *p_cback, BOOLEAN sdp_search);
1538
1539 // btla-specific ++
1540 /*******************************************************************************
1541 **
1542 ** Function         BTA_DmDiscoverUUID
1543 **
1544 ** Description      This function performs service discovery for the services
1545 **                  of a particular peer device.
1546 **
1547 **
1548 ** Returns          void
1549 **
1550 *******************************************************************************/
1551 BTA_API extern void BTA_DmDiscoverUUID(BD_ADDR bd_addr, tSDP_UUID *uuid,
1552                     tBTA_DM_SEARCH_CBACK *p_cback, BOOLEAN sdp_search);
1553
1554 /*******************************************************************************
1555 **
1556 ** Function         BTA_DmGetCachedRemoteName
1557 **
1558 ** Description      Retieve cached remote name if available
1559 **
1560 ** Returns          BTA_SUCCESS if cached name was retrieved
1561 **                  BTA_FAILURE if cached name is not available
1562 **
1563 *******************************************************************************/
1564 tBTA_STATUS BTA_DmGetCachedRemoteName(BD_ADDR remote_device, UINT8 **pp_cached_name);
1565 // btla-specific --
1566
1567 /*******************************************************************************
1568 **
1569 ** Function         BTA_DmIsMaster
1570 **
1571 ** Description      This function checks if the local device is the master of
1572 **                  the link to the given device
1573 **
1574 ** Returns          TRUE if master.
1575 **                  FALSE if not.
1576 **
1577 *******************************************************************************/
1578 BTA_API extern BOOLEAN BTA_DmIsMaster(BD_ADDR bd_addr);
1579
1580 /*******************************************************************************
1581 **
1582 ** Function         BTA_DmBond
1583 **
1584 ** Description      This function initiates a bonding procedure with a peer
1585 **                  device.  The bonding procedure enables authentication
1586 **                  and optionally encryption on the Bluetooth link.
1587 **
1588 **
1589 ** Returns          void
1590 **
1591 *******************************************************************************/
1592 BTA_API extern void BTA_DmBond(BD_ADDR bd_addr);
1593
1594 /*******************************************************************************
1595 **
1596 ** Function         BTA_DmBondByTransport
1597 **
1598 ** Description      This function initiates a bonding procedure with a peer
1599 **                  device by designated transport.  The bonding procedure enables
1600 **                  authentication and optionally encryption on the Bluetooth link.
1601 **
1602 **
1603 ** Returns          void
1604 **
1605 *******************************************************************************/
1606 BTA_API extern void BTA_DmBondByTransport(BD_ADDR bd_addr, tBTA_TRANSPORT transport);
1607
1608
1609 /*******************************************************************************
1610 **
1611 ** Function         BTA_DmBondCancel
1612 **
1613 ** Description      This function cancels a bonding procedure with a peer
1614 **                  device.
1615 **
1616 **
1617 ** Returns          void
1618 **
1619 *******************************************************************************/
1620 BTA_API extern void BTA_DmBondCancel(BD_ADDR bd_addr);
1621
1622 /*******************************************************************************
1623 **
1624 ** Function         BTA_DmPinReply
1625 **
1626 ** Description      This function provides a PIN when one is requested by DM
1627 **                  during a bonding procedure.  The application should call
1628 **                  this function after the security callback is called with
1629 **                  a BTA_DM_PIN_REQ_EVT.
1630 **
1631 **
1632 ** Returns          void
1633 **
1634 *******************************************************************************/
1635 BTA_API extern void BTA_DmPinReply(BD_ADDR bd_addr, BOOLEAN accept, UINT8 pin_len,
1636                                    UINT8 *p_pin);
1637
1638 /*******************************************************************************
1639 **
1640 ** Function         BTA_DmLinkPolicy
1641 **
1642 ** Description      This function sets/clears the link policy mask to the given
1643 **                  bd_addr.
1644 **                  If clearing the sniff or park mode mask, the link is put
1645 **                  in active mode.
1646 **
1647 ** Returns          void
1648 **
1649 *******************************************************************************/
1650 BTA_API extern void BTA_DmLinkPolicy(BD_ADDR bd_addr, tBTA_DM_LP_MASK policy_mask,
1651                                      BOOLEAN set);
1652
1653 #if (BTM_OOB_INCLUDED == TRUE)
1654 /*******************************************************************************
1655 **
1656 ** Function         BTA_DmLocalOob
1657 **
1658 ** Description      This function retrieves the OOB data from local controller.
1659 **                  The result is reported by bta_dm_co_loc_oob().
1660 **
1661 ** Returns          void
1662 **
1663 *******************************************************************************/
1664 BTA_API extern void BTA_DmLocalOob(void);
1665 #endif /* BTM_OOB_INCLUDED */
1666
1667 /*******************************************************************************
1668 **
1669 ** Function         BTA_DmConfirm
1670 **
1671 ** Description      This function accepts or rejects the numerical value of the
1672 **                  Simple Pairing process on BTA_DM_SP_CFM_REQ_EVT
1673 **
1674 ** Returns          void
1675 **
1676 *******************************************************************************/
1677 BTA_API extern void BTA_DmConfirm(BD_ADDR bd_addr, BOOLEAN accept);
1678
1679 /*******************************************************************************
1680 **
1681 ** Function         BTA_DmPasskeyCancel
1682 **
1683 ** Description      This function is called to cancel the simple pairing process
1684 **                  reported by BTA_DM_SP_KEY_NOTIF_EVT
1685 **
1686 ** Returns          void
1687 **
1688 *******************************************************************************/
1689 BTA_API extern void BTA_DmPasskeyCancel(BD_ADDR bd_addr);
1690
1691 /*******************************************************************************
1692 **
1693 ** Function         BTA_DmAddDevice
1694 **
1695 ** Description      This function adds a device to the security database list
1696 **                  of peer devices. This function would typically be called
1697 **                  at system startup to initialize the security database with
1698 **                  known peer devices.  This is a direct execution function
1699 **                  that may lock task scheduling on some platforms.
1700 **
1701 ** Returns          void
1702 **
1703 *******************************************************************************/
1704 BTA_API extern void BTA_DmAddDevice(BD_ADDR bd_addr, DEV_CLASS dev_class,
1705                                     LINK_KEY link_key, tBTA_SERVICE_MASK trusted_mask,
1706                                     BOOLEAN is_trusted, UINT8 key_type,
1707                                     tBTA_IO_CAP io_cap);
1708
1709 /*******************************************************************************
1710 **
1711 ** Function         BTA_DmAddDevWithName
1712 **
1713 ** Description      This function is newer version of  BTA_DmAddDevice()
1714 **                  which added bd_name and features as input parameters.
1715 **
1716 **
1717 ** Returns          void
1718 **
1719 ** Note:            features points to the remote device features array.
1720 **                  The array size is
1721 **                  BTA_FEATURE_BYTES_PER_PAGE * (BTA_EXT_FEATURES_PAGE_MAX + 1)
1722 **
1723 *******************************************************************************/
1724 BTA_API extern void BTA_DmAddDevWithName (BD_ADDR bd_addr, DEV_CLASS dev_class,
1725                                       BD_NAME bd_name, UINT8 *features,
1726                                       LINK_KEY link_key, tBTA_SERVICE_MASK trusted_mask,
1727                                       BOOLEAN is_trusted, UINT8 key_type, tBTA_IO_CAP io_cap);
1728
1729 /*******************************************************************************
1730 **
1731 ** Function         BTA_DmRemoveDevice
1732 **
1733 ** Description      This function removes a device from the security database.
1734 **                  This is a direct execution function that may lock task
1735 **                  scheduling on some platforms.
1736 **
1737 **
1738 ** Returns          BTA_SUCCESS if successful.
1739 **                  BTA_FAIL if operation failed.
1740 **
1741 *******************************************************************************/
1742 BTA_API extern tBTA_STATUS BTA_DmRemoveDevice(BD_ADDR bd_addr);
1743
1744 /*******************************************************************************
1745 **
1746 ** Function         BTA_DmAuthorizeReply
1747 **
1748 ** Description      This function provides an authorization reply when
1749 **                  authorization is requested by BTA.  The application calls
1750 **                  this function after the security callback is called with
1751 **                  a BTA_DM_AUTHORIZE_EVT.
1752 **
1753 **
1754 ** Returns          void
1755 **
1756 *******************************************************************************/
1757 BTA_API extern void BTA_DmAuthorizeReply(BD_ADDR bd_addr, tBTA_SERVICE_ID service,
1758                                          tBTA_AUTH_RESP response);
1759
1760 /*******************************************************************************
1761 **
1762 ** Function         BTA_DmSignalStrength
1763 **
1764 ** Description      This function initiates RSSI and channnel quality
1765 **                  measurments. BTA_DM_SIG_STRENGTH_EVT is sent to
1766 **                  application with the values of RSSI and channel
1767 **                  quality
1768 **
1769 **
1770 ** Returns          void
1771 **
1772 *******************************************************************************/
1773 BTA_API extern void BTA_DmSignalStrength(tBTA_SIG_STRENGTH_MASK mask, UINT16 period, BOOLEAN start);
1774
1775 /*******************************************************************************
1776 **
1777 ** Function         BTA_DmWriteInqTxPower
1778 **
1779 ** Description      This command is used to write the inquiry transmit power level
1780 **                  used to transmit the inquiry (ID) data packets.
1781 **
1782 ** Parameters       tx_power - tx inquiry power to use, valid value is -70 ~ 20
1783
1784 ** Returns          void
1785 **
1786 *******************************************************************************/
1787 BTA_API extern void BTA_DmWriteInqTxPower(INT8 tx_power);
1788
1789 /*******************************************************************************
1790 **
1791 ** Function         BTA_DmEirAddUUID
1792 **
1793 ** Description      This function is called to add UUID into EIR.
1794 **
1795 ** Parameters       tBT_UUID - UUID
1796 **
1797 ** Returns          None
1798 **
1799 *******************************************************************************/
1800 BTA_API extern void BTA_DmEirAddUUID (tBT_UUID *p_uuid);
1801
1802 /*******************************************************************************
1803 **
1804 ** Function         BTA_DmEirRemoveUUID
1805 **
1806 ** Description      This function is called to remove UUID from EIR.
1807 **
1808 ** Parameters       tBT_UUID - UUID
1809 **
1810 ** Returns          None
1811 **
1812 *******************************************************************************/
1813 BTA_API extern void BTA_DmEirRemoveUUID (tBT_UUID *p_uuid);
1814
1815 /*******************************************************************************
1816 **
1817 ** Function         BTA_DmSetEIRConfig
1818 **
1819 ** Description      This function is called to override the BTA default EIR parameters.
1820 **                  This funciton is only valid in a system where BTU & App task
1821 **                  are in the same memory space.
1822 **
1823 ** Parameters       Pointer to User defined EIR config
1824 **
1825 ** Returns          None
1826 **
1827 *******************************************************************************/
1828 BTA_API extern void BTA_DmSetEIRConfig (tBTA_DM_EIR_CONF *p_eir_cfg);
1829
1830 /*******************************************************************************
1831 **
1832 ** Function         BTA_CheckEirData
1833 **
1834 ** Description      This function is called to get EIR data from significant part.
1835 **
1836 ** Parameters       p_eir - pointer of EIR significant part
1837 **                  type   - finding EIR data type
1838 **                  p_length - return the length of EIR data
1839 **
1840 ** Returns          pointer of EIR data
1841 **
1842 *******************************************************************************/
1843 BTA_API extern UINT8 *BTA_CheckEirData( UINT8 *p_eir, UINT8 tag, UINT8 *p_length );
1844
1845 /*******************************************************************************
1846 **
1847 ** Function         BTA_GetEirService
1848 **
1849 ** Description      This function is called to get BTA service mask from EIR.
1850 **
1851 ** Parameters       p_eir - pointer of EIR significant part
1852 **                  p_services - return the BTA service mask
1853 **
1854 ** Returns          None
1855 **
1856 *******************************************************************************/
1857 BTA_API extern void BTA_GetEirService( UINT8 *p_eir, tBTA_SERVICE_MASK *p_services );
1858
1859 /*******************************************************************************
1860 **
1861 ** Function         BTA_DmUseSsr
1862 **
1863 ** Description      This function is called to check if the connected peer device
1864 **                  supports SSR or not.
1865 **
1866 ** Returns          TRUE, if SSR is supported
1867 **
1868 *******************************************************************************/
1869 BTA_API extern BOOLEAN BTA_DmUseSsr( BD_ADDR bd_addr );
1870
1871 /*******************************************************************************
1872 **
1873 ** Function         BTA_DmGetConnectionState
1874 **
1875 ** Description      Returns whether the remote device is currently connected.
1876 **
1877 ** Returns          0 if the device is NOT connected.
1878 **
1879 *******************************************************************************/
1880 BTA_API extern UINT16 BTA_DmGetConnectionState( BD_ADDR bd_addr );
1881
1882
1883 /*******************************************************************************
1884 **
1885 ** Function         BTA_DmSetLocalDiRecord
1886 **
1887 ** Description      This function adds a DI record to the local SDP database.
1888 **
1889 ** Returns          BTA_SUCCESS if record set sucessfully, otherwise error code.
1890 **
1891 *******************************************************************************/
1892 BTA_API extern tBTA_STATUS BTA_DmSetLocalDiRecord( tBTA_DI_RECORD *p_device_info,
1893                                   UINT32 *p_handle );
1894
1895 /*******************************************************************************
1896 **
1897 ** Function         BTA_DmGetLocalDiRecord
1898 **
1899 ** Description      Get a specified DI record to the local SDP database. If no
1900 **                  record handle is provided, the primary DI record will be
1901 **                  returned.
1902 **
1903 ** Returns          BTA_SUCCESS if record set sucessfully, otherwise error code.
1904 **
1905 *******************************************************************************/
1906 BTA_API extern tBTA_STATUS BTA_DmGetLocalDiRecord( tBTA_DI_GET_RECORD *p_device_info,
1907                                   UINT32 *p_handle );
1908
1909 /*******************************************************************************
1910 **
1911 ** Function         BTA_DmDiDiscover
1912 **
1913 ** Description      This function queries a remote device for DI information.
1914 **
1915 ** Returns          None.
1916 **
1917 *******************************************************************************/
1918 BTA_API extern void BTA_DmDiDiscover( BD_ADDR remote_device, tBTA_DISCOVERY_DB *p_db,
1919                        UINT32 len, tBTA_DM_SEARCH_CBACK *p_cback );
1920
1921 /*******************************************************************************
1922 **
1923 ** Function         BTA_DmGetDiRecord
1924 **
1925 ** Description      This function retrieves a remote device's DI record from
1926 **                  the specified database.
1927 **
1928 ** Returns          None.
1929 **
1930 *******************************************************************************/
1931 BTA_API extern tBTA_STATUS BTA_DmGetDiRecord( UINT8 get_record_index, tBTA_DI_GET_RECORD *p_device_info,
1932                         tBTA_DISCOVERY_DB *p_db );
1933
1934 /*******************************************************************************
1935 **
1936 **
1937 ** Function         BTA_DmCloseACL
1938 **
1939 ** Description      This function force to close an ACL connection and remove the
1940 **                  device from the security database list of known devices.
1941 **
1942 ** Parameters:      bd_addr       - Address of the peer device
1943 **                  remove_dev    - remove device or not after link down
1944 **                  transport     - which transport to close
1945
1946 **
1947 ** Returns          void.
1948 **
1949 *******************************************************************************/
1950 BTA_API extern void BTA_DmCloseACL(BD_ADDR bd_addr, BOOLEAN remove_dev, tBTA_TRANSPORT transport);
1951
1952 /*******************************************************************************
1953 **
1954 ** Function         BTA_SysFeatures
1955 **
1956 ** Description      This function is called to set system features.
1957 **
1958 ** Returns          void
1959 **
1960 *******************************************************************************/
1961 BTA_API extern void BTA_SysFeatures (UINT16 sys_features);
1962
1963 /*******************************************************************************
1964 **
1965 ** Function         bta_dmexecutecallback
1966 **
1967 ** Description      This function will request BTA to execute a call back in the context of BTU task
1968 **                  This API was named in lower case because it is only intended
1969 **                  for the internal customers(like BTIF).
1970 **
1971 ** Returns          void
1972 **
1973 *******************************************************************************/
1974 BTA_API extern void bta_dmexecutecallback (tBTA_DM_EXEC_CBACK* p_callback, void * p_param);
1975
1976 #if (BTM_SCO_HCI_INCLUDED == TRUE)
1977 /*******************************************************************************
1978 **
1979 ** Function         BTA_DmPcmInitSamples
1980 **
1981 ** Description      initialize the down sample converter.
1982 **
1983 **                  src_sps: original samples per second (source audio data)
1984 **                            (ex. 44100, 48000)
1985 **                  bits: number of bits per pcm sample (16)
1986 **                  n_channels: number of channels (i.e. mono(1), stereo(2)...)
1987 **
1988 ** Returns          none
1989 **
1990 *******************************************************************************/
1991 BTA_API extern void BTA_DmPcmInitSamples (UINT32 src_sps, UINT32 bits, UINT32 n_channels);
1992
1993 /**************************************************************************************
1994 ** Function         BTA_DmPcmResample
1995 **
1996 ** Description      Down sampling utility to convert higher sampling rate into 8K/16bits
1997 **                  PCM samples.
1998 **
1999 ** Parameters       p_src: pointer to the buffer where the original sampling PCM
2000 **                              are stored.
2001 **                  in_bytes:  Length of the input PCM sample buffer in byte.
2002 **                  p_dst:      pointer to the buffer which is to be used to store
2003 **                              the converted PCM samples.
2004 **
2005 **
2006 ** Returns          INT32: number of samples converted.
2007 **
2008 **************************************************************************************/
2009 BTA_API extern INT32 BTA_DmPcmResample (void *p_src, UINT32 in_bytes, void *p_dst);
2010 #endif
2011
2012 #if ((defined BLE_INCLUDED) && (BLE_INCLUDED == TRUE))
2013 /* BLE related API functions */
2014 /*******************************************************************************
2015 **
2016 ** Function         BTA_DmBleSecurityGrant
2017 **
2018 ** Description      Grant security request access.
2019 **
2020 ** Parameters:      bd_addr          - BD address of the peer
2021 **                  res              - security grant status.
2022 **
2023 ** Returns          void
2024 **
2025 *******************************************************************************/
2026 BTA_API extern void BTA_DmBleSecurityGrant(BD_ADDR bd_addr, tBTA_DM_BLE_SEC_GRANT res);
2027
2028
2029
2030 /*******************************************************************************
2031 **
2032 ** Function         BTA_DmBleSetBgConnType
2033 **
2034 ** Description      This function is called to set BLE connectable mode for a
2035 **                  peripheral device.
2036 **
2037 ** Parameters       bg_conn_type: it can be auto connection, or selective connection.
2038 **                  p_select_cback: callback function when selective connection procedure
2039 **                              is being used.
2040 **
2041 ** Returns          void
2042 **
2043 *******************************************************************************/
2044 BTA_API extern void BTA_DmBleSetBgConnType(tBTA_DM_BLE_CONN_TYPE bg_conn_type, tBTA_DM_BLE_SEL_CBACK *p_select_cback);
2045
2046 /*******************************************************************************
2047 **
2048 ** Function         BTA_DmBlePasskeyReply
2049 **
2050 ** Description      Send BLE SMP passkey reply.
2051 **
2052 ** Parameters:      bd_addr          - BD address of the peer
2053 **                  accept           - passkey entry sucessful or declined.
2054 **                  passkey          - passkey value, must be a 6 digit number,
2055 **                                     can be lead by 0.
2056 **
2057 ** Returns          void
2058 **
2059 *******************************************************************************/
2060 BTA_API extern void BTA_DmBlePasskeyReply(BD_ADDR bd_addr, BOOLEAN accept, UINT32 passkey);
2061
2062 /*******************************************************************************
2063 **
2064 ** Function         BTA_DmAddBleDevice
2065 **
2066 ** Description      Add a BLE device.  This function will be normally called
2067 **                  during host startup to restore all required information
2068 **                  for a LE device stored in the NVRAM.
2069 **
2070 ** Parameters:      bd_addr          - BD address of the peer
2071 **                  dev_type         - Remote device's device type.
2072 **                  addr_type        - LE device address type.
2073 **
2074 ** Returns          void
2075 **
2076 *******************************************************************************/
2077 BTA_API extern void BTA_DmAddBleDevice(BD_ADDR bd_addr, tBLE_ADDR_TYPE addr_type,
2078                                        tBT_DEVICE_TYPE dev_type);
2079
2080
2081 /*******************************************************************************
2082 **
2083 ** Function         BTA_DmAddBleKey
2084 **
2085 ** Description      Add/modify LE device information.  This function will be
2086 **                  normally called during host startup to restore all required
2087 **                  information stored in the NVRAM.
2088 **
2089 ** Parameters:      bd_addr          - BD address of the peer
2090 **                  p_le_key         - LE key values.
2091 **                  key_type         - LE SMP key type.
2092 **
2093 ** Returns          void
2094 **
2095 *******************************************************************************/
2096 BTA_API extern void BTA_DmAddBleKey (BD_ADDR bd_addr,
2097                                      tBTA_LE_KEY_VALUE *p_le_key,
2098                                      tBTA_LE_KEY_TYPE key_type);
2099
2100 /*******************************************************************************
2101 **
2102 ** Function         BTA_DmSetBlePrefConnParams
2103 **
2104 ** Description      This function is called to set the preferred connection
2105 **                  parameters when default connection parameter is not desired.
2106 **
2107 ** Parameters:      bd_addr          - BD address of the peripheral
2108 **                  min_conn_int     - minimum preferred connection interval
2109 **                  max_conn_int     - maximum preferred connection interval
2110 **                  slave_latency    - preferred slave latency
2111 **                  supervision_tout - preferred supervision timeout
2112 **
2113 **
2114 ** Returns          void
2115 **
2116 *******************************************************************************/
2117 BTA_API extern void BTA_DmSetBlePrefConnParams(BD_ADDR bd_addr,
2118                                UINT16 min_conn_int, UINT16 max_conn_int,
2119                                UINT16 slave_latency, UINT16 supervision_tout );
2120
2121 /*******************************************************************************
2122 **
2123 ** Function         BTA_DmSetBleConnScanParams
2124 **
2125 ** Description      This function is called to set scan parameters used in
2126 **                  BLE connection request
2127 **
2128 ** Parameters:      bd_addr          - BD address of the peripheral
2129 **                  scan_interval    - scan interval
2130 **                  scan_window      - scan window
2131 **
2132 ** Returns          void
2133 **
2134 *******************************************************************************/
2135 BTA_API extern void BTA_DmSetBleConnScanParams(UINT16 scan_interval,
2136                                                UINT16 scan_window );
2137
2138 /*******************************************************************************
2139 **
2140 ** Function         BTA_DmSetBleAdvParams
2141 **
2142 ** Description      This function sets the advertising parameters BLE functionality.
2143 **                  It is to be called when device act in peripheral or broadcaster
2144 **                  role.
2145 **
2146 ** Parameters:      adv_int_min    - adv interval minimum
2147 **                  adv_int_max    - adv interval max
2148 **                  p_dir_bda      - directed adv initator address
2149 **
2150 ** Returns          void
2151 **
2152 *******************************************************************************/
2153 BTA_API extern void BTA_DmSetBleAdvParams (UINT16 adv_int_min, UINT16 adv_int_max,
2154                                            tBLE_BD_ADDR *p_dir_bda);
2155 /*******************************************************************************
2156 **
2157 ** Function         BTA_DmSearchExt
2158 **
2159 ** Description      This function searches for peer Bluetooth devices. It performs
2160 **                  an inquiry and gets the remote name for devices. Service
2161 **                  discovery is done if services is non zero
2162 **
2163 ** Parameters       p_dm_inq: inquiry conditions
2164 **                  services: if service is not empty, service discovery will be done.
2165 **                            for all GATT based service condition, put num_uuid, and
2166 **                            p_uuid is the pointer to the list of UUID values.
2167 **                  p_cback: callback functino when search is completed.
2168 **
2169 **
2170 **
2171 ** Returns          void
2172 **
2173 *******************************************************************************/
2174 BTA_API extern void BTA_DmSearchExt(tBTA_DM_INQ *p_dm_inq, tBTA_SERVICE_MASK_EXT *p_services,
2175                                     tBTA_DM_SEARCH_CBACK *p_cback);
2176
2177 /*******************************************************************************
2178 **
2179 ** Function         BTA_DmDiscoverExt
2180 **
2181 ** Description      This function does service discovery for services of a
2182 **                  peer device. When services.num_uuid is 0, it indicates all
2183 **                  GATT based services are to be searched; other wise a list of
2184 **                  UUID of interested services should be provided through
2185 **                  services.p_uuid.
2186 **
2187 **
2188 **
2189 ** Returns          void
2190 **
2191 *******************************************************************************/
2192 BTA_API extern void BTA_DmDiscoverExt(BD_ADDR bd_addr, tBTA_SERVICE_MASK_EXT *p_services,
2193                                     tBTA_DM_SEARCH_CBACK *p_cback, BOOLEAN sdp_search);
2194
2195 /*******************************************************************************
2196 **
2197 ** Function         BTA_DmDiscoverByTransport
2198 **
2199 ** Description      This function does service discovery on particular transport
2200 **                  for services of a
2201 **                  peer device. When services.num_uuid is 0, it indicates all
2202 **                  GATT based services are to be searched; other wise a list of
2203 **                  UUID of interested services should be provided through
2204 **                  p_services->p_uuid.
2205 **
2206 **
2207 **
2208 ** Returns          void
2209 **
2210 *******************************************************************************/
2211 BTA_API extern void BTA_DmDiscoverByTransport(BD_ADDR bd_addr, tBTA_SERVICE_MASK_EXT *p_services,
2212                                               tBTA_DM_SEARCH_CBACK *p_cback, BOOLEAN sdp_search,
2213                                               tBTA_TRANSPORT transport);
2214
2215 /*******************************************************************************
2216 **
2217 ** Function         BTA_DmSetEncryption
2218 **
2219 ** Description      This function is called to ensure that connection is
2220 **                  encrypted.  Should be called only on an open connection.
2221 **                  Typically only needed for connections that first want to
2222 **                  bring up unencrypted links, then later encrypt them.
2223 **
2224 ** Parameters:      bd_addr       - Address of the peer device
2225 **                  transport     - transport of the link to be encruypted
2226 **                  p_callback    - Pointer to callback function to indicat the
2227 **                                  link encryption status
2228 **                  sec_act       - This is the security action to indicate
2229 **                                  what knid of BLE security level is required for
2230 **                                  the BLE link if the BLE is supported
2231 **                                  Note: This parameter is ignored for the BR/EDR link
2232 **                                        or the BLE is not supported
2233 **
2234 ** Returns          void
2235 **
2236 **
2237 *******************************************************************************/
2238 BTA_API extern void BTA_DmSetEncryption(BD_ADDR bd_addr, tBTA_TRANSPORT transport,
2239                                         tBTA_DM_ENCRYPT_CBACK *p_callback,
2240                                          tBTA_DM_BLE_SEC_ACT sec_act);
2241
2242
2243 /*******************************************************************************
2244 **
2245 ** Function         BTA_DmBleObserve
2246 **
2247 ** Description      This procedure keep the device listening for advertising
2248 **                  events from a broadcast device.
2249 **
2250 ** Parameters       start: start or stop observe.
2251 **                  duration : Duration of the scan. Continuous scan if 0 is passed
2252 **                  p_results_cb: Callback to be called with scan results
2253 **
2254 ** Returns          void
2255 **
2256 *******************************************************************************/
2257 BTA_API extern void BTA_DmBleObserve(BOOLEAN start, UINT8 duration,
2258                                            tBTA_DM_SEARCH_CBACK *p_results_cb);
2259
2260
2261 #endif
2262
2263 // btla-specific ++
2264 /*******************************************************************************
2265 **
2266 ** Function         BTA_DmSetAfhChannelAssessment
2267 **
2268 ** Description      This function is called to set the channel assessment mode on or off
2269 **
2270 ** Returns          status
2271 **
2272 *******************************************************************************/
2273 BTA_API extern void BTA_DmSetAfhChannelAssessment (BOOLEAN enable_or_disable);
2274
2275 #if BLE_INCLUDED == TRUE
2276 // btla-specific --
2277 /*******************************************************************************
2278 **
2279 ** Function         BTA_DmBleConfigLocalPrivacy
2280 **
2281 ** Description      Enable/disable privacy on the local device
2282 **
2283 ** Parameters:      privacy_enable   - enable/disabe privacy on remote device.
2284 **
2285 ** Returns          void
2286 **
2287 *******************************************************************************/
2288 BTA_API extern void BTA_DmBleConfigLocalPrivacy(BOOLEAN privacy_enable);
2289
2290 /*******************************************************************************
2291 **
2292 ** Function         BTA_DmBleEnableRemotePrivacy
2293 **
2294 ** Description      Enable/disable privacy on a remote device
2295 **
2296 ** Parameters:      bd_addr          - BD address of the peer
2297 **                  privacy_enable   - enable/disabe privacy on remote device.
2298 **
2299 ** Returns          void
2300 **
2301 *******************************************************************************/
2302 BTA_API extern void BTA_DmBleEnableRemotePrivacy(BD_ADDR bd_addr, BOOLEAN privacy_enable);
2303
2304
2305 /*******************************************************************************
2306 **
2307 ** Function         BTA_DmBleSetAdvConfig
2308 **
2309 ** Description      This function is called to override the BTA default ADV parameters.
2310 **
2311 ** Parameters       Pointer to User defined ADV data structure
2312 **
2313 ** Returns          None
2314 **
2315 *******************************************************************************/
2316 BTA_API extern void BTA_DmBleSetAdvConfig (tBTA_BLE_AD_MASK data_mask,
2317                                            tBTA_BLE_ADV_DATA *p_adv_cfg,
2318                                            tBTA_SET_ADV_DATA_CMPL_CBACK *p_adv_data_cback);
2319
2320 /*******************************************************************************
2321 **
2322 ** Function         BTA_DmBleSetScanRsp
2323 **
2324 ** Description      This function is called to override the BTA scan response.
2325 **
2326 ** Parameters       Pointer to User defined ADV data structure
2327 **
2328 ** Returns          None
2329 **
2330 *******************************************************************************/
2331 BTA_API extern void BTA_DmBleSetScanRsp (tBTA_BLE_AD_MASK data_mask,
2332                                          tBTA_BLE_ADV_DATA *p_adv_cfg,
2333                                          tBTA_SET_ADV_DATA_CMPL_CBACK *p_adv_data_cback);
2334
2335 /*******************************************************************************
2336 **
2337 ** Function         BTA_DmBleBroadcast
2338 **
2339 ** Description      This function starts or stops LE broadcasting.
2340 **
2341 ** Parameters       start: start or stop broadcast.
2342 **
2343 ** Returns          None
2344 **
2345 *******************************************************************************/
2346 BTA_API extern void BTA_DmBleBroadcast (BOOLEAN start);
2347
2348
2349 /*******************************************************************************
2350 **
2351 ** Function         BTA_BleEnableAdvInstance
2352 **
2353 ** Description      This function enables the Multi ADV instance feature
2354 **
2355 ** Parameters       p_params Pointer to ADV param user defined structure
2356 **                  p_cback  Pointer to Multi ADV callback structure
2357 **                  p_ref - Reference pointer
2358 **
2359 ** Returns          None
2360 **
2361 *******************************************************************************/
2362 BTA_API extern void BTA_BleEnableAdvInstance (tBTA_BLE_ADV_PARAMS *p_params,
2363                                 tBTA_BLE_MULTI_ADV_CBACK *p_cback,void *p_ref);
2364
2365 /*******************************************************************************
2366 **
2367 ** Function         BTA_BleUpdateAdvInstParam
2368 **
2369 ** Description      This function updates the Multi ADV instance params
2370 **
2371 ** Parameters       inst_id Instance ID
2372 **                  p_params Pointer to ADV param user defined structure
2373 **
2374 ** Returns          None
2375 **
2376 *******************************************************************************/
2377 BTA_API extern void BTA_BleUpdateAdvInstParam (UINT8 inst_id,
2378                                 tBTA_BLE_ADV_PARAMS *p_params);
2379
2380 /*******************************************************************************
2381 **
2382 ** Function         BTA_BleCfgAdvInstData
2383 **
2384 ** Description      This function is called to configure the ADV instance data
2385 **
2386 ** Parameters       inst_id - Instance ID
2387 **                  is_scan_rsp - Boolean value Scan response
2388 **                  Pointer to User defined ADV data structure
2389 ** Returns          None
2390 **
2391 *******************************************************************************/
2392 BTA_API extern void BTA_BleCfgAdvInstData (UINT8 inst_id, BOOLEAN is_scan_rsp,
2393                                 tBTA_BLE_AD_MASK data_mask, tBTA_BLE_ADV_DATA *p_data);
2394
2395 /*******************************************************************************
2396 **
2397 ** Function         BTA_BleDisableAdvInstance
2398 **
2399 ** Description      This function is called to disable the ADV instance
2400 **
2401 ** Parameters       inst_id - Instance ID to be disabled
2402 **
2403 ** Returns          None
2404 **
2405 *******************************************************************************/
2406 BTA_API extern void BTA_BleDisableAdvInstance(UINT8 inst_id);
2407
2408 /*******************************************************************************
2409 **
2410 ** Function         BTA_DmBleUpdateConnectionParams
2411 **
2412 ** Description      Update connection parameters, can only be used when connection is up.
2413 **
2414 ** Parameters:      bd_addr   - BD address of the peer
2415 **                  min_int   -     minimum connection interval, [0x0004~ 0x4000]
2416 **                  max_int   -     maximum connection interval, [0x0004~ 0x4000]
2417 **                  latency   -     slave latency [0 ~ 500]
2418 **                  timeout   -     supervision timeout [0x000a ~ 0xc80]
2419 **
2420 ** Returns          void
2421 **
2422 *******************************************************************************/
2423 BTA_API extern void BTA_DmBleUpdateConnectionParams(BD_ADDR bd_addr, UINT16 min_int,
2424                                    UINT16 max_int, UINT16 latency, UINT16 timeout);
2425
2426 /*******************************************************************************
2427 **
2428 ** Function         BTA_DmBleSetStorageParams
2429 **
2430 ** Description      This function is called to set the storage parameters
2431 **
2432 ** Parameters       batch_scan_full_max -Max storage space (in %) allocated to full scanning
2433 **                  batch_scan_trunc_max -Max storage space (in %) allocated to truncated scanning
2434 **                  batch_scan_notify_threshold - Setup notification level based on total space
2435 **                  consumed by both pools. Setting it to 0 will disable threshold notification
2436 **                  p_setup_cback - Setup callback
2437 **                  p_thres_cback - Threshold callback
2438 **                  p_rep_cback - Reports callback
2439 **                  ref_value - Reference value
2440 **
2441 ** Returns           None
2442 **
2443 *******************************************************************************/
2444 BTA_API extern void BTA_DmBleSetStorageParams(UINT8 batch_scan_full_max,
2445                                          UINT8 batch_scan_trunc_max,
2446                                          UINT8 batch_scan_notify_threshold,
2447                                          tBTA_BLE_SCAN_SETUP_CBACK *p_setup_cback,
2448                                          tBTA_BLE_SCAN_THRESHOLD_CBACK *p_thres_cback,
2449                                          tBTA_BLE_SCAN_REP_CBACK* p_rep_cback,
2450                                          tBTA_DM_BLE_REF_VALUE ref_value);
2451
2452 /*******************************************************************************
2453 **
2454 ** Function         BTA_DmBleEnableBatchScan
2455 **
2456 ** Description      This function is called to enable the batch scan
2457 **
2458 ** Parameters       scan_mode -Batch scan mode
2459 **                  scan_interval - Scan interval
2460 **                  scan_window - Scan window
2461 **                  discard_rule -Discard rules
2462 **                  addr_type - Address type
2463 **                  ref_value - Reference value
2464 **
2465 ** Returns           None
2466 **
2467 *******************************************************************************/
2468 BTA_API extern void BTA_DmBleEnableBatchScan(tBTA_BLE_SCAN_MODE scan_mode,
2469                                          UINT32 scan_interval, UINT32 scan_window,
2470                                          tBTA_BLE_DISCARD_RULE discard_rule,
2471                                          tBLE_ADDR_TYPE        addr_type,
2472                                          tBTA_DM_BLE_REF_VALUE ref_value);
2473
2474 /*******************************************************************************
2475 **
2476 ** Function         BTA_DmBleReadScanReports
2477 **
2478 ** Description      This function is called to read the batch scan reports
2479 **
2480 ** Parameters       scan_mode -Batch scan mode
2481 **                  ref_value - Reference value
2482 **
2483 ** Returns          None
2484 **
2485 *******************************************************************************/
2486 BTA_API extern void BTA_DmBleReadScanReports(tBTA_BLE_SCAN_MODE scan_type,
2487                                              tBTA_DM_BLE_REF_VALUE ref_value);
2488
2489 /*******************************************************************************
2490 **
2491 ** Function         BTA_DmBleDisableBatchScan
2492 **
2493 ** Description      This function is called to disable the batch scanning
2494 **
2495 ** Parameters       ref_value - Reference value
2496 **
2497 ** Returns          None
2498 **
2499 *******************************************************************************/
2500 BTA_API extern void BTA_DmBleDisableBatchScan(tBTA_DM_BLE_REF_VALUE ref_value);
2501
2502 /*******************************************************************************
2503 **
2504 ** Function         BTA_DmEnableScanFilter
2505 **
2506 ** Description      This function is called to enable the adv data payload filter
2507 **
2508 ** Parameters       action - enable or disable the APCF feature
2509 **                  p_cmpl_cback - Command completed callback
2510 **                  ref_value - Reference value
2511 **
2512 ** Returns          void
2513 **
2514 *******************************************************************************/
2515 BTA_API extern void BTA_DmEnableScanFilter(UINT8 action,
2516                                         tBTA_DM_BLE_PF_STATUS_CBACK *p_cmpl_cback,
2517                                         tBTA_DM_BLE_REF_VALUE ref_value);
2518
2519 /*******************************************************************************
2520 **
2521 ** Function         BTA_DmBleScanFilterSetup
2522 **
2523 ** Description      This function is called to setup the filter params
2524 **
2525 ** Parameters       p_target: enable the filter condition on a target device; if NULL
2526 **                  filt_index - Filter index
2527 **                  p_filt_params -Filter parameters
2528 **                  ref_value - Reference value
2529 **                  action - Add, delete or clear
2530 **                  p_cmpl_back - Command completed callback
2531 **
2532 ** Returns          void
2533 **
2534 *******************************************************************************/
2535 BTA_API extern void BTA_DmBleScanFilterSetup(UINT8 action,
2536                                                    tBTA_DM_BLE_PF_FILT_INDEX filt_index,
2537                                                    tBTA_DM_BLE_PF_FILT_PARAMS *p_filt_params,
2538                                                    tBLE_BD_ADDR *p_target,
2539                                                    tBTA_DM_BLE_PF_PARAM_CBACK *p_cmpl_cback,
2540                                                    tBTA_DM_BLE_REF_VALUE ref_value);
2541
2542 /*******************************************************************************
2543 **
2544 ** Function         BTA_DmBleCfgFilterCondition
2545 **
2546 ** Description      This function is called to configure the adv data payload filter
2547 **                  condition.
2548 **
2549 ** Parameters       action: to read/write/clear
2550 **                  cond_type: filter condition type
2551 **                  filt_index - Filter index
2552 **                  p_cond: filter condition parameter
2553 **                  p_cmpl_back - Command completed callback
2554 **                  ref_value - Reference value
2555 **
2556 ** Returns          void
2557 **
2558 *******************************************************************************/
2559 BTA_API extern void BTA_DmBleCfgFilterCondition(tBTA_DM_BLE_SCAN_COND_OP action,
2560                                                  tBTA_DM_BLE_PF_COND_TYPE cond_type,
2561                                                  tBTA_DM_BLE_PF_FILT_INDEX filt_index,
2562                                                  tBTA_DM_BLE_PF_COND_PARAM *p_cond,
2563                                                  tBTA_DM_BLE_PF_CFG_CBACK *p_cmpl_cback,
2564                                                  tBTA_DM_BLE_REF_VALUE ref_value);
2565
2566
2567 /*******************************************************************************
2568 **
2569 ** Function         BTA_DmBleTrackAdvertiser
2570 **
2571 ** Description      This function is called to track the advertiser
2572 **
2573 ** Parameters    ref_value - Reference value
2574 **               p_track_adv_cback - ADV callback
2575 **
2576 ** Returns          None
2577 **
2578 *******************************************************************************/
2579 BTA_API extern void BTA_DmBleTrackAdvertiser(tBTA_DM_BLE_REF_VALUE ref_value,
2580                             tBTA_BLE_TRACK_ADV_CBACK *p_track_adv_cback);
2581
2582 /*******************************************************************************
2583 **
2584 ** Function         BTA_DmBleGetEnergyInfo
2585 **
2586 ** Description      This function is called to obtain the energy info
2587 **
2588 ** Parameters       p_cmpl_cback - Command complete callback
2589 **
2590 ** Returns          void
2591 **
2592 *******************************************************************************/
2593 BTA_API extern void BTA_DmBleGetEnergyInfo(tBTA_BLE_ENERGY_INFO_CBACK *p_cmpl_cback);
2594
2595 /*******************************************************************************
2596 **
2597 ** Function         BTA_BrcmInit
2598 **
2599 ** Description      This function initializes Broadcom specific VS handler in BTA
2600 **
2601 ** Returns          void
2602 **
2603 *******************************************************************************/
2604 BTA_API extern void BTA_VendorInit  (void);
2605
2606 /*******************************************************************************
2607 **
2608 ** Function         BTA_BrcmCleanup
2609 **
2610 ** Description      This function frees up Broadcom specific VS specific dynamic memory
2611 **
2612 ** Returns          void
2613 **
2614 *******************************************************************************/
2615 BTA_API extern void BTA_VendorCleanup (void);
2616
2617 #endif
2618
2619 #ifdef __cplusplus
2620 }
2621 #endif
2622
2623 #endif /* BTA_API_H */
2624