--- title: "SONOFF SNZB-02LD Waterproof Temperature Sensor with Probe" description: "Termometro Zigbee a sonda SONOFF SNZB-02LD (da -40 a 115 °C) in TapHome tramite gateway Zigbee Tasmota e MQTT: temperatura, batteria e avvisi offline." url: "https://taphome.com/it/compatibility/sonoff-snzb-02ld-zigbee2tasmota/" language: it lastmod: 2026-11-12 generator: hugo ai: topics: ["mqtt","sensor","zigbee","tasmota","battery-powered","temperature","waterproof"] questions: ["Come integrare il SONOFF SNZB-02LD con TapHome?","Cosa misura il template TapHome del SONOFF SNZB-02LD?","Come collegare un SONOFF SNZB-02LD a TapHome tramite un gateway Zigbee Tasmota?","Come associare il SONOFF SNZB-02LD a un gateway Zigbee2Tasmota?","Come trovare l'indirizzo breve Zigbee dell'SNZB-02LD in Tasmota?","Perché l'SNZB-02LD non mostra valori in TapHome?","Perché TapHome segnala l'SNZB-02LD come offline?","La sonda dell'SNZB-02LD si può usare come sensore a pavimento per il riscaldamento a pavimento?"] --- # SONOFF SNZB-02LD Waterproof Temperature Sensor with Probe Comunicazione: Packet Parser → MQTT > Indirizzo di rete > > Con il broker MQTT integrato in TapHome, inserisci `127.0.0.1` come indirizzo del broker in TapHome. Nel dispositivo inserisci l’indirizzo IP del TapHome Core e assegna al Core una prenotazione IP nel router. > > [Preparazione della rete](https://taphome.com/it/docs/setup/network-preparation/) ## Guida all'integrazione > [!IMPORTANT] > Questo dispositivo comunica tramite **Zigbee** attraverso un gateway Tasmota. Prima di importare questo template, > assicurati che il gateway sia connesso al tuo broker MQTT e che il sensore sia associato al gateway. > Il gateway stesso si aggiunge a TapHome con il template > [Zigbee2Tasmota Gateway](https://taphome.com/it/compatibility/zigbee2tasmota-gateway/). Il SONOFF SNZB-02LD è un termometro Zigbee 3.0 alimentato a batteria, con display LCD e sonda di temperatura impermeabile su un cavo da 1,5 m. TapHome non comunica direttamente con il sensore: il sensore è associato a un coordinatore Zigbee con Tasmota (Zigbee2Tasmota), il gateway pubblica ogni messaggio Zigbee su un broker MQTT e TapHome legge i valori da quel broker. Il template fornisce un dispositivo di temperatura e, sul modulo, la diagnostica della batteria e della rete Zigbee. La sonda misura liquidi o spazi chiusi, mentre il corpo con il display resta all'esterno: per esempio in un frigorifero, vicino a una piscina o come sensore a pavimento wireless per il riscaldamento a pavimento, con la sonda sotto la finitura del pavimento e il corpo sulla parete. ## Hardware ![Schema del SONOFF SNZB-02LD: sonda, icona del segnale, foro per il cordino, batteria, display della temperatura e pulsante di associazione sotto il coperchio della batteria.](https://taphome.com/images/compatibility/sonoff-snzb-02ld-zigbee2tasmota/device-overview_hu_68d5a766ee49e022.jpg) | Voce | Valore | |---|---| | Campo di misura della sonda | da -40 a 115 °C | | Precisione | ±0,5 °C | | Cavo della sonda | 1,5 m | | Protezione | IP65 | | Temperatura di esercizio del corpo | da -10 a 60 °C | | Umidità di esercizio del corpo | 0–100 %RH | | Batteria | CR2477, 3 V | | Wireless | Zigbee 3.0 (IEEE 802.15.4) | Il pulsante si trova sotto il coperchio della batteria, che si apre ruotandolo con una moneta. Prima del primo utilizzo togli la linguetta isolante della batteria: in questo modo il sensore si accende. | Pulsante / icona del segnale | Significato | |---|---| | Tieni premuto il pulsante per 5 s | Modalità di associazione, ripristina anche le impostazioni di fabbrica | | Doppia pressione | Commuta il display tra °C e °F (impostazione di fabbrica °C) | | L'icona del segnale lampeggia lentamente | Modalità di associazione, fino a 180 s | | L'icona del segnale resta accesa | Associato | | L'icona del segnale è spenta | Associazione non riuscita | ### Posizionamento - La sonda si fissa nel punto da misurare con il velcro adesivo in dotazione e copre l'intero campo da -40 a 115 °C. - Il corpo è previsto solo per temperature da -10 a 60 °C: tienilo lontano da ambienti caldi o gelati. Si fissa su una superficie metallica con il magnete o si appende con un cordino passato nel foro apposito; il produttore indica altezze di montaggio fino a 2 m. - IP65 protegge dagli spruzzi d'acqua. Non immergere il corpo e non esporlo a getti d'acqua ad alta pressione. - Per verificare il collegamento radio nella posizione definitiva, premi il pulsante: se l'icona del segnale resta accesa, il sensore è nel raggio del gateway o di un router Zigbee della stessa rete. ## Configurazione ### Gateway 1. Installa Tasmota (Zigbee2Tasmota) su un coordinatore Zigbee, per esempio un SONOFF ZBBridge Pro (ZBBridge-P). 2. Nell'interfaccia web di Tasmota apri **Configuration → MQTT** e collega il gateway al broker MQTT usato da TapHome (host e porta). 3. Annota il **Topic** nella stessa pagina, per esempio `tasmota_XXXXX`: è il parametro di importazione **Gateway topic**. 4. Mantieni `SetOption83 0` (predefinito). Il template si aspetta l'indirizzo breve Zigbee come chiave di ogni dispositivo nei messaggi `ZbReceived`; con `SetOption83 1` la chiave diventa il friendly name e il template non riceve nulla. ### Associazione del sensore 1. Abilita l'associazione sul gateway: con l'interruttore **Permit Join** del template del gateway in TapHome o con `ZbPermitJoin 1` nella console Tasmota. 2. Avvia l'associazione sul sensore: - **Sensore nuovo:** togli la linguetta isolante della batteria. Alla prima accensione il sensore entra da solo in modalità di associazione. - **Sensore già usato:** rimuovi il coperchio della batteria e tieni premuto il pulsante per 5 secondi (con uno spillo per SIM) finché l'icona del segnale lampeggia lentamente. In questo modo vengono ripristinate anche le impostazioni di fabbrica. 3. Attendi che l'icona del segnale resti accesa. Se il sensore non viene associato entro 3 minuti, esce dalla modalità di associazione: abilita di nuovo l'associazione sul gateway e ripeti il passo 2. > [!TIP] > Apri prima la finestra di associazione sul gateway, poi accendi il sensore o tieni premuto il suo pulsante. Durante l'associazione tieni il sensore vicino al gateway. ### Trovare l'indirizzo breve Dopo l'associazione osserva la console Tasmota. Ogni messaggio del sensore arriva su `tele//SENSOR` in questa forma: ```json {"ZbReceived":{"0x2916":{"Device":"0x2916","Temperature":25.72,"Endpoint":1,"LinkQuality":116}}} ``` La chiave sotto `ZbReceived` (qui `0x2916`) è l'indirizzo breve che serve al template. I dispositivi associati e i loro indirizzi brevi si possono elencare anche con `ZbStatus` o `ZbInfo` nella console Tasmota. ### Parametri di importazione | Parametro | Significato | Esempio | |---|---|---| | Mqtt Broker IP address | Indirizzo del broker MQTT su cui pubblica il gateway | `192.168.0.1` | | Mqtt Broker port | Porta del broker, predefinita 1883 | `1883` | | Gateway topic | **Configuration → MQTT → Topic** di Tasmota del gateway | `tasmota_XXXXX` | | Device short address | Chiave del sensore in `ZbReceived` | `0x2916` | In TapHome importa il template con questi quattro parametri; il modulo si iscrive quindi a `tele//#` sul broker. ## Funzionalità del dispositivo ### Temperatura della sonda Il dispositivo **Probe Temperature** mostra la temperatura misurata dalla sonda in °C. Durante l'associazione Tasmota configura il sensore in modo che invii un report a ogni variazione di 0,5 °C e almeno una volta all'ora quando la temperatura è stabile. Dopo l'importazione il template prende anche l'ultimo valore noto dalla risposta `ZbInfo` del gateway, così il dispositivo non resta vuoto fino al report successivo. ### Batteria e diagnostica Una volta all'ora il modulo chiede al gateway le informazioni sul sensore (`cmnd//ZbInfo`). Tasmota risponde dalla sua memoria, senza risvegliare il sensore. Il modulo mostra questi attributi di servizio: - **IEEE Address**, **Model ID**, **Manufacturer**, **Endpoints**, **Config** — identificazione e configurazione Zigbee del sensore. - **Link Quality** — qualità del segnale dell'ultimo messaggio, convertita dal range Zigbee 0–254 in percentuale. - **Battery Percentage** e **Battery Voltage** — ricavati dai report della batteria del sensore e dalla risposta oraria `ZbInfo`. Il modulo genera un avviso quando la batteria scende sotto il 30 %. Tiene anche traccia dell'ultima volta in cui il sensore si è fatto sentire, dai suoi messaggi e dall'orario memorizzato dal gateway, e genera un avviso dopo più di 12 ore di silenzio e un errore dopo 24 ore. Poiché il sensore invia un report almeno una volta all'ora, un silenzio così lungo indica un problema reale. ## Risoluzione dei problemi ### Nessun valore 1. Verifica che il **Gateway topic** corrisponda al Topic MQTT di Tasmota e che l'indirizzo del broker sia quello su cui pubblica il gateway. 2. Verifica che il **Device short address** corrisponda alla chiave nei messaggi `ZbReceived` di questo sensore. 3. Verifica che `SetOption83` sia 0. ### I valori si sono fermati dopo una nuova associazione L'indirizzo breve può cambiare quando il sensore viene associato di nuovo; l'indirizzo IEEE resta lo stesso. Cerca il nuovo indirizzo breve nella console Tasmota e aggiornalo nel modulo (variabile `ID`), oppure importa di nuovo il template con il nuovo indirizzo. ### La temperatura cambia lentamente È normale: per risparmiare la batteria, il sensore invia un report solo a una variazione di 0,5 °C o una volta all'ora. ### Avviso o errore offline 1. Controlla **Battery Percentage** e sostituisci la batteria CR2477 se è scarica. 2. Premi il pulsante del sensore: se l'icona del segnale non resta accesa, il sensore è fuori dalla portata del gateway o di un router Zigbee. Avvicina il gateway o aggiungi un router Zigbee. 3. Se il sensore continua a non inviare dati, associalo di nuovo e aggiorna l'indirizzo breve. ## Dispositivi disponibili 1 Questi dispositivi compaiono in TapHome dopo l'importazione. SONOFF SNZB-02LD Waterproof Temperature Sensor with Probe (Zigbee2Tasmota) Modulo Attributi di servizio | | |--------------------| | IEEE Address | | Model ID | | Manufacturer | | Endpoints | | Config | | Link Quality | | Battery Voltage | | Battery Percentage | Variabili personalizzate | | |-------------------------------| | `GWname` (string) | | `ID` (string) | | `BatteryVoltage` (numeric) | | `BatteryPercentage` (numeric) | | `LastSeenEpoch` (numeric) | Lettura (modulo) ```taphome MQTTPUBLISH("cmnd/" + GWname + "/ZbInfo", ID) ``` Listener ```taphome if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0 # Battery values arrive in their own ZbReceived message, cluster 0x0001 var ZbReceived := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID, true); if !ISNULL(ZbReceived) var bat := PARSEJSON(ZbReceived, "BatteryPercentage", true); if(!ISNULL(bat), BatteryPercentage := bat); var volt := PARSEJSON(ZbReceived, "BatteryVoltage", true); if(!ISNULL(volt), BatteryVoltage := volt); # Every message of the sensor proves it is alive, ZbInfo comes only once per hour DATETIME received := NOW(); LastSeenEpoch := received.UNIXTIME; end # ZbInfo answer to the hourly request of the module read script var deviceInfo := PARSEJSON(RECEIVEDMSG.Payload, "ZbInfo." + ID, true); if !ISNULL(deviceInfo) var seen := PARSEJSON(deviceInfo, "LastSeenEpoch", true); if(!ISNULL(seen), LastSeenEpoch := seen); var infoBat := PARSEJSON(deviceInfo, "BatteryPercentage", true); if(!ISNULL(infoBat), BatteryPercentage := infoBat); var infoVolt := PARSEJSON(deviceInfo, "BatteryVoltage", true); if(!ISNULL(infoVolt), BatteryVoltage := infoVolt); COMPLETESERVICEATTRIBUTE("IEEE Address", PARSEJSON(deviceInfo, "IEEEAddr")); COMPLETESERVICEATTRIBUTE("Model ID", PARSEJSON(deviceInfo, "ModelId")); COMPLETESERVICEATTRIBUTE("Manufacturer", PARSEJSON(deviceInfo, "Manufacturer")); COMPLETESERVICEATTRIBUTE("Endpoints", PARSEJSON(deviceInfo, "Endpoints")); COMPLETESERVICEATTRIBUTE("Config", PARSEJSON(deviceInfo, "Config")); var lqi := PARSEJSON(deviceInfo, "LinkQuality", true); if !ISNULL(lqi) COMPLETESERVICEATTRIBUTE("Link Quality", ROUND(LINEAR(lqi, 0, 0, 254, 100)) + "%"); end end end # 0 = no battery report received yet if BatteryPercentage > 0 AND BatteryPercentage < 30 ADDWARNING(1, "Low battery (<30%)"); end # The sensor reports at least once per hour; LastSeenEpoch comes from its messages and from ZbInfo if LastSeenEpoch > 0 DATETIME now := NOW(); var secondsSeen := now.UNIXTIME - LastSeenEpoch; if secondsSeen > 12 * 60 * 60 if secondsSeen > 24 * 60 * 60 ADDERROR(3, "Device is offline > 24H"); else ADDWARNING(2, "Device is offline > 12H"); end end end ``` Attributi di servizio IEEE Address ```taphome MQTTPUBLISH("cmnd/" + GWname + "/ZbInfo", ID) ``` Model ID ``` ``` Manufacturer ``` ``` Endpoints ``` ``` Config ``` ``` Link Quality ``` ``` Battery Voltage ```taphome BatteryVoltage + " V" ``` Battery Percentage ```taphome BatteryPercentage + "%" ``` Probe Temperature Sensore di temperatura Listener ```taphome if INDEXOF(RECEIVEDMSG.Topic, "SENSOR") > 0 var temp := PARSEJSON(RECEIVEDMSG.Payload, "ZbReceived." + ID + ".Temperature", true); if ISNULL(temp) # Last known value from the ZbInfo answer, e.g. right after import temp := PARSEJSON(RECEIVEDMSG.Payload, "ZbInfo." + ID + ".Temperature", true); end if(!ISNULL(temp), Te := temp); end ``` **Connessione:** Packet Parser → MQTT ## Parametri di importazione Inserisci questi valori quando importi l'XML. | Richiesto nell'app | Predefinito | |--------------------------------------------------------------------|-----------------| | Mqtt Broker Indirizzo IP | `192.168.0.1` | | Mqtt Broker port | `1883` | | Gateway topic (Tasmota -> Configuration -> MQTT -> Topic) | `tasmota_XXXXX` | | Device short address (e.g. 0x2916) | `0xFFFF` | ## Documentazione correlata - [MQTT Integration](https://taphome.com/it/compatibility/mqtt-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/it/docs/integration/packet-parser/) - [Funzioni Packet parser](https://taphome.com/it/docs/script/packet-parser/) - [Funzioni di parsing](https://taphome.com/it/docs/script/parsing-functions/) - [Broker MQTT](https://taphome.com/it/docs/integration/packet-parser/mqtt-broker/) - [Script listener](https://taphome.com/it/docs/script/listener-scripts/)