Plugin ‚hue3‘ Konfiguration

plugin logo

Im folgenden sind etwaige Anforderungen und unterstützte Hardware beschrieben. Danach folgt die Beschreibung, wie das Plugin hue3 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.

ACHTUNG: Dieses Plugin ist als develop gekennzeichnet. Es kann daher sein, dass es noch nicht sämtliche Funktionen unterstützt oder noch fehlerhaft ist.

Beschreibung

Anbindung des Philips/Signify Hue Systems über eine Hue Bridge unter Nutzung des neuen API v2

Anforderungen

  • Minimum SmartHomeNG Version: 1.10.0

Konfiguration

Im folgenden ist beschrieben, wie das Plugin hue3 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_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

Item Attribute

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

hue3_function

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

  • Datentyp: str

  • Mögliche Werte:

    • on

    • bri

    • bri_inc

    • xy

    • ct

    • dict

    • name

    • reachable

    • connectivity

    • type

    • modelid

    • swversion

    • activate

    • activate_scene

    • modify_scene

    • alert

    • effect

    • daylight

    • sunriseoffset

    • sunsetoffset

    • temperature

    • motion

    • presence

    • lightlevel

    • status

    • event

    • initial_press

    • repeat

    • short_release

    • long_release

    • power_status

    • battery_level

hue3_id

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

  • Datentyp: str

hue3_resource

Anzusteuernde Resource, falls nicht angegeben wird ‚light‘ angenommen

  • Datentyp: str

  • Mögliche Werte:

    • light

    • group

    • scene

    • sensor

    • button

    • device

    • device_power

hue3_transition_time

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, —)

    • 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, —)

    • connectivity (str, —)

group

Vorlage-Struktur für eine Hue Gruppe

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

    • onoff (bool, —)

    • level (num, —)

    • alert (str, —)

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)

    • 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