STERNENLABOR

Diese Seite ist nicht editierbar. Sie können den Quelltext sehen, jedoch nicht verändern. Kontaktieren Sie den Administrator, wenn Sie glauben, dass hier ein Fehler vorliegt.
====== WLED Anpassungen ======

Für Projekte des Sternenlabor gibt es verschiedene Anpassungen des WLED Quellcodes an unsere Bedürfnisse.
  * **wordclock** Ein usermod für den von Nick abgehaltenen Wordclock Workshop. Im Gegensatz zum Original wordclock usermod wird das 24h Format unterstützt und es gibt verschiedene Dialekte.
  * **dcf77** Der usermod dient dazu, die Zeit nicht über NTP, also per Internetverbindung zu aktualisieren sondern über ein DCF77 Funkuhrmodul. Prinzipiell funktioniert der usermod allerdings gibt es bei den DCF77 Modulen große Unterschiede in der Qualität. Aus diesem Grund sollten hier noch weitere Untersuchungen gemacht werden.
  * **lilygo** Der usermod ermöglicht es über ein Touch-Display verschiedene Presets auszuwählen. Er wurde speziell für die Unterbodenbeleuchtung des Fabmobils erstellt. Ist ein Preset aktiv bzw. ist die Helligkeit != 0 so blinkt der Hintergrund des Displays rot um zu signalisieren, dass die Unterbodenbeleuchtung aktiv ist. Die angelegten Presets können über einen Tumbler ausgewählt werden. Es wird die folgende Hardware benötigt: https://www.lilygo.cc/products/t-display-s3.
  * **cloud_hmi** Der usermod dient dazu das WLED über zwei Drehencoder anzusteuern bzw. den aktuellen Status über ein OLED Display anzuzeigen. Hierzu wird es noch ein separates GIT Projekt geben in welchem die Hardware abgelegt wird.

===== Usermod nutzen =====
Die usermods sind auf unserem Git Hub Account im WLED Repository abgelegt. Hierbei handelt es sich um einen Fork des originalen WLED Projektes, die oben beschriebenen uesermods befinden sich in den gleichnamigen branches.

https://github.com/Sternenlabor/WLED

==== Schnellstart ====
Nachfolgend wird beschrieben, wie der Quellcode bzw. Usermod übersetzt und aufgespielt wird. 
  - Visual Studio Code installieren - https://code.visualstudio.com/
  - Visual Studio Code öffnen und unter Erweiterungen PlatformIO IDE installieren
  - Optional die Erweiterung **Git Graph** installieren (Empfohlen für Update / Rebase der Usermods)
  - Repository https://github.com/Sternenlabor/WLED clonen z.B. innerhalb VS-Code
  - Zum gewünschten Branch ("wordclock") wechseln (unten links in der Status bar - default ist "main")
  - //platformio_override.ini.sample// aus dem usermod Verzeichnis z.B. usermods/usermod_v2_word_clock24 in das Projektverzeichnis kopieren (gleiche Ebene wie //platformio.ini//)
  - kopierte //platformio_override.ini.sample// in //platformio_override.ini// umbenennen
  - ESP Controller per USB anstecken
  - usermod mittels //Pfeil Icon// in Status Bar übersetzen und flashen

==== Usermod aktualisieren ====
Das WLED Projekt wird stetig weiter entwickelt. Damit die Neuerungen und Verbesserungen in die usermods einfließen könne, müssen diese von Zeit zu Zeit aktualisiert werden. Der prinzipielle Workflow ist wie folgt.
  - Sternenlabor WLED Fork mit original WLED Repository synchronisieren (main Branch)
  - Branch des usermods auf aktualisierten main Branch rebasen
  - Aktualisierten branch veröffentlichen

Bevor der branch nach der Aktualisierung auf dem Repository überschrieben wird, sollten die Anpassungen ausreichen getestet werden da mit dem beschriebenen Vorgehen die letzte Version verloren geht.
**Vorgehensweise:**
  - Auf Github anmelden (Account wird benötigt)
  - Auf https://github.com/Sternenlabor/WLED wechseln
  - Button //Sync fork// drücken (Account muss Mitglied von Sternenlabor sein) - der main Branch des Sternenlabor Repos wird nun auf den Stand des original Repos aktualisiert
  - VS-Code öffnen
  - Auf main Branch wechseln (Status Bar links unten)
  - Auf der Linken Seite das Quellcodeverwaltungs Icon (GIT) drücken (Icon mit drei verbundenen Bobbeln)
  - Im //Quellcodeverwaltungs// Bereich das Icon mit den //drei Punkten// anklicken
  - //Pull// auswählen
  - Auf gewünschten usermod branch wechseln
  - Auf der Linken Seite das Quellcodeverwaltungs Icon (GIT) drücken (Icon mit drei verbundenen Bobbeln)
  - //GIT Graph// Icon links vom //drei Punkte // Icon anklicken
  - Rechtsklick auf den letzten commit im //main/origin// branch (grafische Kennzeichnung)
  - //Rebase current branch on Branch...// auswählen
  - Es werden nun alle Commits des aktuellen branches bis zum Ursprung in main zurückgenommen. Dann wird auf den neusten Commit im main Branch gesprungen und die zuvor zurückgenommen commits nacheinander eingespielt (rebase). Hierbei kann es zu Konflikten kommen insbesondere wenn neue usermods erstellt wurden. Die Konflikte können direkt in VS-Code gefixt und übernommen werden.
  - Sobald der Rebase abgeschlossen wurde, sollte das Projekt übersetzt und getestet werden. Sind weitere Korrekturen nötig, können diese über in einem weiteren Commit behoben werden.
  - Funktioniert der Usermod wie gewünscht, müssen die Änderungen noch in das SL Repository übernommen werden. Da ein rebase durchgeführt wurde, müssen die Änderungen über einen //force push// auf den Server gebracht werden. Hierzu öffnet man in VS-Code ein Terminal und führt //git push --force// aus.

==== Ideen zur Erweiterung und Verbesserung ====
  - Weitere Sprachen/Dialekte
    - Englisch
    - Fränkisch -> done -FE
  - Wled Matrix Kompatibilität -> sollte machbar sein: strip.setpixelcolorxy();
  - nicht benötigte LEDs nicht komplett abschalten, nur sehr stark dimmen -> Wled matrixeffekte anzeigen und gleichzeitig Wordclock sein -> geht, könnte aber mit manchen Effekten performanceprobleme machen
  - Variable "matrix"-Größe 
  - 16*16 version -> Äußerer Rand kann zur sekundenanzeige genutzt werden, eventuell Datum oder Wochentag