E1.31

WLED supports the E1.31 (sACN) realtime light protocol.

!!! info “Version Info” As of WLED v0.10.0, Art-Net is alternatively supported. All information on this page applies for Art-Net as well. You will need to switch to Art-Net mode in Sync settings and reboot once.

!!! info “Version Info” As of WLED v0.11.0, DDP is alternatively supported. Using DDP, the Multi RGB DMX mode is always used regardless of the DMX mode setting (as it is no DMX) You will need to switch to DDP mode in Sync settings and reboot once.

!!! info “Version Info” As > WLED 0.14.0-b1, DMX Effect mode channel mapping changed. This is a breaking change in E131 sync behavior. Existing DMX setups using WLED Effect mode are likely to break. Solution: Adopt external DMX channel mappings according to the new Effect mode channel layout.

Features

  • 170 LEDs (510 DMX channels) are supported per universe.
  • You can use up to 9 adjacent universes which is a total of more than the maximum 1500 LEDs WLED can drive.
  • E1.31 priority handling. HTP for multiple senders with same priority is not implemented!

Note: WLED > 0.14.0-b1 implements a basic priority handling. To enable it set E1.31 port priority UI config > 0. Packages < config priority will always be skipped. Higher priority senders will overrule lower priority package senders (timeout 3 seconds). Non-zero start code and E1.31 preview data is ignored.

Note: If you see issued with lag, you may see better performance if you disable Wi-Fi Multimedia (WMM) Mode QoS on your router

General Recommendations

  • For a fluent 25ms (40fps) or more framerate, it is recommended to use no more than 3 universes (510 LEDs).
  • Using multiple E1.31 sources to control a single WLED controller will impact performance. If possible it’s recommended to avoid this.
  • Configure WLED to connect to a WiFi Network. It was observed that sending E1.31 from a computer to WLED when accessed as access point (WLED-AP) may not work, see forum post.
  • When using an ESP32, disabling WiFi sleep in the WiFi settings of WLED can reduce/eliminate visual stuttering/lag of effects, and significantly reduce ping times. Note: disabling WiFi sleep will increase power consumption.

Using LedFX

We highly recommend the LedFx project in combination with WLED! Configure WLED first, ensure devices are powered on and connected to your WiFi. To add WLED devices, in the ‘Device Management’, click on the Find WLED devices button. If you want to manually add devices, use more than 170 LEDs with LedFx, you need to go to additional settings and set “Universe Size” to 510 when adding the WLED device!

Settings

DMX types

Select the mode you want to use in Sync settings.

Disabled

Incoming E1.31 packets will be ignored.

Single RGB

All LEDs are set to the same color. 3 Channels: Red, Green, Blue

Single DRGB

All LEDs are set to the same color. 4 Channels: Master Dimmer, Red, Green, Blue

Effect

Not a realtime mode & only support 1 universe. Allows setting WLED effect properties over E1.31 with 15 channels.

Channel Property
1 Master Dimmer
2 Effect mode ID
3 Effect speed
4 Effect intensity
5 Effect palette ID
6 Effect option
7 Red Primary
8 Green Primary
9 Blue Primary
10 Red Secondary
11 Green Secondary
12 Blue Secondary
13 Red Tertiary
14 Green Tertiary
15 Blue Tertiary

The effect option channel is divided into 128 macro parts to control the various states that a segment can be in.

Using 2D effect options on a 1D strip has no effect.

