geled
=====

This project contains code to control an Arduino to drive multiple
strings of GE color effects lights in interesting ways.

The interesting components are as follows:
  led.pde   -   Code to run on the Arduino itself
  drive.c   -   Code to 'drive' the Arduino, using the
                serial port to pass simple messages
  libled.c  -   A library to simplify the process of
                setting pixels; it uses led.cfg to
                specify an x/y to string/addr mapping.
  ledsim.c  -   A library to to simulate libled so
                you can do development without a string of lights.
  war.c     -   A very simple 'space war' game for two
                that uses libled or ledsim.
               


Requirements
============

This project was written by a Debian Linux user and, as of this date,
has only every been run on a Debian Linux system. 

However, the code is fairly portable.  If you're clever and patient,
you can likely get it to work for you.

The bulk of the Arduino code is contained in led.pde.  That should
work in any Arduino environment, and should get you a running
driver on your Arduino.

You will need the drive command line utility.  Again, the Makefile
will build it on a Linux system, and maybe other Unix systems.

But it should be possible to compile it on any Unix (including Mac OS X)
fairly easily.  For Windows, it'll be harder; you'll have to manually
port the serial IO stuff.

On Debian, I have the following relevant packages:
  ii  arduino                              0018+dfsg-6                       AVR development board IDE and built-in libraries
  ii  avr-libc                             1:1.6.8-2                         Standard C library for Atmel AVR development
  ii  avrdude                              5.10-3                            software for programming Atmel AVR microcontrollers
  ii  binutils-avr                         2.20.1-1                          Binary utilities supporting Atmel's AVR targets
  ii  gcc-avr                              1:4.3.5-1                         The GNU C compiler (cross compiler for avr)
  ii  arduino                              0018+dfsg-6                       AVR development board IDE and built-in libraries
  ii  arduino-core   

I suspect an apt-get install arduino-core gcc-avr will get you all of those.
You also now will need libft-dev to get freetype dev libraries.

You need to download the contents of web/.gitignore from the internet
and drop them into the web/ subdirectory; that includes an Arduino
logo, jquery, and jquery-TextFill.

You need to download a 1.0 Arduino development environment, and make
a symbolic link in the top level directory named 'current-arduino'
that points to that directory.



Usage:
=====
This commmand:
  make && make upload
should result in compiling + uploading the program to the Arduino.

And
  ./drive init
  ./drive status
  ./drive chase

Will make the Arduino do interesting things.  Note that
  make reset
is also quite handy.