E1.31 (Streaming-ACN) Protocol

From doityourselfchristmas.com
Jump to navigation Jump to search

Disclaimers

The standard disclaimers pertaining to the information contained on this wiki page are listed here.

What is Streaming-ACN (E1.31)?

ACN is a suite of protocols (via Ethernet) that is the industry standard for lighting and control. ESTA, the creator of the standard, ratified a subset of this protocol for "lightweight" devices which is called sACN (E1.31). This lightweight version allows microcontroller based lighting equipment to communicate via ethernet, without all the overhead of the full ACN protocol. In an effort push early adoption ETC provided the protocol information (code and draft specification) at no charge.

A ratified/offical copy of the standard can be found here for free.

Protocol Description

The simplest way to think about E1.31 is that it is a way to transport a large number of lighting control channels over a traditional ethernet network connection. E1.31 transports those channels in "Universes", which is a collection of 512 channels together. E.131 is ethernet based and is the data sent via UDP. The two accepted transport methods are multicast and unicast, the most common implementation is multicast. When using multicast all the controller needs to do is subscribe to the multicast address for the universe that you want to receive data from.

Unicast vs. Multicast

Most E1.31 software and hardware can be set up to communicate via the 2 transport methods: Unicast and Multicast

Unicast


Unicast is a method of sending data across a network where two devices, the control PC and the lighting controller, are directly connected (or thru a network switch or router) and the channel control information meant for that specific controller is only sent to that controller. Unicast is a point to point protocol and only the lighting channel information is only switched or routed to the device with the matching IP address. In this case, the same IP address (commonly 192.168.1.206) that is used to access the web configuration page is the same address the the lighting control information is sent to. You must have unique IP address in each controller. Using Unicast the data packets are sent directly to the device instead of being broadcast across the entire subnet.

Multicast


Multicast is a method to send data across a network where a sender, typically a PC, broadcasts the data to all devices connected to the network subnet and the information about the channels are sent to all controllers connected to the network and every other device on the network. Multicast is a point to multipoint broadcast where the controllers need to listen to and only respond to information they are configured to use. Your PC sequencing software or streaming tool sends multicast packets with an address of 239.255.<UHB>.<ULB> where UHB is the Universe high byte and LHB is the Universe low byte. As an example, the address for universe '1' would be 239.255.0.1. This is why using multicast addressing can be simpler to configure since this address is always the same for any device using that universe. The disadvantage of using multicast is that the packets are sent to every device on the subnet regardless if they are destined for it or not. This means the receiving device must read in the header for each packet or have the means to block these within hardware. Depending on the device and the number of universes of data sent it can swamp the device and possibly end up causing a loss of data. Note however that this is not an issue for most networks until you get into the dozens of universes so it's not an issue for most users. With Multicast you must also have a unique IP address for each controller so that you can access its webpage that allows configuration. The data is received on multicast IP address not on the configuration IP address.

Advantages of Unicast vs. Multicast

  • Unicast
    • Allows more channels of data to controllers and bridges (commonly 12 Universes vs. 7 Universes for Multicast)
    • Less data on home network due to routers and switches sending data only to selected devices and not all devices on network
    • Channels can only be sent to one controller per Universe
  • Multicast
    • Allows less channels of data to controllers and bridges (commonly 7 Universes vs. 12 for Unicast)
    • Simpler network configuration since controllers don't need data address information
    • Busier home network due to the fact that Multicast sends information to every device on the home network and they need to deal with it (not just controllers, but other PCs, TV, game consoles, etc)
    • Channels can be mirrored on multiple controllers since the same Universe can be used by multiple controllers.


Understanding Universes

E1.31 transports lighting information in "Universes", which is a collection of up to 512 channels together. In order for this to work with a Pixel Controller or E1.31 bridge you must setup the output driver in your sequencing software. You can chose any universe number from 1-65536 and assign it to a block of channels in your sequencing software. While a Universe can contain up to 512 channels, it does not have to, and can be any number between 1-512 channels. If you are using the E68x series (E680, E681, E682, E6804) of pixel controllers, you can only use 510 channels maximum per universe. If you are using more then one universe of channels in your sequencing software, then you must setup each of the multiple universes in your sequencing software and also map them to the appropriate channels in your sequence. You only need to install one output plugin in the sequencing software and add all of the universe mapings into that one output plugin. Once you have setup your sequencing software E1.31 output plugin, you must then go and setup your Pixel Controller or E1.31 bridge to map those universes of channels to the appropriate output connector.

