Geräteprofil · Licht

Nanoleaf Light Panels / Shapes / Canvas / Elements / Lines

Hinweis: Dieses Profil beruht auf der offiziellen Nanoleaf Open API Documentation und dem älteren OpenAPI-Dokument von Nanoleaf.

Voraussetzungen

1. Ein Nanoleaf-Gerät mit der lokalen Open API:
   • Light Panels (früher Aurora), Canvas, Shapes (Hexagons, Triangles, Mini Triangles), Elements, Lines
   • Laut Nanoleaf bieten auch die Essentials-Leuchtmittel mit WLAN dieselbe Schnittstelle; ungeprüft
2. Das Gerät muss im lokalen Netz erreichbar sein. Die Open API hört auf Port 16021.
3. Ein Zugriffstoken (auth_token). Das Token muss einmal am Gerät erzeugt werden, siehe unten — ohne Token antwortet das Gerät auf jede Anfrage mit 401 Unauthorized.
4. Ein nomos Controller mit einem Daemon, der die HTTP-Methode pro Befehl kennt (1.2.9 oder neuer). Ältere Daemons senden ausschließlich GET; damit lässt sich das Gerät nur lesen, nicht schalten.

Token erzeugen

Das Token wird nur in einem 30-Sekunden-Fenster vergeben:

1. Am Gerät den Einschaltknopf 5 bis 7 Sekunden gedrückt halten, bis die LEDs im Takt blinken. Alternativ in der App Nanoleaf (Smarter Series) unter den Geräteeinstellungen „Connect to API” antippen.

2. Innerhalb von 30 Sekunden auf einem Rechner im selben Netz:

   curl -X POST http://<IP-des-Geräts>:16021/api/v1/new
   

3. Die Antwort enthält das Token:

   {"auth_token":"6hw0Yk1q0ABCdeFghIJKlmnOPq12345"}
   

   Das Token bleibt gültig, bis es gelöscht wird (curl -X DELETE http://<IP>:16021/api/v1/<Token>) oder das Gerät zurückgesetzt wird. Es gilt nur für dieses Gerät.

Einrichtung

1. Dem Gerät im Router eine feste IP-Adresse geben
2. Skills → Add-ons: Profil importieren
3. Gerät anlegen und eintragen:
   • IP-Adresse des Geräts
   • Port – Standard 16021
   • AUTHTOKEN – das Token aus dem Schritt oben

Datenbereich

Abgefragt wird alle 15 Sekunden das vollständige Gerätedokument (GET /api/v1/<Token>/); das Intervall lässt sich ändern. Eine Abfrage liefert alle Werte auf einmal.

• Ein/Aus (state, zusätzlich als active)
• Helligkeit (level) in Prozent, 0–100
• Farbtemperatur (color-temperature): im System in Mired, 154–833, entsprechend 6500–1200 K
• Farbton (hue) 0–360° und Sättigung (saturation) 0–100 %
• Effekt (effect): der Name des laufenden Effekts
• Farbmodus (colormode, ausgeblendet): effect, hs oder ct
• Anzahl der Panels, Gerätename, Modell, Seriennummer, Firmware (ausgeblendet)
• Erreichbarkeit (reachable): aus dem Erfolg der HTTP-Abfragen

Schreibbar sind Ein/Aus, Helligkeit, Farbtemperatur, Farbton, Sättigung, der Effekt und Identifizieren (lässt die Panels kurz blinken).

Hinweise

• Farbtemperatur: nomos rechnet in Mired, das Profil nimmt den Bereich 1200–6500 K an (Light Panels, Shapes, Canvas). Weicht Ihr Modell davon ab, stimmt die Skalierung an den Rändern nicht. Die Firmware 1.5.0 meldet hier bekanntermaßen falsche Grenzen (0–100 statt 1200–6500); der gemeldete Wert selbst ist richtig.
• Farbe und Effekt schließen sich aus: Setzt man Farbton, Sättigung oder Farbtemperatur, verlässt das Gerät den laufenden Effekt und wechselt in den Farbmodus. Umgekehrt überschreibt die Auswahl eines Effekts die eingestellte Farbe. Der Farbmodus steht als colormode zur Verfügung.
• Effektnamen sind je Gerät verschieden und genau so zu schreiben, wie sie das Gerät liefert (Groß- und Kleinschreibung, Leerzeichen). Die Liste der verfügbaren Effekte steht in der Antwort unter effectsList; *Solid* ist der Pseudo-Effekt für eine statische Farbe. Ein unbekannter Name wird vom Gerät mit 400 Bad Request abgelehnt.
• Helligkeit 0 schaltet manche Modelle aus, andere auf die kleinste Stufe. Zum Ausschalten bitte Ein/Aus verwenden.
• Die Antwort wird je Schlüssel ausgewertet, der erste Treffer gilt. Die Firmware-Version ist deshalb die des Panel-Controllers, nicht die des Rhythm-Moduls, und die Panel-Anzahl die aus panelLayout.
• Port 16021 ist der Standard. Nanoleaf empfiehlt, den Port per mDNS (_nanoleafapi._tcp) zu ermitteln; falls Ihr Gerät einen anderen Port verwendet, lässt er sich im Profil eintragen.
• Nicht im Profil enthalten: Musik-/Rhythm-Synchronisation, das Setzen einzelner Panel-Farben und eigener Effektdaten (PUT /effects mit write), Zeitpläne, Layout-Drehung und Firmware-Updates.
• Das Token steht in der Gerätekonfiguration im Klartext. Wer es widerruft, muss es im Profil neu eintragen.