---
title: "Nuki Smart Lock 4 Pro (MQTT)"
description: "Nuki Smart Lock 4 Pro natív MQTT-n: zárás, nyitás, zárnyelv behúzása, Lock 'n' Go, ajtóérzékelő, elemszint. Helyi broker (1883-as port), pl. TapHome Core."
url: "https://taphome.com/hu/compatibility/nuki-smart-lock-4-pro-mqtt/"
language: hu
lastmod: 2026-11-13
generator: hugo
ai:
  topics: ["mqtt","smart-lock","door-lock","access-control","wifi","thread","battery-powered"]
  questions: ["Hogyan integrálható a Nuki Smart Lock 4 Pro a TapHome-mal?","Mit vezérel és mit olvas ki a Nuki Smart Lock 4 Pro TapHome sablonja?","Hogyan csatlakoztatható egy Nuki Smart Lock a TapHome-hoz MQTT-n keresztül, Nuki Bridge nélkül?","Hogyan kapcsolható be az MQTT a Nuki alkalmazásban, és milyen brokercímet kell megadni?","Hol található a zár hexadecimális Nuki ID-ja?","Miért mutatja a Nuki zár az állapotát a TapHome-ban, de nem reagál a parancsokra?","Miért nem csatlakozik a Nuki Smart Lock az MQTT brokerhez?","Mely Nuki Smart Lock modellek támogatják az MQTT API-t?"]
---

# Nuki Smart Lock 4 Pro (MQTT)

Kommunikáció: Packet Parser → MQTT

