---
title: "Zhong Sheng (XY) Temperature, Humidity, Barometer"
description: "Praćenje temperature, vlažnosti i atmosferskog tlaka preko Modbus TCP-a putem RS-485 pristupnika. Predložak TapHome za senzor Zhong Sheng (XY) 3 u 1."
url: "https://taphome.com/hr/compatibility/zhong-sheng-xy-temperature-humidity-barometer/"
language: hr
lastmod: 2026-10-08
generator: hugo
ai:
  topics: ["modbus-tcp","sensor","rs485","ethernet-to-rs485-gateway","temperature","humidity","barometric-pressure"]
  questions: ["Kako integrirati senzor temperature, vlage i tlaka Zhong Sheng (XY) sa sustavom TapHome?","Što mjeri predložak TapHome za Zhong Sheng (XY)?","Kako spojiti RS-485 Modbus senzor sa sustavom TapHome preko Modbus TCP-a?","Kako podesiti kalibracijske pomake CORBAR, CORH i CORTE?","Zašto očitanje vlažnosti senzora XY izgleda pogrešno?","Kako pri uvozu predloška senzora XY postaviti Slave ID i IP adresu?"]
---

# Zhong Sheng (XY) Temperature, Humidity, Barometer

Komunikacija: Modbus TCP

> Adresa u mreži
> 
> TapHome komunicira s uređajem na adresi unesenoj pri uvozu. Dodijelite uređaju stalnu adresu — rezervaciju IP adrese u usmjerivaču ili njegovo mDNS ime ako ga podržava — inače integracija prestaje raditi kada usmjerivač promijeni adresu.
> 
> [Priprema mreže](https://taphome.com/hr/docs/setup/network-preparation/)

## Upute za integraciju

Zhong Sheng (XY) Temperature, Humidity, Barometer kineski je RS-485 Modbus senzor „tri u jednom” koji mjeri temperaturu okoline, relativnu vlažnost i atmosferski tlak. Pripada istoj OEM obitelji kao poznati pretvornik temperature i vlage XY-MD02, proširen čipom za tlak klase BMP, ali s nestandardnim rasporedom registara svojstvenim upravo ovoj inačici pod drugom markom.

Predložak TapHome spaja se sa senzorom preko **Modbus TCP-a** putem pristupnika (gateway) Ethernet-RS-485, a ne izravno. Pristupnik povezuje centralnu jedinicu TapHome Core (lokalna mreža) sa sabirnicom RS-485 na kojoj je senzor s podesivim Slave ID-om. Prikazuju se tri očitanja (temperatura, relativna vlažnost i atmosferski tlak), a svakom se dodaje kalibracijski pomak koji se zadaje za svaku ugradnju posebno (`CORTE`, `CORH`, `CORBAR`).

## Hardversko spajanje

Senzor je Modbus RTU uređaj na sabirnici RS-485. Centralna jedinica TapHome Core s njim komunicira preko mreže putem pristupnika Ethernet-RS-485 (prikladan je svaki standardni pristupnik Modbus TCP ↔ RTU, npr. USR-TCP232, Waveshare ili istovrijedan pretvornik za DIN šinu).

```
┌─────────────┐            ┌───────────────────────┐            ┌──────────────────┐
│ TapHome Core│  Ethernet  │ Ethernet ↔ RS-485     │  RS-485    │ XY sensor        │
│             │ ─────────▶ │ gateway (TCP port 502)│ ─────────▶ │ (Slave ID 1)     │
└─────────────┘            └───────────────────────┘            └──────────────────┘
```

### Ožičenje RS-485

![Oznake boja RS-485 kabela na hladno prešanim stopicama](https://taphome.com/images/compatibility/zhong-sheng-xy-temperature-humidity-barometer/wiring-colors_hu_7886737ce4197a69.jpg)

Senzor ima kabel s četiri žice i hladno prešanim stopicama, s rasporedom prema referentnom senzoru Seeed S-THP-01A (raspored izvoda isti je kao kod većine senzora serije XY):

| Boja žice | Funkcija |
|------------|----------|
| Crvena | V+ (napajanje, 4,5–18 V DC) |
| Crna | GND (zajednička masa napajanja i signala) |
| Žuta | RS-485 A+ |
| Bijela | RS-485 B− |

`A+` i `B−` spojite na odgovarajuće stezaljke pristupnika Ethernet-RS-485, a GND neka bude zajednički za senzor, njegovo napajanje i pristupnik kako biste izbjegli probleme sa zajedničkim (common-mode) naponom.

![Ožičenje RS-485 do pristupnika Ethernet-RS-485 (primjer DataLogger)](https://taphome.com/images/compatibility/zhong-sheng-xy-temperature-humidity-barometer/wiring-datalogger_hu_930ef3cb93c605e5.jpg)

> [!WARNING]
> Boje žica mogu se malo razlikovati između serija OEM proizvodnje. Prije uključivanja napajanja uvijek ih provjerite prema oznaci na kabelu. Zamijenjeni polovi napajanja neće oštetiti senzor (ima zaštitu od obrnutog polariteta), ali senzor jednostavno neće odgovarati.

> [!TIP]
> Za sabirnice dulje od ~100 m za `A+` / `B−` koristite upredenu paricu i na udaljeni kraj voda dodajte zaključni otpornik od 120 Ω. Svi senzori neka imaju istu referentnu masu (GND).

## Uključivanje Modbus komunikacije

Nema izbornika ni DIP prekidača: senzor dolazi s tvornički uključenim Modbus RTU. Integracija se svodi na ožičenje sabirnice RS-485, konfiguraciju pristupnika i unos dviju vrijednosti pri uvozu u TapHome.

### Serijski parametri RS-485 (tvorničke postavke)

Serija XY i referentni Seeed S-THP-01A iz tvornice izlaze s istim serijskim postavkama. Predložak TapHome pretpostavlja ove zadane vrijednosti:

| Postavka | Vrijednost |
|---------|-------|
| Brzina prijenosa (baud rate) | **9600 bps** |
| Podatkovni bitovi | 8 |
| Paritet | nema |
| Stop bitovi | 1 |
| Adresa slave uređaja | **1** |

Brzina prijenosa i adresa slave uređaja mogu se softverski promijeniti preko holding registara na samom senzoru (vidi korisnički priručnik za Seeed S-THP-01A, registri `0x0200` / `0x0201`, ili tehnički list XY-MD02). Predložak TapHome namjerno ne prikazuje te registre jer bi njihova promjena iz sustava TapHome prekinula aktivnu vezu.

### Konfiguracija pristupnika

Pristupnik Ethernet-RS-485 konfigurirajte kao **Modbus TCP slave** (poslužitelj) na **TCP portu 502** koji prosljeđuje na sabirnicu RS-485 s postavkama **9600, 8-N-1**. Dodijelite mu statičku IP adresu (ili DHCP rezervaciju) kako se ne bi promijenila nakon isključivanja i ponovnog uključivanja napajanja.

> [!TIP]
> Ako pristupnik podržava više preslikavanja slave uređaja, ostavite ovaj senzor na Slave ID 1. To je jednostavnije od mijenjanja adrese senzora i odgovara zadanoj vrijednosti predloška.

### Parametri uvoza u TapHome

Pri uvozu predloška u TapHome unesite dvije vrijednosti:

| Parametar | Zadano | Opis |
|-----------|---------|-------------|
| **IP adresa** | `192.168.1.0` (zamjenska vrijednost) | Unesite stvarnu IP adresu pristupnika Ethernet-RS-485 u lokalnoj mreži |
| **Slave ID** | `1` | Modbus adresa senzora na sabirnici RS-485 |

### Varijable modula — kalibracijski pomaci

Nakon uvoza u **TapHome → Varijable modula** dostupne su tri varijable na razini modula za kalibraciju pojedine ugradnje. Dodaju se svakom neobrađenom očitanju:

| Varijabla | Zadano | Jedinica | Namjena |
|----------|---------|------|---------|
| `CORTE` | `0.5` | °C | Pomak temperature koji se dodaje svakom neobrađenom očitanju temperature |
| `CORH` | `0.01` | %RH | Pomak vlažnosti koji se dodaje svakom neobrađenom očitanju vlažnosti |
| `CORBAR` | `17` | hPa | Pomak atmosferskog tlaka koji se dodaje svakom neobrađenom očitanju tlaka |

> [!WARNING]
> **`CORBAR = 17` je korekcija za nadmorsku visinu određene lokacije i mora se ponovno podesiti za svaku ugradnju.** Ako ostane na tvorničkoj vrijednosti, svako očitanje tlaka bit će pomaknuto za **+17 hPa** u odnosu na stvarni lokalni atmosferski tlak. Počnite s `CORBAR = 0` i podesite ga prema poznatom referentnom barometru na nadmorskoj visini ugradnje. Jednako tako provjerite `CORTE` i `CORH` prema referentnom termometru / higrometru postavljenom uz senzor.

## Mogućnosti uređaja

Predložak daje tri senzorska uređaja samo za čitanje, a svi čitaju holding registre preko pristupnika:

### Temperatura

Temperatura zraka iz ugrađenog čipa obitelji SHT čita se iz `H:0` (`uInt16`) i preračunava kao `raw / 10 + CORTE`. Prikazuje se u °C s razlučivošću 0,1 °C i tipičnom točnošću ±0,5 °C.

### Relativna vlažnost

Relativna vlažnost iz istog čipa obitelji SHT čita se iz `H:1` (`uInt16`) i preračunava kao `raw × 0.001 + CORH`. Prikazuje se u %RH.

> [!WARNING]
> **Faktor preračunavanja vlažnosti je sumnjiv.** Množitelj `×0.001` značio bi da neobrađeni registar pri 100 %RH sadrži ≈ 100 000, što premašuje 16-bitni registar (najviše 65 535). Referentni XY-MD02 koristi `/10`, a Seeed S-THP-01A `/100`. Najvjerojatnije je ispravna formula `raw / 10`, u skladu s konvencijom XY-MD02. Prije nego što se pouzdate u očitanja, provjerite ih na stvarnom uređaju. Ako je javljena vlažnost ograničena na rubnu vrijednost ili potpuno izvan raspona, prilagodite predložak ili koristite drugu inačicu XY.

### Atmosferski tlak

Atmosferski tlak iz ugrađenog čipa klase BMP čita se iz `H:4` kao 32-bitni cijeli broj bez predznaka (preko `H:4`–`H:5`) i preračunava kao `raw / 100 + CORBAR`. Prikazuje se u hPa s razlučivošću 0,1 hPa.

> [!TIP]
> Interval očitavanja barometra na razini uređaja u XML predlošku iznosi **1 000 ms**, što je previše često jer se atmosferski tlak mijenja u minutama, a ne u sekundama. Nakon uvoza povećajte interval očitavanja barometra u **TapHome → Varijable uređaja** na **15 000–30 000 ms** kako biste smanjili opterećenje sabirnice bez gubitka korisne razlučivosti. Interval očitavanja na razini modula (30 000 ms) koji već koriste temperatura i vlažnost dobra je početna vrijednost i za barometar.

## Pregled registara

| Registar | Parametar | Tip podatka | Skaliranje / pomak | Jedinica | Interval očitavanja |
|----------|-----------|-----------|----------------|------|---------------|
| `H:0` | Temperatura | `uInt16` | `/ 10 + CORTE (0.5)` | °C | 30 000 ms (razina modula) |
| `H:1` | Vlažnost | `uInt16` | `× 0.001 + CORH (0.01)`, provjeriti | %RH | 30 000 ms (razina modula) |
| `H:4`–`H:5` | Atmosferski tlak | `uInt32` | `/ 100 + CORBAR (17)` | hPa | 1 000 ms (previše često) |

> [!NOTE]
> Neobrađeni tip podatka `uInt16` ne može izravno prikazati negativne vrijednosti. Na stvarnom hardveru XY-MD02 temperature ispod nule stižu kao cijeli brojevi s predznakom zapisani dvojnim komplementom. Ako je senzor ugrađen u okruženju u kojem temperatura redovito pada ispod 0 °C, prije oslanjanja na negativne temperature provjerite dekodiraju li se ispravno.

## Rješavanje problema

### Nakon uvoza nema očitanja

1. Pingajte IP adresu pristupnika iz iste podmreže u kojoj je centralna jedinica TapHome Core. Ako ne odgovara, problem je u lokalnoj mreži ili napajanju, a ne u Modbusu.
2. Provjerite je li pristupnik konfiguriran kao Modbus TCP poslužitelj na **portu 502**, a ne kao transparentni TCP most.
3. Provjerite odgovaraju li serijske postavke RS-485 na pristupniku vrijednostima **9600, 8-N-1**. Ako se ne podudaraju, zahtjevi bez upozorenja istječu (timeout) i nema očitanja.
4. Provjerite odgovara li Slave ID senzora vrijednosti unesenoj pri uvozu u TapHome (zadano `1`). Drugi senzor na istoj sabirnici s istom adresom izazvat će sukob.
5. Pregledajte ožičenje RS-485: `A+` na `A+`, `B−` na `B−`, zajednička masa (GND) za senzor, napajanje i pristupnik.

### Neuvjerljive vrijednosti vlažnosti

XML predložak koristi množitelj vlažnosti `× 0.001`, što nije u skladu s obitelji XY-MD02 (`/10`) ni s referentnim Seeed S-THP-01A (`/100`). Ako očitanje vlažnosti ostaje blizu nule ili nikada ne doseže uvjerljive vrijednosti, neobrađeni registar vjerojatno koristi konvenciju XY-MD02. Usporedite neobrađenu vrijednost registra alatom za otklanjanje pogrešaka Modbusa (npr. qModbus) s referentnim higrometrom. Ako neobrađene vrijednosti oko 500 odgovaraju ~50 %RH, formula treba biti `/10` i predložak treba ispraviti.

### Očitanje tlaka pomaknuto za ~17 hPa

Zadana vrijednost predloška `CORBAR = 17` naslijeđena je korekcija za nadmorsku visinu određene lokacije. Ako tlak stalno pokazuje ~17 hPa više od obližnjeg referentnog barometra (npr. meteorološke postaje), u **TapHome → Varijable modula** postavite `CORBAR` na `0` i podesite ga prema referentnoj vrijednosti.

### Veliko opterećenje sabirnice / pogreške komunikacije

Povećajte interval očitavanja barometra s 1 000 ms na 15 000–30 000 ms u **TapHome → Varijable uređaja**. Očitavanje frekvencijom 1 Hz na zajedničkoj sabirnici RS-485 ostavlja malo propusnosti za druge slave uređaje i barometru ne donosi nikakvu korist.

### Negativna temperatura prikazuje se kao golem pozitivan broj

Predložak čita temperaturu kao `uInt16`. Stvarni hardver XY negativne temperature vraća kao cijele brojeve s predznakom zapisane dvojnim komplementom: neobrađena vrijednost `0xFF33` (≈ 65 331) dekodirana bez predznaka postaje ≈ 6533,1 °C, a trebala bi se dekodirati kao −20,5 °C. Ako je senzor ugrađen u okruženju u kojem temperatura može pasti ispod 0 °C, provjerite ponašanje na stvarnom hardveru i prije oslanjanja na očitanja ispod nule razmislite o zamjeni predloška inačicom s tipom `Int16` s predznakom.

## Dostupni uređaji 3

Ovi se uređaji pojavljuju u TapHomeu nakon uvoza.

Temperatura, vlažnost, barometar Modul

Prilagođene varijable

`CORBAR` (numeric) = 17 Pomak atmosferskog tlaka u hPa koji se dodaje svakom neobrađenom očitanju barometra — služi kao korekcija za nadmorsku visinu / referentnu razinu određene lokacije

Adjust in TapHome → Module Variables after import. Start with 0 and tune against a known reference barometer at the installation altitude; +17 hPa is a legacy site-specific default and will bias pressure readings if left unchanged.

`CORH` (numeric) = 0.01 Pomak relativne vlažnosti u %RH koji se dodaje svakom neobrađenom očitanju vlažnosti — služi za kompenzaciju pomaka očitanja pojedinog senzora tijekom vremena

Adjust in TapHome → Module Variables after import. Typical factory calibration is within ±3 %RH; tune against a reference hygrometer.

`CORTE` (numeric) = 0.5 Pomak temperature u °C koji se dodaje svakom neobrađenom očitanju temperature — služi za kompenzaciju pomaka očitanja pojedinog senzora tijekom vremena

Adjust in TapHome → Module Variables after import. Tune against a reference thermometer placed next to the sensor.

Atmosferski tlak Varijabla Samo za čitanje

Atmosferski tlak u hPa iz ugrađenog čipa klase BMP, uz primijenjen pomak CORBAR zadan za ovu ugradnju

Registar: H:4 uInt32 Jedinica: hPa

Čitanje

```taphome
MODBUSR(H, 4, uInt32)/100 + CORBAR
```

Temperatura Varijabla Samo za čitanje

Temperatura okolnog zraka u °C iz ugrađenog senzora obitelji SHT, uz primijenjen pomak CORTE zadan za ovu ugradnju

Registar: H:0 uInt16 Jedinica: °C

Čitanje

```taphome
MODBUSR(H, 0, uInt16)/10 + CORTE
```

Relativna vlažnost Varijabla Samo za čitanje

Relativna vlažnost u %RH iz ugrađenog senzora obitelji SHT, uz primijenjen pomak CORH zadan za ovu ugradnju

Registar: H:1 uInt16 Jedinica: %RH

Čitanje

```taphome
MODBUSR(H, 1, uInt16)*0.001 + CORH
```

**Povezivanje:** Modbus TCP • Slave ID: $\[SlaveId]

Moguća poboljšanja (10)

- H:2 Dew Point — INT16 /100, °C — commonly exposed by SHT-family chips alongside temperature and humidity; not read by the current TapHome template.
- H:3 Atmospheric Pressure (INT16 variant) — INT16 /10, hPa — alternative lower-resolution pressure register present on sister devices; this template uses the 32-bit variant at H:4 instead.
- H:4 (frost point) Frost Point — INT16 /100, °C — useful for condensation prevention; register overlap with this template's barometer variant means it would only be available on firmware variants without the packed 32-bit pressure register.
- H:5 (vapor pressure) Vapor Pressure / Wet Bulb / Vapor Concentration — Reference devices expose vapor pressure (/10, hPa), vapor concentration (/10, g/m³) and related psychrometric values; not known to be available on this specific Zhong Sheng (XY) rebrand.
- H:0x0020 Temperature Unit Selector — UINT16 RW, 0=°C / 1=°F — configuration register for switching display units; not typically needed when the template fixes °C.
- H:0x0200 Slave Address (writable) — UINT16 RW, 0..255 — would allow changing the Modbus slave ID from TapHome; intentionally left out because mis-writing it would break the connection.
- H:0x0201 Baud Rate (writable) — UINT16 RW, 0..5 mapping to standard baud rates — same rationale as slave address: unsafe to expose in a user-editable template.
- H:0x1000 Temperature (IEEE Float variant) — 32-bit IEEE float temperature at offset 0x1000; this template reads the cheaper uInt16 ×0.1 variant at H:0 instead.
- H:0x1002 Humidity (IEEE Float variant) — 32-bit IEEE float humidity at offset 0x1002; this template reads the uInt16 variant at H:1 instead — consider switching to float if the uInt16 scaling proves wrong on real hardware.
- H:0x1006 Atmospheric Pressure (IEEE Float variant) — 32-bit IEEE float pressure at offset 0x1006; alternative to the packed uInt32 this template uses at H:4.

## Parametri uvoza

Ove vrijednosti unosite pri uvozu XML-a.

| Pitanje u aplikaciji | Zadano        |
|----------------------|---------------|
| Slave Id             | `1`           |
| IP address           | `192.168.1.0` |

## Izvori

- Seeed S-THP-01A — Air Temp/Humidity/Barometric Pressure Sensor User Guide
  
  [files.seeedstudio.com](https://files.seeedstudio.com/products/101991101/Air%20Temperature%20%26%20Humidity%20%26%20Barometric%20Sensor%20User%20Guide%20v1.0.pdf) 2026-04-22
  
  [PDF](https://taphome.com/compatibility/devices/zhong-sheng-xy-temperature-humidity-barometer/manufacturer/s-thp-01a-user-guide.pdf)
- XY-MD01 / XY-MD02 — Modbus RTU RS485 SHT20 Temperature / Humidity Transmitter Datasheet
  
  [www.hestore.hu](https://www.hestore.hu/prod_getfile.php?id=18062) 2026-04-22
  
  [PDF](https://taphome.com/compatibility/devices/zhong-sheng-xy-temperature-humidity-barometer/manufacturer/xy-md02-datasheet.pdf)
- Home Assistant — Modbus Integration (YAML reference)
  
  [www.home-assistant.io](https://www.home-assistant.io/integrations/modbus/) 2026-04-22

Dokumenti proizvođača zaštićeni su autorskim pravom (©) svojih vlasnika. Dostupni su onako kako ih je proizvođač objavio, samo za informaciju.

## Povezana dokumentacija

- [Modbus Integration](https://taphome.com/hr/compatibility/modbus-guide/)
- [Modbus](https://taphome.com/hr/docs/integration/modbus/)
- [Jednostavna konfiguracija pomoću predložaka](https://taphome.com/hr/docs/integration/modbus/templates/)
- [Skripte Modbus i prefetch](https://taphome.com/hr/docs/script/modbus-scripts/)
- [Funkcije Modbus](https://taphome.com/hr/docs/script/modbus/)
- [Tipovi podataka Modbus](https://taphome.com/hr/docs/script/modbus-data-types/)

