Beschreibung
Logikbaustein zum Steuern eines WLED-Geräts (adressierbare LED-Streifen) über die lokale JSON-API. Steuern und Rückmelden sind in einem Baustein. Es gibt einen Baustein pro WLED-Gerät, die Anzahl der Segmente stellt man selbst ein. WLED spricht im lokalen Netz nur HTTP, eine Anmeldung ist nicht nötig.
- Gerät
- Gira X1
- Version
- 1.0.0
- Lizenz
- Ein Schlüssel je X1 (MAC-Adresse), dauerhaft nutzbar
- Thema
- Haus und Garten
Hinweis zur Schnittstelle: Der Baustein nutzt die Schnittstelle von WLED. Ändert der Anbieter sie oder stellt sie ein, kann der Baustein eingeschränkt oder gar nicht mehr funktionieren, bis er angepasst ist. Wir passen ihn nach Möglichkeit an, einen Anspruch darauf gibt es nicht.
Anleitung
Einrichtung
- Im Parameter IP-Adresse oder Name des WLED-Geräts die Adresse eintragen, z. B.
192.168.1.50oderwled-regal.local. Ein vorangestellteshttp://wird entfernt. - Anzahl Segmente einstellen. Für jedes Segment erscheinen eigene Ein- und Ausgänge. Die Segmente müssen in WLED angelegt sein (Einstellungen > Segmente).
- Den Eingang Trigger (Zustand abfragen) zyklisch mit
1belegen, wenn auch Änderungen von außen (WLED-App, Taster, Weboberfläche) zurückgemeldet werden sollen. Empfohlen sind 10 bis 60 Sekunden. Befehle über den Baustein melden den neuen Zustand sofort zurück, dafür braucht es keinen Trigger.
Eingänge
Jeder Eingang sendet nur bei einem neuen Wert genau seinen Teil. Mehrere gleichzeitig gesetzte Eingänge gehen in einer Anfrage raus.
| Eingang | Wirkung | WLED-Feld |
|---|---|---|
| Trigger (Zustand abfragen) | Zustand und Geräteinformationen abfragen | GET /json/si |
| Ein/Aus | Gerät ein- oder ausschalten | on |
| Umschalten (1 = umschalten) | Bei 1 zwischen Ein und Aus wechseln (ausgeblendet) |
on: "t" |
| Helligkeit gesamt (0-100 %) | Gesamthelligkeit. 0 schaltet aus, ein Wert über 0 schaltet ein |
bri, on |
| Preset abrufen | In WLED gespeicherte Szene (Preset) mit dieser Nummer abrufen (ausgeblendet) | ps |
| Nachtlicht (ausblenden) | Bei 1 über die Nachtlicht-Dauer ausblenden, bei 0 abbrechen (ausgeblendet) |
nl |
Je Segment
| Eingang | Wirkung | WLED-Feld |
|---|---|---|
| Segment n Ein/Aus | Segment ein- oder ausschalten | seg[].on |
| Segment n Helligkeit (0-100 %) | Helligkeit des Segments. Ein Wert über 0 schaltet das Segment ein. 0 dunkelt das Segment ab, schaltet es aber nicht aus (anders als bei „Helligkeit gesamt“), dafür „Segment n Ein/Aus“ verwenden |
seg[].bri |
| Segment n Farbe (Hex RRGGBB) | Primärfarbe, auch mit #. Bei 8 Stellen (RRGGBBWW) wird der Weißkanal mitgesendet |
seg[].col |
| Segment n Rot (0-255), Grün (0-255), Blau (0-255) | Primärfarbe aus drei Werten, z. B. vom Farbwähler des X1 (ausgeblendet) | seg[].col |
| Segment n Farbtemperatur (0 warm – 255 kalt) | Warm bis kalt, für Streifen mit Weißkanal (ausgeblendet) | seg[].cct |
| Segment n Effekt (Nr.) | Effekt-Nummer, die Liste steht in der WLED-Weboberfläche (ausgeblendet) | seg[].fx |
| Segment n Effekt-Geschwindigkeit (0-255), Effekt-Intensität (0-255) | (ausgeblendet) | seg[].sx, seg[].ix |
| Segment n Palette (Nr.) | Farbpalette (ausgeblendet) | seg[].pal |
Parameter
| Parameter | Bedeutung |
|---|---|
| IP-Adresse oder Name des WLED-Geräts | Adresse im lokalen Netz |
| Anzahl Segmente | 1 bis 16, bestimmt, für wie viele Segmente es Ein- und Ausgänge gibt |
| ID des ersten Segments (WLED zählt ab 0) | Vorgabe 0. Segment 1 des Bausteins ist diese ID, Segment 2 die nächste usw. (ausgeblendet) |
| Übergangszeit in 1/10 s (-1 = Vorgabe des Geräts) | Überblendung nur für den jeweiligen Befehl, Vorgabe -1 (ausgeblendet) |
| Nachtlicht: Dauer in Minuten (1-255) | 1 bis 255, Vorgabe 10 (ausgeblendet) |
| Lizenzschlüssel | Schlüssel für diesen X1, siehe „Lizenz“ |
Ausgänge
| Ausgang | Quelle |
|---|---|
| Letzter Befehl erfolgreich | 1 nach einem angenommenen Befehl, 0 bei einem Fehler |
| Gerät erreichbar | 0 bei Zeitüberschreitung oder falscher IP-Adresse. Wird nur bei einer Abfrage oder einem Befehl aktualisiert |
| Status Ein/Aus, Status Helligkeit gesamt (0-100 %) | on, bri |
| Status aktives Preset (-1 = keins) | ps (ausgeblendet) |
| Gerätename, Firmware-Version | info.name, info.ver (ausgeblendet) |
| WLAN-Signal (0-100 %), Anzahl LEDs, Geschätzter Strom (mA) | info.wifi.signal, info.leds.count, info.leds.pwr (ausgeblendet) |
| Segment n Status Ein/Aus, Helligkeit (0-100 %), Farbe (Hex) | seg[].on, seg[].bri, seg[].col (ohne Weißkanal) |
| Segment n Status Effekt (Nr.), Effektname, Geschwindigkeit, Intensität, Palette | seg[].fx mit Name aus /json/eff, sx, ix, pal (ausgeblendet) |
| Lizenzstatus | Ergebnis der Lizenzprüfung |
| Debug (ausgeblendet) | Fehler der letzten Anfrage und Hinweise zu ungültigen Eingaben |
Die Effektnamen lädt der Baustein beim ersten erfolgreichen Abruf und erneuert sie, wenn sich die Zahl der Effekte ändert (Firmware-Update). Schlägt das Laden fehl, versucht er es beim nächsten Trigger erneut.
Ausgeblendete Ein- und Ausgänge und Parameter lassen sich im GPA (Gira Projekt Assistent) am Baustein einblenden.
Rückmeldung
- Jeder Befehl geht mit
"v":truean das Gerät. Die Antwort enthält den vollständigen Zustand und füllt sofort die Statusausgänge. - Der Trigger liest Zustand und Geräteinformationen, damit auch Änderungen von außen ankommen. Der Baustein hat keinen eigenen Timer, das Intervall legt das Logikblatt fest.
- WebSocket und MQTT werden nicht verwendet.
Fehlerverhalten
Bei einem Fehler bleiben die Statuswerte auf dem letzten Stand und „Debug“ nennt den Grund:
| Debug | Ursache |
|---|---|
| IP-Adresse des WLED-Geräts fehlt oder ist ungültig | Parameter leer oder mit Sonderzeichen, es wird nicht gesendet |
| Keine Verbindung zum WLED-Gerät | Gerät aus, falsche IP-Adresse oder Zeitüberschreitung (5 s) |
| WLED antwortet mit HTTP … | Falsche Adresse oder anderes Gerät unter dieser IP |
| WLED meldet Fehler … | Das Gerät hat den Befehl abgelehnt, z. B. durch gesperrte Einstellungen |
| Segment n: Farbe … ist kein Hex-Wert (RRGGBB) | Die Farbe muss RRGGBB sein. Die Farbe wird nicht gesendet, die übrigen Befehle desselben Durchlaufs schon. Der Hinweis bleibt auch dann stehen, wenn diese Befehle erfolgreich waren |
Existiert ein eingestelltes Segment in WLED nicht, ignoriert das Gerät den Befehl dafür. Der Baustein legt keine Segmente an.
Lizenz
Der Lizenzschlüssel wird im GPA im Parameter „Lizenzschlüssel“ eingetragen. Der Baustein prüft ihn beim Start auf dem X1, offline und gebunden an die MAC-Adresse des X1. Der Ausgang „Lizenzstatus“ zeigt das Ergebnis, bei einem Schlüssel für ein anderes Gerät auch die MAC-Adresse dieses X1. Ohne gültigen Schlüssel bleibt der Baustein untätig. In der Simulation des GPA am PC läuft er ohne Lizenzprüfung, damit sich Logikblätter testen lassen.
Läuft eine Testlizenz ab, sendet der Baustein ab dem nächsten Eingangswert keine Befehle und Abfragen mehr, bis ein neuer Schlüssel eingetragen ist. Den Schlüssel erhältst du beim Kauf über smolabs.de.
Changelog
Version 1.0.0
- Erste Version.
Rezensionen
Es gibt noch keine Rezensionen.