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: Check if it's a network issue and try switching to a different network.

Q: Arduino program compilation error?

A: Check whether Arduino IDE -> Tools is configured correctly.

Q: Chinese characters are not displayed?

A: Basic Chinese characters can be displayed. If rare characters are not showing, you can encode them using a conversion tool and add them to the project font library.

Q: What should I do if the first compilation is extremely slow?

A: It is normal for the first compilation to be very slow. Please be patient and wait for it to complete.

Q: After ESP-IDF flash succeeds, the serial port shows "waiting for download..." How to handle it?

A: If the development board has a reset button, press it. If there is no reset button, power it on again.

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

A: The AppData folder is hidden by default on some systems. You can set it to show:

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; enter devmgmt.msc and press Enter to open Device Manager; expand the "Ports (COM & LPT)" section, which lists all COM ports and their current status.
  2. Using Command Prompt: Open Command Prompt (CMD); enter the mode command, which will display status information for all COM ports.
  3. Check hardware connection: If you have connected an external device to a COM port, it usually occupies a port number. You can determine which port is being used by checking the connected hardware.

Linux System:

  1. Use the dmesg command: Open a terminal
  2. Use the ls command: Enter ls /dev/ttyS* or ls /dev/ttyUSB* to list all serial devices.
  3. Use the setserial command: Enter 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 which Li-ion battery to choose?

A: Use a standard 3.7V-4.2V lithium battery with a PH1.25 connector, directly plug it in.

Q: How to use SquareLine Studio to design interfaces?