Namespaces
namespace	anonymous_namespace{audio.cpp.hpp}

namespace	detector

namespace	fft

namespace	TeensyI2S

Classes
class	AudioManager

class	AutoGain
	AutoGain implements adaptive gain control using a PI (proportional-integral) controller with slow peak envelope tracking, inspired by WLED Sound Reactive. More...

struct	AutoGainConfig
	Configuration for automatic gain control. More...

struct	BandEnergy

struct	BeatDetectors

class	Config

struct	ConfigI2S

struct	ConfigPdm

class	Context

struct	Data

class	Detector

class	FrequencyBinMapper
	FrequencyBinMapper maps FFT output bins to perceptually-spaced frequency channels. More...

struct	FrequencyBinMapperConfig
	Configuration for frequency bin mapping. More...

class	IInput

class	ISynthEngine
	Interface for synth engine that holds BLEP/BLAMP tables. More...

class	ISynthOscillator
	Interface class for synth oscillator. More...

struct	MicResponseCurve

class	NoiseFloorTracker
	NoiseFloorTracker maintains an adaptive estimate of the background noise floor for audio signals, with hysteresis to prevent "noise chasing" where the floor continuously adjusts to the signal level. More...

struct	NoiseFloorTrackerConfig
	Configuration for noise floor tracking. More...

class	PerceptualWeighting

class	Processor

class	Reactive

struct	ReactiveConfig

class	Sample

class	SampleImpl

class	SignalConditioner
	SignalConditioner performs low-level audio preprocessing to clean raw PCM samples before FFT analysis or beat detection. More...

struct	SignalConditionerConfig
	Configuration for signal conditioning pipeline. More...

class	SilenceEnvelope

class	SoundLevelMeter

class	SpectralEqualizer
	SpectralEqualizer applies frequency-dependent gain correction to address mid-frequency dominance and provide perceptual weighting of audio spectra. More...

struct	SpectralEqualizerConfig
	Configuration for spectral equalizer. More...

class	SpectralFluxDetector

class	SynthEngineImpl

class	SynthOscillatorImpl

struct	SynthParams
	Waveform parameters for custom waveforms. More...

Enumerations
enum class	AGCPreset { AGCPreset_Normal , AGCPreset_Vivid , AGCPreset_Lazy , AGCPreset_Custom }
	AGC preset selection — derived from WLED Sound Reactive's proven approach. More...

enum class	AudioChannel { Left = 0 , Right = 1 , Both = 2 }

enum class	EqualizationCurve { Flat , AWeighting , Custom }
	Equalization curve type. More...

enum class	FrequencyBinMode { Bins16 = 16 , Bins32 = 32 }
	Frequency bin mode - controls number of output bins. More...

enum class	I2SCommFormat { Philips = 0X01 , MSB = 0X02 , PCMShort = 0x04 , PCMLong = 0x0C , Max = 0x0F }

enum class	MicProfile : u8 { None , INMP441 , ICS43434 , SPM1423 , GenericMEMS , LineIn }
	Microphone frequency response correction profile. More...

enum class	SynthShape { Sawtooth , Square , Triangle , AlternatingSaw , Custom }
	Predefined waveform shapes for synth oscillator. More...

Functions
static float	clamp01 (float v)

static float	clampNeg1To1 (float v)

float	computeAudioDt (fl::size pcmSize, int sampleRate) FL_NOEXCEPT
	Compute the time delta (in seconds) for an audio buffer.

float	computePinkNoiseGain (float freq_hz, float f_ref)
	Compute pink noise compensation gain for a single frequency.

void	computePinkNoiseGains (const float binCenters, int numBins, float out)
	Compute pink noise compensation gains for all bins.

void	downsampleMicResponse (const MicResponseCurve &curve, const float binCenters, int numBins, float out)
	Downsample a high-resolution mic response curve to N output bins.

	FASTLED_SHARED_PTR (ISynthEngine)

	FASTLED_SHARED_PTR (ISynthOscillator)

	FASTLED_SHARED_PTR (SampleImpl)

float	fl_progmem_read_float (const float *addr)
	Read a float from PROGMEM.

MicResponseCurve	getMicResponseCurve (MicProfile profile)
	Get the high-resolution response curve for a given mic profile.

