Skip to content
WDECK Download ↓
F/00 Web flasher · Chrome, Edge, Opera

Flash it from the browser.

Plug the Wdeck in over USB, pick your display and install the firmware right from this page. No app, no Arduino IDE, nothing to compile.

Start flashing ↓ Before you start ↓
The browser sends the firmware over USB to the ESP32, then the keys light up on the display
BrowserUSBESP32Display
F/01 Flasher

Three steps,
about a minute.

The firmware is built for every supported display in advance. Your pictures and the touch calibration stay on the deck.

  1. 01

    Pick your display

    Printed on the display board or in the shop listing.

    Colours come out inverted? Flash again with the other panel type.

  2. 02

    Connect the Wdeck

    Use a USB data cable and close the Wdeck app first — only one program can use the port.

    The browser lists the serial ports — pick USB Serial, CP210x or CH340.

  3. 03

    Install the firmware

    Wdeck firmware for ILI9488 · TFT.

F/02 Before you start

Four things
to check.

Most failed flashes come down to the cable or a program that still holds the port.

C1

A data cable

Charge-only cables power the board but carry no data, so no port shows up.

C2

Port is free

Quit the Wdeck app from the tray, and close the Arduino serial monitor.

C3

USB driver

Windows needs the CP210x or CH340 driver, depending on the chip next to the USB port.

C4

The right display

A white or garbled screen after flashing means another controller — just flash again.

F/03 Troubleshooting

When it does
not connect.

My Wdeck is not in the list
Try another cable first, then install the USB driver (C3 above). The port appears as “USB Serial”, “CP210x” or “CH340” with a COM number.
“Failed to connect” or “Wrong boot mode”
Hold the BOOT button on the ESP32, press Connect and let go once the log shows the chip. Some DevKits cannot reset themselves into the bootloader.
“Failed to open serial port”
Another program uses the port. Quit the Wdeck app from the tray icon, close the Arduino IDE serial monitor, then connect again.
Will it delete my key images?
No. Only the program is replaced; images and touch calibration live in a separate part of the flash. They are only removed when you tick “Erase everything first”.
Firefox, Safari or a phone?
They have no Web Serial, so they cannot reach the USB port. Use Chrome, Edge or Opera on Windows, macOS, Linux or ChromeOS — or the flasher in the desktop app.
Which board does this firmware run on?
The classic ESP32 (ESP32-WROOM / DevKit V1) wired as in the wiring table. S2, S3 and C3 boards need their own build.