Das Nuki Smart Lock 4 Pro ist ein batteriebetriebenes Nachrüst-Smart-Lock mit integriertem WLAN und Matter over Thread. Die Vorlage bindet es über die eigene MQTT-Schnittstelle des Schlosses (Nuki MQTT API) in TapHome ein, sodass weder eine Nuki Bridge noch ein anderes Gateway nötig ist. Das Schloss arbeitet als MQTT-Client: Es verbindet sich mit einem MQTT-Broker im lokalen Netzwerk, veröffentlicht seine Zustände unter den Topics nuki/<Nuki ID>/… und nimmt Schließbefehle über dieselben Topics entgegen. Als Broker kann die Schnittstelle MQTT Broker dienen, die direkt auf dem TapHome Core läuft.
TapHome liest den Schlossstatus, den Zustand des Türsensors, den Batteriestand und die letzte Schließaktion und sendet die Befehle Verriegeln, Entriegeln, Falle ziehen und Lock ’n’ Go.
Laut Nuki ist dieselbe MQTT API auf allen Smart-Lock-Modellen der 4. Generation (mit oder ohne Pro), auf dem Smart Lock 3.0 Pro (Firmware 3.5.12 oder höher) sowie auf den neuesten Modellen Smart Lock Ultra, Smart Lock Pro (5. Generation) und Smart Lock Go verfügbar. Die Vorlage ist nach dem Smart Lock 4 Pro benannt.
Das Schloss verbindet sich nur mit einem Broker im lokalen Netzwerk (private Adressen 10.x.x.x, 172.16.x.x – 172.31.x.x, 192.168.x.x), immer über Port 1883 und ohne Verschlüsselung — TLS wird nicht unterstützt. Die Sicherheit der Befehle hängt vollständig von der Sicherheit des WLANs bzw. LANs ab. Verwenden Sie die MQTT-Schnittstelle nur in einem vertrauenswürdigen Netzwerk.
Netzwerkverbindung
MQTT läuft über die Netzwerkverbindung des Schlosses, daher muss sich das Schloss zuerst im selben Netzwerk wie der Broker befinden. Nuki unterstützt MQTT über WLAN oder über Thread (Matter).
- WLAN: Öffnen Sie in der Nuki App beim Schloss Settings → Features & Configuration → Built-in Wi-Fi → Configure Wi-Fi, wählen Sie das Netzwerk und geben Sie dessen Passwort ein. Das Schloss unterstützt nur 2,4-GHz-WLAN (802.11 b/g/n); 5-GHz-Netzwerke werden nicht unterstützt.
- Thread: Alternativ wird das Schloss über Matter over Thread mit dem Netzwerk verbunden, wie von Nuki beschrieben.
Eine Verkabelung entfällt — das Schloss läuft mit Batterien (4× AA oder das Nuki Power Pack) und wird gemäß der Nuki-Montageanleitung mechanisch an der Innenseite der Tür montiert.
Konfiguration
MQTT-Broker
Das Schloss benötigt einen MQTT-Broker, den es im lokalen Netzwerk erreichen kann:
| Anforderung | Wert |
|---|---|
| Broker-Adresse | private IPv4-Adresse oder ein Hostname, der zu einer privaten IP-Adresse aufgelöst wird |
| Port | 1883 (fest, nicht änderbar) |
| Verschlüsselung | keine (TLS wird nicht unterstützt) |
| Benutzername und Passwort | auf Broker-Seite optional; jeweils höchstens 32 Zeichen |
| MQTT-Protokollversion | 3.1.1 oder neuer |
Cloud-Broker im Internet funktionieren nicht. Mit der Schnittstelle MQTT Broker von TapHome ist die Broker-Adresse die IP-Adresse des TapHome Core. Sind am Broker ein Benutzername und ein Passwort gesetzt, geben Sie dieselben Zugangsdaten in der Nuki App ein.
MQTT in der Nuki App aktivieren
- Tippen Sie in der Nuki App auf das Schloss und öffnen Sie seine Einstellungen.
- Gehen Sie zu Features & Configuration → Smart Home → MQTT und folgen Sie dem Aktivierungsassistenten.
- Geben Sie den Hostnamen oder die IPv4-Adresse des Brokers ein (mit TapHome als Broker die IP-Adresse des Core — nicht die IP-Adresse des Schlosses) sowie Benutzername und Passwort, falls der Broker sie verlangt.
- Lassen Sie Allow locking eingeschaltet (Standard). Ohne diese Option abonniert das Schloss die Befehls-Topics nicht: TapHome zeigt dann nur seine Zustände an und kann es weder verriegeln noch entriegeln.
- Auto discovery (Home-Assistant-Discovery, standardmäßig eingeschaltet) wird von TapHome nicht genutzt — die Vorlage liest nur die Topics
nuki/<Nuki ID>/…. Die Option kann eingeschaltet bleiben oder ausgeschaltet werden. - Prüfen Sie den Verbindungsstatus, den die Nuki App im selben MQTT-Bereich anzeigt.
Nuki ID
Die Topics jedes Schlosses enthalten seine Nuki ID in hexadezimaler Form, zum Beispiel 2BB28570. Sie ist auf dem Etikett des Schlosses aufgedruckt und wird auch in der Geräteverwaltung der Nuki App angezeigt. Die ID muss genau in dieser hexadezimalen Form eingegeben werden.
Parameter der Vorlage
In TapHome wird die Vorlage über eine Schnittstelle Packet Parser mit folgenden Importparametern hinzugefügt:
| Parameter | Was eingeben | Beispiel |
|---|---|---|
| Nuki ID (hex) | hexadezimale Nuki ID des Schlosses, aus der Nuki App oder vom Etikett | 2BB28570 |
| IP-Adresse des MQTT-Brokers | Adresse des Brokers für TapHome — mit der Schnittstelle MQTT Broker von TapHome 127.0.0.1 (der Core verbindet sich mit sich selbst); das Schloss bekommt die IP-Adresse des Core, nicht die IP-Adresse des Schlosses | 127.0.0.1 |
Gerätefunktionen
Schloss
Der Schalter Schloss zeigt Verriegelt oder Entriegelt an. Die Nuki-Zustände Wird entriegelt, Entriegelt, Falle gezogen, Entriegelt (Lock ’n’ Go) und Falle wird gezogen gelten alle als Entriegelt. Während des Verriegelns sowie bei nicht kalibriertem Schloss oder blockiertem Motor behält der Schalter seinen letzten Wert.
Die Auswahl Verriegelt sendet die Nuki-Schließaktion lock, die Auswahl Entriegelt sendet unlock — das Schloss entriegelt, ohne die Falle zu ziehen. Die Vorlage sendet einen Befehl erst, nachdem sie einen Zustand vom Schloss empfangen hat, und nur dann, wenn sich der gewünschte Wert vom aktuellen Zustand unterscheidet.
Service-Attribute des Geräts Schloss:
- Nuki-Schlossstatus — der genaue Zustand, einschließlich Wird verriegelt, Wird entriegelt, Falle gezogen, Falle wird gezogen, Entriegelt (Lock ’n’ Go), Nicht kalibriert und Motor blockiert
- Schlossbatterie kritisch und Keypad-Batterie kritisch — ob die Batterien ersetzt werden müssen
- Batterie wird geladen
- Broker-Verbindung — ob das Schloss mit dem MQTT-Broker verbunden ist
- Nuki-Server-Verbindung
- Befehlsantwort — Erfolg oder der vom Schloss gemeldete Fehlercode des letzten Befehls
- Letzte Aktion — Name der letzten Schließaktion, zum Beispiel entriegeln, verriegeln, Falle ziehen oder Lock ’n’ Go (derselbe Wert wie beim Gerät Letzte Schließaktion, siehe unten)
- Letzte Aktualisierung — Zeitpunkt der letzten Aktualisierung vom Schloss, angezeigt in der Ortszeit des TapHome Core
- Firmwareversion
Das Gerät Schloss hat außerdem die Service-Aktion Lock ’n’ Go.
Verriegeln, Falle ziehen und Lock ’n’ Go
- Verriegeln — Taster: verriegelt das Schloss (Nuki-Schließaktion lock). Der Befehl wird bei jedem Drücken gesendet, unabhängig vom Zustand des Schalters Schloss.
- Falle ziehen — Taster: entriegelt das Schloss und zieht die Falle, sodass sich die Tür ohne Drücker öffnen lässt.
- Lock ’n’ Go — Taster: entriegelt das Schloss und verriegelt es wieder, nachdem die Tür geschlossen wurde.
Türsensor
Der Türsensor zeigt Offen oder Geschlossen an, wenn ein Nuki Door Sensor mit dem Schloss gekoppelt ist. Meldet der Türsensor eine Manipulation, zeigt das Gerät Offen an und löst eine Warnung aus. Ein deaktivierter Türsensor wird als Informationsmeldung angezeigt.
Batteriestand
Batteriestand zeigt den Ladezustand der Schlossbatterien in % an.
Letzte Schließaktion
Letzte Schließaktion zeigt die Nummer der letzten Schließaktion an, die das Schloss ausführen wollte — ausgelöst von TapHome, der Nuki App, der Taste am Schloss, einem Keypad oder einem Fob:
| Wert | Schließaktion |
|---|---|
| 1 | entriegeln |
| 2 | verriegeln |
| 3 | Falle ziehen |
| 4 | Lock ’n’ Go |
| 5 | Lock ’n’ Go mit Falle ziehen |
| 6 | vollständig verriegeln |
| 80 | Fob (ohne Aktion) |
| 90 | Taste (ohne Aktion) |
Der Wert bleibt numerisch, damit er sich als Auslöser für smart rules eignet; das Gerät Schloss zeigt den Namen derselben Aktion in seinem Service-Attribut Letzte Aktion an. Erfolglose Codeeingaben am Keypad und Befehle außerhalb eines erlaubten Zeitfensters meldet das Schloss nicht.
Nach einem Neustart des TapHome Core sendet die Vorlage keinen Befehl an das Schloss — der Schalter Schloss übernimmt den vom Schloss gemeldeten Zustand. Das Schloss veröffentlicht seine Zustände als Retained Messages, daher werden die Werte aus den Daten wiederhergestellt, die der Broker vorhält; ein Gerät, das nach dem Neustart keinen solchen Wert erhält, zeigt den richtigen Zustand bei der nächsten Änderung am Schloss an.
Fehlerbehebung
- Das Schloss verbindet sich nicht mit dem Broker: Prüfen Sie in der Nuki App, dass die Broker-Adresse eine private IP-Adresse im selben Netzwerk ist (mit TapHome die IP-Adresse des Core), dass der Broker Verbindungen auf Port 1883 ohne TLS annimmt und dass Benutzername und Passwort mit den Broker-Einstellungen übereinstimmen. Das Service-Attribut Broker-Verbindung muss Verbunden anzeigen.
- Die MQTT-Aktivierung in der Nuki App schlägt fehl: Aktualisieren Sie die Firmware des Schlosses, prüfen Sie, dass das Schloss mit dem Netzwerk verbunden ist (2,4-GHz-WLAN oder Thread), dass die MQTT-Protokollversion 3.1.1 oder neuer ist und dass Benutzername und Passwort am Broker berechtigt sind. Meldet die App eine ungültige Client-Kennung, bittet Nuki, den Nuki-Support zu kontaktieren.
- Zustände werden angezeigt, aber Befehle bewirken nichts: Schalten Sie in den MQTT-Einstellungen der Nuki App Allow locking ein. Das Service-Attribut Befehlsantwort zeigt Erfolg oder den Fehlercode des Schlosses an. Das Schloss verarbeitet jeweils nur einen Befehl; werden mehrere Befehle parallel gesendet, können sich die Antworten überschneiden.
- In TapHome wird nichts angezeigt: Prüfen Sie die Nuki ID — sie muss in hexadezimaler Form genau so eingegeben sein, wie sie in der Nuki App oder auf dem Etikett steht.
- Nuki-Schlossstatus zeigt Nicht kalibriert: Schließen Sie die Kalibrierung des Schlosses in der Nuki App ab.
- Der Türsensor ändert sich nie: Mit dem Schloss muss ein Nuki Door Sensor gekoppelt sein; ohne ihn meldet das Schloss keinen Türzustand.