float	interpolateMicResponse (const MicResponseCurve &curve, float freq_hz)
	Interpolate mic response at an arbitrary frequency (Hz).

FL_LINK_WEAK fl::shared_ptr< IInput >	platform_create_audio_input (const Config &config, fl::string *error_message)

Variables
static const float	kMicResponse_GenericMEMS [kMicResponsePoints]

static const float	kMicResponse_ICS43434 [kMicResponsePoints]

static const float	kMicResponse_INMP441 [kMicResponsePoints]

static const float	kMicResponse_LineIn [kMicResponsePoints]

static const float	kMicResponse_SPM1423 [kMicResponsePoints]

static const float	kMicResponseFreqs [kMicResponsePoints]

static constexpr int	kMicResponsePoints = 61

Controls how quickly the peak tracker forgets old peaks. Longer = more stable.

AGCPreset preset = AGCPreset::AGCPreset_Normal AGC behavior preset (default: Normal) float targetRMSLevel = 8000.0f Target RMS level after gain (0-32767) The AGC will adjust gain to maintain this average level.

Class Members
float	bass = 0.0f
float	mid = 0.0f
float	treb = 0.0f

Class Members
bool	bassBeatDetected = false
float	bassEnergy = 0.0f
bool	beatDetected = false
float	dominantFrequency = 0.0f
float	frequencyBins[16] = {0}
float	magnitude = 0.0f
bool	midBeatDetected = false
float	midEnergy = 0.0f
float	peak = 0.0f
float	spectralFlux = 0.0f
u32	timestamp = 0
bool	trebleBeatDetected = false
float	trebleEnergy = 0.0f
float	volume = 0.0f
float	volumeRaw = 0.0f

Class Members
u32	fftBinCount = 256	Number of FFT bins available from FFT output For 512-sample FFT at 22050 Hz: 256 bins (512/2)
float	maxFrequency = 16000.0f	Maximum frequency (Hz) - default 16000 Hz (treble)
float	minFrequency = 20.0f	Minimum frequency (Hz) - default 20 Hz (bass)
FrequencyBinMode	mode = FrequencyBinMode::Bins16	Number of output frequency bins (16 or 32)
u32	sampleRate = 22050	Sample rate (Hz) - must match FFT sample rate.
bool	useLogSpacing = true	Use logarithmic spacing (recommended for audio) Logarithmic spacing provides better bass/mid/treble separation.

Class Members
int	count	Number of data points.
const float *	freqs	Pointer to frequency array (PROGMEM)
const float *	gains	Pointer to gain array (PROGMEM)

Class Members
float	attackRate = 0.001f	Attack rate for noise floor (0.0-1.0) How quickly the floor rises when signal is consistently low.
float	crossDomainWeight = 0.3f	Cross-domain calibration weight (0.0-1.0) Blends time-domain RMS and frequency-domain energy for floor estimation 0.0 = use only time-domain, 1.0 = use only frequency-domain.
float	decayRate = 0.99f	Decay rate for noise floor (0.0-1.0) Higher = slower decay (more stable, less responsive) Lower = faster decay (more responsive, less stable)
bool	enabled = true	Enable noise floor tracking.
float	hysteresisMargin = 100.0f	Hysteresis margin (prevents noise chasing) Floor must drop by this amount before it can rise again.
float	maxFloor = 5000.0f	Maximum floor value (prevents floor from growing unbounded)
float	minFloor = 10.0f	Minimum floor value (prevents floor from going to zero)

Class Members
u8	attack = 50
float	bassThreshold = 0.15f
u8	decay = 200
bool	enableLogBinSpacing = true
bool	enableMultiBand = true
bool	enableMultiBandBeats = false
bool	enableMusicalBeatDetection = false
bool	enableNoiseFloorTracking = true
bool	enableSignalConditioning = true
bool	enableSpectralEqualizer = false
bool	enableSpectralFlux = true
u8	gain = 128
float	midThreshold = 0.12f
float	musicalBeatConfidence = 0.5f
float	musicalBeatMaxBPM = 180.0f
float	musicalBeatMinBPM = 60.0f
bool	noiseGate = true
u16	sampleRate = 22050
u8	scalingMode = 3
u8	sensitivity = 128
float	spectralFluxThreshold = 0.1f
float	trebleThreshold = 0.08f

