| /****************************************************************************** |
| * |
| * Copyright 2003-2012 Broadcom Corporation |
| * |
| * 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. |
| * |
| ******************************************************************************/ |
| |
| /****************************************************************************** |
| * |
| * This is the implementation of the API for the audio gateway (AG) |
| * subsystem of BTA, Broadcom's Bluetooth application layer for mobile |
| * phones. |
| * |
| ******************************************************************************/ |
| |
| #include "bta/include/bta_ag_api.h" |
| |
| #include <base/functional/bind.h> |
| #include <base/location.h> |
| #include <bluetooth/log.h> |
| |
| #include <cstdint> |
| #include <cstring> |
| #include <vector> |
| |
| #include "bta/ag/bta_ag_int.h" |
| #include "stack/include/main_thread.h" |
| #include "types/raw_address.h" |
| |
| using namespace bluetooth; |
| |
| /***************************************************************************** |
| * Constants |
| ****************************************************************************/ |
| |
| static const tBTA_SYS_REG bta_ag_reg = {bta_ag_hdl_event, BTA_AgDisable}; |
| const tBTA_AG_RES_DATA tBTA_AG_RES_DATA::kEmpty = {}; |
| |
| /******************************************************************************* |
| * |
| * Function BTA_AgEnable |
| * |
| * Description Enable the audio gateway service. When the enable |
| * operation is complete the callback function will be |
| * called with a BTA_AG_ENABLE_EVT. This function must |
| * be called before other function in the AG API are |
| * called. |
| * |
| * Returns BTA_SUCCESS if OK, BTA_FAILURE otherwise. |
| * |
| ******************************************************************************/ |
| tBTA_STATUS BTA_AgEnable(tBTA_AG_CBACK* p_cback) { |
| /* Error if AG is already enabled, or AG is in the middle of disabling. */ |
| for (const tBTA_AG_SCB& scb : bta_ag_cb.scb) { |
| if (scb.in_use) { |
| log::error("BTA_AgEnable: FAILED, AG already enabled."); |
| return BTA_FAILURE; |
| } |
| } |
| bta_sys_register(BTA_ID_AG, &bta_ag_reg); |
| do_in_main_thread(FROM_HERE, base::BindOnce(&bta_ag_api_enable, p_cback)); |
| return BTA_SUCCESS; |
| } |
| |
| /******************************************************************************* |
| * |
| * Function BTA_AgDisable |
| * |
| * Description Disable the audio gateway service |
| * |
| * |
| * Returns void |
| * |
| ******************************************************************************/ |
| void BTA_AgDisable() { |
| do_in_main_thread(FROM_HERE, base::BindOnce(&bta_ag_api_disable)); |
| } |
| |
| /******************************************************************************* |
| * |
| * Function BTA_AgRegister |
| * |
| * Description Register an Audio Gateway service. |
| * |
| * |
| * Returns void |
| * |
| ******************************************************************************/ |
| void BTA_AgRegister(tBTA_SERVICE_MASK services, tBTA_AG_FEAT features, |
| const std::vector<std::string>& service_names, |
| uint8_t app_id) { |
| do_in_main_thread(FROM_HERE, base::BindOnce(&bta_ag_api_register, services, |
| features, service_names, app_id)); |
| } |
| |
| /******************************************************************************* |
| * |
| * Function BTA_AgDeregister |
| * |
| * Description Deregister an audio gateway service. |
| * |
| * |
| * Returns void |
| * |
| ******************************************************************************/ |
| void BTA_AgDeregister(uint16_t handle) { |
| do_in_main_thread(FROM_HERE, base::BindOnce(&bta_ag_sm_execute_by_handle, |
| handle, BTA_AG_API_DEREGISTER_EVT, |
| tBTA_AG_DATA::kEmpty)); |
| } |
| |
| /******************************************************************************* |
| * |
| * Function BTA_AgOpen |
| * |
| * Description Opens a connection to a headset or hands-free device. |
| * When connection is open callback function is called |
| * with a BTA_AG_OPEN_EVT. Only the data connection is |
| * opened. The audio connection is not opened. |
| * |
| * |
| * Returns void |
| * |
| ******************************************************************************/ |
| void BTA_AgOpen(uint16_t handle, const RawAddress& bd_addr) { |
| tBTA_AG_DATA data = {}; |
| data.api_open.bd_addr = bd_addr; |
| do_in_main_thread(FROM_HERE, |
| base::BindOnce(&bta_ag_sm_execute_by_handle, handle, |
| BTA_AG_API_OPEN_EVT, data)); |
| } |
| |
| /******************************************************************************* |
| * |
| * Function BTA_AgClose |
| * |
| * Description Close the current connection to a headset or a handsfree |
| * Any current audio connection will also be closed. |
| * |
| * |
| * Returns void |
| * |
| ******************************************************************************/ |
| void BTA_AgClose(uint16_t handle) { |
| do_in_main_thread(FROM_HERE, |
| base::BindOnce(&bta_ag_sm_execute_by_handle, handle, |
| BTA_AG_API_CLOSE_EVT, tBTA_AG_DATA::kEmpty)); |
| } |
| |
| /******************************************************************************* |
| * |
| * Function BTA_AgAudioOpen |
| * |
| * Description Opens an audio connection to the currently connected |
| * headset or handsfree. Specify `disabled_codecs` to |
| * force the stack to avoid using certain codecs. |
| * |
| * Note that CVSD is a mandatory codec and cannot be disabled. |
| * |
| * |
| * Returns void |
| * |
| ******************************************************************************/ |
| void BTA_AgAudioOpen(uint16_t handle, tBTA_AG_PEER_CODEC disabled_codecs) { |
| tBTA_AG_DATA data = {}; |
| data.api_audio_open.disabled_codecs = disabled_codecs; |
| do_in_main_thread(FROM_HERE, |
| base::BindOnce(&bta_ag_sm_execute_by_handle, handle, |
| BTA_AG_API_AUDIO_OPEN_EVT, data)); |
| } |
| |
| /******************************************************************************* |
| * |
| * Function BTA_AgAudioClose |
| * |
| * Description Close the currently active audio connection to a headset |
| * or handsfree. The data connection remains open |
| * |
| * |
| * Returns void |
| * |
| ******************************************************************************/ |
| void BTA_AgAudioClose(uint16_t handle) { |
| do_in_main_thread( |
| FROM_HERE, |
| base::BindOnce(&bta_ag_sm_execute_by_handle, handle, |
| BTA_AG_API_AUDIO_CLOSE_EVT, tBTA_AG_DATA::kEmpty)); |
| } |
| |
| /******************************************************************************* |
| * |
| * Function BTA_AgResult |
| * |
| * Description Send an AT result code to a headset or hands-free device. |
| * This function is only used when the AG parse mode is set |
| * to BTA_AG_PARSE. |
| * |
| * |
| * Returns void |
| * |
| ******************************************************************************/ |
| void BTA_AgResult(uint16_t handle, tBTA_AG_RES result, |
| const tBTA_AG_RES_DATA& data) { |
| do_in_main_thread(FROM_HERE, |
| base::BindOnce(&bta_ag_api_result, handle, result, data)); |
| } |
| |
| /******************************************************************************* |
| * |
| * Function BTA_AgSetCodec |
| * |
| * Description Specify the codec type to be used for the subsequent |
| * audio connection. |
| * |
| * |
| * |
| * Returns void |
| * |
| ******************************************************************************/ |
| void BTA_AgSetCodec(uint16_t handle, tBTA_AG_PEER_CODEC codec) { |
| tBTA_AG_DATA data = {}; |
| data.api_setcodec.codec = codec; |
| do_in_main_thread(FROM_HERE, |
| base::BindOnce(&bta_ag_sm_execute_by_handle, handle, |
| BTA_AG_API_SETCODEC_EVT, data)); |
| } |
| |
| void BTA_AgSetScoOffloadEnabled(bool value) { |
| do_in_main_thread(FROM_HERE, |
| base::BindOnce(&bta_ag_set_sco_offload_enabled, value)); |
| } |
| |
| void BTA_AgSetScoAllowed(bool value) { |
| do_in_main_thread(FROM_HERE, base::BindOnce(&bta_ag_set_sco_allowed, value)); |
| } |
| |
| void BTA_AgSetActiveDevice(const RawAddress& active_device_addr) { |
| if (active_device_addr.IsEmpty()) { |
| do_in_main_thread(FROM_HERE, base::BindOnce(&bta_clear_active_device)); |
| } else { |
| do_in_main_thread(FROM_HERE, base::BindOnce(&bta_ag_api_set_active_device, |
| active_device_addr)); |
| } |
| } |