TapHome
Italiano
Slovenčina Čeština Magyar

Italiano

Polski Deutsch Română Hrvatski English
Ufficiale · TapHome

Xiaomi Mi Temperature and Humidity Sensor (WSDCGQ01LM) via Zigbee2MQTT

Sensore Zigbee rotondo di temperatura e umidità Xiaomi WSDCGQ01LM (CR2032) in TapHome via MQTT tramite un bridge Zigbee2MQTT. Rileva temperatura, umidità relativa, livello e tensione della batteria e qualità del collegamento Zigbee. Si abbina in Zigbee2MQTT con Permit join e il pulsante di reset.

Zigbee2MQTTPacket Parser → MQTT1 dispositivoRevisione 1.0 Ultimo aggiornamento: 10 novembre 2026

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

Scarica template
In questa pagina

Guida all'integrazione

Xiaomi Mi Temperature and Humidity Sensor (modello WSDCGQ01LM) è un piccolo sensore Zigbee rotondo, alimentato a batteria e destinato all’uso interno. Misura la temperatura ambiente e l’umidità relativa e funziona con una pila a bottone CR2032. Zigbee2MQTT lo elenca anche con i nomi white label Xiaomi YTC4042GL, YTC4007CN e YTC4018CN. Non è il sensore quadrato Aqara WSDCGQ11LM, che misura anche la pressione atmosferica.

TapHome comunica con il sensore in modo indiretto. Il WSDCGQ01LM si abbina a un coordinatore Zigbee gestito da un bridge Zigbee2MQTT, che pubblica le letture in formato JSON sui topic MQTT. TapHome si sottoscrive a questi topic tramite un modulo Packet Parser MQTT e le mappa su un unico dispositivo di tipo sensore di temperatura, con i valori di umidità, batteria e qualità del collegamento. Altri sensori Zigbee2MQTT, per esempio il Tuya TS0201 o il sensore di movimento Aqara RTCGQ11LM, si configurano allo stesso modo.

Requisiti

  • Coordinatore Zigbee — un adattatore Zigbee supportato da Zigbee2MQTT
  • Bridge Zigbee2MQTT — in esecuzione su un host accanto al coordinatore
  • Broker MQTT — raggiungibile sia dall’host Zigbee2MQTT sia dall’unità di controllo TapHome
  • Unità di controllo TapHome con supporto Packet Parser MQTT

Il sensore non ha una connessione Wi-Fi né Ethernet. Tutta la comunicazione IP avviene tra il broker MQTT, Zigbee2MQTT e l’unità di controllo TapHome. Il template si aspetta il topic di base predefinito di Zigbee2MQTT zigbee2mqtt.

Abbinamento con Zigbee2MQTT

Prima di importare il template, il WSDCGQ01LM deve essere abbinato al coordinatore Zigbee2MQTT:

  1. Avvicina il sensore al coordinatore Zigbee.
  2. Apri l’interfaccia web di Zigbee2MQTT e attiva la modalità di abbinamento (Permit join).
  3. Tieni premuto il pulsante di reset per circa 5 secondi, finché la luce blu non inizia a lampeggiare. Il pulsante di reset è il piccolo pulsante sulla parte superiore del dispositivo.
  4. Il sensore si unisce automaticamente alla rete e compare nell’elenco dei dispositivi di Zigbee2MQTT con il suo indirizzo IEEE. Se vuoi, assegnagli un friendly name (per esempio bedroom_climate) nelle impostazioni del dispositivo.

Dopo l’abbinamento possono passare fino a 24 ore prima che compaia la percentuale della batteria: il sensore la invia solo periodicamente.

Posizionamento

Il sensore è destinato solo all’uso interno. Può essere appoggiato liberamente nel punto desiderato oppure fissato con l’adesivo, dopo aver rimosso la pellicola protettiva (nella confezione è incluso un adesivo di ricambio). La superficie deve essere pulita e asciutta. Non montare il sensore su una superficie metallica.

Opzioni del dispositivo in Zigbee2MQTT

Zigbee2MQTT offre per questo sensore opzioni specifiche del dispositivo. Diventano effettive con il successivo invio di dati dal dispositivo:

OpzioneDescrizione
temperature_calibrationOffset assoluto aggiunto al valore di temperatura
temperature_precisionNumero di cifre decimali della temperatura (0–3, la precisione può solo diminuire)
humidity_calibrationOffset assoluto aggiunto al valore di umidità
humidity_precisionNumero di cifre decimali dell’umidità (0–3, la precisione può solo diminuire)

Configurazione

Parametri di importazione

Durante l’importazione del template, inserisci l’indirizzo del broker MQTT:

ParametroDescrizioneValore predefinito
Mqtt Broker ipAddressIndirizzo IP del broker MQTT192.168.0.1
Mqtt Broker portPorta TCP del broker MQTT1883

Il modulo si sottoscrive al topic radice zigbee2mqtt/#.

Variabile del modulo

Dopo l’importazione, imposta la variabile del modulo Xiaomi_WSDCGQ01LM_1 sull’identità del sensore in Zigbee2MQTT:

VariabileDescrizioneCome ottenerlaValore predefinito nel template
Xiaomi_WSDCGQ01LM_1Friendly name Zigbee2MQTT o indirizzo IEEE del sensoreInterfaccia web di Zigbee2MQTT → Devices → WSDCGQ01LM → copia il friendly name o l’indirizzo IEEE0x00158d0001823a01

Il valore predefinito 0x00158d0001823a01 è solo un esempio. Sostituiscilo con il friendly name o l’indirizzo IEEE del tuo sensore, altrimenti il template non riceve alcun dato.

