Overview
Interpolator combining an upsampler and an FIR filter
Discussion
The FIR interpolator module implements an upsampler (zero stuffer) followed by an FIR filter. An efficient polyphase algorithm is used which reduces the processing load. The module operates on multiple channels with all channels sharing the same set of filter coefficients. The filter coefficients are stored in the array, coeffs, in normal order. Each channel uses a circular buffer of length N/L, where N is the filter length and L is the interpolation factor.
...
The latency through the module in samples is displayed in the Audio Weaver Designer GUI. The underlying FIR processing occurs at the output sampling rate and the latency is the delay in samples at the higher sampling rate.
Type Definition
| Code Block |
|---|
typedef struct _ModuleFIRInterpolator
{
ModuleInstanceDescriptor instance; // Common Audio Weaver module instance structure
INT32 L; // Upsampling factor.
INT32 N; // Length of the filter.
INT32 polyphaseLen; // Length of each polyphase filter component.
INT32 stateIndex; // Index of the oldest state variable in the array of state variables.
INT32 stateLen; // Length of the circular state buffer.
FLOAT32* coeffs; // Filter coefficient array in normal order.
FLOAT32* state; // State variable array. The size of the array equals stateLen*numChannels.
void * hardware_specific_struct_pointer; // Usually NULL, but for optimizations that use 3rd party optimizations (like ne10), this may point to the required instance structure
} ModuleFIRInterpolatorClass; |
Variables
Properties
Name | Type | Usage | isHidden | Default value | Range | Units |
L | int | const | 0 | 2 | 2:1:512 | |
N | int | const | 0 | 32 | 1:1:5000 | samples |
polyphaseLen | int | const | 1 | 16 | Unrestricted | |
stateIndex | int | state | 1 | 0 | Unrestricted | |
stateLen | int | const | 1 | 16 | Unrestricted | |
coeffs | float* | parameter | 0 | [32 x 1] | Unrestricted | |
state | float* | state | 1 | [16 x 1] | Unrestricted | |
hardware_specific_struct_pointer | void * | state | 1 | Unrestricted |
Pins
Input Pins
Name: in
Description: audio input
...
Sample rate range: Unrestricted
Complex support: Real
Output Pins
Name: out
Description: audio output
Data type: float
MATLAB Usage
File Name: fir_interpolator_module.m
...