Espressif Systems ESP User Manual

2.2.20 After imported the protocol_examples_common.h header 󰝘le, how come it cannot be found
while compling? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
2.2.21 When using ESP8266 NonOS v3.0 SDK, the following error occurred. What could be the
reason? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
2.3 Environment setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
2.3.1 When setting up ESP32-S2 environment using command idf.py set-target
esp32s2, an error occurred as “Error: No such command ‘set-target’”. What could
be the reason? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
2.3.2 When installing ESP-IDF version master using ESP-IDF Tools 2.3 in Windows system, an
error occurred as: Installation has failed with exit code 2. What could be the reason? . . . 15
2.3.3 When setting up environment using esp-idf-tools-setup-2.3.exe on Windows, errors oc-
curred when make menuconfig is executed: . . . . . . . . . . . . . . . . . . . . . . 15
2.3.4 When using esp-idf-tools-setup-2.2.exe in Windows system, a python error occurred during
the installation: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
2.3.5 What should I do if I get Download failed: security channel support
error when installing build environment in the Windows system? . . . . . . . . . . . . 15
2.3.6 When executing export.bat in Windows system, what should I do if I get CMake and gdbgui
version errors?
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
2.3.7 Errors occurred when using idf.menucon󰝘g and idf.build after updating the ESP-IDF ver-
sion from v3.3 to the latest one: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
2.3.8 How to con󰝘gure PATH and IDF_PATH when developing ESP32 and ESP8266 simulta-
neously? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
2.3.9 Do I need to use command idf.py set-target every time when switching to another
project? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
2.3.10 How to know the version of ESP-IDF, is it recorded in a certain document? . . . . . . . . 17
2.3.11 How to optimize ESP-IDF compilation in Windows environment? . . . . . . . . . . . . . 17
2.3.12 Is there an esptool that can be used directly on Windows? . . . . . . . . . . . . . . . . . 17
2.4 Firmware update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
2.4.1 How does the host MCU 󰝙ash ESP32 via serial interfaces? . . . . . . . . . . . . . . . . . 17
2.4.2 How to download 󰝘rmware for ESP32 series modules using the USB-Serial tool? . . . . . 17
2.4.3 How to 󰝙ash 󰝘rmware in macOS and Linux systems? . . . . . . . . . . . . . . . . . . . . 18
2.4.4 Does ESP32 support programming using JTAG pins directly? . . . . . . . . . . . . . . . 18
2.4.5 Does ESP_Flash_Downloader_Tool support customized programming control？ . . . . . 18
2.4.6 Can I enable the Security Boot function for ESP32 via OTA? . . . . . . . . . . . . . . . 18
2.4.7 How to resolve the following error occured when 󰝙ashing 󰝘rmware to ESP32-S2 based on
ESP-IDF v4.1? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
2.4.8 How to download 󰝘rmware based on ESP-IDF using 󰝙ash_download_tool? . . . . . . . . 19
2.4.9 What is the communication protocol for 󰝙ashing ESP chips? . . . . . . . . . . . . . . . . 19
2.4.10 How to program ESP32-C3’s 󰝘rmware o󰝛ine? . . . . . . . . . . . . . . . . . . . . . . 19
2.4.11 How does ESP32 set Flash SPI to QIO mode? . . . . . . . . . . . . . . . . . . . . . . . 19
2.4.12 After downloading program and powering on EPS8266, the serial port printed the following
log. What is the reason? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
2.4.13 What are the Espressif module programming tools? . . . . . . . . . . . . . . . . . . . . 20
2.4.14 What is the di󰝗erence between the Factory mode and Developer mode of the 󰝙ash download
tool? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
2.4.15 Why does the programming failed for the jig with a 4-port hub in factory mode ? . . . . . 20
2.4.16 I’m using an ESP32-WROVER-B module to download the AT 󰝘rmware via the 󰝙ash
download tool. However, an error occurred after writing to 󰝙ash. But the same operation
succeeded when replacing the module with ESP32-WEOVER-E, what is the reason? . . . 20
2.4.17 The encrypted device cannot be re-󰝙ashed via the 󰝙ash download tool. What could be the
reason? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
2.4.18 When updating ESP32 󰝘rmware through UART interface based on esptool serial port pro-
tocol, can I add a new app partation? . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
2.4.19 I am using ESP8266 to download the 󰝘rmware via 󰝙ash download tool. After downloading
the 󰝘rmware, there is no programming output log, and the serial port printed the following
messages. What could be the reason? . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
2.4.20 Why does my USB driver failed to be recognized by the Windows7 system? . . . . . . . . 21
ii

Espressif Systems ESP Specifications

General

Brand	Espressif Systems
Model	ESP
Category	Motherboard
Language	English