ledtheatre

A simple application to control the Adafruit PCA9685 PWM control board.

It requires the Adafruit_PCA9685 library installed.

You can control up to 16 LEDs. Build a simple, fluent-style data object describing the changes to each LED intensity and how long the change takes, and set it running.

>>> # load the libraries and initialise
>>> import ledtheatre
>>> from Adafruit_PCA9685 import PCA9685
>>> ledtheatre.init(PCA9685())
>>>
>>> # Create a Sequence object
>>> sequence = ledtheatre.Sequence()
>>>
>>> # Optionally initialise the LEDs to off.
>>> sequence.led(range(0, 15), 0.0)
>>>
>>> # The add a half-second transition, setting
>>> #    LED#0 to fade up to 100% brightness, and
>>> #    LED#1 to fade up to target 50% brightness
>>> sequence.transition(0.5).led(0, 1.0).led(1, 0.5)
>>>
>>> # Add another transition, this time over 1 second
>>> #    LED#0 to fade completely out, and
>>> #    LED#1 to target 100% brightness
>>> sequence.transition(1.0).led(0, 0.0).led(1, 1.0)
>>>
>>> # Now pause (sleep) for one second)
>>> sequence.sleep(1.0)
>>>
>>> # the target method also takes lists of LEDs
>>> sequence.transition(2.0).led([0, 1], 0.5)
>>>
>>> # Set LEDs instantaneously
>>> sequence.snap().led(1, 0.0)
>>>
>>> # Chain any set of build commands fluently
>>> sequence.transition(1).led(0, 1).sleep(1).transition(1).led(0, 0)
>>>
>>> # And get those LEDs fading in and out!
>>> sequence.execute()

Installation

To install the library from source run the following commands on a Raspberry Pi or other Debian-based OS system:

sudo apt-get install git build-essential python-dev cd ~ git clone https://github.com/aalcock/ledtheatre cd ledtheatre sudo python setup.py install