E1.31 Network Layout

Since E1.31 transmits its data information using ethernet, normal home networking configurations can be used to connect your E1.31 gear together.

Direct Connection PC to Device


It is possible to use a single ethernet cable to connect a E1.31 controller or bridge directly to a PC without other networking gear. E1.31 uses ether net connections (RJ45 cables). To connect directly, it is necessary to put the PC and the E1.31 on the same IP subnet, ie: that they both have an address that has the same first three IP address settings like: 192.168.1.x or 192.168.0.x By default many of the E1.31 devices come with a default address of 192.168.1.206.

For assistance setting the IP address in a PC:

Use of Switch or Router to Connect PC and Multiple Devices


It is also possible to connect an E1.31 controller or bridge to an existing home network by plugging the device into a low cost ethernet switch or router. This configuration also allows multiple E1.31 controllers or bridges to be controlled by one main PC. It is also possible to use multiple PCs to send data to the controllers over the network. It is necessary to put the PC and all of the E1.31 devices on the same IP subnet, ie: that they both have an address that has the same first three IP address settings like: 192.168.1.x or 192.168.0.x By default many of the E1.31 devices come with a default address of 192.168.1.206. If you are using multiple E1.31 devices, it is necessary that you change the default IP address of the additional units to another address other than 192.168.1.206 so that you can access the configuration page of all of the E1.31 devices.

Common E1.31 Devices

The use of E.131 has increased dramatically in recent years and new devices are coming on the market daily. The two most common devices used in Christmas lighting displays are Pixel Controllers and Protocol Bridges.

E1.31 Pixel Controllers

Using an E1.31 output driver software, the light control software on the PC sends the lighting sequence data out to the controllers that are connected to the PC thru ordinary ethernet connections such as a router or switch. The controllers listen for the light control data addressed to them and then control the lights that are connected to it. The controllers can be setup for either Unicast or Multicast data thru their webpage based configuration screens. Common E1.31 Pixel controllers are:

E1.31 Protocol Bridges

Another common usage of E1.31 is an E1.31 Bridge. An E1.31 bridge bridge is a device that allows your PC to communicate with a large number of Renard or DMX controllers using regular Ethernet network connections. It replaces multiple DMX or RS485 dongles with one configurable device that can be mounted in an enclosure in the yard and only requires one Ethernet Cat5 cable (or WIFI) back to your PC or home network. It allows up to 6 DMX universes or Renard networks to be easily controlled from your sequencing software with a minimum amount of wire from your show PC to your controllers. The bridge works with all Renard, DMX and LOR (using DMX) controllers. A common E1.31 Bridge is:

Configuring Sequencing Software to use E1.31 Output


In order for your light sequencing sotware to communicate via E1.31 protocol, the software needs to have the output configuration setup done in the software. This varies from software package to software package. The basic concept is that you map the output channels from your sequence into collections of channels called "Universes". Each universe can map up to 512 Channels. You must choose a Universe Number, Sequence Channel to Start the Universe at, Multicast or Unicast transport and Number of channels in the Universe. With high channel count systems it is common to have multiple universes used to transport the lighting data to the Pixel Controller or E1.31 Bridge.
IMPORTANT: Remember that E682 lighting controllers only use up to 510 channels per universe, not the full 512 channels per universe when you setup your software to talk to your controllers

Using E1.31 with Vixen

How to setup and use Vixen 2.1,2.5 and 3.0 with E1.31

Using E1.31 with LOR S3

You must have an Advanced ShowTime Software Suite S3 license from Lightorama to use the E1.31 interface.

How to setup E1.31 on LOR S3 Advanced pdf file

Initial setup for E1.31 if you do NOT have an LOR RS485 USB adapter

Video on how to setup and use LOR S3.5 with E1.31

Using E1.31 with HLS

HLS Hardware Configuration

Using E1.31 with LightShowPro (LSP)

Setting up E1.31 in LSP
Setup Video

Using E.131 with xlights (Nutcracker)

Download xlights here
Nutcracker (starts about 15:00 in the video)

Tools for Testing E1.31 Hardware and Connections

These free tools allow you to test E1.31 controllers simply without using sequencing software. They are good tools to use when troubleshooting a E.131 network setup.

More Information

Description

Code Example and Draft Copy of Specification

Article: E1.31: An Offer You Can't Resist