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?

Method 1: Press the reset button for more than 1 second, wait for the PC to re-detect the device, and then upload again.
Method 2: Long press the BOOT button, press RESET at the same time, then release RESET, then release the BOOT button, at this time the module can enter the download mode, which can solve most of the problems that can not be downloaded.

Q: When setting up the environment or creating a project, there is no ESP option shown below?

A: Press F1 in VS Code, search for Espressif IDF. If it is marked as an untrusted extension, set it to trusted.

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: When downloading a program using UART (CH343), the message 'Unrecognized USB device' pops up?

A: This does not affect program flashing. If the 'Unrecognized USB device' message appears and you need to use the USB‑corresponding COM port, disconnect the cable from the computer and reconnect the device. Alternatively, you can erase the program via software or command; after erasing, the USB port will be re‑recognized.

Q: After switching to another ESP of the same model, the flashed program malfunctions?

A: After switching the ESP, re-select the COM port and driver target, then compile and flash again.