Class Members
bool	enableDCRemoval = true	Enable DC offset removal (running average high-pass filter)
bool	enableNoiseGate = true	Enable noise gate with hysteresis.
bool	enableSpikeFilter = true	Enable spike filtering for I2S glitches.
i16	noiseGateCloseThreshold = 300	Noise gate close threshold (signal must fall below to close gate)
i16	noiseGateOpenThreshold = 500	Noise gate open threshold (signal must exceed to open gate)
i16	spikeThreshold = 10000	Spike detection threshold (absolute value) Samples beyond ±spikeThreshold are rejected as glitches.

Class Members
bool	applyMakeupGain = false	Apply makeup gain to compensate for overall level changes If true, automatically adjusts overall gain to maintain average level.
float	compressionRatio = 2.0f	Compression ratio (1.0 = no compression, higher = more compression) 2.0 = 2:1 ratio, 4.0 = 4:1 ratio, etc.
float	compressionThreshold = 0.7f	Compression threshold (0.0-1.0) Signals above this level are compressed.
EqualizationCurve	curve = EqualizationCurve::Flat	Equalization curve type.
vector< float >	customGains	Custom per-band gain multipliers (only used if curve = Custom) Size must match numBands. Default: all 1.0 (no eq)
bool	enableCompression = false	Enable dynamic range compression per band Compresses loud signals to reduce dynamic range.
float	makeupGainTarget = 0.5f	Makeup gain target level (0.0-1.0) The equalizer will scale output to maintain this average level.
size	numBands = 16	Number of frequency bands (must match FrequencyBinMapper output)

Enumerator
AGCPreset_Normal	Balanced: 3.3s peak decay, moderate PI gains.
AGCPreset_Vivid	Faster response: 1.3s peak decay, higher PI gains.
AGCPreset_Lazy	Slower, more stable: 6.7s peak decay, lower PI gains.
AGCPreset_Custom	Use custom PI tuning fields below.

Enumerator
None	No correction (flat response assumed)
INMP441	InvenSense INMP441 MEMS mic (most common)
ICS43434	InvenSense ICS-43434 MEMS mic.
SPM1423	Knowles SPM1423 MEMS mic.
GenericMEMS	Generic MEMS microphone (moderate bass rolloff)
LineIn	Line-in input (relatively flat, minor HF rolloff)

freq_hz	Bin center frequency in Hz
f_ref	Reference frequency (typically geometric mean of all bins)

binCenters	Array of bin center frequencies (Hz)
numBins	Number of bins
out	Output array of gains (length numBins)

curve	The source mic response curve
binCenters	Array of bin center frequencies (Hz), length numBins
numBins	Number of output bins
out	Output array of gains, length numBins

fl::shared_ptr< IInput > fl::audio::platform_create_audio_input	(	const Config &	config,
		fl::string *	error_message )

Namespaces

Classes

Enumerations

Functions

Variables

◆ fl::audio::BandEnergy

◆ fl::audio::Data

◆ fl::audio::FrequencyBinMapperConfig

◆ fl::audio::MicResponseCurve

◆ fl::audio::NoiseFloorTrackerConfig

◆ fl::audio::ReactiveConfig

◆ fl::audio::SignalConditionerConfig

◆ fl::audio::SpectralEqualizerConfig

Enumeration Type Documentation

◆ AGCPreset

◆ AudioChannel

◆ EqualizationCurve

◆ FrequencyBinMode

◆ I2SCommFormat

◆ MicProfile

◆ SynthShape

Function Documentation

◆ clamp01()

◆ clampNeg1To1()

◆ computeAudioDt()

◆ computePinkNoiseGain()

◆ computePinkNoiseGains()

◆ downsampleMicResponse()

◆ FASTLED_SHARED_PTR() [1/3]

◆ FASTLED_SHARED_PTR() [2/3]

◆ FASTLED_SHARED_PTR() [3/3]

◆ fl_progmem_read_float()

◆ getMicResponseCurve()

◆ interpolateMicResponse()

◆ platform_create_audio_input()

Variable Documentation

◆ kMicResponse_GenericMEMS

◆ kMicResponse_ICS43434

◆ kMicResponse_INMP441

◆ kMicResponse_LineIn

◆ kMicResponse_SPM1423

◆ kMicResponseFreqs

◆ kMicResponsePoints