btm_api.h revision 9ca07091a1f07ea201cee0504dab6a1d7073d429
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" 295738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project#include "sdp_api.h" 305738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project#include "hcidefs.h" 315738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 325738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project#include "smp_api.h" 333d6accfcc0bdc5c7a8713320c9bb069cbf253348Bryce Lee 34dc3c1f2afa2d5f311c3ea42bda432089a7f303a4Jakub Pawlowski#include "btm_api_types.h" 35dc3c1f2afa2d5f311c3ea42bda432089a7f303a4Jakub Pawlowski 363d6accfcc0bdc5c7a8713320c9bb069cbf253348Bryce Lee#ifdef __cplusplus 373d6accfcc0bdc5c7a8713320c9bb069cbf253348Bryce Leeextern "C" { 383d6accfcc0bdc5c7a8713320c9bb069cbf253348Bryce Lee#endif 393d6accfcc0bdc5c7a8713320c9bb069cbf253348Bryce Lee 405738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/***************************************************************************** 41ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * DEVICE CONTROL and COMMON 42ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ****************************************************************************/ 43e5ba8841cd39e17c05aeb4ab65b5b761d41577daSatya Calloji 445738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/***************************************************************************** 45ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * EXTERNAL FUNCTION DECLARATIONS 46ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ****************************************************************************/ 475738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 485738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/***************************************************************************** 49ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * DEVICE CONTROL and COMMON FUNCTIONS 50ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ****************************************************************************/ 51ee96a3c60fca590d38025925c072d264e06493c4Myles Watson 52ee96a3c60fca590d38025925c072d264e06493c4Myles Watson/******************************************************************************* 53ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 54ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_DeviceReset 55ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 569ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description This function is called to reset the controller. The 579ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Callback function if provided is called when startup of the 589ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * device has completed. 59ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 60ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 61ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 62ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 6324933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern void BTM_DeviceReset (tBTM_CMPL_CB *p_cb); 645738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 655738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 665738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 67ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 68ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_IsDeviceUp 69ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 70ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to check if the device is up. 71ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 72ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true if device is up, else false 73ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 74ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 75d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern bool BTM_IsDeviceUp (void); 765738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 775738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 785738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 79ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 80ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetLocalDeviceName 81ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 82ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to set the local device name. 83ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 84ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if successful, otherwise an error 85ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 86ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 8724933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_SetLocalDeviceName (char *p_name); 885738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 895738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 90ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 91ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetDeviceClass 92ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 93ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to set the local device class 94ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 95ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successful, otherwise an error 96ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 97ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 9824933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_SetDeviceClass (DEV_CLASS dev_class); 995738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 1005738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 1015738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 102ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 103ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadLocalDeviceName 104ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 105ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to read the local device name. 106ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 107ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns status of the operation 108ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * If success, BTM_SUCCESS is returned and p_name points stored 109ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * local device name 110ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * If BTM doesn't store local device name, BTM_NO_RESOURCES is 111ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * is returned and p_name is set to NULL 112ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 113ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 11424933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_ReadLocalDeviceName (char **p_name); 1155738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 1165738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 117ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 118ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadLocalDeviceNameFromController 119ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 120ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Get local device name from controller. Do not use cached 121ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * name (used to get chip-id prior to btm reset complete). 122ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 123ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if successful, otherwise an error 124ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 125ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 12624933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_ReadLocalDeviceNameFromController (tBTM_CMPL_CB *p_rln_cmpl_cback); 1275738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 1285738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 129ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 130ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadDeviceClass 131ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 132ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to read the local device class 133ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 134ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns pointer to the device class 135ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 136ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 137d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern uint8_t *BTM_ReadDeviceClass (void); 1385738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 1395738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 1405738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 141ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 142ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadLocalFeatures 143ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 144ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to read the local features 145ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 146ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns pointer to the local features string 147ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 148ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 149d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern uint8_t *BTM_ReadLocalFeatures (void); 1505738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 1515738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 152ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 153ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_RegisterForDeviceStatusNotif 154ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 155ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to register for device status 156ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * change notifications. 157ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1589ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Returns pointer to previous caller's callback function or NULL if 1599ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * first registration. 160ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 161ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 16224933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_DEV_STATUS_CB *BTM_RegisterForDeviceStatusNotif (tBTM_DEV_STATUS_CB *p_cb); 1635738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 1645738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 1655738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 166ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 167ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_RegisterForVSEvents 168ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 169ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to register/deregister for vendor 170ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * specific HCI events. 171ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 172ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * If is_register=true, then the function will be registered; 1739ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * otherwise the function will be deregistered. 174ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 175ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successful, 176ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_BUSY if maximum number of callbacks have already been 177ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * registered. 178ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 179ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 180d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern tBTM_STATUS BTM_RegisterForVSEvents (tBTM_VS_EVT_CB *p_cb, bool is_register); 1815738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 1825738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 1835738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 184ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 185ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_VendorSpecificCommand 186ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 187ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Send a vendor specific HCI command to the controller. 188ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 189ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1903d5fbcaf9f191737b1c818523e1bf6831c50d586Jakub Pawlowskiextern void BTM_VendorSpecificCommand(uint16_t opcode, 1913d5fbcaf9f191737b1c818523e1bf6831c50d586Jakub Pawlowski uint8_t param_len, 1923d5fbcaf9f191737b1c818523e1bf6831c50d586Jakub Pawlowski uint8_t *p_param_buf, 1933d5fbcaf9f191737b1c818523e1bf6831c50d586Jakub Pawlowski tBTM_VSC_CMPL_CB *p_cb); 1945738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 1955738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 1965738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 197ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 198ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_AllocateSCN 199ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 200ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Look through the Server Channel Numbers for a free one to be 201ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * used with an RFCOMM connection. 202ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 203ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns Allocated SCN number or 0 if none. 204ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 205ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 206d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern uint8_t BTM_AllocateSCN(void); 2075738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 2085738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 209ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 210ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_TryAllocateSCN 211ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 212ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Try to allocate a fixed server channel 213ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 214ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns Returns true if server channel was available 215ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 216ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 217d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern bool BTM_TryAllocateSCN(uint8_t scn); 2185738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 2195738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 2205738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 221ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 222ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_FreeSCN 223ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 224ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Free the specified SCN. 225ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 226ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true if successful, false if SCN is not in use or invalid 227ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 228ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 229d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern bool BTM_FreeSCN(uint8_t scn); 2305738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 2315738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 2325738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 233ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 234ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetTraceLevel 235ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 236ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function sets the trace level for BTM. If called with 237ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * a value of 0xFF, it simply returns the current trace level. 238ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 239ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns The new or current trace level 240ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 241ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 242d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern uint8_t BTM_SetTraceLevel (uint8_t new_level); 2435738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 2445738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 2455738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 246ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 247ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_WritePageTimeout 248ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 249ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Send HCI Wite Page Timeout. 250ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 251ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 252b6ab9b3af6b8793ff781e0359a78611726ab2300Jakub Pawlowskiextern void BTM_WritePageTimeout(uint16_t timeout); 2535738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 2545738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 255ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 256ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_WriteVoiceSettings 257ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 258ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Send HCI Write Voice Settings command. 259ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * See hcidefs.h for settings bitmask values. 260ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 261ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 262b6ab9b3af6b8793ff781e0359a78611726ab2300Jakub Pawlowskiextern void BTM_WriteVoiceSettings(uint16_t settings); 2635738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 2645738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 265ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 266ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_EnableTestMode 267ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 268ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Send HCI the enable device under test command. 269ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 270ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Note: Controller can only be taken out of this mode by 271ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * resetting the controller. 272ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 273ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns 274ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SUCCESS Command sent. 275ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_NO_RESOURCES If out of resources to send the command. 276ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 277ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 278ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 27924933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_EnableTestMode(void); 2805738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 2815738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 2829ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson/******************************************************************************* 2839ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * DEVICE DISCOVERY FUNCTIONS - Inquiry, Remote Name, Discovery, Class of Device 2849ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson ******************************************************************************/ 285ee96a3c60fca590d38025925c072d264e06493c4Myles Watson 286ee96a3c60fca590d38025925c072d264e06493c4Myles Watson/******************************************************************************* 287ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 288ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetDiscoverability 289ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 290ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to set the device into or out of 291ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * discoverable mode. Discoverable mode means inquiry 2929ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * scans are enabled. If a value of '0' is entered for window 2939ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * or interval, the default values are used. 294ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 295ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successful 296ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_BUSY if a setting of the filter is already in progress 297ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_NO_RESOURCES if couldn't get a memory pool buffer 298ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ILLEGAL_VALUE if a bad parameter was detected 299ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_WRONG_MODE if the device is not up. 300ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 301ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 302d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern tBTM_STATUS BTM_SetDiscoverability (uint16_t inq_mode, uint16_t window, 303d19e0785e662e640191a075eda07acce61c2aedaMarie Janssen uint16_t interval); 3045738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 3055738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 3065738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 307ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 308ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadDiscoverability 309ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 310ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to read the current discoverability 311ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * mode of the device. 312ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 313ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Output Params: p_window - current inquiry scan duration 314ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * p_interval - current inquiry scan interval 315ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 316ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_NON_DISCOVERABLE, BTM_LIMITED_DISCOVERABLE, or 317ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_GENERAL_DISCOVERABLE 318ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 319ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 320d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern uint16_t BTM_ReadDiscoverability (uint16_t *p_window, 321d19e0785e662e640191a075eda07acce61c2aedaMarie Janssen uint16_t *p_interval); 3225738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 3235738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 3245738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 325ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 326ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetPeriodicInquiryMode 327ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 3289ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description This function is called to set the device periodic inquiry 3299ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * mode. If the duration is zero, the periodic inquiry mode is 3309ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * cancelled. 331ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 332ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: p_inqparms - pointer to the inquiry information 333ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * mode - GENERAL or LIMITED inquiry 3349ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * duration - length in 1.28 sec intervals (If '0', the 3359ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * inquiry is CANCELLED) 3369ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * max_resps - maximum amount of devices to search for 3379ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * before ending the inquiry 3389ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * filter_cond_type - BTM_CLR_INQUIRY_FILTER, 3399ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_FILTER_COND_DEVICE_CLASS, or 340ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_FILTER_COND_BD_ADDR 3419ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * filter_cond - value for the filter (based on 3429ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * filter_cond_type) 343ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 3449ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * max_delay - maximum amount of time between successive 3459ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * inquiries 3469ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * min_delay - minimum amount of time between successive 3479ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * inquiries 3489ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * p_results_cb - callback returning pointer to results 3499ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * (tBTM_INQ_RESULTS) 350ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 351ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if successfully started 352ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ILLEGAL_VALUE if a bad parameter is detected 353ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_NO_RESOURCES if could not allocate a message buffer 354ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SUCCESS - if cancelling the periodic inquiry 355ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_BUSY - if an inquiry is already active 356ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_WRONG_MODE if the device is not up. 357ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 358ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 35924933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_SetPeriodicInquiryMode (tBTM_INQ_PARMS *p_inqparms, 360d19e0785e662e640191a075eda07acce61c2aedaMarie Janssen uint16_t max_delay, uint16_t min_delay, 36124933b5b1a06274c47133debac5251a97128a267June R. Tate-Gans tBTM_INQ_RESULTS_CB *p_results_cb); 3625738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 3635738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 3645738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 365ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 366ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_StartInquiry 367ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 368ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to start an inquiry. 369ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 370ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: p_inqparms - pointer to the inquiry information 371ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * mode - GENERAL or LIMITED inquiry 3729ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * duration - length in 1.28 sec intervals (If '0', the 3739ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * inquiry is CANCELLED) 3749ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * max_resps - maximum amount of devices to search for 3759ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * before ending the inquiry 3769ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * filter_cond_type - BTM_CLR_INQUIRY_FILTER, 3779ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_FILTER_COND_DEVICE_CLASS, or 378ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_FILTER_COND_BD_ADDR 3799ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * filter_cond - value for the filter (based on 3809ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * filter_cond_type) 3819ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * 3829ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * p_results_cb - Pointer to the callback routine which gets 3839ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * called upon receipt of an inquiry result. If 3849ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * this field is NULL, the application is not 3859ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * notified. 3869ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * 3879ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * p_cmpl_cb - Pointer to the callback routine which gets 3889ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * called upon completion. If this field is 3899ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * NULL, the application is not notified when 3909ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * completed. 391ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns tBTM_STATUS 392ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_CMD_STARTED if successfully initiated 393ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_BUSY if already in progress 394ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ILLEGAL_VALUE if parameter(s) are out of range 3959ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_NO_RESOURCES if could not allocate resources to start 3969ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * the command 397ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_WRONG_MODE if the device is not up. 398ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 399ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 40024933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_StartInquiry (tBTM_INQ_PARMS *p_inqparms, 40124933b5b1a06274c47133debac5251a97128a267June R. Tate-Gans tBTM_INQ_RESULTS_CB *p_results_cb, 40224933b5b1a06274c47133debac5251a97128a267June R. Tate-Gans tBTM_CMPL_CB *p_cmpl_cb); 4035738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 4045738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 4055738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 406ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 407ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_IsInquiryActive 408ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 4099ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description Return a bit mask of the current inquiry state 410ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 411ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_INQUIRY_INACTIVE if inactive (0) 412ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_LIMITED_INQUIRY_ACTIVE if a limted inquiry is active 413ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_GENERAL_INQUIRY_ACTIVE if a general inquiry is active 414ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_PERIODIC_INQUIRY_ACTIVE if a periodic inquiry is active 415ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 416ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 417d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern uint16_t BTM_IsInquiryActive (void); 4185738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 4195738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 4205738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 421ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 422ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_CancelInquiry 423ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 424ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function cancels an inquiry if active 425ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 426ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successful 427ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_NO_RESOURCES if could not allocate a message buffer 428ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_WRONG_MODE if the device is not up. 429ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 430ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 43124933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_CancelInquiry(void); 4325738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 4335738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 4345738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 435ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 436ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_CancelPeriodicInquiry 437ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 438ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function cancels a periodic inquiry 439ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 440ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns 441ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_NO_RESOURCES if could not allocate a message buffer 442ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SUCCESS - if cancelling the periodic inquiry 443ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_WRONG_MODE if the device is not up. 444ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 445ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 44624933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_CancelPeriodicInquiry(void); 4475738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 4485738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 4495738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 450ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 451ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetConnectability 452ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 453ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to set the device into or out of 4549ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * connectable mode. Discoverable mode means page scans are 4559ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * enabled. 456ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 457ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successful 458ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ILLEGAL_VALUE if a bad parameter is detected 459ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_NO_RESOURCES if could not allocate a message buffer 460ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_WRONG_MODE if the device is not up. 461ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 462ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 463d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern tBTM_STATUS BTM_SetConnectability (uint16_t page_mode, uint16_t window, 464d19e0785e662e640191a075eda07acce61c2aedaMarie Janssen uint16_t interval); 4655738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 4665738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 4675738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 468ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 469ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadConnectability 470ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 471ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to read the current discoverability 472ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * mode of the device. 473ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Output Params p_window - current page scan duration 474ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * p_interval - current time between page scans 475ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 476ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_NON_CONNECTABLE or BTM_CONNECTABLE 477ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 478ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 479d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern uint16_t BTM_ReadConnectability (uint16_t *p_window, uint16_t *p_interval); 4805738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 4815738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 4825738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 483ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 484ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetInquiryMode 485ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 486ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to set standard, with RSSI 487ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * mode or extended of the inquiry for local device. 488ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 489ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Input Params: BTM_INQ_RESULT_STANDARD, BTM_INQ_RESULT_WITH_RSSI or 490ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_INQ_RESULT_EXTENDED 491ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 492ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successful 493ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_NO_RESOURCES if couldn't get a memory pool buffer 494ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ILLEGAL_VALUE if a bad parameter was detected 495ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_WRONG_MODE if the device is not up. 496ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 497ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 498d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern tBTM_STATUS BTM_SetInquiryMode (uint8_t mode); 4995738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 5005738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 501ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 502ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetInquiryScanType 503ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 504ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to set the iquiry scan-type to 505ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * standard or interlaced. 506ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 507ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Input Params: BTM_SCAN_TYPE_STANDARD or BTM_SCAN_TYPE_INTERLACED 508ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 509ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successful 510ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_MODE_UNSUPPORTED if not a 1.2 device 511ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_WRONG_MODE if the device is not up. 512ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 513ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 514d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern tBTM_STATUS BTM_SetInquiryScanType (uint16_t scan_type); 5155738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 5165738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 517ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 518ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetPageScanType 519ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 520ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to set the page scan-type to 521ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * standard or interlaced. 522ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 523ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Input Params: BTM_SCAN_TYPE_STANDARD or BTM_SCAN_TYPE_INTERLACED 524ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 525ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successful 526ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_MODE_UNSUPPORTED if not a 1.2 device 527ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_WRONG_MODE if the device is not up. 528ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 529ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 5305738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 531d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern tBTM_STATUS BTM_SetPageScanType (uint16_t scan_type); 5325738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 5335738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 534ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 535ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadRemoteDeviceName 536ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 537ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function initiates a remote device HCI command to the 5389ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * controller and calls the callback when the process has 5399ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * completed. 540ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 541ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Input Params: remote_bda - device address of name to retrieve 5429ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * p_cb - callback function called when 5439ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_CMD_STARTED is returned. 5449ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * A pointer to tBTM_REMOTE_DEV_NAME is 5459ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * passed to the callback. 546ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 547ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns 5489ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_CMD_STARTED is returned if the request was successfully 5499ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * sent to HCI. 550ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_BUSY if already in progress 551ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if device address is bad 5529ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_NO_RESOURCES if resources could not be allocated to 5539ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * start the command 554ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_WRONG_MODE if the device is not up. 555ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 556ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 55724933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_ReadRemoteDeviceName (BD_ADDR remote_bda, 55824933b5b1a06274c47133debac5251a97128a267June R. Tate-Gans tBTM_CMPL_CB *p_cb, 55924933b5b1a06274c47133debac5251a97128a267June R. Tate-Gans tBT_TRANSPORT transport); 5605738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 5615738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 5625738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 563ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 564ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_CancelRemoteDeviceName 565ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 566ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function initiates the cancel request for the specified 567ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * remote device. 568ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 569ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Input Params: None 570ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 571ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns 5729ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_CMD_STARTED is returned if the request was successfully 5739ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * sent to HCI. 5749ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_NO_RESOURCES if resources could not be allocated to 5759ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * start the command 5769ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_WRONG_MODE if there is no active remote name request. 577ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 578ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 57924933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_CancelRemoteDeviceName (void); 5805738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 5815738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 582ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 583ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadRemoteVersion 584ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 585ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to read a remote device's version 586ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 587ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successful, otherwise an error 588ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 589ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 59024933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_ReadRemoteVersion (BD_ADDR addr, 591d19e0785e662e640191a075eda07acce61c2aedaMarie Janssen uint8_t *lmp_version, 592d19e0785e662e640191a075eda07acce61c2aedaMarie Janssen uint16_t *manufacturer, 593d19e0785e662e640191a075eda07acce61c2aedaMarie Janssen uint16_t *lmp_sub_version); 5945738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 5955738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 596ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 597ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadRemoteFeatures 598ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 599ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to read a remote device's 600ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * supported features mask (features mask located at page 0) 601ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 602ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Note: The size of device features mask page is 603ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_FEATURE_BYTES_PER_PAGE bytes. 604ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 605ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns pointer to the remote supported features mask 606ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 607ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 608d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern uint8_t *BTM_ReadRemoteFeatures (BD_ADDR addr); 6095738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 6105738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 611ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 612ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadRemoteExtendedFeatures 613ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 614ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to read a specific extended features 615ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * page of the remote device 616ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 617ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Note1: The size of device features mask page is 618ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_FEATURE_BYTES_PER_PAGE bytes. 619ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Note2: The valid device features mask page number depends on 620ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * the remote device capabilities. It is expected to be in the 621ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * range [0 - BTM_EXT_FEATURES_PAGE_MAX]. 622ee96a3c60fca590d38025925c072d264e06493c4Myles Watson 623ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns pointer to the remote extended features mask 624ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * or NULL if page_number is not valid 625ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 626ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 627d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern uint8_t *BTM_ReadRemoteExtendedFeatures (BD_ADDR addr, uint8_t page_number); 6283aa60544585b5fb0f35c1165539a4a859fc0f25cAndre Eisenbach 6293aa60544585b5fb0f35c1165539a4a859fc0f25cAndre Eisenbach/******************************************************************************* 630ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 631ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadNumberRemoteFeaturesPages 632ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 6339ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description This function is called to retrieve the number of feature 6349ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * pages read from the remote device 635ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 636ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns number of features pages read from the remote device 637ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 638ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 639d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern uint8_t BTM_ReadNumberRemoteFeaturesPages (BD_ADDR addr); 6403aa60544585b5fb0f35c1165539a4a859fc0f25cAndre Eisenbach 6413aa60544585b5fb0f35c1165539a4a859fc0f25cAndre Eisenbach/******************************************************************************* 642ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 643ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadAllRemoteFeatures 644ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 6459ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description Read all the features of the remote device 646ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 647ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns pointer to the byte[0] of the page[0] of the remote device 648ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * feature mask. 649ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 650ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Note: the function returns the pointer to the array of the size 6519ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_FEATURE_BYTES_PER_PAGE * (BTM_EXT_FEATURES_PAGE_MAX + 1) 652ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 653ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 654d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern uint8_t *BTM_ReadAllRemoteFeatures (BD_ADDR addr); 6553aa60544585b5fb0f35c1165539a4a859fc0f25cAndre Eisenbach 6563aa60544585b5fb0f35c1165539a4a859fc0f25cAndre Eisenbach/******************************************************************************* 657ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 658ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_InqDbRead 659ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 660ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function looks through the inquiry database for a match 661ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * based on Bluetooth Device Address. This is the application's 6629ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * interface to get the inquiry details of a specific BD 6639ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * address. 664ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 665ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns pointer to entry, or NULL if not found 666ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 667ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 668063ca0230d902b1397bb8c19366e807980d876f3Jakub Pawlowskiextern tBTM_INQ_INFO *BTM_InqDbRead (const BD_ADDR p_bda); 6695738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 6705738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 6715738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 672ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 673ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_InqDbFirst 674ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 6759ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description This function looks through the inquiry database for the 6769ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * first used entry, and returns that. This is used in 6779ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * conjunction with BTM_InqDbNext by applications as a way to 6789ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * walk through the inquiry database. 679ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 680ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns pointer to first in-use entry, or NULL if DB is empty 681ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 682ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 68324933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_INQ_INFO *BTM_InqDbFirst (void); 6845738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 6855738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 6865738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 687ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 688ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_InqDbNext 689ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 6909ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description This function looks through the inquiry database for the 6919ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * next used entry, and returns that. If the input parameter 6929ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * is NULL, the first entry is returned. 693ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 694ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns pointer to next in-use entry, or NULL if no more found. 695ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 696ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 69724933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_INQ_INFO *BTM_InqDbNext (tBTM_INQ_INFO *p_cur); 6985738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 6995738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 7005738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 701ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 702ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ClearInqDb 703ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 704ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to clear out a device or all devices 705ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * from the inquiry database. 706ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 707ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameter p_bda - (input) BD_ADDR -> Address of device to clear 708ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * (NULL clears all entries) 709ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 710ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_BUSY if an inquiry, get remote name, or event filter 711ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * is active, otherwise BTM_SUCCESS 712ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 713ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 71424933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_ClearInqDb (BD_ADDR p_bda); 7155738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 7165738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 717ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 718ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadInquiryRspTxPower 719ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 720ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This command will read the inquiry Transmit Power level used 721ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * to transmit the FHS and EIR data packets. 7229ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * This can be used directly in the Tx Power Level EIR data 7239ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * type. 724ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 725ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successful 726ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 727ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 72824933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_ReadInquiryRspTxPower (tBTM_CMPL_CB *p_cb); 7295738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 7305738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 731ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 732ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_StartDiscovery 733ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 734ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called by an application (or profile) 735ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * when it wants to trigger an service discovery using the 736ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM's discovery database. 737ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 738ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns tBTM_STATUS 739ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_CMD_STARTED if the discovery was initiated 740ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_BUSY if one is already in progress 741ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if no addresses are in the INQ DB 742ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ERR_PROCESSING if err initiating the command 743ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 744ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 74524933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_StartDiscovery (tBTM_CMPL_CB *p_cmpl_cb, 74624933b5b1a06274c47133debac5251a97128a267June R. Tate-Gans BD_ADDR_PTR p_rem_addr); 7475738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 7485738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 7495738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 750ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 751ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_FindAttribute 752ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 753ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called by an application (or profile) 754ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * when it wants to see if an attribute exists in the BTM 755ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * discovery database. 756ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 757ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns Pointer to matching record, or NULL 758ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 759ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 760d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern tSDP_DISC_REC *BTM_FindAttribute (uint16_t attr_id, 76124933b5b1a06274c47133debac5251a97128a267June R. Tate-Gans tSDP_DISC_REC *p_start_rec); 7625738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 7635738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 7645738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 765ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 766ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_FindService 767ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 768ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called by an application (or profile) 769ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * when it wants to see if a service exists in the BTM 770ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * discovery database. 771ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 772ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns Pointer to matching record, or NULL 773ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 774ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 775d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern tSDP_DISC_REC *BTM_FindService (uint16_t service_uuid, 77624933b5b1a06274c47133debac5251a97128a267June R. Tate-Gans tSDP_DISC_REC *p_start_rec); 7775738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 7785738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 7795738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 780ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 781ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetDiscoveryParams 782ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 7839ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description This function is called to set the BTM default discovery 7849ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * parameters. These UUID and attribute filters are used during 7859ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * the call to BTM_StartDiscovery. 786ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 787ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 788ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 789ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 790d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern void BTM_SetDiscoveryParams (uint16_t num_uuid, tSDP_UUID *p_uuid_list, 791d19e0785e662e640191a075eda07acce61c2aedaMarie Janssen uint16_t num_attr, uint16_t *p_attr_list); 7925738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 7935738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 7945738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/***************************************************************************** 795ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * ACL CHANNEL MANAGEMENT FUNCTIONS 796ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ****************************************************************************/ 797ee96a3c60fca590d38025925c072d264e06493c4Myles Watson/******************************************************************************* 798ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 799ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetLinkPolicy 800ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 801ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Create and send HCI "Write Policy Set" command 802ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 803ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if successfully initiated, otherwise error 804ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 805ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 80624933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_SetLinkPolicy (BD_ADDR remote_bda, 807d19e0785e662e640191a075eda07acce61c2aedaMarie Janssen uint16_t *settings); 8085738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 8095738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 810ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 811ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetDefaultLinkPolicy 812ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 813ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Set the default value for HCI "Write Policy Set" command 814ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * to use when an ACL link is created. 815ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 816ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 817ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 818ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 819ee96a3c60fca590d38025925c072d264e06493c4Myles Watsonextern void BTM_SetDefaultLinkPolicy (uint16_t settings); 820ee96a3c60fca590d38025925c072d264e06493c4Myles Watson 821ee96a3c60fca590d38025925c072d264e06493c4Myles Watson 8225738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 823ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 824ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetDefaultLinkSuperTout 825ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 8269ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description Set the default value for HCI "Write Link Supervision 8279ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Timeout" command to use when an ACL link is created. 828ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 829ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 830ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 831ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 832d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern void BTM_SetDefaultLinkSuperTout (uint16_t timeout); 8335738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 8345738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 8355738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 836ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 837ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetLinkSuperTout 838ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 839ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Create and send HCI "Write Link Supervision Timeout" command 840ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 841ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if successfully initiated, otherwise error 842ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 843ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 84424933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_SetLinkSuperTout (BD_ADDR remote_bda, 845d19e0785e662e640191a075eda07acce61c2aedaMarie Janssen uint16_t timeout); 846ead3cde4bac0c3e32cd31f149093f004eef8ceebGanesh Ganapathi Batta/******************************************************************************* 847ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 848ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_GetLinkSuperTout 849ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 850ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Read the link supervision timeout value of the connection 851ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 852ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns status of the operation 853ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 854ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 85524933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_GetLinkSuperTout (BD_ADDR remote_bda, 856d19e0785e662e640191a075eda07acce61c2aedaMarie Janssen uint16_t *p_timeout); 8575738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 8585738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 859ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 860ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_IsAclConnectionUp 861ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 862ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to check if an ACL connection exists 863ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * to a specific remote BD Address. 864ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 865ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true if connection is up, else false. 866ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 867ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 868d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern bool BTM_IsAclConnectionUp (BD_ADDR remote_bda, tBT_TRANSPORT transport); 8695738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 8705738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 8715738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 872ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 873ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_GetRole 874ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 875ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to get the role of the local device 876ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * for the ACL connection with the specified remote device 877ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 878ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if connection exists. 879ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if no active link with bd addr specified 880ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 881ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 882d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern tBTM_STATUS BTM_GetRole (BD_ADDR remote_bd_addr, uint8_t *p_role); 8835738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 8845738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 8855738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 8865738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 887ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 888ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SwitchRole 889ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 890ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to switch role between master and 891ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * slave. If role is already set it will do nothing. If the 892ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * command was initiated, the callback function is called upon 893ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * completion. 894ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 895ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if already in specified role. 896ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_CMD_STARTED if command issued to controller. 8979ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_NO_RESOURCES if memory couldn't be allocated to issue 8989ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * the command 899ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if no active link with bd addr specified 9009ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_MODE_UNSUPPORTED if the local device does not support 9019ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * role switching 902ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 903ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 90424933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_SwitchRole (BD_ADDR remote_bd_addr, 905d19e0785e662e640191a075eda07acce61c2aedaMarie Janssen uint8_t new_role, 90624933b5b1a06274c47133debac5251a97128a267June R. Tate-Gans tBTM_CMPL_CB *p_cb); 9075738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 9085738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 909ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 910ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadRSSI 911ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 912ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to read the link policy settings. 9139ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * The address of link policy results are returned in the 9149ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * callback. (tBTM_RSSI_RESULTS) 915ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 916ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if command issued to controller. 9179ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_NO_RESOURCES if memory couldn't be allocated to issue 9189ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * the command 919ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if no active link with bd addr specified 920ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_BUSY if command is already in progress 921ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 922ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 923063ca0230d902b1397bb8c19366e807980d876f3Jakub Pawlowskiextern tBTM_STATUS BTM_ReadRSSI (const BD_ADDR remote_bda, tBTM_CMPL_CB *p_cb); 9245738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 9255738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 9265738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 927ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 928ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadTxPower 929ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 930ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to read the current connection 931ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * TX power of the connection. The TX power level results 932ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * are returned in the callback. 933ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * (tBTM_RSSI_RESULTS) 934ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 935ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if command issued to controller. 9369ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_NO_RESOURCES if memory couldn't be allocated to issue 9379ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * the command 938ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if no active link with bd addr specified 939ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_BUSY if command is already in progress 940ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 941ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 94224933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_ReadTxPower (BD_ADDR remote_bda, 94324933b5b1a06274c47133debac5251a97128a267June R. Tate-Gans tBT_TRANSPORT transport, tBTM_CMPL_CB *p_cb); 9445738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 9455738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 946ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 947ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadLinkQuality 948ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 949ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to read the link quality. 950ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * The value of the link quality is returned in the callback. 951ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * (tBTM_LINK_QUALITY_RESULTS) 952ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 953ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if command issued to controller. 9549ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_NO_RESOURCES if memory couldn't be allocated to issue 9559ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * the command 956ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if no active link with bd addr specified 957ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_BUSY if command is already in progress 958ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 959ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 96024933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_ReadLinkQuality (BD_ADDR remote_bda, tBTM_CMPL_CB *p_cb); 9615738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 9625738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 963ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 964ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_RegBusyLevelNotif 965ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 966ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to register a callback to receive 967ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * busy level change events. 968ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 969ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successfully registered, otherwise error 970ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 971ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 972d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern tBTM_STATUS BTM_RegBusyLevelNotif (tBTM_BL_CHANGE_CB *p_cb, uint8_t *p_level, 97324933b5b1a06274c47133debac5251a97128a267June R. Tate-Gans tBTM_BL_EVENT_MASK evt_mask); 9745738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 9755738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 976ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 977ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_AclRegisterForChanges 978ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 979ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to register a callback to receive 980ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * ACL database change events, i.e. new connection or removed. 981ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 982ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successfully initiated, otherwise error 983ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 984ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 98524933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_AclRegisterForChanges (tBTM_ACL_DB_CHANGE_CB *p_cb); 9865738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 9875738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 988ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 989ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_GetNumAclLinks 990ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 991ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to count the number of 992ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * ACL links that are active. 993ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 994ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns uint16_t Number of active ACL links 995ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 996ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 997d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern uint16_t BTM_GetNumAclLinks (void); 9985738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 9995738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1000ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1001ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetQoS 1002ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1003ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to setup QoS 1004ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1005ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if successfully initiated, otherwise error 1006ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1007ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 100824933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_SetQoS(BD_ADDR bd, FLOW_SPEC *p_flow, 100924933b5b1a06274c47133debac5251a97128a267June R. Tate-Gans tBTM_CMPL_CB *p_cb); 10105738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 10115738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 10125738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/***************************************************************************** 1013ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * (e)SCO CHANNEL MANAGEMENT FUNCTIONS 1014ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ****************************************************************************/ 1015ee96a3c60fca590d38025925c072d264e06493c4Myles Watson/******************************************************************************* 1016ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1017ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_CreateSco 1018ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1019ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to create an SCO connection. If the 1020ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * "is_orig" flag is true, the connection will be originated, 1021ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * otherwise BTM will wait for the other side to connect. 1022ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1023ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_UNKNOWN_ADDR if the ACL connection is not up 1024ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_BUSY if another SCO being set up to 1025ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * the same BD address 1026ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_NO_RESOURCES if the max SCO limit has been reached 1027ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_CMD_STARTED if the connection establishment is started. 1028ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * In this case, "*p_sco_inx" is filled in 1029ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * with the sco index used for the connection. 1030ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1031ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1032d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern tBTM_STATUS BTM_CreateSco (BD_ADDR remote_bda, bool is_orig, 1033d19e0785e662e640191a075eda07acce61c2aedaMarie Janssen uint16_t pkt_types, uint16_t *p_sco_inx, 103424933b5b1a06274c47133debac5251a97128a267June R. Tate-Gans tBTM_SCO_CB *p_conn_cb, 103524933b5b1a06274c47133debac5251a97128a267June R. Tate-Gans tBTM_SCO_CB *p_disc_cb); 10365738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 10375738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 10385738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1039ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1040ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_RemoveSco 1041ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1042ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to remove a specific SCO connection. 1043ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1044ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if successfully initiated, otherwise error 1045ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1046ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1047d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern tBTM_STATUS BTM_RemoveSco (uint16_t sco_inx); 10485738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 10495738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 10505738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1051ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1052ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetScoPacketTypes 1053ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1054ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to set the packet types used for 1055ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * a specific SCO connection, 1056ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1057ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters pkt_types - One or more of the following 1058ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_HV1 1059ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_HV2 1060ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_HV3 1061ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_EV3 1062ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_EV4 1063ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_EV5 1064ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1065ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_LINK_ALL_MASK - enables all supported types 1066ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1067ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if successfully initiated, otherwise error 1068ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1069ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1070d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern tBTM_STATUS BTM_SetScoPacketTypes (uint16_t sco_inx, uint16_t pkt_types); 10715738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 10725738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 10735738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1074ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1075ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadScoPacketTypes 1076ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1077ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is read the packet types used for a specific 1078ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * SCO connection. 1079ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1080ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns One or more of the following (bitmask) 1081ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_HV1 1082ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_HV2 1083ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_HV3 1084ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_EV3 1085ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_EV4 1086ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SCO_PKT_TYPES_MASK_EV5 1087ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1088ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns packet types supported for the connection 1089ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1090ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1091d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern uint16_t BTM_ReadScoPacketTypes (uint16_t sco_inx); 10925738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 10935738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 10945738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1095ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1096ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadDeviceScoPacketTypes 1097ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1098ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is read the SCO packet types that 1099ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * the device supports. 1100ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1101ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns packet types supported by the device. 1102ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1103ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1104d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern uint16_t BTM_ReadDeviceScoPacketTypes (void); 11055738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 11065738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 11075738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1108ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1109ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadScoHandle 1110ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 11119ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description Reead the HCI handle used for a specific SCO connection, 1112ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1113ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns handle for the connection, or 0xFFFF if invalid SCO index. 1114ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1115ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1116d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern uint16_t BTM_ReadScoHandle (uint16_t sco_inx); 11175738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 11185738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 11195738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1120ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1121ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadScoBdAddr 1122ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1123ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is read the remote BD Address for a specific 1124ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * SCO connection, 1125ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1126ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns pointer to BD address or NULL if not known 1127ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1128ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1129d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern uint8_t *BTM_ReadScoBdAddr (uint16_t sco_inx); 11305738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 11315738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 11325738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1133ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1134ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadScoDiscReason 1135ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1136ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is returns the reason why an (e)SCO connection 1137ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * has been removed. It contains the value until read, or until 1138ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * another (e)SCO connection has disconnected. 1139ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1140ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns HCI reason or BTM_INVALID_SCO_DISC_REASON if not set. 1141ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1142ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1143d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern uint16_t BTM_ReadScoDiscReason (void); 11445738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 11455738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 11465738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1147ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1148ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetEScoMode 1149ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1150ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function sets up the negotiated parameters for SCO or 1151ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * eSCO, and sets as the default mode used for calls to 1152ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_CreateSco. It can be called only when there are no 1153ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * active (e)SCO links. 1154ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1155ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if the successful. 1156ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_BUSY if there are one or more active (e)SCO links. 1157ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1158ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 115924933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_SetEScoMode (tBTM_SCO_TYPE sco_mode, 116024933b5b1a06274c47133debac5251a97128a267June R. Tate-Gans tBTM_ESCO_PARAMS *p_parms); 11615738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 11625738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1163ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1164ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetWBSCodec 1165ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1166ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function sends command to the controller to setup 1167ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * WBS codec for the upcoming eSCO connection. 1168ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1169ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS. 1170ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1171ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1172ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 117324933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_SetWBSCodec (tBTM_SCO_CODEC_TYPE codec_type); 11745738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 11755738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1176ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1177ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_RegForEScoEvts 1178ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1179ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function registers a SCO event callback with the 1180ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * specified instance. It should be used to received 1181ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * connection indication events and change of link parameter 1182ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * events. 1183ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1184ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if the successful. 1185ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ILLEGAL_VALUE if there is an illegal sco_inx 1186ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1187ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1188d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern tBTM_STATUS BTM_RegForEScoEvts (uint16_t sco_inx, 118924933b5b1a06274c47133debac5251a97128a267June R. Tate-Gans tBTM_ESCO_CBACK *p_esco_cback); 11905738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 11915738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1192ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1193ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadEScoLinkParms 1194ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1195ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function returns the current eSCO link parameters for 11969ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * the specified handle. This can be called anytime a 11979ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * connection is active, but is typically called after 11989ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * receiving the SCO opened callback. 1199ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1200ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Note: If called over a 1.1 controller, only the packet types 1201ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * field has meaning. 1202ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Note: If the upper layer doesn't know the current sco index, 12039ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_FIRST_ACTIVE_SCO_INDEX can be used as the first 12049ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * parameter to find the first active SCO index 1205ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1206ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if returned data is valid connection. 1207ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ILLEGAL_VALUE if no connection for specified sco_inx. 1208ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_MODE_UNSUPPORTED if local controller does not support 1209ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1.2 specification. 1210ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1211ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1212d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern tBTM_STATUS BTM_ReadEScoLinkParms (uint16_t sco_inx, 121324933b5b1a06274c47133debac5251a97128a267June R. Tate-Gans tBTM_ESCO_DATA *p_parms); 12145738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 12155738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1216ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1217ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ChangeEScoLinkParms 1218ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1219ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function requests renegotiation of the parameters on 1220ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * the current eSCO Link. If any of the changes are accepted 1221ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * by the controllers, the BTM_ESCO_CHG_EVT event is sent in 1222ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * the tBTM_ESCO_CBACK function with the current settings of 1223ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * the link. The callback is registered through the call to 1224ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_SetEScoMode. 1225ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1226ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1227ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if command is successfully initiated. 1228ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ILLEGAL_VALUE if no connection for specified sco_inx. 1229ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_NO_RESOURCES - not enough resources to initiate command. 1230ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_MODE_UNSUPPORTED if local controller does not support 1231ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1.2 specification. 1232ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1233ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1234d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern tBTM_STATUS BTM_ChangeEScoLinkParms (uint16_t sco_inx, 123524933b5b1a06274c47133debac5251a97128a267June R. Tate-Gans tBTM_CHG_ESCO_PARAMS *p_parms); 12365738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 12375738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1238ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1239ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_EScoConnRsp 1240ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1241ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called upon receipt of an (e)SCO connection 1242ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * request event (BTM_ESCO_CONN_REQ_EVT) to accept or reject 1243ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * the request. Parameters used to negotiate eSCO links. 1244ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * If p_parms is NULL, then values set through BTM_SetEScoMode 1245ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * are used. 1246ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * If the link type of the incoming request is SCO, then only 1247ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * the tx_bw, max_latency, content format, and packet_types are 1248ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * valid. The hci_status parameter should be 1249ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * ([0x0] to accept, [0x0d..0x0f] to reject) 1250ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1251ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1252ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 1253ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1254ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1255d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern void BTM_EScoConnRsp (uint16_t sco_inx, uint8_t hci_status, 125624933b5b1a06274c47133debac5251a97128a267June R. Tate-Gans tBTM_ESCO_PARAMS *p_parms); 12575738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 12585738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1259ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1260ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_GetNumScoLinks 1261ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1262ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function returns the number of active SCO links. 1263ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1264ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns uint8_t 1265ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1266ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1267d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern uint8_t BTM_GetNumScoLinks (void); 12685738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 12695738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/***************************************************************************** 1270ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * SECURITY MANAGEMENT FUNCTIONS 1271ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ****************************************************************************/ 1272ee96a3c60fca590d38025925c072d264e06493c4Myles Watson/******************************************************************************* 1273ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1274ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecRegister 1275ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1276ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Application manager calls this function to register for 12779ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * security services. There can be one and only one 12789ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * application saving link keys. BTM allows only first 12799ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * registration. 1280ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1281ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true if registered OK, else false 1282ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1283ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1284d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern bool BTM_SecRegister (tBTM_APPL_INFO *p_cb_info); 12855738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 1286877123f5b9df90e7a71ea7b15997c521229decc1Satya Calloji/******************************************************************************* 1287ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1288ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecRegisterLinkKeyNotificationCallback 1289ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1290ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Profiles can register to be notified when a new Link Key 1291ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * is generated per connection. 1292ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1293ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true if registered OK, else false 1294ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1295ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1296d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern bool BTM_SecRegisterLinkKeyNotificationCallback( 1297877123f5b9df90e7a71ea7b15997c521229decc1Satya Calloji tBTM_LINK_KEY_CALLBACK *p_callback); 12985738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 12995738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1300ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1301ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecAddRmtNameNotifyCallback 1302ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1303ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Profiles can register to be notified when name of the 13049ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * remote device is resolved (up to 13059ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_SEC_MAX_RMT_NAME_CALLBACKS). 1306ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1307ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true if registered OK, else false 1308ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1309ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1310d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern bool BTM_SecAddRmtNameNotifyCallback (tBTM_RMT_NAME_CALLBACK *p_callback); 13115738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 13125738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 13135738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1314ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1315ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecDeleteRmtNameNotifyCallback 1316ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1317ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description A profile can deregister notification when a new Link Key 1318ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * is generated per connection. 1319ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1320ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true if OK, else false 1321ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1322ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1323d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern bool BTM_SecDeleteRmtNameNotifyCallback (tBTM_RMT_NAME_CALLBACK *p_callback); 13245738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 13255738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1326ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1327ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_GetSecurityFlags 1328ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1329ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Get security flags for the device 1330ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1331ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns bool true or false is device found 1332ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1333ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1334d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern bool BTM_GetSecurityFlags (BD_ADDR bd_addr, uint8_t * p_sec_flags); 13355738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 13365738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1337ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1338ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_GetSecurityFlagsByTransport 1339ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1340ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Get security flags for the device on a particular transport 1341ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1342ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters bd_addr: BD address of remote device 13439ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * p_sec_flags : Out parameter to be filled with security 13449ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * flags for the connection 13459ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * transport : Physical transport of the connection 13469ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * (BR/EDR or LE) 1347ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1348ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns bool true or false is device found 1349ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1350ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1351d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern bool BTM_GetSecurityFlagsByTransport (BD_ADDR bd_addr, 1352d19e0785e662e640191a075eda07acce61c2aedaMarie Janssen uint8_t * p_sec_flags, tBT_TRANSPORT transport); 13537fa4fba6f59f97df00aff07dbe8fb21b114b3c2cGanesh Ganapathi Batta 13547fa4fba6f59f97df00aff07dbe8fb21b114b3c2cGanesh Ganapathi Batta/******************************************************************************* 1355ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1356ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadTrustedMask 1357ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1358ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Get trusted mask for the device 1359ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1360ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns NULL, if the device record is not found. 1361ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * otherwise, the trusted mask 1362ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1363ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1364d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern uint32_t * BTM_ReadTrustedMask (BD_ADDR bd_addr); 13655738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 13665738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1367ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1368ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetPinType 1369ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1370ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Set PIN type for the device. 1371ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1372ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 1373ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1374ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1375d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern void BTM_SetPinType (uint8_t pin_type, PIN_CODE pin_code, uint8_t pin_code_len); 13765738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 13775738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 13785738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1379ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1380ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetPairableMode 1381ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1382ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Enable or disable pairing 1383ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1384ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters allow_pairing - (true or false) whether or not the device 1385ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * allows pairing. 1386ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * connect_only_paired - (true or false) whether or not to 1387ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * only allow paired devices to connect. 1388ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1389ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 1390ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1391ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1392d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern void BTM_SetPairableMode (bool allow_pairing, bool connect_only_paired); 13935738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 13945738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1395ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1396ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetSecureConnectionsOnly 1397ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 13989ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description Enable or disable default treatment for Mode 4 Level 0 13999ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * services 1400ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1401ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameter secure_connections_only_mode - (true or false) 14029ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * true means that the device should treat Mode 4 Level 0 14039ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * services as services of other levels. 14049ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * false means that the device should provide default 14059ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * treatment for Mode 4 Level 0 services. 1406ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1407ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 1408ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1409ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1410d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern void BTM_SetSecureConnectionsOnly (bool secure_connections_only_mode); 1411899b77140675a157dba034e98527ab546bc9ac35Mudumba Ananth 1412899b77140675a157dba034e98527ab546bc9ac35Mudumba Ananth/******************************************************************************* 1413ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1414ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetSecurityLevel 1415ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1416ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Register service security level with Security Manager. Each 1417ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * service must register its requirements regardless of the 14189ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * security level that is used. This API is called once for 14199ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * originators and again for acceptors of connections. 1420ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1421ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true if registered OK, else false 1422ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1423ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1424d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern bool BTM_SetSecurityLevel (bool is_originator, const char *p_name, 1425d19e0785e662e640191a075eda07acce61c2aedaMarie Janssen uint8_t service_id, uint16_t sec_level, 1426d19e0785e662e640191a075eda07acce61c2aedaMarie Janssen uint16_t psm, uint32_t mx_proto_id, 1427d19e0785e662e640191a075eda07acce61c2aedaMarie Janssen uint32_t mx_chan_id); 14285738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 14295738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1430ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1431ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetOutService 1432ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1433ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to set the service for 1434ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * outgoing connection. 1435ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1436ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 1437ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1438ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1439d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern void BTM_SetOutService(BD_ADDR bd_addr, uint8_t service_id, uint32_t mx_chan_id); 14405738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 14415738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1442ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1443ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecClrService 1444ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 14459ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description Removes specified service record(s) from the security 14469ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * database. All service records with the specified name are 14479ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * removed. Typically used only by devices with limited RAM 14489ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * so that it can reuse an old security service record. 1449ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1450ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns Number of records that were freed. 1451ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1452ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1453d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern uint8_t BTM_SecClrService (uint8_t service_id); 14545738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 14555738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1456ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1457ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecAddDevice 1458ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1459ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Add/modify device. This function will be normally called 1460ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * during host startup to restore all required information 1461ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * stored in the NVRAM. 14629ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * dev_class, bd_name, link_key, and features are NULL if 14639ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * unknown 1464ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1465ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true if added OK, else false 1466ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1467ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1468d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern bool BTM_SecAddDevice (BD_ADDR bd_addr, DEV_CLASS dev_class, 1469d19e0785e662e640191a075eda07acce61c2aedaMarie Janssen BD_NAME bd_name, uint8_t *features, 1470d19e0785e662e640191a075eda07acce61c2aedaMarie Janssen uint32_t trusted_mask[], LINK_KEY link_key, 1471d19e0785e662e640191a075eda07acce61c2aedaMarie Janssen uint8_t key_type, tBTM_IO_CAP io_cap, uint8_t pin_length); 14725738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 14735738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 14745738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1475ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1476ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecDeleteDevice 1477ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1478ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Free resources associated with the device. 1479ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1480ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true if rmoved OK, false if not found 1481ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1482ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1483d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern bool BTM_SecDeleteDevice (BD_ADDR bd_addr); 14845738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 1485415d1120561ba38c7cd00f0e41d8fb69cda97601Andre Eisenbach/******************************************************************************* 1486ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1487ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecClearSecurityFlags 1488ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1489ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Reset the security flags (mark as not-paired) for a given 1490ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * remove device. 1491ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1492ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1493415d1120561ba38c7cd00f0e41d8fb69cda97601Andre Eisenbachextern void BTM_SecClearSecurityFlags (BD_ADDR bd_addr); 14945738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 14955738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1496ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1497ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecGetDeviceLinkKey 1498ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1499ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to obtain link key for the device 1500ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * it returns BTM_SUCCESS if link key is available, or 1501ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if Security Manager does not know about 1502ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * the device or device record does not contain link key info 1503ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1504ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successful, otherwise error code 1505ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1506ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 150724933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_SecGetDeviceLinkKey (BD_ADDR bd_addr, 150824933b5b1a06274c47133debac5251a97128a267June R. Tate-Gans LINK_KEY link_key); 15095738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 15105738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 15115738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1512ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1513ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecGetDeviceLinkKeyType 1514ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1515ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to obtain link key type for the 1516ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * device. 1517ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * it returns BTM_SUCCESS if link key is available, or 1518ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if Security Manager does not know about 1519ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * the device or device record does not contain link key info 1520ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1521ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_LKEY_TYPE_IGNORE if link key is unknown, link type 1522ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * otherwise. 1523ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1524ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1525444a8da807abaf5f9e813ce70c56a79160495fb3Satya Callojiextern tBTM_LINK_KEY_TYPE BTM_SecGetDeviceLinkKeyType (BD_ADDR bd_addr); 1526444a8da807abaf5f9e813ce70c56a79160495fb3Satya Calloji 1527444a8da807abaf5f9e813ce70c56a79160495fb3Satya Calloji 1528444a8da807abaf5f9e813ce70c56a79160495fb3Satya Calloji/******************************************************************************* 1529ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1530ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_PINCodeReply 1531ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1532ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called after Security Manager submitted 1533ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * PIN code request to the UI. 1534ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 15359ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Parameters: bd_addr - Address of the device for which PIN was 15369ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * requested 15379ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * res - result of the operation BTM_SUCCESS if 15389ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * success 1539ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * pin_len - length in bytes of the PIN Code 1540ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * p_pin - pointer to array with the PIN Code 15419ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * trusted_mask - bitwise OR of trusted services 15429ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * (array of uint32_t) 1543ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1544ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 1545ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1546ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1547d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern void BTM_PINCodeReply (BD_ADDR bd_addr, uint8_t res, uint8_t pin_len, 1548d19e0785e662e640191a075eda07acce61c2aedaMarie Janssen uint8_t *p_pin, uint32_t trusted_mask[]); 15495738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 15505738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 15515738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1552ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1553ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecBond 1554ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1555ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to perform bonding with peer device. 1556ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1557ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: bd_addr - Address of the device to bond 1558ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * pin_len - length in bytes of the PIN Code 1559ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * p_pin - pointer to array with the PIN Code 15609ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * trusted_mask - bitwise OR of trusted services 15619ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * (array of uint32_t) 1562ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if successfully initiated, otherwise error 1563ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1564ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 156524933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_SecBond (BD_ADDR bd_addr, 1566d19e0785e662e640191a075eda07acce61c2aedaMarie Janssen uint8_t pin_len, uint8_t *p_pin, 1567d19e0785e662e640191a075eda07acce61c2aedaMarie Janssen uint32_t trusted_mask[]); 15687fa4fba6f59f97df00aff07dbe8fb21b114b3c2cGanesh Ganapathi Batta 15697fa4fba6f59f97df00aff07dbe8fb21b114b3c2cGanesh Ganapathi Batta/******************************************************************************* 1570ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1571ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecBondByTransport 1572ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 15739ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description Perform bonding by designated transport 1574ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1575ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: bd_addr - Address of the device to bond 1576ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * pin_len - length in bytes of the PIN Code 1577ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * p_pin - pointer to array with the PIN Code 15789ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * trusted_mask - bitwise OR of trusted services 15799ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * (array of uint32_t) 15809ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * transport : Physical transport to use for bonding 15819ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * (BR/EDR or LE) 1582ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1583ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if successfully initiated, otherwise error 1584ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1585ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 158624933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_SecBondByTransport (BD_ADDR bd_addr, 158724933b5b1a06274c47133debac5251a97128a267June R. Tate-Gans tBT_TRANSPORT transport, 1588d19e0785e662e640191a075eda07acce61c2aedaMarie Janssen uint8_t pin_len, uint8_t *p_pin, 1589d19e0785e662e640191a075eda07acce61c2aedaMarie Janssen uint32_t trusted_mask[]); 15905738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 15915738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1592ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1593ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecBondCancel 1594ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1595ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to cancel ongoing bonding process 1596ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * with peer device. 1597ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1598ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_CMD_STARTED if successfully initiated, otherwise error 1599ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1600ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 160124933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_SecBondCancel (BD_ADDR bd_addr); 16025738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 16035738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1604ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1605ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetEncryption 1606ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1607ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to ensure that connection is 1608ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * encrypted. Should be called only on an open connection. 1609ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Typically only needed for connections that first want to 1610ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * bring up unencrypted links, then later encrypt them. 1611ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1612ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: bd_addr - Address of the peer device 1613ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * transport - Link transport 1614ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * p_callback - Pointer to callback function called if 1615ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * this function returns PENDING after required 16169ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * procedures are completed. Can be set to 16179ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * NULL if status is not desired. 16189ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * p_ref_data - pointer to any data the caller wishes to 16199ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * receive in the callback function upon 16209ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * completion. 1621ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * can be set to NULL if not used. 1622ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * sec_act - LE security action, unused for BR/EDR 1623ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1624ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS - already encrypted 1625ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_PENDING - command will be returned in the callback 1626ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_WRONG_MODE- connection not up. 1627ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_BUSY - security procedures are currently active 1628ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_MODE_UNSUPPORTED - if security manager not linked in. 1629ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1630ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 163124933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_SetEncryption (BD_ADDR bd_addr, tBT_TRANSPORT transport, 1632f40b136e7b943d7e25224817fc47bb5b171479d5Andre Eisenbach tBTM_SEC_CBACK *p_callback, 1633f40b136e7b943d7e25224817fc47bb5b171479d5Andre Eisenbach void *p_ref_data, tBTM_BLE_SEC_ACT sec_act); 16345738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 16355738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1636ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1637ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ConfirmReqReply 1638ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1639ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to confirm the numeric value for 1640ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Simple Pairing in response to BTM_SP_CFM_REQ_EVT 1641ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 16429ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Parameters: res - result of the operation BTM_SUCCESS if 16439ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * success 1644ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * bd_addr - Address of the peer device 1645ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1646ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 164724933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern void BTM_ConfirmReqReply(tBTM_STATUS res, BD_ADDR bd_addr); 16485738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 16495738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1650ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1651ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_PasskeyReqReply 1652ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1653ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to provide the passkey for 1654ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Simple Pairing in response to BTM_SP_KEY_REQ_EVT 1655ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 16569ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Parameters: res - result of the operation BTM_SUCCESS if 16579ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * success 1658ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * bd_addr - Address of the peer device 16599ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * passkey - numeric value in the range of 16609ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * 0 - 999999(0xF423F). 1661ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1662ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1663d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern void BTM_PasskeyReqReply(tBTM_STATUS res, BD_ADDR bd_addr, uint32_t passkey); 16645738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 16655738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1666ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1667ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SendKeypressNotif 1668ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1669ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is used during the passkey entry model 1670ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * by a device with KeyboardOnly IO capabilities 1671ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * (very likely to be a HID Device). 16729ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * It is called by a HID Device to inform the remote device 16739ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * when a key has been entered or erased. 1674ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1675ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: bd_addr - Address of the peer device 1676ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * type - notification type 1677ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1678ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 167924933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern void BTM_SendKeypressNotif(BD_ADDR bd_addr, tBTM_SP_KEY_TYPE type); 16805738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 16815738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1682ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1683ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_IoCapRsp 1684ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1685ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called in response to BTM_SP_IO_REQ_EVT 16869ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * When the event data io_req.oob_data is set to 16879ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_OOB_UNKNOWN by the tBTM_SP_CALLBACK implementation, this 16889ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * function is called to provide the actual response 1689ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1690ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: bd_addr - Address of the peer device 1691ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * io_cap - The IO capability of local device. 1692ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * oob - BTM_OOB_NONE or BTM_OOB_PRESENT. 1693ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * auth_req- MITM protection required or not. 1694ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1695ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 169624933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern void BTM_IoCapRsp(BD_ADDR bd_addr, tBTM_IO_CAP io_cap, 169724933b5b1a06274c47133debac5251a97128a267June R. Tate-Gans tBTM_OOB_DATA oob, tBTM_AUTH_REQ auth_req); 16985738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 16995738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1700ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1701ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadLocalOobData 1702ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1703ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to read the local OOB data from 1704ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * LM 1705ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1706ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1707b6ab9b3af6b8793ff781e0359a78611726ab2300Jakub Pawlowskiextern void BTM_ReadLocalOobData(void); 17085738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 17095738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1710ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1711ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_RemoteOobDataReply 1712ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1713ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to provide the remote OOB data for 1714ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Simple Pairing in response to BTM_SP_RMT_OOB_EVT 1715ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1716ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: bd_addr - Address of the peer device 1717ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * c - simple pairing Hash C. 1718ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * r - simple pairing Randomizer C. 1719ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1720ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 172124933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern void BTM_RemoteOobDataReply(tBTM_STATUS res, BD_ADDR bd_addr, 172224933b5b1a06274c47133debac5251a97128a267June R. Tate-Gans BT_OCTET16 c, BT_OCTET16 r); 17235738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 17245738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1725ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1726ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_BuildOobData 1727ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1728ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to build the OOB data payload to 1729ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * be sent over OOB (non-Bluetooth) link 1730ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1731ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: p_data - the location for OOB data 1732ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * max_len - p_data size. 1733ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * c - simple pairing Hash C. 1734ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * r - simple pairing Randomizer C. 1735ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * name_len- 0, local device name would not be included. 1736ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * otherwise, the local device name is included for 1737ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * up to this specified length 1738ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1739ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns Number of bytes in p_data. 1740ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1741ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1742d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern uint16_t BTM_BuildOobData(uint8_t *p_data, uint16_t max_len, BT_OCTET16 c, 1743d19e0785e662e640191a075eda07acce61c2aedaMarie Janssen BT_OCTET16 r, uint8_t name_len); 17445738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 17455738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1746ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1747ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_BothEndsSupportSecureConnections 1748ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 17499ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description This function is called to check if both the local device 17509ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * and the peer device specified by bd_addr support BR/EDR 17519ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Secure Connections. 1752ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1753ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: bd_addr - address of the peer 1754ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 17559ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Returns true if BR/EDR Secure Connections are supported by both 17569ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * local and the remote device. 1757ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * else false. 1758ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1759ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1760d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern bool BTM_BothEndsSupportSecureConnections(BD_ADDR bd_addr); 1761899b77140675a157dba034e98527ab546bc9ac35Mudumba Ananth 1762899b77140675a157dba034e98527ab546bc9ac35Mudumba Ananth/******************************************************************************* 1763ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1764ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_PeerSupportsSecureConnections 1765ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1766ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to check if the peer supports 1767ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BR/EDR Secure Connections. 1768ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1769ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: bd_addr - address of the peer 1770ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1771ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true if BR/EDR Secure Connections are supported by the peer, 1772ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * else false. 1773ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1774ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1775d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern bool BTM_PeerSupportsSecureConnections(BD_ADDR bd_addr); 1776444a8da807abaf5f9e813ce70c56a79160495fb3Satya Calloji 1777444a8da807abaf5f9e813ce70c56a79160495fb3Satya Calloji/******************************************************************************* 1778ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1779ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadOobData 1780ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1781ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to parse the OOB data payload 1782ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * received over OOB (non-Bluetooth) link 1783ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1784ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: p_data - the location for OOB data 1785ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * eir_tag - The associated EIR tag to read the data. 1786ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * *p_len(output) - the length of the data with the given tag. 1787ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1788ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns the beginning of the data with the given tag. 1789ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * NULL, if the tag is not found. 1790ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1791ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1792d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern uint8_t * BTM_ReadOobData(uint8_t *p_data, uint8_t eir_tag, uint8_t *p_len); 17935738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 17945738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1795ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1796ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SecReadDevName 1797ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1798ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Looks for the device name in the security database for the 1799ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * specified BD address. 1800ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1801ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns Pointer to the name or NULL 1802ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1803ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 180424933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern char *BTM_SecReadDevName (BD_ADDR bd_addr); 18055738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 18065738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 18075738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/***************************************************************************** 1808ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * POWER MANAGEMENT FUNCTIONS 1809ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ****************************************************************************/ 1810ee96a3c60fca590d38025925c072d264e06493c4Myles Watson/******************************************************************************* 1811ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1812ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_PmRegister 1813ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1814ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description register or deregister with power manager 1815ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1816ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successful, 1817ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_NO_RESOURCES if no room to hold registration 1818ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ILLEGAL_VALUE 1819ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1820ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1821d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern tBTM_STATUS BTM_PmRegister (uint8_t mask, uint8_t *p_pm_id, 182224933b5b1a06274c47133debac5251a97128a267June R. Tate-Gans tBTM_PM_STATUS_CBACK *p_cb); 18235738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 18245738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 18255738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1826ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1827ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetPowerMode 1828ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1829ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description store the mode in control block or 1830ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * alter ACL connection behavior. 1831ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1832ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successful, 1833ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if bd addr is not active or bad 1834ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1835ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1836d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern tBTM_STATUS BTM_SetPowerMode (uint8_t pm_id, BD_ADDR remote_bda, 183724933b5b1a06274c47133debac5251a97128a267June R. Tate-Gans tBTM_PM_PWR_MD *p_mode); 18385738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 18395738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 18405738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1841ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1842ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ReadPowerMode 1843ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1844ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This returns the current mode for a specific 1845ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * ACL connection. 1846ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1847ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Input Param remote_bda - device address of desired ACL connection 1848ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1849ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Output Param p_mode - address where the current mode is copied into. 1850ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ACL_MODE_NORMAL 1851ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ACL_MODE_HOLD 1852ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ACL_MODE_SNIFF 1853ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ACL_MODE_PARK 1854ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * (valid only if return code is BTM_SUCCESS) 1855ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1856ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if successful, 1857ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if bd addr is not active or bad 1858ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1859ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 186024933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_ReadPowerMode (BD_ADDR remote_bda, 186124933b5b1a06274c47133debac5251a97128a267June R. Tate-Gans tBTM_PM_MODE *p_mode); 18625738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 18635738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1864ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1865ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetSsrParams 1866ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1867ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This sends the given SSR parameters for the given ACL 1868ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * connection if it is in ACTIVE mode. 1869ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1870ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Input Param remote_bda - device address of desired ACL connection 1871ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * max_lat - maximum latency (in 0.625ms)(0-0xFFFE) 1872ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * min_rmt_to - minimum remote timeout 1873ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * min_loc_to - minimum local timeout 1874ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1875ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1876ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if the HCI command is issued successful, 1877ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_UNKNOWN_ADDR if bd addr is not active or bad 1878ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_CMD_STORED if the command is stored 1879ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1880ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1881d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern tBTM_STATUS BTM_SetSsrParams (BD_ADDR remote_bda, uint16_t max_lat, 1882d19e0785e662e640191a075eda07acce61c2aedaMarie Janssen uint16_t min_rmt_to, uint16_t min_loc_to); 18835738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 18845738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1885ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1886ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_GetHCIConnHandle 1887ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 18889ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description This function is called to get the handle for an ACL 18899ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * connection to a specific remote BD Address. 1890ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1891ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns the handle of the connection, or 0xFFFF if none. 1892ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1893ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 18947921e8f594079e00e90173a8fe7483ad72443b34Jakub Pawlowskiextern uint16_t BTM_GetHCIConnHandle (const BD_ADDR remote_bda, tBT_TRANSPORT transport); 18955738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 18965738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1897ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1898ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_DeleteStoredLinkKey 1899ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1900ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to delete link key for the specified 19019ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * device addresses from the NVRAM storage attached to the 19029ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Bluetooth controller. 1903ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1904ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters: bd_addr - Addresses of the devices 1905ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * p_cb - Call back function to be called to return 1906ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * the results 1907ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1908ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 190924933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_DeleteStoredLinkKey(BD_ADDR bd_addr, tBTM_CMPL_CB *p_cb); 19105738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 19115738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1912ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1913ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_WriteEIR 1914ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1915ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to write EIR data to controller. 1916ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1917ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters p_buff - allocated HCI command buffer including extended 1918ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * inquriry response 1919ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1920ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS - if successful 1921ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_MODE_UNSUPPORTED - if local device cannot support it 1922ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1923ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 192424933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_WriteEIR( BT_HDR * p_buff ); 19255738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 19265738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1927ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1928ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_CheckEirData 1929ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 19309ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description Get EIR data from the significant part. 1931ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1932ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters p_eir - pointer of EIR significant part 1933ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * type - finding EIR data type 1934ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * p_length - return the length of EIR data 1935ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1936ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns pointer of EIR data 1937ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1938ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1939d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern uint8_t *BTM_CheckEirData( uint8_t *p_eir, uint8_t type, uint8_t *p_length ); 19405738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 19415738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1942ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1943ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_HasEirService 1944ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1945ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to know if UUID in bit map of UUID. 1946ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1947ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters p_eir_uuid - bit map of UUID list 1948ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * uuid16 - UUID 16-bit 1949ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1950ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns true - if found 1951ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * false - if not found 1952ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1953ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1954d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern bool BTM_HasEirService( uint32_t *p_eir_uuid, uint16_t uuid16 ); 19555738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 19565738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1957ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1958ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_HasInquiryEirService 1959ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 19609ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description Return if a UUID is in the bit map of a UUID list. 1961ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1962ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters p_results - inquiry results 1963ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * uuid16 - UUID 16-bit 1964ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1965ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_EIR_FOUND - if found 19669ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_EIR_NOT_FOUND - if not found and it is a complete list 1967ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_EIR_UNKNOWN - if not found and it is not complete list 1968ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1969ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 197024933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_EIR_SEARCH_RESULT BTM_HasInquiryEirService( tBTM_INQ_RESULTS *p_results, 1971d19e0785e662e640191a075eda07acce61c2aedaMarie Janssen uint16_t uuid16 ); 19725738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 19735738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1974ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1975ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_AddEirService 1976ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 19779ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description This function is called to add a service in the bit map UUID 19789ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * list. 1979ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1980ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters p_eir_uuid - bit mask of UUID list for EIR 1981ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * uuid16 - UUID 16-bit 1982ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1983ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns None 1984ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1985ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 1986d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern void BTM_AddEirService( uint32_t *p_eir_uuid, uint16_t uuid16 ); 19875738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 19885738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 1989ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1990ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_RemoveEirService 1991ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 19929ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description This function is called to remove a service from the bit map 19939ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * UUID list. 1994ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1995ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters p_eir_uuid - bit mask of UUID list for EIR 1996ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * uuid16 - UUID 16-bit 1997ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 1998ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns None 1999ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2000ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 2001d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern void BTM_RemoveEirService( uint32_t *p_eir_uuid, uint16_t uuid16 ); 20025738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 20035738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 2004ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2005ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_GetEirSupportedServices 2006ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 20079ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description This function is called to get UUID list from bit map UUID 20089ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * list. 2009ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2010ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters p_eir_uuid - bit mask of UUID list for EIR 2011ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * p - reference of current pointer of EIR 2012ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * max_num_uuid16 - max number of UUID can be written in EIR 2013ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * num_uuid16 - number of UUID have been written in EIR 2014ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2015ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_EIR_MORE_16BITS_UUID_TYPE, if it has more than max 2016ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_EIR_COMPLETE_16BITS_UUID_TYPE, otherwise 2017ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2018ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 2019d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern uint8_t BTM_GetEirSupportedServices( uint32_t *p_eir_uuid, uint8_t **p, 2020d19e0785e662e640191a075eda07acce61c2aedaMarie Janssen uint8_t max_num_uuid16, uint8_t *p_num_uuid16); 20215738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 20225738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 2023ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2024ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_GetEirUuidList 2025ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2026ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function parses EIR and returns UUID list. 2027ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2028ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameters p_eir - EIR 2029ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * uuid_size - LEN_UUID_16, LEN_UUID_32, LEN_UUID_128 2030ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * p_num_uuid - return number of UUID in found list 2031ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * p_uuid_list - return UUID 16-bit list 2032ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * max_num_uuid - maximum number of UUID to be returned 2033ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2034ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns 0 - if not found 2035ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_EIR_COMPLETE_16BITS_UUID_TYPE 2036ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_EIR_MORE_16BITS_UUID_TYPE 2037ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_EIR_COMPLETE_32BITS_UUID_TYPE 2038ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_EIR_MORE_32BITS_UUID_TYPE 2039ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_EIR_COMPLETE_128BITS_UUID_TYPE 2040ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_EIR_MORE_128BITS_UUID_TYPE 2041ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2042ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 2043d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern uint8_t BTM_GetEirUuidList( uint8_t *p_eir, uint8_t uuid_size, uint8_t *p_num_uuid, 2044d19e0785e662e640191a075eda07acce61c2aedaMarie Janssen uint8_t *p_uuid_list, uint8_t max_num_uuid); 20455738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 20465738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/***************************************************************************** 2047ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * SCO OVER HCI 2048ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ****************************************************************************/ 2049ee96a3c60fca590d38025925c072d264e06493c4Myles Watson/******************************************************************************* 2050ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2051ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_ConfigScoPath 2052ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2053ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function enable/disable SCO over HCI and registers SCO 2054ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * data callback if SCO over HCI is enabled. 2055ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2056ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Parameter path: SCO or HCI 2057ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * p_sco_data_cb: callback function or SCO data if path is set 2058ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * to transport. 20599ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * p_pcm_param: pointer to the PCM interface parameter. If a 20609ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * NULL pointer is used, the PCM parameter 20619ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * maintained in the control block will be used; 20629ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * otherwise update the control block value. 20639ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * err_data_rpt: Lisbon feature to enable the erronous data 20649ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * report or not. 2065ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2066ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS if the successful. 2067ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_NO_RESOURCES: no rsource to start the command. 2068ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ILLEGAL_VALUE: invalid callback function pointer. 20699ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_CMD_STARTED : Command sent. Waiting for command 20709ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * complete event. 2071ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2072ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2073ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 207424933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_STATUS BTM_ConfigScoPath (tBTM_SCO_ROUTE_TYPE path, 207524933b5b1a06274c47133debac5251a97128a267June R. Tate-Gans tBTM_SCO_DATA_CB *p_sco_data_cb, 207624933b5b1a06274c47133debac5251a97128a267June R. Tate-Gans tBTM_SCO_PCM_PARAM *p_pcm_param, 2077d19e0785e662e640191a075eda07acce61c2aedaMarie Janssen bool err_data_rpt); 20785738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 20795738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 2080ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2081ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_WriteScoData 2082ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 20839ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Description This function write SCO data to a specified instance. The 20849ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * data to be written p_buf needs to carry an offset of 2085ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * HCI_SCO_PREAMBLE_SIZE bytes, and the data length can not 20869ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * exceed BTM_SCO_DATA_SIZE_MAX bytes, whose default value is 20879ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * set to 60 and is configurable. Data longer than the maximum 20889ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * bytes will be truncated. 2089ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2090ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns BTM_SUCCESS: data write is successful 2091ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_ILLEGAL_VALUE: SCO data contains illegal offset value. 20929ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_SCO_BAD_LENGTH: SCO data length exceeds the max SCO 20939ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * packet size. 2094ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * BTM_NO_RESOURCES: no resources. 20959ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_UNKNOWN_ADDR: unknown SCO connection handle, or SCO is 20969ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * not routed via HCI. 2097ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2098ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2099ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 2100d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern tBTM_STATUS BTM_WriteScoData (uint16_t sco_inx, BT_HDR *p_buf); 21015738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 21025738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 2103ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2104ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_SetARCMode 2105ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2106ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Send Audio Routing Control command. 2107ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2108ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 2109ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2110ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 2111d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern void BTM_SetARCMode (uint8_t iface, uint8_t arc_mode, tBTM_VSC_CMPL_CB *p_arc_cb); 21125738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 21135738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 21145738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project/******************************************************************************* 2115ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2116ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_PCM2Setup_Write 2117ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2118ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description Send PCM2_Setup write command. 2119ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2120ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Returns void 2121ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2122ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 2123d19e0785e662e640191a075eda07acce61c2aedaMarie Janssenextern void BTM_PCM2Setup_Write (bool clk_master, tBTM_VSC_CMPL_CB *p_arc_cb); 21245738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 2125e5ba8841cd39e17c05aeb4ab65b5b761d41577daSatya Calloji 2126e5ba8841cd39e17c05aeb4ab65b5b761d41577daSatya Calloji/******************************************************************************* 2127ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2128ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Function BTM_PM_ReadControllerState 2129ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2130ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * Description This function is called to obtain the controller state 2131ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 21329ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * Returns Controller state (BTM_CONTRL_ACTIVE, BTM_CONTRL_SCAN, and 21339ca07091a1f07ea201cee0504dab6a1d7073d429Myles Watson * BTM_CONTRL_IDLE) 2134ee96a3c60fca590d38025925c072d264e06493c4Myles Watson * 2135ee96a3c60fca590d38025925c072d264e06493c4Myles Watson ******************************************************************************/ 213624933b5b1a06274c47133debac5251a97128a267June R. Tate-Gansextern tBTM_CONTRL_STATE BTM_PM_ReadControllerState(void); 2137e5ba8841cd39e17c05aeb4ab65b5b761d41577daSatya Calloji 21385738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project#ifdef __cplusplus 21395738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project} 21405738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project#endif 21415738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project 21425738f83aeb59361a0a2eda2460113f6dc919427The Android Open Source Project#endif /* BTM_API_H */ 2143