ESP32-P4: WT9932P4-MINI-A1 Setup & Fehlerbehebung

Dieses Handbuch beschreibt die Inbetriebnahme des WT9932P4_Mini_A1 Entwicklungsboards[cite: 131]. Das Board basiert auf dem leistungsstarken ESP32-P4 System-on-Chip (SoC) von Espressif, der speziell für hochauflösende Multimedia-Anwendungen und KI-gestützte Bildverarbeitung entwickelt wurde[cite: 131]. In diesem Projekt wird eine Smartphone-ähnliche UI auf Basis des ESP-Brookesia Frameworks instanziiert[cite: 132].

Systemvoraussetzungen: Es wird zwingend die ESP-IDF Version v5.5 (Entwicklungszweig) auf Windows 10/11 (64-Bit) benötigt[cite: 143, 145]. Der exakte Git Commit Hash lautet cbe9388f45dd8f33fc560c9727d429e8e107d476[cite: 144].

1. Software-Installation

Starten Sie den interaktiven ESP-IDF Windows-Installationsassistenten[cite: 147].
Wählen Sie zwingend die Option "Custom Installation" (Start Configuration Wizard)[cite: 148].
Wählen Sie im Verlauf die Version 5.5 aus[cite: 150].
Behalten Sie die Standardwerte bei den Download Mirrors (github.com, dl.espressif.com/github_assets und pypi.org/simple) bei, um optimale Übertragungsraten zu garantieren[cite: 151, 152].

2. Compiler- & Projektkonfiguration

Öffnen Sie das Windows-Startmenü und starten Sie die Applikation ESP-IDF 5.5 PowerShell[cite: 159]. Verwenden Sie keine reguläre System-PowerShell, da dieser die Verweise auf den RISC-V-Compiler fehlen[cite: 160].

git clone https://github.com/wireless-tag-com/WT9932P4-MINI-A1.git
cd WT9932P4-MINI-A1
idf.py set-target esp32p4
idf.py reconfigure

Der Befehl reconfigure wertet die idf_component.yml aus und lädt automatisch das UI-Framework esp-brookesia (v0.4.2) sowie LVGL herunter[cite: 167]. Über den Befehl idf.py menuconfig können unter "Example Configuration" folgende Peripherie-Demos aktiviert werden[cite: 169]:

Use eth demo: Aktiviert den IP101 Ethernet PHY[cite: 170].
Use MSC USB demo: Aktiviert Dateisystemoperationen (Lese-/Schreibzugriffe) auf USB-Sticks via VFS[cite: 171].

3. Kritische Fehlerbehebung (Troubleshooting)

Ein häufiger Fehler ist ein Abbruch während des CMake-Konfigurationsschritts mit der Meldung "Check for working C compiler... broken"[cite: 173, 174]. Dies rührt oft von einer Blockade durch Antivirensoftware (z. B. Windows Defender) her, welche das Kompilierungswerkzeug cc1.exe blockiert[cite: 180, 181].

Fügen Sie den Pfad C:\Espressif komplett als Ausschluss/Ausnahme im Antivirenprogramm hinzu[cite: 183].
Navigieren Sie im Explorer zu C:\Espressif\tools\ und löschen Sie den Ordner riscv32-esp-elf restlos[cite: 185].
Wechseln Sie im ESP-IDF Terminal in das Framework-Verzeichnis und stoßen Sie das Setup-Skript erneut an: .\install.ps1[cite: 186, 187].
Wechseln Sie zurück in das Projektverzeichnis und löschen Sie den korrupten Cache: idf.py fullclean gefolgt von idf.py set-target esp32p4[cite: 188, 189, 190].

4. Kompilieren und Flashen

Sobald die Werkzeuge fehlerfrei arbeiten, kann das System kompiliert und geflasht werden[cite: 192]:

idf.py build flash monitor

Der erste Kompilierungsvorgang beansprucht mehrere Minuten[cite: 194]. Der Parameter monitor öffnet unmittelbar nach dem Flashen die serielle Konsole des Boards[cite: 195].

Anhang: Speicher & Komponenten

Das Partitionslayout umfasst unter anderem den Hauptanwendungsbereich factory mit 9 MB für die Smartphone-UI Binärdaten, nvs (24 KB) für Parameter und phy_init (4 KB) für Funk-Werte[cite: 205]. Zentrale Komponenten des Projekts sind espressif/esp-brookesia (0.4.2), lvgl/lvgl (8.4.0) und das KI-Inferenz-Framework espressif/esp-dl (3.1.0)[cite: 207].

➕ Neue Anleitung erstellen