WLED xLights Weihnachten Echtzeit Anleitung

WLED und xLights: Wann Sie es brauchen, DDP einrichten und die Kontrolle zurückbekommen

Wann WLED allein reicht und wann sich xLights lohnt, wie Sie xLights über DDP oder E1.31 an WLED senden, welche Einstellungen auf beiden Seiten zählen und wie WLED nach einer Show die Kontrolle zurückholt.

Von

Geschrieben von Jamie Conde, die WLED Max bei MeowScript entwickelt. WLED Max ist eine unabhängige App, die mit dem offiziellen WLED-Projekt weder verbunden ist noch von ihm empfohlen wird.

Kurze Antwort: WLED führt Effekte selbst aus; xLights ist für Shows, die zur Musik über viele Props sequenziert sind. Beide arbeiten zusammen: xLights sendet die Farbe jedes Pixels über das Netzwerk, und WLED zeigt sie nur an. Fügen Sie das Licht in xLights als Ethernet-Controller mit Hersteller (Vendor) WLED und Protokoll DDP hinzu. WLED braucht für DDP keine Einstellung. Wenn xLights aufhört zu senden, kehrt WLED nach 2,5 Sekunden zu seinem eigenen Effekt zurück.

Brauchen Sie xLights überhaupt?

Die meisten WLED-Nutzer nicht. Eine Faustregel aus dem WLED-Forum bringt es auf den Punkt: WLED schafft viele LED-Installationen allein, und xLights ist das Werkzeug, wenn Sie Ihren ganzen Garten als eine Show steuern wollen.

Sie wollenVerwenden Sie
Schöne Effekte an Dachkante, Baum oder Fenster, die nach Zeitplan wechselnWLED allein, mit Szenen, Szenenfolgen und Timern
Feiertagsmuster wie rot-weiß oder ZuckerstangeWLED allein, siehe Weihnachtsmuster
Mehrere Lichter mit demselben Effekt synchronWLED allein, mit UDP-Synchronisierung
Lichter im Takt eines Songs, Schlag für SchlagxLights
Mega-Tree, Matrix, Bögen und Dachkante als eine einzige AnzeigexLights
Eine Show, die jeden Abend nach Zeitplan ohne Computer läuftxLights zum Erstellen, Falcon Player (FPP) auf einem Raspberry Pi zum Abspielen

xLights ist kostenlos und leistungsfähig, und außerdem ein Hobby für sich. Einen Song zu sequenzieren kann einen Abend dauern. Wenn das Haus im Dezember einfach gut aussehen soll, bringt Sie WLED allein schon fast ans Ziel.

Wie die beiden zusammenpassen

In einer Show ist WLED nicht mehr die Steuerzentrale. xLights (oder FPP, das die Show abspielt) sendet einen Strom von Einzelbildern, jedes mit der Farbe jedes Pixels. WLED wechselt in den Echtzeitmodus: Es löscht den Streifen, zeigt, was ankommt, und ignoriert eigene Effekte, Szenen und Timer, bis der Strom aufhört.

Deshalb lautet die häufigste xLights-Frage im WLED-Forum eigentlich "Warum ignoriert mein WLED die App?". Dazu gibt es eine eigene Seite: WLED hängt im Echtzeitmodus.

DDP oder E1.31?

WLED akzeptiert drei Show-Protokolle. DDP und E1.31 sind standardmäßig an. Für Art-Net stellen Sie unter Sync Interfaces, Network DMX input, Type auf Art-Net. Dadurch empfängt WLED auf Port 6454 statt 5568. E1.31 und Art-Net können also nicht gleichzeitig aktiv sein.

DDPE1.31 (sACN)Art-Net
Port404855686454
Einstellung in WLEDkeine, immer anNetwork DMX input, DMX modedieselbe, Type Art-Net
Universenkeine, nur ein Pixel-Offset170 RGB-Pixel pro Universumwie E1.31
RGBWja in WLED, aber xLights lehnt es beim Hochladen nach WLED abja, mit DMX mode Multi RGBWja
xLights-Standard für WLEDja

Verwenden Sie DDP, sofern nichts dagegen spricht. Es ist das, was xLights wählt, wenn es einen WLED-Controller findet, es gibt keine Universen zum Abgleichen, und es ist effizient. Verwenden Sie E1.31 für RGBW-Pixel oder wenn Ihre Show in FPP um Universen herum aufgebaut ist.

WLED einrichten

