Skip to main content

FAQ

Q: Why does my development board occasionally fail to connect to the serial port when re-flashing?

Press and hold the BOOT button, then press the RESET button. Release RESET first, then release BOOT. This puts the board into download mode, and then re-flash.

Q: Why does my VS Code development environment setup fail?

First check the network connection. If dependency downloads fail, try switching networks and retry.

Q: Why does my Arduino program fail to compile?

Check the Tools menu in Arduino IDE to confirm that the board model, Flash, PSRAM, and USB options match the requirements for your current hardware version.

Q: Why is my image swipe display not smooth?
  • Adjust the LVGL display buffer to the full screen size.
  • Set the configuration item LV_IMG_CACHE_DEF_SIZE to 1000 to increase the number of cached images.
Q: Why can't some Chinese characters be displayed on my interface?

The current font library may not include certain rare characters. Use a font conversion tool to generate the required characters and add the generated glyph data to the project font library.

Q: Why does the program take a long time to compile the first time?

The first compilation needs to generate dependencies and caches, so it typically takes longer than subsequent compilations. Just wait for the compilation to finish.

Q: After ESP-IDF flashing succeeds, the serial port shows 'waiting for download...'. How to handle this?

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

Q: I can't find the AppData folder. How to handle this?

Windows hides the AppData folder by default. You can show hidden items in File Explorer:

Select View > Hidden items.

Q: How do I check which COM port I am using?

Windows System:

  1. Press Windows + R, type devmgmt.msc and press Enter to open Device Manager.
  2. Expand Ports (COM & LPT) and check the COM port corresponding to your board.
  3. You can also run mode in Command Prompt to view the current COM port status.

Linux System:

  1. After connecting the board, run dmesg | grep tty in the terminal to see newly identified serial devices.
  2. Run ls /dev/ttyACM* or ls /dev/ttyUSB* to list USB serial devices.
Q: How do I use SquareLine Studio to design interfaces?