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*******************************************************************************/
48BTA_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**
64** Returns          void
65**
66*******************************************************************************/
67BTA_API extern void bta_ag_co_audio_state(UINT16 handle, UINT8 app_id, UINT8 state);
68
69/*******************************************************************************
70**
71** Function         bta_ag_co_data_open
72**
73** Description      This function is executed by AG when a service level connection
74**                  is opened.  The phone can use this function to set
75**                  up data paths or perform any required initialization or
76**                  set up particular to the connected service.
77**
78**
79** Returns          void
80**
81*******************************************************************************/
82BTA_API extern void bta_ag_co_data_open(UINT16 handle, tBTA_SERVICE_ID service);
83
84/*******************************************************************************
85**
86** Function         bta_ag_co_data_close
87**
88** Description      This function is called by AG when a service level
89**                  connection is closed
90**
91**
92** Returns          void
93**
94*******************************************************************************/
95BTA_API extern void bta_ag_co_data_close(UINT16 handle);
96
97/*******************************************************************************
98**
99** Function         bta_ag_co_tx_write
100**
101** Description      This function is called by the AG to send data to the
102**                  phone when the AG is configured for AT command pass-through.
103**                  The implementation of this function must copy the data to
104**                  the phones memory.
105**
106** Returns          void
107**
108*******************************************************************************/
109BTA_API extern void bta_ag_co_tx_write(UINT16 handle, UINT8 *p_data, UINT16 len);
110
111#endif /* BTA_AG_CO_H */
112
113