====== EOS Integration ======

CueCam is designed exclusively to work with the ETC Eos lighting consoles (including ETCnomad). It has been tested with the ETC Element and ETC Eos range of consoles as well as ETCnomad software on both Mac and Windows. 

It uses standard OSC commands that are officially supported by ETC, and well documented, so should work with any version of ETC Eos that supports them over TCP SLIP 1.1

Eos supports different forms of OSC;

  * **Third-Party OSC (TCP Port 3037)** - CueCam uses this for the main cue information, you cannot change the port. Note that Eos currently does not send messages from Magic Sheets or Macros using ''Send_String'' over Third-Party OSC, which is why an additional port is required. 
  * **TCP SLIP 1.1 OSC** - CueCam uses this to provide remote control and features like [[Markers]] via [[OSC Commands]]. This must be configured in Eos Show Control on a port of your choice, and the same port entered into CueCam
  * **UDP OSC** - CueCam //cannot// use UDP OSC for cue information, but it can be used to receive [[OSC Commands]] although this is really intended for using devices other than the Eos console. For Eos, we recommend using SLIP 1.1 as above. 
===== Configuring Eos =====

==== OSC Configuration ====

To get the most from CueCam you need to enable two different options in ETC Eos

Within **Settings > Device > Network** enable both **Third Party OSC** and **OSC TCP** on any network interfaces that you want to use CueCam on;

{{::eosconfig.png?direct&600|}}

Then within the **System > Show Control** set *OSC TX* to On, and ensure *OSC TCP Mode* is ''SLIP (v1.1)''. You should set a high port (greater than 1024) in *OSC TCP Server Ports* and remember this for later as you will need to provide it to CueCam.

{{::eosshwoconfig.png?direct&600|}}

<WRAP admonition note>
Due to a limitation in Eos, remote commands to control CueCam cannot be sent over Third Party OSC, but must use the separate TCP connection. If you do not enable OSC TCP you will still get live cue information from Eos but control and markers won't work — This is reflected by the AMBER connection status dot in Settings.
</WRAP>

==== EOS Version ====

EOS v3.2 or higher is recommended. 

===== Supported Features and Limitations =====

Eos allows from some incredibly complicated cue sequences, and CueCam is designed as a simpler representation of your show. 

The following data will be retrieved from your Eos console and displayed on CueCam recordings;
  * For each selected Cue List;
    * Current Cue Number
    * Current Cue Label (also supports the Eos Label Symbols) 
    * Remaining Cue fade time (expressed in seconds)
    * Completed percentage
  * Current Scene 
 
Current Limitations;
  * Scene information is taken from Cue List 1
  * When a new cue fires, only the most recently fired cue from that list  is shown even if others are still running
  * Individual times (focus, beam, colour, etc) are not shown separately
  * If a Cue or Scene is renamed, it will not show the new name until it next fires.
  * Parts are not shown individually, only the whole main cue number will appear..
  * Playbacks other than the cue list (e.g. subs) will affect your stage output but are not shown in CueCam