A 9-encoder (un-official) add on to the ETC Eos Family of Lighting Consoles and Software, using OSC over USB.
This is an independent project that is designed to work with the ETC Eos, but not affiliated with Electronic Theatre Controls in any way.
To build the hardware, consult the README located in the Hardware folder.\ To make changes to the firmware, consult the README located in the Firmware folder.
The Encoders consist of the following components:
The three RGB LEDs on the right-hand side of the provide some basic functionality feedback:
The four page select buttons allow the user to choose the group of parameters they wish to adjust:
The two circular buttons on the right hand side are currently not used and reserved for future use.
The encoders will not work on any Win XPe-based consoles. It should work on any Win 7e-based Eos consoles, as well as any version of the ETCnomad software that supports OSC-over-USB. See the ETC Lighthack GitHub page:
Eos supports this functionality on Win7e-based consoles and ETCnomad for Windows in software version 2.6.1 and newer, and on ETCnomad for Mac in software version 2.7.0 and newer.
Support for XPe-based consoles or XP computers is not planned for this project. Many XPe-based consoles can be upgraded to Win7e to make them compatible with #lighthack.
As the Lighthack project was intended for the Arduino Uno (and this project uses a Teensy 3.2), the USB Vendor ID and Product ID had to be spoofed so the encoder board looks like an Arduino instead of a Teensy. Eos consoles will ignore OSC messages from USB devices that do not have the Arduino Uno Vendor ID and Product ID.
Contributions are most welcome! Please log an issue and/or pull request for any bugs or feature changes you may wish to share.
ETC LightHack which formed the basis and initial inspiration for this project
All hardware files (inside Hardware
) and original source code (inside Firmware/src
) uses the Apache 2.0 license. See LICENSE for more information.
Libraries inside Firmare/lib
and Firmware/core
have been licensed separately by their respective authors and include a mixture of BSD, MIT, public domain, LGPLv2 and other licenses. More information on each can be found in the relevant source files.