Repository files navigation

Readthe blog postthat started it all.

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

See ademo. There is also anot-awful professional demoof the original, unmodified hardware.

• With your Arduino, Teensy, or pile of laundry lint that happens to contain anAtmel AVR ATmega, G35Arduino becomes a splice-in replacement for the stock G35controller. 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 namea few! Your spouse will know the difference!

• Easy to add your own programs. If you can make it through the Arduino Blinktutorial, you can probably write your own light program!

• Synchronizes multiple strings. Have them each run individual instances of thesame light program. Have them each run different programs, but withsynchronized program changes. Or combine as many strings as you want into asingle mondo gigantic virtual string! (Number of physical strings is limitedby the number of output pins on your microcontroller, as well as the memoryrequirements of the running light programs.)

• Express your individualism! G35Arduino operates completely independently ofrequests from Twitter, Facebook, SMS, XBee,neighbors, and drive-thru spectators. You bought 'em, you should get tocontrol what they do!

• Arduino 1.6 SDK. Earlier versions willwork, but installation is tedious.

• Any of the following: an Arduino or Arduino-compatible, aTeensy with Teensyduino or else flashed with anArduino Leonardo bootloader. Also a plain Atmel ATmega of some sort, if youknow what you're doing.

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

1. Download this project from GitHub as a ZIP file.

2. In your Arduino IDE, look for Sketch → Include Library → Add ZIPLibrary …, then select the ZIP file you just downloaded.

3. Look for the new G35Arduino submenu in your Examples menu.

4. Upload the BasicExample sketch to your Arduino. You should see the pin-13 LEDflicker as the sketch tries to send data to your lights.

5. Chop off the stock controller on your lights, being careful to note thefunction of the three leads from the first light (from left to right lookingat the first light pointing upward, they're V+, DATA, and GND).

6. Put V+ on the Arduino 5V pin, GND on the GND pin, and DATA on pin 13, andyour 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 power supply rated5V/1A from a Kodak Zi8. Your mileage may vary.

Source-code contributions are welcome. If you think you might contributeimprovements back to the project, git clone into libraries/ instead ofunzipping, and to avoid going insane, check the "external editor" option in theArduino IDE and use a text editor directly on the library source.

We try to follow Google's C++ coding standards: 2 spaces, no tabs, 80 columns,and follow the existing naming/capitalization conventions in the code.

• There's a fork of this project that I've heard puts my programs to shame.Check it out.

• Want to hack on the original G35 remote with your Arduino?There's a library for that.

• Paul Martis

• Robert Quattlebaum

• Scott Harris

• Mark Ortiz, with some of Mark's codeinspired byAdafruit

• Mike Tsao