Zum Hauptinhalt springen

LIFX Smart-Home-Integration, kostenlos und Open Source

LIFX-Integration für Gladys Assistant

LIFX-Lampen, -Streifen und -Matrizen im lokalen Netzwerk: Farben, Weißtöne, Effekte, Blinken.

Auf GitHub ansehenAlle externen Integrationen

Steuere deine LIFX-Lampen, -Streifen und -Matrizen aus Gladys, im lokalen Netzwerk, mit dem offiziellen LAN-Protokoll von LIFX: keine Cloud, kein Konto, kein Schlüssel.

Ohne die Hardware entwickelt: Rückmeldungen sind willkommen („Developed without the hardware: feedback welcome“). Die Integration wurde nach dem öffentlichen LIFX-Protokoll geschrieben und gegen simulierte Lampen getestet. Wenn sich etwas nicht wie beschrieben verhält, eröffne bitte ein Issue: https://github.com/guim31/gladys-lifx/issues

Diese Integration steht in keiner Verbindung zu LIFX.

Überblick​

  • Jede LIFX-Lampe wird zu einer Gladys-Lampe: Ein/Aus, Helligkeit, Farbe, Weißton (in Kelvin, im Bereich deines Modells).
  • Nightvision-Lampen bekommen ihre Infrarot-Stufe.
  • Streifen (Z, Beam, Neon, String, Permanent Outdoor…) und Matrizen (Tile, Candle, Ceiling, Spot, Path, Tube…) werden als Ganzes gesteuert (Ein/Aus, Helligkeit, eine Farbe für die ganze Lampe) und bekommen die Liste ihrer eingebauten Effekte.
  • Zwei Szenenaktionen: LIFX-Lampe blinken lassen (ein farbiger Alarm, der von selbst endet) und LIFX-Effekt starten (Lauflicht, Morph, Flamme).
  • Die Verbindung jeder Lampe wird angezeigt und im Verlauf gespeichert.

Voraussetzungen​

  • Gladys 5.1 oder neuer.
  • LIFX-Lampen, die in der LIFX-App eingerichtet und mit demselben Netzwerk wie Gladys verbunden sind. Die LIFX-App wird danach nicht mehr gebraucht.
  • Die Lampen antworten auf dem UDP-Port 56700. Gladys findet sie per Broadcast im lokalen Netzwerk: Sind Gladys und die Lampen in verschiedenen Netzwerken (VLAN, Gast-WLAN), gib ihre IP-Adressen in der Konfiguration ein.

Konfiguration​

  1. Installiere die Integration (Integrationen → Von GitHub installieren, oder aus dem Store).
  2. Öffne den Tab Konfiguration. Alle Felder sind optional:
    • IP-Adressen der LIFX-Lampen: nur für Lampen, die die automatische Erkennung nicht findet, durch Kommas getrennt. Gib ihnen in deinem Router eine feste Adresse.
    • Aktualisierungsintervall: wie oft jede Lampe gelesen wird (10, 15, 30 oder 60 Sekunden, standardmäßig 15), um Änderungen aus der LIFX-App, über einen Sprachassistenten oder einen Wandschalter zu verfolgen.
    • Übergang: eine Überblendung für die Änderungen aus Gladys (standardmäßig keine, bis zu 5 Sekunden).
    • Sprache der Funktionsnamen: die Sprache der Namen, die den Funktionen neuer Lampen gegeben werden (standardmäßig Französisch).
  3. Öffne den Tab Entdecken und füge deine Lampen hinzu. Die Namen kommen aus der LIFX-App; du kannst sie in Gladys umbenennen.

Die Schaltfläche LIFX-Lampen suchen im Tab Konfiguration sucht die Lampen erneut und listet die gefundenen mit Adresse und Modell auf.

Geräte und Funktionen​

Jede Lampe ist ein Gladys-Gerät, erkannt an ihrer Seriennummer: Verlauf, Szenen und Dashboards bleiben erhalten, wenn sich ihre IP-Adresse ändert.

FunktionLampenWas sie tut
LichtalleEin/Aus
Helligkeitalle0 bis 100 %; 0 schaltet die Lampe aus
FarbeFarblampendie Farbe; ändert nie die Helligkeit
FarbtemperaturLampen mit Weißbereichder Weißton in Kelvin, im Bereich von Modell und Firmware
InfrarotNightvision0 bis 100 % der Infrarotleistung
LIFX-EffektStreifen und MatrizenKeiner, die Effekte der Lampe, Anderer Effekt (nur lesen)
Verbindungalle1, wenn die Lampe antwortet, sonst 0 (nur lesen)

