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:

    • on

    • bri

    • bri_inc

    • hue

    • sat

    • ct

    • dict

    • name

    • reachable

    • colormode

    • xy

    • type

    • modelid

    • swversion

    • activate_scene

    • modify_scene

    • alert

    • effect

    • daylight

    • sunriseoffset

    • sunsetoffset

    • temperature

    • presence

    • lightlevel

    • status

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

Item-Structs

Das Plugin stellt die folgenden Item-Structs zur Verfügung. Diese Informationen sind aus der plugin.yaml entnommen und möglicherweise nicht vollständig.

_light_basic

interne Vorlage-Struktur für eine Hue Leuchte (basic)

  • _light_basic (foo, interne Vorlage-Struktur für eine Hue Leuchte (basic))

    • onoff (bool, —)

    • level (num, —)

    • level_inc (num, —)

    • ct (num, —)

    • colormode (str, —)

    • dict (dict, —)

    • alert (str, —)

    • effect (str, —)

_light_extended

interne Vorlage-Struktur für eine Hue Leuchte (extended attributes)

  • _light_extended (foo, interne Vorlage-Struktur für eine Hue Leuchte (extended attributes))

    • lightname (str, —)

    • reachable (bool, —)

    • lighttype (str, —)

    • modelid (str, —)

    • swversion (str, —)

group

Vorlage-Struktur für eine Hue Gruppe

  • group (foo, Vorlage-Struktur für eine Hue Gruppe)

    • onoff (bool, —)

    • level (num, —)

    • hue (num, —)

    • sat (num, —)

    • ct (num, —)

    • colormode (str, —)

    • xy (list, —)

group_activate_scene

Vorlage-Struktur zum aktivieren von Hue Szenen

  • group_activate_scene (str, Vorlage-Struktur zum aktivieren von Hue Szenen)

light

Vorlage-Struktur für eine Hue Leuchte

  • light (foo, Vorlage-Struktur für eine Hue Leuchte)

    • hue (num, —)

    • sat (num, —)

    • xy (list, —)

light_extended

Vorlage-Struktur für eine Hue Leuchte mit erweiteten Attributen/Sub-Items

  • light_extended (foo, Vorlage-Struktur für eine Hue Leuchte mit erweiteten Attributen/Sub-Items)

light_ww

Vorlage-Struktur für eine Hue Leuchte (warm white)

  • light_ww (foo, Vorlage-Struktur für eine Hue Leuchte (warm white))

light_ww_extended

Vorlage-Struktur für eine Hue Leuchte mit erweiteten Attributen/Sub-Items (warm white)

  • light_ww_extended (foo, Vorlage-Struktur für eine Hue Leuchte mit erweiteten Attributen/Sub-Items (warm white))

light_xy

Vorlage-Struktur für eine Hue Leuchte (Farbe nur über xy)

  • light_xy (foo, Vorlage-Struktur für eine Hue Leuchte (Farbe nur über xy))

    • xy (list, —)

light_xy_extended

Vorlage-Struktur für eine Hue Leuchte mit erweiteten Attributen/Sub-Items (Farbe nur über xy)

  • light_xy_extended (foo, Vorlage-Struktur für eine Hue Leuchte mit erweiteten Attributen/Sub-Items (Farbe nur über xy))

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