A Nuki Smart Lock 4 Pro elemes, utólag felszerelhető okoszár beépített Wi-Fi-vel és Matter over Thread támogatással. A sablon a zár saját MQTT interfészén (Nuki MQTT API) keresztül kapcsolja a TapHome-hoz, így sem Nuki Bridge, sem más átjáró nem kell. A zár MQTT kliensként működik: csatlakozik a helyi hálózat egy MQTT brokeréhez, az állapotait a nuki/<Nuki ID>/… topicokban teszi közzé, és ugyanezeken a topicokon fogadja a zárparancsokat. A broker lehet a közvetlenül a TapHome Core-on futó MQTT Broker interfész.
A TapHome kiolvassa a zár állapotát, az ajtóérzékelő állapotát, az elemek töltöttségi szintjét és az utolsó zárműveletet, és elküldi a zárás, nyitás, zárnyelv behúzása és Lock ’n’ Go parancsokat.
A Nuki szerint ugyanez az MQTT API elérhető az összes 4. generációs Smart Lock modellen (Pro-val vagy anélkül), a Smart Lock 3.0 Pro-n (3.5.12-es vagy újabb firmware-rel), valamint a legújabb Smart Lock Ultra, Smart Lock Pro (5. generáció) és Smart Lock Go modelleken. A sablon a Smart Lock 4 Pro nevét viseli.
A zár csak a helyi hálózatban lévő brokerhez csatlakozik (privát címek: 10.x.x.x, 172.16.x.x – 172.31.x.x, 192.168.x.x), mindig az 1883-as porton és titkosítás nélkül — a TLS nem támogatott. A parancsok biztonsága teljes mértékben a Wi-Fi vagy a LAN biztonságán múlik. Az MQTT interfészt csak megbízható hálózatban használd.
Hálózati kapcsolat
Az MQTT a zár hálózati kapcsolatán fut, ezért a zárnak először a brokerrel azonos hálózatba kell kerülnie. A Nuki az MQTT-t Wi-Fi-n vagy Threaden (Matter) keresztül támogatja.
- Wi-Fi: a Nuki alkalmazásban nyisd meg a zár Settings → Features & Configuration → Built-in Wi-Fi → Configure Wi-Fi menüjét, válaszd ki a hálózatot, és add meg a jelszavát. A zár csak a 2,4 GHz-es Wi-Fi-t (802.11 b/g/n) támogatja; az 5 GHz-es hálózatok nem támogatottak.
- Thread: alternatívaként a zár Matter over Threaden keresztül csatlakozik a hálózathoz, a Nuki leírása szerint.
Bekötés nincs — a zár elemekről működik (4× AA vagy Nuki Power Pack), és a Nuki telepítési útmutatója szerint mechanikusan az ajtó belső oldalára kell felszerelni.
Konfiguráció
MQTT broker
A zárnak olyan MQTT brokerre van szüksége, amelyet a helyi hálózatban elér:
| Követelmény | Érték |
|---|---|
| Broker címe | privát IPv4-cím, vagy privát IP-címre feloldódó hosztnév |
| Port | 1883 (rögzített, nem módosítható) |
| Titkosítás | nincs (a TLS nem támogatott) |
| Felhasználónév és jelszó | a broker oldalán opcionális; mindkettő legfeljebb 32 karakter |
| MQTT protokollverzió | 3.1.1 vagy újabb |
Az interneten lévő felhőbrokerek nem működnek. A TapHome MQTT Broker interfészével a broker címe a TapHome Core IP-címe. Ha a brokeren felhasználónév és jelszó van beállítva, ugyanezeket kell megadni a Nuki alkalmazásban.
Az MQTT bekapcsolása a Nuki alkalmazásban
- A Nuki alkalmazásban koppints a zárra, és nyisd meg a beállításait.
- Lépj a Features & Configuration → Smart Home → MQTT menübe, és kövesd az aktiválási varázslót.
- Add meg a broker hosztnevét vagy IPv4-címét (ha a TapHome a broker, a Core IP-címét — nem a zár IP-címét), valamint a felhasználónevet és a jelszót, ha a broker megköveteli.
- Hagyd bekapcsolva az Allow locking opciót (alapértelmezett). Nélküle a zár nem iratkozik fel a parancs-topicokra: a TapHome ekkor csak az állapotait mutatja, bezárni vagy kinyitni nem tudja.
- Az Auto discovery funkciót (Home Assistant discovery, alapértelmezetten bekapcsolva) a TapHome nem használja — a sablon csak a
nuki/<Nuki ID>/…topicokat olvassa. Bekapcsolva maradhat, vagy kikapcsolhatod. - Ellenőrizd a kapcsolat állapotát, amelyet a Nuki alkalmazás ugyanebben az MQTT szakaszban mutat.
Nuki ID
Az egyes zárak topicjai a zár Nuki ID-ját tartalmazzák hexadecimális formában, például 2BB28570. Rá van nyomtatva a zár címkéjére, és a Nuki alkalmazás eszközkezelésében is megjelenik. Az azonosítót pontosan ebben a hexadecimális formában kell megadni.
A sablon paraméterei
A TapHome-ban a sablont egy Packet Parser interfészen keresztül adod hozzá, a következő importálási paraméterekkel:
| Paraméter | Mit adj meg | Példa |
|---|---|---|
| Nuki ID (hex) | a zár hexadecimális Nuki ID-ja a Nuki alkalmazásból vagy a címkéről | 2BB28570 |
| MQTT broker IP-címe | a broker címe a TapHome számára — a TapHome MQTT Broker interfészével 127.0.0.1 (a Core saját magához csatlakozik); a zár a Core IP-címét kapja, nem a zár IP-címét | 127.0.0.1 |
Az eszköz funkciói
Zár
A Zár kapcsoló Bezárva vagy Kinyitva állapotot mutat. A Nuki nyitás folyamatban, kinyitva, zárnyelv behúzva, kinyitva (Lock ’n’ Go) és zárnyelv behúzása folyamatban állapota mind Kinyitva állapotnak számít. Zárás közben, valamint ha a zár nincs kalibrálva vagy a motor blokkolva van, a kapcsoló megtartja az utolsó értékét.
A Bezárva kiválasztása a Nuki lock (zárás) zárműveletet küldi, a Kinyitva kiválasztása az unlock (nyitás) műveletet — a zár a zárnyelv behúzása nélkül nyit ki. A sablon csak azután küld parancsot, hogy állapotot kapott a zártól, és csak akkor, ha a kért érték eltér az aktuális állapottól.
A Zár eszköz szervizattribútumai:
- Nuki zárállapot — a pontos állapot, beleértve a Zárás folyamatban, Nyitás folyamatban, Zárnyelv behúzva, Zárnyelv behúzása folyamatban, Kinyitva (Lock ’n’ Go), Nincs kalibrálva és Motor blokkolva állapotot
- Zár eleme kritikus és Billentyűzet eleme kritikus — cserélni kell-e az elemeket
- Akkumulátor töltése
- Brokerkapcsolat — csatlakozik-e a zár az MQTT brokerhez
- Nuki szerverkapcsolat
- Parancsválasz — Sikeres, vagy a zár által jelentett utolsó parancs hibakódja
- Utolsó művelet — az utolsó zárművelet neve, például nyitás, zárás, zárnyelv behúzása vagy Lock ’n’ Go (ugyanaz az érték, mint az Utolsó zárművelet eszközé, lásd lent)
- Utolsó frissítés — a zártól érkezett utolsó frissítés időpontja, a TapHome Core helyi idejében
- Firmware-verzió
A Zár eszköznek Lock ’n’ Go szervizakciója is van.
Zárás, zárnyelv behúzása és Lock ’n’ Go
- Zárás — nyomógomb: bezárja a zárat (Nuki lock zárművelet). Minden megnyomáskor elküldi a parancsot, a Zár kapcsoló állapotától függetlenül.
- Zárnyelv behúzása — nyomógomb: kinyitja a zárat és behúzza a zárnyelvet, így az ajtó kilincs nélkül is kinyitható.
- Lock ’n’ Go — nyomógomb: kinyitja a zárat, majd az ajtó becsukása után újra bezárja.
Ajtóérzékelő
Az Ajtóérzékelő Nyitva vagy Csukva állapotot mutat, ha a zárral Nuki Door Sensor van párosítva. Ha az ajtóérzékelő szabotázst jelez, az eszköz Nyitva állapotot mutat, és figyelmeztetést ad. A deaktivált ajtóérzékelőt tájékoztató üzenet jelzi.
Elemszint
Az Elemszint a zár elemeinek töltöttségét mutatja %-ban.
Utolsó zárművelet
Az Utolsó zárművelet annak az utolsó zárműveletnek a számát mutatja, amelyet a zár végrehajtani készült — a TapHome-ból, a Nuki alkalmazásból, a zár gombjáról, billentyűzetről vagy kulcstartós távirányítóról (fob):
| Érték | Zárművelet |
|---|---|
| 1 | nyitás |
| 2 | zárás |
| 3 | zárnyelv behúzása |
| 4 | Lock ’n’ Go |
| 5 | Lock ’n’ Go zárnyelv-behúzással |
| 6 | teljes zárás |
| 80 | kulcstartós távirányító (művelet nélkül) |
| 90 | gomb (művelet nélkül) |
Az érték szám marad, hogy smart rule-ok indítójaként használható legyen; ugyanezt a műveletet a Zár eszköz névvel mutatja az Utolsó művelet szervizattribútumában. A sikertelen billentyűzetes kódbevitelt és az engedélyezett időablakon kívüli parancsokat a zár nem jelenti.
A TapHome Core újraindítása után a sablon nem küld parancsot a zárnak — a Zár kapcsoló átveszi a zár által jelentett állapotot. A zár az állapotait megőrzött (retained) üzenetként teszi közzé, így az értékek a broker által tárolt adatokból állnak helyre; az az eszköz, amely az újraindítás után nem kap ilyen értéket, a zár következő változásakor mutatja a helyes állapotot.
Hibaelhárítás
- A zár nem csatlakozik a brokerhez: ellenőrizd a Nuki alkalmazásban, hogy a broker címe azonos hálózatban lévő privát IP-cím-e (TapHome esetén a Core IP-címe), hogy a broker fogad-e kapcsolatokat az 1883-as porton TLS nélkül, és hogy a felhasználónév és a jelszó egyezik-e a broker beállításaival. A Brokerkapcsolat szervizattribútumnak Csatlakozva értéket kell mutatnia.
- Az MQTT aktiválása sikertelen a Nuki alkalmazásban: frissítsd a zár firmware-ét, ellenőrizd, hogy a zár csatlakozik-e a hálózathoz (2,4 GHz-es Wi-Fi vagy Thread), hogy az MQTT protokollverzió 3.1.1 vagy újabb-e, és hogy a felhasználónév és a jelszó jogosult-e a brokeren. Ha az alkalmazás hibás kliensazonosítót jelez, a Nuki azt kéri, hogy vedd fel a kapcsolatot az ügyfélszolgálatával.
- Az állapotok megjelennek, de a parancsok nem csinálnak semmit: kapcsold be az Allow locking opciót a Nuki alkalmazás MQTT beállításaiban. A Parancsválasz szervizattribútum Sikeres értéket vagy a zár hibakódját mutatja. A zár egyszerre csak egy parancsot dolgoz fel; ha több parancsot küldesz párhuzamosan, a válaszok átfedhetik egymást.
- A TapHome-ban semmi sem jelenik meg: ellenőrizd a Nuki ID-t — pontosan olyan hexadecimális formában kell lennie, ahogy a Nuki alkalmazásban vagy a címkén szerepel.
- A Nuki zárállapot Nincs kalibrálva értéket mutat: fejezd be a zár kalibrálását a Nuki alkalmazásban.
- Az Ajtóérzékelő soha nem változik: a zárral Nuki Door Sensort kell párosítani; nélküle a zár nem jelent ajtóállapotot.