Value Reverse Mirror 1D to 2D Map (2D only) Transpose (2D only) Mirror Y (2D only) Reverse Y (2D only)
0..1     Pixels      
2..3     Pixels     x
4..5     Pixels   x  
6..7     Pixels   x x
8..9     Pixels x    
10..11     Pixels x   x
12..13     Pixels x x  
14..15     Pixels x x x
16..17     Bar      
18..19     Bar     x
20..21     Bar   x  
22..23     Bar   x x
24..25     Bar x    
26..27     Bar x   x
28..29     Bar x x  
30..31     Bar x x x
32..33     Arc      
34..35     Arc     x
36..37     Arc   x  
38..39     Arc   x x
40..41     Arc x    
42..43     Arc x   x
44..45     Arc x x  
46..47     Arc x x x
48..49     Corner      
50..51     Corner     x
52..53     Corner   x  
54..55     Corner   x x
56..57     Corner x    
58..59     Corner x   x
60..61     Corner x x  
62..63     Corner x x x
64..65 x   Pixels      
66..67 x   Pixels     x
68..69 x   Pixels   x  
70..71 x   Pixels   x x
72..73 x   Pixels x    
74..75 x   Pixels x   x
76..77 x   Pixels x x  
78..79 x   Pixels x x x
80..81 x   Bar      
82..83 x   Bar     x
84..85 x   Bar   x  
86..87 x   Bar   x x
88..89 x   Bar x    
90..91 x   Bar x   x
92..93 x   Bar x x  
94..95 x   Bar x x x
96..97 x   Arc      
98..99 x   Arc     x
100..101 x   Arc   x  
102..103 x   Arc   x x
104..105 x   Arc x    
106..107 x   Arc x   x
108..109 x   Arc x x  
110..111 x   Arc x x x
112..113 x   Corner      
114..115 x   Corner     x
116..117 x   Corner   x  
118..119 x   Corner   x x
120..121 x   Corner x    
122..123 x   Corner x   x
124..125 x   Corner x x  
126..127 x   Corner x x x
128..129   x Pixels      
130..131   x Pixels     x
132..133   x Pixels   x  
134..135   x Pixels   x x
136..137   x Pixels x    
138..139   x Pixels x   x
140..141   x Pixels x x  
142..143   x Pixels x x x
144..145   x Bar      
146..147   x Bar     x
148..149   x Bar   x  
150..151   x Bar   x x
152..153   x Bar x    
154..155   x Bar x   x
156..157   x Bar x x  
158..159   x Bar x x x
160..161   x Arc      
162..163   x Arc     x
164..165   x Arc   x  
166..167   x Arc   x x
168..169   x Arc x    
170..171   x Arc x   x
172..173   x Arc x x  
174..175   x Arc x x x
176..177   x Corner      
178..179   x Corner     x
180..181   x Corner   x  
182..183   x Corner   x x
184..185   x Corner x    
186..187   x Corner x   x
188..189   x Corner x x  
190..191   x Corner x x x
192..193 x x Pixels      
194..195 x x Pixels     x
196..197 x x Pixels   x  
198..199 x x Pixels   x x
200..201 x x Pixels x    
202..203 x x Pixels x   x
204..205 x x Pixels x x  
206..207 x x Pixels x x x
208..209 x x Bar      
210..211 x x Bar     x
212..213 x x Bar   x  
214..215 x x Bar   x x
216..217 x x Bar x    
218..219 x x Bar x   x
220..221 x x Bar x x  
222..223 x x Bar x x x
224..225 x x Arc      
226..227 x x Arc     x
228..229 x x Arc   x  
230..231 x x Arc   x x
232..233 x x Arc x    
234..235 x x Arc x   x
236..237 x x Arc x x  
238..239 x x Arc x x x
240..241 x x Corner      
242..243 x x Corner     x
244..245 x x Corner   x  
246..247 x x Corner   x x
248..249 x x Corner x    
250..251 x x Corner x   x
252..253 x x Corner x x  
254..255 x x Corner x x x

Effect + White

Same as Effect with additional whites = 18 channels.

Channel Property
.. ..
16 White Primary
17 White Secondary
18 White Tertiary

Effect Segment

Same as Effect with 15 channels per segment; expect channel 1 = "Segment Dimmer".

All effect segment modes introduce an additional DMX segment spacing. If spacing s = 0 subsequent DMX addresses for all segments are created. When s > 0 a gap of s DMX addresses between segments is used. To calculate segment DMX fixture addresses:

Segment DMX Address (i) = DMXAddress + i * (dmxEffectChannels + s)
Where DMXAddress = start address as configured in UI, dmxEffectChannels = 15 18 depending on selected effect segment mode, s = address gap as configured in UI and i is the index id of each segment as existing.

Note: 1 DMX universe = max 512 DMX addresses. So max number of segments depends on start address, selected segment mode and configured DMX segment spacing. To calculate how many segments can be controlled:

Max segments = floor[ (512 - DMXAddress) / (dmxEffectChannels + s) ]

Effect Segment + White

Same as Effect Segment including whites, so it uses 18 DMX channels per segment.

Multiple RGB

3 Channels per LED in sequence. LED 0 Red, LED 0 Green, LED 0 Blue, LED 1 Red, … Default mode, equivalent to pre-0.9.1 E1.31. This is the mode you want to use for xLights and LedFx.

Multiple RGBW

Like Multiple RGB + additional white channels.

Dimmer + Multi RGB

Like Multiple RGB, but the first channel is a brightness control. Master Dimmer, LED 0 Red, LED 0 Green, …

Preset

Trigger presets and control brightness. 2 Channels: Brightness, Preset ID