---
title: "Xiaomi Mi Temperature and Humidity Sensor (WSDCGQ01LM) via Zigbee2MQTT"
description: "Zigbee senzor Xiaomi WSDCGQ01LM preko Zigbee2MQTT-a i MQTT-a: TapHome čita temperaturu, vlažnost, bateriju, napon i kvalitetu veze. Uz upute za uparivanje."
url: "https://taphome.com/hr/compatibility/zigbee2mqtt-xiaomi-wsdcgq01lm/"
language: hr
lastmod: 2026-11-10
generator: hugo
ai:
  topics: ["mqtt","sensor","zigbee","zigbee2mqtt","temperature-humidity","battery-powered"]
  questions: ["Kako integrirati senzor temperature i vlage Xiaomi WSDCGQ01LM sa sustavom TapHome preko Zigbee2MQTT-a?","Kako upariti Xiaomi WSDCGQ01LM s koordinatorom Zigbee2MQTT?","Što mjeri predložak TapHome za Xiaomi WSDCGQ01LM?","Koju vrijednost mora sadržavati varijabla modula Xiaomi_WSDCGQ01LM_1 u sustavu TapHome?","Zašto moj Xiaomi WSDCGQ01LM prestaje slati podatke ili napušta Zigbee mrežu?","Zašto je vlažnost senzora WSDCGQ01LM u smart rules sustava TapHome između 0 i 1?","Koja je razlika između senzora Xiaomi WSDCGQ01LM i Aqara WSDCGQ11LM?"]
---

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

Komunikacija: Packet Parser → MQTT

## Upute za integraciju

Xiaomi Mi Temperature and Humidity Sensor (model WSDCGQ01LM) mali je okrugli Zigbee senzor na bateriju za unutarnju upotrebu. Mjeri temperaturu okoline i relativnu vlažnost, a napaja ga gumbasta baterija CR2032. Zigbee2MQTT ga navodi i pod white label nazivima Xiaomi YTC4042GL, YTC4007CN i YTC4018CN. Nije riječ o četvrtastom senzoru Aqara WSDCGQ11LM, koji mjeri i tlak zraka.

