Skip to content

espressif/idf-eclipse-plugin

Repository files navigation

Espressif-IDE

The official Eclipse-based IDE for ESP-IDF development

GitHub Release License GitHub Issues Build Status

macOS Windows Linux

Documentation · Download · Report Bug · 中文


Espressif-IDE is a standalone, customized IDE built on Eclipse CDT for developing IoT applications with ESP-IDF. It bundles the IDF Eclipse plugins, Eclipse CDT, and essential third-party plugins into a single ready-to-use environment for the entire ESP32 family of chips.

Key Features

Write

Feature Description
Project Wizards Create new projects from scratch or from 100+ ESP-IDF example templates
Clangd-Powered Editor LSP-based C/C++ editor with code completion, navigation, and real-time diagnostics
CMake Editor Syntax highlighting and content assist for CMakeLists.txt files
SDK Configuration (menuconfig) Visual editor for Kconfig options -- no terminal needed

Build

Feature Description
CMake Build System Full integration with ESP-IDF's CMake-based build
Toolchain Management Auto-configured ESP GCC and Clang toolchains
ESP-IDF Manager Install, manage, and switch between multiple ESP-IDF versions from inside the IDE
Size Analysis Visualize your firmware's static memory footprint (RAM/Flash)

Flash

Feature Description
UART Flashing One-click flash over serial using idf.py flash
JTAG Flashing Flash via JTAG debug probes
DFU Flashing Flash over USB using Device Firmware Update protocol
Partition Table Editor Visual editor for custom partition layouts
NVS Editor Create and edit Non-Volatile Storage partition data

Debug

Feature Description
OpenOCD Debugging Fully integrated JTAG debugging with pre-built launch configurations
GDB Stub Debugging Debug panics and exceptions over serial
Core Dump Analysis Post-mortem debugging from crash dumps
Heap Tracing Profile memory allocations and detect leaks at runtime
App-Level Tracing Collect real-time trace data from running firmware

Monitor & Simulate

Feature Description
Serial Monitor Integrated terminal for viewing device output
ESP-IDF Terminal Pre-configured shell with all build environment variables set
Wokwi Simulator Test your firmware on a virtual ESP32 -- no hardware required

Quick Start

Option 1: Download Espressif-IDE (Recommended)

Download the latest standalone installer from the releases page for your platform.

Option 2: Install the Plugin into an Existing Eclipse

Install from the Eclipse Marketplace or the update site. See the installation guide for details.

First Steps

  1. Launch Espressif-IDE
  2. Install ESP-IDF and tools through the built-in ESP-IDF Manager
  3. Create a new project using File > New > Espressif IDF Project
  4. Select a target chip and serial port
  5. Build, flash, and monitor

Full walkthrough in the official documentation.

Building from Source

Prerequisites: Java 17+ and Maven 3.9+

git clone https://github.com/espressif/idf-eclipse-plugin.git
cd idf-eclipse-plugin
mvn clean verify -Djarsigner.skip=true

The p2 update site artifact is generated at releng/com.espressif.idf.update/target/. Install it using the local archive instructions.

Getting the Latest Development Build

  1. Go to the latest commits on master
  2. Click the green checkmark on the latest commit
  3. Click Details > Summary
  4. Download the com.espressif.idf.update artifact from the Artifacts section
  5. Install using the local archive instructions

Contributing

We welcome contributions! See CONTRIBUTING.md for development environment setup, coding guidelines, and how to submit pull requests.

Resources

Reporting Issues

Found a bug or have a feature request? Please open an issue here with your environment details and relevant logs.

License

This project is licensed under the Eclipse Public License v2.0.