E1.31 (DMX) / Art-Net
WLED supports the E1.31 (sACN) realtime light protocol.
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.
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.
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.
- 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
- 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.
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!
Select the mode you want to use in Sync settings.
Incoming E1.31 packets will be ignored.
All LEDs are set to the same color. 3 Channels: Red, Green, Blue
All LEDs are set to the same color. 4 Channels: Master Dimmer, Red, Green, Blue
Not a realtime mode & only support 1 universe. Allows setting WLED effect properties over E1.31 with 15 channels.
|2||Effect mode ID|
|5||Effect palette ID|
effect option channel is divided into 4 macro parts to control mirror and reverse states:
|192..255||true||true||mirror & reverse|
Effect + White
Effect with additional whites = 18 channels.
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)
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
Effect Segment including whites, so it uses 18 DMX channels per segment.
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 RGB + additional white channels.
Dimmer + Multi RGB
Multiple RGB, but the first channel is a brightness control.
Master Dimmer, LED 0 Red, LED 0 Green, ...
Trigger presets and control brightness. 2 Channels: Brightness, Preset ID