> Hálózati cím
> 
> A TapHome-ba épített MQTT bróker esetén a TapHome-ban brókercímként adja meg a `127.0.0.1` címet. Az eszközben a TapHome Core IP-címét adja meg, és a Core-nak állítson be IP-foglalást a routerben.
> 
> [A hálózat előkészítése](https://taphome.com/hu/docs/setup/network-preparation/)

## Integrációs útmutató

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.

> [!WARNING]
> 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

1. A Nuki alkalmazásban koppints a zárra, és nyisd meg a beállításait.
2. Lépj a **Features & Configuration → Smart Home → MQTT** menübe, és kövesd az aktiválási varázslót.
3. 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.
4. 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.
5. 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.
6. 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.

> [!NOTE]
> 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.

## Elérhető eszközök 7

Ezek az eszközök az importálás után jelennek meg a TapHome-ban.

Nuki Smart Lock 4 Pro Modul

Zámok Többértékű kapcsoló

Értékek / Állapotok: Zamknuté · Odomknuté

Szerviz műveletek

|             |
|-------------|
| Lock 'n' Go |

Változó: `batteryCritical`, Változó: `batteryCharging`, Változó: `keypadBatteryCritical`, Változó: `nukiConnected`, Változó: `serverConnected`, Változó: `commandResponse`, Változó: `nukiTimestamp`, Változó: `nukiFirmware`, Változó: `ready`, Változó: `lastState`, Változó: `lastAction`

Kapcsoló állapot olvasása

```taphome
RETURN(Mu);
```

Kapcsoló állapot írása

```taphome
IF(ready = 0 OR Mu = lastState)
    RETURN(0);
END
IF(Mu = 1)
    MQTTPUBLISH("nuki/$[NukiId]/lockAction", "2");
ELSEIF(Mu = 3)
    MQTTPUBLISH("nuki/$[NukiId]/lockAction", "1");
END
```

Figyelő

```taphome
IF(INDEXOF(RECEIVEDMSG.TOPIC, "nuki/$[NukiId]/") != 0)
    RETURN(0);
END
IF(RECEIVEDMSG.TOPIC = "nuki/$[NukiId]/state")
    VAR st := TODOUBLE(TOSTRING(RECEIVEDMSG.PAYLOAD));
    ready := 1;
    lastState := st;
    IF(st = 1)
        Mu := 1;
    ELSEIF(st = 2 OR st = 3 OR st = 5 OR st = 6 OR st = 7)
        Mu := 3;
    END
ELSEIF(RECEIVEDMSG.TOPIC = "nuki/$[NukiId]/batteryCritical")
    batteryCritical := TOSTRING(RECEIVEDMSG.PAYLOAD);
ELSEIF(RECEIVEDMSG.TOPIC = "nuki/$[NukiId]/batteryCharging")
    batteryCharging := TOSTRING(RECEIVEDMSG.PAYLOAD);
ELSEIF(RECEIVEDMSG.TOPIC = "nuki/$[NukiId]/keypadBatteryCritical")
    keypadBatteryCritical := TOSTRING(RECEIVEDMSG.PAYLOAD);
ELSEIF(RECEIVEDMSG.TOPIC = "nuki/$[NukiId]/connected")
    nukiConnected := TOSTRING(RECEIVEDMSG.PAYLOAD);
ELSEIF(RECEIVEDMSG.TOPIC = "nuki/$[NukiId]/serverConnected")
    serverConnected := TOSTRING(RECEIVEDMSG.PAYLOAD);
ELSEIF(RECEIVEDMSG.TOPIC = "nuki/$[NukiId]/commandResponse")
    commandResponse := TOSTRING(RECEIVEDMSG.PAYLOAD);
ELSEIF(RECEIVEDMSG.TOPIC = "nuki/$[NukiId]/timestamp")
    VAR tsUtc := DATETIME(TOSTRING(RECEIVEDMSG.PAYLOAD));
    VAR tsLocal := tsUtc.LOCALDATETIME;
    nukiTimestamp := TOSTRING(tsLocal, "d.M.yyyy HH:mm:ss");
ELSEIF(RECEIVEDMSG.TOPIC = "nuki/$[NukiId]/lockActionEvent")
    lastAction := TODOUBLE(GETAT(SPLIT(TOSTRING(RECEIVEDMSG.PAYLOAD), ","), 0));
ELSEIF(RECEIVEDMSG.TOPIC = "nuki/$[NukiId]/firmware")
    nukiFirmware := TOSTRING(RECEIVEDMSG.PAYLOAD);
END
```

Szerviz attribútumok

Stav zámku Nuki

```taphome
IF(lastState = 1, "Zamknuté", IF(lastState = 2, "Odomykanie", IF(lastState = 3, "Odomknuté", IF(lastState = 4, "Zamykanie", IF(lastState = 5, "Odblokované", IF(lastState = 6, "Odomknuté (Lock 'n' Go)", IF(lastState = 7, "Odblokovanie", IF(lastState = 0, "Nekalibrovaný", IF(lastState = 254, "Motor zablokovaný", "Neznámy (" + TOSTRING(lastState) + ")")))))))))
```

Krit. batéria zámku

```taphome
IF(batteryCritical = "true", "Áno — vymeniť batérie", "Nie")
```

Nabíjanie batérie

```taphome
IF(batteryCharging = "true", "Prebieha", "Neprebieha")
```

Krit. batéria klávesnice

```taphome
IF(keypadBatteryCritical = "true", "Áno — vymeniť batérie", "Nie")
```

Pripojenie k brokeru

```taphome
IF(nukiConnected = "true", "Pripojený", "Odpojený")
```

Pripojenie k serveru Nuki

```taphome
IF(serverConnected = "true", "Pripojený", "Odpojený")
```

Odozva na príkaz

```taphome
IF(commandResponse = "0", "Úspech", IF(LENGTH(commandResponse) = 0, "—", "Chyba zámku: " + commandResponse))
```

Posledná akcia

```taphome
IF(lastAction = 1, "Odomknutie", IF(lastAction = 2, "Zamknutie", IF(lastAction = 3, "Odblokovanie", IF(lastAction = 4, "Lock 'n' Go", IF(lastAction = 5, "Lock 'n' Go s odblokovaním", IF(lastAction = 6, "Úplné zamknutie", IF(lastAction = 80, "Kľúčenka (bez akcie)", IF(lastAction = 90, "Tlačidlo (bez akcie)", IF(lastAction = -1, "—", "Neznáma (" + TOSTRING(lastAction) + ")")))))))))
```

Posledná aktualizácia

```taphome
IF(LENGTH(nukiTimestamp) = 0, "—", nukiTimestamp)
```

Verzia firmvéru

```taphome
IF(LENGTH(nukiFirmware) = 0, "—", nukiFirmware)
```

Szerviz műveletek

Lock 'n' Go

```taphome
MQTTPUBLISH("nuki/$[NukiId]/lockAction", "4");
```

Dverový senzor Reed kontaktus

Olvasás

```taphome
RETURN(Rc);
```

Figyelő

```taphome
IF(RECEIVEDMSG.TOPIC = "nuki/$[NukiId]/doorsensorState")
    VAR dsVal := TODOUBLE(TOSTRING(RECEIVEDMSG.PAYLOAD));
    IF(dsVal = 3)
        Rc := 1;
    ELSEIF(dsVal = 2)
        Rc := 0;
    ELSEIF(dsVal = 240)
        Rc := 1;
        ADDWARNING(0, "Dverový senzor: detekovaná manipulácia (tamper)");
    ELSEIF(dsVal = 1)
        ADDINFO(0, "Dverový senzor deaktivovaný");
    END
END
```

Odblokovanie (Unlatch) Nyomógomb

Gombállapot olvasása

```taphome
Bp := 0;
```

Gombállapot írása

```taphome
MQTTPUBLISH("nuki/$[NukiId]/lockAction", "3");
```

Lock 'n' Go Nyomógomb

Gombállapot olvasása

```taphome
Bp := 0;
```

Gombállapot írása

```taphome
MQTTPUBLISH("nuki/$[NukiId]/lockAction", "4");
```

Úroveň batérie Analóg bemenet

Bemeneti szint olvasása

```taphome
RETURN(An);
```

Figyelő

```taphome
IF(RECEIVEDMSG.TOPIC = "nuki/$[NukiId]/batteryChargeState")
    An := TODOUBLE(TOSTRING(RECEIVEDMSG.PAYLOAD)) / 100;
END
```

Posledná akcia zámku Változó

Olvasás

```taphome
RETURN(Va);
```

Figyelő

```taphome
IF(RECEIVEDMSG.TOPIC = "nuki/$[NukiId]/lockActionEvent")
    Va := TODOUBLE(GETAT(SPLIT(TOSTRING(RECEIVEDMSG.PAYLOAD), ","), 0));
END
```

Zamknúť Nyomógomb

Gombállapot olvasása

```taphome
Bp := 0;
```

Gombállapot írása

```taphome
MQTTPUBLISH("nuki/$[NukiId]/lockAction", "2");
```

**Kapcsolat:** Packet Parser → MQTT

## Importálási paraméterek

Ezeket az értékeket az XML importálásakor adja meg.

| Az alkalmazás kéri            | Alapérték     |
|-------------------------------|---------------|
| Nuki ID (hex, napr. 2BB28570) | `2BB28570`    |
| IP adresa MQTT brokera        | `192.168.1.1` |

## Kapcsolódó dokumentáció

- [MQTT Integration](https://taphome.com/hu/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hu/docs/integration/packet-parser/)
- [Packet parser függvények](https://taphome.com/hu/docs/script/packet-parser/)
- [Elemző függvények](https://taphome.com/hu/docs/script/parsing-functions/)
- [MQTT bróker](https://taphome.com/hu/docs/integration/packet-parser/mqtt-broker/)
- [Listener szkriptek](https://taphome.com/hu/docs/script/listener-scripts/)