is a programming language that's especially convenient for creating multimedia art. If you don't already have it installed, head to the Processing.org web site
and download it.
On Mac OS X, the .zip file you download will have a Processing
application inside it. You can drag that to your Applications folder or anywhere else you like. On Windows, the .zip file will contain a folder. You can drag that folder anywhere you like.
If you get stuck or you'd like more information about getting started with Processing, take a look at the Getting Started tutorial for Processing
When you're finished, you should be able to run Processing and get a window like this one:
Great! Now for the next thing we'll need: The Fadecandy software. You can download this from the releases page on GitHub
. The link you want is the "Source code (zip)". This package contains both the source code and the binaries you'll need for this tutorial.
The specific release we're using here is Fadecandy 01
This will be another .zip file. When you extract it, you'll see a lot of things. This package contains everything related to the Fadecandy project, including things like the source code for the board's firmware, and CAD files for the circuit board layout. You can ignore most of its contents for now. There are two things we'll need from this download:
- The Fadecandy Server (fcserver) program, in the bin directory
- Processing examples, in the examples directory
First, run the fcserver
program. This program runs in the background and connects your Processing sketches with the Fadecandy Controller board. It also has a simple web interface you can use to test your LEDs.
- On Mac OS, double-click the fcserver-osx file in bin
- On Windows, double-click fcserver.exe in bin
This program will run in a Terminal window. If all is well, you should get a message like "Server listening on 127.0.0.1:7890
". This tells you it's ready to accept connections from other programs on your computer.
What is fcserver
listening for? Three things, actually:
- Programs using the Open Pixel Control protocol to talk to your LEDs
- Browser-based programs using WebSockets to talk to your LEDs
- Web browsers requesting an HTML-based user interface
Let's try out the browser interface. Now that fcserver
is running, you can navigate your web browser to http://localhost:7890
. You should see a page like this one:
If you plug in a Fadecandy Controller board, it should show up in the Connected Devices
section. No need to reload the web page.
The bottom section shows you how the server is configured. This isn't really important unless you have special requirements or you're using multiple Fadecandy Controller boards, but you can read more about this in the Fadecandy server configuration
That's all the software you need for this tutorial. Now for some wiring!