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