---
title: "TapHome za Modbus RTU / ASCII / TCP"
description: "Povežite TapHome s BMS-om ili SCADA sustavom putem Modbusa: primjer s mapom registara na strani TapHome, popisom točaka za master i primjerom u Pythonu."
url: "https://taphome.com/hr/docs/expose-devices/modbus/"
language: hr
lastmod: 2026-11-09
generator: hugo
ai:
  topics: ["modbus-integration","expose-devices","bms-integration","modbus-tcp","rs485-communication","system-integration"]
  questions: ["Kako povezati TapHome sa sustavom BMS ili SCADA?","Kako izložiti uređaje TapHome putem Modbusa?","Kako izgleda mapa registara Modbus u sustavu TapHome?","Koju adresu registra BMS koristi za izloženu vrijednost?","Koje vrste registara i vrste podataka može koristiti izložena vrijednost?","Što vraća registar valjanosti?","Kako Modbus master pokreće radnju uređaja, na primjer naredbu za žaluzine?","Na koji Slave ID odgovara TapHome?","Zašto master dobiva Modbus iznimku 0x02 ili 0x0A?","Što se promijenilo u sučeljima Modbus slave u verziji TapHome 2026.1?"]
---

# TapHome za Modbus RTU / ASCII / TCP

TapHome kao Modbus slave za BMS, SCADA ili PLC putem Modbus TCP-a, RTU-a ili ASCII-ja: odaberite vrijednosti i radnje uređaja i predajte mapu registara.

Posljednje ažuriranje: 2026-11-09

