TapHome do Modbus RTU / ASCII / TCP

TapHome może działać jako Modbus slave (serwer), dzięki czemu system zarządzania budynkiem (BMS), SCADA lub PLC odczytuje urządzenia TapHome i steruje nimi przez Modbus TCP albo przez Modbus RTU lub ASCII na RS485. W sekcji Uwidocznij urządzenia wybierasz wartości i akcje każdego urządzenia, TapHome przydziela każdej z nich własny rejestr, a wynikiem jest mapa rejestrów, którą przekazujesz osobie konfigurującej mastera. W ten sposób może odczytywać urządzenia także drugi Core (łączenie kilku jednostek Core).

Jak to działa#

1. Na Core dodaj interfejs Modbus i wybierz, co master może widzieć i robić: wartości (temperatura, poziom żaluzji, stan przełącznika …) i akcje (polecenia żaluzji, przełączenie …).
2. Mapa rejestrów powstaje w trakcie wybierania: każda wartość dostaje zakres rejestrów pod następnym wolnym adresem, a zaraz za nim rejestr ważności.
3. Na masterze integrator wprowadza te same rejestry jako punkty lub tagi. Odczyt zwraca aktualną wartość; zapis zmienia urządzenie jako zmiana ręczna, tak jak w aplikacji.

Core dalej steruje własnymi modułami i smart rules; Modbus udostępnia tylko wybrane przez Ciebie wartości i akcje.

Przykład: żaluzje i termostat dla BMS#

BMS budynku odczytuje temperaturę w pomieszczeniu, ustawia pożądaną temperaturę termostatu i może zatrzymać żaluzje. Na Core w sekcji Uwidocznij urządzenia wybierz Dodaj nowy interfejs → Modbus TCP, a następnie dodaj żaluzje i termostat. To pełna konfiguracja po stronie TapHome — kliknij rejestr lub Dodaj urządzenie, aby zobaczyć następny krok:

Modbus TCP

Informacja

1

Adres IP

Parametry

2

Urządzenia

Żaluzje

3

Poziom żaluzji

Kąt listew

4

Stop

Termostat

Temperatura

Kliknij, aby otworzyć okno ustawień.

5

Pożądana temperatura

6

Dodaj urządzenie

Pożądana temperatura

Rodzaj rejestru

Indeks rejestru

Typ danych

Typ danych

Cofnij

Żaluzje

Wartości

Poziom żaluzji

Kąt listew

Polecenia

Wymuś w górę

Wymuś w dół

Stop

OK

1. Adres IP Core — BMS łączy się z nim. Nadaj Core stały adres, na przykład przez rezerwację DHCP w routerze.
2. Slave ID — BMS musi wysyłać ten sam Unit ID; żądanie z innym otrzymuje wyjątek 0x0A.
3. Wartość zajmuje dwa rejestry: samą wartość i rejestr ważności za nią. ×100 to mnożnik: poziom żaluzji 0,55 jest odczytywany jako 55.
4. Akcja ma jeden rejestr, do którego BMS zapisuje. Stop to coil: zapis ON zatrzymuje żaluzje.
5. Ustawienia rejestru — typ rejestru, indeks, typ danych, mnożnik, kolejność bajtów i rejestr ważności. Wartości domyślne zwykle pasują; indeks zmień, gdy BMS oczekuje stałego układu.
6. Dodaj urządzenie — zaznacz wartości i akcje urządzenia; OK dodaje je pod następnymi wolnymi adresami. Wartości zapisywalne dostają rejestr holding (H) lub coil (C), wartości tylko do odczytu rejestr wejściowy (A) lub wejście dyskretne (D).

Po stronie BMS lub SCADA#

Master potrzebuje adresu IP i portu Core (lub ustawień linii RS485), Slave ID i listy punktów. Dla powyższego przykładu:

 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: rejestr wejściowy 5 (wartość × 10) i 6 (ważność, 0 = ważna)
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żądana temperatura 22.5 °C: rejestr holding 7, zapis × 10
client.write_register(7, 225, device_id=1)

