summaryrefslogtreecommitdiffstats
path: root/include/hardware/bt_hf_client.h
blob: 8acf1b2c5adb02537517c517e8aa4f3cd5fb4f9d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
/*
 * Copyright (C) 2012-2014 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#ifndef ANDROID_INCLUDE_BT_HF_CLIENT_H
#define ANDROID_INCLUDE_BT_HF_CLIENT_H

__BEGIN_DECLS

typedef enum {
    BTHF_CLIENT_CONNECTION_STATE_DISCONNECTED = 0,
    BTHF_CLIENT_CONNECTION_STATE_CONNECTING,
    BTHF_CLIENT_CONNECTION_STATE_CONNECTED,
    BTHF_CLIENT_CONNECTION_STATE_SLC_CONNECTED,
    BTHF_CLIENT_CONNECTION_STATE_DISCONNECTING
} bthf_client_connection_state_t;

typedef enum {
    BTHF_CLIENT_AUDIO_STATE_DISCONNECTED = 0,
    BTHF_CLIENT_AUDIO_STATE_CONNECTING,
    BTHF_CLIENT_AUDIO_STATE_CONNECTED,
    BTHF_CLIENT_AUDIO_STATE_CONNECTED_MSBC,
} bthf_client_audio_state_t;

typedef enum {
    BTHF_CLIENT_VR_STATE_STOPPED = 0,
    BTHF_CLIENT_VR_STATE_STARTED
} bthf_client_vr_state_t;

typedef enum {
    BTHF_CLIENT_VOLUME_TYPE_SPK = 0,
    BTHF_CLIENT_VOLUME_TYPE_MIC
} bthf_client_volume_type_t;

typedef enum
{
    BTHF_CLIENT_NETWORK_STATE_NOT_AVAILABLE = 0,
    BTHF_CLIENT_NETWORK_STATE_AVAILABLE
} bthf_client_network_state_t;

typedef enum
{
    BTHF_CLIENT_SERVICE_TYPE_HOME = 0,
    BTHF_CLIENT_SERVICE_TYPE_ROAMING
} bthf_client_service_type_t;

typedef enum {
    BTHF_CLIENT_CALL_STATE_ACTIVE = 0,
    BTHF_CLIENT_CALL_STATE_HELD,
    BTHF_CLIENT_CALL_STATE_DIALING,
    BTHF_CLIENT_CALL_STATE_ALERTING,
    BTHF_CLIENT_CALL_STATE_INCOMING,
    BTHF_CLIENT_CALL_STATE_WAITING,
    BTHF_CLIENT_CALL_STATE_HELD_BY_RESP_HOLD,
} bthf_client_call_state_t;

typedef enum {
    BTHF_CLIENT_CALL_NO_CALLS_IN_PROGRESS = 0,
    BTHF_CLIENT_CALL_CALLS_IN_PROGRESS
} bthf_client_call_t;

typedef enum {
    BTHF_CLIENT_CALLSETUP_NONE = 0,
    BTHF_CLIENT_CALLSETUP_INCOMING,
    BTHF_CLIENT_CALLSETUP_OUTGOING,
    BTHF_CLIENT_CALLSETUP_ALERTING

} bthf_client_callsetup_t;

typedef enum {
    BTHF_CLIENT_CALLHELD_NONE = 0,
    BTHF_CLIENT_CALLHELD_HOLD_AND_ACTIVE,
    BTHF_CLIENT_CALLHELD_HOLD,
} bthf_client_callheld_t;

typedef enum {
    BTHF_CLIENT_RESP_AND_HOLD_HELD = 0,
    BTRH_CLIENT_RESP_AND_HOLD_ACCEPT,
    BTRH_CLIENT_RESP_AND_HOLD_REJECT,
} bthf_client_resp_and_hold_t;

typedef enum {
    BTHF_CLIENT_CALL_DIRECTION_OUTGOING = 0,
    BTHF_CLIENT_CALL_DIRECTION_INCOMING
} bthf_client_call_direction_t;

typedef enum {
    BTHF_CLIENT_CALL_MPTY_TYPE_SINGLE = 0,
    BTHF_CLIENT_CALL_MPTY_TYPE_MULTI
} bthf_client_call_mpty_type_t;

typedef enum {
    BTHF_CLIENT_CMD_COMPLETE_OK = 0,
    BTHF_CLIENT_CMD_COMPLETE_ERROR,
    BTHF_CLIENT_CMD_COMPLETE_ERROR_NO_CARRIER,
    BTHF_CLIENT_CMD_COMPLETE_ERROR_BUSY,
    BTHF_CLIENT_CMD_COMPLETE_ERROR_NO_ANSWER,
    BTHF_CLIENT_CMD_COMPLETE_ERROR_DELAYED,
    BTHF_CLIENT_CMD_COMPLETE_ERROR_BLACKLISTED,
    BTHF_CLIENT_CMD_COMPLETE_ERROR_CME
} bthf_client_cmd_complete_t;

typedef enum {
    BTHF_CLIENT_CALL_ACTION_CHLD_0 = 0,
    BTHF_CLIENT_CALL_ACTION_CHLD_1,
    BTHF_CLIENT_CALL_ACTION_CHLD_2,
    BTHF_CLIENT_CALL_ACTION_CHLD_3,
    BTHF_CLIENT_CALL_ACTION_CHLD_4,
    BTHF_CLIENT_CALL_ACTION_CHLD_1x,
    BTHF_CLIENT_CALL_ACTION_CHLD_2x,
    BTHF_CLIENT_CALL_ACTION_ATA,
    BTHF_CLIENT_CALL_ACTION_CHUP,
    BTHF_CLIENT_CALL_ACTION_BTRH_0,
    BTHF_CLIENT_CALL_ACTION_BTRH_1,
    BTHF_CLIENT_CALL_ACTION_BTRH_2,
} bthf_client_call_action_t;

typedef enum {
    BTHF_CLIENT_SERVICE_UNKNOWN = 0,
    BTHF_CLIENT_SERVICE_VOICE,
    BTHF_CLIENT_SERVICE_FAX
} bthf_client_subscriber_service_type_t;

typedef enum {
    BTHF_CLIENT_IN_BAND_RINGTONE_NOT_PROVIDED = 0,
    BTHF_CLIENT_IN_BAND_RINGTONE_PROVIDED,
} bthf_client_in_band_ring_state_t;

/* Peer features masks */
#define BTHF_CLIENT_PEER_FEAT_3WAY   0x00000001  /* Three-way calling */
#define BTHF_CLIENT_PEER_FEAT_ECNR   0x00000002  /* Echo cancellation and/or noise reduction */
#define BTHF_CLIENT_PEER_FEAT_VREC   0x00000004  /* Voice recognition */
#define BTHF_CLIENT_PEER_FEAT_INBAND 0x00000008  /* In-band ring tone */
#define BTHF_CLIENT_PEER_FEAT_VTAG   0x00000010  /* Attach a phone number to a voice tag */
#define BTHF_CLIENT_PEER_FEAT_REJECT 0x00000020  /* Ability to reject incoming call */
#define BTHF_CLIENT_PEER_FEAT_ECS    0x00000040  /* Enhanced Call Status */
#define BTHF_CLIENT_PEER_FEAT_ECC    0x00000080  /* Enhanced Call Control */
#define BTHF_CLIENT_PEER_FEAT_EXTERR 0x00000100  /* Extended error codes */
#define BTHF_CLIENT_PEER_FEAT_CODEC  0x00000200  /* Codec Negotiation */

