blob: 45768a33f304276f62501813727d7141216ee776 [file] [log] [blame]
Shunkai Yao51202502022-12-12 06:11:46 +00001/*
2 * Copyright (C) 2022 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#pragma once
18
Mikhail Naganov5b1eed12023-01-25 11:29:11 -080019#include <map>
20#include <set>
21#include <vector>
22
Mikhail Naganove7a26ad2023-05-25 17:36:48 -070023#include <aidl/android/media/audio/IHalAdapterVendorExtension.h>
Mikhail Naganov31d46652023-01-10 18:29:25 +000024#include <aidl/android/hardware/audio/core/BpModule.h>
Mikhail Naganovdfd594e2023-02-08 16:59:41 -080025#include <android-base/thread_annotations.h>
Shunkai Yao51202502022-12-12 06:11:46 +000026#include <media/audiohal/DeviceHalInterface.h>
27#include <media/audiohal/EffectHalInterface.h>
Mikhail Naganove93a0862023-03-15 17:06:59 -070028#include <media/audiohal/StreamHalInterface.h>
Shunkai Yao51202502022-12-12 06:11:46 +000029
Mikhail Naganov31d46652023-01-10 18:29:25 +000030#include "ConversionHelperAidl.h"
Shunkai Yao51202502022-12-12 06:11:46 +000031
32namespace android {
33
Mikhail Naganovdfd594e2023-02-08 16:59:41 -080034class StreamOutHalInterfaceCallback;
35class StreamOutHalInterfaceEventCallback;
36class StreamOutHalInterfaceLatencyModeCallback;
37
38// The role of the broker is to connect AIDL callback interface implementations
39// with StreamOut callback implementations. Since AIDL requires all callbacks
40// to be provided upfront, while libaudiohal interfaces allow late registration,
41// there is a need to coordinate the matching process.
42class CallbackBroker : public virtual RefBase {
43 public:
44 virtual ~CallbackBroker() = default;
45 // The cookie is always the stream instance pointer. We don't use weak pointers to avoid extra
46 // costs on reference counting. The stream cleans up related entries on destruction. Since
47 // access to the callbacks map is synchronized, the possibility for pointer aliasing due to
48 // allocation of a new stream at the address of previously deleted stream is avoided.
49 virtual void clearCallbacks(void* cookie) = 0;
50 virtual sp<StreamOutHalInterfaceCallback> getStreamOutCallback(void* cookie) = 0;
51 virtual void setStreamOutCallback(void* cookie, const sp<StreamOutHalInterfaceCallback>&) = 0;
52 virtual sp<StreamOutHalInterfaceEventCallback> getStreamOutEventCallback(void* cookie) = 0;
53 virtual void setStreamOutEventCallback(void* cookie,
54 const sp<StreamOutHalInterfaceEventCallback>&) = 0;
55 virtual sp<StreamOutHalInterfaceLatencyModeCallback> getStreamOutLatencyModeCallback(
56 void* cookie) = 0;
57 virtual void setStreamOutLatencyModeCallback(
58 void* cookie, const sp<StreamOutHalInterfaceLatencyModeCallback>&) = 0;
59};
60
Mikhail Naganovcad0afe2023-03-10 14:25:57 -080061class MicrophoneInfoProvider : public virtual RefBase {
62 public:
63 using Info = std::vector<::aidl::android::media::audio::common::MicrophoneInfo>;
64 virtual ~MicrophoneInfoProvider() = default;
65 // Returns a nullptr if the HAL does not support microphone info retrieval.
66 virtual Info const* getMicrophoneInfo() = 0;
67};
68
Mikhail Naganovdfd594e2023-02-08 16:59:41 -080069class DeviceHalAidl : public DeviceHalInterface, public ConversionHelperAidl,
Mikhail Naganovcad0afe2023-03-10 14:25:57 -080070 public CallbackBroker, public MicrophoneInfoProvider {
Shunkai Yao51202502022-12-12 06:11:46 +000071 public:
Mikhail Naganovf83b9742023-04-24 13:06:04 -070072 status_t getAudioPorts(std::vector<media::audio::common::AudioPort> *ports) override;
73
74 status_t getAudioRoutes(std::vector<media::AudioRoute> *routes) override;
75
Mikhail Naganov1fba38c2023-05-03 17:45:36 -070076 status_t getSupportedModes(std::vector<media::audio::common::AudioMode> *modes) override;
77
Shunkai Yao51202502022-12-12 06:11:46 +000078 // Sets the value of 'devices' to a bitmask of 1 or more values of audio_devices_t.
79 status_t getSupportedDevices(uint32_t *devices) override;
80
81 // Check to see if the audio hardware interface has been initialized.
82 status_t initCheck() override;
83
84 // Set the audio volume of a voice call. Range is between 0.0 and 1.0.
85 status_t setVoiceVolume(float volume) override;
86
87 // Set the audio volume for all audio activities other than voice call.
88 status_t setMasterVolume(float volume) override;
89
90 // Get the current master volume value for the HAL.
91 status_t getMasterVolume(float *volume) override;
92
93 // Called when the audio mode changes.
94 status_t setMode(audio_mode_t mode) override;
95
96 // Muting control.
97 status_t setMicMute(bool state) override;
98
99 status_t getMicMute(bool* state) override;
100
101 status_t setMasterMute(bool state) override;
102
103 status_t getMasterMute(bool *state) override;
104
105 // Set global audio parameters.
106 status_t setParameters(const String8& kvPairs) override;
107
108 // Get global audio parameters.
109 status_t getParameters(const String8& keys, String8 *values) override;
110
111 // Returns audio input buffer size according to parameters passed.
112 status_t getInputBufferSize(const struct audio_config* config, size_t* size) override;
113
114 // Creates and opens the audio hardware output stream. The stream is closed
115 // by releasing all references to the returned object.
116 status_t openOutputStream(audio_io_handle_t handle, audio_devices_t devices,
117 audio_output_flags_t flags, struct audio_config* config,
118 const char* address, sp<StreamOutHalInterface>* outStream) override;
119
120 // Creates and opens the audio hardware input stream. The stream is closed
121 // by releasing all references to the returned object.
122 status_t openInputStream(audio_io_handle_t handle, audio_devices_t devices,
123 struct audio_config* config, audio_input_flags_t flags,
124 const char* address, audio_source_t source,
125 audio_devices_t outputDevice, const char* outputDeviceAddress,
126 sp<StreamInHalInterface>* inStream) override;
127
128 // Returns whether createAudioPatch and releaseAudioPatch operations are supported.
129 status_t supportsAudioPatches(bool* supportsPatches) override;
130
131 // Creates an audio patch between several source and sink ports.
132 status_t createAudioPatch(unsigned int num_sources, const struct audio_port_config* sources,
133 unsigned int num_sinks, const struct audio_port_config* sinks,
134 audio_patch_handle_t* patch) override;
135
136 // Releases an audio patch.
137 status_t releaseAudioPatch(audio_patch_handle_t patch) override;
138
Mikhail Naganov31d46652023-01-10 18:29:25 +0000139 // Fills the list of supported attributes for a given audio port.
140 status_t getAudioPort(struct audio_port* port) override;
141
142 // Fills the list of supported attributes for a given audio port.
143 status_t getAudioPort(struct audio_port_v7 *port) override;
144
Shunkai Yao51202502022-12-12 06:11:46 +0000145 // Set audio port configuration.
146 status_t setAudioPortConfig(const struct audio_port_config* config) override;
147
148 // List microphones
Mikhail Naganove93a0862023-03-15 17:06:59 -0700149 status_t getMicrophones(std::vector<audio_microphone_characteristic_t>* microphones) override;
Shunkai Yao51202502022-12-12 06:11:46 +0000150
151 status_t addDeviceEffect(audio_port_handle_t device, sp<EffectHalInterface> effect) override;
152
153 status_t removeDeviceEffect(audio_port_handle_t device, sp<EffectHalInterface> effect) override;
154
155 status_t getMmapPolicyInfos(media::audio::common::AudioMMapPolicyType policyType __unused,
156 std::vector<media::audio::common::AudioMMapPolicyInfo>* policyInfos
157 __unused) override;
158
159 int32_t getAAudioMixerBurstCount() override;
160
161 int32_t getAAudioHardwareBurstMinUsec() override;
162
163 error::Result<audio_hw_sync_t> getHwAvSync() override;
164
Shunkai Yao51202502022-12-12 06:11:46 +0000165 int32_t supportsBluetoothVariableLatency(bool* supports __unused) override;
166
jiabin872de702023-04-27 22:04:31 +0000167 status_t prepareToDisconnectExternalDevice(const struct audio_port_v7 *port) override;
168
Mikhail Naganove93a0862023-03-15 17:06:59 -0700169 status_t setConnectedState(const struct audio_port_v7 *port, bool connected) override;
170
171 status_t setSimulateDeviceConnections(bool enabled) override;
172
173 status_t dump(int __unused, const Vector<String16>& __unused) override;
174
Shunkai Yao51202502022-12-12 06:11:46 +0000175 private:
Mikhail Naganov31d46652023-01-10 18:29:25 +0000176 friend class sp<DeviceHalAidl>;
Mikhail Naganovdfd594e2023-02-08 16:59:41 -0800177
178 struct Callbacks { // No need to use `atomic_wp` because access is serialized.
179 wp<StreamOutHalInterfaceCallback> out;
180 wp<StreamOutHalInterfaceEventCallback> event;
181 wp<StreamOutHalInterfaceLatencyModeCallback> latency;
182 };
Mikhail Naganovcad0afe2023-03-10 14:25:57 -0800183 struct Microphones {
184 enum Status { UNKNOWN, NOT_SUPPORTED, QUERIED };
185 Status status = Status::UNKNOWN;
186 MicrophoneInfoProvider::Info info;
187 };
Mikhail Naganov5b1eed12023-01-25 11:29:11 -0800188 using Patches = std::map<int32_t /*patch ID*/,
189 ::aidl::android::hardware::audio::core::AudioPatch>;
190 using PortConfigs = std::map<int32_t /*port config ID*/,
191 ::aidl::android::media::audio::common::AudioPortConfig>;
192 using Ports = std::map<int32_t /*port ID*/, ::aidl::android::media::audio::common::AudioPort>;
Mikhail Naganovf83b9742023-04-24 13:06:04 -0700193 using Routes = std::vector<::aidl::android::hardware::audio::core::AudioRoute>;
Mikhail Naganov289468a2023-03-29 10:06:15 -0700194 // Answers the question "whether portID 'first' is reachable from portID 'second'?"
195 // It's not a map because both portIDs are known. The matrix is symmetric.
196 using RoutingMatrix = std::set<std::pair<int32_t, int32_t>>;
Mikhail Naganove93a0862023-03-15 17:06:59 -0700197 using Streams = std::map<wp<StreamHalInterface>, int32_t /*patch ID*/>;
Mikhail Naganov5b1eed12023-01-25 11:29:11 -0800198 class Cleanups;
Mikhail Naganov31d46652023-01-10 18:29:25 +0000199
Mikhail Naganov5b1eed12023-01-25 11:29:11 -0800200 // Must not be constructed directly by clients.
201 DeviceHalAidl(
202 const std::string& instance,
Mikhail Naganove7a26ad2023-05-25 17:36:48 -0700203 const std::shared_ptr<::aidl::android::hardware::audio::core::IModule>& module,
204 const std::shared_ptr<::aidl::android::media::audio::IHalAdapterVendorExtension>& vext);
Shunkai Yao51202502022-12-12 06:11:46 +0000205
Mikhail Naganov31d46652023-01-10 18:29:25 +0000206 ~DeviceHalAidl() override = default;
Mikhail Naganov5b1eed12023-01-25 11:29:11 -0800207
Mikhail Naganov89a9f742023-01-30 12:33:18 -0800208 bool audioDeviceMatches(const ::aidl::android::media::audio::common::AudioDevice& device,
209 const ::aidl::android::media::audio::common::AudioPort& p);
210 bool audioDeviceMatches(const ::aidl::android::media::audio::common::AudioDevice& device,
211 const ::aidl::android::media::audio::common::AudioPortConfig& p);
David Lia8675d42023-03-30 21:08:06 +0800212 status_t createOrUpdatePortConfig(
Mikhail Naganov5b1eed12023-01-25 11:29:11 -0800213 const ::aidl::android::media::audio::common::AudioPortConfig& requestedPortConfig,
David Lia8675d42023-03-30 21:08:06 +0800214 PortConfigs::iterator* result, bool *created);
Mikhail Naganove7a26ad2023-05-25 17:36:48 -0700215 status_t filterAndRetrieveBtA2dpParameters(AudioParameter &keys, AudioParameter *result);
Mikhail Naganovccc82112023-04-27 18:14:15 -0700216 status_t filterAndUpdateBtA2dpParameters(AudioParameter &parameters);
217 status_t filterAndUpdateBtHfpParameters(AudioParameter &parameters);
218 status_t filterAndUpdateBtLeParameters(AudioParameter &parameters);
219 status_t filterAndUpdateBtScoParameters(AudioParameter &parameters);
Mikhail Naganove92c34b2023-05-31 14:24:48 -0700220 status_t filterAndUpdateScreenParameters(AudioParameter &parameters);
Mikhail Naganov5b1eed12023-01-25 11:29:11 -0800221 status_t findOrCreatePatch(
222 const std::set<int32_t>& sourcePortConfigIds,
223 const std::set<int32_t>& sinkPortConfigIds,
224 ::aidl::android::hardware::audio::core::AudioPatch* patch, bool* created);
225 status_t findOrCreatePatch(
226 const ::aidl::android::hardware::audio::core::AudioPatch& requestedPatch,
227 ::aidl::android::hardware::audio::core::AudioPatch* patch, bool* created);
228 status_t findOrCreatePortConfig(
229 const ::aidl::android::media::audio::common::AudioDevice& device,
jiabin9c07faf2023-04-26 22:00:44 +0000230 const ::aidl::android::media::audio::common::AudioConfig* config,
Mikhail Naganov5b1eed12023-01-25 11:29:11 -0800231 ::aidl::android::media::audio::common::AudioPortConfig* portConfig,
232 bool* created);
233 status_t findOrCreatePortConfig(
234 const ::aidl::android::media::audio::common::AudioConfig& config,
Mikhail Naganov89a9f742023-01-30 12:33:18 -0800235 const std::optional<::aidl::android::media::audio::common::AudioIoFlags>& flags,
Mikhail Naganov5b1eed12023-01-25 11:29:11 -0800236 int32_t ioHandle,
Mikhail Naganovd8d01f72023-03-09 16:24:40 -0800237 ::aidl::android::media::audio::common::AudioSource aidlSource,
Mikhail Naganov289468a2023-03-29 10:06:15 -0700238 const std::set<int32_t>& destinationPortIds,
Mikhail Naganov5b1eed12023-01-25 11:29:11 -0800239 ::aidl::android::media::audio::common::AudioPortConfig* portConfig, bool* created);
240 status_t findOrCreatePortConfig(
241 const ::aidl::android::media::audio::common::AudioPortConfig& requestedPortConfig,
Mikhail Naganov289468a2023-03-29 10:06:15 -0700242 const std::set<int32_t>& destinationPortIds,
Mikhail Naganov5b1eed12023-01-25 11:29:11 -0800243 ::aidl::android::media::audio::common::AudioPortConfig* portConfig, bool* created);
244 Patches::iterator findPatch(const std::set<int32_t>& sourcePortConfigIds,
245 const std::set<int32_t>& sinkPortConfigIds);
246 Ports::iterator findPort(const ::aidl::android::media::audio::common::AudioDevice& device);
247 Ports::iterator findPort(
248 const ::aidl::android::media::audio::common::AudioConfig& config,
Mikhail Naganov289468a2023-03-29 10:06:15 -0700249 const ::aidl::android::media::audio::common::AudioIoFlags& flags,
250 const std::set<int32_t>& destinationPortIds);
Mikhail Naganov5b1eed12023-01-25 11:29:11 -0800251 PortConfigs::iterator findPortConfig(
252 const ::aidl::android::media::audio::common::AudioDevice& device);
253 PortConfigs::iterator findPortConfig(
254 const ::aidl::android::media::audio::common::AudioConfig& config,
Mikhail Naganov89a9f742023-01-30 12:33:18 -0800255 const std::optional<::aidl::android::media::audio::common::AudioIoFlags>& flags,
Mikhail Naganov5b1eed12023-01-25 11:29:11 -0800256 int32_t ioHandle);
Mikhail Naganov5b1eed12023-01-25 11:29:11 -0800257 status_t prepareToOpenStream(
258 int32_t aidlHandle,
259 const ::aidl::android::media::audio::common::AudioDevice& aidlDevice,
260 const ::aidl::android::media::audio::common::AudioIoFlags& aidlFlags,
Mikhail Naganovd8d01f72023-03-09 16:24:40 -0800261 ::aidl::android::media::audio::common::AudioSource aidlSource,
Mikhail Naganov5b1eed12023-01-25 11:29:11 -0800262 struct audio_config* config,
263 Cleanups* cleanups,
264 ::aidl::android::media::audio::common::AudioConfig* aidlConfig,
Mikhail Naganov89a9f742023-01-30 12:33:18 -0800265 ::aidl::android::media::audio::common::AudioPortConfig* mixPortConfig,
Mikhail Naganove93a0862023-03-15 17:06:59 -0700266 ::aidl::android::hardware::audio::core::AudioPatch* aidlPatch);
Mikhail Naganov5b1eed12023-01-25 11:29:11 -0800267 void resetPatch(int32_t patchId);
268 void resetPortConfig(int32_t portConfigId);
Mikhail Naganove93a0862023-03-15 17:06:59 -0700269 void resetUnusedPatches();
270 void resetUnusedPatchesAndPortConfigs();
271 void resetUnusedPortConfigs();
Mikhail Naganov289468a2023-03-29 10:06:15 -0700272 status_t updateRoutes();
Mikhail Naganov5b1eed12023-01-25 11:29:11 -0800273
Mikhail Naganovdfd594e2023-02-08 16:59:41 -0800274 // CallbackBroker implementation
275 void clearCallbacks(void* cookie) override;
276 sp<StreamOutHalInterfaceCallback> getStreamOutCallback(void* cookie) override;
277 void setStreamOutCallback(void* cookie, const sp<StreamOutHalInterfaceCallback>& cb) override;
278 sp<StreamOutHalInterfaceEventCallback> getStreamOutEventCallback(void* cookie) override;
279 void setStreamOutEventCallback(void* cookie,
280 const sp<StreamOutHalInterfaceEventCallback>& cb) override;
281 sp<StreamOutHalInterfaceLatencyModeCallback> getStreamOutLatencyModeCallback(
282 void* cookie) override;
283 void setStreamOutLatencyModeCallback(
284 void* cookie, const sp<StreamOutHalInterfaceLatencyModeCallback>& cb) override;
285 // Implementation helpers.
286 template<class C> sp<C> getCallbackImpl(void* cookie, wp<C> Callbacks::* field);
287 template<class C> void setCallbackImpl(void* cookie, wp<C> Callbacks::* field, const sp<C>& cb);
288
Mikhail Naganovcad0afe2023-03-10 14:25:57 -0800289 // MicrophoneInfoProvider implementation
290 MicrophoneInfoProvider::Info const* getMicrophoneInfo() override;
291
Mikhail Naganov5b1eed12023-01-25 11:29:11 -0800292 const std::string mInstance;
293 const std::shared_ptr<::aidl::android::hardware::audio::core::IModule> mModule;
Mikhail Naganove7a26ad2023-05-25 17:36:48 -0700294 const std::shared_ptr<::aidl::android::media::audio::IHalAdapterVendorExtension> mVendorExt;
Mikhail Naganov1fba38c2023-05-03 17:45:36 -0700295 const std::shared_ptr<::aidl::android::hardware::audio::core::ITelephony> mTelephony;
Mikhail Naganovccc82112023-04-27 18:14:15 -0700296 const std::shared_ptr<::aidl::android::hardware::audio::core::IBluetooth> mBluetooth;
297 const std::shared_ptr<::aidl::android::hardware::audio::core::IBluetoothA2dp> mBluetoothA2dp;
298 const std::shared_ptr<::aidl::android::hardware::audio::core::IBluetoothLe> mBluetoothLe;
Mikhail Naganov5b1eed12023-01-25 11:29:11 -0800299 Ports mPorts;
Mikhail Naganov81bf4d02023-02-06 12:20:38 -0800300 int32_t mDefaultInputPortId = -1;
301 int32_t mDefaultOutputPortId = -1;
Mikhail Naganov5b1eed12023-01-25 11:29:11 -0800302 PortConfigs mPortConfigs;
jiabin9c07faf2023-04-26 22:00:44 +0000303 std::set<int32_t> mInitialPortConfigIds;
Mikhail Naganov5b1eed12023-01-25 11:29:11 -0800304 Patches mPatches;
Mikhail Naganovf83b9742023-04-24 13:06:04 -0700305 Routes mRoutes;
Mikhail Naganov289468a2023-03-29 10:06:15 -0700306 RoutingMatrix mRoutingMatrix;
Mikhail Naganove93a0862023-03-15 17:06:59 -0700307 Streams mStreams;
Mikhail Naganovcad0afe2023-03-10 14:25:57 -0800308 Microphones mMicrophones;
Mikhail Naganovdfd594e2023-02-08 16:59:41 -0800309 std::mutex mLock;
310 std::map<void*, Callbacks> mCallbacks GUARDED_BY(mLock);
jiabin872de702023-04-27 22:04:31 +0000311 std::set<audio_port_handle_t> mDeviceDisconnectionNotified;
Shunkai Yao51202502022-12-12 06:11:46 +0000312};
313
314} // namespace android