# Zatrzymanie żaluzji: zapis ON do coil 4
client.write_coil(4, True, device_id=1)
client.close()

Master powinien odczytywać rejestr ważności razem z wartością (jednym żądaniem dla obu) i traktować każdy kod inny niż 0 jako usterkę — utracone urządzenie pojawi się wtedy w BMS jako usterka, a nie jako zamrożona wartość.

Interfejsy i właściwości komunikacyjne#

• Kilka masterów przez TCP: kilka interfejsów Modbus TCP może współdzielić jeden port, jeśli mają różne Slave ID — na przykład jeden dla BMS i jeden dla drugiego Core, każdy z własnymi rejestrami. Do 10 połączeń jednocześnie.
• RS485: interfejs RTU lub ASCII uruchamia się dopiero po wybraniu zacisku, a jeden zacisk obsługuje jeden interfejs.
• Slave ID to wartość od 1 do 247. Interfejs odpowiada tylko na własne Slave ID: Modbus TCP zwraca wyjątek 0x0A dla innego Unit ID (także 0 lub 255), RTU i ASCII nie odpowiadają na ramki dla innego adresu.

Lista interfejsów pokazuje konflikty, takie jak ten sam port i Slave ID użyte dwa razy albo interfejs bez zacisku.

Ustawienia rejestru#

Widok szczegółów interfejsu oznacza rejestry, których zakresy się nakładają. Nakładająca się wartość nie jest obsługiwana — daj każdej wartości własny zakres, łącznie z jej rejestrem ważności.

Rejestr ważności i wartość zastępcza#

Include validity register (na C i D Include validity bit) jest domyślnie włączony. Rejestr tylko do odczytu zaraz za wartością informuje mastera, czy wartość jest ważna; gdy nie jest, rejestry wartości zwracają zamiast niej Fallback value (dla Float NaN z Use NaN as fallback).

Na C i D bit ważności ma wartość 1, gdy wartość nie jest ważna.

Akcje#

• Akcja bez parametrów (Stop, Toggle …) ma jeden rejestr na H lub C. Zapis 1 lub więcej albo coil ON ją uruchamia; zapis 0 zwraca wyjątek 0x03.
• Akcja z parametrami (dodanie do poziomu żaluzji, ustawienie zakresu …) ma jeden rejestr holding na każdy parametr, jeden za drugim. Jeden zapis musi objąć wszystkie; zapis tylko części z nich zwraca wyjątek 0x03.
• Rejestry akcji są tylko do zapisu — ich odczyt zwraca wyjątek 0x02.

Co dostaje master#

TapHome obsługuje kody funkcji 01, 02, 03, 04, 05, 06, 15 i 16. Jedno żądanie może odczytać kilka kolejnych wartości; w przeciwnym razie master dostaje wyjątek:

Modbus TCP zamyka połączenie nieaktywne przez 15 minut.

Aktualizacja do 2026.1#

Przy aktualizacji jednostki sterującej do 2026.1 istniejące interfejsy Modbus slave są konwertowane automatycznie z zachowaniem adresów rejestrów i Slave ID. Rejestr Stop żaluzji KNX, żaluzji i urządzenia Markiza z Packet parsera oraz wirtualnego urządzenia Markiza nie jest konwertowany; master, który go używał, otrzyma pod jego adresem wyjątek 0x02 (Wersja 2026.1).

Od wersji 2026.1 Modbus TCP odpowiada tylko na własne Slave ID — jeśli Twój master wysyła Unit ID 0 lub 255, ustaw w nim Slave ID interfejsu.

Debugowanie połączeń Modbus RTU#

RS485 to wspólna magistrala, więc komputer z konwerterem USB–RS485 (na przykład FTDI USB-RS485-WE-1800-BT) i oprogramowaniem terminalowym, takim jak Terminal dla Windows, może podsłuchiwać komunikację podczas integracji.