| /* |
| * Copyright (C) 2004-2010 NXP Software |
| * Copyright (C) 2010 The Android Open Source Project |
| * |
| * Licensed under the Apache License, Version 2.0 (the "License"); |
| * you may not use this file except in compliance with the License. |
| * You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| |
| #ifndef _LVPSA_PRIVATE_H_ |
| #define _LVPSA_PRIVATE_H_ |
| |
| #include "LVPSA.h" |
| #include "BIQUAD.h" |
| #include "LVPSA_QPD.h" |
| #include "LVM_Macros.h" |
| |
| |
| |
| #ifdef __cplusplus |
| extern "C" { |
| #endif /* __cplusplus */ |
| |
| /********************************************************************************** |
| CONSTANT DEFINITIONS |
| ***********************************************************************************/ |
| |
| /* Memory */ |
| #define LVPSA_INSTANCE_ALIGN 4 /* 32-bit alignment for structures */ |
| #define LVPSA_SCRATCH_ALIGN 4 /* 32-bit alignment for long data */ |
| #define LVPSA_COEF_ALIGN 4 /* 32-bit alignment for long words */ |
| #define LVPSA_DATA_ALIGN 4 /* 32-bit alignment for long data */ |
| |
| #define LVPSA_MEMREGION_INSTANCE 0 /* Offset to instance memory region in memory table */ |
| #define LVPSA_MEMREGION_PERSISTENT_COEF 1 /* Offset to persistent coefficients memory region in memory table */ |
| #define LVPSA_MEMREGION_PERSISTENT_DATA 2 /* Offset to persistent taps memory region in memory table */ |
| #define LVPSA_MEMREGION_SCRATCH 3 /* Offset to scratch memory region in memory table */ |
| |
| #define LVPSA_NR_SUPPORTED_RATE 9 /* From 8000Hz to 48000Hz */ |
| #define LVPSA_NR_SUPPORTED_SPEED 3 /* LOW, MEDIUM, HIGH */ |
| |
| #define LVPSA_MAXBUFFERDURATION 4000 /* Maximum length in ms of the levels buffer */ |
| #define LVPSA_MAXINPUTBLOCKSIZE 5000 /* Maximum length in mono samples of the block to process */ |
| #define LVPSA_NBANDSMIN 1 /* Minimum number of frequency band */ |
| #define LVPSA_NBANDSMAX 30 /* Maximum number of frequency band */ |
| #define LVPSA_MAXCENTERFREQ 20000 /* Maximum possible center frequency */ |
| #define LVPSA_MINPOSTGAIN (-15) /* Minimum possible post gain */ |
| #define LVPSA_MAXPOSTGAIN 15 /* Maximum possible post gain */ |
| #define LVPSA_MINQFACTOR 25 /* Minimum possible Q factor */ |
| #define LVPSA_MAXQFACTOR 1200 /* Maximum possible Q factor */ |
| |
| #define LVPSA_MAXLEVELDECAYFACTOR 0x4111 /* Decay factor for the maximum values calculation */ |
| #define LVPSA_MAXLEVELDECAYSHIFT 14 /* Decay shift for the maximum values calculation */ |
| |
| #define LVPSA_MAXUNSIGNEDCHAR 0xFF |
| |
| #define LVPSA_FsInvertShift 31 |
| #define LVPSA_GAINSHIFT 11 |
| #define LVPSA_FREQSHIFT 25 |
| |
| /********************************************************************************** |
| TYPES DEFINITIONS |
| ***********************************************************************************/ |
| |
| #define LVPSA_InternalRefreshTime 0x0014 /* 20 ms (50Hz) in Q16.0 */ |
| #define LVPSA_InternalRefreshTimeInv 0x0666 /* 1/20ms left shifted by 15 */ |
| #define LVPSA_InternalRefreshTimeShift 15 |
| |
| |
| /* Precision of the filter */ |
| typedef enum |
| { |
| LVPSA_SimplePrecisionFilter, /* Simple precision */ |
| LVPSA_DoublePrecisionFilter /* Double precision */ |
| } LVPSA_BPFilterPrecision_en; |
| |
| typedef struct |
| { |
| LVM_CHAR bControlPending; /* Flag incating a change of the control parameters */ |
| LVM_UINT16 nBands; /* Number of bands of the spectrum analyzer */ |
| LVM_UINT16 MaxInputBlockSize; /* Maximum input data buffer size */ |
| |
| LVPSA_ControlParams_t CurrentParams; /* Current control parameters of the module */ |
| LVPSA_ControlParams_t NewParams; /* New control parameters given by the user */ |
| LVPSA_MemTab_t MemoryTable; |
| |
| LVPSA_BPFilterPrecision_en *pBPFiltersPrecision; /* Points a nBands elements array that contains the filter precision for each band */ |
| Biquad_Instance_t *pBP_Instances; /* Points a nBands elements array that contains the band pass filter instance for each band */ |
| Biquad_1I_Order2_Taps_t *pBP_Taps; /* Points a nBands elements array that contains the band pass filter taps for each band */ |
| QPD_State_t *pQPD_States; /* Points a nBands elements array that contains the QPD filter instance for each band */ |
| QPD_Taps_t *pQPD_Taps; /* Points a nBands elements array that contains the QPD filter taps for each band */ |
| LVM_UINT16 *pPostGains; /* Points a nBands elements array that contains the post-filter gains for each band */ |
| |
| LVPSA_FilterParam_t *pFiltersParams; /* Copy of the filters parameters from the input parameters */ |
| |
| |
| LVM_UINT16 nSamplesBufferUpdate; /* Number of samples to make 20ms */ |
| LVM_INT32 BufferUpdateSamplesCount; /* Counter used to know when to put a new value in the buffer */ |
| LVM_UINT16 nRelevantFilters; /* Number of relevent filters depending on sampling frequency and bands center frequency */ |
| LVM_UINT16 LocalSamplesCount; /* Counter used to update the SpectralDataBufferAudioTime */ |
| |
| LVM_UINT16 DownSamplingFactor; /* Down sampling factor depending on the sampling frequency */ |
| LVM_UINT16 DownSamplingCount; /* Counter used for the downsampling handling */ |
| |
| LVM_UINT16 SpectralDataBufferDuration; /* Length of the buffer in time (ms) defined by the application */ |
| LVM_UINT8 *pSpectralDataBufferStart; /* Starting address of the buffer */ |
| LVM_UINT8 *pSpectralDataBufferWritePointer; /* Current position of the writting pointer of the buffer */ |
| LVPSA_Time SpectralDataBufferAudioTime; /* AudioTime at which the last value save occured in the buffer */ |
| LVM_UINT32 SpectralDataBufferLength; /* Number of spectrum data value that the buffer can contain (per band) |
| = SpectralDataBufferDuration/20ms */ |
| |
| LVM_UINT8 *pPreviousPeaks; /* Points to a nBands elements array that contains the previous peak value of the level |
| detection. Those values are decremented after each call to the GetSpectrum function */ |
| |
| }LVPSA_InstancePr_t, *pLVPSA_InstancePr_t; |
| |
| |
| |
| /********************************************************************************** |
| FUNCTIONS PROTOTYPE |
| ***********************************************************************************/ |
| /************************************************************************************/ |
| /* */ |
| /* FUNCTION: LVPSA_ApplyNewSettings */ |
| /* */ |
| /* DESCRIPTION: */ |
| /* Reinitialize some parameters and changes filters' coefficients if */ |
| /* some control parameters have changed. */ |
| /* */ |
| /* PARAMETERS: */ |
| /* pInst Pointer to the instance */ |
| /* */ |
| /* RETURNS: */ |
| /* LVPSA_OK Always succeeds */ |
| /* */ |
| /************************************************************************************/ |
| LVPSA_RETURN LVPSA_ApplyNewSettings (LVPSA_InstancePr_t *pInst); |
| |
| #ifdef __cplusplus |
| } |
| #endif /* __cplusplus */ |
| |
| #endif /* _LVPSA_PRIVATE_H */ |
