1/****************************************************************************** 2 * 3 * Copyright (C) 2003-2012 Broadcom Corporation 4 * 5 * Licensed under the Apache License, Version 2.0 (the "License"); 6 * you may not use this file except in compliance with the License. 7 * You may obtain a copy of the License at: 8 * 9 * http://www.apache.org/licenses/LICENSE-2.0 10 * 11 * Unless required by applicable law or agreed to in writing, software 12 * distributed under the License is distributed on an "AS IS" BASIS, 13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 14 * See the License for the specific language governing permissions and 15 * limitations under the License. 16 * 17 ******************************************************************************/ 18 19/****************************************************************************** 20 * 21 * This is the public interface file for the audio gateway (AG) subsystem 22 * of BTA, Broadcom's Bluetooth application layer for mobile phones. 23 * 24 ******************************************************************************/ 25#ifndef BTA_AG_API_H 26#define BTA_AG_API_H 27 28#include "bta_api.h" 29 30/***************************************************************************** 31** Constants and data types 32*****************************************************************************/ 33 34/* AG feature masks */ 35#define BTA_AG_FEAT_3WAY 0x00000001 /* Three-way calling */ 36#define BTA_AG_FEAT_ECNR 0x00000002 /* Echo cancellation and/or noise reduction */ 37#define BTA_AG_FEAT_VREC 0x00000004 /* Voice recognition */ 38#define BTA_AG_FEAT_INBAND 0x00000008 /* In-band ring tone */ 39#define BTA_AG_FEAT_VTAG 0x00000010 /* Attach a phone number to a voice tag */ 40#define BTA_AG_FEAT_REJECT 0x00000020 /* Ability to reject incoming call */ 41#define BTA_AG_FEAT_ECS 0x00000040 /* Enhanced Call Status */ 42#define BTA_AG_FEAT_ECC 0x00000080 /* Enhanced Call Control */ 43#define BTA_AG_FEAT_EXTERR 0x00000100 /* Extended error codes */ 44#define BTA_AG_FEAT_CODEC 0x00000200 /* Codec Negotiation */ 45#define BTA_AG_FEAT_VOIP 0x00000400 /* VoIP call */ 46/* Proprietary features: using 31 ~ 16 bits */ 47#define BTA_AG_FEAT_BTRH 0x00010000 /* CCAP incoming call hold */ 48#define BTA_AG_FEAT_UNAT 0x00020000 /* Pass unknown AT commands to application */ 49#define BTA_AG_FEAT_NOSCO 0x00040000 /* No SCO control performed by BTA AG */ 50#define BTA_AG_FEAT_NO_ESCO 0x00080000 /* Do not allow or use eSCO */ 51 52typedef UINT32 tBTA_AG_FEAT; 53 54/* AG parse mode */ 55#define BTA_AG_PARSE 0 /* Perform AT command parsing in AG */ 56#define BTA_AG_PASS_THROUGH 1 /* Pass data directly to phone�s AT command interpreter */ 57 58typedef UINT8 tBTA_AG_PARSE_MODE; 59 60/* AG open status */ 61#define BTA_AG_SUCCESS 0 /* Connection successfully opened */ 62#define BTA_AG_FAIL_SDP 1 /* Open failed due to SDP */ 63#define BTA_AG_FAIL_RFCOMM 2 /* Open failed due to RFCOMM */ 64#define BTA_AG_FAIL_RESOURCES 3 /* out of resources failure */ 65 66typedef UINT8 tBTA_AG_STATUS; 67 68/* handle values used with BTA_AgResult */ 69#define BTA_AG_HANDLE_NONE 0 70#define BTA_AG_HANDLE_ALL 0xFFFF 71/* It is safe to use the same value as BTA_AG_HANDLE_ALL 72 * HANDLE_ALL is used for delivering indication 73 * SCO_NO_CHANGE is used for changing sco behavior 74 * They donot interfere with each other 75 */ 76#define BTA_AG_HANDLE_SCO_NO_CHANGE 0xFFFF 77 78/* AG result codes used with BTA_AgResult */ 79#define BTA_AG_SPK_RES 0 /* Update speaker volume */ 80#define BTA_AG_MIC_RES 1 /* Update microphone volume */ 81#define BTA_AG_INBAND_RING_RES 2 /* Update inband ring state */ 82#define BTA_AG_CIND_RES 3 /* Send indicator response for AT+CIND */ 83#define BTA_AG_BINP_RES 4 /* Send phone number for voice tag for AT+BINP */ 84#define BTA_AG_IND_RES 5 /* Update an indicator value */ 85#define BTA_AG_BVRA_RES 6 /* Update voice recognition state */ 86#define BTA_AG_CNUM_RES 7 /* Send subscriber number response for AT+CNUM */ 87#define BTA_AG_BTRH_RES 8 /* Send CCAP incoming call hold */ 88#define BTA_AG_CLCC_RES 9 /* Query list of calls */ 89#define BTA_AG_COPS_RES 10 /* Read network operator */ 90#define BTA_AG_IN_CALL_RES 11 /* Indicate incoming phone call */ 91#define BTA_AG_IN_CALL_CONN_RES 12 /* Incoming phone call connected */ 92#define BTA_AG_CALL_WAIT_RES 13 /* Call waiting notification */ 93#define BTA_AG_OUT_CALL_ORIG_RES 14 /* Outgoing phone call origination */ 94#define BTA_AG_OUT_CALL_ALERT_RES 15 /* Outgoing phone call alerting remote party */ 95#define BTA_AG_OUT_CALL_CONN_RES 16 /* Outgoing phone call connected */ 96#define BTA_AG_CALL_CANCEL_RES 17 /* Incoming/outgoing 3-way canceled before connected */ 97#define BTA_AG_END_CALL_RES 18 /* End call */ 98#define BTA_AG_IN_CALL_HELD_RES 19 /* Incoming call held */ 99#define BTA_AG_UNAT_RES 20 /* Response to unknown AT command event */ 100 101typedef UINT8 tBTA_AG_RES; 102 103/* HFP peer features */ 104#define BTA_AG_PEER_FEAT_ECNR 0x0001 /* Echo cancellation and/or noise reduction */ 105#define BTA_AG_PEER_FEAT_3WAY 0x0002 /* Call waiting and three-way calling */ 106#define BTA_AG_PEER_FEAT_CLI 0x0004 /* Caller ID presentation capability */ 107#define BTA_AG_PEER_FEAT_VREC 0x0008 /* Voice recognition activation */ 108#define BTA_AG_PEER_FEAT_VOL 0x0010 /* Remote volume control */ 109#define BTA_AG_PEER_FEAT_ECS 0x0020 /* Enhanced Call Status */ 110#define BTA_AG_PEER_FEAT_ECC 0x0040 /* Enhanced Call Control */ 111#define BTA_AG_PEER_FEAT_CODEC 0x0080 /* Codec Negotiation */ 112#define BTA_AG_PEER_FEAT_VOIP 0x0100 /* VoIP call */ 113 114typedef UINT16 tBTA_AG_PEER_FEAT; 115 116/* HFP peer supported codec masks */ 117#define BTA_AG_CODEC_NONE BTM_SCO_CODEC_NONE 118#define BTA_AG_CODEC_CVSD BTM_SCO_CODEC_CVSD /* CVSD */ 119#define BTA_AG_CODEC_MSBC BTM_SCO_CODEC_MSBC /* mSBC */ 120typedef UINT16 tBTA_AG_PEER_CODEC; 121 122/* HFP errcode - Set when BTA_AG_OK_ERROR is returned in 'ok_flag' */ 123#define BTA_AG_ERR_PHONE_FAILURE 0 /* Phone Failure */ 124#define BTA_AG_ERR_NO_CONN_PHONE 1 /* No connection to phone */ 125#define BTA_AG_ERR_OP_NOT_ALLOWED 3 /* Operation not allowed */ 126#define BTA_AG_ERR_OP_NOT_SUPPORTED 4 /* Operation not supported */ 127#define BTA_AG_ERR_PHSIM_PIN_REQ 5 /* PH-SIM PIN required */ 128#define BTA_AG_ERR_SIM_NOT_INSERTED 10 /* SIM not inserted */ 129#define BTA_AG_ERR_SIM_PIN_REQ 11 /* SIM PIN required */ 130#define BTA_AG_ERR_SIM_PUK_REQ 12 /* SIM PUK required */ 131#define BTA_AG_ERR_SIM_FAILURE 13 /* SIM failure */ 132#define BTA_AG_ERR_SIM_BUSY 14 /* SIM busy */ 133#define BTA_AG_ERR_INCORRECT_PWD 16 /* Incorrect password */ 134#define BTA_AG_ERR_SIM_PIN2_REQ 17 /* SIM PIN2 required */ 135#define BTA_AG_ERR_SIM_PUK2_REQ 18 /* SIM PUK2 required */ 136#define BTA_AG_ERR_MEMORY_FULL 20 /* Memory full */ 137#define BTA_AG_ERR_INVALID_INDEX 21 /* Invalid index */ 138#define BTA_AG_ERR_MEMORY_FAILURE 23 /* Memory failure */ 139#define BTA_AG_ERR_TEXT_TOO_LONG 24 /* Text string too long */ 140#define BTA_AG_ERR_INV_CHAR_IN_TSTR 25 /* Invalid characters in text string */ 141#define BTA_AG_ERR_DSTR_TOO_LONG 26 /* Dial string too long */ 142#define BTA_AG_ERR_INV_CHAR_IN_DSTR 27 /* Invalid characters in dial string */ 143#define BTA_AG_ERR_NO_NETWORK_SERV 30 /* No network service */ 144#define BTA_AG_ERR_NETWORK_TIME_OUT 31 /* Network timeout */ 145#define BTA_AG_ERR_NO_NET_EMG_ONLY 32 /* Network not allowed - emergency service only */ 146#define BTA_AG_ERR_VOIP_CS_CALLS 33 /* AG cannot create simultaneous VoIP and CS calls */ 147#define BTA_AG_ERR_NOT_FOR_VOIP 34 /* Not supported on this call type(VoIP) */ 148#define BTA_AG_ERR_SIP_RESP_CODE 35 /* SIP 3 digit response code */ 149 150#if 0 /* Not Used in Bluetooth HFP 1.5 Specification */ 151#define BTA_AG_ERR_PHADAP_LNK_RES 2 /* Phone-adapter link reserved */ 152#define BTA_AG_ERR_PHFSIM_PIN_REQ 6 /* PH-FSIM PIN required */ 153#define BTA_AG_ERR_PHFSIM_PUK_REQ 7 /* PH-FSIM PUK required */ 154#define BTA_AG_ERR_SIM_WRONG 15 /* SIM wrong */ 155#define BTA_AG_ERR_NOT_FOUND 22 /* Not found */ 156#define BTA_AG_ERR_NETWORK_TIMEOUT 31 /* Network timeout */ 157#define BTA_AG_ERR_NET_PIN_REQ 40 /* Network personalization PIN required */ 158#define BTA_AG_ERR_NET_PUK_REQ 41 /* Network personalization PUK required */ 159#define BTA_AG_ERR_SUBSET_PIN_REQ 42 /* Network subset personalization PIN required */ 160#define BTA_AG_ERR_SUBSET_PUK_REQ 43 /* Network subset personalization PUK required */ 161#define BTA_AG_ERR_SERVPRO_PIN_REQ 44 /* Service provider personalization PIN required */ 162#define BTA_AG_ERR_SERVPRO_PUK_REQ 45 /* Service provider personalization PUK required */ 163#define BTA_AG_ERR_CORP_PIN_REQ 46 /* Corporate personalization PIN required */ 164#define BTA_AG_ERR_CORP_PUK_REQ 47 /* Corporate personalization PUK required */ 165#define BTA_AG_ERR_UNKNOWN 100 /* Unknown error */ 166/* GPRS-related errors */ 167#define BTA_AG_ERR_ILL_MS 103 /* Illegal MS (#3) */ 168#define BTA_AG_ERR_ILL_ME 106 /* Illegal ME (#6) */ 169#define BTA_AG_ERR_GPRS_NOT_ALLOWED 107 /* GPRS services not allowed (#7) */ 170#define BTA_AG_ERR_PLMN_NOT_ALLOWED 111 /* PLMN services not allowed (#11) */ 171#define BTA_AG_ERR_LOC_NOT_ALLOWED 112 /* Location area not allowed (#12) */ 172#define BTA_AG_ERR_ROAM_NOT_ALLOWED 113 /* Roaming not allowed in this location area (#13) */ 173/* Errors related to a failure to Activate a Context */ 174#define BTA_AG_ERR_OPT_NOT_SUPP 132 /* Service option not supported (#32) */ 175#define BTA_AG_ERR_OPT_NOT_SUBSCR 133 /* Requested service option not subscribed (#33) */ 176#define BTA_AG_ERR_OPT_OUT_OF_ORDER 134 /* Service option temporarily out of order (#34) */ 177#define BTA_AG_ERR_PDP_AUTH_FAILURE 149 /* PDP authentication failure */ 178/* Other GPRS errors */ 179#define BTA_AG_ERR_INV_MOBILE_CLASS 150 /* Invalid mobile class */ 180#define BTA_AG_ERR_UNSPEC_GPRS_ERR 148 /* Unspecified GPRS error */ 181#endif /* Unused error codes */ 182 183 184/* HFP result data 'ok_flag' */ 185#define BTA_AG_OK_CONTINUE 0 /* Send out response (more responses coming) */ 186#define BTA_AG_OK_DONE 1 /* Send out response followed by OK (finished) */ 187#define BTA_AG_OK_ERROR 2 /* Error response */ 188 189/* BTRH values */ 190#define BTA_AG_BTRH_SET_HOLD 0 /* Put incoming call on hold */ 191#define BTA_AG_BTRH_SET_ACC 1 /* Accept incoming call on hold */ 192#define BTA_AG_BTRH_SET_REJ 2 /* Reject incoming call on hold */ 193#define BTA_AG_BTRH_READ 3 /* Read the current value */ 194#define BTA_AG_BTRH_NO_RESP 4 /* Not in RH States (reply to read) */ 195 196/* ASCII character string of arguments to the AT command or result */ 197#ifndef BTA_AG_AT_MAX_LEN 198#define BTA_AG_AT_MAX_LEN 256 199#endif 200 201/* data associated with BTA_AG_IND_RES */ 202typedef struct 203{ 204 UINT16 id; 205 UINT16 value; 206} tBTA_AG_IND; 207 208/* data type for BTA_AgResult() */ 209typedef struct 210{ 211 char str[BTA_AG_AT_MAX_LEN+1]; 212 tBTA_AG_IND ind; 213 UINT16 num; 214 UINT16 audio_handle; 215 UINT16 errcode; /* Valid only if 'ok_flag' is set to BTA_AG_OK_ERROR */ 216 UINT8 ok_flag; /* Indicates if response is finished, and if error occurred */ 217 BOOLEAN state; 218} tBTA_AG_RES_DATA; 219 220/* AG callback events */ 221#define BTA_AG_ENABLE_EVT 0 /* AG enabled */ 222#define BTA_AG_REGISTER_EVT 1 /* AG registered */ 223#define BTA_AG_OPEN_EVT 2 /* AG connection open */ 224#define BTA_AG_CLOSE_EVT 3 /* AG connection closed */ 225#define BTA_AG_CONN_EVT 4 /* Service level connection opened */ 226#define BTA_AG_AUDIO_OPEN_EVT 5 /* Audio connection open */ 227#define BTA_AG_AUDIO_CLOSE_EVT 6 /* Audio connection closed */ 228#define BTA_AG_SPK_EVT 7 /* Speaker volume changed */ 229#define BTA_AG_MIC_EVT 8 /* Microphone volume changed */ 230#define BTA_AG_AT_CKPD_EVT 9 /* CKPD from the HS */ 231#define BTA_AG_DISABLE_EVT 30 /* AG disabled */ 232#if (BTM_WBS_INCLUDED == TRUE ) 233#define BTA_AG_WBS_EVT 31 /* SCO codec info */ 234#endif 235/* Values below are for HFP only */ 236#define BTA_AG_AT_A_EVT 10 /* Answer a call */ 237#define BTA_AG_AT_D_EVT 11 /* Place a call using number or memory dial */ 238#define BTA_AG_AT_CHLD_EVT 12 /* Call hold */ 239#define BTA_AG_AT_CHUP_EVT 13 /* Hang up a call */ 240#define BTA_AG_AT_CIND_EVT 14 /* Read indicator settings */ 241#define BTA_AG_AT_VTS_EVT 15 /* Transmit DTMF tone */ 242#define BTA_AG_AT_BINP_EVT 16 /* Retrieve number from voice tag */ 243#define BTA_AG_AT_BLDN_EVT 17 /* Place call to last dialed number */ 244#define BTA_AG_AT_BVRA_EVT 18 /* Enable/disable voice recognition */ 245#define BTA_AG_AT_NREC_EVT 19 /* Disable echo canceling */ 246#define BTA_AG_AT_CNUM_EVT 20 /* Retrieve subscriber number */ 247#define BTA_AG_AT_BTRH_EVT 21 /* CCAP-style incoming call hold */ 248#define BTA_AG_AT_CLCC_EVT 22 /* Query list of current calls */ 249#define BTA_AG_AT_COPS_EVT 23 /* Query list of current calls */ 250#define BTA_AG_AT_UNAT_EVT 24 /* Unknown AT command */ 251#define BTA_AG_AT_CBC_EVT 25 /* Battery Level report from HF */ 252#define BTA_AG_AT_BAC_EVT 26 /* avablable codec */ 253#define BTA_AG_AT_BCS_EVT 27 /* Codec select */ 254 255typedef UINT8 tBTA_AG_EVT; 256 257/* data associated with most non-AT events */ 258typedef struct 259{ 260 UINT16 handle; 261 UINT8 app_id; 262 tBTA_AG_STATUS status; 263} tBTA_AG_HDR; 264 265/* data associated with BTA_AG_REGISTER_EVT */ 266typedef struct 267{ 268 tBTA_AG_HDR hdr; 269 tBTA_AG_STATUS status; 270} tBTA_AG_REGISTER; 271 272/* data associated with BTA_AG_OPEN_EVT */ 273typedef struct 274{ 275 tBTA_AG_HDR hdr; 276 BD_ADDR bd_addr; 277 tBTA_SERVICE_ID service_id; 278 tBTA_AG_STATUS status; 279} tBTA_AG_OPEN; 280 281/* data associated with BTA_AG_CLOSE_EVT */ 282typedef struct 283{ 284 tBTA_AG_HDR hdr; 285 BD_ADDR bd_addr; 286} tBTA_AG_CLOSE; 287 288/* data associated with BTA_AG_CONN_EVT */ 289typedef struct 290{ 291 tBTA_AG_HDR hdr; 292 tBTA_AG_PEER_FEAT peer_feat; 293 BD_ADDR bd_addr; 294 tBTA_AG_PEER_CODEC peer_codec; 295} tBTA_AG_CONN; 296 297/* data associated with AT command event */ 298typedef struct 299{ 300 tBTA_AG_HDR hdr; 301 BD_ADDR bd_addr; 302 char str[BTA_AG_AT_MAX_LEN+1]; 303 UINT16 num; 304 UINT8 idx; /* call number used by CLCC and CHLD */ 305} tBTA_AG_VAL; 306 307/* union of data associated with AG callback */ 308typedef union 309{ 310 tBTA_AG_HDR hdr; 311 tBTA_AG_REGISTER reg; 312 tBTA_AG_OPEN open; 313 tBTA_AG_CLOSE close; 314 tBTA_AG_CONN conn; 315 tBTA_AG_VAL val; 316} tBTA_AG; 317 318/* AG callback */ 319typedef void (tBTA_AG_CBACK)(tBTA_AG_EVT event, tBTA_AG *p_data); 320 321/* indicator constants HFP 1.1 and later */ 322#define BTA_AG_IND_CALL 1 /* position of call indicator */ 323#define BTA_AG_IND_CALLSETUP 2 /* position of callsetup indicator */ 324#define BTA_AG_IND_SERVICE 3 /* position of service indicator */ 325 326/* indicator constants HFP 1.5 and later */ 327#define BTA_AG_IND_SIGNAL 4 /* position of signal strength indicator */ 328#define BTA_AG_IND_ROAM 5 /* position of roaming indicator */ 329#define BTA_AG_IND_BATTCHG 6 /* position of battery charge indicator */ 330#define BTA_AG_IND_CALLHELD 7 /* position of callheld indicator */ 331#define BTA_AG_IND_BEARER 8 /* position of bearer indicator */ 332 333/* call indicator values */ 334#define BTA_AG_CALL_INACTIVE 0 /* Phone call inactive */ 335#define BTA_AG_CALL_ACTIVE 1 /* Phone call active */ 336 337/* callsetup indicator values */ 338#define BTA_AG_CALLSETUP_NONE 0 /* Not currently in call set up */ 339#define BTA_AG_CALLSETUP_INCOMING 1 /* Incoming call process ongoing */ 340#define BTA_AG_CALLSETUP_OUTGOING 2 /* Outgoing call set up is ongoing */ 341#define BTA_AG_CALLSETUP_ALERTING 3 /* Remote party being alerted in an outgoing call */ 342 343/* service indicator values */ 344#define BTA_AG_SERVICE_NONE 0 /* Neither CS nor VoIP service is available */ 345#define BTA_AG_SERVICE_CS 1 /* Only CS service is available */ 346#define BTA_AG_SERVICE_VOIP 2 /* Only VoIP service is available */ 347#define BTA_AG_SERVICE_CS_VOIP 3 /* Both CS and VoIP services available */ 348 349/* callheld indicator values */ 350#define BTA_AG_CALLHELD_INACTIVE 0 /* No held calls */ 351#define BTA_AG_CALLHELD_ACTIVE 1 /* Call held and call active */ 352#define BTA_AG_CALLHELD_NOACTIVE 2 /* Call held and no call active */ 353 354/* signal strength indicator values */ 355#define BTA_AG_ROAMING_INACTIVE 0 /* Phone call inactive */ 356#define BTA_AG_ROAMING_ACTIVE 1 /* Phone call active */ 357 358/* bearer indicator values */ 359#define BTA_AG_BEARER_WLAN 0 /* WLAN */ 360#define BTA_AG_BEARER_BLUETOOTH 1 /* Bluetooth */ 361#define BTA_AG_BEARER_WIRED 2 /* Wired */ 362#define BTA_AG_BEARER_2G3G 3 /* 2G 3G */ 363#define BTA_AG_BEARER_WIMAX 4 /* WIMAX */ 364#define BTA_AG_BEARER_RES1 5 /* Reserved */ 365#define BTA_AG_BEARER_RES2 6 /* Reserved */ 366#define BTA_AG_BEARER_RES3 7 /* Reserved */ 367 368/* AG configuration structure */ 369typedef struct 370{ 371 char *cind_info; 372 INT32 conn_tout; 373 UINT16 sco_pkt_types; 374 char *chld_val_ecc; 375 char *chld_val; 376} tBTA_AG_CFG; 377 378#ifdef __cplusplus 379extern "C" 380{ 381#endif 382 383/***************************************************************************** 384** External Function Declarations 385*****************************************************************************/ 386 387/******************************************************************************* 388** 389** Function BTA_AgEnable 390** 391** Description Enable the audio gateway service. When the enable 392** operation is complete the callback function will be 393** called with a BTA_AG_ENABLE_EVT. This function must 394** be called before other function in the AG API are 395** called. 396** 397** Returns BTA_SUCCESS if OK, BTA_FAILURE otherwise. 398** 399*******************************************************************************/ 400BTA_API tBTA_STATUS BTA_AgEnable(tBTA_AG_PARSE_MODE parse_mode, tBTA_AG_CBACK *p_cback); 401 402/******************************************************************************* 403** 404** Function BTA_AgDisable 405** 406** Description Disable the audio gateway service 407** 408** 409** Returns void 410** 411*******************************************************************************/ 412BTA_API void BTA_AgDisable(void); 413 414/******************************************************************************* 415** 416** Function BTA_AgRegister 417** 418** Description Register an Audio Gateway service. 419** 420** 421** Returns void 422** 423*******************************************************************************/ 424BTA_API void BTA_AgRegister(tBTA_SERVICE_MASK services, tBTA_SEC sec_mask, 425 tBTA_AG_FEAT features, char *p_service_names[], UINT8 app_id); 426 427/******************************************************************************* 428** 429** Function BTA_AgDeregister 430** 431** Description Deregister an audio gateway service. 432** 433** 434** Returns void 435** 436*******************************************************************************/ 437BTA_API void BTA_AgDeregister(UINT16 handle); 438 439/******************************************************************************* 440** 441** Function BTA_AgOpen 442** 443** Description Opens a connection to a headset or hands-free device. 444** When connection is open callback function is called 445** with a BTA_AG_OPEN_EVT. Only the data connection is 446** opened. The audio connection is not opened. 447** 448** 449** Returns void 450** 451*******************************************************************************/ 452BTA_API void BTA_AgOpen(UINT16 handle, BD_ADDR bd_addr, tBTA_SEC sec_mask, tBTA_SERVICE_MASK services); 453 454/******************************************************************************* 455** 456** Function BTA_AgClose 457** 458** Description Close the current connection to a headset or a handsfree 459** Any current audio connection will also be closed 460** 461** 462** Returns void 463** 464*******************************************************************************/ 465BTA_API void BTA_AgClose(UINT16 handle); 466 467/******************************************************************************* 468** 469** Function BTA_AgAudioOpen 470** 471** Description Opens an audio connection to the currently connected 472** headset or hnadsfree 473** 474** 475** Returns void 476** 477*******************************************************************************/ 478BTA_API void BTA_AgAudioOpen(UINT16 handle); 479 480/******************************************************************************* 481** 482** Function BTA_AgAudioClose 483** 484** Description Close the currently active audio connection to a headset 485** or hnadsfree. The data connection remains open 486** 487** 488** Returns void 489** 490*******************************************************************************/ 491BTA_API void BTA_AgAudioClose(UINT16 handle); 492 493/******************************************************************************* 494** 495** Function BTA_AgResult 496** 497** Description Send an AT result code to a headset or hands-free device. 498** This function is only used when the AG parse mode is set 499** to BTA_AG_PARSE. 500** 501** 502** Returns void 503** 504*******************************************************************************/ 505BTA_API void BTA_AgResult(UINT16 handle, tBTA_AG_RES result, tBTA_AG_RES_DATA *p_data); 506 507/******************************************************************************* 508** 509** Function BTA_AgSetCodec 510** 511** Description Specify the codec type to be used for the subsequent 512** audio connection. 513** 514** 515** 516** Returns void 517** 518*******************************************************************************/ 519BTA_API void BTA_AgSetCodec(UINT16 handle, tBTA_AG_PEER_CODEC codec); 520 521#ifdef __cplusplus 522} 523#endif 524 525#endif /* BTA_AG_API_H */ 526 527 528