Eine Farbe, ein Weißton oder eine Helligkeit schalten die Lampe auch ein. Eine ausgeschaltete Lampe nimmt zuerst ihre neue Farbe an und blendet dann ein: Die alte Farbe ist nie zu sehen. Eine Farbe oder ein Weißton stoppen den laufenden Effekt, der sie verdecken würde.

Die Farbe wird angezeigt, solange die Lampe eine Farbe zeigt, die Farbtemperatur, solange sie ein Weiß zeigt. Eine Lampe, die nicht mehr antwortet (am Wandschalter aus, Stromausfall), wird als aus angezeigt, mit Verbindung auf 0 und dem Abzeichen „nicht erreichbar“.

Die Effekte der Liste LIFX-Effekt: Lauflicht lässt die Farben eines Streifens wandern; Morph mischt Farben und Flamme flackert auf einer Matrix. Aus der Liste starten sie mit ihren Standardeinstellungen; die Szenenaktion lässt Geschwindigkeit, Richtung und Farben wählen. Ein Effekt aus der LIFX-App, den die Integration nicht selbst startet (Himmel, Farbdurchlauf…), wird als Anderer Effekt angezeigt.

Szenenaktionen​

LIFX-Lampe blinken lassen​

Die Lampe blinkt oder pulsiert einige Male in einer Farbe und zeigt danach wieder ihren vorherigen Zustand. Eine ausgeschaltete Lampe geht für das Blinken an und danach mit ihrer Farbe wieder aus. Gedacht für Alarme: eine offen gebliebene Tür, die fertige Waschmaschine, jemand an der Tür.

  • LIFX-Lampe: die Lampe.
  • Farbe: Rot, Orange, Gelb, Grün, Cyan, Blau, Lila, Rosa oder Weiß (weiße Lampen blinken in Weiß).
  • Art: Blinken (an und aus) oder Atmen (sanft).
  • Dauer eines Zyklus: 0,25 bis 5 Sekunden.
  • Anzahl der Zyklen (1-50): standardmäßig 3.

Ausgabe: Dauer des Blinkens (s), um in der Szene auf das Ende zu warten.

LIFX-Effekt starten​

Schaltet die Lampe ein und startet einen eingebauten Effekt, der bis zum Stopp läuft (ein anderer Effekt, eine Farbe, ein Weißton oder Effekt stoppen).

  • Effekt: Lauflicht (Streifen), Morph (Matrizen), Flamme (Matrizen) oder Effekt stoppen.
  • Geschwindigkeit: langsam, normal oder schnell.
  • Richtung (Lauflicht): rechts oder links.
  • Farben: Regenbogen, Feuer, Ozean, Wald, Pastell oder Bereits gezeigte Farben (Lauflicht). Das Lauflicht verteilt sie über den Streifen, bevor es sie wandern lässt; Morph vermischt sie; die Flamme behält ihre Farben.

Ausgabe: Laufender Effekt (move, morph, flame, none).

Warum kein Widget​

Die Licht-Box von Gladys zeigt und steuert bereits alles, was eine LIFX-Lampe kann: Ein/Aus, Helligkeit, Farbe, Weißton, Infrarot und die Effektliste. Das Blinken und die Effekte mit ihren Einstellungen sind Szenenaktionen, dort, wo sie nützlich sind (Alarme, Stimmungen). Ein LIFX-Widget würde nur die Licht-Box wiederholen, deshalb gibt es keins.

Szenenbeispiele​

  • Offen gebliebene Tür: Wenn der Türsensor 5 Minuten offen bleibt → LIFX-Lampe blinken lassen, die Wohnzimmerlampe, Orange, Blinken, 1 Sekunde, 5 Zyklen.
  • Türklingel: Wenn es klingelt → LIFX-Lampe blinken lassen, die Bürolampe, Blau, Atmen, 0,5 Sekunden, 6 Zyklen (eine Aktion pro Lampe, die warnen soll).
  • Filmabend: Um 21 Uhr, wenn der Fernseher angeht → LIFX-Effekt starten, der Streifen am Fernseher, Lauflicht, langsam, Ozean; und Effekt stoppen, wenn er ausgeht.
  • Lampe am Wandschalter aus: Wenn die Verbindung einer Lampe 10 Minuten lang auf 0 ist → die Nachricht „die Flurlampe hat keinen Strom“ senden.

