Skip to main content

FAQ

Q: How to get more library support for the example?

A: You can subscribe to this repository and raise an issue to describe your requirements. The engineers will assess your request as soon as possible: ESP32-display-support

Q: After downloading a program to the module, sometimes it fails to connect to the serial port or fails to flash during subsequent downloads?

A: You can press and hold the BOOT button, then press the RESET button while holding BOOT, release the RESET button, and finally release the BOOT button. This will put the module into download mode, which resolves most download-related issues.

Q: The module keeps resetting, and when checking in Device Manager, the connection appears to be blinking?

A: This may be caused by an empty Flash making the USB port unstable. Press and hold the BOOT button, then press and release the RESET button while still holding BOOT, then release the BOOT button. The module will enter download mode, allowing you to flash the firmware (program) and resolve the issue.

Q: How to handle extremely slow first compilation of the program?

A: It is normal for the first compilation to be slow. Please wait patiently.

Q: How to handle the situation where the serial port shows 'waiting for download...' after a successful ESP-IDF flash?

A: If the development board has a reset button, press it; if not, power cycle the board.

Q: Can't find the AppData folder. How to handle this?
  • Some AppData folders are hidden by default. You can set your system to show them.
  • File Explorer -> View -> Check "Hidden items"
Q: How can I check which COM port I am using?

Windows System:

  1. Through Device Manager: Press Windows + R to open the "Run" dialog box. Type devmgmt.msc and press Enter to open Device Manager. Expand the "Ports (COM & LPT)" section. All COM ports and their current status will be listed here.
  2. Using Command Prompt: Open the Command Prompt (CMD), type the mode command, which will display status information for all COM ports.
  3. Check the hardware connection: If an external device is already connected to a COM port, the device typically occupies a port number. You can determine which port is being used by checking the connected hardware.

Linux System:

  1. Check using the dmesg command: Open the terminal.
  2. Check using the ls command: Type ls /dev/ttyS* or ls /dev/ttyUSB* to list all serial devices.
  3. Use the setserial command: Type setserial -g /dev/ttyS* to view configuration information for all serial devices.
Q: How to use SquareLine Studio to design interfaces?
Q: Program fails to flash when using a MAC device?

A: Install the MAC driver and re-flash.

Q: Why is there no output even though the code is correct and flashed successfully?
  • Check the schematic. Depending on the Type‑C interface of different boards, the code handles output differently:
    • For boards with a direct USB connection, they support output via the printf function. To support output via the Serial function, you need to enable the USB CDC On Boot feature or declare HWCDC
    • For boards with a UART-to-USB connection, they support output via both printf and Serial functions, and there is no need to enable USB CDC On Boot
Q: How to restore factory mode?

A: Flash the factory bin file. Refer to the Flash Firmware Flashing and Erasing Tutorial.

Q: Screen issue

A: The screen and back cover of such products are designed with an integrated adhesive bonding. To ensure normal use, it is recommended to avoid disassembling or prying open the adhesive layer. If the screen is damaged due to disassembly, repairs cannot be performed.

Q: Can I use the product without a TF card?

A: Yes, you can. Only the functions related to the TF card will be unavailable; other functions are unaffected.