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