pi-led-control enables you to control a single color RGB led strip attached to the GPIO pins of a raspberry pi running pi-blaster (https://github.com/sarfata/pi-blaster) with a webinterface.

pi-led-control is implemented as python webserver and a webui using jquery and bootstrap. It provides several programs (scheduled and configurable) to control a single color LED strip.

If you have a single color LED strip you need to connect it to your raspberry pi and setup pi-blaster. You can find a very basic tutorial to connect a LED strip to your pi under https://github.com/s0riak/pi-led-control/blob/master/hardware/hardware.md Please follow the instruction in https://github.com/sarfata/pi-blaster to setup pi-blaster.

In case imports fail, all can be installed with pip3.

If you don't have a single color LED strip, you can use https://github.com/s0riak/pi-blaster-mock to mock it.

To start pi-led-control execute:

main.py [-h] [-n NAME] [-p PORT] [-c CONFIGPATH] [-l LOGPATH] [-fl {0,10,20,30,40,50}] [-cl {0,10,20,30,40,50}] [-atc ACCESSLOGTOCONSOLE]

optional arguments:

-h, --help show this help message and exit

-n NAME, --name NAME the hostname on which pi-led-control is served

-p PORT, --port PORT the port on which pi-led-control is served

-c CONFIGPATH, --configPath CONFIGPATH the path to the config file to be used

-l LOGPATH, --logPath LOGPATH the path to the log folder to be used

-fl {0,10,20,30,40,50}, --fileLogLevel {0,10,20,30,40,50} the log level for the logfile

-cl {0,10,20,30,40,50}, --consoleLogLevel {0,10,20,30,40,50} the log level for the console

-atc ACCESSLOGTOCONSOLE, --accessLogToConsole ACCESSLOGTOCONSOLE set to True to print access log entries to console

The server is started locally and the UI can be accessed on http://localhost:9000 or the port specified.

pi-led-control creates two log files:

0. piledcontrol.log - logging all relevant information on state changes and errors to a rotating logfile (1 per day, keeping those of last week) and stdout
1. piledcontrol_access.log - logging all requests and http error handled by pi-led-control to a rotating logfile (same rotation as for main log) and to stdout if ACCESSLOGTOCONSOLE is true

Several programs are available to control the LED strip:

0. 'Soft Off' to power off the LED strip smoothly (duration based on hue)
1. 'Off' to power off the LED strip immediately
2. 'Scheduled Off' to power off the LED strip after a given time in minutes (floats using '.' accepted for seconds are also accepted)
3. 'Full White' to power on all channel, resulting in maximum brightness
4. 'Feed' a configurable red light
5. 'Color Loop' a looping program rotating through the user defined colors
6. 'Wheel' a looping program smoothly switching from red to green to blue to red and so on
7. 'Sunrise' a program smooth illuminating the LED, simulating a sunrise
8. 'Freak' a program showing a new random color indefinitely at a userdefined pace
9. 'Random Path' a program smoothly switching between 'the' userdefined colors (from 'Color'-program) indefinitely at a userdefined pace
10. 'Color' a program with user selected color from a set of userdefined colors
11. 'Free Color' a program with a color the user can freely choose using three sliders for red, green, blue

The list of programs available in the ledui is about the same but naming is different but printed in the CLI program

The current color of the LED strip (as far as known to pi-led-control) is shown in the top right corner.

If crossbar (http://crossbar.io) is available it is utilized to push status updates from the server to the client via websockets. If crossbar is not installed the client falls back to polling.

To install crossbar use:

sudo pip3 install crossbar

This might fail on the pi due to libffi-dev and libssl-dev not being installed. In this case install them via apt-get

To set the time of a sunrise(-program) the localtime system time is used. Thus the timezone must be configured correctly, to wake at the expected time:

sudo dpkg-reconfigure tzdata

Add the following to your root crontab to autostart pi-blaster at start up of your system

@reboot /home/pi/pi-blaster-master/pi-blaster

Add the following to your user crontab to autostart pi-led-control at start up of your system

@reboot python3 /home/pi/pi-led-control/src/main.py

Flic Buttons (https://flic.io/) can be easily integrated, to do so follow the steps at https://github.com/50ButtonsEach/fliclib-linux-hci to setup the server for the buttons and pair them.

To setup the integration start the flic binary and: ./flic-integrator.py

This will toogle between the programs "feed" and "softOff" on any button down. To start both at startup, add the following to your root crontab:

@reboot /bin/sleep 5 ; /home/pi/fliclib-linux-hci/bin/armv6l/flicd -f /home/pi/flic.sqlite3

and the follwing to your user crontab:

@reboot /bin/sleep 6 ; python3 /home/pi/pi-led-control/src/flicintegration/flicintegrator.py

The sleep is needed to wait for the HCI to come up after system boot. To avoid interference with the standard bluetooth service, disable it:

sudo update-rc.d bluetooth disable

After that when everything (flicserver, flic-integrator and ledserver) is running and flic-buttons are paired with the flicserver (can be done with the simpleClient provided by flic) you use the button for the following:

0. Single Click - If the state is 'off the Feedprogram is started, if state is 'on' the softoff program
1. Double Click - The Full White program is started
2. Hold - The following programs are rotated with every hold: randomPath, 4colorloop, wheel, freak

pi-led-control is currently only tested on Ubuntu 15.10 and Raspbian GNU/Linux 8 (jessie).

pi-led-control is licensed under GPL and makes use of the following work:

0. bootstrap (https://github.com/twbs/bootstrap) licensed under the MIT License
1. jquery (https://github.com/jquery/jquery) licensed under the given license
2. IcoMoon-Free fonts (https://github.com/Keyamoon/IcoMoon-Free) licensed under the given CC BY 4.0 and GPL
3. bootstraptoggle (http://www.bootstraptoggle.com/) licensed under the MIT Licence
4. autobahn-js (https://github.com/crossbario/autobahn-js) licensed under the MIT Licence

pi-led-control can make use of crossbar.io for bidirectional communication 0. crossbar.io (http://crossbar.io/autobahn/) licensed under GNU Affero General Public License v3.0