/* Peer call handling features masks */
#define BTHF_CLIENT_CHLD_FEAT_REL           0x00000001  /* 0  Release waiting call or held calls */
#define BTHF_CLIENT_CHLD_FEAT_REL_ACC       0x00000002  /* 1  Release active calls and accept other
                                                              (waiting or held) cal */
#define BTHF_CLIENT_CHLD_FEAT_REL_X         0x00000004  /* 1x Release specified active call only */
#define BTHF_CLIENT_CHLD_FEAT_HOLD_ACC      0x00000008  /* 2  Active calls on hold and accept other
                                                              (waiting or held) call */
#define BTHF_CLIENT_CHLD_FEAT_PRIV_X        0x00000010  /* 2x Request private mode with specified
                                                              call (put the rest on hold) */
#define BTHF_CLIENT_CHLD_FEAT_MERGE         0x00000020  /* 3  Add held call to multiparty */
#define BTHF_CLIENT_CHLD_FEAT_MERGE_DETACH  0x00000040  /* 4  Connect two calls and leave
                                                              (disconnect from) multiparty */

/** Callback for connection state change.
 *  state will have one of the values from BtHfConnectionState
 *  peer/chld_features are valid only for BTHF_CLIENT_CONNECTION_STATE_SLC_CONNECTED state
 */
