---
title: "Xiaomi Mi Temperature and Humidity Sensor (WSDCGQ01LM) via Zigbee2MQTT"
description: "Xiaomi WSDCGQ01LM przez Zigbee2MQTT i MQTT: TapHome odczytuje temperaturę, wilgotność, baterię, napięcie i jakość połączenia. Z instrukcją parowania."
url: "https://taphome.com/pl/compatibility/zigbee2mqtt-xiaomi-wsdcgq01lm/"
language: pl
lastmod: 2026-11-10
generator: hugo
ai:
  topics: ["mqtt","sensor","zigbee","zigbee2mqtt","temperature-humidity","battery-powered"]
  questions: ["Jak zintegrować czujnik temperatury i wilgotności Xiaomi WSDCGQ01LM z TapHome przez Zigbee2MQTT?","Jak sparować Xiaomi WSDCGQ01LM z koordynatorem Zigbee2MQTT?","Co mierzy szablon TapHome dla Xiaomi WSDCGQ01LM?","Jaką wartość musi zawierać zmienna modułu Xiaomi_WSDCGQ01LM_1 w TapHome?","Dlaczego mój Xiaomi WSDCGQ01LM przestaje wysyłać dane lub opuszcza sieć Zigbee?","Dlaczego wilgotność WSDCGQ01LM w smart rules TapHome mieści się w zakresie od 0 do 1?","Czym różni się Xiaomi WSDCGQ01LM od Aqara WSDCGQ11LM?"]
---

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

Komunikacja: Packet Parser → MQTT

## Poradnik integracji

Xiaomi Mi Temperature and Humidity Sensor (model WSDCGQ01LM) to mały, okrągły czujnik Zigbee zasilany z baterii, przeznaczony do wnętrz. Mierzy temperaturę otoczenia i wilgotność względną, a zasila go bateria guzikowa CR2032. Zigbee2MQTT wymienia go także pod nazwami white label Xiaomi YTC4042GL, YTC4007CN i YTC4018CN. Nie jest to kwadratowy Aqara WSDCGQ11LM, który mierzy także ciśnienie powietrza.

