Nuki Bridge Bausteine Hilfe

Nuki SmartLock

Beschreibung

Dieser Baustein ermöglicht das Abschließen (Sperren), Aufschließen (Entsperren) und Entriegeln eines Türschlosses mittels Nuki SmartLock und liefert Informationen über den Schließzustand, Türsensor und Ladestand.

Um diesen Baustein zu nutzen, wird eine Nuki Bridge benötigt, die im gleichen Netzwerk erreichbar ist. Zur Konfiguration sind die Parameter "token" der Nuki Bridge und "nukiId" (nachfolgend als "Geräte-ID" bezeichnet) des Nuki SmartLocks erforderlich. Die Einrichtung der Nuki Bridge und das Auslesen dieser Parameter ist auf dieser Webseite beschrieben:

  1. Ermitteln der Nuki Bridge IP-Adresse --> Die IP-Adresse der Nuki Bridge sollte statisch vergeben werden.
  2. Erzeugen eines Zugriffstokens --> Das Erzeugen muss innerhalb von 30sek an der Nuki Bridge bestätigt werden.
  3. Ermitteln der Nuki SmartLock Gerätenummer --> Falls mehrere Geräte angezeigt werden, ist die Nummer des Nuki SmartLocks (deviceType = 0 oder 4) relevant.

Nach jeder Aktion (Abschließen, Aufschließen, Entriegeln), die die Nuki Bridge als "erfolgreich" quittiert, wird der "Status: Schloss" entsprechend aktualisiert, ohne dass dabei der tatsächliche Zustand abgefragt wird.

In der Praxis führt dies zu zügigen Rückmeldungen (Visualisierung), die im Rahmen des nächsten Aktualisierungszyklus gegebenenfalls korrigiert werden. Dies betrifft insbesondere das Entsperren der Tür (Status = 5), der nach der eingestellten Sperrzeit auf "Nicht verschlossen" (Status = 3) wechselt, dies aber erst bei der nächsten Aktualisierung des Gerätestatus im X1 wiederspiegelt.

Hinweis: Dieser Baustein eigenet sich gut, um ein einzelnes SmartLock, dass mit einer Bridge verbunden ist, zu steuern. Falls mehrere Geräte mit der gleichen Bridge verbunden sind, ist die Kombination von Nuki Bridge, Nuki Auftraggeber und Nuki Antwortfilter vorzuziehen.

Eigenschaften

Eingänge

Bezeichnung Porttyp Beschreibung
Abschließen Binär

Fordert zum Abschließen (Sperren) der Tür auf, wenn eine 1 übermittelt wird.

Aufschließen Binär

Fordert zum Aufschließen (Entsperren) der Tür auf, wenn eine 1 übermittelt wird.

Hinweis: Je nach Konfiguration des Nuki SmartLocks kann "Aufschließen" den Schlüssel geausoweit drehen, wie beim "Entsperren".

Entsperren Binär

Fordert zum Entsperren des Türriegels auf, wenn eine 1 gesendet wird. Falls die Tür abgeschlossen war, wird sie zuvor aufgeschlossen.

Info (direkt) Binär

Fragt den Status des Nuki SmartLocks und des Türsensors direkt am Gerät ab.

Dies wirkt sich negativ auf die Batterielaufzeit der Geräte aus.

Info (zwischengespeichert) Binär

Fragt den Status des Nuki SmartLocks und des Türsensors an der Bridge ab.

Dies wirkt sich positiv auf die Batterielaufzeit der Geräte aus.

Parameter

Bezeichnung Porttyp Beschreibung
Bridge IP-Adresse Text

Legt die IP4-Adresse der Nuki Bridge (z.B. "0.0.0.0") fest. Der Logikbaustein ergänzt intern den Port "8080".

Bridge Token Text

Eingabe des Zugriffstokens.

Gerät-ID Text

Legt den Bezeichner des Geräts fest, an das die Anforderungen (Abschließen, Aufschließen, Entsperren, Statusaktualisierung) gesendet werden sollen.

Gerättyp Ganzzahl

Angabe des Nuki-Gerättyps (siehe Device Types).

Ausgänge

Bezeichnung Porttyp Beschreibung
Status: Schloss Ganzzahl

Liefert den Status des Nuki SmartLocks (siehe Lock State).

Status: Tür Ganzzahl

Liefert den Status des Nuki DoorSensors (siehe DoorSensor State).

Status: Batterie Prozent

Liefert den Ladestand des Nuki SmartLocks (0..100%).

Fehler Text

Liefert eventuelle Netzwerk-Fehlermeldungen aus der Kommunikation mit der Nuki Bridge.

Anwendung

Beispiel: Türschloss

Die Steuerung der Wohnungstür mit Hife eines Nuki SmartLocks kann folgendermaßen aussehen:

Nuki SmartLock Logikbaustein
Anwendungsbeispiel des Nuki SmartLocks Logikbausteins.

Gesteuert wird das Schloss mit Hilfe von drei Eingängen, über die beispielsweise das Schloss mit Tastern oder im Rahmen einer Szene abgeschlossen, aufgeschlossen oder entriegelt werden kann. Hierzu ein paar Empfehlungen für die Konfiguration der Datenpunkte:

Der Telegrammgenerator sorgt dafür, dass der Zustand (incl. Ladestand der Batterie) regelmäßig von der Nuki Bridge ausgelesen wird. Dafür sind zwei Eingänge vorgesehen:

Auf der Seite der Ausgänge werden die vom Nuki SmartLock definierten Zustände ausgegeben. Mit dem "Vergleicher+"-Logikbaustein werden die Werte ausgewertet (Abgeschlossen/Aufgeschlossen/Störung bzw. Geöffnet/Geschlossen/Störung). Der Ladestand wird direkt weitergereicht. Mit einem Vergleicher könnte hier ein Alarm bei kritischem Ladestand realisiert werden.

Ein klassischer Türsensor erkennt wenn die Tür geöffnet wird und setzt den Zustand des Schlosses auf "Offen" (Filterbaustein in der letzten Zeile). Dadurch wird dieser Status auch außerhalb eines Updatezyklus umgehend bereitgestellt.

Lizenzinformationen