Tuya TS0201 — Senzor de temperatură și umiditate

Tuya TS0201 Temperature & Humidity Sensor

Packet Parser → MQTT

Trimis de

Ultima actualizare: 04. 2026

Pagina dispozitivului TS0201 pe Zigbee2MQTT

Tuya TS0201 Temperature & Humidity Sensor

Tuya TS0201 este un senzor Zigbee de temperatură și umiditate ieftin, alimentat cu baterii, cu un mic afișaj LCD. Același hardware se vinde și sub marca BlitzWolf BW-IS4. Dispozitivul este popular ca senzor ieftin pentru monitorizarea temperaturii și umidității din încăperi.

TapHome comunică cu TS0201 indirect — senzorul se asociază cu un coordonator Zigbee (de ex. Sonoff ZBDongle-P/E, un stick bazat pe CC2652, CC2531), gestionat de o punte Zigbee2MQTT. Zigbee2MQTT transformă mesajele Zigbee în payload-uri JSON pe topicuri MQTT. TapHome se abonează la aceste topicuri printr-un modul PacketParser MQTT și atribuie valorile serviciilor de temperatură/umiditate, cu atribute pentru baterie și calitatea legăturii.

Cerințe

Pentru a folosi TS0201 cu TapHome sunt necesare următoarele componente:

Coordonator Zigbee — stick USB bazat pe CC2652P/CC2652R sau CC2531, de exemplu Sonoff ZBDongle-P sau Sonoff ZBDongle-E
Puntea Zigbee2MQTT — rulează pe un host dedicat (Raspberry Pi, NUC, NAS) sau într-un container, alături de brokerul MQTT
Broker MQTT — opțiunea recomandată este Mosquitto; trebuie să fie accesibil atât de pe hostul Zigbee2MQTT, cât și de pe TapHome CCU
TapHome CCU cu suport PacketParser (model PacketParserCCU)

TS0201 nu se conectează la Wi-Fi sau Ethernet — toată comunicația IP are loc între brokerul MQTT și TapHome CCU.

Asocierea

Înainte de importul șablonului TapHome, TS0201 trebuie asociat cu coordonatorul Zigbee2MQTT:

Deschideți interfața web Zigbee2MQTT și activați modul de asociere (Permit join)
Pe TS0201, țineți apăsat butonul de resetare aproximativ cinci secunde, până când indicatorul de rețea din partea de sus a afișajului începe să clipească
Dispozitivul se alătură automat rețelei Zigbee și apare în lista de dispozitive Zigbee2MQTT cu o adresă IEEE (de ex. 0xa4c1388f85d9eca2)
Opțional, redenumiți dispozitivul și atribuiți-i un friendly name ușor de citit (de ex. bedroom_climate) în interfața web Zigbee2MQTT

După asociere, afișarea procentului bateriei poate dura până la 24 de ore — senzorul raportează valoarea bateriei doar periodic.

Configurare

Parametri de import

La importul șablonului în TapHome, introduceți adresa brokerului MQTT:

Parametru	Descriere	Valoare implicită
`Mqtt Broker ipAddress`	Adresa IP sau numele de gazdă al brokerului MQTT	`192.168.0.1`
`Mqtt Broker port`	Portul TCP al brokerului MQTT	`1883`

Variabila modulului

După importul șablonului, setați variabila personalizată TS0201 pentru a identifica dispozitivul pe brokerul MQTT:

Variabilă	Descriere	Cum se obține	Exemplu
`TS0201`	Friendly name Zigbee2MQTT sau adresa IEEE a senzorului	Interfața web Zigbee2MQTT → Devices → găsiți TS0201 → copiați Friendly name sau adresa IEEE	`0xa4c1388f85d9eca2`

Variabila se folosește ca sufix al topicului MQTT — scriptul listener se abonează la zigbee2mqtt/{TS0201} și analizează payload-ul JSON de stare.

Folosirea unui friendly name (de ex. bedroom_climate) în locul adresei IEEE face configurarea TapHome mai ușor de citit. Friendly name se poate schimba în interfața web Zigbee2MQTT, în setările dispozitivului.

Funcțiile dispozitivului

Șablonul mapează TS0201 ca dispozitiv de tip Senzor de temperatură în TapHome și oferă umiditatea împreună cu atributele pentru baterie și semnal.

Temperatură și umiditate

Temperatura (°C) și umiditatea relativă (%) se citesc din topicul JSON de stare zigbee2mqtt/{TS0201}. Senzorul raportează valori noi ori de câte ori se schimbă o mărime măsurată sau după un program periodic gestionat de puntea Zigbee2MQTT.