Für DDP gibt es fast nichts zu tun. Prüfen Sie Folgendes unter Config›LED & Hardware (LED Preferences auf 0.14 und 0.15):

  • Die LED-Anzahl und die Reihenfolge der Ausgänge entsprechen der echten Verkabelung.
  • Das Licht hat eine feste Adresse (eine DHCP-Reservierung in Ihrem Router).

Für E1.31 öffnen Sie Config›Sync Interfaces und suchen Network DMX input im Abschnitt Realtime:

  • Type: E1.31 (sACN).
  • Start universe: das erste Universum, das xLights an dieses Licht sendet (standardmäßig 1).
  • DMX mode: Multi RGB für RGB-Pixel, Multi RGBW für RGBW. Die WLED-Dokumentation nennt Multi RGB "the mode you want to use for xLights" (den Modus, den Sie für xLights verwenden sollten).
  • Multicast: so wie xLights sendet. Unicast (aus) ist im WLAN einfacher.

Der Rest des Abschnitts Realtime ist für beide Protokolle wichtig:

  • Timeout (standardmäßig 2500 ms): wie lange WLED nach dem letzten Bild wartet, bevor es zu seinem eigenen Effekt zurückkehrt.
  • Force max brightness: zeigt den Stream mit voller Helligkeit statt mit Ihrer WLED-Helligkeit.
  • Use main segment only: der Stream landet nur im Hauptsegment, die anderen behalten ihre WLED-Effekte. Ist das aktiv, ignoriert WLED die unten beschriebene lor-Übersteuerung.
  • Respect LED Maps (0.15 und neuer): wendet Ihre LED-Map (ledmap.json) auch auf den Stream an.

In WLED Max auf dem iPhone finden Sie die E1.31-Einstellungen und das Zeitlimit unter Geräteeinstellungen, Synchronisierung, im Abschnitt E1.31 / DMX / Art-Net. Auf Android ist es dieselbe Stelle: Geräteeinstellungen, Synchronisierung, E1.31 / DMX / Art-Net. Das Feld Zeitlimit der App zählt in Schritten von 100 ms, 25 dort bedeutet also 2500 ms.

xLights einrichten

xLights hat WLED als Controller-Hersteller eingebaut, mit Modellen für generische ESP8266- und ESP32-Boards und mehreren QuinLED-Boards.

  1. Öffnen Sie den Tab Controllers und klicken Sie auf Add Ethernet. (Oder probieren Sie Discover: Es findet WLED-Lichter in Ihrem Netzwerk und füllt den Rest aus.)
  2. Geben Sie die IP Address des Lichts ein, setzen Sie Vendor auf WLED, dann Model auf WLED mit Variant Generic ESP32 oder Generic ESP8266, oder wählen Sie Ihr Board als Model (QuinLED Dig-Uno, Dig-Quad, Dig-Octa und andere).
  3. Setzen Sie Protocol auf DDP. Lassen Sie Keep Channel Numbers aus.
  4. Legen Sie Ihre Props im Tab Layout an, gehen Sie dann zurück zum Controller, klicken Sie auf Visualise und ziehen Sie jedes Prop auf den Port, an dem es angeschlossen ist.
  5. Mit Auto Size ermittelt xLights die Kanalzahl aus den Props. Von Hand sind es LEDs × 3 für RGB.
  6. Speichern Sie und schalten Sie die Ausgabe an die Lichter ein (die Glühbirnen-Schaltfläche in der Symbolleiste).

Sollten Sie xLights in WLED hochladen lassen?

Die Schaltfläche Upload Output schreibt die Port-Konfiguration (LED-Anzahl, GPIO-Pins, LED-Typ, Farbreihenfolge) in WLED und startet das Licht neu. Für einen frischen Controller ist das praktisch, aber es überschreibt die LED-Einstellungen von WLED, und im Forum gibt es Berichte, dass es GPIO-Einstellungen gelöscht hat. Wenn Ihr WLED bereits eingerichtet ist und läuft, setzen Sie die LED-Anzahl selbst in WLED und lassen das Hochladen weg. Sichern Sie in jedem Fall vorher: WLED-Konfiguration sichern und wiederherstellen.

Zwei Fehler beim Hochladen, die Ihnen begegnen können, und was sie bedeuten:

  • "The DDP 'Keep Channel Numbers' option is not support with WLED": Schalten Sie diese Option aus.
  • "Four Channel Pixles and DDP, do not work well in WLED": Ihre Props sind RGBW. Stellen Sie diesen Controller auf E1.31 um und den DMX mode in WLED auf Multi RGBW.

