Installing the Ethernet Module
The Ethernet Module allows your RGB2Go controller to connect to your network via a wired connection, providing a more reliable and lower-latency alternative to WiFi. This guide walks you through installing the module and configuring WLED to use it.
Compatible Controllers
The Ethernet Module requires a special version of the WLED firmware with Ethernet support enabled. You must flash this firmware before installing the module.
The easiest way to flash is using our Web Flasher. Select your controller, then choose the Ethernet add-on before flashing. Ethernet-enabled firmware files end in "-Eth".
For manual flashing instructions, visit our Firmware Flashing Guide.
Align the Ethernet Module with the expansion header on your controller. The module has a semicircle cutout on one edge — align this with the corresponding marking on the controller PCB to ensure correct orientation.
Press the module firmly and evenly into the header, ensuring all pins are fully seated before applying power.
Power on the controller and connect to the WLED web interface. Navigate to Config → WiFi Setup and confirm that "AP Opens" is set to "Always". This ensures you can always access the controller via its WiFi access point if needed.
On the same WiFi Setup screen, scroll down until you see the Ethernet Type setting. If this option is not visible, your firmware does not have Ethernet support — return to Step 1 and re-flash with the correct firmware.
Select the Ethernet type that matches your firmware version:
| Firmware Version | Ethernet Type Setting |
|---|---|
| v0.14.x | ESP32Deux |
| v0.15.x and later | ESP32Deux / RGB2Go |
Click Save after making your selection.
Plug an active Ethernet cable into the RJ45 port on the module. You should see the following on the module's LEDs:
- Green LED — solid, confirms the module is powered and active
- Green LED blinking rapidly — network traffic is flowing
- Amber LED solid — link established at 100Mbps
Navigate back to Config → WiFi Setup and scroll down to just above the Configure Access Point section. Your assigned IP address will be listed next to Client IP.
Enter this IP address into your browser's address bar. If you are on the same network, the WLED interface will load.
Your controller is accessible on your local network via its assigned IP address and can be used with xLights, Vixen, or any other WLED-compatible software.