hardware/bt_av.h

   1 /*
   2  * Copyright (C) 2012 The Android Open Source Project
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at
   7  *
   8  *      http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  */
  16
  17 #ifndef ANDROID_INCLUDE_BT_AV_H
  18 #define ANDROID_INCLUDE_BT_AV_H
  19
  20 __BEGIN_DECLS
  21
  22 /* Bluetooth AV connection states */
  23 typedef enum {
  24         BTAV_CONNECTION_STATE_DISCONNECTED = 0,
  25         BTAV_CONNECTION_STATE_CONNECTING,
  26         BTAV_CONNECTION_STATE_CONNECTED,
  27         BTAV_CONNECTION_STATE_DISCONNECTING
  28 } btav_connection_state_t;
  29
  30 /* Bluetooth AV datapath states */
  31 typedef enum {
  32         BTAV_AUDIO_STATE_REMOTE_SUSPEND = 0,
  33         BTAV_AUDIO_STATE_STOPPED,
  34         BTAV_AUDIO_STATE_STARTED,
  35 } btav_audio_state_t;
  36
  37
  38 /** Callback for connection state change.
  39  *  state will have one of the values from btav_connection_state_t
  40  */
  41 typedef void (*btav_connection_state_callback)(btav_connection_state_t state,
  42                 bt_bdaddr_t *bd_addr);
  43
  44 /** Callback for audiopath state change.
  45  *  state will have one of the values from btav_audio_state_t
  46  */
  47 typedef void (*btav_audio_state_callback)(btav_audio_state_t state,
  48                 bt_bdaddr_t *bd_addr);
  49
  50 /** Callback for audio configuration change.
  51  *  Used only for the A2DP sink interface.
  52  *  state will have one of the values from btav_audio_state_t
  53  *  sample_rate: sample rate in Hz
  54  *  channel_count: number of channels (1 for mono, 2 for stereo)
  55  */
  56 typedef void (*btav_audio_config_callback)(bt_bdaddr_t *bd_addr,
  57                 uint32_t sample_rate,
  58                 uint8_t channel_count);
  59
  60 /** BT-AV callback structure. */
  61 typedef struct {
  62         /** set to sizeof(btav_callbacks_t) */
  63         size_t      size;
  64         btav_connection_state_callback  connection_state_cb;
  65         btav_audio_state_callback audio_state_cb;
  66         btav_audio_config_callback audio_config_cb;
  67 } btav_callbacks_t;
  68
  69 /**
  70  * NOTE:
  71  *
  72  * 1. AVRCP 1.0 shall be supported initially. AVRCP passthrough commands
  73  *    shall be handled internally via uinput
  74  *
  75  * 2. A2DP data path shall be handled via a socket pipe between the AudioFlinger
  76  *    android_audio_hw library and the Bluetooth stack.
  77  *
  78  */
  79 /** Represents the standard BT-AV interface.
  80  *  Used for both the A2DP source and sink interfaces.
  81  */
  82 typedef struct {
  83
  84         /** set to sizeof(btav_interface_t) */
  85         size_t          size;
  86         /**
  87          * Register the BtAv callbacks
  88          */
  89         bt_status_t (*init)(btav_callbacks_t* callbacks);
  90
  91         /** connect to headset */
  92         bt_status_t (*connect)(bt_bdaddr_t *bd_addr);
  93
  94         /** dis-connect from headset */
  95         bt_status_t (*disconnect)(bt_bdaddr_t *bd_addr);
  96
  97         /** Closes the interface. */
  98         void  (*cleanup)(void);
  99 } btav_interface_t;
 100
 101 __END_DECLS
 102
 103 #endif /* ANDROID_INCLUDE_BT_AV_H */