Important changes to repositories hosted on mbed.com
Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.
To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.
It is also possible to export all your personal repositories from the account settings page.
Dependencies: HSI2RGBW_PWM NVIC_set_all_priorities mbed-dsp mbed FastAnalogIn
You are viewing an older revision! See the latest version
Homepage
Spectrum Analyzer¶
Code ported from Tony DiCola at AdaFruit FFT: Fun with Fourier Transforms.
Modifications were made to allow the use of the KL25Z on-board RGB LED or an external RGBW power LED - see items marked with * in the next sections.
Main features¶
- Uses mbed-dsp library.
- Display the audio spectrum on a single RGB(W) LED*.
- Display the audio spectrum on your computer using an audio spectrogram tool (python script).
- Change parameters using a terminal connection : Sample rate, min/max db, slowdown*.
Information
Detailed information and download of the python scripts is available here.
KL25Z wiring¶
Audio inputs
The software reads 2 audio channels (left and right) and takes the average of both values = (left + right)/2.
Analog inputs : PTC2 and PTB3.
A DC offset, and possibly some amplification or attenuation, is needed before the signal is fed into the analog inputs.
The opamp choice is not critical, just make sure it supports single supply operation.
Schematic
External PWM outputs
| Pin | Color |
| PTD4 | Red |
| PTA12 | Green |
| PTA4 | Blue |
| PTA5 | White |
If you want to use an RGB LED, remove the last pin declaration (PTA5).
The conversion routine automatically switches from HSI/RGBW to HSI/RGB.
To use the external RGBW LED, enable following line in the code:
#define RGBW_ext // Disable this line when you want to use the KL25Z on-board RGB LED.
Commands¶
Parameters can be altered through the serial port Using a terminal program (eg : TeraTerm).
Communication settings : 38400 baud + local echo.
Each command needs to be terminated with a semicolon.
Use GET <command>; to read a parameter.
Use SET <command> <value>; to set a parameter.
| Command | Description |
| GET MAGNITUDES; | Reads back the FFT magnitudes. Number of magnitudes = PIXEL_COUNT. |
| GET SAMPLES; | Reads back the current samples. Number of samples = PIXEL_COUNT. |
| GET FFT_SIZE; | The size of the FFT. |
| GET SAMPLE_RATE_HZ; | Audio sample rate (Hz). |
| SET SAMPLE_RATE_HZ <value>; | Change the audio sample rate (see also 'Limitations' below). |
| GET LEDS_ENABLED; | LEDs enabled status. |
| SET LEDS_ENABLED <value>; | Control if the LED's should display the spectrum or not. 1 is true, 0 is false. |
| GET SPECTRUM_MIN_DB; | Audio intensity (in decibels) that maps to low LED brightness. |
| SET SPECTRUM_MIN_DB <value>; | Change low sensitivity (0...100dB). |
| GET SPECTRUM_MAX_DB; | Audio intensity (in decibels) that maps to high LED brightness. |
| SET SPECTRUM_MAX_DB <value>; | Change high sensitivity (0...100dB). |
| GET SLOWDOWN; | LED visualisation delay. |
| SET SLOWDOWN <value>; | * Useful to visualize the spectrum using a single RGB(W) LED. Without this command, the color values are shown too fast for the human eye. This allows you to slow down the visualization without interfering in the FFT conversion. Each frequency window is shown a little longer. The number of frequency windows depends on the value of the PIXEL_COUNT variable.[0...999] The larger the value, the longer each frequency window is shown - a good value is 16. [1000...1000 + PIXEL_COUNT] Selecting a value within this range allows us to lock to a specific frequency window. |
NOTE : PIXEL_COUNT is declared at compile time and determines the number of frequency windows (aka LED colors).
Limitations¶
The original code was written for a cortex-M4 processor.
For a cortex-M0 processor, following limitations apply:
Without the Spectrogram python script
| SAMPLE_RATE_HZ | FFT_SIZE |
| 1...9000 | up to 256 |
| 10000...40000 | max 16 |
With the Spectrogram python script
There is a time lag between the music and the screen output.
| SAMPLE_RATE_HZ | FFT_SIZE |
| max. 8000 | max. 16 |
Demo Videos¶
Parameter settings
| SLOWDOWN | 16 (initial value - changed to 1000+ during the video to demonstrate the lock option). |
| SAMPLE_RATE_HZ | 40000 |
| SPECTRUM_MIN_DB | 30.0 |
| SPECTRUM_MAX_DB | 60.0 |
| FFT_SIZE | 16 |
| PIXEL_COUNT | 8 |
Using the on-board RGB LED
SLOWDOWN is set to different values (normal mode and locked mode).
Using an external 10W RGBW LED
SLOWDOWN is set to different values (normal mode and locked mode).
Spectrogram on Computer screen (serial input from KL25Z board