fschrempf / py-neopixel-spidev

A Python module to interface addressable WS2812 (aka NeoPixel) LEDs via the SPIdev driver in Linux
MIT License
8 stars 1 forks source link
adafruit-neopixel linux neopixel py-neopixel-spidev spi spidev ws2812

Python NeoPixel SPIdev

The py-neopixel-spidev Python module can be used to control WS2812 addressable RGB LEDs via SPI on Linux devices using the generic Linux SPIdev driver.

Only the MOSI signal of the SPI bus is used to control the DIN of the chained LEDs. To emulate the protocol for the LEDs, each bit of LED data is made up of 4 SPI bits.

Dependencies

The following Python modules are needed:

Attributions

This module barely contains any new code, but mainly bundles code from existing projects for easier usage. Thanks to all the authors and contributors.

Adafruit CircuitPython Pypixelbuf

We reuse the Pixelbuf class from Adafruit CircuitPython Pypixelbuf.

File: lib/pixelbuf.py
License: MIT
Copyright: Copyright (c) 2019-2020 Roy Hooper
Authors: Damien P. George, Limor Fried, Scott Shawcroft, Roy Hooper

Adafruit CircuitPython NeoPixel

Further we use the NeoPixel class from Adafruit CircuitPython NeoPixel with some slight modifications to use the SPIdev bus as backend.

File: lib/neopixel_spidev.py
License: MIT
Copyright: Copyright (c) 2016 Damien P. George, Copyright (c) 2017 Scott Shawcroft for Adafruit Industries, Copyright (c) 2019 Carter Nelson, Copyright (c) 2019 Roy Hooper
Authors: Damien P. George, Scott Shawcroft, Carter Nelson, Roy Hooper

ws2812-spi

To emulate the protocol data, we use the code from the ws2812-spi project.

File: lib/neopixel_spi_write.py
License: AGPL
Author: joosteto

Usage

See the examples in examples/ and the docs for the Adafruit NeoPixel class.

Copyright

Copyright (c) 2020 Kontron Electronics GmbH
Author: Frieder Schrempf

License

The code is licensed under the MIT license, unless the source code files specify a different license.