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 HomeServer
- Version
- 0.1.0
- Lizenz
- Ein Schlüssel je HomeServer (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
Besonderheiten beim HomeServer
- Statt 1 bis 16 einstellbarer Segmente gibt es fest 4. Es gibt keinen Parameter „Anzahl Segmente“.
- Der HomeServer liefert jeden Eingang einzeln. Jede Änderung geht als eigener Befehl raus, auch bei Rot/Grün/Blau (dann wird die Farbe aus allen drei Eingängen gebildet). Beim X1 gehen gleichzeitig gesetzte Eingänge in einer Anfrage raus.
- Ein/Aus, Umschalten, Nachtlicht und die Statusausgänge sind
0/1. Der Zugriff läuft über Python (urllib2) statt curl.
- Statt Parametern gibt es Eingänge mit Startwert. Auswahllisten des X1 sind Zahlen, Ja/Nein-Werte sind
0und1. - Der Lizenzschlüssel ist der letzte Text-Eingang. Ein neuer Wert an diesem Eingang wird sofort geprüft.
- Eine Prüfung des Schlüssels im Editor und eine Simulation gibt es nicht, der HomeServer prüft immer.
Funktionen und Anschlüsse
Logikbaustein von SMoLabs 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 mit bis zu 4 Segmenten. Die Segmente müssen in WLED angelegt sein (Einstellungen > Segmente).
Jeder Eingang sendet bei einem neuen Wert genau seinen Teil des Befehls. Jeder Befehl fragt mit „v“: true den vollständigen Zustand ab und gibt ihn an die Status-Ausgänge zurück. Wer auch Änderungen von außen zurückmelden will, belegt E1 zyklisch (10 bis 60 Sekunden).
Bei Fehlern (keine Verbindung, HTTP-Fehler, ungültige IP oder Farbe) zeigt „Fehler“ den Grund, „Letzter Befehl erfolgreich“ wird 0.
Eingänge
| Nr. | Name | Init | Bedeutung |
|---|---|---|---|
| 1 | E1 Trigger (Zustand abfragen) | 0 | Ungleich 0: liest den Zustand des Geräts (/json/si). Empfohlen sind 10 bis 60 Sekunden zyklisch, wenn auch Änderungen von außen (App, Taster, Weboberfläche) zurückgemeldet werden sollen. Befehle über den Baustein melden den neuen Zustand sofort zurück. |
| 2 | E2 Ein/Aus | 0 | Schaltet das Gerät ein (1) oder aus (0). |
| 3 | E3 Umschalten (1 = umschalten) | 0 | 1 = umschalten. |
| 4 | E4 Helligkeit gesamt (0-100 %) | 100 | 0 bis 100 %. 0 schaltet aus (WLED rät von Helligkeit 0 ab), ein Wert größer 0 schaltet ein. |
| 5 | E5 Preset abrufen | 1 | Nummer des Presets, das abgerufen wird. |
| 6 | E6 Nachtlicht | 0 | 1 startet das Nachtlicht (dimmt über die Dauer auf 0), 0 beendet es. |
| 7 | E7 IP-Adresse oder Name des WLED-Geräts | „“ | IP-Adresse oder Name des WLED-Geräts, z. B. 192.168.1.50 oder wled-regal.local. Ein vorangestelltes http:// wird entfernt. WLED spricht im lokalen Netz nur HTTP. |
| 8 | E8 ID des ersten Segments (WLED zählt ab 0) | 0 | ID des ersten Segments in WLED (WLED zählt ab 0). Die weiteren Segmente folgen aufsteigend. |
| 9 | E9 Übergangszeit in 1/10 s (-1 = Vorgabe des Geräts) | -1 | Übergangszeit in Zehntelsekunden für den einzelnen Befehl, -1 = Vorgabe des Geräts. |
| 10 | E10 Nachtlicht: Dauer in Minuten (1-255) | 10 | Dauer des Nachtlichts in Minuten, 1 bis 255. |
| 11 | E11 Segment 1 Ein/Aus | 0 | Segment 1 ein (1) oder aus (0). |
| 12 | E12 Segment 1 Helligkeit (0-100 %) | 100 | Segment 1 Helligkeit 0 bis 100 %. |
| 13 | E13 Segment 1 Farbe (Hex RRGGBB) | „“ | Segment 1 Farbe als Hex RRGGBB (auch mit #, RGBW mit 8 Stellen). |
| 14 | E14 Segment 1 Rot (0-255) | 0 | Segment 1 Rotanteil 0 bis 255. Rot, Grün und Blau werden zusammen als Farbe gesendet, sobald einer sich ändert. |
| 15 | E15 Segment 1 Grün (0-255) | 0 | Segment 1 Grünanteil 0 bis 255. |
| 16 | E16 Segment 1 Blau (0-255) | 0 | Segment 1 Blauanteil 0 bis 255. |
| 17 | E17 Segment 1 Farbtemperatur (0 warm – 255 kalt) | 127 | Segment 1 Farbtemperatur 0 (warm) bis 255 (kalt). |
| 18 | E18 Segment 1 Effekt (Nr.) | 0 | Segment 1 Effekt-Nummer. |
| 19 | E19 Segment 1 Effekt-Geschwindigkeit (0-255) | 128 | Segment 1 Effekt-Geschwindigkeit 0 bis 255. |
| 20 | E20 Segment 1 Effekt-Intensität (0-255) | 128 | Segment 1 Effekt-Intensität 0 bis 255. |
| 21 | E21 Segment 1 Palette (Nr.) | 0 | Segment 1 Palette-Nummer. |
| 22 | E22 Segment 2 Ein/Aus | 0 | Segment 2 ein (1) oder aus (0). |
| 23 | E23 Segment 2 Helligkeit (0-100 %) | 100 | Segment 2 Helligkeit 0 bis 100 %. |
| 24 | E24 Segment 2 Farbe (Hex RRGGBB) | „“ | Segment 2 Farbe als Hex RRGGBB (auch mit #, RGBW mit 8 Stellen). |
| 25 | E25 Segment 2 Rot (0-255) | 0 | Segment 2 Rotanteil 0 bis 255. Rot, Grün und Blau werden zusammen als Farbe gesendet, sobald einer sich ändert. |
| 26 | E26 Segment 2 Grün (0-255) | 0 | Segment 2 Grünanteil 0 bis 255. |
| 27 | E27 Segment 2 Blau (0-255) | 0 | Segment 2 Blauanteil 0 bis 255. |
| 28 | E28 Segment 2 Farbtemperatur (0 warm – 255 kalt) | 127 | Segment 2 Farbtemperatur 0 (warm) bis 255 (kalt). |
| 29 | E29 Segment 2 Effekt (Nr.) | 0 | Segment 2 Effekt-Nummer. |
| 30 | E30 Segment 2 Effekt-Geschwindigkeit (0-255) | 128 | Segment 2 Effekt-Geschwindigkeit 0 bis 255. |
| 31 | E31 Segment 2 Effekt-Intensität (0-255) | 128 | Segment 2 Effekt-Intensität 0 bis 255. |
| 32 | E32 Segment 2 Palette (Nr.) | 0 | Segment 2 Palette-Nummer. |
| 33 | E33 Segment 3 Ein/Aus | 0 | Segment 3 ein (1) oder aus (0). |
| 34 | E34 Segment 3 Helligkeit (0-100 %) | 100 | Segment 3 Helligkeit 0 bis 100 %. |
| 35 | E35 Segment 3 Farbe (Hex RRGGBB) | „“ | Segment 3 Farbe als Hex RRGGBB (auch mit #, RGBW mit 8 Stellen). |
| 36 | E36 Segment 3 Rot (0-255) | 0 | Segment 3 Rotanteil 0 bis 255. Rot, Grün und Blau werden zusammen als Farbe gesendet, sobald einer sich ändert. |
| 37 | E37 Segment 3 Grün (0-255) | 0 | Segment 3 Grünanteil 0 bis 255. |
| 38 | E38 Segment 3 Blau (0-255) | 0 | Segment 3 Blauanteil 0 bis 255. |
| 39 | E39 Segment 3 Farbtemperatur (0 warm – 255 kalt) | 127 | Segment 3 Farbtemperatur 0 (warm) bis 255 (kalt). |
| 40 | E40 Segment 3 Effekt (Nr.) | 0 | Segment 3 Effekt-Nummer. |
| 41 | E41 Segment 3 Effekt-Geschwindigkeit (0-255) | 128 | Segment 3 Effekt-Geschwindigkeit 0 bis 255. |
| 42 | E42 Segment 3 Effekt-Intensität (0-255) | 128 | Segment 3 Effekt-Intensität 0 bis 255. |
| 43 | E43 Segment 3 Palette (Nr.) | 0 | Segment 3 Palette-Nummer. |
| 44 | E44 Segment 4 Ein/Aus | 0 | Segment 4 ein (1) oder aus (0). |
| 45 | E45 Segment 4 Helligkeit (0-100 %) | 100 | Segment 4 Helligkeit 0 bis 100 %. |
| 46 | E46 Segment 4 Farbe (Hex RRGGBB) | „“ | Segment 4 Farbe als Hex RRGGBB (auch mit #, RGBW mit 8 Stellen). |
| 47 | E47 Segment 4 Rot (0-255) | 0 | Segment 4 Rotanteil 0 bis 255. Rot, Grün und Blau werden zusammen als Farbe gesendet, sobald einer sich ändert. |
| 48 | E48 Segment 4 Grün (0-255) | 0 | Segment 4 Grünanteil 0 bis 255. |
| 49 | E49 Segment 4 Blau (0-255) | 0 | Segment 4 Blauanteil 0 bis 255. |
| 50 | E50 Segment 4 Farbtemperatur (0 warm – 255 kalt) | 127 | Segment 4 Farbtemperatur 0 (warm) bis 255 (kalt). |
| 51 | E51 Segment 4 Effekt (Nr.) | 0 | Segment 4 Effekt-Nummer. |
| 52 | E52 Segment 4 Effekt-Geschwindigkeit (0-255) | 128 | Segment 4 Effekt-Geschwindigkeit 0 bis 255. |
| 53 | E53 Segment 4 Effekt-Intensität (0-255) | 128 | Segment 4 Effekt-Intensität 0 bis 255. |
| 54 | E54 Segment 4 Palette (Nr.) | 0 | Segment 4 Palette-Nummer. |
| 55 | E55 Lizenzschlüssel | „“ | Lizenzschlüssel für diesen HomeServer (von smolabs.de). Ohne gültigen Schlüssel bleibt der Baustein untätig. |
Ausgänge
| Nr. | Name | Init | Bedeutung |
|---|---|---|---|
| 1 | A1 Letzter Befehl erfolgreich | 0 | 1, wenn der letzte Befehl erfolgreich war. |
| 2 | A2 Gerät erreichbar | 0 | 1, wenn das Gerät auf die letzte Anfrage geantwortet hat. |
| 3 | A3 Status Ein/Aus | 0 | Ein/Aus laut Gerät. |
| 4 | A4 Status Helligkeit gesamt (0-100 %) | 0 | Gesamthelligkeit laut Gerät in %. |
| 5 | A5 Status aktives Preset (-1 = keins) | -1 | Aktives Preset, -1 = keins. |
| 6 | A6 Gerätename | „“ | Name des Geräts. |
| 7 | A7 Firmware-Version | „“ | Firmware-Version. |
| 8 | A8 WLAN-Signal (0-100 %) | 0 | WLAN-Signal in %. |
| 9 | A9 Anzahl LEDs | 0 | Anzahl der LEDs. |
| 10 | A10 Stromaufnahme (mA) | 0 | Geschätzte Stromaufnahme in mA. |
| 11 | A11 Segment 1 Status Ein/Aus | 0 | Segment 1 Status ein/aus. |
| 12 | A12 Segment 1 Status Helligkeit (0-100 %) | 0 | Segment 1 Status Helligkeit in %. |
| 13 | A13 Segment 1 Status Farbe (Hex) | „“ | Segment 1 Status Farbe als Hex RRGGBB. |
| 14 | A14 Segment 1 Status Effekt (Nr.) | 0 | Segment 1 Status Effekt-Nummer. |
| 15 | A15 Segment 1 Status Effektname | „“ | Segment 1 Name des Effekts laut Gerät. |
| 16 | A16 Segment 1 Status Geschwindigkeit | 0 | Segment 1 Status Geschwindigkeit. |
| 17 | A17 Segment 1 Status Intensität | 0 | Segment 1 Status Intensität. |
| 18 | A18 Segment 1 Status Palette | 0 | Segment 1 Status Palette. |
| 19 | A19 Segment 2 Status Ein/Aus | 0 | Segment 2 Status ein/aus. |
| 20 | A20 Segment 2 Status Helligkeit (0-100 %) | 0 | Segment 2 Status Helligkeit in %. |
| 21 | A21 Segment 2 Status Farbe (Hex) | „“ | Segment 2 Status Farbe als Hex RRGGBB. |
| 22 | A22 Segment 2 Status Effekt (Nr.) | 0 | Segment 2 Status Effekt-Nummer. |
| 23 | A23 Segment 2 Status Effektname | „“ | Segment 2 Name des Effekts laut Gerät. |
| 24 | A24 Segment 2 Status Geschwindigkeit | 0 | Segment 2 Status Geschwindigkeit. |
| 25 | A25 Segment 2 Status Intensität | 0 | Segment 2 Status Intensität. |
| 26 | A26 Segment 2 Status Palette | 0 | Segment 2 Status Palette. |
| 27 | A27 Segment 3 Status Ein/Aus | 0 | Segment 3 Status ein/aus. |
| 28 | A28 Segment 3 Status Helligkeit (0-100 %) | 0 | Segment 3 Status Helligkeit in %. |
| 29 | A29 Segment 3 Status Farbe (Hex) | „“ | Segment 3 Status Farbe als Hex RRGGBB. |
| 30 | A30 Segment 3 Status Effekt (Nr.) | 0 | Segment 3 Status Effekt-Nummer. |
| 31 | A31 Segment 3 Status Effektname | „“ | Segment 3 Name des Effekts laut Gerät. |
| 32 | A32 Segment 3 Status Geschwindigkeit | 0 | Segment 3 Status Geschwindigkeit. |
| 33 | A33 Segment 3 Status Intensität | 0 | Segment 3 Status Intensität. |
| 34 | A34 Segment 3 Status Palette | 0 | Segment 3 Status Palette. |
| 35 | A35 Segment 4 Status Ein/Aus | 0 | Segment 4 Status ein/aus. |
| 36 | A36 Segment 4 Status Helligkeit (0-100 %) | 0 | Segment 4 Status Helligkeit in %. |
| 37 | A37 Segment 4 Status Farbe (Hex) | „“ | Segment 4 Status Farbe als Hex RRGGBB. |
| 38 | A38 Segment 4 Status Effekt (Nr.) | 0 | Segment 4 Status Effekt-Nummer. |
| 39 | A39 Segment 4 Status Effektname | „“ | Segment 4 Name des Effekts laut Gerät. |
| 40 | A40 Segment 4 Status Geschwindigkeit | 0 | Segment 4 Status Geschwindigkeit. |
| 41 | A41 Segment 4 Status Intensität | 0 | Segment 4 Status Intensität. |
| 42 | A42 Segment 4 Status Palette | 0 | Segment 4 Status Palette. |
| 43 | A43 Lizenzstatus | „“ | Ergebnis der Lizenzprüfung, z. B. „Lizenz gültig (2026-000123)“. |
| 44 | A44 Fehler | „“ | Fehler des letzten Befehls bzw. der letzten Abfrage, sonst leer. |
Lizenz
Der Lizenzschlüssel wird am letzten Text-Eingang des Bausteins eingetragen. Der Baustein prüft ihn auf dem HomeServer, offline und gebunden an die MAC-Adresse des HomeServers. Der Ausgang „Lizenzstatus“ zeigt das Ergebnis, bei einem Schlüssel für ein anderes Gerät auch die MAC-Adresse dieses HomeServers. Ohne gültigen Schlüssel bleibt der Baustein untätig. Den Schlüssel erhältst du beim Kauf über smolabs.de. Ein Schlüssel für den X1 schaltet keinen HomeServer-Baustein frei und umgekehrt.
Changelog
Version 0.1.0
- Erste Version für den HomeServer auf Basis der X1-Bausteine | SMoLabs.
Rezensionen
Es gibt noch keine Rezensionen.