Skip to main content

Python library for APA102 LEDs

Project description

APA102 Library

Build Status Coverage Status PyPi Package Python Versions

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

apa102-0.0.3.tar.gz (4.5 kB view details)

Uploaded Source

Built Distributions

apa102-0.0.3-py3-none-any.whl (4.3 kB view details)

Uploaded Python 3

apa102-0.0.3-py2-none-any.whl (4.3 kB view details)

Uploaded Python 2

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

Hashes for apa102-0.0.3.tar.gz
Algorithm Hash digest
SHA256 ae73bdea26f027b57052ab990004ca8faa0f160d10bcacf5bd07e04769513cf9
MD5 92a06f0871b7d6bcdf449cec6876552e
BLAKE2b-256 27531e423891e9e614ba37e05fab08aa83ba8c13128b36b49474dc72cf398e71

See more details on using hashes here.

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

Hashes for apa102-0.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 16ed5c6100a46645ca08d31a04e0182f6b21f431b4ff54ed508f83cf51af6478
MD5 f733b4f26777dd3a53514d44839f2c1b
BLAKE2b-256 24baa8d7a68daba00e73c837dcf68f082a176b2f0afe0c24873c92f3634e4dd1

See more details on using hashes here.

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

Hashes for apa102-0.0.3-py2-none-any.whl
Algorithm Hash digest
SHA256 ee2833d4e161cfd47cc148be50a5d1855c345384a15b4bf592f6d0684c73930c
MD5 6b7f6be80200711b7307bb2d552666e6
BLAKE2b-256 0629236dd9fd2145885d673fda0ba7a1ea4739014f398b9be1154f07ef78acd1

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page