FAQ

Short answers to the questions that come up most often.

Which browser do I need for the web installer?

Chrome or Edge — the installer uses the Web Serial API, which Firefox and Safari don't support. Any OS works as long as the browser is Chromium-based.

The board doesn't show up when I click Connect

Two usual suspects: the USB-serial driver (install CP210x or CH340 drivers depending on the adapter chip) and the cable — many USB cables are charge-only and carry no data. Try another cable before anything else. Also note most QuinLED and Gledopto boards have no onboard USB-serial chip and need an external USB-TTL adapter.

How do I flash a WT32-ETH01 (XDMX rev2.2)?

The WT32-ETH01 has no USB port. Connect a USB-TTL adapter to TX0/RX0/GND, tie GPIO0 to GND, then power the board up — it boots into the serial bootloader. Flash normally, remove the GPIO0 strap, and power-cycle.

How do I factory reset?

Boards with a physical reset button (e.g. XDMX): hold it for 10 seconds — the config is wiped and the defaults from default_config.json are loaded, including a fresh MAC-based device ID. Boards without a button: re-flash the filesystem (_fs_ binary) and erase the flash if you also need to clear NVS, or use the restart/reset actions in the web UI Settings while it's still reachable.

Does my config survive firmware updates?

Yes. The runtime config lives in NVS (flash key-value storage), not in the filesystem — it survives both OTA firmware updates and filesystem (uploadfs / _fs_ OTA) updates. Only a full-chip erase or a factory reset clears it. You can also export/import the config as JSON from Settings.

Art-Net data isn't arriving

Check in this order:

  1. Universe numbering — RavLight universes are 0-based like Art-Net. If your software counts from 1, its universe 1 is RavLight's universe 0.
  2. Same subnet — sender and board must be on the same IP subnet; check the board's IP in the Network panel.
  3. Firewall — allow UDP 6454 (Art-Net) or 5568 (sACN) outbound on the sending machine.
  4. Open the DMX monitor page — if channels light up there, data is arriving and the issue is patching, not network.

ravXXXX.local doesn't resolve

mDNS works out of the box on Windows, macOS, Linux and iOS, but Android does not resolve .local hostnames in the browser. On Android use the board's IP address directly — it's shown in the Info popup and in your router's DHCP client list.

Where do I download release binaries?

From the GitHub releases page, grouped per fixture in release/{veyron,elyon,orion}/vX.Y.Z/. Each board gets three files: the merged binary for first flash at 0x0, plus _fw_ and _fs_ binaries for OTA updates.

Why does OTA need two files?

ElegantOTA flashes one partition at a time: upload _fw_ as "Firmware" and _fs_ as "Filesystem". Firmware first is recommended so the web UI matches the backend. The board reboots after each upload.

How do I report a bug?

Open an issue on GitHub. Include the board, fixture, firmware version (Info popup), and what you were sending it (Art-Net/sACN source and universe layout) — that's usually enough to reproduce.