• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * Copyright (C) 2010 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_EFFECTBUNDLE_H_
18 #define ANDROID_EFFECTBUNDLE_H_
19 
20 #include <audio_effects/effect_bassboost.h>
21 #include <audio_effects/effect_equalizer.h>
22 #include <audio_effects/effect_virtualizer.h>
23 #include <LVM.h>
24 #include <limits.h>
25 
26 #if __cplusplus
27 extern "C" {
28 #endif
29 
30 #define FIVEBAND_NUMBANDS          5
31 #define MAX_NUM_BANDS              5
32 #define MAX_CALL_SIZE              256
33 #define LVM_MAX_SESSIONS           32
34 #define LVM_UNUSED_SESSION         INT_MAX
35 #define BASS_BOOST_CUP_LOAD_ARM9E  150    // Expressed in 0.1 MIPS
36 #define VIRTUALIZER_CUP_LOAD_ARM9E 120    // Expressed in 0.1 MIPS
37 #define EQUALIZER_CUP_LOAD_ARM9E   220    // Expressed in 0.1 MIPS
38 #define VOLUME_CUP_LOAD_ARM9E      0      // Expressed in 0.1 MIPS
39 #define BUNDLE_MEM_USAGE           25     // Expressed in kB
40 //#define LVM_PCM
41 
42 #ifndef OPENSL_ES_H_
43 static const effect_uuid_t SL_IID_VOLUME_ = { 0x09e8ede0, 0xddde, 0x11db, 0xb4f6,
44                                             { 0x00, 0x02, 0xa5, 0xd5, 0xc5, 0x1b } };
45 const effect_uuid_t * const SL_IID_VOLUME = &SL_IID_VOLUME_;
46 #endif //OPENSL_ES_H_
47 
48 typedef enum
49 {
50     LVM_BASS_BOOST,
51     LVM_VIRTUALIZER,
52     LVM_EQUALIZER,
53     LVM_VOLUME
54 } lvm_effect_en;
55 
56 // Preset configuration.
57 struct PresetConfig {
58     // Human-readable name.
59     const char * name;
60     // An array of size nBands where each element is a configuration for the
61     // corresponding band.
62     //const BandConfig * bandConfigs;
63 };
64 
65 /* BundledEffectContext : One per session */
66 struct BundledEffectContext{
67     LVM_Handle_t                    hInstance;                /* Instance handle */
68     int                             SessionNo;                /* Current session number */
69     int                             SessionId;                /* Current session id */
70     bool                            bVolumeEnabled;           /* Flag for Volume */
71     bool                            bEqualizerEnabled;        /* Flag for EQ */
72     bool                            bBassEnabled;             /* Flag for Bass */
73     bool                            bBassTempDisabled;        /* Flag for Bass to be re-enabled */
74     bool                            bVirtualizerEnabled;      /* Flag for Virtualizer */
75     bool                            bVirtualizerTempDisabled; /* Flag for effect to be re-enabled */
76     int                             NumberEffectsEnabled;     /* Effects in this session */
77     int                             NumberEffectsCalled;      /* Effects called so far */
78     bool                            firstVolume;              /* No smoothing on first Vol change */
79     // Saved parameters for each effect */
80     // Bass Boost
81     int                             BassStrengthSaved;        /* Conversion between Get/Set */
82     // Equalizer
83     int                             CurPreset;                /* Current preset being used */
84     // Virtualzer
85     int                             VirtStrengthSaved;        /* Conversion between Get/Set */
86     // Volume
87     int                             levelSaved;     /* for when mute is set, level must be saved */
88     int                             positionSaved;
89     bool                            bMuteEnabled;   /* Must store as mute = -96dB level */
90     bool                            bStereoPositionEnabled;
91     LVM_Fs_en                       SampleRate;
92     int                             SamplesPerSecond;
93     int                             SamplesToExitCountEq;
94     int                             SamplesToExitCountBb;
95     int                             SamplesToExitCountVirt;
96     LVM_INT16                       *workBuffer;
97     int                             frameCount;
98     #ifdef LVM_PCM
99     FILE                            *PcmInPtr;
100     FILE                            *PcmOutPtr;
101     #endif
102 };
103 
104 /* SessionContext : One session */
105 struct SessionContext{
106     bool                            bBundledEffectsEnabled;
107     bool                            bVolumeInstantiated;
108     bool                            bEqualizerInstantiated;
109     bool                            bBassInstantiated;
110     bool                            bVirtualizerInstantiated;
111     BundledEffectContext            *pBundledContext;
112 };
113 
114 struct EffectContext{
115     const struct effect_interface_s *itfe;
116     effect_config_t                 config;
117     lvm_effect_en                   EffectType;
118     BundledEffectContext            *pBundledContext;
119 };
120 
121 
122 /* enumerated parameter settings for Volume effect */
123 typedef enum
124 {
125     VOLUME_PARAM_LEVEL,                       // type SLmillibel = typedef SLuint16 (set & get)
126     VOLUME_PARAM_MAXLEVEL,                    // type SLmillibel = typedef SLuint16 (get)
127     VOLUME_PARAM_MUTE,                        // type SLboolean  = typedef SLuint32 (set & get)
128     VOLUME_PARAM_ENABLESTEREOPOSITION,        // type SLboolean  = typedef SLuint32 (set & get)
129     VOLUME_PARAM_STEREOPOSITION,              // type SLpermille = typedef SLuint16 (set & get)
130 } t_volume_params;
131 
132 static const int PRESET_CUSTOM = -1;
133 
134 static const uint32_t bandFreqRange[FIVEBAND_NUMBANDS][2] = {
135                                        {30000, 120000},
136                                        {120001, 460000},
137                                        {460001, 1800000},
138                                        {1800001, 7000000},
139                                        {7000001, 1}};
140 
141 static const LVM_UINT16  EQNB_5BandPresetsFrequencies[] = {
142                                        60,           /* Frequencies in Hz */
143                                        230,
144                                        910,
145                                        3600,
146                                        14000};
147 
148 static const LVM_UINT16 EQNB_5BandPresetsQFactors[] = {
149                                        96,               /* Q factor multiplied by 100 */
150                                        96,
151                                        96,
152                                        96,
153                                        96};
154 
155 static const LVM_INT16 EQNB_5BandNormalPresets[] = {
156                                        3, 0, 0, 0, 3,       /* Normal Preset */
157                                        8, 5, -3, 5, 6,      /* Classical Preset */
158                                        15, -6, 7, 13, 10,   /* Dance Preset */
159                                        0, 0, 0, 0, 0,       /* Flat Preset */
160                                        6, -2, -2, 6, -3,    /* Folk Preset */
161                                        8, -8, 13, -1, -4,   /* Heavy Metal Preset */
162                                        10, 6, -4, 5, 8,     /* Hip Hop Preset */
163                                        8, 5, -4, 5, 9,      /* Jazz Preset */
164                                       -6, 4, 9, 4, -5,      /* Pop Preset */
165                                        10, 6, -1, 8, 10};   /* Rock Preset */
166 
167 static const LVM_INT16 EQNB_5BandSoftPresets[] = {
168                                         3, 0, 0, 0, 3,      /* Normal Preset */
169                                         5, 3, -2, 4, 4,     /* Classical Preset */
170                                         6, 0, 2, 4, 1,      /* Dance Preset */
171                                         0, 0, 0, 0, 0,      /* Flat Preset */
172                                         3, 0, 0, 2, -1,     /* Folk Preset */
173                                         4, 1, 9, 3, 0,      /* Heavy Metal Preset */
174                                         5, 3, 0, 1, 3,      /* Hip Hop Preset */
175                                         4, 2, -2, 2, 5,     /* Jazz Preset */
176                                        -1, 2, 5, 1, -2,     /* Pop Preset */
177                                         5, 3, -1, 3, 5};    /* Rock Preset */
178 
179 static const PresetConfig gEqualizerPresets[] = {
180                                         {"Normal"},
181                                         {"Classical"},
182                                         {"Dance"},
183                                         {"Flat"},
184                                         {"Folk"},
185                                         {"Heavy Metal"},
186                                         {"Hip Hop"},
187                                         {"Jazz"},
188                                         {"Pop"},
189                                         {"Rock"}};
190 
191 #if __cplusplus
192 }  // extern "C"
193 #endif
194 
195 
196 #endif /*ANDROID_EFFECTBUNDLE_H_*/
197