Nuki Smart Lock 4 Pro è una serratura smart a batteria da installare sulla serratura esistente, con Wi-Fi integrato e Matter over Thread. Il template la collega a TapHome tramite l’interfaccia MQTT propria della serratura (Nuki MQTT API), quindi non servono né un Nuki Bridge né altri gateway. La serratura funziona come client MQTT: si connette a un broker MQTT nella rete locale, pubblica i propri stati nei topic nuki/<Nuki ID>/… e riceve i comandi di blocco negli stessi topic. Il broker può essere l’interfaccia MQTT Broker in esecuzione direttamente sul TapHome Core.
TapHome legge lo stato della serratura, lo stato del sensore porta, il livello della batteria e l’ultima azione della serratura, e invia i comandi blocco, sblocco, apertura (unlatch) e Lock ’n’ Go.
Secondo Nuki, la stessa API MQTT è disponibile su tutti i modelli Smart Lock di 4ª generazione (con o senza Pro), sullo Smart Lock 3.0 Pro (firmware 3.5.12 o superiore) e sui modelli più recenti Smart Lock Ultra, Smart Lock Pro (5ª generazione) e Smart Lock Go. Il template prende il nome dallo Smart Lock 4 Pro.
La serratura si connette solo a un broker nella rete locale (indirizzi privati 10.x.x.x, 172.16.x.x – 172.31.x.x, 192.168.x.x), sempre sulla porta 1883 e senza crittografia: TLS non è supportato. La sicurezza dei comandi dipende interamente dalla sicurezza della rete Wi-Fi o LAN. Usa l’interfaccia MQTT solo in una rete affidabile.
Connessione di rete
MQTT passa attraverso la connessione di rete della serratura, quindi la serratura deve prima trovarsi nella stessa rete del broker. Nuki supporta MQTT tramite Wi-Fi o tramite Thread (Matter).
- Wi-Fi: nell’app Nuki apri Settings → Features & Configuration → Built-in Wi-Fi → Configure Wi-Fi della serratura, seleziona la rete e inserisci la relativa password. La serratura supporta solo Wi-Fi a 2,4 GHz (802.11 b/g/n); le reti a 5 GHz non sono supportate.
- Thread: in alternativa, la serratura si collega alla rete tramite Matter over Thread, come descritto da Nuki.
Non ci sono collegamenti elettrici: la serratura funziona a batterie (4× AA o il Nuki Power Pack) e si monta meccanicamente sul lato interno della porta secondo la guida di installazione Nuki.
Configurazione
Broker MQTT
La serratura ha bisogno di un broker MQTT raggiungibile nella rete locale:
| Requisito | Valore |
|---|---|
| Indirizzo del broker | indirizzo IPv4 privato, oppure un hostname che si risolve in un indirizzo IP privato |
| Porta | 1883 (fissa, non modificabile) |
| Crittografia | nessuna (TLS non è supportato) |
| Nome utente e password | facoltativi lato broker; ciascuno al massimo 32 caratteri |
| Versione del protocollo MQTT | 3.1.1 o superiore |
I broker cloud su internet non funzionano. Con l’interfaccia MQTT Broker di TapHome, l’indirizzo del broker è l’indirizzo IP del TapHome Core. Se sul broker sono impostati nome utente e password, le stesse credenziali vanno inserite nell’app Nuki.
Attivazione di MQTT nell’app Nuki
- Nell’app Nuki tocca la serratura e apri le sue impostazioni.
- Vai su Features & Configuration → Smart Home → MQTT e segui la procedura guidata di attivazione.
- Inserisci l’hostname o l’indirizzo IPv4 del broker (con TapHome come broker, l’indirizzo IP del Core, non quello della serratura) e, se il broker li richiede, nome utente e password.
- Lascia attivo Allow locking (predefinito). Senza questa opzione la serratura non si iscrive ai topic dei comandi: TapHome ne mostra solo gli stati e non può bloccarla né sbloccarla.
- Auto discovery (discovery di Home Assistant, attivo per impostazione predefinita) non è usato da TapHome: il template legge solo i topic
nuki/<Nuki ID>/…. Puoi lasciarlo attivo o disattivarlo. - Controlla lo stato della connessione, che l’app Nuki mostra nella stessa sezione MQTT.
Nuki ID
I topic di ogni serratura contengono il suo Nuki ID in forma esadecimale, per esempio 2BB28570. È stampato sull’etichetta della serratura ed è visibile anche nell’amministrazione del dispositivo nell’app Nuki. L’ID va inserito esattamente in questa forma esadecimale.
Parametri del template
In TapHome il template si aggiunge tramite un’interfaccia Packet Parser con i seguenti parametri di importazione:
| Parametro | Cosa inserire | Esempio |
|---|---|---|
| Nuki ID (hex) | Nuki ID esadecimale della serratura, dall’app Nuki o dall’etichetta | 2BB28570 |
| Indirizzo IP del broker MQTT | indirizzo del broker per TapHome: con l’interfaccia TapHome MQTT Broker 127.0.0.1 (il Core si collega a se stesso); la serratura riceve l’indirizzo IP del Core, non quello della serratura | 127.0.0.1 |
Funzionalità del dispositivo
Serratura
L’interruttore Serratura mostra Bloccata o Sbloccata. Gli stati Nuki in sblocco, sbloccata, aperta, sbloccata (Lock ’n’ Go) e in apertura valgono tutti come Sbloccata. Durante il blocco, e quando la serratura non è calibrata o il motore è bloccato, l’interruttore mantiene l’ultimo valore.
Selezionando Bloccata viene inviata l’azione Nuki lock, selezionando Sbloccata l’azione unlock: la serratura si sblocca senza ritrarre lo scrocco. Il template invia un comando solo dopo aver ricevuto uno stato dalla serratura e solo quando il valore richiesto è diverso dallo stato attuale.
Attributi di servizio del dispositivo Serratura:
- Stato serratura Nuki — lo stato esatto, compresi In blocco, In sblocco, Aperta, In apertura, Sbloccata (Lock ’n’ Go), Non calibrata e Motore bloccato
- Batteria serratura critica e Batteria tastierino critica — se le batterie vanno sostituite
- Batteria in carica
- Connessione al broker — se la serratura è connessa al broker MQTT
- Connessione al server Nuki
- Risposta al comando — Successo, oppure il codice di errore dell’ultimo comando segnalato dalla serratura
- Ultima azione — nome dell’ultima azione della serratura, per esempio Sblocco, Blocco, Apertura (unlatch) o Lock ’n’ Go (lo stesso valore del dispositivo Ultima azione serratura, vedi sotto)
- Ultimo aggiornamento — ora dell’ultimo aggiornamento ricevuto dalla serratura, espressa nell’ora locale del TapHome Core
- Versione firmware
Il dispositivo Serratura ha anche un’azione di servizio Lock ’n’ Go.
Blocco, Apertura (Unlatch) e Lock ’n’ Go
- Blocco — pulsante: blocca la serratura (azione Nuki lock). Invia il comando a ogni pressione, indipendentemente dallo stato dell’interruttore Serratura.
- Apertura (Unlatch) — pulsante: sblocca la serratura e ritrae lo scrocco, così la porta si apre senza usare la maniglia.
- Lock ’n’ Go — pulsante: sblocca la serratura e la blocca di nuovo dopo la chiusura della porta.
Sensore porta
Il Sensore porta mostra Aperta o Chiusa quando un Nuki Door Sensor è associato alla serratura. Quando il sensore porta segnala una manomissione, il dispositivo mostra Aperta e genera un avviso. Un sensore porta disattivato viene segnalato con un messaggio informativo.
Livello batteria
Livello batteria mostra la carica delle batterie della serratura in %.
Ultima azione serratura
Ultima azione serratura mostra il numero dell’ultima azione che la serratura stava per eseguire, avviata da TapHome, dall’app Nuki, dal pulsante sulla serratura, da un tastierino o da un telecomando (fob):
| Valore | Azione della serratura |
|---|---|
| 1 | sblocco |
| 2 | blocco |
| 3 | apertura (unlatch) |
| 4 | Lock ’n’ Go |
| 5 | Lock ’n’ Go con apertura (unlatch) |
| 6 | blocco completo |
| 80 | telecomando (fob, senza azione) |
| 90 | pulsante (senza azione) |
Il valore resta numerico per poter essere usato come trigger per le smart rule; il dispositivo Serratura mostra la stessa azione per nome nell’attributo di servizio Ultima azione. I codici errati inseriti sul tastierino e i comandi fuori da una fascia oraria consentita non vengono segnalati dalla serratura.
Dopo un riavvio del TapHome Core il template non invia alcun comando alla serratura: l’interruttore Serratura assume lo stato segnalato dalla serratura. La serratura pubblica i propri stati come messaggi retained, quindi i valori vengono ripristinati da ciò che il broker conserva; un dispositivo che dopo il riavvio non riceve un tale valore mostra lo stato corretto alla successiva variazione sulla serratura.
Risoluzione dei problemi
- La serratura non si connette al broker: nell’app Nuki verifica che l’indirizzo del broker sia un indirizzo IP privato nella stessa rete (con TapHome, l’indirizzo IP del Core), che il broker accetti connessioni sulla porta 1883 senza TLS e che nome utente e password corrispondano alle impostazioni del broker. L’attributo di servizio Connessione al broker deve mostrare Connesso.
- L’attivazione di MQTT nell’app Nuki non riesce: aggiorna il firmware della serratura, verifica che la serratura sia connessa alla rete (Wi-Fi a 2,4 GHz o Thread), che la versione del protocollo MQTT sia 3.1.1 o superiore e che nome utente e password siano autorizzati sul broker. Se l’app segnala un identificativo client non valido, Nuki chiede di contattare il proprio supporto.
- Gli stati vengono mostrati, ma i comandi non hanno effetto: attiva Allow locking nelle impostazioni MQTT dell’app Nuki. L’attributo di servizio Risposta al comando mostra Successo o il codice di errore della serratura. La serratura elabora un solo comando alla volta; se vengono inviati più comandi in parallelo, le risposte possono sovrapporsi.
- In TapHome non viene mostrato nulla: controlla il Nuki ID: deve essere in forma esadecimale, esattamente come appare nell’app Nuki o sull’etichetta.
- Stato serratura Nuki mostra Non calibrata: completa la calibrazione della serratura nell’app Nuki.
- Il Sensore porta non cambia mai: alla serratura deve essere associato un Nuki Door Sensor; senza di esso la serratura non segnala lo stato della porta.
