btm_api.h revision 57f6508cf7b22788fa2e7a739cec241b785718fb
15738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/****************************************************************************** 25738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project * 35738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project * Copyright (C) 1999-2012 Broadcom Corporation 45738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project * 55738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 65738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project * you may not use this file except in compliance with the License. 75738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project * You may obtain a copy of the License at: 85738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project * 95738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 105738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project * 115738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 125738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 135738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 145738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project * See the License for the specific language governing permissions and 155738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project * limitations under the License. 165738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project * 175738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project ******************************************************************************/ 185738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 195738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/****************************************************************************** 205738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project * 215738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project * This file contains the Bluetooth Manager (BTM) API function external 225738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project * definitions. 235738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project * 245738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project ******************************************************************************/ 255738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project#ifndef BTM_API_H 265738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project#define BTM_API_H 275738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 285738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project#include "bt_target.h" 2957f6508cf7b22788fa2e7a739cec241b785718fbMudumba Ananth#include "device/include/esco_parameters.h" 3057f6508cf7b22788fa2e7a739cec241b785718fbMudumba Ananth#include "hcimsgs.h" 31911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson#include "sdp_api.h" 325738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 335738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project#include "smp_api.h" 343d6accfcc0bdc5c7a8713320c9bb069cbf253348Bryce Lee 35dc3c1f2afa2d5f311c3ea42bda432089a7f303a4Jakub Pawlowski#include "btm_api_types.h" 36dc3c1f2afa2d5f311c3ea42bda432089a7f303a4Jakub Pawlowski 375738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/***************************************************************************** 38ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * DEVICE CONTROL and COMMON 39ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ****************************************************************************/ 40e5ba8841cd39e17c05aeb4ab65b5b761d41577daSatya Calloji 415738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/***************************************************************************** 42ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * EXTERNAL FUNCTION DECLARATIONS 43ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ****************************************************************************/ 445738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 455738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/***************************************************************************** 46ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * DEVICE CONTROL and COMMON FUNCTIONS 47ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ****************************************************************************/ 48ee96a3c60fca590d38025925c072d264e06493c4Myles Watson 49ee96a3c60fca590d38025925c072d264e06493c4Myles Watson/******************************************************************************* 50ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 51ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_DeviceReset 52ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 539ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description This function is called to reset the controller. The 549ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Callback function if provided is called when startup of the 559ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * device has completed. 56ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 57ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 58ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 59ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 60911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern void BTM_DeviceReset(tBTM_CMPL_CB* p_cb); 615738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 625738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 63ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 64ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_IsDeviceUp 65ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 66ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to check if the device is up. 67ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 68ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true if device is up, else false 69ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 70ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 71911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern bool BTM_IsDeviceUp(void); 725738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 735738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 74ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 75ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetLocalDeviceName 76ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 77ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to set the local device name. 78ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 79ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if successful, otherwise an error 80ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 81ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 82911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_SetLocalDeviceName(char* p_name); 835738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 845738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 85ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 86ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetDeviceClass 87ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 88ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to set the local device class 89ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 90ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successful, otherwise an error 91ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 92ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 93911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_SetDeviceClass(DEV_CLASS dev_class); 945738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 955738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 96ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 97ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadLocalDeviceName 98ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 99ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to read the local device name. 100ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 101ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns status of the operation 102ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * If success, BTM_SUCCESS is returned and p_name points stored 103ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * local device name 104ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * If BTM doesn't store local device name, BTM_NO_RESOURCES is 105ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * is returned and p_name is set to NULL 106ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 107ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 108911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_ReadLocalDeviceName(char** p_name); 1095738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 1105738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 111ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 112ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadLocalDeviceNameFromController 113ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 114ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Get local device name from controller. Do not use cached 115ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * name (used to get chip-id prior to btm reset complete). 116ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 117ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if successful, otherwise an error 118ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 119ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 120911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_ReadLocalDeviceNameFromController( 121911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_CMPL_CB* p_rln_cmpl_cback); 1225738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 1235738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 124ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 125ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadDeviceClass 126ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 127ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to read the local device class 128ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 129ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns pointer to the device class 130ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 131ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 132911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern uint8_t* BTM_ReadDeviceClass(void); 1335738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 1345738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 135ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 136ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadLocalFeatures 137ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 138ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to read the local features 139ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 140ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns pointer to the local features string 141ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 142ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 143911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern uint8_t* BTM_ReadLocalFeatures(void); 1445738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 1455738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 146ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 147ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_RegisterForDeviceStatusNotif 148ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 149ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to register for device status 150ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * change notifications. 151ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1529ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Returns pointer to previous caller's callback function or NULL if 1539ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * first registration. 154ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 155ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 156911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_DEV_STATUS_CB* BTM_RegisterForDeviceStatusNotif( 157911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_DEV_STATUS_CB* p_cb); 1585738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 1595738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 160ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 161ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_RegisterForVSEvents 162ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 163ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to register/deregister for vendor 164ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * specific HCI events. 165ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 166ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * If is_register=true, then the function will be registered; 1679ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * otherwise the function will be deregistered. 168ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 169ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successful, 170ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_BUSY if maximum number of callbacks have already been 171ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * registered. 172ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 173ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 174911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_RegisterForVSEvents(tBTM_VS_EVT_CB* p_cb, 175911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson bool is_register); 1765738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 1775738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 178ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 179ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_VendorSpecificCommand 180ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 181ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Send a vendor specific HCI command to the controller. 182ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 183ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 184911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern void BTM_VendorSpecificCommand(uint16_t opcode, uint8_t param_len, 185911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint8_t* p_param_buf, 186911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_VSC_CMPL_CB* p_cb); 1875738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 1885738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 189ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 190ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_AllocateSCN 191ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 192ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Look through the Server Channel Numbers for a free one to be 193ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * used with an RFCOMM connection. 194ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 195ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns Allocated SCN number or 0 if none. 196ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 197ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 198d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern uint8_t BTM_AllocateSCN(void); 1995738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 2005738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 201ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 202ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_TryAllocateSCN 203ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 204ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Try to allocate a fixed server channel 205ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 206ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns Returns true if server channel was available 207ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 208ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 209911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern bool BTM_TryAllocateSCN(uint8_t scn); 2105738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 2115738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 212ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 213ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_FreeSCN 214ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 215ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Free the specified SCN. 216ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 217ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true if successful, false if SCN is not in use or invalid 218ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 219ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 220911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern bool BTM_FreeSCN(uint8_t scn); 2215738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 2225738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 223ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 224ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetTraceLevel 225ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 226ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function sets the trace level for BTM. If called with 227ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * a value of 0xFF, it simply returns the current trace level. 228ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 229ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns The new or current trace level 230ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 231ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 232911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern uint8_t BTM_SetTraceLevel(uint8_t new_level); 2335738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 2345738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 235ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 236ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_WritePageTimeout 237ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 238ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Send HCI Wite Page Timeout. 239ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 240ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 241b6ab9b3af6b8793ff781e0359a78611726ab2300Jakub Pawlowskiextern void BTM_WritePageTimeout(uint16_t timeout); 2425738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 2435738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 244ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 245ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_WriteVoiceSettings 246ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 247ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Send HCI Write Voice Settings command. 248ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * See hcidefs.h for settings bitmask values. 249ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 250ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 251b6ab9b3af6b8793ff781e0359a78611726ab2300Jakub Pawlowskiextern void BTM_WriteVoiceSettings(uint16_t settings); 2525738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 2535738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 254ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 255ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_EnableTestMode 256ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 257ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Send HCI the enable device under test command. 258ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 259ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Note: Controller can only be taken out of this mode by 260ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * resetting the controller. 261ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 262ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns 263ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SUCCESS Command sent. 264ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_NO_RESOURCES If out of resources to send the command. 265ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 266ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 267ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 26824933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_EnableTestMode(void); 2695738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 2709ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson/******************************************************************************* 2719ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * DEVICE DISCOVERY FUNCTIONS - Inquiry, Remote Name, Discovery, Class of Device 2729ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson ******************************************************************************/ 273ee96a3c60fca590d38025925c072d264e06493c4Myles Watson 274ee96a3c60fca590d38025925c072d264e06493c4Myles Watson/******************************************************************************* 275ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 276ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetDiscoverability 277ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 278ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to set the device into or out of 279ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * discoverable mode. Discoverable mode means inquiry 2809ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * scans are enabled. If a value of '0' is entered for window 2819ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * or interval, the default values are used. 282ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 283ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successful 284ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_BUSY if a setting of the filter is already in progress 285ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_NO_RESOURCES if couldn't get a memory pool buffer 286ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ILLEGAL_VALUE if a bad parameter was detected 287ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_WRONG_MODE if the device is not up. 288ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 289ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 290911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_SetDiscoverability(uint16_t inq_mode, uint16_t window, 291911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint16_t interval); 2925738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 2935738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 294ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 295ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadDiscoverability 296ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 297ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to read the current discoverability 298ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * mode of the device. 299ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 300ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Output Params: p_window - current inquiry scan duration 301ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * p_interval - current inquiry scan interval 302ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 303ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_NON_DISCOVERABLE, BTM_LIMITED_DISCOVERABLE, or 304ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_GENERAL_DISCOVERABLE 305ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 306ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 307911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern uint16_t BTM_ReadDiscoverability(uint16_t* p_window, 308911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint16_t* p_interval); 3095738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 3105738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 311ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 312ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetPeriodicInquiryMode 313ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 3149ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description This function is called to set the device periodic inquiry 3159ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * mode. If the duration is zero, the periodic inquiry mode is 3169ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * cancelled. 317ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 318ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: p_inqparms - pointer to the inquiry information 319ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * mode - GENERAL or LIMITED inquiry 3209ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * duration - length in 1.28 sec intervals (If '0', the 3219ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * inquiry is CANCELLED) 3229ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * max_resps - maximum amount of devices to search for 3239ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * before ending the inquiry 3249ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * filter_cond_type - BTM_CLR_INQUIRY_FILTER, 3259ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_FILTER_COND_DEVICE_CLASS, or 326ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_FILTER_COND_BD_ADDR 3279ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * filter_cond - value for the filter (based on 3289ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * filter_cond_type) 329ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 3309ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * max_delay - maximum amount of time between successive 3319ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * inquiries 3329ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * min_delay - minimum amount of time between successive 3339ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * inquiries 3349ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * p_results_cb - callback returning pointer to results 3359ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * (tBTM_INQ_RESULTS) 336ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 337ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if successfully started 338ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ILLEGAL_VALUE if a bad parameter is detected 339ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_NO_RESOURCES if could not allocate a message buffer 340ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SUCCESS - if cancelling the periodic inquiry 341ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_BUSY - if an inquiry is already active 342ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_WRONG_MODE if the device is not up. 343ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 344ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 345911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_SetPeriodicInquiryMode( 346911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_INQ_PARMS* p_inqparms, uint16_t max_delay, uint16_t min_delay, 347911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_INQ_RESULTS_CB* p_results_cb); 3485738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 3495738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 350ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 351ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_StartInquiry 352ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 353ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to start an inquiry. 354ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 355ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: p_inqparms - pointer to the inquiry information 356ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * mode - GENERAL or LIMITED inquiry 3579ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * duration - length in 1.28 sec intervals (If '0', the 3589ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * inquiry is CANCELLED) 3599ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * max_resps - maximum amount of devices to search for 3609ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * before ending the inquiry 3619ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * filter_cond_type - BTM_CLR_INQUIRY_FILTER, 3629ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_FILTER_COND_DEVICE_CLASS, or 363ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_FILTER_COND_BD_ADDR 3649ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * filter_cond - value for the filter (based on 3659ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * filter_cond_type) 3669ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * 3679ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * p_results_cb - Pointer to the callback routine which gets 3689ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * called upon receipt of an inquiry result. If 3699ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * this field is NULL, the application is not 3709ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * notified. 3719ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * 3729ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * p_cmpl_cb - Pointer to the callback routine which gets 3739ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * called upon completion. If this field is 3749ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * NULL, the application is not notified when 3759ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * completed. 376ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns tBTM_STATUS 377ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_CMD_STARTED if successfully initiated 378ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_BUSY if already in progress 379ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ILLEGAL_VALUE if parameter(s) are out of range 3809ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_NO_RESOURCES if could not allocate resources to start 3819ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * the command 382ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_WRONG_MODE if the device is not up. 383ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 384ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 385911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_StartInquiry(tBTM_INQ_PARMS* p_inqparms, 386911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_INQ_RESULTS_CB* p_results_cb, 387911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_CMPL_CB* p_cmpl_cb); 3885738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 3895738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 390ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 391ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_IsInquiryActive 392ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 3939ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description Return a bit mask of the current inquiry state 394ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 395ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_INQUIRY_INACTIVE if inactive (0) 396ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_LIMITED_INQUIRY_ACTIVE if a limted inquiry is active 397ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_GENERAL_INQUIRY_ACTIVE if a general inquiry is active 398ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_PERIODIC_INQUIRY_ACTIVE if a periodic inquiry is active 399ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 400ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 401911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern uint16_t BTM_IsInquiryActive(void); 4025738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 4035738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 404ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 405ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_CancelInquiry 406ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 407ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function cancels an inquiry if active 408ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 409ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successful 410ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_NO_RESOURCES if could not allocate a message buffer 411ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_WRONG_MODE if the device is not up. 412ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 413ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 41424933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_CancelInquiry(void); 4155738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 4165738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 417ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 418ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_CancelPeriodicInquiry 419ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 420ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function cancels a periodic inquiry 421ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 422ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns 423ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_NO_RESOURCES if could not allocate a message buffer 424ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SUCCESS - if cancelling the periodic inquiry 425ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_WRONG_MODE if the device is not up. 426ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 427ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 42824933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_CancelPeriodicInquiry(void); 4295738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 4305738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 431ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 432ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetConnectability 433ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 434ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to set the device into or out of 4359ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * connectable mode. Discoverable mode means page scans are 4369ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * enabled. 437ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 438ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successful 439ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ILLEGAL_VALUE if a bad parameter is detected 440ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_NO_RESOURCES if could not allocate a message buffer 441ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_WRONG_MODE if the device is not up. 442ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 443ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 444911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_SetConnectability(uint16_t page_mode, uint16_t window, 445911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint16_t interval); 4465738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 4475738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 448ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 449ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadConnectability 450ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 451ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to read the current discoverability 452ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * mode of the device. 453ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Output Params p_window - current page scan duration 454ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * p_interval - current time between page scans 455ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 456ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_NON_CONNECTABLE or BTM_CONNECTABLE 457ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 458ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 459911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern uint16_t BTM_ReadConnectability(uint16_t* p_window, 460911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint16_t* p_interval); 4615738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 4625738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 463ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 464ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetInquiryMode 465ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 466ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to set standard, with RSSI 467ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * mode or extended of the inquiry for local device. 468ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 469ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Input Params: BTM_INQ_RESULT_STANDARD, BTM_INQ_RESULT_WITH_RSSI or 470ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_INQ_RESULT_EXTENDED 471ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 472ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successful 473ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_NO_RESOURCES if couldn't get a memory pool buffer 474ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ILLEGAL_VALUE if a bad parameter was detected 475ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_WRONG_MODE if the device is not up. 476ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 477ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 478911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_SetInquiryMode(uint8_t mode); 4795738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 4805738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 481ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 482ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetInquiryScanType 483ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 484ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to set the iquiry scan-type to 485ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * standard or interlaced. 486ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 487ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Input Params: BTM_SCAN_TYPE_STANDARD or BTM_SCAN_TYPE_INTERLACED 488ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 489ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successful 490ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_MODE_UNSUPPORTED if not a 1.2 device 491ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_WRONG_MODE if the device is not up. 492ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 493ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 494911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_SetInquiryScanType(uint16_t scan_type); 4955738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 4965738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 497ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 498ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetPageScanType 499ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 500ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to set the page scan-type to 501ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * standard or interlaced. 502ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 503ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Input Params: BTM_SCAN_TYPE_STANDARD or BTM_SCAN_TYPE_INTERLACED 504ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 505ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successful 506ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_MODE_UNSUPPORTED if not a 1.2 device 507ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_WRONG_MODE if the device is not up. 508ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 509ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 5105738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 511911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_SetPageScanType(uint16_t scan_type); 5125738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 5135738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 514ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 515ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadRemoteDeviceName 516ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 517ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function initiates a remote device HCI command to the 5189ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * controller and calls the callback when the process has 5199ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * completed. 520ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 521ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Input Params: remote_bda - device address of name to retrieve 5229ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * p_cb - callback function called when 5239ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_CMD_STARTED is returned. 5249ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * A pointer to tBTM_REMOTE_DEV_NAME is 5259ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * passed to the callback. 526ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 527ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns 5289ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_CMD_STARTED is returned if the request was successfully 5299ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * sent to HCI. 530ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_BUSY if already in progress 531ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if device address is bad 5329ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_NO_RESOURCES if resources could not be allocated to 5339ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * start the command 534ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_WRONG_MODE if the device is not up. 535ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 536ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 537911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_ReadRemoteDeviceName(BD_ADDR remote_bda, 538911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_CMPL_CB* p_cb, 539911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBT_TRANSPORT transport); 5405738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 5415738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 542ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 543ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_CancelRemoteDeviceName 544ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 545ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function initiates the cancel request for the specified 546ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * remote device. 547ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 548ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Input Params: None 549ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 550ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns 5519ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_CMD_STARTED is returned if the request was successfully 5529ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * sent to HCI. 5539ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_NO_RESOURCES if resources could not be allocated to 5549ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * start the command 5559ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_WRONG_MODE if there is no active remote name request. 556ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 557ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 558911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_CancelRemoteDeviceName(void); 5595738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 5605738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 561ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 562ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadRemoteVersion 563ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 564ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to read a remote device's version 565ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 566ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successful, otherwise an error 567ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 568ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 569911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_ReadRemoteVersion(BD_ADDR addr, uint8_t* lmp_version, 570911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint16_t* manufacturer, 571911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint16_t* lmp_sub_version); 5725738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 5735738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 574ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 575ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadRemoteFeatures 576ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 577ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to read a remote device's 578ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * supported features mask (features mask located at page 0) 579ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 580ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Note: The size of device features mask page is 581ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_FEATURE_BYTES_PER_PAGE bytes. 582ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 583ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns pointer to the remote supported features mask 584ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 585ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 586911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern uint8_t* BTM_ReadRemoteFeatures(BD_ADDR addr); 5875738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 5885738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 589ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 590ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadRemoteExtendedFeatures 591ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 592ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to read a specific extended features 593ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * page of the remote device 594ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 595ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Note1: The size of device features mask page is 596ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_FEATURE_BYTES_PER_PAGE bytes. 597ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Note2: The valid device features mask page number depends on 598ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * the remote device capabilities. It is expected to be in the 599ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * range [0 - BTM_EXT_FEATURES_PAGE_MAX]. 600ee96a3c60fca590d38025925c072d264e06493c4Myles Watson 601ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns pointer to the remote extended features mask 602ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * or NULL if page_number is not valid 603ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 604ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 605911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern uint8_t* BTM_ReadRemoteExtendedFeatures(BD_ADDR addr, 606911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint8_t page_number); 6073aa60544585b5fb0f35c1165539a4a859fc0f25cAndre Eisenbach 6083aa60544585b5fb0f35c1165539a4a859fc0f25cAndre Eisenbach/******************************************************************************* 609ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 610ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadNumberRemoteFeaturesPages 611ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 6129ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description This function is called to retrieve the number of feature 6139ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * pages read from the remote device 614ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 615ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns number of features pages read from the remote device 616ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 617ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 618911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern uint8_t BTM_ReadNumberRemoteFeaturesPages(BD_ADDR addr); 6193aa60544585b5fb0f35c1165539a4a859fc0f25cAndre Eisenbach 6203aa60544585b5fb0f35c1165539a4a859fc0f25cAndre Eisenbach/******************************************************************************* 621ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 622ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadAllRemoteFeatures 623ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 6249ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description Read all the features of the remote device 625ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 626ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns pointer to the byte[0] of the page[0] of the remote device 627ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * feature mask. 628ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 629ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Note: the function returns the pointer to the array of the size 6309ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_FEATURE_BYTES_PER_PAGE * (BTM_EXT_FEATURES_PAGE_MAX + 1) 631ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 632ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 633911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern uint8_t* BTM_ReadAllRemoteFeatures(BD_ADDR addr); 6343aa60544585b5fb0f35c1165539a4a859fc0f25cAndre Eisenbach 6353aa60544585b5fb0f35c1165539a4a859fc0f25cAndre Eisenbach/******************************************************************************* 636ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 637ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_InqDbRead 638ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 639ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function looks through the inquiry database for a match 640ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * based on Bluetooth Device Address. This is the application's 6419ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * interface to get the inquiry details of a specific BD 6429ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * address. 643ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 644ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns pointer to entry, or NULL if not found 645ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 646ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 647911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_INQ_INFO* BTM_InqDbRead(const BD_ADDR p_bda); 6485738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 6495738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 650ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 651ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_InqDbFirst 652ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 6539ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description This function looks through the inquiry database for the 6549ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * first used entry, and returns that. This is used in 6559ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * conjunction with BTM_InqDbNext by applications as a way to 6569ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * walk through the inquiry database. 657ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 658ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns pointer to first in-use entry, or NULL if DB is empty 659ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 660ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 661911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_INQ_INFO* BTM_InqDbFirst(void); 6625738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 6635738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 664ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 665ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_InqDbNext 666ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 6679ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description This function looks through the inquiry database for the 6689ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * next used entry, and returns that. If the input parameter 6699ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * is NULL, the first entry is returned. 670ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 671ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns pointer to next in-use entry, or NULL if no more found. 672ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 673ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 674911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_INQ_INFO* BTM_InqDbNext(tBTM_INQ_INFO* p_cur); 6755738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 6765738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 677ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 678ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ClearInqDb 679ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 680ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to clear out a device or all devices 681ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * from the inquiry database. 682ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 683ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameter p_bda - (input) BD_ADDR -> Address of device to clear 684ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * (NULL clears all entries) 685ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 686ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_BUSY if an inquiry, get remote name, or event filter 687ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * is active, otherwise BTM_SUCCESS 688ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 689ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 690911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_ClearInqDb(BD_ADDR p_bda); 6915738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 6925738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 693ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 694ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadInquiryRspTxPower 695ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 696ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This command will read the inquiry Transmit Power level used 697ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * to transmit the FHS and EIR data packets. 6989ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * This can be used directly in the Tx Power Level EIR data 6999ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * type. 700ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 701ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successful 702ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 703ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 704911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_ReadInquiryRspTxPower(tBTM_CMPL_CB* p_cb); 7055738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 7065738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 707ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 708ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_StartDiscovery 709ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 710ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called by an application (or profile) 711ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * when it wants to trigger an service discovery using the 712ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM's discovery database. 713ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 714ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns tBTM_STATUS 715ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_CMD_STARTED if the discovery was initiated 716ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_BUSY if one is already in progress 717ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if no addresses are in the INQ DB 718ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ERR_PROCESSING if err initiating the command 719ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 720ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 721911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_StartDiscovery(tBTM_CMPL_CB* p_cmpl_cb, 722911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson BD_ADDR_PTR p_rem_addr); 7235738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 7245738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 725ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 726ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_FindAttribute 727ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 728ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called by an application (or profile) 729ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * when it wants to see if an attribute exists in the BTM 730ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * discovery database. 731ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 732ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns Pointer to matching record, or NULL 733ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 734ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 735911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tSDP_DISC_REC* BTM_FindAttribute(uint16_t attr_id, 736911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tSDP_DISC_REC* p_start_rec); 7375738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 7385738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 739ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 740ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_FindService 741ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 742ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called by an application (or profile) 743ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * when it wants to see if a service exists in the BTM 744ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * discovery database. 745ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 746ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns Pointer to matching record, or NULL 747ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 748ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 749911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tSDP_DISC_REC* BTM_FindService(uint16_t service_uuid, 750911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tSDP_DISC_REC* p_start_rec); 7515738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 7525738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 753ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 754ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetDiscoveryParams 755ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 7569ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description This function is called to set the BTM default discovery 7579ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * parameters. These UUID and attribute filters are used during 7589ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * the call to BTM_StartDiscovery. 759ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 760ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 761ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 762ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 763911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern void BTM_SetDiscoveryParams(uint16_t num_uuid, tSDP_UUID* p_uuid_list, 764911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint16_t num_attr, uint16_t* p_attr_list); 7655738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 7665738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/***************************************************************************** 767ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * ACL CHANNEL MANAGEMENT FUNCTIONS 768ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ****************************************************************************/ 769ee96a3c60fca590d38025925c072d264e06493c4Myles Watson/******************************************************************************* 770ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 771ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetLinkPolicy 772ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 773ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Create and send HCI "Write Policy Set" command 774ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 775ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if successfully initiated, otherwise error 776ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 777ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 778911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_SetLinkPolicy(BD_ADDR remote_bda, uint16_t* settings); 7795738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 7805738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 781ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 782ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetDefaultLinkPolicy 783ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 784ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Set the default value for HCI "Write Policy Set" command 785ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * to use when an ACL link is created. 786ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 787ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 788ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 789ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 790911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern void BTM_SetDefaultLinkPolicy(uint16_t settings); 791ee96a3c60fca590d38025925c072d264e06493c4Myles Watson 7925738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 793ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 794ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetDefaultLinkSuperTout 795ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 7969ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description Set the default value for HCI "Write Link Supervision 7979ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Timeout" command to use when an ACL link is created. 798ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 799ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 800ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 801ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 802911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern void BTM_SetDefaultLinkSuperTout(uint16_t timeout); 8035738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 8045738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 805ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 806ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetLinkSuperTout 807ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 808ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Create and send HCI "Write Link Supervision Timeout" command 809ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 810ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if successfully initiated, otherwise error 811ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 812ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 813911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_SetLinkSuperTout(BD_ADDR remote_bda, uint16_t timeout); 814ead3cde4bac0c3e32cd31f149093f004eef8ceebGanesh Ganapathi Batta/******************************************************************************* 815ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 816ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_GetLinkSuperTout 817ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 818ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Read the link supervision timeout value of the connection 819ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 820ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns status of the operation 821ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 822ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 823911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_GetLinkSuperTout(BD_ADDR remote_bda, 824911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint16_t* p_timeout); 8255738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 8265738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 827ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 828ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_IsAclConnectionUp 829ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 830ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to check if an ACL connection exists 831ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * to a specific remote BD Address. 832ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 833ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true if connection is up, else false. 834ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 835ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 836911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern bool BTM_IsAclConnectionUp(BD_ADDR remote_bda, tBT_TRANSPORT transport); 8375738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 8385738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 839ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 840ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_GetRole 841ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 842ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to get the role of the local device 843ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * for the ACL connection with the specified remote device 844ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 845ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if connection exists. 846ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if no active link with bd addr specified 847ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 848ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 849911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_GetRole(BD_ADDR remote_bd_addr, uint8_t* p_role); 8505738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 8515738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 852ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 853ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SwitchRole 854ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 855ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to switch role between master and 856ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * slave. If role is already set it will do nothing. If the 857ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * command was initiated, the callback function is called upon 858ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * completion. 859ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 860ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if already in specified role. 861ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_CMD_STARTED if command issued to controller. 8629ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_NO_RESOURCES if memory couldn't be allocated to issue 8639ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * the command 864ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if no active link with bd addr specified 8659ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_MODE_UNSUPPORTED if the local device does not support 8669ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * role switching 867ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 868ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 869911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_SwitchRole(BD_ADDR remote_bd_addr, uint8_t new_role, 870911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_CMPL_CB* p_cb); 8715738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 8725738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 873ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 874ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadRSSI 875ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 876ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to read the link policy settings. 8779ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * The address of link policy results are returned in the 8789ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * callback. (tBTM_RSSI_RESULTS) 879ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 880ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if command issued to controller. 8819ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_NO_RESOURCES if memory couldn't be allocated to issue 8829ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * the command 883ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if no active link with bd addr specified 884ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_BUSY if command is already in progress 885ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 886ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 887911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_ReadRSSI(const BD_ADDR remote_bda, tBTM_CMPL_CB* p_cb); 8885738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 8895738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 890ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 891ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadTxPower 892ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 893ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to read the current connection 894ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * TX power of the connection. The TX power level results 895ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * are returned in the callback. 896ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * (tBTM_RSSI_RESULTS) 897ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 898ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if command issued to controller. 8999ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_NO_RESOURCES if memory couldn't be allocated to issue 9009ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * the command 901ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if no active link with bd addr specified 902ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_BUSY if command is already in progress 903ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 904ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 905911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_ReadTxPower(BD_ADDR remote_bda, tBT_TRANSPORT transport, 906911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_CMPL_CB* p_cb); 9075738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 9085738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 909ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 910ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadLinkQuality 911ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 912ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to read the link quality. 913ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * The value of the link quality is returned in the callback. 914ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * (tBTM_LINK_QUALITY_RESULTS) 915ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 916ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if command issued to controller. 9179ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_NO_RESOURCES if memory couldn't be allocated to issue 9189ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * the command 919ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if no active link with bd addr specified 920ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_BUSY if command is already in progress 921ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 922ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 923911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_ReadLinkQuality(BD_ADDR remote_bda, tBTM_CMPL_CB* p_cb); 9245738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 9255738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 926ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 927ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_RegBusyLevelNotif 928ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 929ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to register a callback to receive 930ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * busy level change events. 931ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 932ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successfully registered, otherwise error 933ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 934ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 935911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_RegBusyLevelNotif(tBTM_BL_CHANGE_CB* p_cb, 936911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint8_t* p_level, 937911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_BL_EVENT_MASK evt_mask); 9385738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 9395738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 940ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 941ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_AclRegisterForChanges 942ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 943ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to register a callback to receive 944ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * ACL database change events, i.e. new connection or removed. 945ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 946ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successfully initiated, otherwise error 947ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 948ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 949911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_AclRegisterForChanges(tBTM_ACL_DB_CHANGE_CB* p_cb); 9505738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 9515738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 952ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 953ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_GetNumAclLinks 954ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 955ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to count the number of 956ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * ACL links that are active. 957ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 958ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns uint16_t Number of active ACL links 959ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 960ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 961911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern uint16_t BTM_GetNumAclLinks(void); 9625738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 9635738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 964ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 965ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetQoS 966ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 967ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to setup QoS 968ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 969ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if successfully initiated, otherwise error 970ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 971ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 972911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_SetQoS(BD_ADDR bd, FLOW_SPEC* p_flow, 973911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_CMPL_CB* p_cb); 9745738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 9755738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/***************************************************************************** 976ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * (e)SCO CHANNEL MANAGEMENT FUNCTIONS 977ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ****************************************************************************/ 978ee96a3c60fca590d38025925c072d264e06493c4Myles Watson/******************************************************************************* 979ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 980ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_CreateSco 981ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 982ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to create an SCO connection. If the 983ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * "is_orig" flag is true, the connection will be originated, 984ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * otherwise BTM will wait for the other side to connect. 985ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 986ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_UNKNOWN_ADDR if the ACL connection is not up 987ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_BUSY if another SCO being set up to 988ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * the same BD address 989ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_NO_RESOURCES if the max SCO limit has been reached 990ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_CMD_STARTED if the connection establishment is started. 991ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * In this case, "*p_sco_inx" is filled in 992ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * with the sco index used for the connection. 993ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 994ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 995911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_CreateSco(BD_ADDR remote_bda, bool is_orig, 996911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint16_t pkt_types, uint16_t* p_sco_inx, 997911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_SCO_CB* p_conn_cb, 998911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_SCO_CB* p_disc_cb); 9995738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 10005738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1001ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1002ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_RemoveSco 1003ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1004ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to remove a specific SCO connection. 1005ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1006ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if successfully initiated, otherwise error 1007ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1008ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1009911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_RemoveSco(uint16_t sco_inx); 10105738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 10115738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1012ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1013ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetScoPacketTypes 1014ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1015ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to set the packet types used for 1016ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * a specific SCO connection, 1017ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1018ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters pkt_types - One or more of the following 1019ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_HV1 1020ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_HV2 1021ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_HV3 1022ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_EV3 1023ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_EV4 1024ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_EV5 1025ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1026ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_LINK_ALL_MASK - enables all supported types 1027ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1028ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if successfully initiated, otherwise error 1029ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1030ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1031911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_SetScoPacketTypes(uint16_t sco_inx, uint16_t pkt_types); 10325738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 10335738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1034ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1035ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadScoPacketTypes 1036ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1037ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is read the packet types used for a specific 1038ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * SCO connection. 1039ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1040ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns One or more of the following (bitmask) 1041ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_HV1 1042ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_HV2 1043ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_HV3 1044ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_EV3 1045ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_EV4 1046ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_EV5 1047ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1048ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns packet types supported for the connection 1049ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1050ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1051911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern uint16_t BTM_ReadScoPacketTypes(uint16_t sco_inx); 10525738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 10535738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1054ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1055ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadDeviceScoPacketTypes 1056ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1057ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is read the SCO packet types that 1058ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * the device supports. 1059ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1060ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns packet types supported by the device. 1061ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1062ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1063911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern uint16_t BTM_ReadDeviceScoPacketTypes(void); 10645738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 10655738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1066ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1067ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadScoHandle 1068ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 10699ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description Reead the HCI handle used for a specific SCO connection, 1070ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1071ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns handle for the connection, or 0xFFFF if invalid SCO index. 1072ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1073ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1074911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern uint16_t BTM_ReadScoHandle(uint16_t sco_inx); 10755738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 10765738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1077ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1078ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadScoBdAddr 1079ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1080ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is read the remote BD Address for a specific 1081ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * SCO connection, 1082ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1083ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns pointer to BD address or NULL if not known 1084ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1085ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1086911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern uint8_t* BTM_ReadScoBdAddr(uint16_t sco_inx); 10875738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 10885738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1089ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1090ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadScoDiscReason 1091ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1092ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is returns the reason why an (e)SCO connection 1093ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * has been removed. It contains the value until read, or until 1094ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * another (e)SCO connection has disconnected. 1095ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1096ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns HCI reason or BTM_INVALID_SCO_DISC_REASON if not set. 1097ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1098ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1099911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern uint16_t BTM_ReadScoDiscReason(void); 11005738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 11015738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1102ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1103ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetEScoMode 1104ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1105ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function sets up the negotiated parameters for SCO or 1106ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * eSCO, and sets as the default mode used for calls to 1107ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_CreateSco. It can be called only when there are no 1108ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * active (e)SCO links. 1109ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1110ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if the successful. 1111ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_BUSY if there are one or more active (e)SCO links. 1112ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1113ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 111457f6508cf7b22788fa2e7a739cec241b785718fbMudumba Ananthextern tBTM_STATUS BTM_SetEScoMode(enh_esco_params_t* p_parms); 11155738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 11165738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1117ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1118ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetWBSCodec 1119ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1120ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function sends command to the controller to setup 1121ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * WBS codec for the upcoming eSCO connection. 1122ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1123ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS. 1124ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1125ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1126ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1127911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_SetWBSCodec(tBTM_SCO_CODEC_TYPE codec_type); 11285738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 11295738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1130ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1131ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_RegForEScoEvts 1132ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1133ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function registers a SCO event callback with the 1134ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * specified instance. It should be used to received 1135ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * connection indication events and change of link parameter 1136ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * events. 1137ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1138ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if the successful. 1139ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ILLEGAL_VALUE if there is an illegal sco_inx 1140ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1141ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1142911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_RegForEScoEvts(uint16_t sco_inx, 1143911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_ESCO_CBACK* p_esco_cback); 11445738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 11455738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1146ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1147ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadEScoLinkParms 1148ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1149ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function returns the current eSCO link parameters for 11509ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * the specified handle. This can be called anytime a 11519ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * connection is active, but is typically called after 11529ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * receiving the SCO opened callback. 1153ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1154ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Note: If called over a 1.1 controller, only the packet types 1155ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * field has meaning. 1156ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Note: If the upper layer doesn't know the current sco index, 11579ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_FIRST_ACTIVE_SCO_INDEX can be used as the first 11589ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * parameter to find the first active SCO index 1159ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1160ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if returned data is valid connection. 1161ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ILLEGAL_VALUE if no connection for specified sco_inx. 1162ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_MODE_UNSUPPORTED if local controller does not support 1163ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1.2 specification. 1164ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1165ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1166911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_ReadEScoLinkParms(uint16_t sco_inx, 1167911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_ESCO_DATA* p_parms); 11685738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 11695738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1170ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1171ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ChangeEScoLinkParms 1172ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1173ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function requests renegotiation of the parameters on 1174ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * the current eSCO Link. If any of the changes are accepted 1175ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * by the controllers, the BTM_ESCO_CHG_EVT event is sent in 1176ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * the tBTM_ESCO_CBACK function with the current settings of 1177ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * the link. The callback is registered through the call to 1178ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SetEScoMode. 1179ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1180ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1181ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if command is successfully initiated. 1182ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ILLEGAL_VALUE if no connection for specified sco_inx. 1183ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_NO_RESOURCES - not enough resources to initiate command. 1184ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_MODE_UNSUPPORTED if local controller does not support 1185ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1.2 specification. 1186ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1187ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1188911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_ChangeEScoLinkParms(uint16_t sco_inx, 1189911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_CHG_ESCO_PARAMS* p_parms); 11905738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 11915738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1192ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1193ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_EScoConnRsp 1194ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1195ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called upon receipt of an (e)SCO connection 1196ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * request event (BTM_ESCO_CONN_REQ_EVT) to accept or reject 1197ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * the request. Parameters used to negotiate eSCO links. 1198ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * If p_parms is NULL, then values set through BTM_SetEScoMode 1199ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * are used. 1200ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * If the link type of the incoming request is SCO, then only 1201ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * the tx_bw, max_latency, content format, and packet_types are 1202ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * valid. The hci_status parameter should be 1203ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * ([0x0] to accept, [0x0d..0x0f] to reject) 1204ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1205ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1206ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 1207ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1208ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1209911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern void BTM_EScoConnRsp(uint16_t sco_inx, uint8_t hci_status, 121057f6508cf7b22788fa2e7a739cec241b785718fbMudumba Ananth enh_esco_params_t* p_parms); 12115738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 12125738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1213ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1214ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_GetNumScoLinks 1215ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1216ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function returns the number of active SCO links. 1217ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1218ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns uint8_t 1219ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1220ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1221911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern uint8_t BTM_GetNumScoLinks(void); 12225738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 12235738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/***************************************************************************** 1224ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * SECURITY MANAGEMENT FUNCTIONS 1225ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ****************************************************************************/ 1226ee96a3c60fca590d38025925c072d264e06493c4Myles Watson/******************************************************************************* 1227ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1228ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecRegister 1229ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1230ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Application manager calls this function to register for 12319ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * security services. There can be one and only one 12329ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * application saving link keys. BTM allows only first 12339ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * registration. 1234ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1235ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true if registered OK, else false 1236ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1237ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1238911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern bool BTM_SecRegister(tBTM_APPL_INFO* p_cb_info); 12395738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 1240877123f5b9df90e7a71ea7b15997c521229decc1Satya Calloji/******************************************************************************* 1241ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1242ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecRegisterLinkKeyNotificationCallback 1243ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1244ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Profiles can register to be notified when a new Link Key 1245ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * is generated per connection. 1246ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1247ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true if registered OK, else false 1248ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1249ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1250911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern bool BTM_SecRegisterLinkKeyNotificationCallback( 1251911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_LINK_KEY_CALLBACK* p_callback); 12525738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 12535738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1254ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1255ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecAddRmtNameNotifyCallback 1256ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1257ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Profiles can register to be notified when name of the 12589ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * remote device is resolved (up to 12599ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_SEC_MAX_RMT_NAME_CALLBACKS). 1260ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1261ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true if registered OK, else false 1262ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1263ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1264911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern bool BTM_SecAddRmtNameNotifyCallback(tBTM_RMT_NAME_CALLBACK* p_callback); 12655738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 12665738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1267ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1268ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecDeleteRmtNameNotifyCallback 1269ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1270ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description A profile can deregister notification when a new Link Key 1271ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * is generated per connection. 1272ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1273ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true if OK, else false 1274ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1275ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1276911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern bool BTM_SecDeleteRmtNameNotifyCallback( 1277911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_RMT_NAME_CALLBACK* p_callback); 12785738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 12795738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1280ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1281ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_GetSecurityFlags 1282ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1283ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Get security flags for the device 1284ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1285ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns bool true or false is device found 1286ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1287ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1288911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern bool BTM_GetSecurityFlags(BD_ADDR bd_addr, uint8_t* p_sec_flags); 12895738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 12905738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1291ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1292ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_GetSecurityFlagsByTransport 1293ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1294ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Get security flags for the device on a particular transport 1295ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1296ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters bd_addr: BD address of remote device 12979ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * p_sec_flags : Out parameter to be filled with security 12989ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * flags for the connection 12999ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * transport : Physical transport of the connection 13009ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * (BR/EDR or LE) 1301ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1302ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns bool true or false is device found 1303ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1304ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1305911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern bool BTM_GetSecurityFlagsByTransport(BD_ADDR bd_addr, 1306911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint8_t* p_sec_flags, 1307911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBT_TRANSPORT transport); 13087fa4fba6f59f97df00aff07dbe8fb21b114b3c2cGanesh Ganapathi Batta 13097fa4fba6f59f97df00aff07dbe8fb21b114b3c2cGanesh Ganapathi Batta/******************************************************************************* 1310ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1311ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadTrustedMask 1312ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1313ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Get trusted mask for the device 1314ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1315ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns NULL, if the device record is not found. 1316ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * otherwise, the trusted mask 1317ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1318ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1319911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern uint32_t* BTM_ReadTrustedMask(BD_ADDR bd_addr); 13205738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 13215738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1322ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1323ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetPinType 1324ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1325ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Set PIN type for the device. 1326ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1327ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 1328ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1329ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1330911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern void BTM_SetPinType(uint8_t pin_type, PIN_CODE pin_code, 1331911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint8_t pin_code_len); 13325738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 13335738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1334ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1335ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetPairableMode 1336ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1337ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Enable or disable pairing 1338ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1339ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters allow_pairing - (true or false) whether or not the device 1340ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * allows pairing. 1341ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * connect_only_paired - (true or false) whether or not to 1342ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * only allow paired devices to connect. 1343ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1344ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 1345ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1346ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1347911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern void BTM_SetPairableMode(bool allow_pairing, bool connect_only_paired); 13485738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 13495738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1350ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1351ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetSecureConnectionsOnly 1352ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 13539ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description Enable or disable default treatment for Mode 4 Level 0 13549ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * services 1355ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1356ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameter secure_connections_only_mode - (true or false) 13579ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * true means that the device should treat Mode 4 Level 0 13589ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * services as services of other levels. 13599ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * false means that the device should provide default 13609ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * treatment for Mode 4 Level 0 services. 1361ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1362ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 1363ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1364ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1365911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern void BTM_SetSecureConnectionsOnly(bool secure_connections_only_mode); 1366899b77140675a157dba034e98527ab546bc9ac35Mudumba Ananth 1367899b77140675a157dba034e98527ab546bc9ac35Mudumba Ananth/******************************************************************************* 1368ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1369ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetSecurityLevel 1370ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1371ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Register service security level with Security Manager. Each 1372ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * service must register its requirements regardless of the 13739ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * security level that is used. This API is called once for 13749ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * originators and again for acceptors of connections. 1375ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1376ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true if registered OK, else false 1377ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1378ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1379911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern bool BTM_SetSecurityLevel(bool is_originator, const char* p_name, 1380911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint8_t service_id, uint16_t sec_level, 1381911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint16_t psm, uint32_t mx_proto_id, 1382911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint32_t mx_chan_id); 13835738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 13845738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1385ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1386ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetOutService 1387ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1388ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to set the service for 1389ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * outgoing connection. 1390ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1391ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 1392ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1393ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1394911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern void BTM_SetOutService(BD_ADDR bd_addr, uint8_t service_id, 1395911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint32_t mx_chan_id); 13965738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 13975738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1398ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1399ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecClrService 1400ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 14019ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description Removes specified service record(s) from the security 14029ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * database. All service records with the specified name are 14039ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * removed. Typically used only by devices with limited RAM 14049ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * so that it can reuse an old security service record. 1405ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1406ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns Number of records that were freed. 1407ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1408ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1409911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern uint8_t BTM_SecClrService(uint8_t service_id); 14105738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 14115738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1412ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1413ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecAddDevice 1414ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1415ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Add/modify device. This function will be normally called 1416ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * during host startup to restore all required information 1417ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * stored in the NVRAM. 14189ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * dev_class, bd_name, link_key, and features are NULL if 14199ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * unknown 1420ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1421ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true if added OK, else false 1422ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1423ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1424911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern bool BTM_SecAddDevice(BD_ADDR bd_addr, DEV_CLASS dev_class, 1425911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson BD_NAME bd_name, uint8_t* features, 1426911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint32_t trusted_mask[], LINK_KEY link_key, 1427911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint8_t key_type, tBTM_IO_CAP io_cap, 1428911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint8_t pin_length); 14295738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 14305738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1431ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1432ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecDeleteDevice 1433ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1434ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Free resources associated with the device. 1435ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1436ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true if rmoved OK, false if not found 1437ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1438ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1439911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern bool BTM_SecDeleteDevice(BD_ADDR bd_addr); 14405738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 1441415d1120561ba38c7cd00f0e41d8fb69cda97601Andre Eisenbach/******************************************************************************* 1442ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1443ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecClearSecurityFlags 1444ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1445ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Reset the security flags (mark as not-paired) for a given 1446ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * remove device. 1447ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1448ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1449911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern void BTM_SecClearSecurityFlags(BD_ADDR bd_addr); 14505738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 14515738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1452ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1453ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecGetDeviceLinkKey 1454ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1455ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to obtain link key for the device 1456ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * it returns BTM_SUCCESS if link key is available, or 1457ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if Security Manager does not know about 1458ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * the device or device record does not contain link key info 1459ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1460ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successful, otherwise error code 1461ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1462ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1463911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_SecGetDeviceLinkKey(BD_ADDR bd_addr, LINK_KEY link_key); 14645738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 14655738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1466ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1467ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecGetDeviceLinkKeyType 1468ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1469ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to obtain link key type for the 1470ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * device. 1471ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * it returns BTM_SUCCESS if link key is available, or 1472ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if Security Manager does not know about 1473ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * the device or device record does not contain link key info 1474ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1475ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_LKEY_TYPE_IGNORE if link key is unknown, link type 1476ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * otherwise. 1477ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1478ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1479911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_LINK_KEY_TYPE BTM_SecGetDeviceLinkKeyType(BD_ADDR bd_addr); 1480444a8da807abaf5f9e813ce70c56a79160495fb3Satya Calloji 1481444a8da807abaf5f9e813ce70c56a79160495fb3Satya Calloji/******************************************************************************* 1482ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1483ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_PINCodeReply 1484ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1485ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called after Security Manager submitted 1486ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * PIN code request to the UI. 1487ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 14889ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Parameters: bd_addr - Address of the device for which PIN was 14899ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * requested 14909ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * res - result of the operation BTM_SUCCESS if 14919ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * success 1492ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * pin_len - length in bytes of the PIN Code 1493ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * p_pin - pointer to array with the PIN Code 14949ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * trusted_mask - bitwise OR of trusted services 14959ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * (array of uint32_t) 1496ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1497ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 1498ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1499ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1500911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern void BTM_PINCodeReply(BD_ADDR bd_addr, uint8_t res, uint8_t pin_len, 1501911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint8_t* p_pin, uint32_t trusted_mask[]); 15025738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 15035738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1504ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1505ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecBond 1506ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1507ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to perform bonding with peer device. 1508ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1509ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: bd_addr - Address of the device to bond 1510ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * pin_len - length in bytes of the PIN Code 1511ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * p_pin - pointer to array with the PIN Code 15129ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * trusted_mask - bitwise OR of trusted services 15139ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * (array of uint32_t) 1514ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if successfully initiated, otherwise error 1515ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1516ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1517911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_SecBond(BD_ADDR bd_addr, uint8_t pin_len, uint8_t* p_pin, 1518911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint32_t trusted_mask[]); 15197fa4fba6f59f97df00aff07dbe8fb21b114b3c2cGanesh Ganapathi Batta 15207fa4fba6f59f97df00aff07dbe8fb21b114b3c2cGanesh Ganapathi Batta/******************************************************************************* 1521ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1522ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecBondByTransport 1523ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 15249ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description Perform bonding by designated transport 1525ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1526ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: bd_addr - Address of the device to bond 1527ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * pin_len - length in bytes of the PIN Code 1528ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * p_pin - pointer to array with the PIN Code 15299ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * trusted_mask - bitwise OR of trusted services 15309ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * (array of uint32_t) 15319ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * transport : Physical transport to use for bonding 15329ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * (BR/EDR or LE) 1533ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1534ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if successfully initiated, otherwise error 1535ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1536ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1537911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_SecBondByTransport(BD_ADDR bd_addr, 1538911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBT_TRANSPORT transport, 1539911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint8_t pin_len, uint8_t* p_pin, 1540911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint32_t trusted_mask[]); 15415738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 15425738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1543ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1544ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecBondCancel 1545ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1546ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to cancel ongoing bonding process 1547ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * with peer device. 1548ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1549ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if successfully initiated, otherwise error 1550ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1551ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1552911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_SecBondCancel(BD_ADDR bd_addr); 15535738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 15545738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1555ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1556ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetEncryption 1557ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1558ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to ensure that connection is 1559ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * encrypted. Should be called only on an open connection. 1560ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Typically only needed for connections that first want to 1561ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * bring up unencrypted links, then later encrypt them. 1562ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1563ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: bd_addr - Address of the peer device 1564ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * transport - Link transport 1565ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * p_callback - Pointer to callback function called if 1566ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * this function returns PENDING after required 15679ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * procedures are completed. Can be set to 15689ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * NULL if status is not desired. 15699ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * p_ref_data - pointer to any data the caller wishes to 15709ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * receive in the callback function upon 15719ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * completion. 1572ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * can be set to NULL if not used. 1573ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * sec_act - LE security action, unused for BR/EDR 1574ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1575ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS - already encrypted 1576ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_PENDING - command will be returned in the callback 1577ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_WRONG_MODE- connection not up. 1578ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_BUSY - security procedures are currently active 1579ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_MODE_UNSUPPORTED - if security manager not linked in. 1580ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1581ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1582911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_SetEncryption(BD_ADDR bd_addr, tBT_TRANSPORT transport, 1583911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_SEC_CBACK* p_callback, 1584911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson void* p_ref_data, 1585911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_BLE_SEC_ACT sec_act); 15865738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 15875738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1588ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1589ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ConfirmReqReply 1590ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1591ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to confirm the numeric value for 1592ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Simple Pairing in response to BTM_SP_CFM_REQ_EVT 1593ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 15949ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Parameters: res - result of the operation BTM_SUCCESS if 15959ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * success 1596ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * bd_addr - Address of the peer device 1597ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1598ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 159924933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern void BTM_ConfirmReqReply(tBTM_STATUS res, BD_ADDR bd_addr); 16005738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 16015738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1602ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1603ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_PasskeyReqReply 1604ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1605ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to provide the passkey for 1606ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Simple Pairing in response to BTM_SP_KEY_REQ_EVT 1607ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 16089ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Parameters: res - result of the operation BTM_SUCCESS if 16099ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * success 1610ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * bd_addr - Address of the peer device 16119ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * passkey - numeric value in the range of 16129ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * 0 - 999999(0xF423F). 1613ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1614ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1615911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern void BTM_PasskeyReqReply(tBTM_STATUS res, BD_ADDR bd_addr, 1616911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint32_t passkey); 16175738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 16185738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1619ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1620ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SendKeypressNotif 1621ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1622ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is used during the passkey entry model 1623ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * by a device with KeyboardOnly IO capabilities 1624ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * (very likely to be a HID Device). 16259ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * It is called by a HID Device to inform the remote device 16269ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * when a key has been entered or erased. 1627ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1628ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: bd_addr - Address of the peer device 1629ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * type - notification type 1630ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1631ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 163224933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern void BTM_SendKeypressNotif(BD_ADDR bd_addr, tBTM_SP_KEY_TYPE type); 16335738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 16345738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1635ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1636ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_IoCapRsp 1637ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1638ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called in response to BTM_SP_IO_REQ_EVT 16399ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * When the event data io_req.oob_data is set to 16409ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_OOB_UNKNOWN by the tBTM_SP_CALLBACK implementation, this 16419ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * function is called to provide the actual response 1642ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1643ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: bd_addr - Address of the peer device 1644ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * io_cap - The IO capability of local device. 1645ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * oob - BTM_OOB_NONE or BTM_OOB_PRESENT. 1646ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * auth_req- MITM protection required or not. 1647ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1648ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1649911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern void BTM_IoCapRsp(BD_ADDR bd_addr, tBTM_IO_CAP io_cap, tBTM_OOB_DATA oob, 1650911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_AUTH_REQ auth_req); 16515738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 16525738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1653ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1654ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadLocalOobData 1655ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1656ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to read the local OOB data from 1657ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * LM 1658ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1659ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1660b6ab9b3af6b8793ff781e0359a78611726ab2300Jakub Pawlowskiextern void BTM_ReadLocalOobData(void); 16615738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 16625738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1663ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1664ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_RemoteOobDataReply 1665ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1666ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to provide the remote OOB data for 1667ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Simple Pairing in response to BTM_SP_RMT_OOB_EVT 1668ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1669ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: bd_addr - Address of the peer device 1670ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * c - simple pairing Hash C. 1671ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * r - simple pairing Randomizer C. 1672ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1673ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 167424933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern void BTM_RemoteOobDataReply(tBTM_STATUS res, BD_ADDR bd_addr, 167524933b5b1a06274c47133debac5251a97128a267June R. Tate-Gans BT_OCTET16 c, BT_OCTET16 r); 16765738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 16775738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1678ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1679ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_BuildOobData 1680ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1681ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to build the OOB data payload to 1682ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * be sent over OOB (non-Bluetooth) link 1683ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1684ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: p_data - the location for OOB data 1685ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * max_len - p_data size. 1686ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * c - simple pairing Hash C. 1687ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * r - simple pairing Randomizer C. 1688ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * name_len- 0, local device name would not be included. 1689ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * otherwise, the local device name is included for 1690ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * up to this specified length 1691ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1692ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns Number of bytes in p_data. 1693ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1694ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1695911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern uint16_t BTM_BuildOobData(uint8_t* p_data, uint16_t max_len, 1696911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson BT_OCTET16 c, BT_OCTET16 r, uint8_t name_len); 16975738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 16985738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1699ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1700ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_BothEndsSupportSecureConnections 1701ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 17029ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description This function is called to check if both the local device 17039ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * and the peer device specified by bd_addr support BR/EDR 17049ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Secure Connections. 1705ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1706ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: bd_addr - address of the peer 1707ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 17089ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Returns true if BR/EDR Secure Connections are supported by both 17099ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * local and the remote device. 1710ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * else false. 1711ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1712ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1713911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern bool BTM_BothEndsSupportSecureConnections(BD_ADDR bd_addr); 1714899b77140675a157dba034e98527ab546bc9ac35Mudumba Ananth 1715899b77140675a157dba034e98527ab546bc9ac35Mudumba Ananth/******************************************************************************* 1716ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1717ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_PeerSupportsSecureConnections 1718ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1719ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to check if the peer supports 1720ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BR/EDR Secure Connections. 1721ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1722ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: bd_addr - address of the peer 1723ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1724ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true if BR/EDR Secure Connections are supported by the peer, 1725ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * else false. 1726ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1727ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1728911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern bool BTM_PeerSupportsSecureConnections(BD_ADDR bd_addr); 1729444a8da807abaf5f9e813ce70c56a79160495fb3Satya Calloji 1730444a8da807abaf5f9e813ce70c56a79160495fb3Satya Calloji/******************************************************************************* 1731ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1732ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadOobData 1733ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1734ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to parse the OOB data payload 1735ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * received over OOB (non-Bluetooth) link 1736ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1737ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: p_data - the location for OOB data 1738ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * eir_tag - The associated EIR tag to read the data. 1739ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * *p_len(output) - the length of the data with the given tag. 1740ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1741ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns the beginning of the data with the given tag. 1742ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * NULL, if the tag is not found. 1743ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1744ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1745911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern uint8_t* BTM_ReadOobData(uint8_t* p_data, uint8_t eir_tag, 1746911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint8_t* p_len); 17475738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 17485738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1749ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1750ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecReadDevName 1751ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1752ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Looks for the device name in the security database for the 1753ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * specified BD address. 1754ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1755ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns Pointer to the name or NULL 1756ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1757ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1758911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern char* BTM_SecReadDevName(BD_ADDR bd_addr); 17595738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 17605738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/***************************************************************************** 1761ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * POWER MANAGEMENT FUNCTIONS 1762ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ****************************************************************************/ 1763ee96a3c60fca590d38025925c072d264e06493c4Myles Watson/******************************************************************************* 1764ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1765ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_PmRegister 1766ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1767ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description register or deregister with power manager 1768ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1769ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successful, 1770ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_NO_RESOURCES if no room to hold registration 1771ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ILLEGAL_VALUE 1772ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1773ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1774911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_PmRegister(uint8_t mask, uint8_t* p_pm_id, 1775911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_PM_STATUS_CBACK* p_cb); 17765738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 17775738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1778ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1779ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetPowerMode 1780ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1781ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description store the mode in control block or 1782ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * alter ACL connection behavior. 1783ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1784ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successful, 1785ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if bd addr is not active or bad 1786ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1787ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1788911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_SetPowerMode(uint8_t pm_id, BD_ADDR remote_bda, 1789911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_PM_PWR_MD* p_mode); 17905738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 17915738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1792ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1793ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadPowerMode 1794ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1795ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This returns the current mode for a specific 1796ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * ACL connection. 1797ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1798ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Input Param remote_bda - device address of desired ACL connection 1799ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1800ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Output Param p_mode - address where the current mode is copied into. 1801ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ACL_MODE_NORMAL 1802ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ACL_MODE_HOLD 1803ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ACL_MODE_SNIFF 1804ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ACL_MODE_PARK 1805ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * (valid only if return code is BTM_SUCCESS) 1806ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1807ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successful, 1808ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if bd addr is not active or bad 1809ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1810ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1811911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_ReadPowerMode(BD_ADDR remote_bda, tBTM_PM_MODE* p_mode); 18125738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 18135738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1814ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1815ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetSsrParams 1816ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1817ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This sends the given SSR parameters for the given ACL 1818ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * connection if it is in ACTIVE mode. 1819ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1820ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Input Param remote_bda - device address of desired ACL connection 1821ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * max_lat - maximum latency (in 0.625ms)(0-0xFFFE) 1822ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * min_rmt_to - minimum remote timeout 1823ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * min_loc_to - minimum local timeout 1824ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1825ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1826ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if the HCI command is issued successful, 1827ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if bd addr is not active or bad 1828ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_CMD_STORED if the command is stored 1829ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1830ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1831911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_SetSsrParams(BD_ADDR remote_bda, uint16_t max_lat, 1832911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint16_t min_rmt_to, uint16_t min_loc_to); 18335738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 18345738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1835ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1836ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_GetHCIConnHandle 1837ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 18389ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description This function is called to get the handle for an ACL 18399ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * connection to a specific remote BD Address. 1840ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1841ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns the handle of the connection, or 0xFFFF if none. 1842ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1843ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1844911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern uint16_t BTM_GetHCIConnHandle(const BD_ADDR remote_bda, 1845911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBT_TRANSPORT transport); 18465738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 18475738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1848ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1849ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_DeleteStoredLinkKey 1850ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1851ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to delete link key for the specified 18529ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * device addresses from the NVRAM storage attached to the 18539ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Bluetooth controller. 1854ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1855ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: bd_addr - Addresses of the devices 1856ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * p_cb - Call back function to be called to return 1857ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * the results 1858ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1859ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1860911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_DeleteStoredLinkKey(BD_ADDR bd_addr, tBTM_CMPL_CB* p_cb); 18615738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 18625738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1863ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1864ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_WriteEIR 1865ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1866ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to write EIR data to controller. 1867ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1868ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters p_buff - allocated HCI command buffer including extended 1869ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * inquriry response 1870ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1871ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS - if successful 1872ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_MODE_UNSUPPORTED - if local device cannot support it 1873ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1874ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1875911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_WriteEIR(BT_HDR* p_buff); 18765738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 18775738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1878ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1879ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_HasEirService 1880ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1881ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to know if UUID in bit map of UUID. 1882ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1883ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters p_eir_uuid - bit map of UUID list 1884ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * uuid16 - UUID 16-bit 1885ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1886ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true - if found 1887ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * false - if not found 1888ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1889ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1890911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern bool BTM_HasEirService(uint32_t* p_eir_uuid, uint16_t uuid16); 18915738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 18925738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1893ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1894ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_HasInquiryEirService 1895ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 18969ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description Return if a UUID is in the bit map of a UUID list. 1897ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1898ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters p_results - inquiry results 1899ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * uuid16 - UUID 16-bit 1900ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1901ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_EIR_FOUND - if found 19029ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_EIR_NOT_FOUND - if not found and it is a complete list 1903ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_EIR_UNKNOWN - if not found and it is not complete list 1904ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1905ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1906911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_EIR_SEARCH_RESULT BTM_HasInquiryEirService( 1907911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_INQ_RESULTS* p_results, uint16_t uuid16); 19085738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 19095738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1910ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1911ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_AddEirService 1912ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 19139ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description This function is called to add a service in the bit map UUID 19149ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * list. 1915ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1916ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters p_eir_uuid - bit mask of UUID list for EIR 1917ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * uuid16 - UUID 16-bit 1918ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1919ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns None 1920ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1921ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1922911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern void BTM_AddEirService(uint32_t* p_eir_uuid, uint16_t uuid16); 19235738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 19245738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1925ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1926ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_RemoveEirService 1927ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 19289ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description This function is called to remove a service from the bit map 19299ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * UUID list. 1930ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1931ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters p_eir_uuid - bit mask of UUID list for EIR 1932ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * uuid16 - UUID 16-bit 1933ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1934ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns None 1935ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1936ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1937911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern void BTM_RemoveEirService(uint32_t* p_eir_uuid, uint16_t uuid16); 19385738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 19395738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1940ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1941ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_GetEirSupportedServices 1942ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 19439ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description This function is called to get UUID list from bit map UUID 19449ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * list. 1945ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1946ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters p_eir_uuid - bit mask of UUID list for EIR 1947ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * p - reference of current pointer of EIR 1948ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * max_num_uuid16 - max number of UUID can be written in EIR 1949ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * num_uuid16 - number of UUID have been written in EIR 1950ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1951ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_EIR_MORE_16BITS_UUID_TYPE, if it has more than max 1952ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_EIR_COMPLETE_16BITS_UUID_TYPE, otherwise 1953ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1954ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1955911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern uint8_t BTM_GetEirSupportedServices(uint32_t* p_eir_uuid, uint8_t** p, 1956911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint8_t max_num_uuid16, 1957911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint8_t* p_num_uuid16); 19585738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 19595738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1960ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1961ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_GetEirUuidList 1962ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1963ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function parses EIR and returns UUID list. 1964ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1965ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters p_eir - EIR 19660595ca0018ac9980d1dd7e192301f8494a01f9cbJakub Pawlowski * eirl_len - EIR len 1967ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * uuid_size - LEN_UUID_16, LEN_UUID_32, LEN_UUID_128 1968ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * p_num_uuid - return number of UUID in found list 1969ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * p_uuid_list - return UUID 16-bit list 1970ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * max_num_uuid - maximum number of UUID to be returned 1971ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1972ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns 0 - if not found 1973ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_EIR_COMPLETE_16BITS_UUID_TYPE 1974ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_EIR_MORE_16BITS_UUID_TYPE 1975ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_EIR_COMPLETE_32BITS_UUID_TYPE 1976ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_EIR_MORE_32BITS_UUID_TYPE 1977ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_EIR_COMPLETE_128BITS_UUID_TYPE 1978ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_EIR_MORE_128BITS_UUID_TYPE 1979ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1980ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 19810595ca0018ac9980d1dd7e192301f8494a01f9cbJakub Pawlowskiextern uint8_t BTM_GetEirUuidList(uint8_t* p_eir, size_t eir_len, 19820595ca0018ac9980d1dd7e192301f8494a01f9cbJakub Pawlowski uint8_t uuid_size, uint8_t* p_num_uuid, 19830595ca0018ac9980d1dd7e192301f8494a01f9cbJakub Pawlowski uint8_t* p_uuid_list, uint8_t max_num_uuid); 19845738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 19855738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/***************************************************************************** 1986ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * SCO OVER HCI 1987ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ****************************************************************************/ 1988ee96a3c60fca590d38025925c072d264e06493c4Myles Watson/******************************************************************************* 1989ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1990ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ConfigScoPath 1991ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1992ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function enable/disable SCO over HCI and registers SCO 1993ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * data callback if SCO over HCI is enabled. 1994ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1995ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameter path: SCO or HCI 1996ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * p_sco_data_cb: callback function or SCO data if path is set 1997ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * to transport. 19989ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * p_pcm_param: pointer to the PCM interface parameter. If a 19999ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * NULL pointer is used, the PCM parameter 20009ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * maintained in the control block will be used; 20019ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * otherwise update the control block value. 20029ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * err_data_rpt: Lisbon feature to enable the erronous data 20039ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * report or not. 2004ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2005ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if the successful. 2006ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_NO_RESOURCES: no rsource to start the command. 2007ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ILLEGAL_VALUE: invalid callback function pointer. 20089ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_CMD_STARTED : Command sent. Waiting for command 20099ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * complete event. 2010ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2011ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2012ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 201357f6508cf7b22788fa2e7a739cec241b785718fbMudumba Ananthextern tBTM_STATUS BTM_ConfigScoPath(esco_data_path_t path, 2014911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_SCO_DATA_CB* p_sco_data_cb, 2015911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_SCO_PCM_PARAM* p_pcm_param, 2016911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson bool err_data_rpt); 20175738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 20185738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 2019ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2020ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_WriteScoData 2021ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 20229ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description This function write SCO data to a specified instance. The 20239ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * data to be written p_buf needs to carry an offset of 2024ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * HCI_SCO_PREAMBLE_SIZE bytes, and the data length can not 20259ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * exceed BTM_SCO_DATA_SIZE_MAX bytes, whose default value is 20269ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * set to 60 and is configurable. Data longer than the maximum 20279ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * bytes will be truncated. 2028ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2029ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS: data write is successful 2030ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ILLEGAL_VALUE: SCO data contains illegal offset value. 20319ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_SCO_BAD_LENGTH: SCO data length exceeds the max SCO 20329ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * packet size. 2033ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_NO_RESOURCES: no resources. 20349ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_UNKNOWN_ADDR: unknown SCO connection handle, or SCO is 20359ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * not routed via HCI. 2036ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2037ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2038ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 2039911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_WriteScoData(uint16_t sco_inx, BT_HDR* p_buf); 20405738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 20415738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 2042ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2043ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetARCMode 2044ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2045ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Send Audio Routing Control command. 2046ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2047ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 2048ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2049ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 2050911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern void BTM_SetARCMode(uint8_t iface, uint8_t arc_mode, 2051911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_VSC_CMPL_CB* p_arc_cb); 20525738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 20535738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 2054ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2055ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_PCM2Setup_Write 2056ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2057ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Send PCM2_Setup write command. 2058ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2059ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 2060ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2061ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 2062911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern void BTM_PCM2Setup_Write(bool clk_master, tBTM_VSC_CMPL_CB* p_arc_cb); 2063e5ba8841cd39e17c05aeb4ab65b5b761d41577daSatya Calloji 2064e5ba8841cd39e17c05aeb4ab65b5b761d41577daSatya Calloji/******************************************************************************* 2065ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2066ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_PM_ReadControllerState 2067ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2068ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to obtain the controller state 2069ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 20709ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Returns Controller state (BTM_CONTRL_ACTIVE, BTM_CONTRL_SCAN, and 20719ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_CONTRL_IDLE) 2072ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2073ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 207424933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_CONTRL_STATE BTM_PM_ReadControllerState(void); 2075e5ba8841cd39e17c05aeb4ab65b5b761d41577daSatya Calloji 20765738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project#endif /* BTM_API_H */ 2077