TapHome sa senzorom komunicira neizravno. WSDCGQ01LM se uparuje sa Zigbee koordinatorom kojim upravlja most Zigbee2MQTT, a most očitanja objavljuje kao JSON na MQTT temama. TapHome se na te teme pretplaćuje preko modula Packet Parser MQTT i preslikava ih na jedan uređaj tipa senzor temperature s vrijednostima vlažnosti, baterije i kvalitete veze. Drugi Zigbee2MQTT senzori, na primjer [Tuya TS0201](https://taphome.com/hr/compatibility/zigbee2mqtt-ts0201-temperature-humidity/) ili [senzor pokreta Aqara RTCGQ11LM](https://taphome.com/hr/compatibility/zigbee2mqtt-xiaomi-rtcgq11lm/), postavljaju se na isti način.

## Preduvjeti

- **Zigbee koordinator**: Zigbee adapter koji podržava Zigbee2MQTT
- **Most Zigbee2MQTT**: radi na računalu uz koordinator
- **MQTT broker**: dostupan i s računala na kojem radi Zigbee2MQTT i s centralne jedinice TapHome
- **Centralna jedinica TapHome** s podrškom za Packet Parser MQTT

Sam senzor nema Wi-Fi ni Ethernet vezu. Sva IP komunikacija odvija se između MQTT brokera, mosta Zigbee2MQTT i centralne jedinice TapHome. Predložak očekuje zadanu osnovnu temu Zigbee2MQTT `zigbee2mqtt`.

## Uparivanje sa Zigbee2MQTT-om

WSDCGQ01LM mora biti uparen s koordinatorom Zigbee2MQTT prije uvoza predloška:

1. Postavite senzor blizu Zigbee koordinatora.
2. Otvorite web-sučelje Zigbee2MQTT i uključite način uparivanja (**Permit join**).
3. Pritisnite i držite tipku za resetiranje oko 5 sekundi, dok plavo svjetlo ne počne treptati. Tipka za resetiranje je mala tipka na vrhu uređaja.
4. Senzor se automatski pridružuje mreži i pojavljuje se na popisu uređaja Zigbee2MQTT sa svojom IEEE adresom. Po želji mu u postavkama uređaja dodijelite friendly name (na primjer `bedroom_climate`).

> [!NOTE]
> Nakon uparivanja može proći do 24 sata dok se pojavi postotak baterije jer ga senzor javlja samo povremeno.

### Postavljanje

Senzor je namijenjen samo za unutarnju upotrebu. Može slobodno stajati na željenom mjestu ili se, nakon uklanjanja zaštitne folije, može pričvrstiti samoljepivom naljepnicom (dodatna naljepnica nalazi se u pakiranju). Površina mora biti čista i suha. Senzor ne postavljajte na metalnu površinu.

### Opcije uređaja u Zigbee2MQTT-u

Zigbee2MQTT za ovaj senzor nudi opcije specifične za uređaj. Primjenjuju se pri sljedećem javljanju uređaja:

| Opcija | Opis |
|--------|------|
| `temperature_calibration` | Apsolutni pomak koji se dodaje vrijednosti temperature |
| `temperature_precision` | Broj decimalnih mjesta temperature (0–3, preciznost se može samo smanjiti) |
| `humidity_calibration` | Apsolutni pomak koji se dodaje vrijednosti vlažnosti |
| `humidity_precision` | Broj decimalnih mjesta vlažnosti (0–3, preciznost se može samo smanjiti) |

## Konfiguracija

### Parametri uvoza

Pri uvozu predloška unesite adresu MQTT brokera:

| Parametar | Opis | Zadano |
|-----------|------|--------|
| `Mqtt Broker ipAddress` | IP adresa MQTT brokera | `192.168.0.1` |
| `Mqtt Broker port` | TCP port MQTT brokera | `1883` |

Modul se pretplaćuje na korijensku temu `zigbee2mqtt/#`.

### Varijabla modula

Nakon uvoza postavite varijablu modula `Xiaomi_WSDCGQ01LM_1` na identitet senzora u Zigbee2MQTT-u:

| Varijabla | Opis | Kako je dobiti | Zadano u predlošku |
|-----------|------|----------------|--------------------|
| `Xiaomi_WSDCGQ01LM_1` | Zigbee2MQTT friendly name ili IEEE adresa senzora | Web-sučelje Zigbee2MQTT → Devices → WSDCGQ01LM → kopirajte friendly name ili IEEE adresu | `0x00158d0001823a01` |

> [!WARNING]
> Zadana vrijednost `0x00158d0001823a01` samo je primjer. Umjesto nje upišite friendly name ili IEEE adresu svojeg senzora, inače predložak ne prima podatke.

Listener skripta reagira samo na poruke na temi `zigbee2mqtt/` iza koje slijedi vrijednost ove varijable, pa vrijednost mora točno odgovarati nazivu u Zigbee2MQTT-u. U aplikaciji TapHome predložak se s ovim parametrima uvoza dodaje u MQTT sučelje, a varijabla se zatim uređuje u postavkama modula.

> [!TIP]
> Friendly name (na primjer `bedroom_climate`) čitljiviji je od IEEE adrese. Ako se friendly name kasnije promijeni u Zigbee2MQTT-u, treba ažurirati i varijablu u sustavu TapHome.

## Mogućnosti uređaja

Predložak stvara jedan uređaj, **Xiaomi WSDCGQ01LM**, tipa senzor temperature. Uređaj se ažurira iz JSON poruke stanja na temi `zigbee2mqtt/{Xiaomi_WSDCGQ01LM_1}`.

### Temperatura i vlažnost

Temperatura u °C čita se iz svojstva `temperature`. Relativna vlažnost čita se iz svojstva `humidity`, koje Zigbee2MQTT objavljuje u postocima. Predložak je dijeli sa 100 jer TapHome vlažnost drži na ljestvici 0–1 i prikazuje je kao postotak, pa se vrijednost `54.2` iz poruke u sustavu TapHome prikazuje kao 54,2 %.

Prema priručniku proizvođača senzor mjeri:

| Veličina | Raspon | Točnost |
|----------|--------|---------|
| Temperatura | -20 °C do 50 °C | ±0,3 °C |
| Relativna vlažnost | 10–90 % RH, bez kondenzacije | ±3 % |

### Praćenje baterije i signala

Uređaj ima tri servisna atributa koji se čitaju iz iste JSON poruke:

- **Battery**: preostali kapacitet baterije u postocima (0–100 %) iz svojstva `battery`, prikazuje se na primjer kao `95%`
- **Battery voltage**: napon baterije u milivoltima iz svojstva `voltage`, prikazuje se na primjer kao `3000mV`
- **Atribút**: kvaliteta Zigbee veze (LQI) iz svojstva `linkquality`, prikazuje se s jedinicom `lqi`; predložak ovaj atribut prikazuje pod nazivom `Atribút`

Battery i Battery voltage prikazuju `-` dok ne stigne prva poruka s tim vrijednostima. Atribut kvalitete veze počinje s vrijednošću `0lqi`.

## Tehničke specifikacije

| Parametar | Vrijednost |
|-----------|------------|
| Model | WSDCGQ01LM |
| Bežična veza | Zigbee, 2405–2480 MHz |
| Baterija | CR2032 |
| Dimenzije | 36 × 36 × 11,5 mm |

## Rješavanje problema

### Nema podataka u sustavu TapHome

1. Provjerite je li senzor na popisu uređaja Zigbee2MQTT s nedavnim vremenom „Last seen”.
2. Provjerite odgovara li varijabla `Xiaomi_WSDCGQ01LM_1` točno nazivu (friendly name) ili IEEE adresi i je li primjer `0x00158d0001823a01` zamijenjen.
3. MQTT klijentom (na primjer MQTT Explorer) pretplatite se na `zigbee2mqtt/#` i provjerite stižu li JSON poruke na `zigbee2mqtt/{friendly_name}`.
4. Provjerite jesu li IP adresa i port brokera iz parametara uvoza dostupni s centralne jedinice TapHome.

### Senzor prestaje slati poruke ili napušta mrežu

Xiaomi uređaji ne poštuju u potpunosti standard Zigbee i ponekad se odspajaju s mreže. Najčešći uzroci su:

1. **Slab signal**: kvaliteta veze ispod 20 smatra se slabom. Približite senzor koordinatoru ili Zigbee usmjerivaču s mrežnim napajanjem.
2. **Nizak napon baterije**: može se dogoditi i kad se baterija još čini punom. Pokušajte s drugom baterijom CR2032.
3. **Nekompatibilan usmjerivač**: poznato je da usmjerivači tvrtki Centralite, General Electric, Iris, Ledvance, Legrand, OSRAM, Sylvania, Securifi i nekih drugih proizvođača uzrokuju probleme s Xiaomi uređajima. Spojite senzor izravno na koordinator tako da pritisnete tipku za resetiranje dok je senzor fizički blizu koordinatora.

### Vrijednost vlažnosti u smart rules je između 0 i 1

To je očekivano. TapHome vlažnost drži na ljestvici 0–1 (0,542 = 54,2 %), a aplikacija je prikazuje u postocima. U smart rules i formulama koristite vrijednost 0–1.

## Dostupni uređaji 1

Ovi se uređaji pojavljuju u TapHomeu nakon uvoza.

Xiaomi WSDCGQ01LM Modul

Prilagođene varijable

|                                                     |
|-----------------------------------------------------|
| `Xiaomi_WSDCGQ01LM_1` (string) = 0x00158d0001823a01 |

Xiaomi WSDCGQ01LM Senzor temperature

Servisni atributi

|                 |
|-----------------|
| Battery         |
| Battery voltage |
| Atribút         |

Varijabla: `battery`, Varijabla: `voltage`, Varijabla: `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
```

Servisni atributi

Battery

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

Battery voltage

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

Atribút

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

**Povezivanje:** Packet Parser → MQTT

## Parametri uvoza

Ove vrijednosti unosite pri uvozu XML-a.

| Pitanje u aplikaciji  | Zadano        |
|-----------------------|---------------|
| Mqtt Broker IP adresa | `192.168.0.1` |
| Mqtt Broker port      | `1883`        |

## Povezana dokumentacija

- [MQTT Integration](https://taphome.com/hr/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hr/docs/integration/packet-parser/)
- [Funkcije Packet parsera](https://taphome.com/hr/docs/script/packet-parser/)
- [Funkcije za raščlambu](https://taphome.com/hr/docs/script/parsing-functions/)
- [MQTT Broker](https://taphome.com/hr/docs/integration/packet-parser/mqtt-broker/)
- [Listener skripte](https://taphome.com/hr/docs/script/listener-scripts/)