TapHome

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

  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:

Modbus TCP
Informacije
1
IP adresa
Parametri
2
Uređaji
Žaluzine
3
Razina žaluzina
Kut lamela
4
Stop
Termostat
Temperatura
5
Željena temperatura
6
Dodajte uređaj
Željena temperatura
Vrsta registra
Indeks registra
Vrsta podataka
Vrsta podataka
Natrag
Žaluzine
Vrijednosti
Naredbe
OK
  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:

TočkaRegistar TapHomeZapis od 1Kod funkcijeVrijednost
Položaj žaluzineH 04000103 čitanje, 06 upis0–100
Valjanost položaja žaluzineH 140002030 = valjano
Kut lamelaH 24000303 čitanje, 06 upis0–100
Valjanost kuta lamelaH 340004030 = valjano
Zaustavljanje žaluzineC 40000505 upisON = zaustavljanje
TemperaturaA 53000604÷ 10 = °C
Valjanost temperatureA 630007040 = valjano
Željena temperaturaH 74000803 čitanje, 06 upis÷ 10 = °C
Valjanost željene temperatureH 840009030 = 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:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
from pymodbus.client import ModbusTcpClient

client = ModbusTcpClient("192.168.1.50", 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"Temperature: {value / 10} °C")

# Ž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 (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čeljeSvojstvaZadano
Modbus TCPTCP port, Slave IDport 502, sljedeći slobodni Slave ID na portu
Modbus RTU, Modbus ASCIIstezaljka BUS 1, BUS 2 ili BUS 3, brzina prijenosa, podatkovni bitovi, paritet, stop bitovi, Slave IDbez 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

PostavkaVrijednosti
Vrsta registraH holding registar, A ulazni registar, C coil, D diskretni ulaz. Master može upisivati samo u H i C.
Indeks registraOd 0 do 65535, adresa u zahtjevu Modbus.
Vrsta podatakaBool, 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).
ThresholdUmjesto 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.
EndiannessBigEndian 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).

KodZnačenje
0valjano
1vrijednost ne odgovara vrsti podataka (na primjer NaN u cjelobrojnoj vrsti)
2uređaj nije dostupan ili je u pogrešci
3postavke registra nisu valjane
5još 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:

IznimkaKada
0x01nepodržani kod funkcije
0x02adresa koja nije dodijeljena nijednoj vrijednosti, raspon s prazninom, upis u A ili D, čitanje registra radnje, upis u registar valjanosti
0x03vrijednost koju uređaj ne može prihvatiti ili nevaljan upis radnje; upis više vrijednosti izvodi se u cijelosti ili nikako
0x04uređaj je odbio upis
0x0AModbus 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.