TapHome
Polski
Slovenčina Čeština Magyar Italiano

Polski

Deutsch Română Hrvatski English
Oficjalny · TapHome

Xiaomi Mi Temperature and Humidity Sensor (WSDCGQ01LM) via Zigbee2MQTT

Okrągły czujnik temperatury i wilgotności Zigbee Xiaomi WSDCGQ01LM (CR2032) w TapHome przez MQTT za pośrednictwem bramki Zigbee2MQTT. Raportuje temperaturę, wilgotność względną, poziom baterii, napięcie baterii i jakość połączenia Zigbee. Parowanie w Zigbee2MQTT przez Permit join i przycisk reset.

Zigbee2MQTTPacket Parser → MQTT1 urządzenieRewizja 1.0 Ostatnia aktualizacja: 10 listopada 2026

Import do aplikacji TapHomeSprzęt › Packet Parser › Dodaj z szablonu

Pobierz szablon
Na tej stronie

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 lub czujnik ruchu Aqara 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).

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:

OpcjaOpis
temperature_calibrationBezwzględne przesunięcie dodawane do wartości temperatury
temperature_precisionLiczba miejsc dziesiętnych temperatury (0–3, może tylko zmniejszyć precyzję)
humidity_calibrationBezwzględne przesunięcie dodawane do wartości wilgotności
humidity_precisionLiczba miejsc dziesiętnych wilgotności (0–3, może tylko zmniejszyć precyzję)

Konfiguracja

Parametry importu

Podczas importu szablonu wpisz adres brokera MQTT:

ParametrOpisWartość domyślna
Mqtt Broker ipAddressAdres IP brokera MQTT192.168.0.1
Mqtt Broker portPort TCP brokera MQTT1883

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

Zmienna modułu

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

ZmiennaOpisJak uzyskaćWartość domyślna w szablonie
Xiaomi_WSDCGQ01LM_1Friendly name Zigbee2MQTT lub adres IEEE czujnikaInterfejs webowy Zigbee2MQTT → Devices → WSDCGQ01LM → skopiuj friendly name lub adres IEEE0x00158d0001823a01

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.

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śćZakresDokładność
Temperaturaod -20 °C do 50 °C±0,3 °C
Wilgotność względna10–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

ParametrWartość
ModelWSDCGQ01LM
Łączność bezprzewodowaZigbee, 2405–2480 MHz
BateriaCR2032
Wymiary36 × 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

Xiaomi WSDCGQ01LM

Nasłuchiwanie
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
IF (ISNAN(battery), "-", battery + "%");
Battery voltage
IF (ISNAN(voltage), "-", voltage + "mV");
Atribút
IF (ISNAN(link), "-", link + "lqi");
Połączenie: Packet Parser → MQTT

Parametry importu

Te wartości podajesz podczas importu pliku XML.

Pytanie w aplikacjiDomyślnie
Mqtt Broker Adres IP192.168.0.1
Mqtt Broker port1883

Powiązana dokumentacja

Znalazłeś problem z tym szablonem urządzenia?

Napisz nam, co nie działa, czego brakuje lub jak powinien zachowywać się szablon. Twoja opinia pomaga nam utrzymać katalog dokładnym.

Szablon · portal TapHome Xiaomi Mi Temperature and Humidity Sensor (WSDCGQ01LM) via Zigbee2MQTT Otwórz ten szablon w portalu klienta, aby zastosować go w swoim domu, lub zaproponuj modyfikację i wyślij ją z powrotem do katalogu. Packet Parser → MQTT Zobacz w portalu TapHome