blob: f0bc9e80766f22267d1df6df3f6c08e48c98dc75 [file] [log] [blame]
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001/* //device/include/server/AudioFlinger/AudioMixer.h
2**
3** Copyright 2007, The Android Open Source Project
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#ifndef ANDROID_AUDIO_MIXER_H
19#define ANDROID_AUDIO_MIXER_H
20
21#include <stdint.h>
22#include <sys/types.h>
23
24#include "AudioBufferProvider.h"
25#include "AudioResampler.h"
26
27namespace android {
28
29// ----------------------------------------------------------------------------
30
31#define LIKELY( exp ) (__builtin_expect( (exp) != 0, true ))
32#define UNLIKELY( exp ) (__builtin_expect( (exp) != 0, false ))
33
34// ----------------------------------------------------------------------------
35
36class AudioMixer
37{
38public:
39 AudioMixer(size_t frameCount, uint32_t sampleRate);
40
41 ~AudioMixer();
42
43 static const uint32_t MAX_NUM_TRACKS = 32;
44 static const uint32_t MAX_NUM_CHANNELS = 2;
45
46 static const uint16_t UNITY_GAIN = 0x1000;
47
48 enum { // names
49
50 // track units (32 units)
51 TRACK0 = 0x1000,
52
53 // enable/disable
54 MIXING = 0x2000,
55
56 // setParameter targets
57 TRACK = 0x3000,
58 RESAMPLE = 0x3001,
59 RAMP_VOLUME = 0x3002, // ramp to new volume
60 VOLUME = 0x3003, // don't ramp
61
62 // set Parameter names
63 // for target TRACK
Jean-Michel Trivi54392232011-05-24 15:53:33 -070064 CHANNEL_MASK = 0x4000,
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080065 FORMAT = 0x4001,
Eric Laurent65b65452010-06-01 23:49:17 -070066 MAIN_BUFFER = 0x4002,
67 AUX_BUFFER = 0x4003,
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080068 // for TARGET RESAMPLE
69 SAMPLE_RATE = 0x4100,
Eric Laurent4bb21c42011-02-28 16:52:51 -080070 RESET = 0x4101,
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080071 // for TARGET VOLUME (8 channels max)
72 VOLUME0 = 0x4200,
73 VOLUME1 = 0x4201,
Eric Laurent65b65452010-06-01 23:49:17 -070074 AUXLEVEL = 0x4210,
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080075 };
76
77
78 int getTrackName();
79 void deleteTrackName(int name);
80
81 status_t enable(int name);
82 status_t disable(int name);
83
84 status_t setActiveTrack(int track);
Eric Laurent65b65452010-06-01 23:49:17 -070085 status_t setParameter(int target, int name, void *value);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080086
87 status_t setBufferProvider(AudioBufferProvider* bufferProvider);
Eric Laurent65b65452010-06-01 23:49:17 -070088 void process();
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080089
90 uint32_t trackNames() const { return mTrackNames; }
91
Eric Laurenta553c252009-07-17 12:17:14 -070092 static void ditherAndClamp(int32_t* out, int32_t const *sums, size_t c);
93
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080094private:
95
96 enum {
97 NEEDS_CHANNEL_COUNT__MASK = 0x00000003,
98 NEEDS_FORMAT__MASK = 0x000000F0,
99 NEEDS_MUTE__MASK = 0x00000100,
100 NEEDS_RESAMPLE__MASK = 0x00001000,
Eric Laurent65b65452010-06-01 23:49:17 -0700101 NEEDS_AUX__MASK = 0x00010000,
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800102 };
103
104 enum {
105 NEEDS_CHANNEL_1 = 0x00000000,
106 NEEDS_CHANNEL_2 = 0x00000001,
107
108 NEEDS_FORMAT_16 = 0x00000010,
109
110 NEEDS_MUTE_DISABLED = 0x00000000,
111 NEEDS_MUTE_ENABLED = 0x00000100,
112
113 NEEDS_RESAMPLE_DISABLED = 0x00000000,
114 NEEDS_RESAMPLE_ENABLED = 0x00001000,
Eric Laurent65b65452010-06-01 23:49:17 -0700115
116 NEEDS_AUX_DISABLED = 0x00000000,
117 NEEDS_AUX_ENABLED = 0x00010000,
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800118 };
119
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800120 struct state_t;
Eric Laurent65b65452010-06-01 23:49:17 -0700121 struct track_t;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800122
Eric Laurent65b65452010-06-01 23:49:17 -0700123 typedef void (*mix_t)(state_t* state);
124 typedef void (*hook_t)(track_t* t, int32_t* output, size_t numOutFrames, int32_t* temp, int32_t* aux);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800125 static const int BLOCKSIZE = 16; // 4 cache lines
126
127 struct track_t {
128 uint32_t needs;
129
130 union {
131 int16_t volume[2]; // [0]3.12 fixed point
132 int32_t volumeRL;
133 };
134
135 int32_t prevVolume[2];
136
137 int32_t volumeInc[2];
Eric Laurent65b65452010-06-01 23:49:17 -0700138 int32_t auxLevel;
139 int32_t auxInc;
140 int32_t prevAuxLevel;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800141
142 uint16_t frameCount;
143
144 uint8_t channelCount : 4;
145 uint8_t enabled : 1;
146 uint8_t reserved0 : 3;
147 uint8_t format;
Jean-Michel Trivi54392232011-05-24 15:53:33 -0700148 uint32_t channelMask;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800149
150 AudioBufferProvider* bufferProvider;
151 mutable AudioBufferProvider::Buffer buffer;
152
Eric Laurent65b65452010-06-01 23:49:17 -0700153 hook_t hook;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800154 void const* in; // current location in buffer
155
156 AudioResampler* resampler;
157 uint32_t sampleRate;
Eric Laurent65b65452010-06-01 23:49:17 -0700158 int32_t* mainBuffer;
159 int32_t* auxBuffer;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800160
161 bool setResampler(uint32_t sampleRate, uint32_t devSampleRate);
162 bool doesResample() const;
Eric Laurent4bb21c42011-02-28 16:52:51 -0800163 void resetResampler();
Eric Laurent65b65452010-06-01 23:49:17 -0700164 void adjustVolumeRamp(bool aux);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800165 };
166
167 // pad to 32-bytes to fill cache line
168 struct state_t {
169 uint32_t enabledTracks;
170 uint32_t needsChanged;
171 size_t frameCount;
172 mix_t hook;
173 int32_t *outputTemp;
174 int32_t *resampleTemp;
175 int32_t reserved[2];
176 track_t tracks[32]; __attribute__((aligned(32)));
177 };
178
179 int mActiveTrack;
180 uint32_t mTrackNames;
181 const uint32_t mSampleRate;
182
183 state_t mState __attribute__((aligned(32)));
184
185 void invalidateState(uint32_t mask);
186
Eric Laurent65b65452010-06-01 23:49:17 -0700187 static void track__genericResample(track_t* t, int32_t* out, size_t numFrames, int32_t* temp, int32_t* aux);
188 static void track__nop(track_t* t, int32_t* out, size_t numFrames, int32_t* temp, int32_t* aux);
189 static void track__16BitsStereo(track_t* t, int32_t* out, size_t numFrames, int32_t* temp, int32_t* aux);
190 static void track__16BitsMono(track_t* t, int32_t* out, size_t numFrames, int32_t* temp, int32_t* aux);
191 static void volumeRampStereo(track_t* t, int32_t* out, size_t frameCount, int32_t* temp, int32_t* aux);
192 static void volumeStereo(track_t* t, int32_t* out, size_t frameCount, int32_t* temp, int32_t* aux);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800193
Eric Laurent65b65452010-06-01 23:49:17 -0700194 static void process__validate(state_t* state);
195 static void process__nop(state_t* state);
196 static void process__genericNoResampling(state_t* state);
197 static void process__genericResampling(state_t* state);
198 static void process__OneTrack16BitsStereoNoResampling(state_t* state);
Glenn Kasten31ba2e52011-12-15 09:53:12 -0800199#if 0
Eric Laurent65b65452010-06-01 23:49:17 -0700200 static void process__TwoTracks16BitsStereoNoResampling(state_t* state);
Glenn Kasten31ba2e52011-12-15 09:53:12 -0800201#endif
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800202};
203
204// ----------------------------------------------------------------------------
205}; // namespace android
206
207#endif // ANDROID_AUDIO_MIXER_H