Home | History | Annotate | Download | only in src
      1 /*
      2  * Copyright (C) 2004-2010 NXP Software
      3  * Copyright (C) 2010 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 /****************************************************************************************/
     19 /*                                                                                      */
     20 /*    Includes                                                                          */
     21 /*                                                                                      */
     22 /****************************************************************************************/
     23 
     24 #include "LVDBE.h"
     25 #include "LVDBE_Private.h"
     26 
     27 /****************************************************************************************/
     28 /*                                                                                      */
     29 /* FUNCTION:                 LVDBE_Memory                                               */
     30 /*                                                                                      */
     31 /* DESCRIPTION:                                                                         */
     32 /*    This function is used for memory allocation and free. It can be called in         */
     33 /*    two ways:                                                                         */
     34 /*                                                                                      */
     35 /*        hInstance = NULL                Returns the memory requirements               */
     36 /*        hInstance = Instance handle        Returns the memory requirements and        */
     37 /*                                        allocated base addresses for the instance     */
     38 /*                                                                                      */
     39 /*    When this function is called for memory allocation (hInstance=NULL) the memory    */
     40 /*  base address pointers are NULL on return.                                           */
     41 /*                                                                                      */
     42 /*    When the function is called for free (hInstance = Instance Handle) the memory     */
     43 /*  table returns the allocated memory and base addresses used during initialisation.   */
     44 /*                                                                                      */
     45 /* PARAMETERS:                                                                          */
     46 /*  hInstance                Instance Handle                                            */
     47 /*  pMemoryTable             Pointer to an empty memory definition table                */
     48 /*    pCapabilities           Pointer to the instance capabilities                      */
     49 /*                                                                                      */
     50 /* RETURNS:                                                                             */
     51 /*  LVDBE_SUCCESS            Succeeded                                                  */
     52 /*                                                                                      */
     53 /* NOTES:                                                                               */
     54 /*    1.    This function may be interrupted by the LVDBE_Process function              */
     55 /*                                                                                      */
     56 /****************************************************************************************/
     57 
     58 LVDBE_ReturnStatus_en LVDBE_Memory(LVDBE_Handle_t            hInstance,
     59                                    LVDBE_MemTab_t            *pMemoryTable,
     60                                    LVDBE_Capabilities_t      *pCapabilities)
     61 {
     62 
     63     LVM_UINT32          ScratchSize;
     64     LVDBE_Instance_t    *pInstance = (LVDBE_Instance_t *)hInstance;
     65 
     66 
     67     /*
     68      * Fill in the memory table
     69      */
     70     if (hInstance == LVM_NULL)
     71     {
     72         /*
     73          * Instance memory
     74          */
     75         pMemoryTable->Region[LVDBE_MEMREGION_INSTANCE].Size         = sizeof(LVDBE_Instance_t);
     76         pMemoryTable->Region[LVDBE_MEMREGION_INSTANCE].Alignment    = LVDBE_INSTANCE_ALIGN;
     77         pMemoryTable->Region[LVDBE_MEMREGION_INSTANCE].Type         = LVDBE_PERSISTENT;
     78         pMemoryTable->Region[LVDBE_MEMREGION_INSTANCE].pBaseAddress = LVM_NULL;
     79 
     80         /*
     81          * Data memory
     82          */
     83         pMemoryTable->Region[LVDBE_MEMREGION_PERSISTENT_DATA].Size         = sizeof(LVDBE_Data_t);
     84         pMemoryTable->Region[LVDBE_MEMREGION_PERSISTENT_DATA].Alignment    = LVDBE_PERSISTENT_DATA_ALIGN;
     85         pMemoryTable->Region[LVDBE_MEMREGION_PERSISTENT_DATA].Type         = LVDBE_PERSISTENT_DATA;
     86         pMemoryTable->Region[LVDBE_MEMREGION_PERSISTENT_DATA].pBaseAddress = LVM_NULL;
     87 
     88         /*
     89          * Coef memory
     90          */
     91         pMemoryTable->Region[LVDBE_MEMREGION_PERSISTENT_COEF].Size         = sizeof(LVDBE_Coef_t);
     92         pMemoryTable->Region[LVDBE_MEMREGION_PERSISTENT_COEF].Alignment    = LVDBE_PERSISTENT_COEF_ALIGN;
     93         pMemoryTable->Region[LVDBE_MEMREGION_PERSISTENT_COEF].Type         = LVDBE_PERSISTENT_COEF;
     94         pMemoryTable->Region[LVDBE_MEMREGION_PERSISTENT_COEF].pBaseAddress = LVM_NULL;
     95 
     96         /*
     97          * Scratch memory
     98          */
     99         ScratchSize = (LVM_UINT32)(LVDBE_SCRATCHBUFFERS_INPLACE*sizeof(LVM_INT16)*pCapabilities->MaxBlockSize);
    100         pMemoryTable->Region[LVDBE_MEMREGION_SCRATCH].Size         = ScratchSize;
    101         pMemoryTable->Region[LVDBE_MEMREGION_SCRATCH].Alignment    = LVDBE_SCRATCH_ALIGN;
    102         pMemoryTable->Region[LVDBE_MEMREGION_SCRATCH].Type         = LVDBE_SCRATCH;
    103         pMemoryTable->Region[LVDBE_MEMREGION_SCRATCH].pBaseAddress = LVM_NULL;
    104     }
    105     else
    106     {
    107         /* Read back memory allocation table */
    108         *pMemoryTable = pInstance->MemoryTable;
    109     }
    110 
    111     return(LVDBE_SUCCESS);
    112 }
    113 
    114 
    115 /****************************************************************************************/
    116 /*                                                                                      */
    117 /* FUNCTION:                 LVDBE_Init                                                 */
    118 /*                                                                                      */
    119 /* DESCRIPTION:                                                                         */
    120 /*    Create and initialisation function for the Dynamic Bass Enhancement module        */
    121 /*                                                                                      */
    122 /*    This function can be used to create an algorithm instance by calling with         */
    123 /*    hInstance set to NULL. In this case the algorithm returns the new instance        */
    124 /*    handle.                                                                           */
    125 /*                                                                                      */
    126 /*    This function can be used to force a full re-initialisation of the algorithm      */
    127 /*    by calling with hInstance = Instance Handle. In this case the memory table        */
    128 /*    should be correct for the instance, this can be ensured by calling the function   */
    129 /*    DBE_Memory before calling this function.                                          */
    130 /*                                                                                      */
    131 /* PARAMETERS:                                                                          */
    132 /*  hInstance                  Instance handle                                          */
    133 /*  pMemoryTable             Pointer to the memory definition table                     */
    134 /*  pCapabilities              Pointer to the instance capabilities                     */
    135 /*                                                                                      */
    136 /* RETURNS:                                                                             */
    137 /*  LVDBE_SUCCESS            Initialisation succeeded                                   */
    138 /*  LVDBE_ALIGNMENTERROR    Instance or scratch memory on incorrect alignment           */
    139 /*    LVDBE_NULLADDRESS        Instance or scratch memory has a NULL pointer            */
    140 /*                                                                                      */
    141 /* NOTES:                                                                               */
    142 /*  1.     The instance handle is the pointer to the base address of the first memory   */
    143 /*        region.                                                                       */
    144 /*    2.    This function must not be interrupted by the LVDBE_Process function         */
    145 /*                                                                                      */
    146 /****************************************************************************************/
    147 
    148 LVDBE_ReturnStatus_en LVDBE_Init(LVDBE_Handle_t         *phInstance,
    149                                    LVDBE_MemTab_t       *pMemoryTable,
    150                                    LVDBE_Capabilities_t *pCapabilities)
    151 {
    152 
    153     LVDBE_Instance_t      *pInstance;
    154     LVMixer3_1St_st       *pMixer_Instance;
    155     LVMixer3_2St_st       *pBypassMixer_Instance;
    156     LVM_INT16             i;
    157     LVM_INT32             MixGain;
    158 
    159 
    160     /*
    161      * Set the instance handle if not already initialised
    162      */
    163     if (*phInstance == LVM_NULL)
    164     {
    165         *phInstance = (LVDBE_Handle_t)pMemoryTable->Region[LVDBE_MEMREGION_INSTANCE].pBaseAddress;
    166     }
    167     pInstance =(LVDBE_Instance_t  *)*phInstance;
    168 
    169 
    170     /*
    171      * Check the memory table for NULL pointers and incorrectly aligned data
    172      */
    173     for (i=0; i<LVDBE_NR_MEMORY_REGIONS; i++)
    174     {
    175         if (pMemoryTable->Region[i].Size!=0)
    176         {
    177             if (pMemoryTable->Region[i].pBaseAddress==LVM_NULL)
    178             {
    179                 return(LVDBE_NULLADDRESS);
    180             }
    181             if (((LVM_UINT32)pMemoryTable->Region[i].pBaseAddress % pMemoryTable->Region[i].Alignment)!=0){
    182                 return(LVDBE_ALIGNMENTERROR);
    183             }
    184         }
    185     }
    186 
    187 
    188     /*
    189      * Save the memory table in the instance structure
    190      */
    191     pInstance->Capabilities = *pCapabilities;
    192 
    193 
    194     /*
    195      * Save the memory table in the instance structure
    196      */
    197     pInstance->MemoryTable = *pMemoryTable;
    198 
    199 
    200     /*
    201      * Set the default instance parameters
    202      */
    203     pInstance->Params.CentreFrequency   =    LVDBE_CENTRE_55HZ;
    204     pInstance->Params.EffectLevel       =    0;
    205     pInstance->Params.HeadroomdB        =    0;
    206     pInstance->Params.HPFSelect         =    LVDBE_HPF_OFF;
    207     pInstance->Params.OperatingMode     =    LVDBE_OFF;
    208     pInstance->Params.SampleRate        =    LVDBE_FS_8000;
    209     pInstance->Params.VolumeControl     =    LVDBE_VOLUME_OFF;
    210     pInstance->Params.VolumedB          =    0;
    211 
    212 
    213     /*
    214      * Set pointer to data and coef memory
    215      */
    216     pInstance->pData = pMemoryTable->Region[LVDBE_MEMREGION_PERSISTENT_DATA].pBaseAddress;
    217     pInstance->pCoef = pMemoryTable->Region[LVDBE_MEMREGION_PERSISTENT_COEF].pBaseAddress;
    218 
    219 
    220     /*
    221      * Initialise the filters
    222      */
    223     LVDBE_SetFilters(pInstance,                 /* Set the filter taps and coefficients */
    224                      &pInstance->Params);
    225 
    226 
    227     /*
    228      * Initialise the AGC
    229      */
    230     LVDBE_SetAGC(pInstance,                                     /* Set the AGC gain */
    231                  &pInstance->Params);
    232     pInstance->pData->AGCInstance.AGC_Gain = pInstance->pData->AGCInstance.AGC_MaxGain;
    233                                                 /* Default to the bass boost setting */
    234 
    235     // initialize the mixer with some fixes values since otherwise LVDBE_SetVolume ends up
    236     // reading uninitialized data
    237     pMixer_Instance = &pInstance->pData->BypassVolume;
    238     LVC_Mixer_Init(&pMixer_Instance->MixerStream[0],0x00007FFF,0x00007FFF);
    239 
    240     /*
    241      * Initialise the volume
    242      */
    243     LVDBE_SetVolume(pInstance,                                         /* Set the Volume */
    244                     &pInstance->Params);
    245 
    246     pInstance->pData->AGCInstance.Volume = pInstance->pData->AGCInstance.Target;
    247                                                 /* Initialise as the target */
    248 
    249     MixGain = LVC_Mixer_GetTarget(&pMixer_Instance->MixerStream[0]);
    250     LVC_Mixer_Init(&pMixer_Instance->MixerStream[0],MixGain,MixGain);
    251 
    252     /* Configure the mixer process path */
    253     pMixer_Instance->MixerStream[0].CallbackParam = 0;
    254     pMixer_Instance->MixerStream[0].pCallbackHandle = LVM_NULL;
    255     pMixer_Instance->MixerStream[0].pCallBack = LVM_NULL;
    256     pMixer_Instance->MixerStream[0].CallbackSet = 0;
    257 
    258     /*
    259      * Initialise the clicks minimisation BypassMixer
    260      */
    261 
    262     pBypassMixer_Instance = &pInstance->pData->BypassMixer;
    263 
    264     /*
    265      * Setup the mixer gain for the processed path
    266      */
    267     pBypassMixer_Instance->MixerStream[0].CallbackParam = 0;
    268     pBypassMixer_Instance->MixerStream[0].pCallbackHandle = LVM_NULL;
    269     pBypassMixer_Instance->MixerStream[0].pCallBack = LVM_NULL;
    270     pBypassMixer_Instance->MixerStream[0].CallbackSet=0;
    271     LVC_Mixer_Init(&pBypassMixer_Instance->MixerStream[0],0,0);
    272     LVC_Mixer_SetTimeConstant(&pBypassMixer_Instance->MixerStream[0],
    273         LVDBE_BYPASS_MIXER_TC,pInstance->Params.SampleRate,2);
    274     /*
    275      * Setup the mixer gain for the unprocessed path
    276      */
    277     pBypassMixer_Instance->MixerStream[1].CallbackParam = 0;
    278     pBypassMixer_Instance->MixerStream[1].pCallbackHandle = LVM_NULL;
    279     pBypassMixer_Instance->MixerStream[1].pCallBack = LVM_NULL;
    280     pBypassMixer_Instance->MixerStream[1].CallbackSet=0;
    281     LVC_Mixer_Init(&pBypassMixer_Instance->MixerStream[1],0x00007FFF,0x00007FFF);
    282     LVC_Mixer_SetTimeConstant(&pBypassMixer_Instance->MixerStream[1],
    283         LVDBE_BYPASS_MIXER_TC,pInstance->Params.SampleRate,2);
    284 
    285     return(LVDBE_SUCCESS);
    286 }
    287 
    288