Node.js server and user interface to control WS2801 RGB LED strips via SPI. Built to control wolk.bike, a two-person bicycle sound system cloud commissioned by Welcome to the Village 2015.
wolkd can display mathematical functions, frame-by-frame animations (and even animated GIFs!) on RGB LED strips, and can be controlled via a web interface — with your laptop, smartphone or tablet. wolkd lets you write animations in terms of either a pixel's LED strip index or x and y coordinates using a mapping file. And wolkd has a 256 color ANSI terminal debug mode!
wolkd works well in conjunction with LED Strip Mapper.
See http://wolk.bike for more photos!
git clone https://github.com/bertspaan/wolkd.git
cd wolkd
npm install
If your device has an SPI interface (Raspberry Pis have one!), you can install spi-device:
npm install spi-device
Please note: without spi-device, wolkd will run in console mode!
wolkd expects the environment variable WOLKD_CONFIG to point to the path of the wolkd configuration JSON file.
cp wolkd.example.config.json ~/wolkd.config.json
export WOLKD_CONFIG=/home/wolk/wolkd.config.json
wolkd's configuration and command line arguments are described in detail below.
To run wolkd, type:
node index.js
When running wolkd on your laptop and/or in console mode, the RGB LED output is mapped to the terminal:
After starting wolkd, a web interface to control wolkd and mix patterns is available on http://localhost:3000:
wolkd supports two kinds of patterns:
- Functions: functions are executed every frame for each active pattern
- Frames: frames are hard-coded arrays of pixel colors.
Function:
module.exports = {
title: 'Function',
getPixel: function(beat, t, i, x, y) {
// beat: beat number
// t: frame number
// i: pixel index
// x: x coordinate of pixel, according to mapping
// y: y coordinate of pixel, according to mapping
return [r, g, b];
}
};Frames:
module.exports = {
title: 'Frames',
frames: [
[
[0, 0, 0], // Frame 1, pixel 1
[255, 0, 0], // Frame 1, pixel 2
...
],
[
[0, 255, 0], // Frame 2, pixel 1
[255, 255, 0], // Frame 2, pixel 2
...
],
]
};TODO: animated GIFs!
Each frame, wolkd outputs its pixel data to a screen. Currently, wolkd has two screens available: spi and console.
It's easy to add your own screens, by creating a JavaScript file in the screens directory.
exports.setPixel = function(pixel, r, g, b) {
// Set RGB color of individual indexed pixel in buffer
}
exports.update = function update() {
// Send buffer to screen, called each frame
}wolkd uses a JSON mapping file to convert a pixel's LED strip index to its x and y coordinates (between 0 and 1). You can use LED Strip Mapper to generate such patterns from an SVG file.
You can find wolkd's mappings in the mappings directory
Autopilot is very smart and can create beautiful random patterns!
{
"pixels": 100, // Number of pixels on LED strip
"framerate": 30, // Framerate wolkd tries to achieve
"bpm": 120, // Default BPM
"framesPerBeat": 16, // Frames per beat - constant if BPM changes
"spi": {
"device": "/dev/spidev0.0" // SPI device
},
"autopilot": {
"enabled": true, // Enable/disable [autopilot](#autopilot)
"inputTimeout": 120000, // Time in milliseconds before autopilot starts
// after user input
"patternTimeout": 60000 // Time after which autopilot changes patterns
},
"mapping": "st-bree", // Default [mapping file](#mappings)
"screen": "spi", // Default [screen](#screens)
"hostname": "wolkd.local", // Used by web interface
"websocket": {
"port": 8080 // Used by web interface
},
"http": {
"port": 3000 // Used by web interface
}
}You can override some of the options set in the configuration file with the following command line arguments:
| Argument | Example | Description |
|---|---|---|
--screen <screen> |
--screen console |
Choose screen |
--mapping <mapping> |
--mapping wolk |
Choose mapping file |
| `--autopilot <true | false>` | --autopilot false |
Instructions for installing wolkd on a Raspberry Pi:
- Installation: http://raspberrypi.stackexchange.com/questions/15192/installing-raspbian-from-noobs-without-display
- WiFi: https://www.raspberrypi.org/documentation/configuration/wireless/wireless-cli.md
- Run
sudo raspi-config- Enable SPI
- Set locale
- Set hostname to
wolk
- Add user
wolk: https://www.raspberrypi.org/documentation/linux/usage/users.mdsudo adduser wolksudo usermod -a -G sudo,audio,video,users,netdev,input,spi,i2c,gpio wolk
- Login with user wolk, clone wolkd:
git clone https://github.com/bertspaan/wolkd.git - Install Node.js: http://weworkweplay.com/play/raspberry-pi-nodejs/
- Install screen:
sudo apt-get install screen - Install nginx: https://www.raspberrypi.org/documentation/remote-access/web-server/nginx.md
- Add the following to the file
/etc/nginx/sites-available/wolkd
WS2801 LEDs LED: green: DAT -> MOSI -> PIN #19) -> 10 aan linker kant (usb onder) yellow: CLK -> SCKL -> (PIN #23) -> 12 aan linker kant (usb onder)
https://docs.microsoft.com/en-us/windows/iot-core/media/pinmappingsrpi/rp2_pinout.png
server {
listen 80;
server_name wolk.local;
location / {
proxy_pass http://localhost:3000/;
}
}
sudo ln -s /etc/nginx/sites-available/wolkd /etc/nginx/sites-enabled && sudo service nginx restart- Create wolkd daemon: http://www.slidequest.com/Taboca/70ang:
sudo npm install -g foreversudo cp ./daemon/wolkd /etc/init.d/wolkdsudo chmod 755 /etc/init.d/wolkdsudo update-rc.d wolkd defaults
- Language files/config for user interface
- In UI, sliders should change when wolkd changes patterns/modifiers
- Frame animations with configurable speed
- Patterns either continuous (each frame) or per beat
- Create programs, combinations of patterns that work well together
- Add colors or images to buttons in user interface
- Add modifiers which change hue/color through time
- FFT audio analysis and beat detection using microphone
- Add Open Pixel Control support
- Send output to Fadecandy Controller board
- Add websocket screen and HTML Canvas viewer