---
title: "Tuya TS0201 Temperature \u0026 Humidity Sensor"
description: "Praćenje temperature i vlažnosti preko mosta Zigbee2MQTT. Atributi baterije, napona i kvalitete veze. Predložak TapHome za Zigbee senzor Tuya TS0201."
url: "https://taphome.com/hr/compatibility/zigbee2mqtt-ts0201-temperature-humidity/"
language: hr
lastmod: 2026-04-23
generator: hugo
ai:
  topics: ["mqtt","sensor","zigbee","zigbee2mqtt","temperature-humidity","battery-powered"]
  questions: ["Kako integrirati Tuya TS0201 sa sustavom TapHome preko Zigbee2MQTT-a?","Kako upariti senzor TS0201 s koordinatorom Zigbee2MQTT?","Zašto se vlažnost senzora TS0201 javlja kao razlomak umjesto kao postotak?","Kako u sustavu TapHome postaviti Zigbee2MQTT friendly name za TS0201?","Treba li firmver senzora TS0201 ažurirati bežično (OTA) preko Zigbee2MQTT-a?","Koje servisne atribute daje predložak za TS0201 u sustavu TapHome?"]
---

# Tuya TS0201 Temperature & Humidity Sensor

Komunikacija: Packet Parser → MQTT

- [Zigbee2MQTT — stranica uređaja TS0201](https://www.zigbee2mqtt.io/devices/TS0201.html)

> Adresa u mreži
> 
> Kod MQTT brokera ugrađenog u TapHome radi se o jednom brokeru kojem se pristupa s dva mjesta. Predložak radi izravno u jedinici TapHome Core, zato je u TapHomeu adresa brokera `127.0.0.1` (ovo računalo). Uređaj radi drugdje u mreži, zato u uređaju unesite IP adresu jedinice TapHome Core i za Core postavite rezervaciju IP adrese u usmjerivaču — ako se adresa jedinice Core promijeni, uređaj više ne dolazi do brokera.
> 
> [Priprema mreže](https://taphome.com/hr/docs/setup/network-preparation/)

## Upute za integraciju

Tuya TS0201 povoljan je Zigbee senzor temperature i vlage na bateriju s malim LCD zaslonom. Isti se hardver prodaje i pod nazivom BlitzWolf BW-IS4 (white label). Uređaj je popularan kao jeftin senzor sobne klime u najnižem cjenovnom razredu.

TapHome sa senzorom TS0201 komunicira neizravno: senzor se uparuje sa Zigbee koordinatorom (npr. Sonoff ZBDongle-P/E, USB stick s čipom CC2652, CC2531) kojim upravlja most Zigbee2MQTT. Zigbee2MQTT pretvara Zigbee poruke u JSON poruke na MQTT temama. TapHome se na te teme pretplaćuje preko modula PacketParser MQTT i vrijednosti preslikava na temperaturu i vlažnost s atributima baterije i kvalitete veze.

## Preduvjeti

Za korištenje senzora TS0201 sa sustavom TapHome potrebne su sljedeće komponente:

- **Zigbee koordinator**: USB stick s čipom CC2652P/CC2652R ili CC2531, na primjer Sonoff ZBDongle-P ili Sonoff ZBDongle-E
- **Most Zigbee2MQTT**: radi na zasebnom računalu (Raspberry Pi, NUC, NAS) ili kao kontejner uz MQTT broker
- **MQTT broker**: preporučuje se Mosquitto; mora biti dostupan i s računala na kojem radi Zigbee2MQTT i s centralne jedinice TapHome (CCU)
- **Centralna jedinica TapHome (CCU)** s podrškom za PacketParser (model PacketParserCCU)

Sam TS0201 ne spaja se na Wi-Fi ni Ethernet: sva IP komunikacija odvija se između MQTT brokera i centralne jedinice TapHome.

## Uparivanje

Prije uvoza predloška TapHome senzor TS0201 mora biti uparen s koordinatorom Zigbee2MQTT:

1. Otvorite web-sučelje Zigbee2MQTT i uključite način uparivanja (**Permit join**)
2. Na senzoru TS0201 pritisnite i držite tipku za resetiranje oko pet sekundi, dok indikator mreže na vrhu zaslona ne počne treptati
3. Uređaj se automatski pridružuje Zigbee mreži i pojavljuje se na popisu uređaja Zigbee2MQTT s IEEE adresom (npr. `0xa4c1388f85d9eca2`)
4. Po želji u web-sučelju Zigbee2MQTT preimenujte uređaj i dodijelite mu čitljiv friendly name (npr. `bedroom_climate`)

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

## Konfiguracija

### Parametri uvoza

Pri uvozu predloška u TapHome unesite adresu MQTT brokera:

| Parametar | Opis | Zadano |
|-----------|-------------|---------|
| `Mqtt Broker ipAddress` | IP adresa ili naziv računala (hostname) MQTT brokera | `192.168.0.1` |
| `Mqtt Broker port` | TCP port MQTT brokera | `1883` |

### Varijabla modula

Nakon uvoza predloška postavite korisničku varijablu `TS0201` kojom se uređaj prepoznaje na MQTT brokeru:

| Varijabla | Opis | Kako je dobiti | Primjer |
|----------|-------------|---------------|---------|
| `TS0201` | Zigbee2MQTT friendly name ili IEEE adresa senzora | Web-sučelje Zigbee2MQTT → Devices → pronađite TS0201 → kopirajte Friendly name ili IEEE adresu | `0xa4c1388f85d9eca2` |

Varijabla se koristi kao sufiks MQTT teme: listener skripta pretplaćuje se na `zigbee2mqtt/{TS0201}` i raščlanjuje JSON poruku stanja.

> [!TIP]
> Ako umjesto IEEE adrese koristite friendly name (npr. `bedroom_climate`), konfiguracija u sustavu TapHome je preglednija. Friendly name može se promijeniti u web-sučelju Zigbee2MQTT u postavkama uređaja.

## Mogućnosti uređaja

Predložak u sustavu TapHome prikazuje TS0201 kao senzor temperature, a uz to daje vlažnost te atribute baterije i signala.

### Temperatura i vlažnost

Temperatura (°C) i relativna vlažnost (%) raščlanjuju se iz JSON teme stanja `zigbee2mqtt/{TS0201}`. Senzor javlja nove vrijednosti kad god se izmjerena veličina promijeni ili periodično, prema rasporedu kojim upravlja most Zigbee2MQTT.

Primjer poruke koju objavljuje Zigbee2MQTT:

```json
{
  "battery": 95,
  "humidity": 54.2,
  "linkquality": 132,
  "temperature": 21.7,
  "voltage": 3000
}
```

### Praćenje baterije i signala

Uz glavne vrijednosti temperature i vlažnosti uređaj ima tri servisna atributa:

- **Baterija**: preostali postotak baterije (0–100 %) iz JSON poruke stanja. Nakon uparivanja može proći do 24 sata dok stigne prva vrijednost.
- **Napon baterije**: neobrađeni napon baterije u milivoltima iz JSON poruke stanja.
- **LinkQuality**: pokazatelj kvalitete Zigbee signala (LQI) iz JSON poruke stanja, u rasponu od 0 (najlošiji) do 255 (najbolji).

Svi atributi prikazuju `"-"` dok s uređaja ne stigne prva poruka.

## Poznati problemi

### Vrijednost vlažnosti podijeljena sa 100

Trenutačna listener skripta u predlošku dijeli vrijednost vlažnosti sa 100 (`Hu := payloadHum/100`). Međutim, Zigbee2MQTT vlažnost objavljuje izravno kao postotak (npr. `54.2` znači 54,2 %), pa dijeljenje sa `/100` daje `0.542 %` umjesto očekivanih `54.2 %`.

> [!WARNING]
> Provjerite javljenu vlažnost na stvarnom uređaju. Ako je vrijednost očito pomaknuta za dva decimalna mjesta, promijenite skriptu slušatelja u `Hu := payloadHum;` (bez dijeljenja `/100`).

### Ne primjenjujte bežična (OTA) ažuriranja firmvera

Najnovija objavljena slika firmvera za TS0201 trajno onesposobljuje uređaj i čini ga potpuno neupotrebljivim. Zigbee2MQTT za ovaj uređaj nudi OTA ažuriranja, ali ih ne smijete primijeniti dok ne bude objavljena sigurna slika. Pojedinosti potražite u prijavi problema Zigbee2MQTT na GitHubu [#25207](https://github.com/Koenkk/zigbee2mqtt/issues/25207).

> [!WARNING]
> NE pokrećite OTA ažuriranje za TS0201 iz web-sučelja Zigbee2MQTT. Poznato je da trenutačna slika firmvera trajno onesposobljuje senzor.

## Rješavanje problema

### Podaci ne stižu

1. Provjerite je li TS0201 na popisu uređaja Zigbee2MQTT s nedavnom vremenskom oznakom „Last seen”
2. Provjerite odgovara li korisnička varijabla `TS0201` u sustavu TapHome točno nazivu uređaja (friendly name) ili njegovoj IEEE adresi. Razlikuju se velika i mala slova
3. MQTT klijentom (npr. MQTT Explorer) pretplatite se na `zigbee2mqtt/#` i provjerite stižu li JSON poruke na `zigbee2mqtt/{friendly_name}`
4. Provjerite odgovaraju li IP adresa i port MQTT brokera u parametrima uvoza TapHome brokeru koji je dostupan s centralne jedinice

### Uređaj se u Zigbee2MQTT-u prikazuje kao izvan mreže

1. TS0201 je krajnji uređaj na bateriju koji između dva javljanja spava kako bi štedio energiju. „Offline” može jednostavno značiti da uređaj u posljednje vrijeme nije ništa poslao. Pričekajte sljedeće redovno javljanje ili kratko pritisnite tipku za resetiranje kako bi uređaj poslao podatke.
2. Ako se uređaj nikada ne vrati na mrežu, Zigbee veza je možda prekinuta zbog udaljenosti od koordinatora. Približite senzor ili dodajte Zigbee usmjerivač (Zigbee uređaj s mrežnim napajanjem) kako biste proširili mesh mrežu.
3. Provjerite atribut LinkQuality. Vrijednosti ispod ~30 lqi znače slab signal.

### Zastarjele vrijednosti baterije ili kvalitete veze

1. Baterija i napon ažuriraju se samo kada se senzor probudi i javi, što može biti jednom u nekoliko sati
2. Ako vrijednosti prikazuju `"-"`, još nije primljena nijedna MQTT poruka. Pričekajte sljedeće javljanje ili ponovno uparite uređaj
3. Nakon ponovnog uparivanja baterija može do 24 sata prikazivati `"-"` prije nego što se objavi prva vrijednost

## Dostupni uređaji 1

Ovi se uređaji pojavljuju u TapHomeu nakon uvoza.

Tuya TS0201 Modul

Prilagođene varijable

`TS0201` (string) = 0xa4c1388f85d9eca2 Zigbee2MQTT friendly name ili IEEE adresa senzora TS0201 — koristi se kao sufiks MQTT teme (zigbee2mqtt/{friendly\_name})

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

Senzor temperature i vlage Senzor temperature Samo za čitanje

Temperatura (°C) i relativna vlažnost (%) raščlanjene iz JSON poruke stanja Zigbee2MQTT

JSON Jedinica: °C / % json\_path

Servisni atributi

|                |                                                                                                          |
|----------------|----------------------------------------------------------------------------------------------------------|
| Baterija       | Preostali postotak baterije (0–100 %); nakon uparivanja može proći do 24 sata dok stigne prva vrijednost |
| Napon baterije | Neobrađeni napon baterije u milivoltima (mV) raščlanjen iz JSON poruke stanja                            |
| LinkQuality    | Pokazatelj kvalitete Zigbee signala (LQI) — od 0 (najlošiji) do 255 (najbolji)                           |

Čitanje vlažnosti

```taphome
# 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");
```

Čitanje temperature

```taphome
# 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");
```

Listener

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

Servisni atributi

Battery

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

Battery Voltage

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

LinkQuality

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

**Povezivanje:** Packet Parser → MQTT

Moguća poboljšanja (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.

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

## Izvori

- Zigbee2MQTT — TS0201 device page
  
  [www.zigbee2mqtt.io](https://www.zigbee2mqtt.io/devices/TS0201.html) 2026-04-23
- Zigbee2MQTT GitHub — TS0201 device definition
  
  [github.com](https://github.com/Koenkk/zigbee2mqtt.io/blob/master/docs/devices/TS0201.md) 2026-04-23

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

