Set up your device
From the box to a running display. No account, no sign-in.
Built and tested against the ELEGOO 2-Pack ESP32 2.8-Inch Touch Display.
-
1
Plug it into a computer
Use a USB cable that carries data. Some cables only carry power, and a power-only cable is the most common reason the next step finds nothing. Plug straight into the computer rather than through a hub.
-
2
Flash it
This step needs Chrome or Edge on a Windows, Mac or Linux computer. It talks to the device over USB through WebSerial, which phones and tablets do not have.
Nothing is uploaded anywhere. The connection is directly between this page and the device over USB.
The picker was empty, or the browser couldn't talk to the device
Install the USB driver, then come back and press Connect and flash again. Windows is the usual case; Linux has it built in.
From Silicon Labs, who make the USB chip in the device. If a link is dead, their driver page has the current file.
Flash it by hand
Download the file above, open Espressif's flashing tool, connect, set the flash address to
0x0and select the file. -
3
Join it to your WiFi
The device raises its own WiFi network for a few minutes after it starts. On your phone, open WiFi settings and join the network named on the device's screen. A page asking for your home WiFi name and password opens by itself.
If it doesn't open, go to
192.168.4.1in a browser on your phone.
If something isn't working
Nothing happened when the flash finished
The device stays halted until it is power-cycled, so the screen is dark or still showing whatever was there before. Unplug the USB cable and plug it back in, or press the reset button. Try this before anything else here.
No device appears when you press Connect and flash
Try a different USB cable, since some carry power only. Then install the driver from inside step 2 and try again.
Flashing stops partway through
Unplug, plug back in, and press Connect and flash again. The device keeps the firmware it already had until a flash completes.
No WiFi network to join after flashing
Power-cycle it and wait 30 seconds. If it still does not appear, the flash did not complete, so go back to step 2.
The screen is blank, scrambled or showing garbled colors
Power-cycle it once. If it is still wrong after that, this unit needs a closer look, so contact whoever gave you the device.
The downloaded file opened in another program
Use Connect and flash in step 2, or select the file from inside the standalone flashing tool.
None of the above
Contact whoever gave you the device.