projekte:wled
Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Nächste Überarbeitung | Vorhergehende ÜberarbeitungNächste ÜberarbeitungBeide Seiten der Revision | ||
projekte:wled [2024/01/02 22:05] – angelegt holger | projekte:wled [2024/01/15 02:13] – ecki | ||
---|---|---|---|
Zeile 1: | Zeile 1: | ||
====== WLED Anpassungen ====== | ====== 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, | ||
+ | * **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:// | ||
+ | |||
+ | ==== Schnellstart ==== | ||
+ | Nachfolgend wird beschrieben, | ||
+ | - Visual Studio Code installieren - https:// | ||
+ | - 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:// | ||
+ | - Zum gewünschten Branch (usermod) wechseln (unten links in der Status bar - default ist main) | ||
+ | - // | ||
+ | - kopierte // | ||
+ | - 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:// | ||
+ | - 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 // | ||
+ | - //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 // | ||
+ | - //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/ | ||
+ | - Englisch | ||
+ | - Fränkisch | ||
+ | - Wled Matrix Kompatibilität | ||
+ | - nicht benötigte LEDs nicht komplett abschalten, nur sehr stark dimmen -> Wled matrixeffekte anzeigen und gleichzeitig Wordclock sein | ||
+ | - Variable " | ||
+ | - 16*16 version -> Äußerer Rand kann zur sekundenanzeige genutzt werden, eventuell Datum oder Wochentag | ||
projekte/wled.txt · Zuletzt geändert: 2024/05/19 22:03 von andre