1/******************************************************************************
2 *
3 *  Copyright 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 private interface file for the BTA audio gateway.
22 *
23 ******************************************************************************/
24#ifndef BTA_AG_INT_H
25#define BTA_AG_INT_H
26
27#include "bta_ag_api.h"
28#include "bta_ag_at.h"
29#include "bta_api.h"
30#include "bta_sys.h"
31
32/*****************************************************************************
33 *  Constants
34 ****************************************************************************/
35/* Time to wait for retry in case of collision */
36#ifndef BTA_AG_COLLISION_TIMEOUT_MS
37#define BTA_AG_COLLISION_TIMEOUT_MS (2 * 1000) /* 2 seconds */
38#endif
39
40/* RFCOMM MTU SIZE */
41#define BTA_AG_MTU 256
42
43/* Max number of peer and local HF indicators */
44#define BTA_AG_MAX_NUM_PEER_HF_IND 20
45#define BTA_AG_MAX_NUM_LOCAL_HF_IND 4
46
47/* Internal profile indexes */
48#define BTA_AG_HSP 0     /* index for HSP */
49#define BTA_AG_HFP 1     /* index for HFP */
50#define BTA_AG_NUM_IDX 2 /* number of profile indexes */
51
52/* profile role for connection */
53#define BTA_AG_ACP 0 /* accepted connection */
54#define BTA_AG_INT 1 /* initiating connection */
55
56#define BTA_AG_SDP_FEAT_SPEC                                \
57  (BTA_AG_FEAT_3WAY | BTA_AG_FEAT_ECNR | BTA_AG_FEAT_VREC | \
58   BTA_AG_FEAT_INBAND | BTA_AG_FEAT_VTAG)
59
60enum {
61  /* these events are handled by the state machine */
62  BTA_AG_API_REGISTER_EVT = BTA_SYS_EVT_START(BTA_ID_AG),
63  BTA_AG_API_DEREGISTER_EVT,
64  BTA_AG_API_OPEN_EVT,
65  BTA_AG_API_CLOSE_EVT,
66  BTA_AG_API_AUDIO_OPEN_EVT,
67  BTA_AG_API_AUDIO_CLOSE_EVT,
68  BTA_AG_API_RESULT_EVT,
69  BTA_AG_API_SETCODEC_EVT,
70  BTA_AG_RFC_OPEN_EVT,
71  BTA_AG_RFC_CLOSE_EVT,
72  BTA_AG_RFC_SRV_CLOSE_EVT,
73  BTA_AG_RFC_DATA_EVT,
74  BTA_AG_SCO_OPEN_EVT,
75  BTA_AG_SCO_CLOSE_EVT,
76  BTA_AG_DISC_ACP_RES_EVT,
77  BTA_AG_DISC_INT_RES_EVT,
78  BTA_AG_DISC_OK_EVT,
79  BTA_AG_DISC_FAIL_EVT,
80  BTA_AG_RING_TIMEOUT_EVT,
81  BTA_AG_SVC_TIMEOUT_EVT,
82  BTA_AG_COLLISION_EVT,
83  BTA_AG_MAX_EVT,
84};
85
86/* Actions to perform after a SCO event */
87enum {
88  BTA_AG_POST_SCO_NONE,      /* no action */
89  BTA_AG_POST_SCO_CLOSE_RFC, /* close RFCOMM channel after SCO closes */
90  BTA_AG_POST_SCO_RING,      /* send RING result code after SCO opens */
91  BTA_AG_POST_SCO_CALL_CONN, /* send call indicators after SCO opens/closes */
92  BTA_AG_POST_SCO_CALL_ORIG, /* send call indicators after SCO closes */
93  BTA_AG_POST_SCO_CALL_END,  /* send call indicators after SCO closes */
94  BTA_AG_POST_SCO_CALL_END_INCALL /* send call indicators for end call &
95                                     incoming call after SCO closes */
96};
97
98/* sco states */
99enum {
100  BTA_AG_SCO_SHUTDOWN_ST,   /* no sco listening, all sco connections closed */
101  BTA_AG_SCO_LISTEN_ST,     /* sco listening */
102  BTA_AG_SCO_CODEC_ST,      /* sco codec negotiation */
103  BTA_AG_SCO_OPENING_ST,    /* sco connection opening */
104  BTA_AG_SCO_OPEN_CL_ST,    /* opening sco connection being closed */
105  BTA_AG_SCO_OPEN_XFER_ST,  /* opening sco connection being transferred */
106  BTA_AG_SCO_OPEN_ST,       /* sco open */
107  BTA_AG_SCO_CLOSING_ST,    /* sco closing */
108  BTA_AG_SCO_CLOSE_OP_ST,   /* closing sco being opened */
109  BTA_AG_SCO_CLOSE_XFER_ST, /* closing sco being transferred */
110  BTA_AG_SCO_SHUTTING_ST    /* sco shutting down */
111};
112
113/*****************************************************************************
114 *  Data types
115 ****************************************************************************/
116
117/* data type for BTA_AG_API_REGISTER_EVT */
118typedef struct {
119  char p_name[2][BTA_SERVICE_NAME_LEN + 1];
120  tBTA_SERVICE_MASK services;
121  tBTA_SEC sec_mask;
122  tBTA_AG_FEAT features;
123  uint8_t app_id;
124} tBTA_AG_API_REGISTER;
125
126/* data type for BTA_AG_API_OPEN_EVT */
127typedef struct {
128  RawAddress bd_addr;
129  tBTA_SEC sec_mask;
130} tBTA_AG_API_OPEN;
131
132/* data type for BTA_AG_API_RESULT_EVT */
133typedef struct {
134  tBTA_AG_RES result;
135  tBTA_AG_RES_DATA data;
136} tBTA_AG_API_RESULT;
137
138/* data type for BTA_AG_API_SETCODEC_EVT */
139typedef struct {
140  tBTA_AG_PEER_CODEC codec;
141} tBTA_AG_API_SETCODEC;
142
143/* data type for BTA_AG_DISC_RESULT_EVT */
144typedef struct {
145  uint16_t status;
146} tBTA_AG_DISC_RESULT;
147
148/* data type for RFCOMM events */
149typedef struct {
150  uint16_t port_handle;
151} tBTA_AG_RFC;
152
153/* union of all event datatypes */
154union tBTA_AG_DATA {
155  tBTA_AG_API_REGISTER api_register;
156  tBTA_AG_API_OPEN api_open;
157  tBTA_AG_API_RESULT api_result;
158  tBTA_AG_API_SETCODEC api_setcodec;
159  tBTA_AG_DISC_RESULT disc_result;
160  tBTA_AG_RFC rfc;
161  static const tBTA_AG_DATA kEmpty;
162
163  /**
164   * Check if two tBTA_AG_DATA are equal in memory
165   *
166   * @param rhs other tBTA_AG_DATA
167   * @return true if both unions are equal in memory
168   */
169  bool operator==(const tBTA_AG_DATA& rhs) const {
170    return (std::memcmp(this, &rhs, sizeof(tBTA_AG_DATA)) == 0);
171  }
172
173  /**
174   * Check if this union is empty by comparing it to the kEmpty constant
175   *
176   * @return true if this union is empty
177   */
178  bool IsEmpty() const { return *this == kEmpty; }
179};
180
181/* type for each profile */
182typedef struct {
183  uint32_t sdp_handle;
184  uint8_t scn;
185} tBTA_AG_PROFILE;
186
187typedef enum {
188  BTA_AG_SCO_MSBC_SETTINGS_T2 = 0, /* preferred/default when codec is mSBC */
189  BTA_AG_SCO_MSBC_SETTINGS_T1,
190} tBTA_AG_SCO_MSBC_SETTINGS;
191
192/* type for each service control block */
193struct tBTA_AG_SCB {
194  char clip[BTA_AG_AT_MAX_LEN + 1];     /* number string used for CLIP */
195  uint16_t serv_handle[BTA_AG_NUM_IDX]; /* RFCOMM server handles */
196  tBTA_AG_AT_CB at_cb;                  /* AT command interpreter */
197  RawAddress peer_addr;                 /* peer bd address */
198  tSDP_DISCOVERY_DB* p_disc_db;         /* pointer to discovery database */
199  tBTA_SERVICE_MASK reg_services;       /* services specified in register API */
200  tBTA_SERVICE_MASK open_services;      /* services specified in open API */
201  uint16_t conn_handle;                 /* RFCOMM handle of connected service */
202  tBTA_SEC serv_sec_mask;               /* server security mask */
203  tBTA_SEC cli_sec_mask;                /* client security mask */
204  tBTA_AG_FEAT features;                /* features registered by application */
205  tBTA_AG_PEER_FEAT peer_features;      /* peer device features */
206  uint16_t peer_sdp_features;           /* peer device SDP features */
207  uint16_t peer_version;                /* profile version of peer device */
208  uint16_t hsp_version;                 /* HSP profile version before SDP */
209  uint16_t sco_idx;                     /* SCO handle */
210  bool in_use;                          /* scb in use */
211  bool dealloc;                         /* true if service shutting down */
212  bool clip_enabled;        /* set to true if HF enables CLIP reporting */
213  bool ccwa_enabled;        /* set to true if HF enables CCWA reporting */
214  bool cmer_enabled;        /* set to true if HF enables CMER reporting */
215  bool cmee_enabled;        /* set to true if HF enables CME ERROR reporting */
216  bool inband_enabled;      /* set to true if inband ring enabled */
217  bool svc_conn;            /* set to true when service level connection up */
218  uint8_t state;            /* state machine state */
219  uint8_t conn_service;     /* connected service */
220  uint8_t peer_scn;         /* peer scn */
221  uint8_t app_id;           /* application id */
222  uint8_t role;             /* initiator/acceptor role */
223  uint8_t post_sco;         /* action to perform after sco event */
224  uint8_t call_ind;         /* CIEV call indicator value */
225  uint8_t callsetup_ind;    /* CIEV callsetup indicator value */
226  uint8_t service_ind;      /* CIEV service indicator value */
227  uint8_t signal_ind;       /* CIEV signal indicator value */
228  uint8_t roam_ind;         /* CIEV roam indicator value */
229  uint8_t battchg_ind;      /* CIEV battery charge indicator value */
230  uint8_t callheld_ind;     /* CIEV call held indicator value */
231  uint32_t bia_masked_out;  /* indicators HF does not want us to send */
232  alarm_t* collision_timer;
233  alarm_t* ring_timer;
234  alarm_t* codec_negotiation_timer;
235  bool received_at_bac; /* indicate AT+BAC is received at least once */
236  tBTA_AG_PEER_CODEC peer_codecs; /* codecs for eSCO supported by the peer */
237  tBTA_AG_PEER_CODEC sco_codec;   /* codec to be used for eSCO connection */
238  tBTA_AG_PEER_CODEC
239      inuse_codec;     /* codec being used for the current SCO connection */
240  bool codec_updated;  /* set to true whenever the app updates codec type */
241  bool codec_fallback; /* If sco nego fails for mSBC, fallback to CVSD */
242  tBTA_AG_SCO_MSBC_SETTINGS
243      codec_msbc_settings; /* settings to be used for the impending eSCO */
244
245  tBTA_AG_HF_IND
246      peer_hf_indicators[BTA_AG_MAX_NUM_PEER_HF_IND]; /* Peer supported
247                                                  HF indicators */
248  tBTA_AG_HF_IND
249      local_hf_indicators[BTA_AG_MAX_NUM_LOCAL_HF_IND]; /* Local supported
250                                                    HF indicators */
251};
252
253/* type for sco data */
254typedef struct {
255  tBTM_ESCO_CONN_REQ_EVT_DATA conn_data; /* SCO data for pending conn request */
256  tBTA_AG_SCB* p_curr_scb;  /* SCB associated with SCO connection */
257  tBTA_AG_SCB* p_xfer_scb;  /* SCB associated with SCO transfer */
258  uint16_t cur_idx;         /* SCO handle */
259  uint8_t state;            /* SCO state variable */
260  bool is_local;            /* SCO connection initiated locally or remotely */
261} tBTA_AG_SCO_CB;
262
263/* type for AG control block */
264typedef struct {
265  tBTA_AG_SCB scb[BTA_AG_MAX_NUM_CLIENTS]; /* service control blocks */
266  tBTA_AG_PROFILE profile[BTA_AG_NUM_IDX]; /* profile-specific data */
267  tBTA_AG_SCO_CB sco;                      /* SCO data */
268  tBTA_AG_CBACK* p_cback;                  /* application callback */
269} tBTA_AG_CB;
270
271/*****************************************************************************
272 *  Global data
273 ****************************************************************************/
274
275/* constant lookup tables */
276extern const uint16_t bta_ag_uuid[BTA_AG_NUM_IDX];
277extern const uint8_t bta_ag_sec_id[BTA_AG_NUM_IDX];
278extern const tBTA_AG_AT_CMD* bta_ag_at_tbl[BTA_AG_NUM_IDX];
279
280/* control block declaration */
281extern tBTA_AG_CB bta_ag_cb;
282
283/* config struct */
284extern const tBTA_AG_CFG* p_bta_ag_cfg;
285extern const tBTA_AG_HF_IND bta_ag_local_hf_ind_cfg[];
286
287/*****************************************************************************
288 *  Function prototypes
289 ****************************************************************************/
290bool bta_ag_hdl_event(BT_HDR* p_msg);
291
292/* API functions */
293extern void bta_ag_api_enable(tBTA_AG_CBACK* p_cback);
294extern void bta_ag_api_disable();
295extern void bta_ag_api_set_active_device(const RawAddress& new_active_device);
296extern void bta_ag_api_register(tBTA_SERVICE_MASK services, tBTA_SEC sec_mask,
297                                tBTA_AG_FEAT features,
298                                const std::vector<std::string>& service_names,
299                                uint8_t app_id);
300extern void bta_ag_api_result(uint16_t handle, tBTA_AG_RES result,
301                              const tBTA_AG_RES_DATA& result_data);
302
303/* main functions */
304extern void bta_ag_scb_dealloc(tBTA_AG_SCB* p_scb);
305extern uint16_t bta_ag_scb_to_idx(tBTA_AG_SCB* p_scb);
306extern tBTA_AG_SCB* bta_ag_scb_by_idx(uint16_t idx);
307extern uint8_t bta_ag_service_to_idx(tBTA_SERVICE_MASK services);
308extern uint16_t bta_ag_idx_by_bdaddr(const RawAddress* peer_addr);
309extern bool bta_ag_other_scb_open(tBTA_AG_SCB* p_curr_scb);
310extern bool bta_ag_scb_open(tBTA_AG_SCB* p_curr_scb);
311extern void bta_ag_sm_execute(tBTA_AG_SCB* p_scb, uint16_t event,
312                              const tBTA_AG_DATA& data);
313extern void bta_ag_sm_execute_by_handle(uint16_t handle, uint16_t event,
314                                        const tBTA_AG_DATA& data);
315extern void bta_ag_collision_cback(tBTA_SYS_CONN_STATUS status, uint8_t id,
316                                   uint8_t app_id, const RawAddress& peer_addr);
317extern void bta_ag_resume_open(tBTA_AG_SCB* p_scb);
318
319/* SDP functions */
320extern bool bta_ag_add_record(uint16_t service_uuid, const char* p_service_name,
321                              uint8_t scn, tBTA_AG_FEAT features,
322                              uint32_t sdp_handle);
323extern void bta_ag_create_records(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
324extern void bta_ag_del_records(tBTA_AG_SCB* p_scb);
325extern bool bta_ag_sdp_find_attr(tBTA_AG_SCB* p_scb, tBTA_SERVICE_MASK service);
326extern void bta_ag_do_disc(tBTA_AG_SCB* p_scb, tBTA_SERVICE_MASK service);
327extern void bta_ag_free_db(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
328
329/* RFCOMM functions */
330extern void bta_ag_start_servers(tBTA_AG_SCB* p_scb,
331                                 tBTA_SERVICE_MASK services);
332extern void bta_ag_close_servers(tBTA_AG_SCB* p_scb,
333                                 tBTA_SERVICE_MASK services);
334extern bool bta_ag_is_server_closed(tBTA_AG_SCB* p_scb);
335extern void bta_ag_rfc_do_close(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
336extern void bta_ag_rfc_do_open(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
337
338/* SCO functions */
339extern bool bta_ag_sco_is_active_device(const RawAddress& bd_addr);
340extern bool bta_ag_sco_is_open(tBTA_AG_SCB* p_scb);
341extern bool bta_ag_sco_is_opening(tBTA_AG_SCB* p_scb);
342extern void bta_ag_sco_conn_rsp(tBTA_AG_SCB* p_scb,
343                                tBTM_ESCO_CONN_REQ_EVT_DATA* data);
344
345/* AT command functions */
346extern void bta_ag_at_hsp_cback(tBTA_AG_SCB* p_scb, uint16_t cmd,
347                                uint8_t arg_type, char* p_arg, int16_t int_arg);
348extern void bta_ag_at_hfp_cback(tBTA_AG_SCB* p_scb, uint16_t cmd,
349                                uint8_t arg_type, char* p_arg, int16_t int_arg);
350extern void bta_ag_at_err_cback(tBTA_AG_SCB* p_scb, bool unknown,
351                                const char* p_arg);
352extern bool bta_ag_inband_enabled(tBTA_AG_SCB* p_scb);
353extern void bta_ag_send_call_inds(tBTA_AG_SCB* p_scb, tBTA_AG_RES result);
354
355/* Action functions */
356extern void bta_ag_register(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
357extern void bta_ag_deregister(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
358extern void bta_ag_start_dereg(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
359extern void bta_ag_start_close(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
360extern void bta_ag_start_open(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
361extern void bta_ag_disc_int_res(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
362extern void bta_ag_disc_acp_res(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
363extern void bta_ag_disc_fail(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
364extern void bta_ag_open_fail(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
365extern void bta_ag_rfc_fail(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
366extern void bta_ag_rfc_close(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
367extern void bta_ag_rfc_open(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
368extern void bta_ag_rfc_acp_open(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
369extern void bta_ag_rfc_data(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
370extern void bta_ag_sco_listen(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
371extern void bta_ag_sco_open(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
372extern void bta_ag_sco_close(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
373extern void bta_ag_sco_shutdown(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
374extern void bta_ag_sco_conn_open(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
375extern void bta_ag_sco_conn_close(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
376extern void bta_ag_post_sco_open(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
377extern void bta_ag_post_sco_close(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
378extern void bta_ag_svc_conn_open(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
379extern void bta_ag_result(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
380extern void bta_ag_setcodec(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
381extern void bta_ag_send_ring(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
382extern void bta_ag_handle_collision(tBTA_AG_SCB* p_scb,
383                                    const tBTA_AG_DATA& data);
384
385/* Internal utility functions */
386extern void bta_ag_sco_codec_nego(tBTA_AG_SCB* p_scb, bool result);
387extern void bta_ag_codec_negotiate(tBTA_AG_SCB* p_scb);
388extern void bta_ag_send_bcs(tBTA_AG_SCB* p_scb);
389extern void bta_ag_set_sco_allowed(bool value);
390extern const RawAddress& bta_ag_get_active_device();
391extern void bta_clear_active_device();
392
393#endif /* BTA_AG_INT_H */
394