TapHome može raditi kao Modbus slave (poslužitelj), pa sustav za upravljanje zgradom (BMS), SCADA ili PLC čita uređaje TapHome i upravlja njima putem Modbus TCP-a ili putem Modbus RTU-a ili ASCII-ja na RS-485. U odjeljku **Izložite uređaje** odabirete vrijednosti i radnje svakog uređaja, TapHome svakoj od njih dodjeljuje vlastiti registar, a rezultat je mapa registara koju predajete onome tko postavlja master. Na taj način uređaje može čitati i druga centralna jedinica Core ([povezivanje više centralnih jedinica Core](https://taphome.com/hr/docs/configuration/multiple-cores/)).

## Kako to radi

1. **Na centralnoj jedinici Core** dodajte sučelje Modbus i odaberite što master smije vidjeti i raditi: vrijednosti (temperatura, položaj žaluzine, stanje sklopke …) i radnje (naredbe za žaluzine, prebacivanje …).
2. **Mapa registara** nastaje dok odabirete: svaka vrijednost dobiva raspon registara na sljedećoj slobodnoj adresi, a odmah iza njega registar valjanosti.
3. **Na masteru** integrator unosi iste registre kao točke ili oznake (tagove). Čitanje vraća trenutačnu vrijednost; upis mijenja uređaj kao ručna promjena, kao u aplikaciji.

Centralna jedinica Core i dalje upravlja vlastitim modulima i izvodi svoje smart rules; Modbus dijeli samo vrijednosti i radnje koje ste odabrali.

## Primjer: žaluzine i termostat za BMS

BMS zgrade čita temperaturu prostorije, postavlja željenu temperaturu termostata i može zaustaviti žaluzine. Na centralnoj jedinici Core u odjeljku **Izložite uređaje** odaberite **Dodajte novo sučelje** → **Modbus TCP**, a zatim dodajte žaluzine i termostat. Ovo je cijela konfiguracija na strani TapHome — kliknite registar ili **Dodajte uređaj** da biste vidjeli sljedeći korak:



1. **IP adresa centralne jedinice Core** — na nju se spaja BMS. Centralnoj jedinici Core dodijelite fiksnu adresu, na primjer DHCP rezervacijom u usmjerivaču.
2. **Slave ID** — BMS mora slati isti Unit ID; zahtjev s drugim dobiva iznimku 0x0A.
3. **Vrijednost** zauzima dva registra: samu vrijednost i registar valjanosti iza nje. *×100* je množitelj: položaj žaluzine 0,55 čita se kao 55.
4. **Radnja** ima jedan registar u koji BMS upisuje. Stop je coil: upis ON zaustavlja žaluzine.
5. **Postavke registra** — vrsta registra, indeks, vrsta podataka, množitelj, redoslijed bajtova i registar valjanosti. Zadane vrijednosti obično odgovaraju; indeks promijenite kada BMS očekuje fiksni raspored.
6. **Dodajte uređaj** — označite vrijednosti i radnje uređaja; **OK** ih dodaje na sljedeće slobodne adrese. Vrijednosti u koje se može upisivati dobivaju holding registar (H) ili coil (C), vrijednosti samo za čitanje ulazni registar (A) ili diskretni ulaz (D).

## Na strani BMS-a ili SCADA sustava

Master treba IP adresu i port centralne jedinice Core (ili postavke linije RS-485), Slave ID i popis točaka. Za gornji primjer:

**Popis točaka**

| Točka                         | Registar TapHome | Zapis od 1 | Kod funkcije        | Vrijednost         |
|-------------------------------|------------------|------------|---------------------|--------------------|
| Položaj žaluzine              | H 0              | 40001      | 03 čitanje, 06 upis | 0–100              |
| Valjanost položaja žaluzine   | H 1              | 40002      | 03                  | 0 = valjano        |
| Kut lamela                    | H 2              | 40003      | 03 čitanje, 06 upis | 0–100              |
| Valjanost kuta lamela         | H 3              | 40004      | 03                  | 0 = valjano        |
| Zaustavljanje žaluzine        | C 4              | 00005      | 05 upis             | ON = zaustavljanje |
| Temperatura                   | A 5              | 30006      | 04                  | ÷ 10 = °C          |
| Valjanost temperature         | A 6              | 30007      | 04                  | 0 = valjano        |
| Željena temperatura           | H 7              | 40008      | 03 čitanje, 06 upis | ÷ 10 = °C          |
| Valjanost željene temperature | H 8              | 40009      | 03                  | 0 = valjano        |

Svi registri su Int16 (coil je jedan bit). H = holding registar, A = ulazni registar, C = coil.

> TapHome numerira registre od 0, onako kako se šalju u zahtjevu. Masteri koji koriste zapis od 1 (40001 za holding registar 0) imaju broj veći za jedan — pomak za jedan najčešći je uzrok čitanja pogrešne vrijednosti.



**Python (pymodbus)**

Čitanje i upis iz primjera s bibliotekom [pymodbus](https://github.com/pymodbus-dev/pymodbus) 3.16:

\```python from pymodbus.client import ModbusTcpClient client = ModbusTcpClient(&#34;192.168.1.50&#34;, port=502) client.connect() # Temperatura: ulazni registar 5 (vrijednost × 10) i 6 (valjanost, 0 = valjano) rr = client.read\_input\_registers(5, count=2, device\_id=1) value, validity = client.convert\_from\_registers(rr.registers, client.DATATYPE.INT16) if validity == 0: print(f&#34;Temperature: {value / 10} °C&#34;) # Željena temperatura 22.5 °C: holding registar 7, upisuje se × 10 client.write\_register(7, 225, device\_id=1) # Zaustavljanje žaluzine: upis ON u coil 4 client.write\_coil(4, True, device\_id=1) client.close() \`\`\`

Biblioteke za druge jezike: [NModbus4](https://github.com/NModbus4/NModbus4) (C#), [libmodbus](https://libmodbus.org) (C), [digitalpetri/modbus](https://github.com/digitalpetri/modbus) (Java), [goburrow/modbus](https://github.com/goburrow/modbus) (Go). [Simply Modbus](http://www.simplymodbus.ca/) objašnjava protokol.

Master bi trebao čitati registar valjanosti zajedno s vrijednošću (jednim zahtjevom za oboje) i svaki kod osim 0 tretirati kao kvar — izgubljeni uređaj tada se u BMS-u prikazuje kao kvar, a ne kao zamrznuta vrijednost.

## Sučelja i komunikacijska svojstva

| Sučelje | Svojstva | Zadano |
|---|---|---|
| **Modbus TCP** | **TCP port**, **Slave ID** | port 502, sljedeći slobodni Slave ID na portu |
| **Modbus RTU**, **Modbus ASCII** | stezaljka BUS 1, BUS 2 ili BUS 3, brzina prijenosa, podatkovni bitovi, paritet, stop bitovi, **Slave ID** | bez stezaljke, 9600 bauda, 8 podatkovnih bitova (ASCII 7), paritet None, 1 stop bit, Slave ID 1 |

- **Više mastera preko TCP-a:** više sučelja Modbus TCP može dijeliti jedan port ako imaju različite Slave ID-ove — na primjer jedno za BMS i jedno za drugu centralnu jedinicu Core, svako s vlastitim registrima. Do 10 veza istodobno.
- **RS-485:** sučelje RTU ili ASCII pokreće se tek nakon što odaberete stezaljku, a na jednoj stezaljki može raditi samo jedno sučelje.
- **Slave ID** je od 1 do 247. Sučelje odgovara samo na vlastiti: Modbus TCP vraća iznimku 0x0A za drugi Unit ID (i za 0 ili 255), a RTU i ASCII ne odgovaraju na okvire za drugu adresu.

Popis sučelja prikazuje sukobe, kao što su dvaput isti port i Slave ID ili sučelje bez stezaljke.

## Postavke registra

| Postavka | Vrijednosti |
|---|---|
| **Vrsta registra** | **H** holding registar, **A** ulazni registar, **C** coil, **D** diskretni ulaz. Master može upisivati samo u H i C. |
| **Indeks registra** | Od 0 do 65535, adresa u zahtjevu Modbus. |
| **Vrsta podataka** | Bool, Int16 i UInt16 zauzimaju jedan registar, Int32, UInt32 i Float dva. C i D nose samo Bool. |
| **Multiplier** | Čitanje: registar = vrijednost × množitelj. Upis: vrijednost = registar ÷ množitelj. Temperature su zadano ×10, razine i postoci ×100 (0,55 → 55). |
| **Threshold** | Umjesto množitelja za Bool na brojčanoj vrijednosti: true kada je vrijednost jednaka pragu ili veća od njega; upis true u coil postavlja vrijednost na prag, a false na 0. |
| **Endianness** | BigEndian ili LittleEndian; **Byte swap** dodatno zamjenjuje bajtove unutar svakog registra kod vrsta Int32, UInt32 i Float. |

Detalj sučelja označava registre čiji se rasponi preklapaju. Vrijednost koja se preklapa ne poslužuje se — svakoj vrijednosti dodijelite vlastiti raspon, uključujući njezin registar valjanosti.

## Registar valjanosti i zamjenska vrijednost

**Include validity register** (na C i D **Include validity bit**) zadano je uključen. Registar samo za čitanje odmah iza vrijednosti govori masteru je li vrijednost valjana; kada nije, registri vrijednosti umjesto nje vraćaju **Fallback value** (za Float NaN uz **Use NaN as fallback**).

| Kod | Značenje |
|---|---|
| 0 | valjano |
| 1 | vrijednost ne odgovara vrsti podataka (na primjer NaN u cjelobrojnoj vrsti) |
| 2 | uređaj nije dostupan ili je u pogrešci |
| 3 | postavke registra nisu valjane |
| 5 | još nema vrijednosti, na primjer odmah nakon pokretanja centralne jedinice Core |

Na C i D bit valjanosti je 1 kada vrijednost nije valjana.

## Radnje

- **Radnja bez parametara** (Stop, Toggle …) ima jedan registar na H ili C. Upis 1 ili više, ili coil ON, pokreće je; upis 0 vraća iznimku 0x03.
- **Radnja s parametrima** (dodavanje položaju žaluzine, postavljanje raspona …) ima jedan holding registar po parametru, jedan za drugim. Jedan upis mora obuhvatiti sve; upis samo nekih vraća iznimku 0x03.
- Registri radnji služe samo za upis — njihovo čitanje vraća iznimku 0x02.

## Što master dobiva

TapHome poslužuje kodove funkcija 01, 02, 03, 04, 05, 06, 15 i 16. Jedan zahtjev može pročitati više uzastopnih vrijednosti; inače master dobiva iznimku:

| Iznimka | Kada |
|---|---|
| 0x01 | nepodržani kod funkcije |
| 0x02 | adresa koja nije dodijeljena nijednoj vrijednosti, raspon s prazninom, upis u A ili D, čitanje registra radnje, upis u registar valjanosti |
| 0x03 | vrijednost koju uređaj ne može prihvatiti ili nevaljan upis radnje; upis više vrijednosti izvodi se u cijelosti ili nikako |
| 0x04 | uređaj je odbio upis |
| 0x0A | Modbus TCP: Slave ID (Unit ID) različit od Slave ID-a sučelja |

Modbus TCP zatvara vezu koja je neaktivna 15 minuta.

## Ažuriranje na 2026.1

> [!WARNING]
> Pri ažuriranju centralne jedinice na 2026.1 postojeća sučelja Modbus slave automatski se pretvaraju uz zadržavanje adresa registara i Slave ID-a. Registar Stop KNX žaluzine, žaluzine iz Packet parsera i uređaja **Tenda** te virtualnog uređaja **Tenda** ne pretvara se; master koji ga je koristio na njegovoj adresi dobiva iznimku 0x02 ([napomene uz izdanje 2026.1](https://taphome.com/hr/docs/release-notes/2026-1/#expose-devices)).

Od verzije 2026.1 Modbus TCP odgovara samo na vlastiti Slave ID — ako vaš master šalje Unit ID 0 ili 255, postavite ga na Slave ID sučelja.

## Otklanjanje pogrešaka u vezama Modbus RTU

RS-485 je zajednička sabirnica, pa računalo s pretvaračem USB na RS-485 (na primjer [FTDI USB-RS485-WE-1800-BT](https://ftdichip.com/products/usb-rs485-we-1800-bt/)) i terminalskim softverom, kao što je [Terminal](http://www.der-hammer.info/terminal/) za Windows, može pratiti komunikaciju tijekom povezivanja.
