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 <bluetooth/log.h>
28 
29 #include <cstdint>
30 #include <string>
31 
32 #include "bta/ag/bta_ag_at.h"
33 #include "bta/include/bta_ag_api.h"
34 #include "bta/include/bta_api.h"
35 #include "bta/sys/bta_sys.h"
36 #include "internal_include/bt_target.h"
37 #include "os/logging/log_adapter.h"
38 #include "stack/include/bt_hdr.h"
39 #include "stack/include/btm_api_types.h"
40 #include "stack/include/sdp_status.h"
41 #include "stack/sdp/sdp_discovery_db.h"
42 #include "types/raw_address.h"
43 
44 /*****************************************************************************
45  *  Constants
46  ****************************************************************************/
47 /* Time to wait for retry in case of collision */
48 #ifndef BTA_AG_COLLISION_TIMEOUT_MS
49 #define BTA_AG_COLLISION_TIMEOUT_MS (2 * 1000) /* 2 seconds */
50 #endif
51 
52 /* RFCOMM MTU SIZE */
53 #define BTA_AG_MTU 256
54 
55 /* Max number of peer and local HF indicators */
56 #define BTA_AG_MAX_NUM_PEER_HF_IND 20
57 #define BTA_AG_MAX_NUM_LOCAL_HF_IND 4
58 
59 /* Internal profile indexes */
60 #define BTA_AG_HSP 0     /* index for HSP */
61 #define BTA_AG_HFP 1     /* index for HFP */
62 #define BTA_AG_NUM_IDX 2 /* number of profile indexes */
63 
64 /* profile role for connection */
65 #define BTA_AG_ACP 0 /* accepted connection */
66 #define BTA_AG_INT 1 /* initiating connection */
67 
68 #define BTA_AG_SDP_FEAT_SPEC \
69   (BTA_AG_FEAT_3WAY | BTA_AG_FEAT_ECNR | BTA_AG_FEAT_VREC | BTA_AG_FEAT_INBAND | BTA_AG_FEAT_VTAG)
70 
71 /* Timeout for alarm in 2018 toyota camry carkit workaround */
72 #define BTA_AG_BIND_TIMEOUT_MS 500
73 
74 enum {
75   /* these events are handled by the state machine */
76   BTA_AG_API_REGISTER_EVT = BTA_SYS_EVT_START(BTA_ID_AG),
77   BTA_AG_API_DEREGISTER_EVT,
78   BTA_AG_API_OPEN_EVT,
79   BTA_AG_API_CLOSE_EVT,
80   BTA_AG_API_AUDIO_OPEN_EVT,
81   BTA_AG_API_AUDIO_CLOSE_EVT,
82   BTA_AG_API_RESULT_EVT,
83   BTA_AG_API_SETCODEC_EVT,
84   BTA_AG_RFC_OPEN_EVT,
85   BTA_AG_RFC_CLOSE_EVT,
86   BTA_AG_RFC_SRV_CLOSE_EVT,
87   BTA_AG_RFC_DATA_EVT,
88   BTA_AG_SCO_OPEN_EVT,
89   BTA_AG_SCO_CLOSE_EVT,
90   BTA_AG_DISC_ACP_RES_EVT,
91   BTA_AG_DISC_INT_RES_EVT,
92   BTA_AG_DISC_OK_EVT,
93   BTA_AG_DISC_FAIL_EVT,
94   BTA_AG_RING_TIMEOUT_EVT,
95   BTA_AG_SVC_TIMEOUT_EVT,
96   BTA_AG_COLLISION_EVT,
97   BTA_AG_MAX_EVT,
98 };
99 
100 /* Local events which will not trigger a higher layer callback */
101 enum {
102   BTA_AG_LOCAL_EVT_FIRST = 0x100,
103   BTA_AG_LOCAL_EVT_CCWA,
104   BTA_AG_LOCAL_EVT_CLIP,
105   BTA_AG_LOCAL_EVT_CMER,
106   BTA_AG_LOCAL_EVT_BRSF,
107   BTA_AG_LOCAL_EVT_CMEE,
108   BTA_AG_LOCAL_EVT_BCC,
109 };
110 
111 /* Actions to perform after a SCO event */
112 enum {
113   BTA_AG_POST_SCO_NONE,           /* no action */
114   BTA_AG_POST_SCO_CLOSE_RFC,      /* close RFCOMM channel after SCO closes */
115   BTA_AG_POST_SCO_RING,           /* send RING result code after SCO opens */
116   BTA_AG_POST_SCO_CALL_CONN,      /* send call indicators after SCO opens/closes */
117   BTA_AG_POST_SCO_CALL_ORIG,      /* send call indicators after SCO closes */
118   BTA_AG_POST_SCO_CALL_END,       /* send call indicators after SCO closes */
119   BTA_AG_POST_SCO_CALL_END_INCALL /* send call indicators for end call &
120                                      incoming call after SCO closes */
121 };
122 
123 /* sco states */
124 typedef enum : uint8_t {
125   BTA_AG_SCO_SHUTDOWN_ST,   /* no sco listening, all sco connections closed */
126   BTA_AG_SCO_LISTEN_ST,     /* sco listening */
127   BTA_AG_SCO_CODEC_ST,      /* sco codec negotiation */
128   BTA_AG_SCO_OPENING_ST,    /* sco connection opening */
129   BTA_AG_SCO_OPEN_CL_ST,    /* opening sco connection being closed */
130   BTA_AG_SCO_OPEN_XFER_ST,  /* opening sco connection being transferred */
131   BTA_AG_SCO_OPEN_ST,       /* sco open */
132   BTA_AG_SCO_CLOSING_ST,    /* sco closing */
133   BTA_AG_SCO_CLOSE_OP_ST,   /* closing sco being opened */
134   BTA_AG_SCO_CLOSE_XFER_ST, /* closing sco being transferred */
135   BTA_AG_SCO_SHUTTING_ST    /* sco shutting down */
136 } tBTA_AG_SCO;
137 
138 /*****************************************************************************
139  *  Data types
140  ****************************************************************************/
141 
142 /* data type for BTA_AG_API_REGISTER_EVT */
143 typedef struct {
144   char p_name[2][BTA_SERVICE_NAME_LEN + 1];
145   tBTA_SERVICE_MASK services;
146   tBTA_AG_FEAT features;
147   uint8_t app_id;
148 } tBTA_AG_API_REGISTER;
149 
150 /* data type for BTA_AG_API_OPEN_EVT */
151 typedef struct {
152   RawAddress bd_addr;
153 } tBTA_AG_API_OPEN;
154 
155 /* data type for BTA_AG_API_AUDIO_OPEN_EVT */
156 typedef struct {
157   tBTA_AG_PEER_CODEC disabled_codecs;
158 } tBTA_AG_API_AUDIO_OPEN;
159 
160 /* data type for BTA_AG_API_RESULT_EVT */
161 typedef struct {
162   tBTA_AG_RES result;
163   tBTA_AG_RES_DATA data;
ToString__anon71f1767f1b08164   std::string ToString() const {
165     return base::StringPrintf("result:%s", bta_ag_result_text(result).c_str());
166   }
167 } tBTA_AG_API_RESULT;
168 
169 /* data type for BTA_AG_API_SETCODEC_EVT */
170 typedef struct {
171   tBTA_AG_PEER_CODEC codec;
172 } tBTA_AG_API_SETCODEC;
173 
174 /* data type for BTA_AG_DISC_RESULT_EVT */
175 typedef struct {
176   tSDP_STATUS status;
177 } tBTA_AG_DISC_RESULT;
178 
179 /* data type for RFCOMM events */
180 typedef struct {
181   uint16_t port_handle;
182 } tBTA_AG_RFC;
183 
184 /* union of all event datatypes */
185 union tBTA_AG_DATA {
186   tBTA_AG_API_REGISTER api_register;
187   tBTA_AG_API_OPEN api_open;
188   tBTA_AG_API_AUDIO_OPEN api_audio_open;
189   tBTA_AG_API_RESULT api_result;
190   tBTA_AG_API_SETCODEC api_setcodec;
191   tBTA_AG_DISC_RESULT disc_result;
192   tBTA_AG_RFC rfc;
193   static const tBTA_AG_DATA kEmpty;
194 
195   /**
196    * Check if two tBTA_AG_DATA are equal in memory
197    *
198    * @param rhs other tBTA_AG_DATA
199    * @return true if both unions are equal in memory
200    */
201   bool operator==(const tBTA_AG_DATA& rhs) const {
202     return std::memcmp(this, &rhs, sizeof(tBTA_AG_DATA)) == 0;
203   }
204 
205   /**
206    * Check if this union is empty by comparing it to the kEmpty constant
207    *
208    * @return true if this union is empty
209    */
IsEmpty()210   bool IsEmpty() const { return *this == kEmpty; }
211 };
212 
213 /* type for each profile */
214 typedef struct {
215   uint32_t sdp_handle;
216   uint8_t scn;
217 } tBTA_AG_PROFILE;
218 
219 typedef enum {
220   BTA_AG_SCO_CVSD_SETTINGS_S4 = 0, /* preferred/default when codec is CVSD */
221   BTA_AG_SCO_CVSD_SETTINGS_S3,
222   BTA_AG_SCO_CVSD_SETTINGS_S1,
223 } tBTA_AG_SCO_CVSD_SETTINGS;
224 
225 typedef enum {
226   BTA_AG_SCO_MSBC_SETTINGS_T2 = 0, /* preferred/default when codec is mSBC */
227   BTA_AG_SCO_MSBC_SETTINGS_T1,
228 } tBTA_AG_SCO_MSBC_SETTINGS;
229 
230 typedef enum {
231   BTA_AG_SCO_LC3_SETTINGS_T2 = 0, /* preferred/default when codec is LC3 */
232   BTA_AG_SCO_LC3_SETTINGS_T1,
233 } tBTA_AG_SCO_LC3_SETTINGS;
234 
235 typedef enum {
236   BTA_AG_SCO_APTX_SWB_SETTINGS_Q0 = 0, /* preferred/default when codec is SWB */
237   BTA_AG_SCO_APTX_SWB_SETTINGS_Q1 = 4,
238   BTA_AG_SCO_APTX_SWB_SETTINGS_Q2 = 6,
239   BTA_AG_SCO_APTX_SWB_SETTINGS_Q3 = 7,
240   BTA_AG_SCO_APTX_SWB_SETTINGS_UNKNOWN = 0xFFFF,
241 } tBTA_AG_SCO_APTX_SWB_SETTINGS;
242 
243 /* state machine states */
244 typedef enum { BTA_AG_INIT_ST, BTA_AG_OPENING_ST, BTA_AG_OPEN_ST, BTA_AG_CLOSING_ST } tBTA_AG_STATE;
245 
246 /* type for each service control block */
247 struct tBTA_AG_SCB {
248   char clip[BTA_AG_AT_MAX_LEN + 1];     /* number string used for CLIP */
249   uint16_t serv_handle[BTA_AG_NUM_IDX]; /* RFCOMM server handles */
250   tBTA_AG_AT_CB at_cb;                  /* AT command interpreter */
251   RawAddress peer_addr;                 /* peer bd address */
252   tSDP_DISCOVERY_DB* p_disc_db;         /* pointer to discovery database */
253   tBTA_SERVICE_MASK reg_services;       /* services specified in register API */
254   tBTA_SERVICE_MASK open_services;      /* services specified in open API */
255   uint16_t conn_handle;                 /* RFCOMM handle of connected service */
256   tBTA_AG_FEAT features;                /* features registered by application */
257   tBTA_AG_FEAT masked_features;         /* local BRSF features for this connection */
258   tBTA_AG_PEER_FEAT peer_features;      /* peer device features */
259   uint16_t peer_sdp_features;           /* peer device SDP features */
260   uint16_t peer_version;                /* profile version of peer device */
261   uint16_t hsp_version;                 /* HSP profile version before SDP */
262   uint16_t sco_idx;                     /* SCO handle */
263   bool in_use;                          /* scb in use */
264   bool dealloc;                         /* true if service shutting down */
265   bool clip_enabled;                    /* set to true if HF enables CLIP reporting */
266   bool ccwa_enabled;                    /* set to true if HF enables CCWA reporting */
267   bool cmer_enabled;                    /* set to true if HF enables CMER reporting */
268   bool cmee_enabled;                    /* set to true if HF enables CME ERROR reporting */
269   bool inband_enabled;                  /* set to true if inband ring enabled */
270   bool nrec_enabled;                    /* noise reduction & echo canceling */
271   bool svc_conn;                        /* set to true when service level connection up */
272   tBTA_AG_STATE state;                  /* state machine state */
273   uint8_t conn_service;                 /* connected service */
274   uint8_t peer_scn;                     /* peer scn */
275   uint8_t app_id;                       /* application id */
276   uint8_t role;                         /* initiator/acceptor role */
277   uint8_t post_sco;                     /* action to perform after sco event */
278   uint8_t call_ind;                     /* CIEV call indicator value */
279   uint8_t callsetup_ind;                /* CIEV callsetup indicator value */
280   uint8_t service_ind;                  /* CIEV service indicator value */
281   uint8_t signal_ind;                   /* CIEV signal indicator value */
282   uint8_t roam_ind;                     /* CIEV roam indicator value */
283   uint8_t battchg_ind;                  /* CIEV battery charge indicator value */
284   uint8_t callheld_ind;                 /* CIEV call held indicator value */
285   uint32_t bia_masked_out;              /* indicators HF does not want us to send */
286   alarm_t* bind_timer;                  /* Timer for toyota camry 2018 carkit workaround */
287   alarm_t* collision_timer;
288   alarm_t* ring_timer;
289   alarm_t* codec_negotiation_timer;
290   bool received_at_bac;                  /* indicate AT+BAC is received at least once */
291   tBTA_AG_PEER_CODEC disabled_codecs;    /* set by app to block certain codecs from being used */
292   tBTA_AG_PEER_CODEC peer_codecs;        /* codecs for eSCO supported by the peer */
293   tBTA_AG_PEER_CODEC sco_codec;          /* codecs to be used for eSCO connection */
294   tBTA_AG_UUID_CODEC inuse_codec;        /* codec being used for the current SCO connection */
295   bool codec_updated;                    /* set to true whenever the app updates codec type */
296   bool codec_fallback;                   /* If sco nego fails for mSBC, fallback to CVSD */
297   bool trying_cvsd_safe_settings;        /* set to true whenever we are trying CVSD
298                                             safe settings */
299   uint8_t retransmission_effort_retries; /* Retry eSCO
300                                           with retransmission_effort value*/
301   tBTA_AG_SCO_MSBC_SETTINGS codec_msbc_settings;     /* settings to be used for the
302                                                         impending eSCO on WB */
303   tBTA_AG_SCO_LC3_SETTINGS codec_lc3_settings;       /* settings to be used for the
304                                                         impending eSCO on SWB */
305   tBTA_AG_SCO_CVSD_SETTINGS codec_cvsd_settings;     /* settings to be used for the
306                                                         impending eSCO on CVSD */
307   tBTA_AG_SCO_APTX_SWB_SETTINGS codec_aptx_settings; /* settings to be used for the
308                                                         aptX Voice SWB eSCO */
309   bool is_aptx_swb_codec;                            /* Flag to determine aptX Voice SWB codec  */
310 
311   tBTA_AG_HF_IND peer_hf_indicators[BTA_AG_MAX_NUM_PEER_HF_IND];   /* Peer supported
312                                                                HF indicators */
313   tBTA_AG_HF_IND local_hf_indicators[BTA_AG_MAX_NUM_LOCAL_HF_IND]; /* Local supported
314                                                                HF indicators */
315 
ToStringtBTA_AG_SCB316   std::string ToString() const {
317     return base::StringPrintf(
318             "codec_updated=%d, codec_fallback=%d, nrec=%d"
319             "sco_codec=%d, peer_codec=%d, msbc_settings=%d, lc3_settings=%d, "
320             "device=%s",
321             codec_updated, codec_fallback, nrec_enabled, sco_codec, peer_codecs,
322             codec_msbc_settings, codec_lc3_settings, ADDRESS_TO_LOGGABLE_CSTR(peer_addr));
323   }
324 };
325 
326 /* type for sco data */
327 typedef struct {
328   tBTM_ESCO_CONN_REQ_EVT_DATA conn_data; /* SCO data for pending conn request */
329   tBTA_AG_SCB* p_curr_scb;               /* SCB associated with SCO connection */
330   tBTA_AG_SCB* p_xfer_scb;               /* SCB associated with SCO transfer */
331   uint16_t cur_idx;                      /* SCO handle */
332   tBTA_AG_SCO state;                     /* SCO state variable */
333   bool is_local;                         /* SCO connection initiated locally or remotely */
334 } tBTA_AG_SCO_CB;
335 
336 /* type for AG control block */
337 typedef struct {
338   tBTA_AG_SCB scb[BTA_AG_MAX_NUM_CLIENTS]; /* service control blocks */
339   tBTA_AG_PROFILE profile[BTA_AG_NUM_IDX]; /* profile-specific data */
340   tBTA_AG_SCO_CB sco;                      /* SCO data */
341   tBTA_AG_CBACK* p_cback;                  /* application callback */
342 } tBTA_AG_CB;
343 
344 /*****************************************************************************
345  *  Global data
346  ****************************************************************************/
347 
348 /* constant lookup tables */
349 extern const uint16_t bta_ag_uuid[BTA_AG_NUM_IDX];
350 extern const uint8_t bta_ag_sec_id[BTA_AG_NUM_IDX];
351 extern const tBTA_AG_AT_CMD* bta_ag_at_tbl[BTA_AG_NUM_IDX];
352 
353 /* control block declaration */
354 extern tBTA_AG_CB bta_ag_cb;
355 
356 /* config struct */
357 extern const tBTA_AG_CFG* p_bta_ag_cfg;
358 extern const tBTA_AG_HF_IND bta_ag_local_hf_ind_cfg[];
359 
360 /*****************************************************************************
361  *  Function prototypes
362  ****************************************************************************/
363 bool bta_ag_hdl_event(const BT_HDR_RIGID* p_msg);
364 
365 /* API functions */
366 void bta_ag_api_enable(tBTA_AG_CBACK* p_cback);
367 void bta_ag_api_disable();
368 void bta_ag_api_set_active_device(const RawAddress& new_active_device);
369 void bta_ag_api_register(tBTA_SERVICE_MASK services, tBTA_AG_FEAT features,
370                          const std::vector<std::string>& service_names, uint8_t app_id);
371 void bta_ag_api_result(uint16_t handle, tBTA_AG_RES result, const tBTA_AG_RES_DATA& result_data);
372 
373 /* main functions */
374 void bta_ag_scb_dealloc(tBTA_AG_SCB* p_scb);
375 uint16_t bta_ag_scb_to_idx(tBTA_AG_SCB* p_scb);
376 tBTA_AG_SCB* bta_ag_scb_by_idx(uint16_t idx);
377 uint8_t bta_ag_service_to_idx(tBTA_SERVICE_MASK services);
378 uint16_t bta_ag_idx_by_bdaddr(const RawAddress* peer_addr);
379 bool bta_ag_other_scb_open(tBTA_AG_SCB* p_curr_scb);
380 bool bta_ag_scb_open(tBTA_AG_SCB* p_curr_scb);
381 void bta_ag_sm_execute(tBTA_AG_SCB* p_scb, uint16_t event, const tBTA_AG_DATA& data);
382 void bta_ag_sm_execute_by_handle(uint16_t handle, uint16_t event, const tBTA_AG_DATA& data);
383 void bta_ag_collision_cback(tBTA_SYS_CONN_STATUS status, tBTA_SYS_ID id, uint8_t app_id,
384                             const RawAddress& peer_addr);
385 void bta_ag_resume_open(tBTA_AG_SCB* p_scb);
386 const std::string bta_ag_state_str(tBTA_AG_STATE state);
387 
388 /* SDP functions */
389 bool bta_ag_add_record(uint16_t service_uuid, const char* p_service_name, uint8_t scn,
390                        tBTA_AG_FEAT features, uint32_t sdp_handle);
391 void bta_ag_create_records(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
392 void bta_ag_del_records(tBTA_AG_SCB* p_scb);
393 bool bta_ag_sdp_find_attr(tBTA_AG_SCB* p_scb, tBTA_SERVICE_MASK service);
394 void bta_ag_do_disc(tBTA_AG_SCB* p_scb, tBTA_SERVICE_MASK service);
395 void bta_ag_free_db(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
396 
397 /* RFCOMM functions */
398 void bta_ag_start_servers(tBTA_AG_SCB* p_scb, tBTA_SERVICE_MASK services);
399 void bta_ag_close_servers(tBTA_AG_SCB* p_scb, tBTA_SERVICE_MASK services);
400 bool bta_ag_is_server_closed(tBTA_AG_SCB* p_scb);
401 void bta_ag_rfc_do_close(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
402 void bta_ag_rfc_do_open(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
403 
404 /* SCO functions */
405 bool bta_ag_sco_is_active_device(const RawAddress& bd_addr);
406 bool bta_ag_sco_is_open(tBTA_AG_SCB* p_scb);
407 bool bta_ag_sco_is_opening(tBTA_AG_SCB* p_scb);
408 void bta_ag_sco_conn_rsp(tBTA_AG_SCB* p_scb, tBTM_ESCO_CONN_REQ_EVT_DATA* data);
409 // Testonly
410 void bta_ag_create_sco(tBTA_AG_SCB* p_scb, bool is_orig);
411 
412 /* AT command functions */
413 void bta_ag_at_hsp_cback(tBTA_AG_SCB* p_scb, uint16_t cmd, uint8_t arg_type, char* p_arg,
414                          char* p_end, int16_t int_arg);
415 void bta_ag_at_hfp_cback(tBTA_AG_SCB* p_scb, uint16_t cmd, uint8_t arg_type, char* p_arg,
416                          char* p_end, int16_t int_arg);
417 void bta_ag_at_err_cback(tBTA_AG_SCB* p_scb, bool unknown, const char* p_arg);
418 bool bta_ag_inband_enabled(tBTA_AG_SCB* p_scb);
419 void bta_ag_send_call_inds(tBTA_AG_SCB* p_scb, tBTA_AG_RES result);
420 
421 /* Action functions */
422 void bta_ag_register(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
423 void bta_ag_deregister(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
424 void bta_ag_start_dereg(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
425 void bta_ag_start_close(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
426 void bta_ag_start_open(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
427 void bta_ag_disc_int_res(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
428 void bta_ag_disc_acp_res(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
429 void bta_ag_disc_fail(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
430 void bta_ag_open_fail(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
431 void bta_ag_rfc_fail(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
432 void bta_ag_rfc_close(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
433 void bta_ag_rfc_open(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
434 void bta_ag_rfc_acp_open(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
435 void bta_ag_rfc_data(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
436 void bta_ag_sco_listen(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
437 void bta_ag_sco_open(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
438 void bta_ag_sco_close(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
439 void bta_ag_sco_shutdown(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
440 void bta_ag_sco_conn_open(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
441 void bta_ag_sco_conn_close(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
442 void bta_ag_post_sco_open(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
443 void bta_ag_post_sco_close(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
444 void bta_ag_svc_conn_open(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
445 void bta_ag_result(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
446 void bta_ag_setcodec(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
447 void bta_ag_send_ring(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
448 void bta_ag_handle_collision(tBTA_AG_SCB* p_scb, const tBTA_AG_DATA& data);
449 size_t bta_ag_sco_write(const uint8_t* p_buf, uint32_t len);
450 size_t bta_ag_sco_read(uint8_t* p_buf, uint32_t len);
451 
452 /* Internal utility functions */
453 void bta_ag_sco_codec_nego(tBTA_AG_SCB* p_scb, bool result);
454 void bta_ag_codec_negotiate(tBTA_AG_SCB* p_scb);
455 bool bta_ag_is_sco_open_allowed(tBTA_AG_SCB* p_scb, const std::string event);
456 void bta_ag_send_bcs(tBTA_AG_SCB* p_scb);
457 bool bta_ag_get_sco_offload_enabled();
458 void bta_ag_set_sco_offload_enabled(bool value);
459 void bta_ag_set_sco_allowed(bool value);
460 const RawAddress& bta_ag_get_active_device();
461 void bta_clear_active_device();
462 void bta_ag_send_qac(tBTA_AG_SCB* p_scb);
463 void bta_ag_send_qcs(tBTA_AG_SCB* p_scb);
464 /**
465  * Check if SCO is managed by Audio is enabled. This is set via the system property
466  * bluetooth.sco.managed_by_audio.
467  * <p>When set to false, Bluetooth will manage the start and end of the SCO.
468  * <p>When set to true, Audio will manage the start and end of the SCO through
469  * HAL.
470  *
471  * @return true if SCO managed by Audio is enabled, false otherwise
472  */
473 bool bta_ag_is_sco_managed_by_audio();
474 /**
475  * Respond to Audio HAL's SuspendStream request when SCO is disconnected
476  */
477 void bta_ag_stream_suspended();
478 
479 namespace std {
480 template <>
481 struct formatter<tBTA_AG_SCO_APTX_SWB_SETTINGS> : enum_formatter<tBTA_AG_SCO_APTX_SWB_SETTINGS> {};
482 template <>
483 struct formatter<tBTA_AG_SCO> : enum_formatter<tBTA_AG_SCO> {};
484 }  // namespace std
485 
486 #endif /* BTA_AG_INT_H */
487