VolumeControlFract32

Overview

Volume control with Fletcher-Munson loudness compensation

Discussion

Volume control subsystem with built in loudness compensation. The system has one multichannel input pin and one multichannel output pin. Input and output pins must have the same dimensions. The System consists of a biquad_smoothed_module plus algorithms for dynamically adjusting the biquad coefficients. System has one interface variable: SYS.gain with a range of 0 to -90 dB. As gain is adjusted it is automatically translated to new target values for the biquad coefficients. The new coefficient values give 2 results: i.)Lower overall system volume by gain dB. ii.)Boost system bass according to Fletcher Munson nonlinear model. The center frequency for bass boost is specified by the constant SYS.centerFreq. .centerFreq is specified at instantiation time and be default equals 62. Hz. Theory of operation: 1.)At system creation a 5 coefficient biquad filter is created. The biquad frequency response is designed with a center frequency of SYS.centerFreq and a shape which closely fits Fletcher Munson difference curves. 2.)At system creation polynomial coefficients are calculated such that the polynomial: p(SYS.gain) will evaluate to the amount of bass boost in dB needed at SYS.centerFreq when overall system volume is cut by SYS.gain dB. 3.)When SYS.gain is changed p(SYS.gain) is evaluated. Two linear gains are then calculated: i.)passThruGain, (=undb20(SYS.gain)) and ii.)b which is equal to gain to be applied to the biquad. Desired system output = passThruGaindataIn + b(biquad output) (biquad output with dataIn for input).
4.)Intead of using a seperate biquad and mixer we dyanmically vary biquad coefficients so its transfer function implements the combined mixer biquad system described above. We need the original biquad numerator coefficients for calculation each time SYS.gain is varied thus we keep them in the constants: SYS.b0_LPF, SYS.b1_LPF, SYS.b2_LPF.

Module Pack

Standard

ClassID

classID = 214

Type Definition

typedef struct _ModuleVolumeControlFract32
{
ModuleInstanceDescriptor instance;            // Common Audio Weaver module instance structure
FLOAT32 gain;                                 // Gain through the volume control
FLOAT32 centerFreq;                           // Center frequency of the low frequency resonance
FLOAT32 c2;                                   // X^2 coefficient
FLOAT32 c1;                                   // X^1 coefficient
FLOAT32 c0;                                   // X^0 coefficient
FLOAT32 b0_LPF;                               // First numerator coefficient
FLOAT32 b1_LPF;                               // Second numerator coefficient
FLOAT32 b2_LPF;                               // Third numerator coefficient
awe_modBiquadSmoothedFract32Instance *mixerFilt; // 2nd order smoothly updating IIR filter} ModuleVolumeControlFract32Class;

Variables

Properties

Name	Type	Usage	Default Value	Range	Units
gain	float	parameter	0	-90:0.1:0	dB
centerFreq	float	const	62.5	30:120	Hz
c2	float	const	0.001904	Unrestricted
c1	float	const	-0.09575	Unrestricted
c0	float	const	-0.2614	Unrestricted
b0_LPF	float	const	0.004074	Unrestricted
b1_LPF	float	const	-6.224e-12	Unrestricted
b2_LPF	float	const	-0.004074	Unrestricted

Pins

Input Pins


Name	in
Description	Audio Input
Data type	fract32
Channel range	Unrestricted
Block size range	Unrestricted
Sample rate range	Unrestricted
Complex support	Real

Output Pins


Name	out
Description	Audio output
Data Type	fract32

Matlab Usage

File Name: volume_control_fract32_module.m 
 SYS=volume_control_fract32_module(NAME, CENTERFREQ) 
 Creates a volume control module with built-in loudness compensation. 
 This module can operate on multiple channels.  Arguments: 

   NAME - name of the module. 
   CENTERFREQ - frequency of the low frequency gain boost, in Hz. 
                By default equals 62.5 Hz.