btm_api.h revision a484a888196ddf8bcbf1ad3226d6451bc735a94b
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" 30fe695a557a92053d4c44428ba08c0b8e945d4711Jack He#include "hcidefs.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 ******************************************************************************/ 537a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern tBTM_STATUS BTM_ReadRemoteDeviceName(const RawAddress& 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 ******************************************************************************/ 569a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern tBTM_STATUS BTM_ReadRemoteVersion(const RawAddress& addr, 570c2276b06572ab6fc1f900fbb1f41087e77d47e2aJakub Pawlowski uint8_t* lmp_version, 571911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint16_t* manufacturer, 572911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint16_t* lmp_sub_version); 5735738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 5745738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 575ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 576ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadRemoteFeatures 577ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 578ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to read a remote device's 579ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * supported features mask (features mask located at page 0) 580ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 581ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Note: The size of device features mask page is 582ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_FEATURE_BYTES_PER_PAGE bytes. 583ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 584ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns pointer to the remote supported features mask 585ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 586ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 587a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern uint8_t* BTM_ReadRemoteFeatures(const RawAddress& addr); 5885738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 5895738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 590ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 591ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadRemoteExtendedFeatures 592ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 593ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to read a specific extended features 594ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * page of the remote device 595ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 596ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Note1: The size of device features mask page is 597ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_FEATURE_BYTES_PER_PAGE bytes. 598ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Note2: The valid device features mask page number depends on 599ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * the remote device capabilities. It is expected to be in the 600ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * range [0 - BTM_EXT_FEATURES_PAGE_MAX]. 601ee96a3c60fca590d38025925c072d264e06493c4Myles Watson 602ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns pointer to the remote extended features mask 603ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * or NULL if page_number is not valid 604ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 605ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 606a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern uint8_t* BTM_ReadRemoteExtendedFeatures(const RawAddress& addr, 607911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint8_t page_number); 6083aa60544585b5fb0f35c1165539a4a859fc0f25cAndre Eisenbach 6093aa60544585b5fb0f35c1165539a4a859fc0f25cAndre Eisenbach/******************************************************************************* 610ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 611ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadNumberRemoteFeaturesPages 612ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 6139ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description This function is called to retrieve the number of feature 6149ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * pages read from the remote device 615ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 616ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns number of features pages read from the remote device 617ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 618ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 619a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern uint8_t BTM_ReadNumberRemoteFeaturesPages(const RawAddress& addr); 6203aa60544585b5fb0f35c1165539a4a859fc0f25cAndre Eisenbach 6213aa60544585b5fb0f35c1165539a4a859fc0f25cAndre Eisenbach/******************************************************************************* 622ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 623ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadAllRemoteFeatures 624ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 6259ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description Read all the features of the remote device 626ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 627ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns pointer to the byte[0] of the page[0] of the remote device 628ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * feature mask. 629ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 630ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Note: the function returns the pointer to the array of the size 6319ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_FEATURE_BYTES_PER_PAGE * (BTM_EXT_FEATURES_PAGE_MAX + 1) 632ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 633ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 634a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern uint8_t* BTM_ReadAllRemoteFeatures(const RawAddress& addr); 6353aa60544585b5fb0f35c1165539a4a859fc0f25cAndre Eisenbach 6363aa60544585b5fb0f35c1165539a4a859fc0f25cAndre Eisenbach/******************************************************************************* 637ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 638ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_InqDbRead 639ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 640ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function looks through the inquiry database for a match 641ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * based on Bluetooth Device Address. This is the application's 6429ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * interface to get the inquiry details of a specific BD 6439ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * address. 644ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 645ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns pointer to entry, or NULL if not found 646ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 647ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 648a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern tBTM_INQ_INFO* BTM_InqDbRead(const RawAddress& p_bda); 6495738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 6505738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 651ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 652ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_InqDbFirst 653ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 6549ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description This function looks through the inquiry database for the 6559ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * first used entry, and returns that. This is used in 6569ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * conjunction with BTM_InqDbNext by applications as a way to 6579ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * walk through the inquiry database. 658ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 659ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns pointer to first in-use entry, or NULL if DB is empty 660ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 661ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 662911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_INQ_INFO* BTM_InqDbFirst(void); 6635738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 6645738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 665ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 666ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_InqDbNext 667ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 6689ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description This function looks through the inquiry database for the 6699ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * next used entry, and returns that. If the input parameter 6709ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * is NULL, the first entry is returned. 671ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 672ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns pointer to next in-use entry, or NULL if no more found. 673ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 674ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 675911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_INQ_INFO* BTM_InqDbNext(tBTM_INQ_INFO* p_cur); 6765738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 6775738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 678ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 679ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ClearInqDb 680ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 681ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to clear out a device or all devices 682ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * from the inquiry database. 683ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 684ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameter p_bda - (input) BD_ADDR -> Address of device to clear 685ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * (NULL clears all entries) 686ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 687ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_BUSY if an inquiry, get remote name, or event filter 688ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * is active, otherwise BTM_SUCCESS 689ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 690ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 691a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern tBTM_STATUS BTM_ClearInqDb(const RawAddress* p_bda); 6925738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 6935738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 694ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 695ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadInquiryRspTxPower 696ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 697ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This command will read the inquiry Transmit Power level used 698ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * to transmit the FHS and EIR data packets. 6999ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * This can be used directly in the Tx Power Level EIR data 7009ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * type. 701ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 702ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successful 703ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 704ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 705911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_ReadInquiryRspTxPower(tBTM_CMPL_CB* p_cb); 7065738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 7075738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/***************************************************************************** 708ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * ACL CHANNEL MANAGEMENT FUNCTIONS 709ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ****************************************************************************/ 710ee96a3c60fca590d38025925c072d264e06493c4Myles Watson/******************************************************************************* 711ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 712ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetLinkPolicy 713ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 714ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Create and send HCI "Write Policy Set" command 715ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 716ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if successfully initiated, otherwise error 717ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 718ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 719a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern tBTM_STATUS BTM_SetLinkPolicy(const RawAddress& remote_bda, 720c2276b06572ab6fc1f900fbb1f41087e77d47e2aJakub Pawlowski uint16_t* settings); 7215738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 7225738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 723ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 724ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetDefaultLinkPolicy 725ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 726ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Set the default value for HCI "Write Policy Set" command 727ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * to use when an ACL link is created. 728ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 729ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 730ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 731ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 732911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern void BTM_SetDefaultLinkPolicy(uint16_t settings); 733ee96a3c60fca590d38025925c072d264e06493c4Myles Watson 7345738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 735ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 736ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetDefaultLinkSuperTout 737ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 7389ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description Set the default value for HCI "Write Link Supervision 7399ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Timeout" command to use when an ACL link is created. 740ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 741ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 742ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 743ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 744911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern void BTM_SetDefaultLinkSuperTout(uint16_t timeout); 7455738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 7465738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 747ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 748ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetLinkSuperTout 749ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 750ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Create and send HCI "Write Link Supervision Timeout" command 751ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 752ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if successfully initiated, otherwise error 753ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 754ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 755a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern tBTM_STATUS BTM_SetLinkSuperTout(const RawAddress& remote_bda, 756c2276b06572ab6fc1f900fbb1f41087e77d47e2aJakub Pawlowski uint16_t timeout); 757ead3cde4bac0c3e32cd31f149093f004eef8ceebGanesh Ganapathi Batta/******************************************************************************* 758ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 759ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_GetLinkSuperTout 760ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 761ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Read the link supervision timeout value of the connection 762ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 763ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns status of the operation 764ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 765ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 766a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern tBTM_STATUS BTM_GetLinkSuperTout(const RawAddress& remote_bda, 767911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint16_t* p_timeout); 7685738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 7695738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 770ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 771ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_IsAclConnectionUp 772ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 773ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to check if an ACL connection exists 774ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * to a specific remote BD Address. 775ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 776ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true if connection is up, else false. 777ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 778ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 779a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern bool BTM_IsAclConnectionUp(const RawAddress& remote_bda, 780c2276b06572ab6fc1f900fbb1f41087e77d47e2aJakub Pawlowski tBT_TRANSPORT transport); 7815738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 7825738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 783ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 784ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_GetRole 785ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 786ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to get the role of the local device 787ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * for the ACL connection with the specified remote device 788ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 789ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if connection exists. 790ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if no active link with bd addr specified 791ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 792ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 793a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern tBTM_STATUS BTM_GetRole(const RawAddress& remote_bd_addr, 794c2276b06572ab6fc1f900fbb1f41087e77d47e2aJakub Pawlowski uint8_t* p_role); 7955738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 7965738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 797ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 798ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SwitchRole 799ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 800ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to switch role between master and 801ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * slave. If role is already set it will do nothing. If the 802ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * command was initiated, the callback function is called upon 803ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * completion. 804ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 805ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if already in specified role. 806ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_CMD_STARTED if command issued to controller. 8079ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_NO_RESOURCES if memory couldn't be allocated to issue 8089ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * the command 809ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if no active link with bd addr specified 8109ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_MODE_UNSUPPORTED if the local device does not support 8119ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * role switching 812ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 813ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 814a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern tBTM_STATUS BTM_SwitchRole(const RawAddress& remote_bd_addr, 815c2276b06572ab6fc1f900fbb1f41087e77d47e2aJakub Pawlowski uint8_t new_role, tBTM_CMPL_CB* p_cb); 8165738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 8175738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 818ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 819ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadRSSI 820ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 821ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to read the link policy settings. 8229ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * The address of link policy results are returned in the 8239ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * callback. (tBTM_RSSI_RESULTS) 824ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 825ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if command issued to controller. 8269ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_NO_RESOURCES if memory couldn't be allocated to issue 8279ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * the command 828ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if no active link with bd addr specified 829ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_BUSY if command is already in progress 830ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 831ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 832a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern tBTM_STATUS BTM_ReadRSSI(const RawAddress& remote_bda, 833c2276b06572ab6fc1f900fbb1f41087e77d47e2aJakub Pawlowski tBTM_CMPL_CB* p_cb); 8345738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 8355738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 836ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 837ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadTxPower 838ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 839ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to read the current connection 840ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * TX power of the connection. The TX power level results 841ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * are returned in the callback. 842ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * (tBTM_RSSI_RESULTS) 843ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 844ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if command issued to controller. 8459ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_NO_RESOURCES if memory couldn't be allocated to issue 8469ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * the command 847ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if no active link with bd addr specified 848ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_BUSY if command is already in progress 849ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 850ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 851a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern tBTM_STATUS BTM_ReadTxPower(const RawAddress& remote_bda, 852c2276b06572ab6fc1f900fbb1f41087e77d47e2aJakub Pawlowski tBT_TRANSPORT transport, tBTM_CMPL_CB* p_cb); 8535738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 8545738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 855ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 856ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadLinkQuality 857ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 858ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to read the link quality. 859ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * The value of the link quality is returned in the callback. 860ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * (tBTM_LINK_QUALITY_RESULTS) 861ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 862ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if command issued to controller. 8639ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_NO_RESOURCES if memory couldn't be allocated to issue 8649ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * the command 865ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if no active link with bd addr specified 866ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_BUSY if command is already in progress 867ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 868ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 869a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern tBTM_STATUS BTM_ReadLinkQuality(const RawAddress& remote_bda, 870c2276b06572ab6fc1f900fbb1f41087e77d47e2aJakub Pawlowski tBTM_CMPL_CB* p_cb); 8715738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 8725738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 873ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 874ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_RegBusyLevelNotif 875ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 876ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to register a callback to receive 877ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * busy level change events. 878ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 879ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successfully registered, otherwise error 880ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 881ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 882911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_RegBusyLevelNotif(tBTM_BL_CHANGE_CB* p_cb, 883911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint8_t* p_level, 884911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_BL_EVENT_MASK evt_mask); 8855738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 8865738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 887ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 888ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_AclRegisterForChanges 889ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 890ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to register a callback to receive 891ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * ACL database change events, i.e. new connection or removed. 892ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 893ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successfully initiated, otherwise error 894ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 895ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 896911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_AclRegisterForChanges(tBTM_ACL_DB_CHANGE_CB* p_cb); 8975738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 8985738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 899ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 900ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_GetNumAclLinks 901ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 902ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to count the number of 903ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * ACL links that are active. 904ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 905ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns uint16_t Number of active ACL links 906ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 907ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 908911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern uint16_t BTM_GetNumAclLinks(void); 9095738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 9105738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 911ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 912ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetQoS 913ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 914ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to setup QoS 915ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 916ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if successfully initiated, otherwise error 917ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 918ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 919a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern tBTM_STATUS BTM_SetQoS(const RawAddress& bd, FLOW_SPEC* p_flow, 920911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_CMPL_CB* p_cb); 9215738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 9225738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/***************************************************************************** 923ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * (e)SCO CHANNEL MANAGEMENT FUNCTIONS 924ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ****************************************************************************/ 925ee96a3c60fca590d38025925c072d264e06493c4Myles Watson/******************************************************************************* 926ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 927ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_CreateSco 928ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 929ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to create an SCO connection. If the 930ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * "is_orig" flag is true, the connection will be originated, 931ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * otherwise BTM will wait for the other side to connect. 932ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 933ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_UNKNOWN_ADDR if the ACL connection is not up 934ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_BUSY if another SCO being set up to 935ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * the same BD address 936ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_NO_RESOURCES if the max SCO limit has been reached 937ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_CMD_STARTED if the connection establishment is started. 938ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * In this case, "*p_sco_inx" is filled in 939ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * with the sco index used for the connection. 940ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 941ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 942a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern tBTM_STATUS BTM_CreateSco(const RawAddress* remote_bda, bool is_orig, 943911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint16_t pkt_types, uint16_t* p_sco_inx, 944911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_SCO_CB* p_conn_cb, 945911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_SCO_CB* p_disc_cb); 9465738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 9475738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 948ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 949ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_RemoveSco 950ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 951ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to remove a specific SCO connection. 952ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 953ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if successfully initiated, otherwise error 954ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 955ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 956911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_RemoveSco(uint16_t sco_inx); 9575738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 9585738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 959ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 960ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetScoPacketTypes 961ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 962ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to set the packet types used for 963ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * a specific SCO connection, 964ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 965ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters pkt_types - One or more of the following 966ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_HV1 967ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_HV2 968ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_HV3 969ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_EV3 970ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_EV4 971ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_EV5 972ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 973ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_LINK_ALL_MASK - enables all supported types 974ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 975ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if successfully initiated, otherwise error 976ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 977ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 978911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_SetScoPacketTypes(uint16_t sco_inx, uint16_t pkt_types); 9795738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 9805738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 981ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 982ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadScoPacketTypes 983ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 984ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is read the packet types used for a specific 985ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * SCO connection. 986ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 987ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns One or more of the following (bitmask) 988ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_HV1 989ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_HV2 990ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_HV3 991ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_EV3 992ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_EV4 993ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_EV5 994ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 995ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns packet types supported for the connection 996ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 997ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 998911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern uint16_t BTM_ReadScoPacketTypes(uint16_t sco_inx); 9995738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 10005738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1001ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1002ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadDeviceScoPacketTypes 1003ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1004ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is read the SCO packet types that 1005ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * the device supports. 1006ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1007ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns packet types supported by the device. 1008ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1009ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1010911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern uint16_t BTM_ReadDeviceScoPacketTypes(void); 10115738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 10125738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1013ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1014ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadScoHandle 1015ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 10169ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description Reead the HCI handle used for a specific SCO connection, 1017ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1018ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns handle for the connection, or 0xFFFF if invalid SCO index. 1019ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1020ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1021911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern uint16_t BTM_ReadScoHandle(uint16_t sco_inx); 10225738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 10235738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1024ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1025ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadScoBdAddr 1026ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1027ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is read the remote BD Address for a specific 1028ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * SCO connection, 1029ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1030ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns pointer to BD address or NULL if not known 1031ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1032ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1033a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern const RawAddress* BTM_ReadScoBdAddr(uint16_t sco_inx); 10345738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 10355738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1036ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1037ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadScoDiscReason 1038ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1039ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is returns the reason why an (e)SCO connection 1040ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * has been removed. It contains the value until read, or until 1041ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * another (e)SCO connection has disconnected. 1042ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1043ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns HCI reason or BTM_INVALID_SCO_DISC_REASON if not set. 1044ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1045ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1046911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern uint16_t BTM_ReadScoDiscReason(void); 10475738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 10485738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1049ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1050ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetEScoMode 1051ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1052ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function sets up the negotiated parameters for SCO or 1053ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * eSCO, and sets as the default mode used for calls to 1054ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_CreateSco. It can be called only when there are no 1055ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * active (e)SCO links. 1056ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1057ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if the successful. 1058ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_BUSY if there are one or more active (e)SCO links. 1059ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1060ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 106157f6508cf7b22788fa2e7a739cec241b785718fbMudumba Ananthextern tBTM_STATUS BTM_SetEScoMode(enh_esco_params_t* p_parms); 10625738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 10635738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1064ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1065ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetWBSCodec 1066ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1067ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function sends command to the controller to setup 1068ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * WBS codec for the upcoming eSCO connection. 1069ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1070ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS. 1071ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1072ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1073ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1074911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_SetWBSCodec(tBTM_SCO_CODEC_TYPE codec_type); 10755738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 10765738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1077ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1078ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_RegForEScoEvts 1079ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1080ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function registers a SCO event callback with the 1081ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * specified instance. It should be used to received 1082ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * connection indication events and change of link parameter 1083ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * events. 1084ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1085ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if the successful. 1086ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ILLEGAL_VALUE if there is an illegal sco_inx 1087ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1088ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1089911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_RegForEScoEvts(uint16_t sco_inx, 1090911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_ESCO_CBACK* p_esco_cback); 10915738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 10925738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1093ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1094ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadEScoLinkParms 1095ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1096ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function returns the current eSCO link parameters for 10979ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * the specified handle. This can be called anytime a 10989ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * connection is active, but is typically called after 10999ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * receiving the SCO opened callback. 1100ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1101ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Note: If called over a 1.1 controller, only the packet types 1102ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * field has meaning. 1103ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Note: If the upper layer doesn't know the current sco index, 11049ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_FIRST_ACTIVE_SCO_INDEX can be used as the first 11059ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * parameter to find the first active SCO index 1106ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1107ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if returned data is valid connection. 1108ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ILLEGAL_VALUE if no connection for specified sco_inx. 1109ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_MODE_UNSUPPORTED if local controller does not support 1110ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1.2 specification. 1111ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1112ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1113911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_ReadEScoLinkParms(uint16_t sco_inx, 1114911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_ESCO_DATA* p_parms); 11155738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 11165738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1117ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1118ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ChangeEScoLinkParms 1119ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1120ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function requests renegotiation of the parameters on 1121ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * the current eSCO Link. If any of the changes are accepted 1122ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * by the controllers, the BTM_ESCO_CHG_EVT event is sent in 1123ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * the tBTM_ESCO_CBACK function with the current settings of 1124ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * the link. The callback is registered through the call to 1125ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SetEScoMode. 1126ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1127ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1128ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if command is successfully initiated. 1129ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ILLEGAL_VALUE if no connection for specified sco_inx. 1130ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_NO_RESOURCES - not enough resources to initiate command. 1131ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_MODE_UNSUPPORTED if local controller does not support 1132ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1.2 specification. 1133ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1134ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1135911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_ChangeEScoLinkParms(uint16_t sco_inx, 1136911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_CHG_ESCO_PARAMS* p_parms); 11375738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 11385738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1139ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1140ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_EScoConnRsp 1141ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1142ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called upon receipt of an (e)SCO connection 1143ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * request event (BTM_ESCO_CONN_REQ_EVT) to accept or reject 1144ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * the request. Parameters used to negotiate eSCO links. 1145ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * If p_parms is NULL, then values set through BTM_SetEScoMode 1146ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * are used. 1147ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * If the link type of the incoming request is SCO, then only 1148ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * the tx_bw, max_latency, content format, and packet_types are 1149ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * valid. The hci_status parameter should be 1150ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * ([0x0] to accept, [0x0d..0x0f] to reject) 1151ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1152ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1153ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 1154ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1155ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1156911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern void BTM_EScoConnRsp(uint16_t sco_inx, uint8_t hci_status, 115757f6508cf7b22788fa2e7a739cec241b785718fbMudumba Ananth enh_esco_params_t* p_parms); 11585738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 11595738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1160ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1161ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_GetNumScoLinks 1162ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1163ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function returns the number of active SCO links. 1164ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1165ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns uint8_t 1166ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1167ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1168911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern uint8_t BTM_GetNumScoLinks(void); 11695738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 11705738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/***************************************************************************** 1171ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * SECURITY MANAGEMENT FUNCTIONS 1172ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ****************************************************************************/ 1173ee96a3c60fca590d38025925c072d264e06493c4Myles Watson/******************************************************************************* 1174ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1175ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecRegister 1176ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1177ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Application manager calls this function to register for 11789ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * security services. There can be one and only one 11799ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * application saving link keys. BTM allows only first 11809ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * registration. 1181ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1182ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true if registered OK, else false 1183ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1184ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1185911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern bool BTM_SecRegister(tBTM_APPL_INFO* p_cb_info); 11865738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 1187877123f5b9df90e7a71ea7b15997c521229decc1Satya Calloji/******************************************************************************* 1188ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1189ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecRegisterLinkKeyNotificationCallback 1190ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1191ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Profiles can register to be notified when a new Link Key 1192ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * is generated per connection. 1193ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1194ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true if registered OK, else false 1195ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1196ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1197911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern bool BTM_SecRegisterLinkKeyNotificationCallback( 1198911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_LINK_KEY_CALLBACK* p_callback); 11995738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 12005738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1201ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1202ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecAddRmtNameNotifyCallback 1203ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1204ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Profiles can register to be notified when name of the 12059ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * remote device is resolved (up to 12069ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_SEC_MAX_RMT_NAME_CALLBACKS). 1207ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1208ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true if registered OK, else false 1209ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1210ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1211911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern bool BTM_SecAddRmtNameNotifyCallback(tBTM_RMT_NAME_CALLBACK* p_callback); 12125738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 12135738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1214ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1215ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecDeleteRmtNameNotifyCallback 1216ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1217ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description A profile can deregister notification when a new Link Key 1218ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * is generated per connection. 1219ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1220ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true if OK, else false 1221ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1222ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1223911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern bool BTM_SecDeleteRmtNameNotifyCallback( 1224911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_RMT_NAME_CALLBACK* p_callback); 12255738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 12265738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1227ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1228ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_GetSecurityFlags 1229ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1230ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Get security flags for the device 1231ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1232ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns bool true or false is device found 1233ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1234ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1235a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern bool BTM_GetSecurityFlags(const RawAddress& bd_addr, 1236c2276b06572ab6fc1f900fbb1f41087e77d47e2aJakub Pawlowski uint8_t* p_sec_flags); 12375738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 12385738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1239ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1240ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_GetSecurityFlagsByTransport 1241ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1242ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Get security flags for the device on a particular transport 1243ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1244ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters bd_addr: BD address of remote device 12459ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * p_sec_flags : Out parameter to be filled with security 12469ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * flags for the connection 12479ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * transport : Physical transport of the connection 12489ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * (BR/EDR or LE) 1249ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1250ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns bool true or false is device found 1251ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1252ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1253a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern bool BTM_GetSecurityFlagsByTransport(const RawAddress& bd_addr, 1254911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint8_t* p_sec_flags, 1255911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBT_TRANSPORT transport); 12567fa4fba6f59f97df00aff07dbe8fb21b114b3c2cGanesh Ganapathi Batta 12577fa4fba6f59f97df00aff07dbe8fb21b114b3c2cGanesh Ganapathi Batta/******************************************************************************* 1258ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1259ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadTrustedMask 1260ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1261ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Get trusted mask for the device 1262ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1263ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns NULL, if the device record is not found. 1264ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * otherwise, the trusted mask 1265ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1266ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1267a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern uint32_t* BTM_ReadTrustedMask(const RawAddress& bd_addr); 12685738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 12695738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1270ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1271ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetPinType 1272ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1273ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Set PIN type for the device. 1274ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1275ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 1276ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1277ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1278911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern void BTM_SetPinType(uint8_t pin_type, PIN_CODE pin_code, 1279911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint8_t pin_code_len); 12805738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 12815738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1282ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1283ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetPairableMode 1284ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1285ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Enable or disable pairing 1286ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1287ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters allow_pairing - (true or false) whether or not the device 1288ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * allows pairing. 1289ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * connect_only_paired - (true or false) whether or not to 1290ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * only allow paired devices to connect. 1291ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1292ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 1293ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1294ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1295911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern void BTM_SetPairableMode(bool allow_pairing, bool connect_only_paired); 12965738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 12975738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1298ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1299ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetSecureConnectionsOnly 1300ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 13019ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description Enable or disable default treatment for Mode 4 Level 0 13029ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * services 1303ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1304ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameter secure_connections_only_mode - (true or false) 13059ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * true means that the device should treat Mode 4 Level 0 13069ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * services as services of other levels. 13079ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * false means that the device should provide default 13089ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * treatment for Mode 4 Level 0 services. 1309ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1310ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 1311ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1312ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1313911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern void BTM_SetSecureConnectionsOnly(bool secure_connections_only_mode); 1314899b77140675a157dba034e98527ab546bc9ac35Mudumba Ananth 1315899b77140675a157dba034e98527ab546bc9ac35Mudumba Ananth/******************************************************************************* 1316ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1317ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetSecurityLevel 1318ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1319ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Register service security level with Security Manager. Each 1320ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * service must register its requirements regardless of the 13219ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * security level that is used. This API is called once for 13229ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * originators and again for acceptors of connections. 1323ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1324ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true if registered OK, else false 1325ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1326ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1327911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern bool BTM_SetSecurityLevel(bool is_originator, const char* p_name, 1328911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint8_t service_id, uint16_t sec_level, 1329911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint16_t psm, uint32_t mx_proto_id, 1330911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint32_t mx_chan_id); 13315738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 13325738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1333ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1334ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetOutService 1335ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1336ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to set the service for 1337ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * outgoing connection. 1338ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1339ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 1340ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1341ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1342a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern void BTM_SetOutService(const RawAddress& bd_addr, uint8_t service_id, 1343911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint32_t mx_chan_id); 13445738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 13455738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1346ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1347ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecClrService 1348ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 13499ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description Removes specified service record(s) from the security 13509ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * database. All service records with the specified name are 13519ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * removed. Typically used only by devices with limited RAM 13529ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * so that it can reuse an old security service record. 1353ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1354ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns Number of records that were freed. 1355ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1356ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1357911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern uint8_t BTM_SecClrService(uint8_t service_id); 13585738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 13595738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1360ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1361ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecAddDevice 1362ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1363ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Add/modify device. This function will be normally called 1364ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * during host startup to restore all required information 1365ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * stored in the NVRAM. 13669ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * dev_class, bd_name, link_key, and features are NULL if 13679ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * unknown 1368ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1369ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true if added OK, else false 1370ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1371ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1372a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern bool BTM_SecAddDevice(const RawAddress& bd_addr, DEV_CLASS dev_class, 1373911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson BD_NAME bd_name, uint8_t* features, 1374911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint32_t trusted_mask[], LINK_KEY link_key, 1375911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint8_t key_type, tBTM_IO_CAP io_cap, 1376911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint8_t pin_length); 13775738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 13785738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1379ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1380ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecDeleteDevice 1381ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1382ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Free resources associated with the device. 1383ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1384ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true if rmoved OK, false if not found 1385ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1386ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1387a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern bool BTM_SecDeleteDevice(const RawAddress& bd_addr); 13885738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 1389415d1120561ba38c7cd00f0e41d8fb69cda97601Andre Eisenbach/******************************************************************************* 1390ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1391ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecClearSecurityFlags 1392ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1393ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Reset the security flags (mark as not-paired) for a given 1394ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * remove device. 1395ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1396ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1397a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern void BTM_SecClearSecurityFlags(const RawAddress& bd_addr); 13985738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 13995738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1400ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1401ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecGetDeviceLinkKey 1402ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1403ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to obtain link key for the device 1404ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * it returns BTM_SUCCESS if link key is available, or 1405ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if Security Manager does not know about 1406ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * the device or device record does not contain link key info 1407ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1408ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successful, otherwise error code 1409ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1410ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1411a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern tBTM_STATUS BTM_SecGetDeviceLinkKey(const RawAddress& bd_addr, 1412c2276b06572ab6fc1f900fbb1f41087e77d47e2aJakub Pawlowski LINK_KEY link_key); 14135738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 14145738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1415ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1416ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecGetDeviceLinkKeyType 1417ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1418ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to obtain link key type for the 1419ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * device. 1420ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * it returns BTM_SUCCESS if link key is available, or 1421ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if Security Manager does not know about 1422ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * the device or device record does not contain link key info 1423ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1424ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_LKEY_TYPE_IGNORE if link key is unknown, link type 1425ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * otherwise. 1426ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1427ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1428c2276b06572ab6fc1f900fbb1f41087e77d47e2aJakub Pawlowskiextern tBTM_LINK_KEY_TYPE BTM_SecGetDeviceLinkKeyType( 1429a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowski const RawAddress& bd_addr); 1430444a8da807abaf5f9e813ce70c56a79160495fb3Satya Calloji 1431444a8da807abaf5f9e813ce70c56a79160495fb3Satya Calloji/******************************************************************************* 1432ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1433ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_PINCodeReply 1434ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1435ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called after Security Manager submitted 1436ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * PIN code request to the UI. 1437ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 14389ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Parameters: bd_addr - Address of the device for which PIN was 14399ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * requested 14409ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * res - result of the operation BTM_SUCCESS if 14419ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * success 1442ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * pin_len - length in bytes of the PIN Code 1443ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * p_pin - pointer to array with the PIN Code 14449ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * trusted_mask - bitwise OR of trusted services 14459ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * (array of uint32_t) 1446ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1447ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 1448ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1449ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1450a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern void BTM_PINCodeReply(const RawAddress& bd_addr, uint8_t res, 1451c2276b06572ab6fc1f900fbb1f41087e77d47e2aJakub Pawlowski uint8_t pin_len, uint8_t* p_pin, 1452c2276b06572ab6fc1f900fbb1f41087e77d47e2aJakub Pawlowski uint32_t trusted_mask[]); 14535738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 14545738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1455ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1456ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecBond 1457ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1458ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to perform bonding with peer device. 1459ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1460ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: bd_addr - Address of the device to bond 1461ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * pin_len - length in bytes of the PIN Code 1462ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * p_pin - pointer to array with the PIN Code 14639ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * trusted_mask - bitwise OR of trusted services 14649ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * (array of uint32_t) 1465ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if successfully initiated, otherwise error 1466ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1467ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1468a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern tBTM_STATUS BTM_SecBond(const RawAddress& bd_addr, uint8_t pin_len, 1469c2276b06572ab6fc1f900fbb1f41087e77d47e2aJakub Pawlowski uint8_t* p_pin, uint32_t trusted_mask[]); 14707fa4fba6f59f97df00aff07dbe8fb21b114b3c2cGanesh Ganapathi Batta 14717fa4fba6f59f97df00aff07dbe8fb21b114b3c2cGanesh Ganapathi Batta/******************************************************************************* 1472ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1473ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecBondByTransport 1474ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 14759ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description Perform bonding by designated transport 1476ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1477ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: bd_addr - Address of the device to bond 1478ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * pin_len - length in bytes of the PIN Code 1479ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * p_pin - pointer to array with the PIN Code 14809ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * trusted_mask - bitwise OR of trusted services 14819ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * (array of uint32_t) 14829ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * transport : Physical transport to use for bonding 14839ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * (BR/EDR or LE) 1484ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1485ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if successfully initiated, otherwise error 1486ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1487ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1488a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern tBTM_STATUS BTM_SecBondByTransport(const RawAddress& bd_addr, 1489911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBT_TRANSPORT transport, 1490911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint8_t pin_len, uint8_t* p_pin, 1491911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint32_t trusted_mask[]); 14925738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 14935738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1494ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1495ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecBondCancel 1496ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1497ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to cancel ongoing bonding process 1498ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * with peer device. 1499ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1500ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if successfully initiated, otherwise error 1501ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1502ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1503a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern tBTM_STATUS BTM_SecBondCancel(const RawAddress& bd_addr); 15045738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 15055738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1506ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1507ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetEncryption 1508ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1509ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to ensure that connection is 1510ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * encrypted. Should be called only on an open connection. 1511ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Typically only needed for connections that first want to 1512ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * bring up unencrypted links, then later encrypt them. 1513ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1514ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: bd_addr - Address of the peer device 1515ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * transport - Link transport 1516ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * p_callback - Pointer to callback function called if 1517ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * this function returns PENDING after required 15189ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * procedures are completed. Can be set to 15199ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * NULL if status is not desired. 15209ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * p_ref_data - pointer to any data the caller wishes to 15219ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * receive in the callback function upon 15229ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * completion. 1523ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * can be set to NULL if not used. 1524ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * sec_act - LE security action, unused for BR/EDR 1525ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1526ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS - already encrypted 1527ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_PENDING - command will be returned in the callback 1528ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_WRONG_MODE- connection not up. 1529ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_BUSY - security procedures are currently active 1530ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_MODE_UNSUPPORTED - if security manager not linked in. 1531ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1532ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1533a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern tBTM_STATUS BTM_SetEncryption(const RawAddress& bd_addr, 1534c2276b06572ab6fc1f900fbb1f41087e77d47e2aJakub Pawlowski tBT_TRANSPORT transport, 1535911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_SEC_CBACK* p_callback, 1536911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson void* p_ref_data, 1537911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_BLE_SEC_ACT sec_act); 15385738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 15395738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1540ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1541ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ConfirmReqReply 1542ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1543ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to confirm the numeric value for 1544ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Simple Pairing in response to BTM_SP_CFM_REQ_EVT 1545ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 15469ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Parameters: res - result of the operation BTM_SUCCESS if 15479ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * success 1548ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * bd_addr - Address of the peer device 1549ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1550ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1551a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern void BTM_ConfirmReqReply(tBTM_STATUS res, const RawAddress& bd_addr); 15525738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 15535738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1554ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1555ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_PasskeyReqReply 1556ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1557ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to provide the passkey for 1558ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Simple Pairing in response to BTM_SP_KEY_REQ_EVT 1559ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 15609ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Parameters: res - result of the operation BTM_SUCCESS if 15619ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * success 1562ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * bd_addr - Address of the peer device 15639ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * passkey - numeric value in the range of 15649ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * 0 - 999999(0xF423F). 1565ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1566ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1567a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern void BTM_PasskeyReqReply(tBTM_STATUS res, const RawAddress& bd_addr, 1568911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint32_t passkey); 15695738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 15705738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1571ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1572ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SendKeypressNotif 1573ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1574ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is used during the passkey entry model 1575ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * by a device with KeyboardOnly IO capabilities 1576ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * (very likely to be a HID Device). 15779ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * It is called by a HID Device to inform the remote device 15789ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * when a key has been entered or erased. 1579ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1580ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: bd_addr - Address of the peer device 1581ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * type - notification type 1582ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1583ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1584a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern void BTM_SendKeypressNotif(const RawAddress& bd_addr, 1585c2276b06572ab6fc1f900fbb1f41087e77d47e2aJakub Pawlowski tBTM_SP_KEY_TYPE type); 15865738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 15875738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1588ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1589ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_IoCapRsp 1590ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1591ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called in response to BTM_SP_IO_REQ_EVT 15929ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * When the event data io_req.oob_data is set to 15939ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_OOB_UNKNOWN by the tBTM_SP_CALLBACK implementation, this 15949ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * function is called to provide the actual response 1595ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1596ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: bd_addr - Address of the peer device 1597ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * io_cap - The IO capability of local device. 1598ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * oob - BTM_OOB_NONE or BTM_OOB_PRESENT. 1599ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * auth_req- MITM protection required or not. 1600ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1601ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1602a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern void BTM_IoCapRsp(const RawAddress& bd_addr, tBTM_IO_CAP io_cap, 1603c2276b06572ab6fc1f900fbb1f41087e77d47e2aJakub Pawlowski tBTM_OOB_DATA oob, tBTM_AUTH_REQ auth_req); 16045738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 16055738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1606ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1607ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadLocalOobData 1608ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1609ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to read the local OOB data from 1610ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * LM 1611ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1612ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1613b6ab9b3af6b8793ff781e0359a78611726ab2300Jakub Pawlowskiextern void BTM_ReadLocalOobData(void); 16145738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 16155738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1616ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1617ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_RemoteOobDataReply 1618ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1619ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to provide the remote OOB data for 1620ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Simple Pairing in response to BTM_SP_RMT_OOB_EVT 1621ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1622ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: bd_addr - Address of the peer device 1623ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * c - simple pairing Hash C. 1624ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * r - simple pairing Randomizer C. 1625ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1626ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1627a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern void BTM_RemoteOobDataReply(tBTM_STATUS res, const RawAddress& bd_addr, 162824933b5b1a06274c47133debac5251a97128a267June R. Tate-Gans BT_OCTET16 c, BT_OCTET16 r); 16295738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 16305738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1631ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1632ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_BuildOobData 1633ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1634ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to build the OOB data payload to 1635ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * be sent over OOB (non-Bluetooth) link 1636ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1637ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: p_data - the location for OOB data 1638ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * max_len - p_data size. 1639ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * c - simple pairing Hash C. 1640ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * r - simple pairing Randomizer C. 1641ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * name_len- 0, local device name would not be included. 1642ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * otherwise, the local device name is included for 1643ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * up to this specified length 1644ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1645ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns Number of bytes in p_data. 1646ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1647ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1648911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern uint16_t BTM_BuildOobData(uint8_t* p_data, uint16_t max_len, 1649911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson BT_OCTET16 c, BT_OCTET16 r, uint8_t name_len); 16505738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 16515738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1652ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1653ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_BothEndsSupportSecureConnections 1654ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 16559ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description This function is called to check if both the local device 16569ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * and the peer device specified by bd_addr support BR/EDR 16579ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Secure Connections. 1658ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1659ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: bd_addr - address of the peer 1660ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 16619ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Returns true if BR/EDR Secure Connections are supported by both 16629ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * local and the remote device. 1663ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * else false. 1664ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1665ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1666a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern bool BTM_BothEndsSupportSecureConnections(const RawAddress& bd_addr); 1667899b77140675a157dba034e98527ab546bc9ac35Mudumba Ananth 1668899b77140675a157dba034e98527ab546bc9ac35Mudumba Ananth/******************************************************************************* 1669ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1670ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_PeerSupportsSecureConnections 1671ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1672ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to check if the peer supports 1673ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BR/EDR Secure Connections. 1674ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1675ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: bd_addr - address of the peer 1676ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1677ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true if BR/EDR Secure Connections are supported by the peer, 1678ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * else false. 1679ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1680ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1681a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern bool BTM_PeerSupportsSecureConnections(const RawAddress& bd_addr); 1682444a8da807abaf5f9e813ce70c56a79160495fb3Satya Calloji 1683444a8da807abaf5f9e813ce70c56a79160495fb3Satya Calloji/******************************************************************************* 1684ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1685ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadOobData 1686ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1687ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to parse the OOB data payload 1688ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * received over OOB (non-Bluetooth) link 1689ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1690ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: p_data - the location for OOB data 1691ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * eir_tag - The associated EIR tag to read the data. 1692ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * *p_len(output) - the length of the data with the given tag. 1693ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1694ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns the beginning of the data with the given tag. 1695ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * NULL, if the tag is not found. 1696ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1697ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1698911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern uint8_t* BTM_ReadOobData(uint8_t* p_data, uint8_t eir_tag, 1699911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint8_t* p_len); 17005738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 17015738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1702ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1703ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecReadDevName 1704ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1705ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Looks for the device name in the security database for the 1706ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * specified BD address. 1707ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1708ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns Pointer to the name or NULL 1709ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1710ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1711a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern char* BTM_SecReadDevName(const RawAddress& bd_addr); 17125738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 17135738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/***************************************************************************** 1714ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * POWER MANAGEMENT FUNCTIONS 1715ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ****************************************************************************/ 1716ee96a3c60fca590d38025925c072d264e06493c4Myles Watson/******************************************************************************* 1717ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1718ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_PmRegister 1719ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1720ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description register or deregister with power manager 1721ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1722ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successful, 1723ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_NO_RESOURCES if no room to hold registration 1724ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ILLEGAL_VALUE 1725ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1726ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1727911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_PmRegister(uint8_t mask, uint8_t* p_pm_id, 1728911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_PM_STATUS_CBACK* p_cb); 17295738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 17305738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1731ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1732ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetPowerMode 1733ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1734ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description store the mode in control block or 1735ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * alter ACL connection behavior. 1736ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1737ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successful, 1738ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if bd addr is not active or bad 1739ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1740ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1741a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern tBTM_STATUS BTM_SetPowerMode(uint8_t pm_id, const RawAddress& remote_bda, 1742911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_PM_PWR_MD* p_mode); 17435738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 17445738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1745ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1746ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadPowerMode 1747ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1748ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This returns the current mode for a specific 1749ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * ACL connection. 1750ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1751ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Input Param remote_bda - device address of desired ACL connection 1752ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1753ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Output Param p_mode - address where the current mode is copied into. 1754ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ACL_MODE_NORMAL 1755ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ACL_MODE_HOLD 1756ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ACL_MODE_SNIFF 1757ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ACL_MODE_PARK 1758ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * (valid only if return code is BTM_SUCCESS) 1759ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1760ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successful, 1761ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if bd addr is not active or bad 1762ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1763ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1764a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern tBTM_STATUS BTM_ReadPowerMode(const RawAddress& remote_bda, 1765c2276b06572ab6fc1f900fbb1f41087e77d47e2aJakub Pawlowski tBTM_PM_MODE* p_mode); 17665738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 17675738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1768ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1769ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetSsrParams 1770ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1771ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This sends the given SSR parameters for the given ACL 1772ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * connection if it is in ACTIVE mode. 1773ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1774ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Input Param remote_bda - device address of desired ACL connection 1775ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * max_lat - maximum latency (in 0.625ms)(0-0xFFFE) 1776ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * min_rmt_to - minimum remote timeout 1777ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * min_loc_to - minimum local timeout 1778ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1779ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1780ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if the HCI command is issued successful, 1781ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if bd addr is not active or bad 1782ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_CMD_STORED if the command is stored 1783ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1784ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1785a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern tBTM_STATUS BTM_SetSsrParams(const RawAddress& remote_bda, 1786c2276b06572ab6fc1f900fbb1f41087e77d47e2aJakub Pawlowski uint16_t max_lat, uint16_t min_rmt_to, 1787c2276b06572ab6fc1f900fbb1f41087e77d47e2aJakub Pawlowski uint16_t min_loc_to); 17885738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 17895738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1790ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1791ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_GetHCIConnHandle 1792ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 17939ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description This function is called to get the handle for an ACL 17949ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * connection to a specific remote BD Address. 1795ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1796ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns the handle of the connection, or 0xFFFF if none. 1797ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1798ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1799a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern uint16_t BTM_GetHCIConnHandle(const RawAddress& remote_bda, 1800911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBT_TRANSPORT transport); 18015738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 18025738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1803ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1804ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_DeleteStoredLinkKey 1805ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1806ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to delete link key for the specified 18079ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * device addresses from the NVRAM storage attached to the 18089ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Bluetooth controller. 1809ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1810ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: bd_addr - Addresses of the devices 1811ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * p_cb - Call back function to be called to return 1812ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * the results 1813ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1814ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1815a484a888196ddf8bcbf1ad3226d6451bc735a94bJakub Pawlowskiextern tBTM_STATUS BTM_DeleteStoredLinkKey(const RawAddress* bd_addr, 1816c2276b06572ab6fc1f900fbb1f41087e77d47e2aJakub Pawlowski tBTM_CMPL_CB* p_cb); 18175738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 18185738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1819ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1820ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_WriteEIR 1821ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1822ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to write EIR data to controller. 1823ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1824ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters p_buff - allocated HCI command buffer including extended 1825ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * inquriry response 1826ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1827ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS - if successful 1828ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_MODE_UNSUPPORTED - if local device cannot support it 1829ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1830ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1831911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_WriteEIR(BT_HDR* p_buff); 18325738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 18335738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1834ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1835ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_HasEirService 1836ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1837ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to know if UUID in bit map of UUID. 1838ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1839ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters p_eir_uuid - bit map of UUID list 1840ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * uuid16 - UUID 16-bit 1841ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1842ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true - if found 1843ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * false - if not found 1844ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1845ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1846911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern bool BTM_HasEirService(uint32_t* p_eir_uuid, uint16_t uuid16); 18475738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 18485738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1849ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1850ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_HasInquiryEirService 1851ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 18529ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description Return if a UUID is in the bit map of a UUID list. 1853ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1854ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters p_results - inquiry results 1855ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * uuid16 - UUID 16-bit 1856ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1857ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_EIR_FOUND - if found 18589ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_EIR_NOT_FOUND - if not found and it is a complete list 1859ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_EIR_UNKNOWN - if not found and it is not complete list 1860ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1861ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1862911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_EIR_SEARCH_RESULT BTM_HasInquiryEirService( 1863911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_INQ_RESULTS* p_results, uint16_t uuid16); 18645738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 18655738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1866ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1867ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_AddEirService 1868ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 18699ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description This function is called to add a service in the bit map UUID 18709ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * list. 1871ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1872ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters p_eir_uuid - bit mask of UUID list for EIR 1873ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * uuid16 - UUID 16-bit 1874ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1875ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns None 1876ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1877ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1878911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern void BTM_AddEirService(uint32_t* p_eir_uuid, uint16_t uuid16); 18795738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 18805738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1881ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1882ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_RemoveEirService 1883ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 18849ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description This function is called to remove a service from the bit map 18859ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * UUID list. 1886ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1887ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters p_eir_uuid - bit mask of UUID list for EIR 1888ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * uuid16 - UUID 16-bit 1889ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1890ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns None 1891ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1892ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1893911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern void BTM_RemoveEirService(uint32_t* p_eir_uuid, uint16_t uuid16); 18945738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 18955738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1896ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1897ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_GetEirSupportedServices 1898ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 18999ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description This function is called to get UUID list from bit map UUID 19009ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * list. 1901ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1902ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters p_eir_uuid - bit mask of UUID list for EIR 1903ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * p - reference of current pointer of EIR 1904ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * max_num_uuid16 - max number of UUID can be written in EIR 1905ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * num_uuid16 - number of UUID have been written in EIR 1906ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1907ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_EIR_MORE_16BITS_UUID_TYPE, if it has more than max 1908ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_EIR_COMPLETE_16BITS_UUID_TYPE, otherwise 1909ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1910ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1911911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern uint8_t BTM_GetEirSupportedServices(uint32_t* p_eir_uuid, uint8_t** p, 1912911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint8_t max_num_uuid16, 1913911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson uint8_t* p_num_uuid16); 19145738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 19155738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1916ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1917ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_GetEirUuidList 1918ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1919ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function parses EIR and returns UUID list. 1920ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1921ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters p_eir - EIR 19220595ca0018ac9980d1dd7e192301f8494a01f9cbJakub Pawlowski * eirl_len - EIR len 1923ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * uuid_size - LEN_UUID_16, LEN_UUID_32, LEN_UUID_128 1924ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * p_num_uuid - return number of UUID in found list 1925ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * p_uuid_list - return UUID 16-bit list 1926ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * max_num_uuid - maximum number of UUID to be returned 1927ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1928ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns 0 - if not found 1929ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_EIR_COMPLETE_16BITS_UUID_TYPE 1930ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_EIR_MORE_16BITS_UUID_TYPE 1931ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_EIR_COMPLETE_32BITS_UUID_TYPE 1932ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_EIR_MORE_32BITS_UUID_TYPE 1933ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_EIR_COMPLETE_128BITS_UUID_TYPE 1934ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_EIR_MORE_128BITS_UUID_TYPE 1935ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1936ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 19370595ca0018ac9980d1dd7e192301f8494a01f9cbJakub Pawlowskiextern uint8_t BTM_GetEirUuidList(uint8_t* p_eir, size_t eir_len, 19380595ca0018ac9980d1dd7e192301f8494a01f9cbJakub Pawlowski uint8_t uuid_size, uint8_t* p_num_uuid, 19390595ca0018ac9980d1dd7e192301f8494a01f9cbJakub Pawlowski uint8_t* p_uuid_list, uint8_t max_num_uuid); 19405738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 19415738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/***************************************************************************** 1942ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * SCO OVER HCI 1943ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ****************************************************************************/ 1944ee96a3c60fca590d38025925c072d264e06493c4Myles Watson/******************************************************************************* 1945ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1946ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ConfigScoPath 1947ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1948ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function enable/disable SCO over HCI and registers SCO 1949ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * data callback if SCO over HCI is enabled. 1950ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1951ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameter path: SCO or HCI 1952ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * p_sco_data_cb: callback function or SCO data if path is set 1953ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * to transport. 19549ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * p_pcm_param: pointer to the PCM interface parameter. If a 19559ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * NULL pointer is used, the PCM parameter 19569ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * maintained in the control block will be used; 19579ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * otherwise update the control block value. 19589ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * err_data_rpt: Lisbon feature to enable the erronous data 19599ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * report or not. 1960ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1961ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if the successful. 1962ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_NO_RESOURCES: no rsource to start the command. 1963ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ILLEGAL_VALUE: invalid callback function pointer. 19649ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_CMD_STARTED : Command sent. Waiting for command 19659ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * complete event. 1966ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1967ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1968ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 196957f6508cf7b22788fa2e7a739cec241b785718fbMudumba Ananthextern tBTM_STATUS BTM_ConfigScoPath(esco_data_path_t path, 1970911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_SCO_DATA_CB* p_sco_data_cb, 1971911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_SCO_PCM_PARAM* p_pcm_param, 1972911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson bool err_data_rpt); 19735738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 19745738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1975ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1976ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_WriteScoData 1977ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 19789ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description This function write SCO data to a specified instance. The 19799ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * data to be written p_buf needs to carry an offset of 1980ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * HCI_SCO_PREAMBLE_SIZE bytes, and the data length can not 19819ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * exceed BTM_SCO_DATA_SIZE_MAX bytes, whose default value is 19829ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * set to 60 and is configurable. Data longer than the maximum 19839ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * bytes will be truncated. 1984ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1985ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS: data write is successful 1986ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ILLEGAL_VALUE: SCO data contains illegal offset value. 19879ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_SCO_BAD_LENGTH: SCO data length exceeds the max SCO 19889ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * packet size. 1989ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_NO_RESOURCES: no resources. 19909ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_UNKNOWN_ADDR: unknown SCO connection handle, or SCO is 19919ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * not routed via HCI. 1992ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1993ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1994ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1995911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern tBTM_STATUS BTM_WriteScoData(uint16_t sco_inx, BT_HDR* p_buf); 19965738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 19975738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1998ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1999ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetARCMode 2000ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2001ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Send Audio Routing Control command. 2002ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2003ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 2004ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2005ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 2006911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern void BTM_SetARCMode(uint8_t iface, uint8_t arc_mode, 2007911d1ae03efec2d54c3b1b605589d790d1745488Myles Watson tBTM_VSC_CMPL_CB* p_arc_cb); 20085738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 20095738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 2010ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2011ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_PCM2Setup_Write 2012ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2013ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Send PCM2_Setup write command. 2014ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2015ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 2016ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2017ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 2018911d1ae03efec2d54c3b1b605589d790d1745488Myles Watsonextern void BTM_PCM2Setup_Write(bool clk_master, tBTM_VSC_CMPL_CB* p_arc_cb); 2019e5ba8841cd39e17c05aeb4ab65b5b761d41577daSatya Calloji 2020e5ba8841cd39e17c05aeb4ab65b5b761d41577daSatya Calloji/******************************************************************************* 2021ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2022ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_PM_ReadControllerState 2023ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2024ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to obtain the controller state 2025ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 20269ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Returns Controller state (BTM_CONTRL_ACTIVE, BTM_CONTRL_SCAN, and 20279ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_CONTRL_IDLE) 2028ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2029ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 203024933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_CONTRL_STATE BTM_PM_ReadControllerState(void); 2031e5ba8841cd39e17c05aeb4ab65b5b761d41577daSatya Calloji 20325738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project#endif /* BTM_API_H */ 2033