apa102 0.0.3

Description:

apa102 0.0.3

APA102 Library




A simple library to drive APA102 pixels from the Raspberry Pi, or similar SBCs.
Uses either spidev or RPi.GPIO depending on the pins specified.
Pre-requisites
You must enable SPI:

spi: sudo raspi-config nonint do_spi 0

You can optionally run sudo raspi-config or the graphical Raspberry Pi Configuration UI to enable interfaces.
Installing
Stable library from PyPi:

Just run python3 -m pip install apa102

Latest/development library from GitHub:

git clone https://github.com/pimoroni/apa102-python
cd apa102-python
sudo ./install.sh

Usage
The APA102 class will attempt to use spidev or RPi.GPIO depending on which pins you specify.
For example; three RGB LEDs connected to SPI pins 10 and 11 with chip-select 8 (CE0):
from apa102 import APA102
lights = APA102(3, 10, 11, 8)

You can then set individual pixels with set_pixel:
lights.set_pixel(0, 255, 0, 0) # Pixel 1 to Red
lights.set_pixel(1, 0, 255, 0) # Pixel 2 to Green
lights.set_pixel(2, 0, 0, 255) # Pixel 3 to Blue

Pixels are zero-indexed and accept Red, Green and Blue colour values from 0 to 255.
Changelog
0.0.3

Support SPI with cs None and no_cs
Add support for inverted output (GPIO ONLY)
Fix colour order to BGR
Fix SOF, EOF and data lengths
Drop noisy debug print from SPI mode
Fix set_brightness so it doesn't break pixel SOF
Add spi_max_speed_hz parameter

0.0.2

Bugfixes and improvements

0.0.1

Initial Release