Kumiki – Firmware mit einer ausgetauschten Arduino-Bibliothek neu linken

Dieses Paket enthält die übersetzten Kumiki-Anwendungsobjekte der angegebenen
Firmwareversion, die dazugehörigen Arduino-Quellen und ein PlatformIO-Projekt.
Die Prüfsumme in release.json bezeichnet das ursprünglich veröffentlichte
firmware.bin. Durch ein erneutes Linken können Build-ID, Zeitstempel oder das
Layout abweichen. Ein bitgleiches Ergebnis ist für den Austausch der
Bibliothek nicht erforderlich.

1. Installiere PlatformIO Core 6.x und entpacke das ZIP in einen eigenen
   Ordner. Für die folgenden Befehle muss das Kommando pio verfügbar sein.
2. Öffne ein Terminal im entpackten Ordner. Setze PLATFORMIO_CORE_DIR auf
   einen eigenen, absoluten Pfad für diesen Build. Beispiel für macOS/Linux:
     export PLATFORMIO_CORE_DIR="$PWD/.pio-core"
   In Windows PowerShell:
     $env:PLATFORMIO_CORE_DIR = "$PWD/.pio-core"
3. Führe "pio run -e es3c35p" aus. PlatformIO installiert das in
   platformio.ini festgelegte Framework, das ESP-IDF-SDK, die Bibliotheken
   und die passende Toolchain und erstellt .pio/build/es3c35p/firmware.bin.
4. Um eine Bibliotheksänderung zu testen, ändere beispielsweise eine Datei in
   arduino-source/cores/esp32 oder in arduino-source/libraries. Ersetze die
   entsprechende Datei im gleichnamigen Unterordner unter
   .pio-core/packages/framework-arduinoespressif32/. Mit dem eigenen
   PLATFORMIO_CORE_DIR betrifft diese Änderung nur deinen Relink-Build.
   Starte "pio run -t clean" und anschließend "pio run -e es3c35p" erneut.
   relink.py gibt dem Linker die mitgelieferten Kumiki-Objekte mit.
5. Zum Flashen dieses eigenen Builds auf dein passendes Gerät verwende
   "pio run -e es3c35p -t upload". Den richtigen Port kannst du optional
   mit "--upload-port PORT" angeben.

Zum Auswechseln der Bibliothek und zum Debuggen solcher Änderungen gelten die
Rechte aus der LGPL. Fremde Komponenten behalten ihre jeweiligen Lizenzen.
