Difference between revisions of "S18: Audio Spectrum Analyzer with Graphics Display"

Revision as of 19:21, 23 May 2018

Audio Spectrum Analyzer with Graphics Display

Abstract

This project is going to use an RGB LED matrix to display graphics based on dynamic MP3 audio frequencies. An MP3 audio decoder board will be used to connect to one of the SJOne board with MP3 files in its SD card to decode audio and send to graphic equalizer. The user will be able to see graphics on the RGB LED matrix instantly while playing MP3 files, and have some control buttons to modify the music such as pause, resume, skip, the matrix's display screen, modes, and rotation with different orientation.

Objectives & Introduction

Introduction

Our team split the project into four different parts: The audio decoder, the audio analyzer, the RGB LED Matrix, and the PCB design. Thus, two of our team members split the hardware and the software parts, some they worked together, some they worked individually. The other team member wanted to work on the PCB design and software and hardware of the LED matrix, he provided essential contribution to make audio analyzer working and try to work on other parts. The Equalizer part focuses on the conversion of audio input into an ADC output that can be parsed and create a data representation for the RGB LED Matrix. The RGB LED Matrix part is mainly focus on parsing the converted data and drive the RGB LEDs to display the dynamic frequencies of the signals.

Objectives

Follow proper engineering and testing practices to design and implement the following:

• Design equalizer PCB
• Interfacing audio decoder pin layout and system design
• Interfacing audio equalizer pin layout and system design
• Interfacing RGB LED matrix pin layout and system design
• Implement audio decoder driver
• Implement audio equalizer driver
• Implement RGB LED matrix driver
• Integrate equalizer and RGB LED matrix

• Test overall system and program
• Preparing whole project hardware design as a demo ready package

Team Members & Responsibilities

• Lorenzo Javier
  • Audio Decoder Interfacing w/ SJOne Board (MP3 Driver)
  • Graphic Equalizer Interfacing w/ Audio Decoder (Pin Layout/System Design)
  • RGB LED Matrix Initialization Interfacing w/ SJOne Board (RGB LED Driver)
  • Record, Edit, and Post the Demo Video on YouTube

• Jason Lin
  • Graphic Equalizer Interfacing w/ SJOne Board (Audio Analyzer Driver)
  • RGB LED Matrix Light Show Algorithm & Initialization Interfacing w/ SJOne Board (RGB LED Driver)
  • Extra/Additional Functionalities (MP3 pause, resume, and skip / display modes, accelerometer direction/rotation, splash/pause/skip screen, and entertainment bar/dot and spinning)
  • Design and Implement the Display Shadow Box (Containing All Components)

• Bohan Liu
  • PCB Design
  • Design the basic schema for the Audio Decode Chip
  • Adding surrounding component to MSGEQ7 chip and make it connectable to other components
  • Tested the connections of the basic schema
  • Generate the connected PCB board layout
  • Wired the PCB board layout

Schedule

Parts List & Cost

Design & Implementation

This section will provide an overview of our design methodology for the MP3 audio decoder, audio analyzer graphic equalizer, and RGB LED matrix independently, and then will describe the integration of all components.

Hardware Design

Figure 1. Overall Schematic of Pin Connections

MP3 Audio Decoder

Adafruit VS1053 MP3 Audio Decoder Breakout Board

The VS1053 MP3 audio decoder breakout board connects to the SJOne board through the SPI protocol (MOSI, MISO, SCLK, XDCS) for sending/receiving data.

The other pins DREQ, XCS, SDCS, and RST are connected to the SJOne board pins as GPIO functionality.

The AGND, LOUT, and ROUT pins are split out between the 3.5mm stereo headphone jack and the audio analyzer breakout board.

Here is a description of the pin functionalities as follows:

• XCS -> a chip select pin for SCI operation (to control settings, i.e. volume)
• XDCS -> a chip select pin for SDI operation (to enable data transfer)
• RST -> a reset pin to perform a hard reset of previous data/settings
• DREQ -> a status pin to notify when the buffer is ready to receive more data (busy = 0, ready = 1)
• SDCS -> a chip select pin for enabling/disabling the MicroSD card slot
• AGND -> a common ground pin
• LOUT -> the analog left audio data pin
• ROUT -> the analog right audio data pin

The remaining pins are VCC (5V), and GND (Ground).

Graphic Equalizer

DFROBOT Audio Analyzer Schematic

DFROBOT Audio Analyzer (MSGEQ7) Graphic Equalizer Breakout Board

