Python library for APA102 LEDs
Project description
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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
File details
Details for the file apa102-0.0.3.tar.gz
.
File metadata
- Download URL: apa102-0.0.3.tar.gz
- Upload date:
- Size: 4.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.7.3
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | ae73bdea26f027b57052ab990004ca8faa0f160d10bcacf5bd07e04769513cf9 |
|
MD5 | 92a06f0871b7d6bcdf449cec6876552e |
|
BLAKE2b-256 | 27531e423891e9e614ba37e05fab08aa83ba8c13128b36b49474dc72cf398e71 |
File details
Details for the file apa102-0.0.3-py3-none-any.whl
.
File metadata
- Download URL: apa102-0.0.3-py3-none-any.whl
- Upload date:
- Size: 4.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.7.3
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 16ed5c6100a46645ca08d31a04e0182f6b21f431b4ff54ed508f83cf51af6478 |
|
MD5 | f733b4f26777dd3a53514d44839f2c1b |
|
BLAKE2b-256 | 24baa8d7a68daba00e73c837dcf68f082a176b2f0afe0c24873c92f3634e4dd1 |
File details
Details for the file apa102-0.0.3-py2-none-any.whl
.
File metadata
- Download URL: apa102-0.0.3-py2-none-any.whl
- Upload date:
- Size: 4.3 kB
- Tags: Python 2
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.7.3
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | ee2833d4e161cfd47cc148be50a5d1855c345384a15b4bf592f6d0684c73930c |
|
MD5 | 6b7f6be80200711b7307bb2d552666e6 |
|
BLAKE2b-256 | 0629236dd9fd2145885d673fda0ba7a1ea4739014f398b9be1154f07ef78acd1 |