blinkt 0.1.2
Python library for driving Pimoroni Blinkt!
License: MIT
Keywords: Raspberry Pi LED

|Blinkt!| https://shop.pimoroni.com/products/blinkt

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 Blinkt! 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:

.. figure:: http://get.pimoroni.com/resources/github-repo-terminal.png
   :alt: Finding the terminal

In the new terminal window type the command exactly as it appears below
(check for typos) and follow the on-screen instructions:

.. code:: bash

    curl https://get.pimoroni.com/blinkt | bash

Alternatively, on Raspbian, you can download the ``pimoroni-dashboard``
and install your product by browsing to the relevant entry:

.. code:: bash

    sudo apt-get install pimoroni

(you will find the Dashboard under 'Accessories' too, in the Pi menu -
or just run ``pimoroni-dashboard`` at the command line)

If you choose to download examples you'll find them in
``/home/pi/Pimoroni/blinkt/``.

Manual install:
~~~~~~~~~~~~~~~

Library install for Python 3:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

on Raspbian:

.. code:: bash

    sudo apt-get install python3-blinkt

other environments:

.. code:: bash

    sudo pip3 install blinkt

Library install for Python 2:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

on Raspbian:

.. code:: bash

    sudo apt-get install python-blinkt

other environments:

.. code:: bash

    sudo pip2 install blinkt

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:

.. code:: bash

    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/blinkt
-  Function reference - http://docs.pimoroni.com/blinkt/
-  GPIO Pinout - https://pinout.xyz/pinout/blinkt
-  Get help - http://forums.pimoroni.com/c/support

Unofficial / Third-party libraries
----------------------------------

-  Golang library & examples by `Alex
   Ellis <https://www.alexellis.io>`__ -
   https://github.com/alexellis/blinkt\_go\_examples
-  Java library by Jim Darby - https://github.com/hackerjimbo/PiJava

.. |Blinkt!| image:: https://raw.githubusercontent.com/pimoroni/blinkt/master/blinkt-logo.png

0.1.2
-----

* BugFix: Added sleep to data output, see: https://github.com/pimoroni/blinkt/issues/62

0.1.1
-----

* New: Added `get_pixel` to return colour and brightness of a single pixel

0.1.0
-----

* Removed try/except from RPi.GPIO import, output was misleading at best
* Reverted default behaviour of clear on exit

0.0.9
-----

* Added set_all method to set all pixels
* Changed default behaviour of clear on exit to reduce module side-effects
* Move GPIO initialisation to show() to reduce module side-effects

0.0.8
-----

* Tweaked some methods to show intent as implementation detail only
* Added docstrings detailing public methods

0.0.7
-----

* Fixed bug with APA102 pixels that have a small, black die (vs the larger, paler one)

0.0.6
-----

* set_clear_on_exit now method

0.0.5
-----

* Range clamping and coercion to integers

0.0.4
-----

* Various bug fixes

0.0.3
-----

* Switch to Python

0.0.2
-----

* Bug fixes for C Library

0.0.1
-----

* Original C Library