FAQ
Q: After powering on the module, the recognized serial port devices and USB port keep resetting/rebooting?
A: Check if the supply voltage of the USB port is less than 5V. Generally, if the USB port's supply voltage is above 4.9V, both USB ports on the module should function normally. If it is below 4.9V, insufficient power supply may occur, leading to the USB port disconnecting. In this case, you need to switch to a USB port that provides adequate voltage.
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: During repeated flashing, serial port connection fails or flashing fails?
A: You can force the board into download mode in one of the following ways:
- Press and hold the RESET button for more than 1 second, then release it. Wait for the computer to re-detect the device, then flash again.
- Press and hold the BOOT button, press RESET once and release it, then release BOOT. The board will enter download mode, which can resolve most flashing issues.
Q: After switching to another board of the same model, flashing fails or the program runs abnormally?
A: When you change boards, the COM port assigned by the computer usually changes. Please reselect the COM port and the target chip, then recompile and flash.
Q: The ESP-IDF action buttons are missing from the VS Code bottom status bar?
A: Press F1 to open the command palette and search for Espressif IDF. If the extension shows as untrusted, set it to trusted and it will work properly.
Q: During JTAG debugging, the debug interface never appears?
A: Click the OpenOCD button in the VS Code bottom status bar, stop OpenOCD, and then restart it.