ESP32 CYD Getting Started: USB, First Upload & Recovery
Start with USB communication before configuring LCD libraries. Successful upload and a working display are separate checks: a sketch can upload correctly while the screen stays blank because its driver, pins or backlight have not been configured.
Identify the board
Read the rear PCB marking and record the USB connectors, display and touch type. The familiar ESP32-2432S028R reference is not a universal description of every yellow display board. Use the CYD comparison and 2.8-inch CYD: ESP32-2432S028R to match the unit.
Connect and find the port
- Use a known USB data cable and connect directly to the computer.
- Observe which serial device appears after connecting the board.
- Install the USB bridge driver matching the actual bridge when required; not every CYD uses the same chip.
- Select the board configuration and serial port appropriate to that hardware.
Keep the first diagnostic simple. A serial-output example can establish that your program runs without relying on the LCD. Select the Serial Monitor baud rate to match the sketch.
Recover from a failed upload
| Message or symptom | First checks |
|---|---|
| No port appears | Cable data capability, connector, driver and another USB port |
| Port busy or permission error | Close other serial programs and check operating-system permissions |
| Connecting dots / no serial data | Correct port, board boot mode, cable and power |
| Upload succeeds but screen is blank | Display configuration and backlight; this is a separate stage |
| Repeated resets | Capture the serial reset message and inspect the supply path |
Use the board’s documented BOOT/RESET procedure if automatic bootloader entry fails. Do not erase flash as the first response to every upload error. See USB & upload troubleshooting for the recovery workflow.
Test display, then touch
After serial output works, use the display and touch configuration guide or CYD PlatformIO & LVGL workflow with the exact environment. If the LCD model is uncertain, use driver identification. Preserve a copy of the successful project before adding a GUI or networking.
Article illustrations
