How to Install ESP-IDF on Eclipse IDE for ESP32 Development
In this tutorial, you’ll learn how to install ESP-IDF on Eclipse IDE, the official development framework recommended by Espressif for ESP32 projects. This step-by-step guide is designed to help you set up a stable and reliable development environment, whether you’re a beginner or refining your existing setup.
Before starting, make sure the ESP-IDF Plugin for Eclipse is already installed. In addition, several prerequisite tools are required to ensure a smooth installation and error-free development experience.
All necessary download links and related resources are provided below.
🔗 ESP-IDF Releases (GitHub):
https://github.com/espressif/esp-idf/releases
About This Tutorial
Hello, I’m Behnam Jafari, and welcome to the PicoBit-Tech channel.
In this session, I’ll guide you through installing ESP-IDF on Eclipse using the method officially recommended by Espressif.
To proceed with this tutorial, the following software must already be installed on your system:
-
MinGW (via MSYS2)
-
Git
-
Python
-
JDK
-
ESP-IDF Plugin for Eclipse
⚠️ Important Note:
The ESP-IDF Plugin and ESP-IDF itself are two separate components. Both must be installed correctly for Eclipse to work properly with ESP-IDF.
Recommended Installation Order
For best results, follow this installation sequence:
-
Install MinGW using MSYS2
-
Install Git
-
Install JDK and Python
-
Install the ESP-IDF Plugin for Eclipse
If you need a detailed explanation of these prerequisites, refer to the related videos linked at the top of this page.
Downloading ESP-IDF
-
Open your browser and navigate to the official ESP-IDF GitHub repository.
-
At the time of recording, the latest version is ESP-IDF v5.4.
-
In this tutorial, we use ESP-IDF v5.3 for stability and compatibility reasons.
-
Scroll to the Assets section, download the ZIP file for version 5.3, and extract it to a suitable directory on your system.
Adding ESP-IDF to Eclipse
-
Launch Eclipse IDE.
-
On the workspace selection screen, you may keep the default path and click Launch.
-
From the Espressif menu, select Add ESP-IDF.
-
Choose Use an existing ESP-IDF directory.
-
Click Browse and select the folder where you extracted ESP-IDF.
💡 Tip:
If Eclipse automatically downloads an ESP-IDF version that causes errors, delete it and manually replace it with the version downloaded from GitHub.
Ensure that the paths for Git and Python are correctly detected. It is recommended to use default installation paths for these tools.
Click Finish to complete the setup.
Verifying the Installation
After installation:
-
Open ESP-IDF Manager and verify the installed version.
-
Go to File → New → Project.
-
Select Espressif IDF Project and click Finish.
-
Choose Create a project using one of the templates.
-
Select the Hello World template and click Finish.
Open the project, locate the main C file, and review the source code.
If some code elements appear unrecognized, this will be resolved during the build process, as Eclipse will automatically download required dependencies via Git.
