USB & upload troubleshooting
Check missing serial ports, failed uploads and unreadable startup logs.
On this page
No serial port appearsUpload cannot connectSerial output is unreadableThe display stays blankContact supportNo serial port appears
- Use a known data cable and connect directly to the computer.
- Compare the device list before and after connecting the board.
- Identify whether the board uses a USB-to-serial bridge or native USB.
- Install the driver appropriate to that interface.
Upload cannot connect
Confirm the board target and port. Close other programs using the port. Follow the exact board guide for entering download mode; button behavior differs between boards.
Serial output is unreadable
Match the monitor baud rate to the application. Reset after opening the monitor, and distinguish boot output from application output.
The display stays blank
Confirm that the firmware is for the exact display board and revision. Upload success does not verify screen wiring or driver selection. Use a board-specific example rather than guessing GPIO assignments.
Contact support
Send the product link, hardware revision, photographs of both board sides, software versions and complete error text. Include the steps you have already tried.
Share the product link, hardware revision, software version and any error messages.
Contact ESP32S support →