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 interface file for audio gateway call-out functions. 22 * 23 ******************************************************************************/ 24 #ifndef BTA_AG_CO_H 25 #define BTA_AG_CO_H 26 27 #include "bta_ag_api.h" 28 29 /* Definitions for audio state callout function "state" parameter */ 30 #define BTA_AG_CO_AUD_STATE_OFF 0 31 #define BTA_AG_CO_AUD_STATE_OFF_XFER 1 /* Closed pending transfer of audio */ 32 #define BTA_AG_CO_AUD_STATE_ON 2 33 #define BTA_AG_CO_AUD_STATE_SETUP 3 34 35 /******************************************************************************* 36 ** 37 ** Function bta_ag_co_init 38 ** 39 ** Description This callout function is executed by AG when it is 40 ** started by calling BTA_AgEnable(). This function can be 41 ** used by the phone to initialize audio paths or for other 42 ** initialization purposes. 43 ** 44 ** 45 ** Returns Void. 46 ** 47 *******************************************************************************/ 48 BTA_API extern void bta_ag_co_init(void); 49 50 /******************************************************************************* 51 ** 52 ** Function bta_ag_co_audio_state 53 ** 54 ** Description This function is called by the AG before the audio connection 55 ** is brought up, after it comes up, and after it goes down. 56 ** 57 ** Parameters handle - handle of the AG instance 58 ** state - Audio state 59 ** BTA_AG_CO_AUD_STATE_OFF - Audio has been turned off 60 ** BTA_AG_CO_AUD_STATE_OFF_XFER - Audio is closed pending transfer 61 ** BTA_AG_CO_AUD_STATE_ON - Audio has been turned on 62 ** BTA_AG_CO_AUD_STATE_SETUP - Audio is about to be turned on 63 ** codec - if WBS support is compiled in, codec to going to be used is provided 64 ** and when in BTA_AG_CO_AUD_STATE_SETUP, BTM_I2SPCMConfig() must be called with 65 ** the correct platform parameters. 66 ** in the other states codec type should not be ignored 67 ** 68 ** Returns void 69 ** 70 *******************************************************************************/ 71 #if (BTM_WBS_INCLUDED == TRUE ) 72 BTA_API extern void bta_ag_co_audio_state(UINT16 handle, UINT8 app_id, UINT8 state, 73 tBTA_AG_PEER_CODEC codec); 74 75 #else 76 BTA_API extern void bta_ag_co_audio_state(UINT16 handle, UINT8 app_id, UINT8 state); 77 #endif 78 79 /******************************************************************************* 80 ** 81 ** Function bta_ag_co_data_open 82 ** 83 ** Description This function is executed by AG when a service level connection 84 ** is opened. The phone can use this function to set 85 ** up data paths or perform any required initialization or 86 ** set up particular to the connected service. 87 ** 88 ** 89 ** Returns void 90 ** 91 *******************************************************************************/ 92 BTA_API extern void bta_ag_co_data_open(UINT16 handle, tBTA_SERVICE_ID service); 93 94 /******************************************************************************* 95 ** 96 ** Function bta_ag_co_data_close 97 ** 98 ** Description This function is called by AG when a service level 99 ** connection is closed 100 ** 101 ** 102 ** Returns void 103 ** 104 *******************************************************************************/ 105 BTA_API extern void bta_ag_co_data_close(UINT16 handle); 106 107 /******************************************************************************* 108 ** 109 ** Function bta_ag_co_tx_write 110 ** 111 ** Description This function is called by the AG to send data to the 112 ** phone when the AG is configured for AT command pass-through. 113 ** The implementation of this function must copy the data to 114 ** the phones memory. 115 ** 116 ** Returns void 117 ** 118 *******************************************************************************/ 119 BTA_API extern void bta_ag_co_tx_write(UINT16 handle, UINT8 *p_data, UINT16 len); 120 121 #endif /* BTA_AG_CO_H */ 122 123