Entwicklungsumgebung für "ESP-IDF" mit "Visual Studio Code" unter Windows 11 einrichten

Schritt 1) Visual Studio Code und ESP-IDF Extension installieren

VS Code herunterladen und installieren
ESP-IDF Plugin für VS Code installieren
VS Code starten, auf die „Extensions“ gehen (Strg+Shift+X) und nach „Espressif IDF“ suchen. Die gefundene Extension installieren

Schritt 2) ESP-IDF und Toolchain einrichten

Drücke in VS Code F1 oder Strg+Shift+P und tippe „ESP-IDF: Configure ESP-IDF Extension“ in das Dialogfenster.
Wähle „EXPRESS“ für die schnelle Installation
Wähle ESP-IDF Version 5.5 aus der Liste
Wähle einen Installationspfad (z.B. C:\esp\esp-idf). Die Extension lädt und installiert dann automatisch:
1. ESP-IDF Framework
2. Toolchain
3. Python-Pakete
4. OpenOCD (für Debugging)

Schritt 3) Erstes Projekt erstellen

F1 → „ESP-IDF: Show Examples Projects“
Wähle ein Beispiel wie „blink“ oder „hello_world“
Wähle einen Ordner für dein Projekt
Oder: F1 → „ESP-IDF: New Project“ für ein leeres Projekt
Beim Template das „sample template“ wählen

Projektstruktur (minimal):

mein_projekt/
├── main/
│   ├── CMakeLists.txt
│   └── main.c
└── CMakeLists.txt

Die CMakeLists.txt im Projektordner:

cmake_minimum_required(VERSION 3.16)
 
include($ENV{IDF_PATH}/tools/cmake/project.cmake)
project(mein_projekt)

Schritt 4) Target konfigurieren

Öffne die Command Palette (F1) „ESP-IDF: Set Espressif Device Target“ Wähle deinen Chip (ESP32, ESP32-C3, ESP32-S3, etc.)

Schritt 5) Software compilieren (build) und Flashen

Unten in der Status-Leiste von VS Code findest du Buttons für:

Build (Hammer-Symbol) - Projekt kompilieren Flash (Blitz-Symbol) - auf ESP flashen Monitor (Stecker-Symbol) - Serielle Konsole öffnen Build, Flash and Monitor - Alles in einem

Schritt 6) Wichtige Konfigurationen

Erstelle/bearbeite .vscode/settings.json in deinem Projekt:

json{
    "idf.portWin": "COM3",  // Deinen COM-Port (Windows)
    "idf.flashBaudRate": "921600",
    "idf.openOcdConfigs": [
        "board/esp32-wrover-kit-3.3v.cfg"
    ]
}

Nützliche Tastenkombinationen

Strg+E dann B - Build
Strg+E dann F - Flash
Strg+E dann M - Monitor
Strg+E dann D - Build, Flash, Monitor

Problembehandlung

Falls die Express-Installation nicht funktioniert, kannst du auch „ADVANCED“ wählen und ESP-IDF manuell von GitHub klonen oder eine bereits installierte Version angeben. Brauchst du Hilfe bei einem spezifischen Schritt oder hast du bereits ESP-IDF installiert?