TapHome pro Modbus RTU / ASCII / TCP

TapHome může pracovat jako Modbus slave (server), takže systém řízení budovy (BMS), SCADA nebo PLC čte a ovládá zařízení TapHome přes Modbus TCP nebo přes Modbus RTU či ASCII na RS485. V části Vystavit zařízení vyberete hodnoty a akce každého zařízení, TapHome každé přidělí vlastní registr a výsledkem je mapa registrů, kterou předáte tomu, kdo nastavuje master. Takto může zařízení číst i druhý Core (propojení více Core).

Jak to funguje#

1. Na Core přidejte rozhraní Modbus a vyberte, co smí master vidět a dělat: hodnoty (teplota, úroveň žaluzií, stav spínače …) a akce (příkazy žaluzií, přepnutí …).
2. Mapa registrů vzniká průběžně s výběrem: každá hodnota dostane rozsah registrů na nejbližší volné adrese a hned za ním registr platnosti.
3. Na masteru zadá integrátor stejné registry jako body nebo tagy. Čtení vrátí aktuální hodnotu; zápis změní zařízení jako manuální změna, stejně jako v aplikaci.

Core dál řídí své moduly a smart rules; Modbus jen sdílí hodnoty a akce, které jste vybrali.

Příklad: žaluzie a termostat pro BMS#

BMS budovy čte teplotu v místnosti, nastavuje požadovanou teplotu termostatu a může zastavit žaluzie. Na Core v části Vystavit zařízení vyberte Přidat nové rozhraní → Modbus TCP a potom přidejte žaluzie a termostat. Toto je úplná konfigurace na straně TapHome — klikněte na registr nebo na Přidat zařízení a uvidíte další krok:

Modbus TCP

Informace

1

IP adresa

Parametry

2

Zařízení

Žaluzie

3

Úroveň žaluzií

Úhel lamel

4

Zastavit

Termostat

Teplota

Klikněte a otevře se okno nastavení.

5

Požadovaná teplota

6

Přidat zařízení

Požadovaná teplota

Typ registru

Index registru

Datový typ

Datový typ

Zpět

Žaluzie

Hodnoty

Úroveň žaluzií

Úhel lamel

Příkazy

Vynutit nahoru

Vynutit dolů

Zastavit

OK

1. IP adresa Core — BMS se připojuje na tuto adresu. Dejte Core pevnou adresu, například rezervací DHCP v routeru.
2. Slave ID — BMS musí posílat stejné Unit ID; požadavek s jiným dostane výjimku 0x0A.
3. Hodnota zabírá dva registry: samotnou hodnotu a za ní registr platnosti. ×100 je násobitel: úroveň žaluzií 0,55 se čte jako 55.
4. Akce má jeden registr, do kterého BMS zapisuje. Stop je coil: zápis ON zastaví žaluzie.
5. Nastavení registru — typ registru, index, datový typ, násobitel, pořadí bajtů a registr platnosti. Výchozí hodnoty obvykle vyhovují; index změňte, když BMS očekává pevné rozložení.
6. Přidat zařízení — zaškrtněte hodnoty a akce zařízení; OK je přidá na nejbližší volné adresy. Zapisovatelné hodnoty dostanou holding register (H) nebo coil (C), hodnoty jen pro čtení input register (A) nebo discrete input (D).

Na straně BMS nebo SCADA#

Master potřebuje IP adresu a port Core (nebo nastavení linky RS485), Slave ID a seznam bodů. Pro příklad výše:

 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()

# Teplota: input register 5 (hodnota × 10) a 6 (platnost, 0 = platná)
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")

# Požadovaná teplota 22,5 °C: holding register 7, zapisuje se × 10
client.write_register(7, 225, device_id=1)

# Zastavení žaluzií: zápis ON do coilu 4
client.write_coil(4, True, device_id=1)
client.close()

Master by měl číst registr platnosti spolu s hodnotou (obojí jedním požadavkem) a každý kód jiný než 0 brát jako poruchu — ztracené zařízení se pak v BMS ukáže jako porucha, ne jako zamrzlá hodnota.

Rozhraní a komunikační vlastnosti#

• Více masterů přes TCP: více rozhraní Modbus TCP může sdílet jeden port, pokud mají různá Slave ID — například jedno pro BMS a jedno pro druhý Core, každé s vlastními registry. Najednou nejvýše 10 spojení.
• RS485: rozhraní RTU nebo ASCII se spustí až po výběru svorky a jedna svorka nese jedno rozhraní.
• Slave ID je 1 až 247. Rozhraní odpovídá jen na vlastní: Modbus TCP vrátí na jiné Unit ID (i 0 nebo 255) výjimku 0x0A, RTU a ASCII na rámce pro jinou adresu neodpovídají.

Seznam rozhraní ukazuje konflikty, například stejný port a Slave ID dvakrát nebo rozhraní bez svorky.

Nastavení registru#

Detail rozhraní označí registry, jejichž rozsahy se překrývají. Překrývající se hodnota se neobsluhuje — dejte každé hodnotě vlastní rozsah včetně jejího registru platnosti.

Registr platnosti a náhradní hodnota#

Include validity register (u C a D Include validity bit) je ve výchozím stavu zapnutý. Registr jen pro čtení hned za hodnotou oznamuje masteru, zda je hodnota platná; když není, registry hodnoty místo ní vrátí Fallback value (u Float NaN s volbou Use NaN as fallback).

U C a D je bit platnosti 1, když hodnota není platná.

Akce#

• Akce bez parametrů (Stop, Toggle …) má jeden registr na H nebo C. Zápis 1 nebo více, případně coil ON, ji spustí; zápis 0 vrátí výjimku 0x03.
• Akce s parametry (přičtení k úrovni žaluzií, nastavení rozsahu …) má jeden holding register na každý parametr, jeden za druhým. Jeden zápis musí pokrýt všechny; zápis jen některých vrátí výjimku 0x03.
• Registry akcí jsou jen pro zápis — jejich čtení vrátí výjimku 0x02.

Co dostane master#

TapHome obsluhuje funkční kódy 01, 02, 03, 04, 05, 06, 15 a 16. Jeden požadavek může číst více hodnot za sebou; jinak master dostane výjimku:

Modbus TCP zavře spojení, které je 15 minut nečinné.

Aktualizace na 2026.1#

Při aktualizaci řídicí jednotky na 2026.1 se existující rozhraní Modbus slave převedou automaticky se zachováním adres registrů a Slave ID. Registr Stop žaluzie KNX, žaluzie a zařízení Roleta typu Packet parser a virtuálního zařízení Roleta se nepřevede; master, který ho používal, dostane na jeho adrese výjimku 0x02 (release notes 2026.1).

Od verze 2026.1 odpovídá Modbus TCP jen na vlastní Slave ID — pokud váš master posílá Unit ID 0 nebo 255, nastavte ho na Slave ID rozhraní.

Ladění spojení Modbus RTU#

RS485 je sdílená sběrnice, takže počítač s převodníkem USB na RS485 (například FTDI USB-RS485-WE-1800-BT) a terminálovým softwarem, jako je Terminal pro Windows, může během integrace odposlouchávat komunikaci.