Getting started

From a blank board to receiving DMX over the network in about five minutes.

1 · Flash the firmware

The fastest path is the web installer: connect the board via USB, pick your fixture and board, click Install. It writes the full 4 MB image — bootloader, firmware and web UI — in one pass. Chrome or Edge required.

Alternative: esptool (command line)

Download the merged image for your board from release/latest, then:

pip install esptool
esptool --chip esp32 --port COM5 --baud 460800 write_flash 0x0 elyon_quinled_octa.bin

Replace COM5 with your serial port (/dev/ttyUSB0 on Linux) and the file name with your board's image.

Boards without native USB (e.g. the WT32-ETH01 on XDMX) need a USB-TTL adapter on TX0/RX0/GND, with GPIO0 tied to GND during power-up to enter the bootloader.

2 · Connect to the network

On first boot the board starts a WiFi access point named RavLight-XXXX. Connect to it and open http://4.3.2.1 in a browser — the web UI loads.

Open the Network section.
Ethernet boards: plug the cable — DHCP is used by default; a static IP can be set in the same panel.
WiFi: pick your SSID from the scan list, enter the password, save.
The board restarts and the page redirects to its new address (also reachable as ravXXXX.local via mDNS).

3 · Send it DMX

Open the DMX section and pick the input source:

Source	Notes
Art-Net	Default. Listens on UDP 6454, answers ArtPoll — the board shows up automatically in Resolume, xLights, QLC+, MadMapper…
sACN (E1.31)	Multicast per universe, priority handling. Works over WiFi too.
Wired DMX	Boards with an RS-485 port (XDMX) accept a physical DMX512 chain.
Auto scene	Loops a scene recorded with the built-in DMX recorder — standalone shows with no console.
Effects	Built-in generators (rainbow, chase, fire…) rendered on-device.

Set the start universe and channel to match your patch, then check the live DMX monitor page to verify data is arriving — fixture channels are highlighted in the grid.

4 · Configure your fixture

Each fixture adds its own section to the web UI. See the dedicated guides: Veyron, Elyon, Orion, Axon.

Updating later

Once on the network, updates are OTA: Settings → Update accepts the _fw_ (firmware) and _fs_ (web UI) binaries from the release page — no USB needed.