Home | History | Annotate | Download | only in Bundle
      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