Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
sowbug committed Dec 23, 2011
1 parent 0c9d1bf commit 0669c62
Showing 1 changed file with 24 additions and 37 deletions.
61 changes: 24 additions & 37 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,29 +1,24 @@
Introduction
============

Here's the blog post that started it all:
Read [the blog post](http://www.deepdarc.com/2010/11/27/hacking-christmas-lights/)
that started it all.

http://www.deepdarc.com/2010/11/27/hacking-christmas-lights/
This library makes it easy to replace the controller in GE Color Effects Christmas lights with an Arduino, and to run much better light programs. If you can program C or Processing, it's pretty easy to make new programs, too!

This library makes it easy to replace the controller in these lights
with an Arduino, and to run much better light programs. If you can
program C or Processing, it's pretty easy to make new programs, too!

See a demo at http://www.youtube.com/watch?v=QyKt7tHV-EM. There is also
a not-awful professional demo of the original, unmodified hardware at
http://www.geholidaylighting.com/holiday-lighting/led/color-effects.
See a [demo](http://www.youtube.com/watch?v=QyKt7tHV-EM). There is also a [not-awful professional demo](http://www.geholidaylighting.com/holiday-lighting/led/color-effects) of the original, unmodified hardware.

Features
========

- With your Arduino, Teensy, or pile of laundry lint that happens to
contain an Atmel AVR ATMega of some kind, G35Arduino becomes a
contain an Atmel AVR ATmega, G35Arduino becomes a
splice-in replacement for the stock G35 controller. Contains versions
of the same programs that ship with the lights. Your spouse won't know
the difference!

- Also contains custom programs: Inchworm, Orbit, Cylon, Meteorite,
just to name a few!
just to name a few! Your spouse will know the difference!

- Easy to add your own programs. If you can make it through the Arduino
Blink tutorial, you can probably write your own light program!
Expand All @@ -37,43 +32,35 @@ Features
light programs.)

- Express your individualism! G35Arduino operates completely
independently of requests from Twitter, Facebook, SMS, XBee, neighbors,
independently of [requests from Twitter](http://www.cheerlights.com/), Facebook, SMS, XBee, neighbors,
and drive-thru spectators. You bought 'em, you should get to control
what they do!

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

- Arduino 1.0 SDK. This code is not compatible with pre-1.0 Arduino.
- [Arduino 1.0 SDK](http://arduino.cc/en/Main/Software). This code is not compatible with pre-1.0 Arduino.

- Any of the following: an Arduino or Arduino-compatible, a Teensy
with Teensyduino or else flashed with an Arduino Leonardo bootloader.
Also a plain Atmel ATMega of some sort, if you know what you're
doing.
- Any of the following: an Arduino or Arduino-compatible, a [Teensy](http://www.pjrc.com/) with Teensyduino or else flashed with an Arduino Leonardo bootloader. Also a plain Atmel ATmega of some sort, if you know what you're doing.

- At least one working strand of GE G-35 Color Effects Christmas lights
that you are willing to slice up and solder back together again.
- At least one working strand of GE G-35 Color Effects Christmas lights that you are willing to slice up and solder back together again.

Installation
============

Find your Arduino IDE's libraries directory. Then unzip the project
archive into it. It should end up looking like this:
1. Find your Arduino IDE's sketches directory.

1. If there isn't already one, create a `libraries` directory inside the sketches directory.

1. Unzip the project archive into `libraries`. It should end up looking like this: `[Your Arduino sketches directory]/libraries/G35Arduino/G35.h (etc.)`

1. Restart your Arduino IDE and you should see G35Arduino among the libraries.

[Your Arduino documents directory]/
libraries/
G35Arduino/
G35.h (etc.)
1. Upload the BasicExample sketch to your Arduino. You should see the pin-13 LED flicker as the sketch tries to send data to your lights.

Then restart your Arduino IDE and you should see G35Arduino among
the libraries.
1. Chop off the stock controller on your lights, being careful to note the function of the three leads from the first light (from left to right looking at the first light pointing upward, they're V+, DATA, and GND).

Upload the BasicExample sketch to your Arduino. You should see the
pin-13 LED flicker. Chop off the stock controller on your lights,
being careful to note the function of the three leads from the first
light (from left to right looking at the first light pointing upward,
they're V+, DATA, and GND). Put V+ on the Arduino 5V pin, GND on the
GND pin, and DATA on pin 13, and your lights should come back to life!
1. Put V+ on the Arduino 5V pin, GND on the GND pin, and DATA on pin 13, and your lights should come back to life!

I've been happily running two strands on my house directly off the
Arduino (i.e., not using the stock power transformer) with an old USB
Expand All @@ -94,10 +81,10 @@ code.
Credits
=======

- Paul Martis: http://www.digitalmisery.com
- [Paul Martis](http://www.digitalmisery.com)

- Robert Quattlebaum: http://www.deepdarc.com/2010/11/27/hacking-christmas-lights
- [Robert Quattlebaum](http://www.deepdarc.com/2010/11/27/hacking-christmas-lights)

- Scott Harris: http://scottrharris.blogspot.com/2010/12/controlling-ge-color-effects-lights.html
- [Scott Harris](http://scottrharris.blogspot.com/2010/12/controlling-ge-color-effects-lights.html)

- Mike Tsao: http://github.com/sowbug
- [Mike Tsao](http://github.com/sowbug)

0 comments on commit 0669c62

Please sign in to comment.