Inhaltsverzeichnis
Programmierung
Stand: 01/25
Das Repository auf Github enthält den Quellcode des Projekts. Aus diesem Code wird (Programmiersprache C++) ein für den Microcontroller passendes Software-Image gebaut, das anschließend auf den ESP8266 übertragen wird. Für den Build-Prozess des Image ist eine spezielle Umgebung erforderlich. In den meisten Fällen wird diese Aufgabe von der Arduino-Ide erledigt. Bei diesem Projekt wird PlatformIO verwendet. Diese Software ist als Plugin für den Code-Editor Visual Studio Code erhältlich.
Wichtiger Hinweis:
Das Code-Projekt ist speziell für PlatformIO konzipiert. Du kannst es nicht ohne Anpassungen mit der Arduino-IDE nutzen.
Öffnet man den Sourcecode-Ordner mit Visual Studio Code, identifiziert die IDE mithilfe der
Konfigurationsdatei platformio.ini
das Projekt und lädt die fehlenden Programmteile nach.
Eine Besonderheit dieses Projekts ist das Verwenden eines Filesystems zur Ablage der Website-Bestandteile
wie HTML-, CSS- und JavaScript-Dateien. Alle dazugehörigen Dateien befinden sich im Verzeichnis /data
.
Während des Builds entsteht aus diesen Dateien ein zweites Image, das ebenfalls auf den Microcontroller
übertragen wird.
Der Build-Prozess und die Übertragung der gebauten Images erfolgen manuell. Das PlatformIO-Menü stellt dafür zahlreiche Kommandos bereit.
Zwei Aktionen sind relevant:
Upload
: Dieses Kommando baut das Betriebssystem-Image und überträgt es auf den Microcontroller. Dazu verbindet man den ESP8266 über den USB-Anschluss mit dem PC.Upload Filesystem Image
: Dieses Kommando packt die Web-Bestandteile in ein Image und überträgt es an den Microcontroller.
Die Reihenfolge der Aktionen spielt keine Rolle. Manchmal treten Timeout-Fehler beim Upload des Filesystem-Images auf, die ignoriert werden können.