E1.31 (DMX) / Art-Net

E1.31

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

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.

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.

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