Difference between revisions of "ECE597 Project Music Visualizer"
m |
m (→User Instructions) |
||
Line 82: | Line 82: | ||
Enable PRU and LEDscape service | Enable PRU and LEDscape service | ||
bone$: '''cd musicvisualizer''' | bone$: '''cd musicvisualizer''' | ||
− | bone$: '''./setup''' | + | bone$: '''./setup.sh''' |
Run visualizer | Run visualizer |
Revision as of 16:06, 19 November 2014
Embedded Linux Class by Mark A. Yoder
Team members: Zhihao Xue, Ying Ying Zhou
Contents
Grading Template
I'm using the following template to grade. Each slot is 10 points. 0 = Missing, 5=OK, 10=Wow!
00 Executive Summary 00 Installation Instructions 00 User Instructions 00 Highlights 00 Theory of Operation 00 Work Breakdown 00 Future Work 00 Conclusions 00 Demo 00 Late Comments: I'm looking forward to seeing this. Score: 10/100
(Inline Comment)
Executive Summary
This project is a music visualizer implemented on a 10x10 LED matrix controlled by Beaglebone Black, where a pattern that corresponds to the spectrum of a wav file is displayed on the LED. We are able to compute the spectrum of slices of the given wavefile, convert the spectrum to a 10 by 10 matrix, and display the spectrum on the LED matrix. Currently, the LEDs updates every 0.1 second. Depending on the size of the file, it may take a long time (about 1 minute for a 7M wav file) to parse the file. Once the file is loaded, the software will play the wav file and synchronize it with the LED display. Adjustments can be made to change the design of the display pattern, and how often the screen is updated.
Packaging
The LED matrix is a 3-pin device that connects directly to the beaglebone.
Installation Instructions
Hardware
These are a bit lean. You need more details. For example. The display has three wires, where do I attach the other two? Use Fritzing to create a wiring diagram.
Connect 10x10 Neopixel LED matrix to P9_22 on Beaglebone
Connect USB sound card to Beagle
Connect Beagle to host computer
The sound card we using is CREATIVE SOUND BLASTER X-FI GO! PRO
Software
It's LEDscape, you've spelled it at least two other ways!
Download and install LEDscape from git repository
bone$: git clone https://github.com/Yona-Appletree/LEDscape.git
Please following the instruction under LEDscape repo to install LEDsacpe and disable HDMI ports
Download and install scipy and numpy package
bone$: sudo apt-get update bone$: sudo apt-get install python-numpy python-scipy python-matplotlib ipython ipython-notebook python-pandas python-sympy python-nose bone$: sudo apt-get install build-essential bone$: pip install cython bone$: git clone git://github.com/numpy/numpy.git numpy bone$: cd numpy bone$: python setup.py build bone$: python setup.py install --prefix=$HOME/local
After installing LEDscapte, scipy and numpy packages, get the project git repo
bone$: git clone https://github.com/xHa0z/musicvisualizer.git
Then make USB sound card as default output
bone$: cd musicvisualize bone$: cp asoundrc ~/.asoundrc
User Instructions
Enable PRU and LEDscape service
bone$: cd musicvisualizer bone$: ./setup.sh
Run visualizer
bone$: python final.py
Highlights
Here is our YouTube video
https://www.youtube.com/watch?v=gEa0vO2T--I
Theory of Operation
The software reads a wave file, and obtains the amplitude and the sampling frequency. The amplitude is sliced into 0.1 second segments, and fast Fourier transform is performed on each fragment to obtain the spectrum. For each spectrum, the frequency component is divided into ten columns where the amplitude is average, and the amplitude information is then normalized to a value between 0 to 10. This 10x10 matrix is displayed on the LED matrix using open pixel control.
The sound and display component of the software runs simultaneously so that the display is synchronized with the sound.
Work Breakdown
Major tasks 1. Install and test LEDscape; drive the LED matrix using default test programs in LEDscape. -Zhihao
2. Install and test open pixel control; make a custom pattern in open pixel control and display it on the LED matrix. -Ying Ying
3. Read a wav file, compute its spectrum, and map it to a 10x10 matrix. -Ying Ying
4. Display the spectrum using open pixel control. -Zhihao
5. Play wav file and synchronize sound with display. -Zhihao
6. Test other sound files. -Ying Ying
Future Work
Currently we only have one pattern for the spectrum (which displays red, blue, green, and white). More complicated design patterns could be implemented to explore the capabilities of LEDscape(fading, color changing, etc). Minor adjustments could be made to the software to make it more versatile, and work more smoothly. Some issues we currently have are with the size of the input file (only works if size of original file is divisible by 4), and the display can be delayed depending on the input file.
Conclusions
We have implemented a music visualizer using Beaglebone Black, by displaying the spectrum of a given wav file on a 10x10 LED matrix.
Although the original scope was to make a music visualizer that displays a pattern for a given sound file, to make the project more interactive, a recording element could be added, and the spectrum could be updated in real time. Another expansion of the project is to stack several LED matrices, add a third variable, and create a 3-D music visualizer.
Embedded Linux Class by Mark A. Yoder