Python library for driving Pimoroni Plasma!
Project description
https://shop.pimoroni.com/products/plasma
Eight super-bright RGB LED indicators, ideal for adding visual notifications to your Raspberry Pi on their own or on a pHAT stacking header.
Installing
Full install (recommended):
We’ve created an easy installation script that will install all pre-requisites and get your Plasma Arcade Button Lights up and running with minimal efforts. To run it, fire up Terminal which you’ll find in Menu -> Accessories -> Terminal on your Raspberry Pi desktop, as illustrated below:
In the new terminal window type the command exactly as it appears below (check for typos) and follow the on-screen instructions:
curl https://get.pimoroni.com/plasma | bash
If you choose to download examples you’ll find them in /home/pi/Pimoroni/plasma/.
Manual install:
Library install for Python 3:
on Raspbian:
sudo apt-get install python3-plasmalights
other environments:
sudo pip3 install plasmalights
Library install for Python 2:
on Raspbian:
sudo apt-get install python-plasmalights
other environments:
sudo pip2 install plasmalights
Using Plasma
Plasma installs two programs onto your Raspberry Pi. plasma itself and a tool called plasmactl you can use to install and switch lighting effects. Plasma runs as a service on your system.
plasmactl commands:
- plasmactl 255 0 0 - Set Plasma lights to R, G, B colour. Red in this case.
- plasmactl <pattern> - Set Plasma lights to pattern image
- plasmactl fps <fps> - Change plasma effect framerate (default is 30, lower FPS = less CPU)
- plasmactl --list - List all available patterns
- sudo plasmactl --install <pattern> - Install a new pattern, where <pattern> is the filename of a 24bit PNG image file
Development:
If you want to contribute, or like living on the edge of your seat by having the latest code, you should clone this repository, cd to the library directory, and run:
sudo python3 setup.py install
(or sudo python setup.py install whichever your primary Python environment may be)
Documentation & Support
- Guides and tutorials - https://learn.pimoroni.com/plasma
- Function reference - http://docs.pimoroni.com/plasma/
- Get help - http://forums.pimoroni.com/c/support
1.0.0
- API refactor, use plasma.legacy for old API
- USB support for Picade Player X
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.
Filename, size | File type | Python version | Upload date | Hashes |
---|---|---|---|---|
Filename, size plasmalights-1.0.0-py2-none-any.whl (8.0 kB) | File type Wheel | Python version py2 | Upload date | Hashes View |
Filename, size plasmalights-1.0.0-py3-none-any.whl (8.0 kB) | File type Wheel | Python version py3 | Upload date | Hashes View |
Hashes for plasmalights-1.0.0-py2-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1450229ca5dd44bb81bd464a31574307a04bb01c890054ec38e05871f39ed6cd |
|
MD5 | 5de44f8c51fc9306bfd180fb96b60b68 |
|
BLAKE2-256 | 3eaa4568bd9641190131d129912a127e5a9678614f84da922e7138250efae668 |
Hashes for plasmalights-1.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1cdbc08c5254c1556fd027fca939814b63c920fade2455611afd44efa5d1dbb8 |
|
MD5 | 9f6e239aade70ee488ed4991e693e9c3 |
|
BLAKE2-256 | 9c4bbe7e78ad34f6a2b2e07463ef18f8c4a7d0c6120086ad8f1fb604839582c1 |