Netzwerkverkehr und Grenzen des Protokolls​

  • Das LIFX-Protokoll schickt nichts von selbst: Jede in Gladys hinzugefügte Lampe wird im Aktualisierungsintervall gelesen (ein oder zwei kleine UDP-Pakete, drei für einen Streifen oder eine Matrix). LIFX bittet Clients, unter 20 Nachrichten pro Sekunde und Lampe zu bleiben: Die Integration sendet eine Nachricht nach der anderen pro Lampe, weit darunter.
  • Gladys bekommt nur die geänderten Werte, dazu alle 6 Stunden die unveränderten, damit der Verlauf aktuell bleibt.
  • Die Lampen werden alle 15 Minuten erneut gesucht, um ihren Adresswechseln zu folgen und neue zu finden.
  • Die Integration liest die Lampen mit ihrem eigenen Timer: Gladys fragt sie nicht ab (die Geräte werden mit should_poll: false veröffentlicht).

Fehlerbehebung​

  • Keine Lampe gefunden: Prüfe, ob die Lampen in der LIFX-App eingerichtet und im selben Netzwerk wie Gladys sind. Die automatische Erkennung läuft über Gladys (Gladys 5.1 oder neuer); in einem anderen Netzwerk gib die IP-Adressen ein.
  • Eine Lampe ist „nicht erreichbar“: Die Lampe ist am Wandschalter aus, oder ihre Adresse hat sich geändert. Die Integration findet sie bei der nächsten Suche von selbst wieder; gib ihr in deinem Router eine feste Adresse, um das zu vermeiden.
  • Änderungen aus der LIFX-App kommen spät an: Die Änderungen kommen beim nächsten Lesen an; wähle ein kürzeres Aktualisierungsintervall.
  • Ein Effekt tut nichts: Das Lauflicht gibt es nur auf Streifen, Morph und Flamme nur auf Matrizen. Das Lauflicht mit Bereits gezeigte Farben (Lauflicht) auf einem einfarbigen Streifen zeigt keine Bewegung: Wähle eine Palette.
  • Protokolle: Die Integration protokolliert nur das Wesentliche (Start, gefundene, verlorene und zurückgekehrte Lampen, Fehler). Für Details setze LOG_LEVEL=debug am Container.

Grenzen​

  • Ohne die Hardware entwickelt: Das Verhalten mit echten LIFX-Lampen muss noch bestätigt werden.
  • Streifen und Matrizen werden als Ganzes gesteuert: keine Farbe pro Zone.
  • Die für einen Streifen oder eine Matrix angezeigte Farbe ist die, die die Lampe für das ganze Gerät meldet (ihre erste Zone).
  • Nicht unterstützt: der LIFX Switch (Relais und Tasten), der HEV-Reinigungszyklus der LIFX-Clean-Lampen (die Lampe selbst funktioniert als Farblampe), die Effekte Himmel und Farbdurchlauf (als Anderer Effekt angezeigt), die LIFX-Cloud und die Szenen der LIFX-App.
  • Ein Produkt, das neuer ist als die Produktliste der Integration, wird bis zu einem Update als Farblampe mit einem Weißbereich von 1500 bis 9000 K behandelt.

Konfigurationseinstellungen​

Diese Einstellungen fragt LIFX in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Deine LIFX-Lampen findensectionNeinLIFX-Lampen im selben Netzwerk wie Gladys werden automatisch gefunden: Öffne den Tab „Entdecken“. Richte sie zuerst in der LIFX-App ein. Fehlt eine, gib unten ihre IP-Adresse ein.
IP-Adressen der LIFX-LampenstringNeinOptional, durch Kommas getrennt. Nur für Lampen nötig, die die automatische Erkennung nicht findet.
AktualisierungsintervallselectNeinWie oft jede Lampe gelesen wird, um Änderungen aus der LIFX-App, über einen Sprachassistenten oder einen Wandschalter zu verfolgen.
ÜbergangselectNeinÜberblendung der Änderungen aus Gladys: Ein, Aus, Helligkeit, Farbe und Weißton.
Sprache der FunktionsnamenselectNeinNamen, die den Funktionen neuer Lampen gegeben werden (Licht, Helligkeit, LIFX-Effekt…). Die Lampennamen kommen aus der LIFX-App.

So installierst du LIFX in Gladys​

  1. Öffne in Gladys Integrationen: LIFX erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/guim31/gladys-lifx:1.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-lifx.

LIFX benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen​

LIFX ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂
Zuletzt aktualisiert am