TapHome komunikuje się z czujnikiem pośrednio. WSDCGQ01LM paruje się z koordynatorem Zigbee zarządzanym przez bramkę Zigbee2MQTT, która publikuje odczyty jako JSON na topikach MQTT. TapHome subskrybuje te topiki przez moduł Packet Parser MQTT i mapuje je na jedno urządzenie typu czujnik temperatury z wartościami wilgotności, baterii i jakości połączenia. Inne czujniki Zigbee2MQTT, na przykład [Tuya TS0201](https://taphome.com/pl/compatibility/zigbee2mqtt-ts0201-temperature-humidity/) lub [czujnik ruchu Aqara RTCGQ11LM](https://taphome.com/pl/compatibility/zigbee2mqtt-xiaomi-rtcgq11lm/), konfiguruje się w ten sam sposób.

## Wymagania

- **Koordynator Zigbee** — adapter Zigbee obsługiwany przez Zigbee2MQTT
- **Bramka Zigbee2MQTT** — uruchomiona na hoście obok koordynatora
- **Broker MQTT** — osiągalny zarówno z hosta Zigbee2MQTT, jak i z jednostki sterującej TapHome
- **Jednostka sterująca TapHome** z obsługą Packet Parser MQTT

Sam czujnik nie ma połączenia Wi-Fi ani Ethernet. Cała komunikacja IP odbywa się między brokerem MQTT, Zigbee2MQTT i jednostką sterującą TapHome. Szablon oczekuje domyślnego topiku bazowego Zigbee2MQTT, `zigbee2mqtt`.

## Parowanie z Zigbee2MQTT

Przed importem szablonu WSDCGQ01LM musi zostać sparowany z koordynatorem Zigbee2MQTT:

1. Umieść czujnik blisko koordynatora Zigbee.
2. Otwórz interfejs webowy Zigbee2MQTT i włącz tryb parowania (**Permit join**).
3. Naciśnij i przytrzymaj przycisk reset przez około 5 sekund, aż niebieska dioda zacznie migać. Przycisk reset to mały przycisk na górze urządzenia.
4. Czujnik dołącza automatycznie i pojawia się na liście urządzeń Zigbee2MQTT ze swoim adresem IEEE. Opcjonalnie przypisz mu w ustawieniach urządzenia friendly name (na przykład `bedroom_climate`).

> [!NOTE]
> Procent naładowania baterii może pojawić się nawet do 24 godzin po sparowaniu — czujnik raportuje go tylko okresowo.

### Umiejscowienie

Czujnik jest przeznaczony wyłącznie do użytku wewnątrz pomieszczeń. Może stać swobodnie w wybranym miejscu albo zostać przyklejony naklejką samoprzylepną po zdjęciu folii ochronnej (w opakowaniu znajduje się dodatkowa naklejka). Powierzchnia musi być czysta i sucha. Nie montuj czujnika na metalowej powierzchni.

### Opcje urządzenia w Zigbee2MQTT

Zigbee2MQTT oferuje dla tego czujnika opcje specyficzne dla urządzenia. Zaczynają działać przy następnym raporcie z urządzenia:

| Opcja | Opis |
|--------|-------------|
| `temperature_calibration` | Bezwzględne przesunięcie dodawane do wartości temperatury |
| `temperature_precision` | Liczba miejsc dziesiętnych temperatury (0–3, może tylko zmniejszyć precyzję) |
| `humidity_calibration` | Bezwzględne przesunięcie dodawane do wartości wilgotności |
| `humidity_precision` | Liczba miejsc dziesiętnych wilgotności (0–3, może tylko zmniejszyć precyzję) |

## Konfiguracja

### Parametry importu

Podczas importu szablonu wpisz adres brokera MQTT:

| Parametr | Opis | Wartość domyślna |
|-----------|-------------|---------|
| `Mqtt Broker ipAddress` | Adres IP brokera MQTT | `192.168.0.1` |
| `Mqtt Broker port` | Port TCP brokera MQTT | `1883` |

Moduł subskrybuje topik główny `zigbee2mqtt/#`.

### Zmienna modułu

Po imporcie ustaw zmienną modułu `Xiaomi_WSDCGQ01LM_1` na identyfikator czujnika w Zigbee2MQTT:

| Zmienna | Opis | Jak uzyskać | Wartość domyślna w szablonie |
|----------|-------------|---------------|-------------------------|
| `Xiaomi_WSDCGQ01LM_1` | Friendly name Zigbee2MQTT lub adres IEEE czujnika | Interfejs webowy Zigbee2MQTT → Devices → WSDCGQ01LM → skopiuj friendly name lub adres IEEE | `0x00158d0001823a01` |

> [!WARNING]
> Wartość domyślna `0x00158d0001823a01` jest tylko przykładem. Zastąp ją friendly name lub adresem IEEE swojego czujnika, w przeciwnym razie szablon nie otrzyma żadnych danych.

Skrypt listener reaguje tylko na wiadomości na topiku `zigbee2mqtt/`, po którym następuje wartość tej zmiennej, dlatego wartość musi dokładnie odpowiadać nazwie w Zigbee2MQTT. W aplikacji TapHome szablon dodaje się do interfejsu MQTT z tymi parametrami importu, a zmienną edytuje się następnie w ustawieniach modułu.

> [!TIP]
> Friendly name (na przykład `bedroom_climate`) jest czytelniejszy niż adres IEEE. Jeśli później zmienisz friendly name w Zigbee2MQTT, musisz zaktualizować także zmienną w TapHome.

## Możliwości urządzenia

Szablon tworzy jedno urządzenie, **Xiaomi WSDCGQ01LM**, typu czujnik temperatury. Jest ono aktualizowane na podstawie wiadomości stanu JSON na `zigbee2mqtt/{Xiaomi_WSDCGQ01LM_1}`.

### Temperatura i wilgotność

Temperatura w °C jest odczytywana z właściwości `temperature`. Wilgotność względna jest odczytywana z właściwości `humidity`, którą Zigbee2MQTT publikuje w procentach. Szablon dzieli ją przez 100, ponieważ TapHome przechowuje wilgotność w skali 0–1 i wyświetla ją w procentach, więc payload `54.2` pojawia się w TapHome jako 54,2 %.

Według instrukcji producenta czujnik mierzy:

| Wielkość | Zakres | Dokładność |
|----------|-------|----------|
| Temperatura | od -20 °C do 50 °C | ±0,3 °C |
| Wilgotność względna | 10–90 % RH, bez kondensacji | ±3 % |

### Monitorowanie baterii i sygnału

Urządzenie ma trzy atrybuty serwisowe odczytywane z tej samej wiadomości JSON:

- **Battery** — pozostały poziom baterii w procentach (0–100 %) z właściwości `battery`, wyświetlany na przykład jako `95%`
- **Battery voltage** — napięcie baterii w miliwoltach z właściwości `voltage`, wyświetlane na przykład jako `3000mV`
- **Atribút** — jakość połączenia Zigbee (LQI) z właściwości `linkquality`, wyświetlana z jednostką `lqi`; szablon wyświetla ten atrybut pod nazwą `Atribút`

Battery i Battery voltage pokazują `-`, dopóki nie dotrze pierwsza wiadomość z tymi wartościami. Atrybut jakości połączenia startuje od `0lqi`.

## Dane techniczne

| Parametr | Wartość |
|-----------|-------|
| Model | WSDCGQ01LM |
| Łączność bezprzewodowa | Zigbee, 2405–2480 MHz |
| Bateria | CR2032 |
| Wymiary | 36 × 36 × 11,5 mm |

## Rozwiązywanie problemów

### Brak danych w TapHome

1. Sprawdź, czy czujnik pojawia się na liście urządzeń Zigbee2MQTT z niedawnym czasem „Last seen”.
2. Sprawdź, czy zmienna `Xiaomi_WSDCGQ01LM_1` dokładnie odpowiada friendly name lub adresowi IEEE i czy przykładowa wartość `0x00158d0001823a01` została zastąpiona.
3. Zasubskrybuj `zigbee2mqtt/#` klientem MQTT (na przykład MQTT Explorer) i potwierdź, że wiadomości JSON przychodzą na `zigbee2mqtt/{friendly_name}`.
4. Sprawdź, czy adres IP i port brokera z parametrów importu są osiągalne z jednostki sterującej TapHome.

### Czujnik przestaje wysyłać wiadomości lub opuszcza sieć

Urządzenia Xiaomi nie są w pełni zgodne ze standardem Zigbee i czasami rozłączają się z siecią. Najczęstsze przyczyny to:

1. **Słaby sygnał** — jakość połączenia poniżej 20 uważa się za słabą. Przenieś czujnik bliżej koordynatora lub routera Zigbee zasilanego z sieci.
2. **Niskie napięcie baterii** — może się to zdarzyć nawet wtedy, gdy bateria nadal wydaje się pełna. Wypróbuj inną baterię CR2032.
3. **Niekompatybilny router** — routery firm Centralite, General Electric, Iris, Ledvance, Legrand, OSRAM, Sylvania, Securifi i niektórych innych producentów są znane z powodowania problemów z urządzeniami Xiaomi. Podłącz czujnik bezpośrednio do koordynatora, naciskając przycisk reset, gdy znajduje się fizycznie blisko koordynatora.

### Wartość wilgotności w smart rules mieści się w zakresie od 0 do 1

To zamierzone działanie. TapHome przechowuje wilgotność w skali 0–1 (0,542 = 54,2 %), a aplikacja wyświetla ją w procentach. W smart rules i formułach używaj wartości z zakresu 0–1.

## Dostępne urządzenia 1

Te urządzenia pojawią się w TapHome po imporcie.

Xiaomi WSDCGQ01LM Moduł

Zmienne niestandardowe

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

Xiaomi WSDCGQ01LM Czujnik temperatury

Atrybuty serwisowe

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

Zmienna: `battery`, Zmienna: `voltage`, Zmienna: `link`

Nasłuchiwanie

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

Atrybuty serwisowe

Battery

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

Battery voltage

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

Atribút

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

**Połączenie:** Packet Parser → MQTT

## Parametry importu

Te wartości podajesz podczas importu pliku XML.

| Pytanie w aplikacji  | Domyślnie     |
|----------------------|---------------|
| Mqtt Broker Adres IP | `192.168.0.1` |
| Mqtt Broker port     | `1883`        |

## Powiązana dokumentacja

- [MQTT Integration](https://taphome.com/pl/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/pl/docs/integration/packet-parser/)
- [Funkcje Packet parser](https://taphome.com/pl/docs/script/packet-parser/)
- [Funkcje parsowania](https://taphome.com/pl/docs/script/parsing-functions/)
- [Broker MQTT](https://taphome.com/pl/docs/integration/packet-parser/mqtt-broker/)
- [Skrypty listener](https://taphome.com/pl/docs/script/listener-scripts/)