Skip to content

TROUBLESHOOTING.md

Latest commit

 

History

History
45 lines (27 loc) · 2.89 KB

TROUBLESHOOTING.md

File metadata and controls

45 lines (27 loc) · 2.89 KB

First, Make sure it's a CYD!

If you are having any issues, this is the first thing I would check!

The examples and information contained on this repo are for the ESP32-2432S028 display only. The model number is written on the back of the display in gold writting, beside the speaker connector.

Display is not turning on

If you are having issues getting the display working, the first thing I would try is webflashing an existing project. These will be known working code, and if it works correctly, it points to a software issue, not a hardware one.

If the webflash project displays something on the screen

  • Make sure you have put the User_Setup.h file in the correct location as described here
  • Pin 21 is the backlight pin, make sure you are not using it for something else in your sketch.

The webflash project doesn't display on screen

  • Make sure you are not connecting Pin 21 to anything. It is broken out on the connector labeled P3
  • Try a different USB supply and or cable
  • If nothing else worked, your CYD could be faulty. Contact the seller.

Display, Touch and SD card are not working at the same time

The ESP32 offers two usable hardware SPI buses, but on the CYD each of display, touch and SD card use a different bus. To use all three devices at the same time, for one of them the SPI has to be "simulated" in software. Usually this is done for the touch device, since it doesn't require a high bandwidth. Therefor use a software SPI implementation like XPT2046_Bitbang_Slim and follow the button example

Display is flickering

  • Try a different USB supply and or cable
  • Go through the Display is not turning on steps
  • If nothing else worked, your CYD could be faulty. Contact the seller.

Cannot upload

  • On Ubuntu and flavors disable or uninstall service brltty and make sure user is in group dialout

Automatic flash with esptool failed: Wrong boot mode detected (0x13)

This is the well-known problem of flashing ESP32 through USB-UART converter, when DTR and RTS signals are used to switch the chip to the bootloader mode (with additional 2xNPN transistor digital protection logic). On some PC, OS, driver version it works, on another it doesn't:

A fatal error occurred: Failed to connect to ESP32: Wrong boot mode detected (0x13)! The chip needs to be in download mode. For troubleshooting steps visit: https://docs.espressif.com/projects/esptool/en/latest/troubleshooting.html

The solution is to replace a capacitor between EN (RST) and GND from 0.1uF, installed on CYD, to something in range 1uF and 10uF.

NOTE: In schematic, this is C4, but at least on Type-C version of CYD it is C5 actually.