typedef void (* bthf_client_connection_state_callback)(bthf_client_connection_state_t state,
                                                       unsigned int peer_feat,
                                                       unsigned int chld_feat,
                                                       bt_bdaddr_t *bd_addr);

/** Callback for audio connection state change.
 *  state will have one of the values from BtHfAudioState
 */
typedef void (* bthf_client_audio_state_callback)(bthf_client_audio_state_t state,
                                                  bt_bdaddr_t *bd_addr);

/** Callback for VR connection state change.
 *  state will have one of the values from BtHfVRState
 */
typedef void (* bthf_client_vr_cmd_callback)(bthf_client_vr_state_t state);

/** Callback for network state change
 */
typedef void (* bthf_client_network_state_callback) (bthf_client_network_state_t state);

/** Callback for network roaming status change
 */
typedef void (* bthf_client_network_roaming_callback) (bthf_client_service_type_t type);

/** Callback for signal strength indication
 */
typedef void (* bthf_client_network_signal_callback) (int signal_strength);

/** Callback for battery level indication
 */
typedef void (* bthf_client_battery_level_callback) (int battery_level);

/** Callback for current operator name
 */
typedef void (* bthf_client_current_operator_callback) (const char *name);

/** Callback for call indicator
 */
typedef void (* bthf_client_call_callback) (bthf_client_call_t call);

/** Callback for callsetup indicator
 */
typedef void (* bthf_client_callsetup_callback) (bthf_client_callsetup_t callsetup);

/** Callback for callheld indicator
 */
typedef void (* bthf_client_callheld_callback) (bthf_client_callheld_t callheld);

/** Callback for response and hold
 */
typedef void (* bthf_client_resp_and_hold_callback) (bthf_client_resp_and_hold_t resp_and_hold);

/** Callback for Calling Line Identification notification
 *  Will be called only when there is an incoming call and number is provided.
 */
typedef void (* bthf_client_clip_callback) (const char *number);

/**
 * Callback for Call Waiting notification
 */
typedef void (* bthf_client_call_waiting_callback) (const char *number);

/**
 *  Callback for listing current calls. Can be called multiple time.
 *  If number is unknown NULL is passed.
 */
typedef void (*bthf_client_current_calls) (int index, bthf_client_call_direction_t dir,
                                           bthf_client_call_state_t state,
                                           bthf_client_call_mpty_type_t mpty,
                                           const char *number);

/** Callback for audio volume change
 */
typedef void (*bthf_client_volume_change_callback) (bthf_client_volume_type_t type, int volume);

/** Callback for command complete event
 *  cme is valid only for BTHF_CLIENT_CMD_COMPLETE_ERROR_CME type
 */
typedef void (*bthf_client_cmd_complete_callback) (bthf_client_cmd_complete_t type, int cme);

/** Callback for subscriber information
 */
typedef void (* bthf_client_subscriber_info_callback) (const char *name,
                                                       bthf_client_subscriber_service_type_t type);

/** Callback for in-band ring tone settings
 */
typedef void (* bthf_client_in_band_ring_tone_callback) (bthf_client_in_band_ring_state_t state);