Exemplu de payload publicat de Zigbee2MQTT:

1
2
3
4
5
6
7
{
  "battery": 95,
  "humidity": 54.2,
  "linkquality": 132,
  "temperature": 21.7,
  "voltage": 3000
}

Monitorizarea bateriei și a semnalului

Pe lângă valorile principale de temperatură și umiditate, dispozitivul oferă trei atribute de service:

Baterie — procentul rămas al bateriei (0–100 %) din payload-ul JSON de stare. După asociere, raportarea primei valori poate dura până la 24 de ore.
Tensiunea bateriei — tensiunea brută a bateriei în milivolți, din payload-ul JSON de stare.
LinkQuality — indicatorul calității semnalului Zigbee (LQI) din payload-ul JSON de stare, de la 0 (cel mai slab) la 255 (cel mai bun).

Toate atributele afișează "-" până la primirea primului mesaj de la dispozitiv.

Probleme cunoscute

Valoarea umidității este împărțită la 100

Scriptul listener actual din șablon împarte payload-ul umidității la 100 (Hu := payloadHum/100). Zigbee2MQTT publică însă umiditatea direct ca procent (de ex. 54.2 înseamnă 54,2 %), așa că aplicarea /100 dă 0.542 % în loc de 54.2 %, cât ar fi de așteptat.

Verificați umiditatea raportată pe hardware-ul real. Dacă valoarea afișată este de 100 de ori mai mică decât cea așteptată, modificați scriptul listener în Hu := payloadHum; (fără împărțirea /100).

Nu aplicați actualizări de firmware OTA

Cea mai recentă imagine de firmware publicată pentru TS0201 blochează definitiv dispozitivul și îl lasă complet inutilizabil. Zigbee2MQTT oferă actualizări OTA pentru acest dispozitiv, dar acestea nu trebuie aplicate până când nu este publicată o imagine de firmware sigură. Detalii în issue-ul Zigbee2MQTT de pe GitHub #25207.

NU porniți o actualizare OTA pentru TS0201 din interfața web Zigbee2MQTT. Se știe că imaginea actuală blochează definitiv senzorul.

Rezolvarea problemelor

Nu se primesc date

Verificați dacă TS0201 apare în lista de dispozitive Zigbee2MQTT cu o marcă de timp „Last seen” recentă
Verificați dacă variabila personalizată TS0201 din TapHome corespunde exact friendly name-ului sau adresei IEEE a dispozitivului — se ține cont de majuscule și minuscule
Folosiți un client MQTT (de ex. MQTT Explorer) pentru a vă abona la zigbee2mqtt/# și confirmați că payload-urile JSON sosesc pe zigbee2mqtt/{friendly_name}
Confirmați că adresa IP și portul brokerului MQTT din parametrii de import TapHome corespund brokerului accesibil de pe CCU

Dispozitivul apare offline în Zigbee2MQTT

TS0201 este un dispozitiv final alimentat cu baterii — între raportări intră în repaus pentru a economisi energie. „Offline” poate însemna doar că dispozitivul nu a transmis de curând; așteptați următoarea raportare programată sau apăsați scurt butonul de resetare pentru a forța o raportare.
Dacă dispozitivul nu mai revine online, legătura Zigbee poate fi întreruptă din cauza distanței față de coordonator. Apropiați senzorul sau adăugați un router Zigbee (dispozitiv Zigbee alimentat de la rețea) pentru a extinde rețeaua mesh.
Verificați atributul LinkQuality — valorile sub ~30 lqi indică un semnal slab.

Valori învechite ale bateriei sau calității legăturii

Bateria și tensiunea se actualizează doar când senzorul se trezește și raportează — poate fi o dată la câteva ore
Dacă valorile afișează "-", încă nu s-a primit niciun mesaj MQTT; așteptați următoarea raportare sau asociați din nou dispozitivul
După o nouă asociere, bateria poate rămâne "-" până la 24 de ore, până la publicarea primei valori

Dispozitive disponibile

Tuya TS0201 Modul

Variabile personalizate

TS0201 (string) = 0xa4c1388f85d9eca2

Friendly name Zigbee2MQTT sau adresa IEEE a senzorului TS0201 — folosit ca sufix al topicului MQTT (zigbee2mqtt/{friendly_name})

Open Zigbee2MQTT web UI → Devices → find the TS0201 → copy the Friendly name (or use the IEEE address, e.g. 0xa4c1388f85d9eca2)

Senzor de temperatură și umiditate Senzor de temperatură Doar citire

Temperatura (°C) și umiditatea relativă (%) citite din payload-ul JSON de stare Zigbee2MQTT

JSON Unitate: °C / % json_path

Atribute de service

