Skip to main content

Python library for APA102 LEDs

Project description

# APA102 Library

[![Build Status](https://travis-ci.com/pimoroni/apa102-python.svg?branch=master)](https://travis-ci.com/pimoroni/apa102-python) [![Coverage Status](https://coveralls.io/repos/github/pimoroni/apa102-python/badge.svg?branch=master)](https://coveralls.io/github/pimoroni/apa102-python?branch=master) [![PyPi Package](https://img.shields.io/pypi/v/apa102.svg)](https://pypi.python.org/pypi/apa102) [![Python Versions](https://img.shields.io/pypi/pyversions/apa102.svg)](https://pypi.python.org/pypi/apa102)

# 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):

`python 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.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.1.tar.gz (4.1 kB view hashes)

Uploaded Source

Built Distributions

apa102-0.0.1-py3-none-any.whl (4.0 kB view hashes)

Uploaded Python 3

apa102-0.0.1-py2-none-any.whl (4.8 kB view hashes)

Uploaded Python 2

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