Flashing WLED Firmware - ESPHomeFlasher

Flashing WLED Firmware - ESPHomeFlasher
RGB2Go Resources

Flashing WLED firmware manually

This guide walks through the manual ESPHome Flasher method for reinstalling WLED on RGB2Go controllers. It works for Solo2Go, Duo2Go, Tetra2Go, Octa2Go, and Matrix2Go when you prefer a downloadable flashing utility or need a fallback from the online installer.

Try the Web Flasher first Manual flashing steps
Easiest option

The RGB2Go Web Flasher works directly in Chrome or Microsoft Edge and can connect the controller to WiFi after install.

Manual option

ESPHome Flasher is a downloadable utility for manually writing the correct .bin firmware file.

Required cable

You need a data-capable USB cable. Charge-only cables can power the controller but will not show a COM/serial port.

Recommended first: Web Flasher

Looking for the easiest way to flash? Try the RGB2Go Web Flasher. Use Chrome or Microsoft Edge on a desktop/laptop. Firefox and Safari currently do not support the Web Serial connection required by the online flasher.

The Web Flasher handles the firmware selection and install in the browser. After the firmware installs, it prompts you to connect the controller to your local WiFi network. Once WiFi setup completes, it provides a direct link to the controller's WLED web interface, so you do not have to search for the IP address it was assigned.

Downloads

Serial drivers

Install the driver if your controller does not appear as a COM/serial port.

ESPHome Flasher

Download the manual flashing program for your operating system.

WLED firmware

Choose the firmware file that matches your controller and installed add-on modules.

If you do not have add-on modules, choose the Base firmware for your controller.

Manual flashing steps

1

Install the serial driver

The serial driver allows your computer to recognize the controller when it is plugged in over USB.

Most RGB2Go controllers use the CH9102F chip. Start with the CH9102F driver. If your controller is still not recognized after installing it, try the CP210x driver. All of these drivers can be installed at the same time without conflict.

On Windows, run the installer after downloading. Once installed, plug in your controller and confirm a new COM port appears in Device Manager under Ports (COM & LPT).

2

Download ESPHome Flasher

ESPHome Flasher is the utility that writes the WLED firmware file onto ESP8266 and ESP32 controllers.

Download the Windows or macOS version from the download cards above, then open the program.

3

Download the correct firmware

Open the RGB2Go Firmware Downloads page and select your controller from the dropdown.

  • Choose the controller model that matches your hardware.
  • Choose the variant that matches your add-on modules: Base, Ethernet, OLED, Differential, or DMX.
  • If you do not have add-on modules, choose Base.
  • Make note of where the downloaded .bin file is saved.
4

Connect your controller by USB

Important: Make sure NO external power cable is connected to the controller before plugging in USB. Only USB power should be present during flashing.

Connect your controller to your computer using a data-capable USB cable. On Windows, you should hear a connection sound and see a COM port in Device Manager.

5

Flash the firmware

  1. Open ESPHome Flasher.
  2. Under Serial Port, select the controller's COM/serial port, such as COM3 or COM7.
  3. Under Firmware, click Browse and select the .bin file downloaded in Step 3.
  4. Click Flash ESP.

The status LED on the controller may go out during flashing. When the progress reaches 100%, the LED will come back on and flashing is complete. You can ignore any garbled text that appears after 100%.

No COM port showing? Try a different USB cable, a different USB port, and reinstall the serial driver from Step 1. Charge-only USB cables are the most common cause.
6

Power up and configure WLED

Unplug USB and reconnect the controller's normal power supply. It will boot as a fresh WLED install and broadcast a WiFi access point named WLED-<controllername>.

  1. Connect to the WLED WiFi network. If asked for a password, try wled1234.
  2. If a setup page does not open automatically, browse to http://4.3.2.1.
  3. Connect WLED to your local WiFi network.
  4. Go to Config → LED & Hardware and confirm your output and current limit settings.
Important WLED 0.16+ note: RGB2Go controller firmware is pre-configured with a maximum amperage for the unit. In WLED, go to Config → LED & Hardware and check Use per-output limiter. This divides the total current limit across the available outputs and caps each output at 5A.

Troubleshooting quick checks

No serial port?

Try a known data USB cable, a different USB port, then install CH9102F first. If it still does not appear, try CP210x. Older controllers may need CH340.

Wrong firmware?

Return to the Firmware Downloads page and make sure the controller model and add-on variant match your hardware before flashing again.

Want the easier path?

Use the Web Flasher in Chrome or Edge. It can install firmware, set WiFi, and give you a direct WLED link.

Need help?

We are happy to help get your controller working again.

If you get stuck, email jason@rgb2go.com with your controller model, computer operating system, the firmware filename you selected, and a screenshot of any error message.