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 */
23typedef 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 */
31typedef 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 */
41typedef 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 */
47typedef 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 */
56typedef 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. */
61typedef 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 */
82typedef 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 */
104