/**
 * Callback for requested number from AG
 */
typedef void (* bthf_client_last_voice_tag_number_callback) (const char *number);

/**
 * Callback for sending ring indication to app
 */
typedef void (* bthf_client_ring_indication_callback) (void);

/** BT-HF callback structure. */
typedef struct {
    /** set to sizeof(BtHfClientCallbacks) */
    size_t      size;
    bthf_client_connection_state_callback  connection_state_cb;
    bthf_client_audio_state_callback       audio_state_cb;
    bthf_client_vr_cmd_callback            vr_cmd_cb;
    bthf_client_network_state_callback     network_state_cb;
    bthf_client_network_roaming_callback   network_roaming_cb;
    bthf_client_network_signal_callback    network_signal_cb;
    bthf_client_battery_level_callback     battery_level_cb;
    bthf_client_current_operator_callback  current_operator_cb;
    bthf_client_call_callback              call_cb;
    bthf_client_callsetup_callback         callsetup_cb;
    bthf_client_callheld_callback          callheld_cb;
    bthf_client_resp_and_hold_callback     resp_and_hold_cb;
    bthf_client_clip_callback              clip_cb;
    bthf_client_call_waiting_callback      call_waiting_cb;
    bthf_client_current_calls              current_calls_cb;
    bthf_client_volume_change_callback     volume_change_cb;
    bthf_client_cmd_complete_callback      cmd_complete_cb;
    bthf_client_subscriber_info_callback   subscriber_info_cb;
    bthf_client_in_band_ring_tone_callback in_band_ring_tone_cb;
    bthf_client_last_voice_tag_number_callback last_voice_tag_number_callback;
    bthf_client_ring_indication_callback   ring_indication_cb;
} bthf_client_callbacks_t;

/** Represents the standard BT-HF interface. */
typedef struct {

    /** set to sizeof(BtHfClientInterface) */
    size_t size;
    /**
     * Register the BtHf callbacks
     */
    bt_status_t (*init)(bthf_client_callbacks_t* callbacks);

    /** connect to audio gateway */
    bt_status_t (*connect)(bt_bdaddr_t *bd_addr);

    /** disconnect from audio gateway */
    bt_status_t (*disconnect)(bt_bdaddr_t *bd_addr);

    /** create an audio connection */
    bt_status_t (*connect_audio)(bt_bdaddr_t *bd_addr);

    /** close the audio connection */
    bt_status_t (*disconnect_audio)(bt_bdaddr_t *bd_addr);

    /** start voice recognition */
    bt_status_t (*start_voice_recognition)(void);

    /** stop voice recognition */
    bt_status_t (*stop_voice_recognition)(void);

    /** volume control */
    bt_status_t (*volume_control) (bthf_client_volume_type_t type, int volume);

    /** place a call with number a number
     * if number is NULL last called number is called (aka re-dial)*/
    bt_status_t (*dial) (const char *number);

    /** place a call with number specified by location (speed dial) */
    bt_status_t (*dial_memory) (int location);

    /** perform specified call related action
     * idx is limited only for enhanced call control related action
     */
    bt_status_t (*handle_call_action) (bthf_client_call_action_t action, int idx);

    /** query list of current calls */
    bt_status_t (*query_current_calls) (void);

    /** query name of current selected operator */
    bt_status_t (*query_current_operator_name) (void);

    /** Retrieve subscriber information */
    bt_status_t (*retrieve_subscriber_info) (void);

    /** Send DTMF code*/
    bt_status_t (*send_dtmf) (char code);

    /** Request a phone number from AG corresponding to last voice tag recorded */
    bt_status_t (*request_last_voice_tag_number) (void);

    /** Closes the interface. */
    void (*cleanup)(void);

    /** Send AT Command. */
    bt_status_t (*send_at_cmd) (int cmd, int val1, int val2, const char *arg);
} bthf_client_interface_t;

__END_DECLS

#endif /* ANDROID_INCLUDE_BT_HF_CLIENT_H */