Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Es gibt mehrere Möglichkeiten ein Nuki.io Türschloss in Loxone einzubinden:

Table of Contents
maxLevel1

NUKI Smartlock Plugin für LoxBerry (via NUKI Bridge)

Für den LoxBerry gibt es das Nuki Smartlock Plugin, das mittels Callback kein ständiges Pollen des Status erfordert.

Nuki per Nuki Bridge bzw. Android Bridge einbinden

Einrichtung von NUKI und der NUKI Bridge bzw. Android Bridge

Die Bridge bzw. Android Bridge muss mit dem oder den NUKI's eingerichtet und funktionsfähig sein.

In der Android App auf die Bridge klicken und dort die Entwickleroption aktivieren (siehe https://nuki.io/de/hilfe/bridge-de/b-funktionen/bridge-einstellungen-verwalten/). Dahinter verbirgt dich die benötigte IP-Adresse der Bridge und vor allem der TOKEN.

Für die API ist zudem die ID des NUKI Keyturners (bei mehreren NUKI's entsprechend mehrere IDs) erforderlich.


Wenn kein Android-Gerät zur Hand ist kann man auch, um einen Token zu bekommen, folgenden Befehl in einen Browser eingeben:

http://*IP*:8080/auth

Dann beginnt an der Bridge einige Zeit die LED zu leuchten und man muss innerhalb von 30 Sekunden den Knopf der Bridge drücken.
Anschließend bekommt man dann als Antwort im Browser einen Token und kann dann mit dem nachfolgenden Schritt weitermachen. 

Test der Bridge und Abruf der NUKIID

Im Browser eingeben:

http://*IP*:8080/list?token=*TOKEN*

*IP* und *TOKEN* muss natürlich durch deine Werte ersetzt werden.

Sollte der Webbrowser einen Download anbieten, dann die Datei speichern und im Editor öffnen.

Die angegebene NukiId (die Zahl) muss später bei den Aufrufen eingesetzt werden.

Opensource Software Bridge

Speziell auf den Amazon Fire HD Tablets läuft die Android Bridge nicht immer zu 100% stabil. Eine alternative entsteht hier: https://github.com/Gagi2k/nukibridge
Es wird die selbe http API verwendet (keine Änderungen in Loxone, nötig falls im Moment die Android Bridge verwendet wird) und lässt sich auf einem Rpi installieren.

Einrichtung in Loxone

Downloads

Template für Virtual In: VirtualIn_NUKI_Status.zip

Template für Virtual Out: VirtualOut_NUKI_Aktionen.zip

Beispieldatei: NUKI-Integration.Loxone (Überarbeitung der Stati auf APi V1,5)

Status
titleTipp
 Bitte beachtet, welche Anschlüsse der Eingänge an welchen Anschlüssen der Statusbausteine angeschlossen sind. Für die Fehlererkennung werden auch die Fehlerausgänge verwendet!

Abfragehäufigkeit 

Laut Jürgen Pansy, CPO NUKI, wird eine Abfrage des Schloss-Zustands über die API an den Keyturner weitergereicht und dort abgefragt (Link). Das regelmäßige Abfragen von Loxone (das sich leider nicht steuern lässt) wird sich vermutlich negativ auf die Batterielebensdauer auswirken. Eventuell das Abfrageintervall (im Beispiel 60 Sekunden) entsprechend höher stellen. Leider erhält man dadurch kein zeitnahes Feedback mehr, ob eine gesendete Aktion erfolgreich war.

Pairing mit der NUKI Android Bridge

Beim Verbindungsaufbau NUKI Keyturner ↔ NUKI Android Bridge machte es den Anschein, dass das Pairen nicht funktioniert, wenn das Android-Gerät nicht am Ladestecker angeschlossen ist. Ein Hinweis dazu wird in der App nicht angezeigt, und ich habe das auch nicht weiter getestet bzw. verfolgt.

WLAN Passwort NUKI Bridge

Die NUKI Bridge kann keine WLAN Passwörter mit Sonderzeichen verarbeiten.


Nuki mit Node-RED in Loxone einbinden

Anforderungen

  • Node-RED Installation (z.b. auf einem Raspberry Pi)
  • ein Nuki Türschloss - die Bridge wird NICHT benötigt!
  • Bluetooth (z.b. über ein USB Bluetooth Dongle)


Der node-red-contrib-nukible Node muss auf dem Node-RED installiert werden. Dieser Node basiert auf "nukible" - einer Open Source Anbindung  verfügbar unter https://github.com/as19git67/nukible Danach muss man das Pairing durchführen und die Zugangsdaten in Node-RED eingeben - und schon kann man die Tür öffnen, schließen, verriegeln und natürlich auch den Status abfragen. Die Anbindung an Loxone kann man schlussendlich wieder mit dem Loxone Node-RED Node (siehe Installation node-red auf RPi für node-red-contrib-loxone) erstellen.

Durch die Node-RED Anbindung kann man auch elegant zusätzliche elektronische Türschnapper anbinden (siehe Beispiel oben durch den Baustein "Haustüröffner").  Der Türstatus wird nur abgefragt, wenn zwei Bewegungsmelder innerhalb kurzer Zeit beide aktiv waren - so lässt sich die Anzahl der Abfragen reduzieren.

Weitere Informationen zum Node-Red Nuki Node findet man hier: npmjs und node-red-contrib-nukible