Plugin ‚hue2‘ Konfiguration

plugin logo

Im folgenden sind etwaige Anforderungen und unterstützte Hardware beschrieben. Danach folgt die Beschreibung, wie das Plugin hue2 konfiguriert wird. Außerdem ist im folgenden beschrieben, wie das Plugin in den Item Definitionen genutzt werden kann. [1]

Es handelt sich bei diesem Plugin um ein gateway Plugin.

Beschreibung

Anbindung des Philips/Signify Hue Systems über eine Hue Bridge (v1 oder v2)

Anforderungen

  • Minimum SmartHomeNG Version: 1.8.2

Konfiguration

Im folgenden ist beschrieben, wie das Plugin hue2 konfiguriert wird. Außerdem ist im folgenden beschrieben, wie das Plugin in den Item Definitionen genutzt werden kann.

Parameter

Das Plugin verfügt über folgende Parameter, die in der Datei ../etc/plugin.yaml konfiguriert werden:

bridge_ip

IP Adresse der Philips/Signify Hue Bridge Dieser Parameter wird durch das Plugins in den Konfigurationsdaten abgelegt. Er ist in der Admin GUI nicht änderbar

  • Datentyp: ip

bridge_port

Port der Philips/Signify Hue Bridge Dieser Parameter wird durch das Plugins in den Konfigurationsdaten abgelegt. Er ist in der Admin GUI nicht änderbar

  • Datentyp: int

  • Standardwert: 80

  • Minimalwert: 0

bridge_serial

Seriennummer der Philips/Signify Hue Bridge Dieser Parameter wird durch das Plugins in den Konfigurationsdaten abgelegt. Er ist in der Admin GUI nicht änderbar

  • Datentyp: str

bridge_user

Username/Anwendungsschlüssel um auf die Philips/Signify Hue Bridge zuzugreifen Dieser Parameter wird durch das Plugins in den Konfigurationsdaten abgelegt. Er ist in der Admin GUI nicht änderbar

  • Datentyp: str

default_transitionTime

Zeit in sekunden welche die Leuchte benötigt um in einen neuen Zustand überzugehen

  • Datentyp: float

  • Standardwert: 0.4

  • Minimalwert: 0

polltime_bridge

Zykluszeit in Sekunden (lang) für die Abfrage der weiteren Informationen der Hue Bridge

  • Datentyp: int

  • Standardwert: 90

polltime_lights

Zykluszeit in Sekunden (kurz) für die Abfrage von Informationen über Leuchten

  • Datentyp: int

  • Standardwert: 5

  • Minimalwert: 1

polltime_sensors

Zykluszeit in Sekunden (kurz) für die Abfrage von Sensoren

  • Datentyp: int

  • Standardwert: 2

  • Minimalwert: 1

Item Attribute

Das Plugin unterstützt folgende Item Attribute, die in den Dateien im Verzeichnis ../items verwendet werden:

dpt3_dim

Aktiviert DPT3 dimmen

  • Datentyp: bool

hue2_function

Anzusteuernde Funktion für die gewählte Resource/ID

  • Datentyp: str

  • Mögliche Werte:

    •   -   <noch keine Funktion gewählt>

    • on   -   Mehrere Funktionen auf einmal -> dict, r/w (resource: light, group)

    • bri   -   Ein-/Ausschalten -> bool, r/w (resource: light, group)

    • bri_inc   -   Helligkeit, 0 … 255 -> num, r/w (resource: light, group)

    • hue   -   Relative Helligkeitsveränderung 0 … 254, w/o (resource: light, group)

    • sat   -   Farbton, 0 … 65535 -> num, r/w (resource: light), group

    • ct   -   Sättigung, 0 … 255 -> num, r/w (resource: light, group)

    • dict   -   ct Wert -> num, r/w (resource: light, group)

    • name   -   Name -> str, r/w (resource: light, group, scene, sensor)

    • reachable   -   Erreichbar -> bool, r/o (resource: light)

    • colormode   -   Farb-Mode -> str (Werte: ct, hs, xy), r/o (resource: light, group)

    • xy   -   xy Werte -> list, r/w (resource: light, group)

    • type   -   Typ des Leuchtmittels -> str, r/o (resource: light)

    • modelid   -   Model Id des Leuchtmittels -> str, r/o (resource: light)

    • swversion   -   Software Version des Leuchtmittels -> str, r/o (resource: light)

    • activate_scene   -   Aktivieren einer Szene für Leuchten in der selektierten Gruppe (hue2_id) -> str w/o (resource: group)

    • modify_scene   -   Anpassen einer Szene für Leuchten in der selektierten Gruppe (hue2_id) -> str w/o (resource: group)

    • alert   -   Benachrichtigung -> str (Werte: none, select, lselect) (resource: light, group)

    • effect   -   Lichteffekt -> str (Werte: none, colorloop) (resource: light, group)

    • daylight   -   Tageslicht -> bool, r/o (resource: sensor)

    • sunriseoffset   -   Tageslicht: sunriseoffset -> num r/o (resource: sensor)

    • sunsetoffset   -   Tageslicht: sunsetoffset -> num r/o (resource: sensor)

    • temperature   -   Temperatur -> num r/o (resource: sensor)

    • presence   -   Präsenz -> bool, r/o (resource: sensor)

    • lightlevel   -   Sensor ‚lightlevel‘ -> num r/o (resource: sensor)

    • status   -   Sensor ‚status‘ -> num, r/o (resource: sensor)

hue2_id

ID der anzusteuernden resouce. Der Typ der resource wird mit ‚hue2_recource‘ festgelegt.

  • Datentyp: str

hue2_reference_light_id

ID der des referenzwert gebenden Lichtes. Nur möglich wenn resource == group

  • Datentyp: str

hue2_resource

Anzusteuernde Resource, falls nicht angegeben wird ‚light‘ angenommen

  • Datentyp: str

  • Mögliche Werte:

    • light

    • group

    • scene

    • sensor

hue2_transitionTime

Zeit für Übergang (in sec)

  • Datentyp: num

Logik Parameter

Das Plugin verfügt über folgende Parameter, die in der Datei ../etc/logic.yaml konfiguriert werden:

Keine Logik Parameter in den Metadaten beschrieben - Bitte in der README nachsehen (siehe Fußnote)

Plugin Functions

Das Plugin verfügt über folgende öffentliche Funktionen, die z.B. in Logiken aufgerufen werden können.

Keine