ESP-FAQ Choose version... Instruction Development environment Application solution Software framework Hardware related Test verification Commercial FAQ ESP-FAQ » ESP-FAQ Edit on GitHub ESP-FAQ [中文] ESP-FAQ is a summary document of frequently asked questions released by Espressif. This repository aims to help our users to quickly locate those questions and get answers through simple explanations. The current categories of FAQ cover: development environment, application solution, software framework, hardware related and test verification. Instruction Development environment Application solution Software framework Hardware related Test verification Suggestion on this document? Provide feedback No answer found? Check issues on GitHub Ask the ESP community Contact technical support Next © Copyright 2020 - 2026, Espressif Systems (Shanghai) Co., Ltd.. Built with Sphinx using a theme based on Read the Docs Sphinx Theme. Download PDF ESP-FAQ Choose version... Instruction Question search Document contribution Development environment Application solution Software framework Hardware related Test verification Commercial FAQ ESP-FAQ » Instruction Edit on GitHub Instruction [中文] This section provides guidance on how to use ESP-FAQ. The “Question search” guides you through the repository’s search methods and categories, helping you find information more quickly. You are also welcome to contribute directly to ESP-FAQ by fixing bugs or adding new documents. For more details on how to contribute, please refer to “Document contribution”. Question search Document contribution Suggestion on this document? Provide feedback No answer found? Check issues on GitHub Ask the ESP community Contact technical support Previous Next © Copyright 2020 - 2026, Espressif Systems (Shanghai) Co., Ltd.. Built with Sphinx using a theme based on Read the Docs Sphinx Theme. Download PDF ESP-FAQ Choose version... Instruction Question search Question Search Techniques Search key words Exclude a Specific Keyword Question Classification Categories Document contribution Development environment Application solution Software framework Hardware related Test verification Commercial FAQ ESP-FAQ » Instruction » Question search Edit on GitHub Question search [中文] This instruction includes the following two parts： Question search techniques Question classification framework Question Search Techniques Currently, there are mainly two searching techniques: Search keywords Exclude a specific keyword Search key words Extract keywords from your question and search for them, then the search results should list the best matches. For example, if you expect to ask a question as What is the Bluetooth LE Throughput for ESP32? Then just searching keywords such as ESP32, BLE and throughput should give you the result. Exclude a Specific Keyword Add a tag - into the search content in the format: keyword -excluded keyword. By doing so, the search results will not show the specific keyword you excluded. For example, if you search ESP32 -ble, then any results with ble inside will not be shown. Question Classification Categories Once you have mastered the above mentioned question search techniques, you can use the categories in ESP-FAQ for reference to extract keywords for the questions you expect to ask and then search for them. The framework of ESP-FAQ categories is shown as follows: Development environment Application solution Software framework Hardware related Test verification Commercial FAQ Suggestion on this document? Provide feedback No answer found? Check issues on GitHub Ask the ESP community Contact technical support Previous Next © Copyright 2020 - 2026, Espressif Systems (Shanghai) Co., Ltd.. Built with Sphinx using a theme based on Read the Docs Sphinx Theme. Download PDF ESP-FAQ Choose version... Instruction Development environment IDE plugins Debugging Environment setup Firmware update Application solution Software framework Hardware related Test verification Commercial FAQ ESP-FAQ » Development environment Edit on GitHub Development environment [中文] IDE plugins Debugging Environment setup Firmware update Suggestion on this document? Provide feedback No answer found? Check issues on GitHub Ask the ESP community Contact technical support Previous Next © Copyright 2020 - 2026, Espressif Systems (Shanghai) Co., Ltd.. Built with Sphinx using a theme based on Read the Docs Sphinx Theme. Download PDF ESP-FAQ Choose version... Instruction Development environment IDE plugins How to add ESP32 development board on Arduino IDE? When using the Arduino IDE development platform, how to read the MAC address of the Wi-Fi that comes with ESP32? How to use the flash download tool to flash the bin file generated by Arduino to ESP32? How to update the esp32-arduino library version? Can ESP32-SOLO-1 be developed using the Arduino software? Debugging Environment setup Firmware update Application solution Software framework Hardware related Test verification Commercial FAQ ESP-FAQ » Development environment » IDE plugins Edit on GitHub IDE plugins [中文] How to add ESP32 development board on Arduino IDE? For installation instructions of Arduino-ESP32, please refer to arduino-ide getting started. For instructions on how to add development boards on Arduino IDE, please refer to arduino Cores. When using the Arduino IDE development platform, how to read the MAC address of the Wi-Fi that comes with ESP32? Please refer to the Arduino-ESP32 Development Framework. Use “WiFi.macAddress()” to obtain the MAC address of ESP32’s Wi-Fi. Please also refer to the WiFiClientStaticIP example. How to use the flash download tool to flash the bin file generated by Arduino to ESP32? Please navigate to File > Preferences > Show verbose output during, and check compilation. After compilation succeeded, a Python flashing command will be printed with the bin file to be flashed and the corresponding flashing address. For details, please refer to Arduino IDE Software Compilation Environment. Download the flash download tool, select the bin file when using the tool to flash, and enter the corresponding flashing address. For more information, please refer to Flash DownLoad Tool User Guide. How to update the esp32-arduino library version? Under the path Tool > Board > BoardManager, search for ESP32 to select and install the desired version of the esp32-arduino library. For more details, please refer to Installing ESP32 Arduino Software Development Environment on Windows. Can ESP32-SOLO-1 be developed using the Arduino software? Currently, the Arduino software development environment only supports the operation of ESP32 dual-core chips and does not support the operation of ESP32 single-core chips. Therefore, ESP32-SOLO-1 is not yet supported for development on Arduino software. If you prefer to use Arduino to build your code, you can use the arduino-esp32 library as an ESP-IDF component for development and testing. For more details, please refer to How to use the arduino-esp32 library as an ESP-IDF component?. Suggestion on this document? Provide feedback No answer found? Check issues on GitHub Ask the ESP community Contact technical support Previous Next © Copyright 2020 - 2026, Espressif Systems (Shanghai) Co., Ltd.. Built with Sphinx using a theme based on Read the Docs Sphinx Theme. Download PDF ESP-FAQ Choose version... Instruction Development environment IDE plugins Debugging What is the serial port name of ESP devices？ How to block debugging messages sent through UART0 by default in ESP32? How to modify the default method of RF calibration in ESP32? How to modify the default method of RF calibration in ESP8266? How to troubleshoot in ESP32 Boot mode？ When debugging with ESP32 JLINK, an ERROR occurs as: No Symbols For Freertos. How can I resolve such issue? How to monitor the free space of the task stack? Is it possible to use JTAG to debug with ESP32-S2？ How to modify the log output without changing the output level of menuconfig？ ESP8266 enters boot mode (2,7) and hits a watchdog reset. What could be wrong? When using the ESP-WROVER-KIT board with OpenOCD, an error occurred as Can't find board/esp32-wrover-kit-3.3v.cfg. How can I resolve such issue? The RTC_watch_dog keeps resetting during ESP32 SPI boot. What could be the reason? How to obtain and parse coredump with ESP32? How to do RF performance test with ESP32, ESP8266, and ESP32S2? What are the reasons for not being able to recognize ESP devices under the Win10 system? One error occurred with ESP32 as Core 1 panicked (Cache disabled but cache memory region accessed). What could be the reason? How to read the flash model information of the modules? When debugging the Ethernet Example in ESP-IDF, the following exception log appears. How can I resolve such issue? I found a “Brownout detector was triggered” failure on my ESP32. How to resolve such issue? After ESP32 imported the protocol_examples_common.h header file, the file cannot be found while compiling. What could be the reason? When using ESP8266 NonOS v3.0 SDK, the following error occurred. What could be the reason? When using flash_download_tool to flash firmware to the ESP8266 module, how to solve the following error? When upgrading from ESP-IDF v4.4 to v5.0 and above, the error esp_log.h:265:27: error: format ‘%d’ expects argument of type ‘int’, but argument 6 has type ‘uint32_t’ {aka ‘long unsigned int’} [-Werror=format=]265 | #define LOG_COLOR(COLOR) “033[0;” COLOR “m” is reported. How can this be resolved? Do ESP32 series products support the use of JTAG functionality in a boundary scan environment? Where can I download the BSDL files? Environment setup Firmware update Application solution Software framework Hardware related Test verification Commercial FAQ ESP-FAQ » Development environment » Debugging Edit on GitHub Debugging [中文] What is the serial port name of ESP devices？ The serial port name is usually assigned by the operating system, and different operating