How joegould1878/spectrum_visualiser_lab works
Spectrum Visualiser is ESP32-S3 firmware that turns microphone samples into a 32×8 LED spectrum, with LOG/LINEAR modes, tone and signal-quality reporting, persistent settings, and button controls. Its principal workflow starts in main/main.c: audio frames are sampled and analysed, passed to the display task, and rendered on the MAX7219 matrix; a separate input task handles controls. Python tools parse firmware and bring-up logs for inspection. The README documents the signal-processing stages; sampled task code and the SOURCE INDEX support the specific task/component links shown. Unsampled internals are represented only where the README documents their role.
Main entry points: audio_task.c Audio Task · display_task.c Display Task · input_task.c Button Input · main.c Firmware Startup
Components 21
Application Tasks
- Firmware Startup
main/main.c - Settings
main/settings.c - Button Input
main/input_task.c - Audio Task
main/audio_task.c - Serial Debug
main/debug_stream.c - Debounced Buttons
components/button/button.c
Audio Analysis
- DMA ADC Sampling
components/adc_sampler/adc_sampler.c - FFT Processing
components/spectrum/spectrum.c - Band Mapping
components/band_map/band_map.c - Tone Finding
components/tone_finder/tone_finder.c
Display Output
- Display Task
main/display_task.c - Bar Model
components/bar_model/bar_model.c - Frame Graphics
components/frame_gfx/frame_gfx.c - MAX7219 Driver
components/max7219/max7219.c
Log Analysis
- Log Parser
tools/logparse.py - Raw Log Plots
tools/plot_raw.py - Frame Visualisation
tools/frames.py - Accuracy Plots
tools/plot_accuracy.py - Tone Statistics
tools/tone_stats.py - Rate Tables
tools/rate_table.py
Other components
- Operator
Connections 22
- Operator → Button Input: presses buttons
- Firmware Startup → Settings: loads settings
main/main.c - Firmware Startup → Display Task: starts display
main/main.c - Firmware Startup → Audio Task: starts audio
main/main.c - Firmware Startup → Button Input: starts input
main/main.c - Button Input → Debounced Buttons: reads presses
main/input_task.c - Button Input → Audio Task: controls listening
main/input_task.c - Button Input → Display Task: sets brightness
main/input_task.c - Audio Task → DMA ADC Sampling: reads samples
main/audio_task.c - Audio Task → FFT Processing: processes samples
main/audio_task.c - Audio Task → Band Mapping: maps bins
main/audio_task.c - Audio Task → Tone Finding: finds tone
main/audio_task.c - Audio Task → Serial Debug: emits telemetry
main/audio_task.c - Audio Task → Display Task: queues frames
- Display Task → Bar Model: models levels
main/display_task.c - Display Task → Frame Graphics: draws frame
main/display_task.c - Display Task → MAX7219 Driver: writes rows
main/display_task.c - Display Task → Serial Debug: emits display stats
main/display_task.c - Raw Log Plots → Log Parser: parses logs
tools/plot_raw.py - Frame Visualisation → Log Parser: parses logs
tools/frames.py - Tone Statistics → Log Parser: parses logs
tools/tone_stats.py - Rate Tables → Log Parser: parses logs
tools/rate_table.py