Skip to main content

FAQ

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: VS Code environment setup fails?

A: This is most likely a network issue. Try switching to a different network.

Q: Arduino program compilation error?

A: Check that the Arduino IDE > Tools settings are configured correctly.

Q: Image sliding is laggy?

A:

  • Increase the LVGL display cache to the full screen size.
  • In the configuration options, change LV_IMG_CACHE_DEF_SIZE to 1000 for some improvement.
Q: Chinese characters are not displayed?

A:

  • Basic Chinese characters can be displayed; uncommon characters may not.
  • You can convert the required uncommon characters using encoding software and add them to the project font library.
Q: The first compilation takes a long time. How to handle it?

A: It is normal for the first compilation to take a while. Just wait for it to complete.

Q: After successful flashing in ESP-IDF, the serial port shows 'waiting for download...'. What should I do?

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

Q: How to handle the situation when the AppData folder cannot be found?

A:

Some AppData folders are hidden by default. You can set them to be visible:

  • File Explorer -> View -> Check "Hidden items"
Q: How do I check which COM port I am using?

A:

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: Program fails to flash when using a MAC device?

A: Install the MAC driver and re-flash.

Q: Not sure how to choose a lithium battery and RTC battery?

A:

  • Standard 3.7V-4.2V lithium battery: if without a case, directly plug into the PH1.25 connector; if with a case, connect via the VBAT and GND terminals.
  • RTC battery range is 1.5 to 3.3V, with an SH1.0 connector.
Q: How to design a user interface with SquareLine Studio?

A: Please refer to the SquareLine Studio tutorial.