File	Date	Author	Commit
examples	2014-09-06	farvardin	[215332] adding more examples
Adafruit_8x8.py	2014-09-06	farvardin	[4ba5a6] adding initial adafruit code
Adafruit_I2C.py	2014-09-06	farvardin	[4ba5a6] adding initial adafruit code
Adafruit_LEDBackpack.py	2014-09-06	farvardin	[4ba5a6] adding initial adafruit code
README.md	2014-09-06	farvardin	[215332] adding more examples
convert_animated_gif_to_matrix.sh	2014-09-06	farvardin	[721db9] fixed blinking animation
convert_image_to_matrix.sh	2014-09-06	farvardin	[721db9] fixed blinking animation
matrix8x8.png	2014-09-06	farvardin	[683240] adding sample images
readme.t2t	2014-09-06	farvardin	[215332] adding more examples

Read Me

%!target: md
%!options: --outfile README.md 


= Convert PNG image to Adafruit 8x8 board =

Those scripts will help you to easily create animations or images on Adafruit 8x8 boards. 

They are meant to be used on Raspberry Pi using Adafruit libraries.


== Installation ==

Requirements: imagemagick, bash, python, perl installed on your raspberry pi.

Read instructions for installing the Adafruit libraries:

- https://learn.adafruit.com/led-backpack-displays-on-raspberry-pi-and-beaglebone-black/overview
- https://github.com/adafruit/Adafruit-Raspberry-Pi-Python-Code/tree/master/Adafruit_LEDBackpack


Wire your 8x8 matrix to your raspberry pi:

- ``+`` is wired to GPIO 1 (3V3)
- ``-`` is wired to GPIO 6 (GND)
- ``C`` is wired to GPIO 5 (GP3)
- ``D`` is wired to GPIO 3 (GP2)


Get the code on your raspberry pi:

``` hg clone https://farvardin@bitbucket.org/farvardin/rpi_8x8_matrix_editor

Edit with Gimp or whatever image editor the ``matrix8x8.png`` (inside examples folder) to display a fixed image on your 8x8 matrix. 

Run ``sudo bash convert_image_to_matrix.sh examples/matrix8x8.png``.

Edit the ``matrix8x8_anim.gif`` (inside examples folder) to display an animation on your 8x8 matrix.
 

Run ``sudo bash convert_animated_gif_to_matrix.sh examples/matrix8x8_anim.gif``.

Enjoy!


== Licences ==


https://bitbucket.org/farvardin/rpi_8x8_matrix_editor/

   Copyright (c) 2014 Eric Forgeot. All rights reserved.


https://github.com/adafruit/Adafruit-Raspberry-Pi-Python-Code/tree/master/Adafruit_LEDBackpack

   Copyright (c) 2012-2013 Limor Fried, Kevin Townsend and Mikey Sklar for Adafruit Industries. All rights reserved.

----------------------------


Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

- Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 

- Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 

- Neither the name of the nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.