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:
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).
Kako to radi
- 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 …).
- Mapa registara nastaje dok odabirete: svaka vrijednost dobiva raspon registara na sljedećoj slobodnoj adresi, a odmah iza njega registar valjanosti.
- 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:
- IP adresa centralne jedinice Core — na nju se spaja BMS. Centralnoj jedinici Core dodijelite fiksnu adresu, na primjer DHCP rezervacijom u usmjerivaču.
- Slave ID — BMS mora slati isti Unit ID; zahtjev s drugim dobiva iznimku 0x0A.
- Vrijednost zauzima dva registra: samu vrijednost i registar valjanosti iza nje. ×100 je množitelj: položaj žaluzine 0,55 čita se kao 55.
- Radnja ima jedan registar u koji BMS upisuje. Stop je coil: upis ON zaustavlja žaluzine.
- 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.
- 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:
| 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.
Čitanje i upis iz primjera s bibliotekom pymodbus 3.16:
| |
Biblioteke za druge jezike: NModbus4 (C#), libmodbus (C), digitalpetri/modbus (Java), goburrow/modbus (Go). Simply Modbus 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
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).
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) i terminalskim softverom, kao što je Terminal za Windows, može pratiti komunikaciju tijekom povezivanja.