WLAN, Bildraten und große Shows

Streaming über WLAN funktioniert für einige wenige Controller. Mit wachsender Show wird es schwieriger: Jedes Pixel jedes Bildes geht über die Luft, und Forenthreads beschreiben Shows mit einem Dutzend WLAN-Controllern, die auf ein paar Bilder pro Sekunde einbrechen.

  • Schließen Sie den Computer oder FPP, der die Show sendet, per Netzwerkkabel an, damit nur die letzte Strecke über WLAN läuft.
  • Schalten Sie Suppress Duplicate Frames am Controller in xLights ein, damit unveränderte Bilder nicht erneut gesendet werden.
  • Für E1.31 empfiehlt die WLED-Dokumentation höchstens 3 Universen (510 RGB-Pixel) pro Licht für flüssige 40 Bilder pro Sekunde und maximal 9 Universen auf dem ESP8266.
  • WLED zeigt ein neues gestreamtes Bild höchstens alle 16 ms, das begrenzt die Rate auf etwas über 60 Bilder pro Sekunde, egal was Sie senden.
  • Für große Anzeigen verwenden Sie ESP32-Boards und, wo möglich, Boards mit kabelgebundenem Ethernet.

Die Kontrolle nach der Show zurückbekommen

Wenn der Stream stoppt, wartet WLED das Zeitlimit ab (standardmäßig 2,5 s) und macht dann genau da weiter, wo es war: gleicher Effekt, gleiche Helligkeit. Streaming ändert keine der eigenen Einstellungen von WLED.

Wenn Sie die Ausgabe in xLights ausschalten, sendet es zuerst ein komplett schwarzes Bild. Die Lichter sind also bis zum Ablauf des Zeitlimits dunkel, dann kommt der WLED-Effekt zurück.

Kommt WLED nicht zurück, sendet noch etwas. Finden Sie es über /json/info des Lichts (das Feld lip zeigt die IP des Senders) oder übersteuern Sie es:

  • Senden Sie {"lor":1} an /json/state, um den Stream zu ignorieren, bis er aufhört, oder {"lor":2}, um ihn bis zum nächsten Neustart zu ignorieren.
  • Senden Sie {"live":false}, um den Echtzeitmodus sofort zu verlassen. Streamt der Sender weiter, setzt das nächste Paket das Licht sofort wieder in den Echtzeitmodus, stoppen Sie also den Sender oder nutzen Sie lor.

In WLED Max zeigt der Tab Steuerung ein Banner, wenn ein Licht von xLights oder etwas anderem gesteuert wird ("Externe Steuerung aktiv", auf Android ab WLED Max 1.1.4). Tippen Sie auf Steuerung übernehmen und wählen Sie Übernehmen, bis keine Daten mehr kommen oder Übernehmen bis zum Neustart. Das sind dieselben zwei Übersteuerungswerte. Unter Android 1.1.2 und älter steht im Banner der Name des Senders ("... is controlling this device", die App gab es damals nur auf Englisch), und die beiden Tasten heißen Until Data Stops und Until Reboot.

Um stattdessen das letzte Bild auf den Lichtern zu behalten, setzen Sie den Wert Timeout auf 65000, was WLED als "nie" behandelt.

FAQ

Brauche ich xLights für WLED? Nein. WLED führt Effekte, Szenen, Szenenfolgen und Timer selbst aus. xLights ist für musiksynchrone Shows über viele Props.

Welchen Port nutzt xLights für WLED? DDP auf Port 4048, E1.31 auf 5568, Art-Net auf 6454.

Muss ich DDP in WLED aktivieren? Nein. WLED empfängt DDP immer. E1.31 und Art-Net werden in Sync Interfaces unter Network DMX input eingestellt: Type wählt E1.31 oder Art-Net, und DMX mode darf nicht Disabled sein.

Warum bleibt WLED nach der Show dunkel? xLights hat beim Ausschalten der Ausgabe ein schwarzes Bild gesendet, und WLED zeigt es, bis das Zeitlimit abläuft. Bleibt es länger dunkel, streamt noch ein anderer Sender.

Kann ich WLED-Effekte und xLights zusammen nutzen? Ja, auf zwei Wegen: Schalten Sie Use main segment only ein, damit die Show auf einem Segment läuft und die anderen ihre WLED-Effekte behalten, oder lassen Sie WLED normal laufen und wechseln nur während der Show zu xLights.

WLED Max, unsere WLED-App für iOS und Android, bietet für ein Licht jede Funktion kostenlos.