Our Eclipse IDE resources here may well be old, we’ve switched over to using VSCode



NOTE: The esp-idf build system does not support spaces in paths to projects

Create a project In Eclipse

Menu > File > New > Project…

Espressif > Espressif IDF Project

Set the name and location (DO NOT USE SPACES IN PATH)

Use a template project?

Select “Create a project using one of the templates” and select one

Press Finish

Configure Launch target

Connect your ESP-Prog or similar debugger and gets its port number.

The Launch bar is usually on the far left of the toolbar in Eclipse and has Build, Run & Stop buttons and 3 dropdowns.
If the launch bar is not shown: Menu > Window > Preferences > Run/Debug > Launching > Launch Bar > Enable the Launch Bar = CHECKED

Click the third dropdown from the launch bar > New Launch Target > ESP Target
Give it a name
Select the Serial Port your ESP device or ESP-Prog is connected to (lower port number = JTAG for ESP-Prog)
Click Finish


In the toolbar ensure Run mode, your project and your device is selected. Then press the Build button.

Check the Output window for any build issues you need to resolve.


Select Debug mode from the Launch Bar.

We benefit hugely from resources on the web so we decided we should try and give back some of our knowledge and resources to the community by opening up many of our company’s internal notes and libraries through mini sites like this. We hope you find the site helpful.
Please feel free to comment if you can add help to this page or point out issues and solutions you have found, but please note that we do not provide support on this site. If you need help with a problem please use one of the many online forums.


Your email address will not be published. Required fields are marked *