Bearbeiten von „Micropython mit LVGL zusammen kompilieren“

= MicroPython mit LVGL für ESP32 selbst bauen =

== Voraussetzungen ==
* Git ist installiert
* Docker ist installiert (falls nötig, aber nicht zwingend für nativen Build)
* ESP-IDF ist installiert und korrekt initialisiert (getestet mit ESP-IDF v5.1 oder v5.2)

== Vorbereitung ==
Zunächst alle alten Installationen und Downloads löschen:

<syntaxhighlight lang="bash">
rm -rf ~/mpy_lvgl_test
</syntaxhighlight>

== Schritte ==

=== 1. Repository klonen ===
Das LVGL-MicroPython-Repository mit allen Submodulen klonen:

<syntaxhighlight lang="bash">
mkdir -p ~/mpy_lvgl_test
cd ~/mpy_lvgl_test
git clone --recurse-submodules https://github.com/lvgl/lv_binding_micropython.git
cd lv_binding_micropython
</syntaxhighlight>

=== 2. ESP-IDF Umgebung laden ===
Die ESP-IDF-Umgebung aktivieren:

<syntaxhighlight lang="bash">
source ~/esp-idf/export.sh
</syntaxhighlight>

=== 3. In das ESP32-Port-Verzeichnis wechseln ===

<syntaxhighlight lang="bash">
cd ports/esp32
</syntaxhighlight>

=== 4. Target setzen ===

Damit MicroPython für ESP32 kompiliert wird:

<syntaxhighlight lang="bash">
idf.py set-target esp32
</syntaxhighlight>

(Dadurch wird eine neue `sdkconfig` erstellt.)

=== 5. Build starten ===

Jetzt den MicroPython Build starten:

<syntaxhighlight lang="bash">
idf.py build
</syntaxhighlight>

=== Hinweis ===
* Warnungen über ''tinyusb'' können ignoriert werden.
* Das Menü ''menuconfig'' kann durch Drücken von ''Q'' verlassen werden, wenn keine Änderungen nötig sind.

== Abschluss ==
Nach erfolgreichem Build kann mit

<syntaxhighlight lang="bash">
idf.py flash
</syntaxhighlight>

die Firmware direkt auf den ESP32 geflasht werden.

== Troubleshooting ==
* Bei Fehlern bzgl. fehlender Submodule: `git submodule update --init --recursive`
* Immer sicherstellen, dass die ESP-IDF-Umgebung aktiv ist: `source ~/esp-idf/export.sh`

= Fertig! =