Baterie	Procentul rămas al bateriei (0–100 %); după asociere, raportarea primei valori poate dura până la 24 de ore
Tensiunea bateriei	Tensiunea brută a bateriei în milivolți (mV), citită din payload-ul JSON de stare
LinkQuality	Indicatorul calității semnalului Zigbee (LQI) — de la 0 (cel mai slab) la 255 (cel mai bun)

Senzor de temperatură și umiditate

Citirea umidității

# Simple HTTP Request:
# VAR response := SENDHTTPREQUEST("/example/getValue");
# IF response.IsSuccess
#  VAR content := response.Content;
#  VAR responseHeaders := response.Headers;
#  RETURN(PARSEXML(content, "//element1/value1"));
# ELSE
#  ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
#  RETURN(NaN);
# END
#
# Set Http request method, body and headers
# VAR response := SENDHTTPREQUEST("/example/getValue", "GET", "some data", "header1:value1", "header2:value2", ...);
# OR
# VAR request := HTTPREQUEST("/example/getValue", "POST", "some data");
# request.headers := { "header1:value1", "header2:value2", ...};
# request.method := "GET";
# request.data := null;
# VAR response := SENDHTTPREQUEST(request);
#
#
# Send TCP, UDP data:
# VAR data1 := BYTECOLLECTION("0a bb ea df 01");
# SENDDATA(data1);
# VAR data2 := "{\"name\":\"John\", \"age\":32}";
# SENDDATA(data2);
# VAR data3 := TOBYTES("{\"name\":\"John\", \"age\":32}", "iso-8859-1");
# SENDDATA(data3);
# Process received TCP or UDP data and set device values in the Listener script
#
#
# Download data from FTP:
# FTPDOWNLOAD("filePath");

Citirea temperaturii

# Simple HTTP Request:
# VAR response := SENDHTTPREQUEST("/example/getValue");
# IF response.IsSuccess
#  VAR content := response.Content;
#  VAR responseHeaders := response.Headers;
#  RETURN(PARSEXML(content, "//element1/value1"));
# ELSE
#  ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
#  RETURN(NaN);
# END
#
# Set Http request method, body and headers
# VAR response := SENDHTTPREQUEST("/example/getValue", "GET", "some data", "header1:value1", "header2:value2", ...);
# OR
# VAR request := HTTPREQUEST("/example/getValue", "POST", "some data");
# request.headers := { "header1:value1", "header2:value2", ...};
# request.method := "GET";
# request.data := null;
# VAR response := SENDHTTPREQUEST(request);
#
#
# Send TCP, UDP data:
# VAR data1 := BYTECOLLECTION("0a bb ea df 01");
# SENDDATA(data1);
# VAR data2 := "{\"name\":\"John\", \"age\":32}";
# SENDDATA(data2);
# VAR data3 := TOBYTES("{\"name\":\"John\", \"age\":32}", "iso-8859-1");
# SENDDATA(data3);
# Process received TCP or UDP data and set device values in the Listener script
#
#
# Download data from FTP:
# FTPDOWNLOAD("filePath");

Ascultător

if RECEIVEDMSG.TOPIC = "zigbee2mqtt/"+ TS0201 
   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

Atribute de service

Battery

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

Battery Voltage

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

LinkQuality

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

Conexiune: Packet Parser → MQTT

Îmbunătățiri posibile (5)

Temperature calibration (absolute offset) — Configurable via Zigbee2MQTT devices.yaml or frontend UI — not exposed via TapHome template. Applied at Z2M layer.
Temperature precision (decimal digits 0-3) — Configured at the Z2M layer, not in TapHome template.
Humidity calibration (absolute offset) — Configured at the Z2M layer, not in TapHome template.
Humidity precision (decimal digits 0-3) — Configured at the Z2M layer, not in TapHome template.
Availability status — Online/offline availability topic — could detect unreachable devices. Not subscribed by the current template.

Descărcați șablon

Surse

Zigbee2MQTT — TS0201 device page
www.zigbee2mqtt.io 2026-04-23
Zigbee2MQTT GitHub — TS0201 device definition
github.com 2026-04-23

Ați găsit o problemă la acest șablon de dispozitiv?

Spuneți-ne ce nu funcționează, ce lipsește sau cum ar trebui să se comporte șablonul. Feedbackul dvs. ne ajută să păstrăm catalogul corect.

Verificat de TapHome

Doriți să folosiți acest șablon în TapHome Core?

Deschideți acest șablon în Customer Portal pentru a-l aplica într-una dintre locuințele dvs. sau pentru a propune o îmbunătățire și a o trimite înapoi în catalog.

Deschideți în portal