Home | History | Annotate | Download | only in include 
      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 #include "hci/include/hci_audio.h"
     29 
     30 /*******************************************************************************
     31 **
     32 ** Function         bta_ag_co_init
     33 **
     34 ** Description      This callout function is executed by AG when it is
     35 **                  started by calling BTA_AgEnable().  This function can be
     36 **                  used by the phone to initialize audio paths or for other
     37 **                  initialization purposes.
     38 **
     39 **
     40 ** Returns          Void.
     41 **
     42 *******************************************************************************/
     43 extern void bta_ag_co_init(void);
     44 
     45 /*******************************************************************************
     46 **
     47 ** Function         bta_ag_co_audio_state
     48 **
     49 ** Description      This function is called by the AG before the audio connection
     50 **                  is brought up, after it comes up, and after it goes down.
     51 **
     52 ** Parameters       handle - handle of the AG instance
     53 **                  state - Audio state
     54 **                  codec - if WBS support is compiled in, codec to going to be used is provided
     55 **                      and when in SCO_STATE_SETUP, BTM_I2SPCMConfig() must be called with
     56 **                      the correct platform parameters.
     57 **                      in the other states codec type should not be ignored
     58 **
     59 ** Returns          void
     60 **
     61 *******************************************************************************/
     62 #if (BTM_WBS_INCLUDED == TRUE )
     63 extern void bta_ag_co_audio_state(UINT16 handle, UINT8 app_id, UINT8 state,
     64                                           tBTA_AG_PEER_CODEC codec);
     65 
     66 #else
     67 extern void bta_ag_co_audio_state(UINT16 handle, UINT8 app_id, UINT8 state);
     68 #endif
     69 
     70 /*******************************************************************************
     71 **
     72 ** Function         bta_ag_co_data_open
     73 **
     74 ** Description      This function is executed by AG when a service level connection
     75 **                  is opened.  The phone can use this function to set
     76 **                  up data paths or perform any required initialization or
     77 **                  set up particular to the connected service.
     78 **
     79 **
     80 ** Returns          void
     81 **
     82 *******************************************************************************/
     83 extern void bta_ag_co_data_open(UINT16 handle, tBTA_SERVICE_ID service);
     84 
     85 /*******************************************************************************
     86 **
     87 ** Function         bta_ag_co_data_close
     88 **
     89 ** Description      This function is called by AG when a service level
     90 **                  connection is closed
     91 **
     92 **
     93 ** Returns          void
     94 **
     95 *******************************************************************************/
     96 extern void bta_ag_co_data_close(UINT16 handle);
     97 
     98 /*******************************************************************************
     99 **
    100 ** Function         bta_ag_co_tx_write
    101 **
    102 ** Description      This function is called by the AG to send data to the
    103 **                  phone when the AG is configured for AT command pass-through.
    104 **                  The implementation of this function must copy the data to
    105 **                  the phones memory.
    106 **
    107 ** Returns          void
    108 **
    109 *******************************************************************************/
    110 extern void bta_ag_co_tx_write(UINT16 handle, UINT8 *p_data, UINT16 len);
    111 
    112 #endif /* BTA_AG_CO_H */
    113