Lo script listener reagisce solo ai messaggi sul topic zigbee2mqtt/ seguito dal valore di questa variabile, quindi il valore deve corrispondere esattamente al nome in Zigbee2MQTT. Nell’app TapHome il template si aggiunge all’interfaccia MQTT con questi parametri di importazione; la variabile si modifica poi nelle impostazioni del modulo.

Un friendly name (per esempio bedroom_climate) è più leggibile dell’indirizzo IEEE. Se in seguito cambi il friendly name in Zigbee2MQTT, devi aggiornare anche la variabile in TapHome.

Funzionalità del dispositivo

Il template crea un unico dispositivo, Xiaomi WSDCGQ01LM, di tipo sensore di temperatura. Il dispositivo si aggiorna dal messaggio di stato JSON su zigbee2mqtt/{Xiaomi_WSDCGQ01LM_1}.

Temperatura e umidità

La temperatura in °C si legge dalla proprietà temperature. L’umidità relativa si legge dalla proprietà humidity, che Zigbee2MQTT pubblica in percentuale. Il template la divide per 100 perché TapHome gestisce l’umidità su una scala 0–1 e la mostra in percentuale: un payload 54.2 compare quindi in TapHome come 54,2 %.

Secondo il manuale del produttore, il sensore misura:

GrandezzaCampo di misuraPrecisione
Temperaturada -20 °C a 50 °C±0,3 °C
Umidità relativa10–90 % RH, senza condensa±3 %

Monitoraggio della batteria e del segnale

Il dispositivo ha tre attributi di servizio, letti dallo stesso messaggio JSON:

  • Battery — carica residua della batteria in percentuale (0–100 %) dalla proprietà battery, mostrata per esempio come 95%
  • Battery voltage — tensione della batteria in millivolt dalla proprietà voltage, mostrata per esempio come 3000mV
  • Atribút — qualità del collegamento Zigbee (LQI) dalla proprietà linkquality, mostrata con l’unità lqi; il template visualizza questo attributo con il nome Atribút

Battery e Battery voltage mostrano - finché non arriva il primo messaggio con questi valori. L’attributo della qualità del collegamento parte da 0lqi.

Specifiche tecniche

ParametroValore
ModelloWSDCGQ01LM
Connettività wirelessZigbee, 2405–2480 MHz
BatteriaCR2032
Dimensioni36 × 36 × 11,5 mm

Risoluzione dei problemi

Nessun dato in TapHome

  1. Verifica che il sensore compaia nell’elenco dei dispositivi di Zigbee2MQTT con un orario “Last seen” recente.
  2. Verifica che la variabile Xiaomi_WSDCGQ01LM_1 corrisponda esattamente al friendly name o all’indirizzo IEEE e che il valore di esempio 0x00158d0001823a01 sia stato sostituito.
  3. Sottoscriviti a zigbee2mqtt/# con un client MQTT (per esempio MQTT Explorer) e verifica che i messaggi JSON arrivino su zigbee2mqtt/{friendly_name}.
  4. Verifica che l’indirizzo IP e la porta del broker indicati nei parametri di importazione siano raggiungibili dall’unità di controllo TapHome.

Il sensore smette di inviare messaggi o esce dalla rete

I dispositivi Xiaomi non rispettano del tutto lo standard Zigbee e a volte si disconnettono dalla rete. Le cause più comuni sono:

  1. Segnale debole — una qualità del collegamento inferiore a 20 è considerata debole. Avvicina il sensore al coordinatore o a un router Zigbee alimentato dalla rete elettrica.
  2. Tensione della batteria bassa — può succedere anche quando la batteria sembra ancora carica. Prova con un’altra batteria CR2032.
  3. Router incompatibile — i router di Centralite, General Electric, Iris, Ledvance, Legrand, OSRAM, Sylvania, Securifi e di alcuni altri produttori causano notoriamente problemi con i dispositivi Xiaomi. Collega il sensore direttamente al coordinatore premendo il pulsante di reset mentre il sensore si trova fisicamente vicino al coordinatore.

Il valore di umidità nelle smart rule è compreso tra 0 e 1

È il comportamento previsto. TapHome gestisce l’umidità su una scala 0–1 (0,542 = 54,2 %) e l’app la mostra in percentuale. Nelle smart rule e nelle formule usa il valore 0–1.

Dispositivi disponibili 1

Questi dispositivi compaiono in TapHome dopo l'importazione.

Xiaomi WSDCGQ01LM Modulo
Variabili personalizzate
Xiaomi_WSDCGQ01LM_1 (string) = 0x00158d0001823a01
Xiaomi WSDCGQ01LM Sensore di temperatura
Attributi di servizio
Battery
Battery voltage
Atribút
Variabile: battery, Variabile: voltage, Variabile: link

Xiaomi WSDCGQ01LM

Listener
if RECEIVEDMSG.TOPIC = "zigbee2mqtt/"+ Xiaomi_WSDCGQ01LM_1 
   VAR payloadTemp := PARSEJSON(RECEIVEDMSG.PAYLOAD, "temperature");
   Te := payloadTemp;
   VAR payloadHum := PARSEJSON(RECEIVEDMSG.PAYLOAD, "humidity");
   Hu := payloadHum/100;
   battery := PARSEJSON(RECEIVEDMSG.PAYLOAD,"battery", true);
   voltage := PARSEJSON(RECEIVEDMSG.PAYLOAD,"voltage", true);
   link := PARSEJSON(RECEIVEDMSG.PAYLOAD,"linkquality", true);
end
Attributi di servizio
Battery
IF (ISNAN(battery), "-", battery + "%");
Battery voltage
IF (ISNAN(voltage), "-", voltage + "mV");
Atribút
IF (ISNAN(link), "-", link + "lqi");
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

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 Xiaomi Mi Temperature and Humidity Sensor (WSDCGQ01LM) via Zigbee2MQTT 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