TapHome
Italiano
Slovenčina Čeština Magyar

Italiano

Polski Deutsch Română Hrvatski English
Community Verificato Sensori

SONOFF SNZB-02LD Waterproof Temperature Sensor with Probe

Termometro Zigbee 3.0 SONOFF SNZB-02LD alimentato a batteria, con sonda impermeabile su cavo da 1,5 m (da -40 a 115 °C), collegato a TapHome via MQTT tramite un gateway Zigbee Tasmota (Zigbee2Tasmota). TapHome mostra la temperatura della sonda, il livello della batteria e la qualità del collegamento, e avvisa in caso di batteria scarica o di sensore che ha smesso di inviare dati.

SONOFFPacket Parser → MQTT1 dispositivoRevisione 1.0 Ultimo aggiornamento: 12 novembre 2026

Inviato da Bart Klopstra

SONOFF SNZB-02LD Waterproof Temperature Sensor with Probe

Importa nell'app TapHomeHardware › Packet Parser › Aggiungi da modello

Scarica template
In questa pagina

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

Guida all'integrazione

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.

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.
VoceValore
Campo di misura della sondada -40 a 115 °C
Precisione±0,5 °C
Cavo della sonda1,5 m
ProtezioneIP65
Temperatura di esercizio del corpoda -10 a 60 °C
Umidità di esercizio del corpo0–100 %RH
BatteriaCR2477, 3 V
WirelessZigbee 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 segnaleSignificato
Tieni premuto il pulsante per 5 sModalità di associazione, ripristina anche le impostazioni di fabbrica
Doppia pressioneCommuta il display tra °C e °F (impostazione di fabbrica °C)
L’icona del segnale lampeggia lentamenteModalità di associazione, fino a 180 s
L’icona del segnale resta accesaAssociato
L’icona del segnale è spentaAssociazione 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.

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/<gateway topic>/SENSOR in questa forma:

1

{"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

ParametroSignificatoEsempio
Mqtt Broker IP addressIndirizzo del broker MQTT su cui pubblica il gateway192.168.0.1
Mqtt Broker portPorta del broker, predefinita 18831883
Gateway topicConfiguration → MQTT → Topic di Tasmota del gatewaytasmota_XXXXX
Device short addressChiave del sensore in ZbReceived0x2916

In TapHome importa il template con questi quattro parametri; il modulo si iscrive quindi a tele/<gateway topic>/# 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/<gateway topic>/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)

SONOFF SNZB-02LD Waterproof Temperature Sensor with Probe (Zigbee2Tasmota)

Lettura (modulo)
MQTTPUBLISH("cmnd/" + GWname + "/ZbInfo", ID)
Listener
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
MQTTPUBLISH("cmnd/" + GWname + "/ZbInfo", ID)
Model ID
Manufacturer
Endpoints
Config
Link Quality
Battery Voltage
BatteryVoltage + " V"
Battery Percentage
BatteryPercentage + "%"
Probe Temperature Sensore di temperatura

Probe Temperature

Listener
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'appPredefinito
Mqtt Broker Indirizzo IP192.168.0.1
Mqtt Broker port1883
Gateway topic (Tasmota -> Configuration -> MQTT -> Topic)tasmota_XXXXX
Device short address (e.g. 0x2916)0xFFFF

Documentazione correlata

Hai trovato un problema con questo template?

Dicci cosa non funziona, cosa manca o come dovrebbe comportarsi il template. Il tuo feedback ci aiuta a mantenere il catalogo accurato.

Modello · portale TapHome SONOFF SNZB-02LD Waterproof Temperature Sensor with Probe Apri questo template nel Customer Portal per applicarlo a una delle tue case, o crea una proposta di modifica e inviala al catalogo. Packet Parser → MQTT Vedi nel portale TapHome