1 /*
2  * Copyright (C) 2018 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 #ifndef ANDROID_HARDWARE_AUDIO_EFFECT_VIRTUALIZEREFFECT_H
18 #define ANDROID_HARDWARE_AUDIO_EFFECT_VIRTUALIZEREFFECT_H
19 
20 #include PATH(android/hardware/audio/effect/FILE_VERSION/IVirtualizerEffect.h)
21 
22 #include "Effect.h"
23 
24 #include <hidl/Status.h>
25 
26 #include <hidl/MQDescriptor.h>
27 
28 #include "VersionUtils.h"
29 
30 namespace android {
31 namespace hardware {
32 namespace audio {
33 namespace effect {
34 namespace CPP_VERSION {
35 namespace implementation {
36 
37 using ::android::sp;
38 using ::android::hardware::hidl_string;
39 using ::android::hardware::hidl_vec;
40 using ::android::hardware::Return;
41 using ::android::hardware::Void;
42 #if MAJOR_VERSION <= 6
43 using ::android::hardware::audio::common::CPP_VERSION::implementation::AudioChannelBitfield;
44 #endif
45 using namespace ::android::hardware::audio::common::CPP_VERSION;
46 using namespace ::android::hardware::audio::effect::CPP_VERSION;
47 
48 struct VirtualizerEffect : public IVirtualizerEffect {
49     explicit VirtualizerEffect(effect_handle_t handle);
50 
51     // Methods from ::android::hardware::audio::effect::CPP_VERSION::IEffect follow.
52     Return<Result> init() override;
53     Return<Result> setConfig(
54         const EffectConfig& config, const sp<IEffectBufferProviderCallback>& inputBufferProvider,
55         const sp<IEffectBufferProviderCallback>& outputBufferProvider) override;
56     Return<Result> reset() override;
57     Return<Result> enable() override;
58     Return<Result> disable() override;
59 #if MAJOR_VERSION <= 6
60     Return<Result> setAudioSource(AudioSource source) override;
61     Return<Result> setDevice(AudioDeviceBitfield device) override;
62     Return<Result> setInputDevice(AudioDeviceBitfield device) override;
63 #else
64     Return<Result> setAudioSource(const AudioSource& source) override;
65     Return<Result> setDevice(const DeviceAddress& device) override;
66     Return<Result> setInputDevice(const DeviceAddress& device) override;
67 #endif
68     Return<void> setAndGetVolume(const hidl_vec<uint32_t>& volumes,
69                                  setAndGetVolume_cb _hidl_cb) override;
70     Return<Result> volumeChangeNotification(const hidl_vec<uint32_t>& volumes) override;
71     Return<Result> setAudioMode(AudioMode mode) override;
72     Return<Result> setConfigReverse(
73         const EffectConfig& config, const sp<IEffectBufferProviderCallback>& inputBufferProvider,
74         const sp<IEffectBufferProviderCallback>& outputBufferProvider) override;
75     Return<void> getConfig(getConfig_cb _hidl_cb) override;
76     Return<void> getConfigReverse(getConfigReverse_cb _hidl_cb) override;
77     Return<void> getSupportedAuxChannelsConfigs(
78         uint32_t maxConfigs, getSupportedAuxChannelsConfigs_cb _hidl_cb) override;
79     Return<void> getAuxChannelsConfig(getAuxChannelsConfig_cb _hidl_cb) override;
80     Return<Result> setAuxChannelsConfig(const EffectAuxChannelsConfig& config) override;
81     Return<Result> offload(const EffectOffloadParameter& param) override;
82     Return<void> getDescriptor(getDescriptor_cb _hidl_cb) override;
83     Return<void> prepareForProcessing(prepareForProcessing_cb _hidl_cb) override;
84     Return<Result> setProcessBuffers(const AudioBuffer& inBuffer,
85                                      const AudioBuffer& outBuffer) override;
86     Return<void> command(uint32_t commandId, const hidl_vec<uint8_t>& data, uint32_t resultMaxSize,
87                          command_cb _hidl_cb) override;
88     Return<Result> setParameter(const hidl_vec<uint8_t>& parameter,
89                                 const hidl_vec<uint8_t>& value) override;
90     Return<void> getParameter(const hidl_vec<uint8_t>& parameter, uint32_t valueMaxSize,
91                               getParameter_cb _hidl_cb) override;
92     Return<void> getSupportedConfigsForFeature(uint32_t featureId, uint32_t maxConfigs,
93                                                uint32_t configSize,
94                                                getSupportedConfigsForFeature_cb _hidl_cb) override;
95     Return<void> getCurrentConfigForFeature(uint32_t featureId, uint32_t configSize,
96                                             getCurrentConfigForFeature_cb _hidl_cb) override;
97     Return<Result> setCurrentConfigForFeature(uint32_t featureId,
98                                               const hidl_vec<uint8_t>& configData) override;
99     Return<Result> close() override;
100     Return<void> debug(const hidl_handle& fd, const hidl_vec<hidl_string>& options) override;
101 
102     // Methods from ::android::hardware::audio::effect::CPP_VERSION::IVirtualizerEffect
103     // follow.
104     Return<bool> isStrengthSupported() override;
105     Return<Result> setStrength(uint16_t strength) override;
106     Return<void> getStrength(getStrength_cb _hidl_cb) override;
107     Return<void> getVirtualizationMode(getVirtualizationMode_cb _hidl_cb) override;
108 #if MAJOR_VERSION <= 6
109     Return<void> getVirtualSpeakerAngles(AudioChannelBitfield mask, AudioDevice device,
110                                          getVirtualSpeakerAngles_cb _hidl_cb) override;
111     Return<Result> forceVirtualizationMode(AudioDevice device) override;
112 #else
113     Return<void> getVirtualSpeakerAngles(const AudioChannelMask& mask, const DeviceAddress& device,
114                                          getVirtualSpeakerAngles_cb _hidl_cb) override;
115     Return<Result> forceVirtualizationMode(const DeviceAddress& device) override;
116 #endif
117 
118   private:
119     sp<Effect> mEffect;
120 
121     virtual ~VirtualizerEffect() = default;
122 
123 #if MAJOR_VERSION <= 6
124     using SpeakerAngles = hidl_vec<SpeakerAngle>;
125 #endif
126     static status_t speakerAnglesFromHal(const int32_t* halAngles, uint32_t channelCount,
127                                          SpeakerAngles& speakerAngles);
128 };
129 
130 }  // namespace implementation
131 }  // namespace CPP_VERSION
132 }  // namespace effect
133 }  // namespace audio
134 }  // namespace hardware
135 }  // namespace android
136 
137 #endif  // ANDROID_HARDWARE_AUDIO_EFFECT_VIRTUALIZEREFFECT_H
138