The Audio Analyzer breakout board features the MSGEQ7 graphic equalizer display filter. It splits the analog audio input into seven different frequency bands. The seven frequencies measured are as follows: 63Hz, 160Hz, 400Hz, 1kHz, 2.5kHz, 6.25kHz and 16kHz. It connects to the SJOne board through the ADC (ANALOG) protocol for reading the values of seven frequencies.

The other pins, RESET and STROBE, are connected to the SJOne board pins as GPIO functionality.

Here is a description of the pin functionalities as follows:

• ANALOG-> a chip select pin for Output analog signal (for ADC on SJOne board to read)
• RESET -> a chip select pin for Input GPIO signal (to get reset signal from SJOne GPIO)
• STROBE-> a chip select pin for Input GPIO signal (to be precisely controlled to read the analog outputs properly)

The remaining pins are VCC (5V), and GND (Ground).

RGB LED Matrix

Adafruit 16x32 RGB LED Matrix

The 16x32 RGB LED Matrix features as a display panel. It has two IDC connectors INPUT and OUTPUT on the back to connect multiple panels, but we only use one on this project. Its RGB data is separate in 1 and 2, 1 represent the upper half of the matrix, 2 represent the lower half. This matrix has a decoder which takes ABC as input to decode the corresponding row on both upper and lower half of the panel. Every color pin has a 32-bit shift register. With the clock single implement with the shift register, we can control every column of LED's color on each row.

The Latch signal is for indicate the end of the data line. It connects to the SJOne board through pins (R1, G1, B1, R2, G2, B2, A, B, C, CLK, LAT, OE) as GPIO functionality.

Here is a description of the pin functionalities as follows:

