---
title: "Xiaomi Mi Temperature and Humidity Sensor (WSDCGQ01LM) via Zigbee2MQTT"
description: "Sensore Zigbee Xiaomi WSDCGQ01LM via Zigbee2MQTT e MQTT: TapHome legge temperatura, umidità, batteria, tensione e qualità del segnale. Con abbinamento."
url: "https://taphome.com/it/compatibility/zigbee2mqtt-xiaomi-wsdcgq01lm/"
language: it
lastmod: 2026-11-10
generator: hugo
ai:
  topics: ["mqtt","sensor","zigbee","zigbee2mqtt","temperature-humidity","battery-powered"]
  questions: ["Come integrare il sensore di temperatura e umidità Xiaomi WSDCGQ01LM con TapHome tramite Zigbee2MQTT?","Come abbinare lo Xiaomi WSDCGQ01LM a un coordinatore Zigbee2MQTT?","Cosa misura il template TapHome dello Xiaomi WSDCGQ01LM?","Quale valore deve contenere la variabile del modulo Xiaomi_WSDCGQ01LM_1 in TapHome?","Perché il mio Xiaomi WSDCGQ01LM smette di inviare dati o esce dalla rete Zigbee?","Perché l'umidità del WSDCGQ01LM è compresa tra 0 e 1 nelle smart rule di TapHome?","Qual è la differenza tra lo Xiaomi WSDCGQ01LM e l'Aqara WSDCGQ11LM?"]
---

# Xiaomi Mi Temperature and Humidity Sensor (WSDCGQ01LM) via Zigbee2MQTT

Comunicazione: Packet Parser → MQTT

## 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](https://taphome.com/it/compatibility/zigbee2mqtt-ts0201-temperature-humidity/) o il [sensore di movimento Aqara RTCGQ11LM](https://taphome.com/it/compatibility/zigbee2mqtt-xiaomi-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.

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

| Opzione | Descrizione |
|---------|-------------|
| `temperature_calibration` | Offset assoluto aggiunto al valore di temperatura |
| `temperature_precision` | Numero di cifre decimali della temperatura (0–3, la precisione può solo diminuire) |
| `humidity_calibration` | Offset assoluto aggiunto al valore di umidità |
| `humidity_precision` | Numero 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:

| Parametro | Descrizione | Valore predefinito |
|-----------|-------------|--------------------|
| `Mqtt Broker ipAddress` | Indirizzo IP del broker MQTT | `192.168.0.1` |
| `Mqtt Broker port` | Porta TCP del broker MQTT | `1883` |

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:

| Variabile | Descrizione | Come ottenerla | Valore predefinito nel template |
|-----------|-------------|----------------|---------------------------------|
| `Xiaomi_WSDCGQ01LM_1` | Friendly name Zigbee2MQTT o indirizzo IEEE del sensore | Interfaccia web di Zigbee2MQTT → Devices → WSDCGQ01LM → copia il friendly name o l'indirizzo IEEE | `0x00158d0001823a01` |

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

> [!TIP]
> 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:

| Grandezza | Campo di misura | Precisione |
|-----------|-----------------|------------|
| Temperatura | da -20 °C a 50 °C | ±0,3 °C |
| Umidità relativa | 10–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

| Parametro | Valore |
|-----------|--------|
| Modello | WSDCGQ01LM |
| Connettività wireless | Zigbee, 2405–2480 MHz |
| Batteria | CR2032 |
| Dimensioni | 36 × 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`

Listener

```taphome
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

```taphome
IF (ISNAN(battery), "-", battery + "%");
```

Battery voltage

```taphome
IF (ISNAN(voltage), "-", voltage + "mV");
```

Atribút

```taphome
IF (ISNAN(link), "-", link + "lqi");
```

**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`        |

## 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/)