--- title: "Tuya TS0201 Temperature \u0026 Humidity Sensor" description: "Hőmérséklet és páratartalom monitorozása Zigbee2MQTT MQTT átjárón keresztül. Akkumulátor, feszültség és link quality attribútumok. TapHome sablon a Tuya TS0201 Zigbee érzékelőhöz." url: "https://taphome.com/hu/compatibility/zigbee2mqtt-ts0201-temperature-humidity/" language: hu lastmod: 2026-04-23 generator: hugo ai: topics: ["mqtt","sensor","zigbee","zigbee2mqtt","temperature-humidity","battery-powered"] questions: ["Hogyan integrálható a Tuya TS0201 a TapHome rendszerrel Zigbee2MQTT-n keresztül?","Hogyan lehet a TS0201 érzékelőt Zigbee2MQTT koordinátorral párosítani?","Miért jelenik meg a TS0201 páratartalom értéke tört formában százalék helyett?","Hogyan állítható be a Zigbee2MQTT friendly name a TS0201-hez TapHome-ban?","Frissítsem a TS0201 firmware-ét OTA-n keresztül a Zigbee2MQTT-ből?","Milyen szolgáltatás-attribútumokat tesz elérhetővé a TS0201 sablon a TapHome-ban?"] --- # Tuya TS0201 Temperature & Humidity Sensor Kommunikáció: Packet Parser → MQTT - [Zigbee2MQTT TS0201 eszközoldal](https://www.zigbee2mqtt.io/devices/TS0201.html) > Hálózati cím > > A TapHome-ba épített MQTT bróker esetén a TapHome-ban brókercímként adja meg a `127.0.0.1` címet. Az eszközben a TapHome Core IP-címét adja meg, és a Core-nak állítson be IP-foglalást a routerben. > > [A hálózat előkészítése](https://taphome.com/hu/docs/setup/network-preparation/) ## Integrációs útmutató A Tuya TS0201 egy olcsó, elemmel működő Zigbee hőmérséklet- és páraérzékelő kis LCD kijelzővel. Ugyanaz a hardver BlitzWolf BW-IS4 márkanév alatt is kapható (white label). Az eszköz népszerű olcsó szobaklíma-érzékelőként a belépő árkategóriában. A TapHome közvetve kommunikál a TS0201-gyel — az érzékelő egy Zigbee koordinátorral párosodik (pl. Sonoff ZBDongle-P/E, CC2652-alapú stick, CC2531), amelyet Zigbee2MQTT átjáró kezel. A Zigbee2MQTT a Zigbee üzeneteket JSON payloadokká fordítja le MQTT topicokon. A TapHome egy PacketParser MQTT modulon keresztül feliratkozik ezekre a topicokra, és a értékeket hőmérséklet/páratartalom szolgáltatásokra képezi le akkumulátor- és kapcsolat-minőségi attribútumokkal. ## Követelmények A TS0201 használatához a TapHome-mal a következő komponensek szükségesek: - **Zigbee koordinátor** — CC2652P/CC2652R vagy CC2531 alapú USB stick, például Sonoff ZBDongle-P vagy Sonoff ZBDongle-E - **Zigbee2MQTT átjáró** — dedikált hoston (Raspberry Pi, NUC, NAS) vagy konténerként az MQTT broker mellett fut - **MQTT broker** — a Mosquitto ajánlott; elérhetőnek kell lennie mind a Zigbee2MQTT hostról, mind a TapHome CCU-ról - **TapHome CCU** PacketParser támogatással (PacketParserCCU modell) Maga a TS0201 nem csatlakozik Wi-Fi vagy Ethernet hálózathoz — minden IP-hálózati kommunikáció az MQTT broker és a TapHome CCU között zajlik. ## Párosítás A TapHome sablon importálása előtt a TS0201-et párosítani kell a Zigbee2MQTT koordinátorral: 1. Nyissa meg a Zigbee2MQTT webes felületét, és engedélyezze a párosítási módot (**Permit join**) 2. A TS0201-en tartsa nyomva a reset gombot körülbelül öt másodpercig, amíg a hálózati jelző a kijelző tetején villogni nem kezd 3. Az eszköz automatikusan csatlakozik a Zigbee hálózathoz, és IEEE címmel (pl. `0xa4c1388f85d9eca2`) megjelenik a Zigbee2MQTT eszközlistájában 4. Opcionálisan nevezze át az eszközt, és rendeljen hozzá olvasható friendly name-et (pl. `haloszoba_klima`) a Zigbee2MQTT webes felületén > [!NOTE] > Az akkumulátor százaléka a párosítás után akár 24 órát is igénybe vehet, amíg megjelenik — az érzékelő csak periodikusan jelenti az akkumulátor értékét. ## Konfiguráció ### Import paraméterek A sablon TapHome-ba történő importálásakor adja meg az MQTT broker címét: | Paraméter | Leírás | Alapérték | |-----------|--------|-----------| | `Mqtt Broker ipAddress` | Az MQTT broker IP-címe vagy hostneve | `192.168.0.1` | | `Mqtt Broker port` | Az MQTT broker TCP portja | `1883` | ### Modul változó A sablon importálása után állítsa be a `TS0201` egyéni változót, hogy azonosítsa az eszközt az MQTT brokeren: | Változó | Leírás | Hogyan szerezhető meg | Példa | |---------|--------|----------------------|-------| | `TS0201` | A Zigbee2MQTT friendly name vagy az érzékelő IEEE címe | Zigbee2MQTT web UI → Devices → keresse meg a TS0201-et → másolja a Friendly name-et vagy az IEEE címet | `0xa4c1388f85d9eca2` | A változó az MQTT topic utótagjaként szolgál — a listener script feliratkozik a `zigbee2mqtt/{TS0201}`-re és elemzi a JSON állapot payloadot. > [!TIP] > A friendly name (pl. `haloszoba_klima`) használata az IEEE cím helyett olvashatóbbá teszi a TapHome konfigurációt. A friendly name a Zigbee2MQTT webes felületén az eszköz beállításai között módosítható. ## Eszközfunkciók A sablon a TS0201-et Temperature Sensor típusú eszközként képezi le a TapHome-ban, és a hőmérséklet mellett a páratartalmat is elérhetővé teszi akkumulátor- és jel-attribútumokkal együtt. ### Hőmérséklet és páratartalom A hőmérsékletet (°C) és a relatív páratartalmat (%) a `zigbee2mqtt/{TS0201}` JSON állapot topicból elemzi. Az érzékelő új értékeket jelent, amikor egy mért mennyiség változik, vagy a Zigbee2MQTT átjáró által kezelt periodikus ütemterv szerint. Példa a Zigbee2MQTT által publikált payloadra: ```json { "battery": 95, "humidity": 54.2, "linkquality": 132, "temperature": 21.7, "voltage": 3000 } ``` ### Akkumulátor- és jelfigyelés Az eszköz a primér hőmérséklet- és páratartalom-értékek mellett három szolgáltatás-attribútumot tesz elérhetővé: - **Battery** — fennmaradó akkumulátorszázalék (0–100 %) a JSON állapot payloadból. Az első érték akár 24 órát is igénybe vehet a párosítás után. - **Battery Voltage** — nyers akkumulátorfeszültség millivoltban a JSON állapot payloadból. - **LinkQuality** — Zigbee jelminőség-indikátor (LQI) a JSON állapot payloadból, 0 (legrosszabb) és 255 (legjobb) közötti tartományban. Minden attribútum `"-"`-ot jelenít meg, amíg az első üzenet meg nem érkezik az eszköztől. ## Ismert problémák ### A páratartalom értéke 100-zal osztva A sablon jelenlegi listener scriptje a páratartalom payloadot 100-zal osztja (`Hu := payloadHum/100`). A Zigbee2MQTT azonban a páratartalmat közvetlenül százalékként publikálja (pl. `54.2` azt jelenti, hogy 54,2 %), így a `/100` alkalmazása `0.542 %`-ot eredményez a várt `54.2 %` helyett. > [!WARNING] > Ellenőrizze a jelentett páratartalmat éles hardveren. Ha az érték láthatóan két tizedesjeggyel el van tolódva, módosítsa a listener scriptet `Hu := payloadHum;`-ra (a `/100` osztás nélkül). ### Ne alkalmazzon OTA firmware-frissítéseket A TS0201 legutóbb közzétett firmware-képe használhatatlanná teszi az eszközt. A Zigbee2MQTT OTA-frissítéseket kínál ehhez az eszközhöz, de ezeket nem szabad alkalmazni, amíg a upstream nem ad ki biztonságos képet. Részletek a Zigbee2MQTT GitHub issue [#25207](https://github.com/Koenkk/zigbee2mqtt/issues/25207) alatt. > [!WARNING] > NE indítson OTA frissítést a TS0201-hez a Zigbee2MQTT webes felületéről. A jelenlegi kép ismerten használhatatlanná teszi az érzékelőt. ## Hibaelhárítás ### Nincsenek beérkező adatok 1. Ellenőrizze, hogy a TS0201 megjelenik-e a Zigbee2MQTT eszközlistájában nemrégi "Last seen" időbélyeggel 2. Ellenőrizze, hogy a `TS0201` egyéni változó a TapHome-ban pontosan megegyezik-e az eszköz friendly name-jével vagy IEEE címével — az egyezés kis- és nagybetű érzékeny 3. Egy MQTT klienssel (pl. MQTT Explorer) iratkozzon fel a `zigbee2mqtt/#`-re, és erősítse meg, hogy JSON payloadok érkeznek a `zigbee2mqtt/{friendly_name}`-re 4. Ellenőrizze, hogy az MQTT broker IP-címe és portja a TapHome import paraméterekben megegyezik-e a CCU-ról elérhető brokerrel ### Az eszköz offline-ként jelenik meg a Zigbee2MQTT-ben 1. A TS0201 elemes végeszköz — jelentések között alszik, hogy energiát takarítson meg. Az "offline" egyszerűen azt jelentheti, hogy az eszköz nemrég nem adott; várja meg a következő ütemezett jelentést, vagy röviden nyomja meg a reset gombot a bejelentkezés kényszerítésére. 2. Ha az eszköz soha nem kerül vissza online-ba, a Zigbee kapcsolat megszakadhatott a koordinátortól való távolság miatt. Helyezze az érzékelőt közelebb, vagy adjon hozzá egy Zigbee routert (hálózatról táplált Zigbee eszköz) a mesh hálózat bővítésére. 3. Ellenőrizze a LinkQuality attribútumot — a ~30 lqi alatti értékek gyenge jelet jeleznek. ### Elavult akkumulátor- vagy kapcsolat-minőségi értékek 1. Az akkumulátor és a feszültség csak akkor frissül, amikor az érzékelő felébred és jelentést küld — ez néhány óránként egyszer történhet 2. Ha `"-"` jelenik meg, még nem érkezett MQTT üzenet; várja meg a következő jelentést, vagy párosítsa újra az eszközt 3. Újrapárosítás után az akkumulátor akár 24 óráig is `"-"` maradhat, mielőtt az első érték publikálásra kerülne ## Elérhető eszközök 1 Ezek az eszközök az importálás után jelennek meg a TapHome-ban. Tuya TS0201 Modul Egyéni változók `TS0201` (string) = 0xa4c1388f85d9eca2 A TS0201 érzékelő Zigbee2MQTT friendly name-je vagy IEEE címe — az MQTT topic utótagjaként szolgál (zigbee2mqtt/{friendly\_name}) Open Zigbee2MQTT web UI → Devices → find the TS0201 → copy the Friendly name (or use the IEEE address, e.g. 0xa4c1388f85d9eca2) Hőmérséklet- és páraérzékelő Hőmérséklet-érzékelő Csak olvasható A hőmérséklet (°C) és a relatív páratartalom (%) a Zigbee2MQTT JSON állapot payloadból kerül elemzésre JSON Egység: °C / % json\_path Szerviz attribútumok | | | |------------------------|--------------------------------------------------------------------------------------------------------| | Akkumulátor | Fennmaradó akkumulátorszázalék (0–100 %); az első érték akár 24 órát is igénybe vehet a párosítás után | | Akkumulátor feszültség | Nyers akkumulátorfeszültség millivoltban (mV) a JSON állapot payloadból elemezve | | LinkQuality | Zigbee jelminőség-indikátor (LQI) — 0 (legrosszabb) 255-ig (legjobb) | Páratartalom olvasása ```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"); ``` Hőmérséklet olvasása ```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"); ``` Figyelő ```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 ``` Szerviz attribútumok Battery ```taphome IF(ISNAN(battery),"-",battery+"%"); ``` Battery Voltage ```taphome IF(ISNAN(voltage),"-",voltage+"mV"); ``` LinkQuality ```taphome IF(ISNAN(link),"-",link+"lqi"); ``` **Kapcsolat:** Packet Parser → MQTT Lehetséges fejlesztések (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. ## Importálási paraméterek Ezeket az értékeket az XML importálásakor adja meg. | Az alkalmazás kéri | Alapérték | |--------------------|---------------| | Mqtt Broker IP-cím | `192.168.0.1` | | Mqtt Broker port | `1883` | ## Források - 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 ## Kapcsolódó dokumentáció - [MQTT Integration](https://taphome.com/hu/compatibility/mqtt-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hu/docs/integration/packet-parser/) - [Packet parser függvények](https://taphome.com/hu/docs/script/packet-parser/) - [Elemző függvények](https://taphome.com/hu/docs/script/parsing-functions/) - [MQTT bróker](https://taphome.com/hu/docs/integration/packet-parser/mqtt-broker/) - [Listener szkriptek](https://taphome.com/hu/docs/script/listener-scripts/)