• R1 -> a chip select pin for Input GPIO signal (to control upper panel's R data)
• G1 -> a chip select pin for Input GPIO signal (to control upper panel's G data)
• B1 -> a chip select pin for Input GPIO signal (to control upper panel's B data)
• R2 -> a chip select pin for Input GPIO signal (to control lower panel's R data)
• G2 -> a chip select pin for Input GPIO signal (to control lower panel's G data)
• B2 -> a chip select pin for Input GPIO signal (to control lower panel's B data)
• A -> a chip select pin for Input GPIO signal (to select both upper and lower panel's row bit 2)
• B -> a chip select pin for Input GPIO signal (to select both upper and lower panel's row bit 1)
• C -> a chip select pin for Input GPIO signal (to select both upper and lower panel's row bit 0)
• CLK -> a chip select pin for Input GPIO signal (to get clock signal from SJOne board)
• LAT -> a chip select pin for Input GPIO signal (to get latch signal from SJOne GPIO)
• OE -> a chip select pin for Input GPIO signal (Output enable to cascade LED matrix)

The remaining pins are VCC (5V), and four GND (Ground).

Hardware Interface

This section briefly describes some of the hardware communication protocols between the various master/slave devices. Most of the information here is repeated from the previous Hardware Design section.

MP3 Audio Decoder

The audio decoder was driven by the several pins mentioned in Figure 1 from the Hardware Design section. It's main interface is SPI, which is great for transferring large amounts of bytes within a short amount of time. This is especially useful for live audio streaming, otherwise there would be many glitches, or a slow down of audio playback.

The SJOne's audio decoder driver included opening & reading the .mp3 files that were loaded onto the microSD card, which was inserted into the microSD card slot on the SJOne board, not the audio decoder board.

Graphic Equalizer

The audio analyzer was driven by the several pins mentioned in the Hardware Design section. It's main interface was GPIO, which was used to reset the analog signals coming in. The other main interface was the analog audio input from the left and right audio pins, coming from the audio decoder.

RGB LED Matrix

The RGB LED matrix was driven by the several pins mentioned in the Hardware Design section. It's main interface was GPIO, which was used for every single pin including CLOCK (besides GND).

There were sets of GPIO's which controlled the top half and bottom half of the matrix. Each top and bottom half had it's own Red, Green, and Blue GPIO connections for controlling the color of each individual LED.

The other important GPIO pins were for the LATCH, CLOCK, and OUTPUT ENABLE. The LATCH was used to set each rows' LED color data after it was loaded into its register. The CLOCK was manually controlled by a GPIO to ensure that the SJOne board could have enough time to send all the RGB signals.

Software Design

The following diagram shows how two of our tasks are being integrated. The Matrix task reads the analog values from the Equalizer and use them to do an algorithm and display on the LED Matrix. The analog input values are converted to digital using the SJOne board ADC. The converted values are then sent to the queue which the LED Matrix task is listening.

Figure 2. Integrated Software Diagram

MP3 Audio Decoder

The below code snippet contains part of the MP3 audio driver from the SJOne. This while loop will constantly transfer data to the audio decoder's buffer via the SPI protocol, and will sit idle until the audio decoder sends a status signal saying it's ready for more data.

while(1)
{
   while(!mp3Ready())
   {
       if(need_data == true)
       {
           if(FR_OK != file_read)
           {
                file_close; //ERROR: Could not read mp3 file or no data left to read
           }
           need_data = false;
        }
   }
   if(need_data == true)
   {
       if(FR_OK != file_read)
       {
           file_close; //ERROR: Could not read mp3 file or no data left to read
       }
       need_data = false;
   }
   if(xSemaphoreTake(xMutex, portMAX_DELAY))
   {
       enable XDCS;
       for(y < sizeof mp3DataBuffer)
       {
            transfer(mp3DataBuffer[y]);
       }
            disable XDCS;
            xSemaphoreGive(xMutex);
   }
   need_data = true;
   if(bytesRead == 0) break;
}
while(!mp3Ready());
disable XDCS;
file_close;

Graphic Equalizer

The diagram below shows how the MSGEQ7 chip outputting the analog signals. The software needs GPIO pins to generate the strobe signal and reset signal. The strobe signal needs to be precisely controlled in order to read the analog values properly.

Strobe Timing Diagram

for(i<7)
{
    clear_pin(STROBE);
    current time = system get uptime  + 36;
    while(ystem get uptime < current time){}
    values[i] = read_pin_value;
    set_pin(STROBE);
    current time = system get uptime  + 36;
    while(ystem get uptime < current time){}
}

RGB LED Matrix

The below code snippet is from the RGB LED matrix driver of the SJOne. The conditions below are comparing the several spectrum frequencies that were divided by the audio analyzer board, and sent back to the SJOne. Depending on those values, the color and height of the matrix array will be set respectively.

Light show algorithm

It uses the ADC values to determine which row should be lit up, and which columns to be lit up. The light up function is separated into two different functions since the upper panel and the lower panel is read different color data from SJOne board. It also save the intensity of light from 0 - 15 for dropping entertainment algorithm to use.

Dropping Entertainment Algorithm

It uses the intensity of light from light show algorithm. In mode one, it will create a dropping bar that will be push up to row of the highest most recent values, and drop a little as time pass. In mode two, it will drag the existing lights row up to the highest most recent values. The different between mode one is that every column has its own counter, so the dropping speed can be vary for each column, which make them look like 32 different signal bands.

for(row < 8)
{
    disable OE;
    set row;
    if(convert)   rowset = ...;
    else          rowset = ...;

    for(col < 32)
    {
        if(colset<5)       freq=audio.values[6];    //63Hz
        else if(colset<10) freq=audio.values[5];    //160Hz
        else if(colset<14) freq=audio.values[4];    //400Hz
        else if(colset<18) freq=audio.values[3];    //1Khz
        else if(colset<22) freq=audio.values[2];    //2.5Khz
        else if(colset<27) freq=audio.values[1];    //6.25Khz
        else               freq=audio.values[0];    //16Khz

        //---- do Matrix Light Show Algorithm ----
        if(freq<496){}
        else if(freq>=496 && freq <736){set color on row <1}
        else if(freq>=736 && freq <976){set color on row <2}
        else if(freq>=976 && freq <1216){set color on row <3}
        else if(freq>=1216 && freq <1456){set color on row <4}
        else if(freq>=1456 && freq <1696){set color on row <5}
        else if(freq>=1696 && freq <1936){set color on row <6}
        else if(freq>=1936 && freq <2176){set color on row <7}
        else if(freq>=2176 && freq <2416){set color on row <8}
        else if(freq>=2416 && freq <2656){set color on row <9}
        else if(freq>=2656 && freq <2896){set color on row <10}
        else if(freq>=2896 && freq <3136){set color on row <11}
        else if(freq>=3136 && freq <3376){set color on row <12}
        else if(freq>=3376 && freq <3616){set color on row <13}
        else if(freq>=3616 && freq <3856){set color on row <14}
        else if(freq>=3856 && freq <4095){set color on row <15}
        else if(freq==4095){set color on every row}

        //---- do Dropping Entertainment Algorithm ----
        //dropping bars
        if(rowset == top[colset] && top[colset] >= 0)
        {
             set_color_bottom(dropping);
             if(count%10 == 0) top[colset]--;
             if(convert_i)   count++;
        }
        else if(rowset == top[colset]-8 && top[colset] > 0)
        {
             set_color_top(dropping);
             if(count%10 == 0) top[colset]--;
             if(convert_i)   count++;
        }
        //dropping dots
        if(convert_i)
        {
            if(rowset < top[colset]-8)
            {
                 set_color_top(m_matrixBuffer[row+8-convert_i*(2*row+1)][colset]);
            }
            if (rowset < top[colset])
            {
                 set_color_bottom(m_matrixBuffer[row+convert_i*(15-2*row)][colset]);
            }
        }
        clockTick();
    }
    latchReset();
    enableOE();
    vTaskDelay(1);
}

Implementation

It is like in the Integrated Software Diagram in the SoftwareDesign section.

For Aduio Decoder Task, it will wait the input 1 & 3 signal go high to start open the MP3 file. After that, if input 1 goes low, will back to song list and skip to next song. To implement pause function, if input 2 goes low, the task will stay in a while loop until input 2 goes high again. And semaphore will task the MP3 data out out the buffer as long as the buffer isn't empty. If the buffer goes empty, will go back to song list and play the next song.

For RGB LED Matrix Task, It will keep reading the acceleration and display splash screen with the orientation at first until any switch is being pushed. Then, the task will set Output signal 1 & 3 to high to active the Audio Decoder Task. After that, it goes i a while loop that read acceleration and if any switch is pushed. If switch 1 is pushed, then display mode change. If switch 2 is pushed, then toggle Output 2 signal and goes into pause screen. If switch 3 is pushed, then set Output 1 signal as low to skip song. If switch 4 is pushed, then display the splash screen. After reading all those functions, task will read the ADC values and use them to do the algorithm and convert to LED matrix representation and dropping entertainment.

PCB Design

N/A

Testing & Technical Challenges

In this section, we review the testing procedures used to test the audio decoder, equalizer, RGB LED matrix. We also go over some of the technical challenges we experienced while doing this project and how we resolve those issues.

MP3 Audio Decoder Challenges

Testing

We tested the audio decoder by loading .mp3 files onto a microSD card in the root directory, and then inserting it into the microSD card slot of the SJOne board. After writing the driver to read the microSD card and communicate between the MP3 audio decoder and the SJOne, we were able to hear audio through the audio jack. We tested multiple external audio devices, such as headphones, keychain speakers, and a large portable speaker to ensure the audio quality was consistent.

Pin Connections Challenge

The issue was that the MOSI and MISO connections were switched up. It took a while to see that these pins were connected incorrectly, but after some double checking, we made sure that the MOSI->MOSI pins and MISO<-MISO pins were properly attached to each other.

Graphic Equalizer Challenges

Testing

Because the MSGEQ7 chip is very sensitive to noise, we need to find out the lowest frequency it will read for every band. Even if there is no input, the MSGEQ7 chip can still read a small amount of values.

Reading the ADC values

In order to read the ADC values properly, generate the strobe with precise timing is required. If the timing isn't precise, the whole date of the frequency values will be messed up.

Online Tone Generator Output: 63Hz

Online Tone Generator Output: 160Hz

Online Tone Generator Output: 400Hz

RGB LED Matrix Challenges

Testing

We test the RBG LED Matrix by creating a two-dimensional array to match up with all the LED on the matrix panel, so we can light up a specified LED and set with a specific color to it.

Matrix Array Controlling

The issue we had was trying to control one LED at a time in the matrix array. For example, following the pattern (row, column), the first LED index is (0, 0), and the last LED index is (15, 31). It didn't help that the LED matrix is split into two, meaning that row 0 and 8, 1 and 9,..... 7 and 15, were both enabled at the same time. The buffers had to be precisely enabled with a certain color at the same time the next clock cycle came.

Display Algorithm in LED Matrix

Finding a good algorithm to display properly took us a lot of time since we have a function which is using the acceleration sensor on SJOne board to rotate the entire RGB LED matrix display with all other functions. That increase the difficulty to display.

Color Variety

Due to the fact that the CPU Clock speed of the SJOne board isn't fast enough to let us smoothly control the RGB pins other than GPIO, so we can only set the LED's color in seven different colors.

Conclusion

Conclude your project here. You can recap your testing and problems. You should address the "so what" part here to indicate what you ultimately learnt from this project. How has this project increased your knowledge?

Project Video

• Youtube Video Link
• Google Drive Video Link

Project Source Code

• Audio Spectrum Analyzer with Graphics Display Source Code Link

References

Acknowledgement

Any acknowledgement that you may wish to provide can be included here.

References Used

• VS1053 Datasheet
• MSGEQ7 Datasheet
• RGB LED Matrix Tutorial
• Amazon FreeRTOS API FreeRTOS API (original)

Appendix

• Tone Generator