Sie sind auf Seite 1von 48

Helios Ventilatoren

FUNKTIONS- UND SCHNITTSTELLENBESCHREIBUNG NR. 82 269 D

Gebäudeleittechnik-Schnittstelle

Modbus Gateway TCP/IP mit


DEUTSCH
Helios Ventilatoren
FUNKTIONS- UND SCHNITTSTELLENBESCHREIBUNG

Inhaltsverzeichnis
KAPITEL 1. ALLGEMEINE INFORMATIONEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Seite 1
1.0 Allgemeine Informationen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Seite 1
1.1 Warn- und Sicherheitshinweise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Seite 1
1.2 Systemvoraussetzungen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Seite 1
1.3 Die Modbus-Schnittstelle (allgemein) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Seite 1
1.4 Modbus Simulation – Programme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Seite 1

KAPITEL 2. MODBUS MIT MODPOLL.EXE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Seite 2


2.0 Beispiel mit dem Modbus-Simulator modpoll.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Seite 2
2.1 Schreiben von Variablen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Seite 2
1. Beispiel – Schreiben der Variable v0003 Systemsprache – Französisch . . . . . . . . . . . . . . . . . . . . . . . . . .Seite 3
2. Beispiel – Schreiben der Variable v00004 Datum – 11.12.2013 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Seite 3
2.2 Auslesen von Variablen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Seite 4
1. Beispiel – Auslesen der Variable v00004 Datum – 11.12.2013 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Seite 4
2. Beispiel – Auslesen des Temperaturfühlers Außenluft . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Seite 5
2.3 Auslesen einer falschen Anzahl von Registern . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Seite 5

KAPITEL 3. MODBUS MIT MODBUSPOLL.EXE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Seite 6


3.0 Beispiel mit dem Windows-Programm modbuspoll.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Seite 6
3.1 Schreiben von Variablen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Seite 6
1. Beispiel – Schreiben der Variable v00004 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Seite 6
3.2 Auslesen von Variablen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Seite 7
1. Beispiel – Auslesen der Variable v00004 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Seite 7
2. Beispiel – Auslesen der Variable v00104 – Temperatur Ausßenluft . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Seite 8

KAPITEL 4. VARIABLEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Seite 9


4.0 Variablenliste . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Seite 9

KAPITEL 5. SONSTIGES / HINWEISE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Seite 19


5.0 Sonstiges / Hinweise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Seite 19
Funktionsbeschreibung
Modbus Gateway TCP/IP – easyControls

D
1.0 Allgemeine Informationen
KAPITEL 1
Zur Sicherstellung einer einwandfreien Funktion und zur eigenen Sicherheit sind alle nachstehenden Vorschriften genau
ALLGEMEINE
durchzulesen und zu beachten. National einschlägigen Normen, Sicherheitsbestimmungen und Vorschriften (z.B. DIN
INFORMATIONEN EN VDE 0100) sowie die TAB des EVUs sind unbedingt zu beachten und anzuwenden.

 1.1 Warn- und Sicherheitshinweise


Nebenstehendes Symbol ist ein sicherheitstechnischer Warnhinweis. Alle Sicherheitsvorschriften bzw. Symbole
müssen unbedingt beachtet werden, damit jegliche Gefahrensituation vermieden wird.

1.2 Systemvoraussetzungen
WICHTIG ☞ Die Software-Version der Gerätesteuerung muss mindestens auf Version 2.01 aktualisiert werden (s. Abb. unten).
Falls auf dem KWL-Gerät eine ältere Versionsnummer installiert ist, muss das Gerät online im Menü „ Erstinbetrieb-
nahme” über die Schaltfläche „ Software jetzt aktualisieren“ mit dem neuesten Firmwareupdate versorgt werden.
Die entsprechenden Einstellungen werden im Menü "Netzwerk einrichten" vorgenommen und sind im Anwender-Hand-
buch zu EasyControls (Nr. 82 200) beschrieben.

1.3 Die Modbus-Schnittstelle (allgemein)


Die Kommunikation der KWL-Steuerung über Modbus erfolgt über das Protokoll Modbus TCP/IP.
Hierzu wird der TCP/IP-Port 502 genutzt.
WICHTIG ☞ Es ist immer die Modbus-Adresse 180 zu verwenden!

Lese- und Schreibfunktionen unterstützen ausschließlich die Holding-Register. Zugriffsversuche auf andere Register
führen zu einer Fehlermeldung (ILLEGAL_DATA_ADDRESS).
Beim Lesen und Schreiben ist die Startadresse immer die Registeradresse 1.
Jeder Schreib- und Lesezugriff auf ein Register erfolgt mit Hexadezimal-Schreibweise und wird mit dem ASCII-Zeichen
„ NUL” (0x00) abgeschlossen.
Für den Lesezugriff ist erforderlich, dass die richtige Anzahl der zu lesenden Register (Count) in dem Lesebefehl ent-
halten ist.
Die Anzahl wird wie folgt ermittelt:

Anzahl der ASCII-Zeichen + Nullterminierung dividiert durch 2 (aufgerundet)

1.4 Modbus Simulation – Programme


Zur Simulation der Modbus-Befehle stehen im Internet folgende Programme zur Verfügung:

a) Das Programm modpoll, als kostenloses Kommandozeilen-Programm, welches in einer DOSBox unter Windows
ausgeführt wird.
--> Download unter: http://www.modbusdriver.com/modpoll.html

b) Das Windows-Programm Modbus Poll, das als Testversion verwendet werden kann,
--> Download unter: http://www.modbustools.com/modbus_poll.asp.

Des Weiteren sind die Modbus-Demoprogramme auch auf der Helios Internetseite erhältlich:

L IN K http://www.easycontrols.net ➞ Download

1
Funktionsbeschreibung
Modbus Gateway TCP/IP – easyControls

D
2.0 Beispiel mit dem Modbus-Simulator modpoll.exe
KAPITEL 2 Die nachfolgend beschriebenen Beispiele (Seite 3) wurden mit dem Programm „modpoll.exe” in einer DOSBox unter
Windows durchgeführt.
MOBBUS MIT
Der Aufruf im DOS-Fenster erfolgt nach folgendem Prinzip:
MODPOLL.EXE
modpoll.exe -m tcp -a [Modbusadresse] -t4:hex -r 1 -0 -1 -o 2.0 [ip-adresse] [Variablennummer „ vXXXXX\0" als HEX-
Zeichen codiert in 16 bit hex-Blöcken]

Folgende Parameter (siehe Tabelle) werden von modpoll.exe verwendet:

WICHTIG ☞ Aufruf: modpoll.exe [options] [host-IP] [Befehl]

Befehl Bedeutungen
-m tcp Definition des Modbus-Protokolls TCP/IP
-a # Adresse des anzusteuernden KWL-Gerätes (1-255, Vorgabe ist 1)
-r # Start-Register (1-65536, Vorgabe ist 100)
-c Anzahl der Registerwerte je Aufruf (1.100, Vorgabe ist 1)
-t4:hex 16-bit Rückgabe der Holding-Register. Daten werden als HEX-Wert angezeigt
-1 (Zahl 1) Aufruf nur einmal, sonst wird der Befehl jede Sekunde gesendet
-0 (Zahl 0) Die erste Referenz ist auf der Stelle 0 (PDU Adressdefinition) anstatt 1
-o # Time-Out in Sekunden (0.01 – 10.0) Vorgabe ist 1.0 Sekunden

2.1 Schreiben von Variablen


Beim Schreiben per Modbus werden die Variablen im Format „ VXXXXX=YYYYY...\0" als HEX-Zeichen codiert.
Die Registerstartadresse ist dabei immer 1.

Vergleichstabelle Wandlung HEX und ASCII


Die am häuftigsten benötigten Werte sind nachstehend zu finden:

HEX ASCII HEX ASCII HEX ASCII HEX ASCII


0x2E . 0x45 E 0x55 U 0x6B k
0x30 0 0x46 F 0x56 V 0x6C l
0x31 1 0x47 G 0x57 W 0x6D m
0x32 2 0x48 H 0x58 X 0x6E n
0x33 3 0x49 I 0x59 Y 0x6F o
0x34 4 0x4A J 0x5A Z 0x70 p
0x35 5 0x4B K 0x61 a 0x71 q
0x36 6 0x4C L 0x62 b 0x72 r
0x37 7 0x4D M 0x63 c 0x73 s
0x38 8 0x4E N 0x64 d 0x74 t
0x39 9 0x4F O 0x65 e 0x75 u
0x3D = 0x50 P 0x66 f 0x76 v
0x41 A 0x51 Q 0x67 g 0x77 w
0x42 B 0x52 R 0x68 h 0x78 x
0x43 C 0x53 S 0x69 i 0x79 y
0x44 D 0x54 T 0x6A j 0x7A z

2
Funktionsbeschreibung
Modbus Gateway TCP/IP – easyControls

D
Beispiel 1:
BEISPIEL ☞ Umwandlung der Variable v00102 von ASCII in HEX: “v00102=4” + Ende-Terminierung (Abschluss):

ASCII HEX
„ V” 76
„ 0” 30
„ 0” 30
„ 1” 31
„ 0” 30
„ 2” 32
„ =” 3D
„ 4” 34
NUL 00

→ Die HEX-Werte werden zu Wertepaaren zusammengefasst und mit 0x ("Null"x) davor geschrieben:
0x7630 0x3031 0x3032 0x3d34 0x0000
Die Anzahl der Register (references) beträgt in diesem Beispiel = 5

→ Modbus-Aufruf:
modpoll.exe -m tcp -a 180 -t4:hex -r 1 -0 -1 -o 2.0 192.168.1.10

Befehl Bedeutung
-m tcp Protokoll verwenden
-a 180 Slave-Adresse 180 verwenden (Immer 180)
-r 1 Start-Referenz. (Immer 1)
-0 Ziffer Null. Erste Referenz ist 0. (Immer 0)
-1 Ziffer Eins. Nur ein mal pollen
-o 2.0 Buchstabe “o” (kleingeschrieben). Timeout 2 Sekunden
192.168.1.10 IP-Adresse des KWL-Gerätes

→ Zusammenfassen von Modbus-Aufruf und HEX-Werten zu folgendem Programmaufruf:


Hinweis: Alles in einer Zeile schreiben.
modpoll.exe -m tcp -a 180 -t4:hex -r 1 -0 -1 -o 2.0 192.168.1.10 0x7630 0x3031 0x3032 0x3d34 0x0000
Ausgabe modpoll: 5 Werte geschrieben (written 5 references)

BEISPIEL ☞ Beispiel 2: – Schreiben der Variable v0003 Systemsprache – Französisch

Variable = v00003, Wert = fr (RegStr.BasisParameter.Language.SystemLanguage = fr):


Beschreibung Zugriff Typ count Variable Bemerkung Gültigkeitsbereich
Min. Max.
Sprache RW char[2] 5 v00003 WR: „ de”, „ en”, „ fr”, „ sl” - -

ASCII „ v” „ 0” „ 0” „ 0” „ 0” „ 3” „ =” „ f” „ r” NUL
HEX 67 30 30 30 30 33 3D 66 75 00

modpoll -m tcp -a 180 -t4:hex -r 1 -0 -1 -o 2.0 192.168.1.10 0x7630 0x3030 0x3033 0x3D66 0x7200
Ausgabe modpoll: 5 Werte geschrieben (written 5 references)

BEISPIEL ☞ Beispiel 3: – Schreiben der Variable v00004 Datum – 11.12.2013

Variable = v00004, Wert = 11.12.13 (RegStr.DateTime.SystemDate.Day = 11,


RegStr.DateTime.SystemDate.Month = 12, RegStr.DateTime.SystemDate.Year = 13):
Beschreibung Zugriff Typ count Variable Bemerkung Gültigkeitsbereich
Min. Max.
Datum RW char[10] 9 v00004 R: nach eingestelltem Format - -
(„ dd.mm.yy” „ yyyy.mm.dd”
„ dd.mm.yyyyy”
W: Nur in Format: dd.mm.yy

ASCII „ v” „ 0” „ 0” „ 0” „ 0” „ 4” „ =” „ 1” „ 1” „.” „ 1” „ 2” „.” „ 1” „ 3” NUL


HEX 76 30 30 30 30 34 3d 31 31 2e 31 32 2e 31 33 00

modpoll -m tcp -a 180 -t4:hex -r 1 -0 -1 -o 2.0 192.168.1.10 0x7630 0x3030 0x3034 0x3d31 0x312e 0x3132 0x2e31 0x3300
Ausgabe modpoll: 8 Werte geschrieben (written 8 references)

3
Funktionsbeschreibung
Modbus Gateway TCP/IP – easyControls

D
2.2 Auslesen von Variablen
Das Lesen von Variablen erfordert ein zweistufiges Vorgehen:

1. Zuerst muss die Bezeichnung der zu lesenden Variable im Format „ vXXXXX\0" als HEX-Zeichen codiert in die
Modbus-Register ab Registeradresse 1 geschrieben werden.

2. Mit der anschließenden Abfrage kann die angeforderte Variable ab der Registeradresse 1 gelesen werden. Die an-
geforderte Variable wird dann im Format „ vXXXXX=YYYYY...\0" (als HEX-Zeichen codiert) zurückgegeben.
Damit eine Variable korrekt ausgelesen werden kann, ist es wichtig, dass ausreichend viele Register ausgele-
WICHTIG ☞ sen werden. Die Anzahl der Register ist die Anzahl der HEX-Wertepaare (wie oben beschrieben).

Auslesen von einer falschen Anzahl von Registern


Werden weniger Register abgefragt als für die Ausgabe benötigt werden, wird die Variablenbezeichnung im Format
„ vXXXXX=YYYY....\0” zurückgegeben.
Wenn so wenige Register (count < 4) abgefragt werden, dass es dem Modbus-Slave nicht möglich ist im Format
„ vXXXXX=YYYY.....\0” zu antworten, wird eine ILLEGAL_DATA_ADDRESS-Exception ausgegeben.
Werden mehr Register als nötig ausgelesen, werden die nicht benötigten Register mit 0x00 aufgefüllt.

BEISPIEL ☞ Beispiel 1: – Auslesen der Variable v00004 Datum – 11.12.2013

Zuerst muss dem Modbus-Register die Variable, die gelesen werden soll, zugewiesen werden:
1. Schreiben von „v00004\0" als HEX-Zeichen codiert (Startadresse = 1)
Beschreibung Zugriff Typ count Variable Bemerkung Gültigkeitsbereich
Min. Max.
Datum RW char[10] 9 v00004 R: nach eingestelltem Format - -
(„ dd.mm.yy” „ yyyy.mm.dd”
„ dd.mm.yyyyy”
W: Nur in Format: dd.mm.yy

ASCII „ v” „ 0” „ 0” „ 0” „ 0” „ 4” NUL
HEX 76 30 30 30 30 34 00

modpoll -m tcp -a 180 -t4:hex -r 1 -0 -1 -o 2.0 192.168.1.10 0x7630 0x3030 0x3034 0x0000

– Ausgabe des Programms:


Protocol configuration: MODBUS/TCP
Slave configuration...: address = 180, start reference = 1 (PDU), count = 1
Communication.........: 10.8.11.61, port 502, t/o 2.00 s, poll rate 1000 ms
Data type.............: 16-bit register (hex), output (holding) register table
Written 4 references.

Nun kann an der Startadresse 1 der Wert ausgelesen werden.

Wichtig dabei ist die Anzahl (count) der Registerwerte, die aus der Variablen-Übersicht in der Spalte "count"
WICHTIG ☞ der zu lesenden Variablen zu entnehmen ist.

2. Lesen der Modbus-Register ab Startadresse = 1, count = 9 (Count siehe Variablenübersicht):


modpoll -m tcp -a 180 -t4:hex -r 1 -c 9 -0 -1 -o 2.0 192.168.1.10

– Antwort des KWL-Gerätes:


Protocol configuration: MODBUS/TCP
Slave configuration...: address = 180, start reference = 1 (PDU), count = 9
Communication.........: 10.8.11.61, port 502, t/o 2.00 s, poll rate 1000 ms
Data type.............: 16-bit register (hex), output (holding) register table
-- Polling slave...

HEX-Werte ASCII-Werte
[1]: 0x7630 v0
[2]: 0x3030 00
[3]: 0x3034 04
[4]: 0x3D31 =1
[5]: 0x312E 1.
[6]: 0x3132 12
[7]: 0x2E30 .0
[8]: 0x3031 01
[9]: 0x3300 3/0

Diese Antwort entspricht nach Umwandlung von HEX in ASCII: „v00004=11.12.0013\0“

4
Funktionsbeschreibung
Modbus Gateway TCP/IP – easyControls

D
Beispiel 2: – Auslesen des Temperaturfühlers Außenluft
BEISPIEL ☞
Zuerst muss dem Modbus-Register die Variable, die gelesen werden soll, zugewiesen werden:
1. Schreiben von „ v00104\0" als HEX-Zeichen codiert (Startadresse = 1):

ASCII „ v” „ 0” „ 0” „ 0” „ 0” „ 4” NUL
HEX 76 30 30 30 30 34 00

modpoll.exe -m tcp -a 180 -t4:hex -r 1 -0 -1 -o 2.0 10.8.11.61 0x7630 0x3031 0x3034 0x0000

– Ausgabe des Programms:


Protocol configuration: MODBUS/TCP
Slave configuration...: address = 180, start reference = 1 (PDU), count = 1
Communication.........: 10.8.11.61, port 502, t/o 2.00 s, poll rate 1000 ms
Data type.............: 16-bit register (hex), output (holding) register table
Written 4 references.

2. Lesen der Modbus-Register ab Startadresse 1, count = 8 :


modpoll.exe -m tcp -a 180 -t4:hex -r 1 -c 8 -0 -1 -o 2.0 10.8.11.61

– Ausgabe des Programms:


Protocol configuration: MODBUS/TCP
Slave configuration...: address = 180, start reference = 1 (PDU), count = 8
Communication.........: 10.8.11.61, port 502, t/o 2.00 s, poll rate 1000 ms
Data type.............: 16-bit register (hex), output (holding) register table
-- Polling slave...
HEX-Werte ASCII-Werte
[1]: 0x7630 V0
[2]: 0x3031 01
[3]: 0x3034 04
[4]: 0x3D32 =2
[5]: 0x352E 5.
[6]: 0x3500 50
[7]: 0x0000 00
[8]: 0x0000 00

ERGEBNIS ☞ Diese Antwort entspricht: 25.50 °C

2.3 Auslesen einer falschen Anzahl von Registern


1. Auslesen von zu wenig Registern

Abfrage Startadress = 1, count = 1


modpoll -m tcp -a 180 -t4:hex -r 1 -c 1 -0 -1 -o 2.0 192.168.1.10

– Antwort KWL-Gerät:
Illegal Data Address exception response!

2. Auslesen von zu vielen Registern

Abfrage Startadress = 1, count = 11


modpoll -m tcp -a 180 -t4:hex -r 1 -c 11 -0 -1 -o 2.0 192.168.1.10

– Antwort KWL-Gerät:
HEX-Werte ASCII-Werte
[1]: 0x7630 v0
[2]: 0x3030 00
[3]: 0x3530 50
[4]: 0x3D00 =\0
[5]: 0x0000 00
[6]: 0x0000 00
[7]: 0x0000 00
[8]: 0x0000 00
[9]: 0x0000 00
[10]: 0x0000 00
[11]: 0x0000 00

Diese Antwort entspricht „v00050=\0“


ERGEBNIS ☞ Bei einer zu hohen Anzahl der abgefragten Register werden die restlichen ohne Werte mit "0000" zurückgegeben.

5
Funktionsbeschreibung
Modbus Gateway TCP/IP – easyControls

D
3.0 Beispiel mit dem Windows-Programm modbuspoll.exe
KAPITEL 3
– Herstellen einer Verbindung
MOBBUS MIT
Um eine Verbindung über Modbus Poll mit der Steuerung herzustellen, müssen im Programm „ modbuspoll” folgende
MODBUSPOLL.EXE
Parameter eingestellt werden:

Sofern per DHCP keine andere IP-Adresse vergeben wurde, ist diese standardmäßig: 192.168.1.199

3.1 Schreiben von Variablen

BEISPIEL ☞ Beispiel 1: – Schreiben der Variable v00004

Beschreibung Zugriff Typ count Variable Bemerkung Gültigkeitsbereich


Min. Max.
Datum RW char[10] 9 v00004 R: nach eingestelltem Format - -
(„ dd.mm.yy” „ yyyy.mm.dd”
„ dd.mm.yyyyy”
W: Nur in Format: dd.mm.yy

Schreiben der Variable v00004


(RegStr.DateTime.SystemDate.Day, RegStr.DateTime.SystemDate.Month, RegStr.DateTime.SystemDate.Year)

1. Schreiben des aktuellen Datums: „ v00004=24.04.2014\0“

6
Funktionsbeschreibung
Modbus Gateway TCP/IP – easyControls

D
3.2 Auslesen von Variablen

BEISPIEL ☞ Beispiel 1: – Auslesen der Variable v00004


(RegStr.DateTime.SystemDate.Day, RegStr.DateTime.SystemDate.Month, RegStr.DateTime.SystemDate.Year)

1. Schreiben von „ v00004\0" als ASCII-Zeichen codiert (Startadresse = 1)

2. Lesen der Modbus-Register ab Startadresse = 1, count = 9:

Als Ergebnis erhält man die Ausgabe: „v00004=24.04.2014\0“


ERGEBNIS ☞ Hierzu muss der Inhalt der neun Modbus-Register in eine ASCII-Zeichenkette umgewandelt werden.

7
Funktionsbeschreibung
Modbus Gateway TCP/IP – easyControls

D
Beispiel 2: – Auslesen der Variable v00104 – Temperatur Außenluft
BEISPIEL ☞
Beschreibung Zugriff Typ count Variable Bemerkung Gültigkeitsbereich
Min. Max.
Außenluft R char[7] 8 v00004 R: Format = .1f. -27 <9999
Wenn val >= 9999 dann „ -”

Definitionen für das Auslesen der Variable v00104:


Befehl 1 Befehl 2

Ergebnis Befehl 1 und 2:


ERGEBNIS ☞ Im Rechten Fenster ist das Ergebnis 25,4 Grad als HEX-Wert wie folgt dargestellt:
3D=„ =“ - 32=2 - 35=5 - 2E=„ .“ - 34=4

8
Funktionsbeschreibung
Modbus Gateway TCP/IP – easyControls

D
4.0 Variablenliste
KAPITEL 4 Nachfolgend werden die Register, die gelesen und geschrieben werden können näher beschrieben:
VARIABLEN
– Die Spalte „ Beschreibung” beschreibt die Zugehörigkeit der Variable.
– Die verfügbare Zugriffsart wird durch die Spalte „ Zugriff” beschrieben.
R steht dabei für Lesen, W für Schreiben und RW für Schreib- und Lesezugriffe.
– In der Spalte „ Typ” stehen die zu erwartenden Zeichen. Diese sollte beim Lesen bzw. beim Schreiben über Modbus
mit angegeben werden.
– Beim Schreiben muss die exakte Anzahl der Zeichen mitgegeben werden, dies ist der Wert in der Spalte „ count”.
– Die Spalte „ Variablen” enthält die Namen der Variablen, die beim Zugriff angegeben werden müssen.
– Bei den „ Bemerkungen” stehen zusätzliche Informationen zum Format, der Länge und weiteren Eigenschaften der
Werte.
– Abschließend wird in der Spalte „ Gültigkeitsbereich” der mögliche Wertebereich der Variable – falls vorhanden,
beschrieben.

Beschreibung Zugriff Typ count Variable Bemerkung Gültigkeitsbereich


Min. Max.
Artikelbezeichnung RW char[31] 20 v00000 W: 0 < strlen < 31 - -
Best.-Nr. RW char[16] 12 v00001 W: 0 < strlen < 17 - -
MAC-Adresse Webserver R char[18] 13 v00002 W: 0 < strlen < 17 - -
Sprache RW char[2] 5 v00003 WR: „ de”, „ en”, „ fr”, „ sl” - -
Datum RW char[10] 9 v00004 R: nach eingestelltem Format - -
(„ dd.mm.yy” „ yyyy.mm.dd”
„ dd.mm.yyyyy”
W: Nur in Format: dd.mm.yy
Uhrzeit RW char[10] 9 v00005 R: Format: hh:mm:ss - -
W: Format: hh:mm:ss
Sommer / Winter RW char[1] 5 v00006 W: „ o”-Aktiv - -
R: 0-Winterzeit,
1 = Sommerzeit
Auto. Softwareupdates RW char[1] 5 v00007 W: „ o”-Aktiv - -
erlauben R: 0-Winterzeit,
1 = aktiviert
Zugang zum RW char[1] 5 v00008 W: „ o”-Aktiv - -
Helios Portal erlauben R: 0-Winterzeit,
1 = aktiviert
Spannung Lüfterstufe 1 RW char[3] 6 v00012 R: Format = .1f 1.6 10
Abluft
Spannung Lüfterstufe 1 RW char[3] 6 v00013 R: Format = .1f 1.6 10
Zuluft
Spannung Lüfterstufe 2 RW char[3] 6 v00014 R: Format = .1f 1.6 10
Abluft
Spannung Lüfterstufe 2 RW char[3] 6 v00015 R: Format = .1f 1.6 10
Zuluft
Spannung Lüfterstufe 3 RW char[3] 6 v00016 R: Format = .1f 1.6 10
Abluft
Spannung Lüfterstufe 3 RW char[3] 6 v00017 R: Format = .1f 1.6 10
Zuluft
Spannung Lüfterstufe 4 RW char[3] 6 v00018 R: Format = .1f 1.6 10
Abluft
Spannung Lüfterstufe 4 RW char[3] 6 v00019 R: Format = .1f 1.6 10
Zuluft
Min. Lüfterstufe RW char[1] 5 v00020 RW: Lüfterstufe 0 1

KWL-BE aktiviert RW char[1] 5 v00020 RW: 0 =Aus 0 1


1 = Ein
KWL-BEC aktiviert RW char[1] 5 v00022 RW: 0 =Aus 0 1
1 = Ein
Gerätekonfiguration RW char[1] 5 v00023 RW: 1-DiBt 1 2
2-Passivhaus

9
Funktionsbeschreibung
Modbus Gateway TCP/IP – easyControls

D
Beschreibung Zugriff Typ count Variable Bemerkung Gültigkeitsbereich
Min. Max.
Vorheizung Status RW char[1] 5 v00024 RW: 0 =Aus 0 1
1 = Ein
KWL-FTF konfig 0 RW char[1] 5 v00025 RW: 1=RF, 1 3
2=Temp., 3=kombiniert
KWL-FTF konfig 1 RW char[1] 5 v00026 RW: 1=RF, 1 3
2=Temp., 3=kombiniert
KWL-FTF konfig 2 RW char[1] 5 v00027 RW: 1=RF, 1 3
2=Temp., 3=kombiniert
KWL-FTF konfig 3 RW char[1] 5 v00028 RW: 1=RF, 1 3
2=Temp., 3=kombiniert
KWL-FTF konfig 4 RW char[10] 5 v00029 RW: 1=RF, 1 3
2=Temp., 3=kombiniert
KWL-FTF konfig 5 RW char[1] 5 v00030 RW: 1=RF, 1 3
2=Temp., 3=kombiniert
KWL-FTF konfig 6 RW char[1] 5 v00031 RW: 1=RF, 1 3
2=Temp., 3=kombiniert
KWL-FTF konfig 7 RW char[1] 5 v00032 RW: 1=RF, 0 2
2=Temp., 3=kombiniert
Feuchte-Steuerung RW char[1] 5 v00033 RW: 1=RF, 0 2
Status 2=Temp., 3=kombiniert
Feuchte-Steuerung RW char[2] 5 v00034 RW: in Prozent 20 % 80 %
Sollwert
Feuchte-Steuerung RW char[2] 5 v00035 RW: in Prozent 5% 20 %
Stufen
Feuchte-Steuerung RW char[2] 5 v00036 RW: in Stunden 0h 24 h
Stoppzeit
CO2-Steuerung RW char[1] 5 v00037 RW: 0=Aus, 0 2
Status 2 = Stufig., 3 = Stufenlos
CO2-Steuerung RW char[4] 6 v00038 RW: in ppm 300 2000
Sollwert
CO2-Steuerung RW char[3] 6 v00039 RW: in ppm 50 400
Stufen
VOC-Steuerung RW char[1] 5 v00040 RW: 0=Aus, 0 2
Status 2 = Stufig., 3 = Stufenlos
VOC-Steuerung RW char[4] 6 v00041 RW: in ppm 300 2000
Sollwert
VOC-Steuerung RW char[3] 6 v00042 RW: in ppm 50 400
Stufen
Behaglichkeits- RW char[4] 6 v00043 R: Format = .1f 10 25
temperatur
Zeitzone Abweichung RW char[3] 6 v00051 RW: Zeitzonen -12 14
von GMT
Datumsformat RW char[1] 5 v00052 R: 0 = „ dd.mm.yy”, 0 2
1 = „ mm.dd.yyyy”,
2 = „ yyyyy.mm.dd”
Wärmetauscher Typ RW char[1] 5 v00053 RW: 1 = „ Kunststoff” 1 3
2 = „ Aluminium”
3 = „ Enthalpie”
Partybetrieb RW char[3] 6 v00091 RW: in Minuten 5 180
Dauer
Partybetrieb RW char[3] 5 v00092 RW: Lüfterstufe 0 4
Lüfterstufe
Partybetrieb R char[3] 6 v00093 RW: in Minuten 0 180
Restzeit
Partybetrieb RW char[1] 5 v00094 RW: 0 = Aus 0 1
aktivieren / abrechen 1 = Ein
Ruhebetrieb RW char[3] 6 v00096 RW: in Minuten 5 180
Dauer

10
Funktionsbeschreibung
Modbus Gateway TCP/IP – easyControls

D
Beschreibung Zugriff Typ count Variable Bemerkung Gültigkeitsbereich
Min. Max.
Ruhebetrieb RW char[1] 5 v00097 RW: Lüfterstufe 0 4
Lüfterstufe
Ruhebetrieb R char[3] 6 v00098 R: in Minuten 0 180
Restzeit
Ruhebetrieb RW char[1] 5 v00099 RW: 0 = Aus 0 1
aktivieren / abbrechen 1 = Ein
Betriebsart RW char[1] 5 v00101 R: 0 = Automat. 0 1
1 = Handbetrieb
W: 0 = Automat.
1 = Handbetrieb
Lüfterstufe RW char[1] 5 v00102 RW: Lüfterstufe 0 4
Prozentuale R char[3] 6 v00103 R: prozentuale 0 100
Lüfterstufe Lüfteransteuerung
Temperatur R char[7] 8 v00104 R: Format = .1f. Wenn -27 <9999
Außenluft val >=9999 dann „ -”
Temperatur R char[7] 8 v00105 R: Format = .1f. Wenn -27 <9999
Zuluft val >=9999 dann „ -”
Temperatur R char[7] 8 v00106 R: Format = .1f. Wenn -27 <9999
Fortluft val >=9999 dann „ -”
Temperatur R char[7] 8 v00107 R: Format = .1f. Wenn -27 <9999
Abluft val >=9999 dann „ -”
VHZ Kanalfühler R char[7] 8 v00108 R: Format = .1f. Wenn -27 <9999
(-Außenluft- T5) val >=9999 dann „ -”
NHZ Rücklauffühler R char[7] 8 v00110 R: Format = .1f. Wenn -27 <9999
(-Warmwasser-Register- val >=9999 dann „ -”
T7)
Externer Fühler R char[4] 6 v00111 R: Wenn val >=9999 0 <9999
KWL-FTF Feuchte 1 dann „ -”
Externer Fühler R char[4] 6 v00112 R: Wenn val >=9999 0 <9999
KWL-FTF Feuchte 2 dann „ -”
Externer Fühler R char[4] 6 v00113 R: Wenn val >=9999 0 <9999
KWL-FTF Feuchte 3 dann „ -”
Externer Fühler R char[4] 6 v00114 R: Wenn val >=9999 0 <9999
KWL-FTF Feuchte 4 dann „ -”
Externer Fühler R char[4] 6 v00115 R: Wenn val >=9999 0 <9999
KWL-FTF Feuchte 5 dann „ -”
Externer Fühler R char[4] 6 v00116 R: Wenn val >=9999 0 <9999
KWL-FTF Feuchte 16 dann „ -”
Externer Fühler R char[4] 6 v00117 R: Wenn val >=9999 0 <9999
KWL-FTF Feuchte 7 dann „ -”
Externer Fühler R char[4] 6 v00118 R: Wenn val >=9999 0 <9999
KWL-FTF Feuchte 8 dann „ -”

11
Funktionsbeschreibung
Modbus Gateway TCP/IP – easyControls

D
Beschreibung Zugriff Typ count Variable Bemerkung Gültigkeitsbereich
Min. Max.
Externer Fühler R char[7] 8 v00119 R: Format = .1f. Wenn -27 <9999
KWL-FTF Temp 1 val >=9999 dann „ -”
Externer Fühler R char[7] 8 v00120 R: Format = .1f. Wenn -27 <9999
KWL-FTF Temp 2 val >=9999 dann „ -”
Externer Fühler R char[7] 8 v00121 R: Format = .1f. Wenn -27 <9999
KWL-FTF Temp 3 val >=9999 dann „ -”
Externer Fühler R char[7] 8 v00122 R: Format = .1f. Wenn -27 <9999
KWL-FTF Temp 4 val >=9999 dann „ -”
Externer Fühler R char[7] 8 v00123 R: Format = .1f. Wenn -27 <9999
KWL-FTF Temp 5 val >=9999 dann „ -”
Externer Fühler R char[7] 8 v00124 R: Format = .1f. Wenn -27 <9999
KWL-FTF Temp 6 val >=9999 dann „ -”
Externer Fühler R char[7] 8 v00125 R: Format = .1f. Wenn -27 <9999
KWL-FTF Temp 7 val >=9999 dann „ -”
Externer Fühler R char[7] 8 v00126 R: Format = .1f. Wenn -27 <9999
KWL-FTF Temp 8 val >=9999 dann „ -”
Externer Fühler R char[4] 6 v00128 R: Format = .1f. Wenn 0 <9999
KWL-CO2 1 val >=9999 dann „ -”
Externer Fühler R char[4] 6 v00129 R: Format = .1f. Wenn 0 <9999
KWL-CO2 2 val >=9999 dann „ -”
Externer Fühler R char[4] 6 v00130 R: Format = .1f. Wenn 0 <9999
KWL-CO2 3 val >=9999 dann „ -”
Externer Fühler R char[4] 6 v00131 R: Format = .1f. Wenn 0 <9999
KWL-CO2 4 val >=9999 dann „ -”
Externer Fühler R char[4] 6 v00132 R: Wenn val >=9999 0 <9999
KWL-CO2 5 dann „ -”
Externer Fühler R char[4] 6 v00133 R: Wenn val >=9999 0 <9999
KWL-CO2 6 dann „ -”
Externer Fühler R char[4] 6 v00134 R: Wenn val >=9999 0 <9999
KWL-CO2 7 dann „ -”
Externer Fühler R char[4] 6 v00135 R: Wenn val >=9999 0 <9999
KWL-CO2 8 dann „ -”
Externer Fühler R char[4] 6 v00136 R: Wenn val >=9999 0 <9999
KWL-VOC 1 dann „ -”
Externer Fühler R char[4] 6 v00137 R: Wenn val >=9999 0 <9999
KWL-VOC 2 dann „ -”
Externer Fühler R char[4] 6 v00138 R: Wenn val >=9999 0 <9999
KWL-VOC 3 dann „ -”
Externer Fühler R char[4] 6 v00139 R: Wenn val >=9999 0 <9999
KWL-VOC 4 dann „ -”
Externer Fühler R char[4] 6 v00140 R: Wenn val >=9999 0 <9999
KWL-VOC 5 dann „ -”
Externer Fühler R char[4] 6 v00141 R: Wenn val >=9999 0 <9999
KWL-VOC 6 dann „ -”
Externer Fühler R char[4] 6 v00142 R: Wenn val >=9999 0 <9999
KWL-VOC 7 dann „ -”
Externer Fühler R char[4] 6 v00143 R: Wenn val >=9999 0 <9999
KWL-VOC 8 dann „ -”
NHZ Kanalfühler R char[7] 8 v00146 R: Format = .1f. Wenn -27 <9999
(-Zuluft- T6) val >=9999 dann „ -”
Wochenprofil NHZ RW char[1] 5 v00201 RW: Wert für die Variablen: 0 6
v00230..v00259 (y)
0 = Standard 1;
1 = Standard 2;
2 = Festwert;
3 = Individuell 1;
4 = Individuell 2;
5 = NA; 6 = Aus
Ser. Nr. RW char[16] 12 v00303 W: 0 < strlen > 16 - -
ProdCode RW char[13] 11 v00304 W: 0 < strlen > 13 - -
Zuluft rpm R char[4] 6 v00348 R: min -1 0 9999
Abluft rpm R char[4] 6 v00349 R: min -1 0 9999
Logout W char[1] 5 v00403 W: Logout 1 1

12
Funktionsbeschreibung
Modbus Gateway TCP/IP – easyControls

D
Beschreibung Zugriff Typ count Variable Bemerkung Gültigkeitsbereich
Min. Max.
Urlaubsprogramm RW char[1] 5 v00601 RW: 0-Aus; 0 2
1-Intervall; 2-Konstant
Lüfterstufe RW char[1] 5 v00602 RW: Lüfterstufe 1 4
Urlaubsprogramm
Start RW char[10] 9 v00603 RW: nach eingestelltem Format - -
(„ dd.mm.yy” „ yyyy.mm.dd”
„ dd.mm.yyyyy”
Ende RW char[10] 9 v00604 RW: nach eingestelltem Format - -
(„ dd.mm.yy” „ yyyy.mm.dd”
„ dd.mm.yyyyy”
Intervall RW char[2] 5 v00605 RW: Zeit in Stunden 1 24

Einschaltzeit RW char[3] 6 v00606 RW: in Minuten 5 300

VHZ Typ RW char[1] 5 v01010 RW: 1 = EH-Basis; 2 = EH- 1 4


ERW; 3 = SEWT; 4 =
1-Intervall; 2-Konstant
Funktionsart KWL-EM RW char[1] 5 v01017 RW: 1 = Funktion 1, 1 2
(Zuordnungen Relais auf 2 = Funktion 2
Klappen / Störausgänge)
Nachlaufzeit VHZ / NHZ RW char[3] 6 v01019 RW: Nachlaufzeit in Sek. 60 120

Externer Kontakt RW char[1] 5 v01020 RW: 1 = Funktion 1; 1 6


2 = Funktion 2;
3 = Funktion 3; ...
Störausgangsfunktion: RW char[1] 5 v01021 RW: 1 = Sammelstörung; 1 2
Sammelstörung 2 = Nur Fehler 2
oder nur Fehler
Filterwechsel RW char[1] 5 v01031 RW: 0 = Nein 0 1
1 = Ja
Wechselintervall RW char[2] 5 v01032 RW: Wechsleintervall 0 12
in Monaten
Restlaufzeit R char[10] 9 v01033 RW: in Minuten 2 232-1

Bypass RW char[2] 5 v01035 RW: in °C 10 40


Raum/Temp.
Bypass RW char[2] 5 v01036 RW: in °C 5 20
Min. Außentemp.
RW char[2] 5 v01037 RW: in °C 3 10
Auslieferzustand RW char[1] 5 v01041 W: 1 = Reset der 1 1
WZU individuellen Schaltzeiten
Werksreset RW char[1] 5 v01042 W: 1 = Reset Start 1 1
Zuluft RW char[1] 5 v01050 RW: Lüfterstufe 1 4
Abluft RW char[1] 5 v01051 RW: Lüfterstufe 1 4
Zuordnung Lüfterstufen RW char[1] 5 v01061 RW: Lüfterstufe 0 2
(bei stufig) Bereich 0-2
Zuordnung Lüfterstufen RW char[1] 5 v01062 RW: Lüfterstufe 0 4
(bei stufig) Bereich 2-4
Zuodnung Lüfterstufen RW char[1] 5 v01063 RW: Lüfterstufe 0 4
(bei stufig) Bereich 4-6
Zuodnung Lüfterstufen RW char[1] 5 v01064 RW: Lüfterstufe 0 4
(bei stufig) Bereich 6-8
Zuodnung Lüfterstufen RW char[10] 5 v01065 RW: Lüfterstufe 0 4
(bei stufig) Bereich 8-10
Offset Abluft RW char[10] 9 v01066 RW: (Float_Value)
Zuodnung Lüfterstufen RW char[1] 5 v01068 W: 0 = 0...10V; 0 1
Stufig oder 0-10 Volt 1 = Stufig
Sensorname RW char[15] 12 v01071 W: 0 < strlen > 15 - -
Feuchte und Temp.
Sensorname RW char[15] 12 v01072 W: 0 < strlen > 15 - -
Feuchte und Temp.

13
Funktionsbeschreibung
Modbus Gateway TCP/IP – easyControls

D
Beschreibung Zugriff Typ count Variable Bemerkung Gültigkeitsbereich
Min. Max.
Sensorname RW char[15] 12 v01073 W: 0 < strlen > 15 - -
Feuchte und Temp.
Sensorname RW char[15] 12 v01074 W: 0 < strlen > 15 - -
Feuchte und Temp.
Sensorname RW char[15] 12 v01075 W: 0 < strlen > 15 - -
Feuchte und Temp.
Sensorname RW char[15] 12 v01076 W: 0 < strlen > 15 - -
Feuchte und Temp.
Sensorname RW char[15] 12 v01077 W: 0 < strlen > 15 - -
Feuchte und Temp.
Sensorname RW char[15] 12 v01078 W: 0 < strlen > 15 - -
Feuchte und Temp.
Sensorname CO2 RW char[15] 12 v01081 W: 0 < strlen > 15 - -
Sensorname CO2 RW char[15] 12 v01082 W: 0 < strlen > 15 - -
Sensorname CO2 RW char[15] 12 v01083 W: 0 < strlen > 15 - -
Sensorname CO2 RW char[15] 12 v01084 W: 0 < strlen > 15 - -
Sensorname CO2 RW char[15] 12 v01085 W: 0 < strlen > 15 - -
Sensorname CO2 RW char[15] 12 v01086 W: 0 < strlen > 15 - -
Sensorname CO2 RW char[15] 12 v01087 W: 0 < strlen > 15 - -
Sensorname CO2 R char[15] 12 v01088 W: 0 < strlen > 15 - -
Sensorname VOC RW char[15] 12 v01091 W: 0 < strlen > 15 - -
Sensorname VOC RW char[15] 12 v01092 W: 0 < strlen > 15 - -
Sensorname VOC RW char[15] 12 v01093 W: 0 < strlen > 15 - -
Sensorname VOC RW char[15] 12 v01094 W: 0 < strlen > 15 - -
Sensorname VOC RW char[15] 12 v01095 W: 0 < strlen > 15 - -
Sensorname VOC RW char[15] 12 v01096 W: 0 < strlen > 15 - -
Sensorname VOC RW char[15] 12 v01097 W: 0 < strlen > 15 - -
Sensorname VOC RW char[15] 12 v01098 W: 0 < strlen > 15 - -
Software Version Basis R char[5] 7 v01101 R: Format "xx.xx" 0 99.99
Betr. Stdn. Zuluft Vent. R char[10] 9 v01103 in Minuten 0 232-1
Betr. Stdn. Abluft Vent. R char[10] 9 v01104 in Minuten 0 232-1
Betr. Stdn. VHZ R char[10] 9 v01105 in Minuten 0 232-1
Betr. Stdn. NHZ R char[10] 9 v01106 in Minuten 0 232-1
Abgegebene Leistung R char[10] 9 v01108 Wert/100 0 232-1
VHZ in %
Abgegebene Leistung R char[10] 9 v01109 Wert/100 0 232-1
NHZ in %
Reset Flag R char[1] 5 v01120 W: 1 = Reset Flag 1 1

14
Funktionsbeschreibung
Modbus Gateway TCP/IP – easyControls

D
Beschreibung Zugriff Typ count Variable Bemerkung Gültigkeitsbereich
Min. Max.
Fehler R char[10] 9 v01123 R: Fehler als Int-Wert (siehe Ta- 0 232-1
belle "codierung")
Beachte: V01303 - V01306
Warnungen R char[3] 6 v01124 R: Warnungen als Int-Wert 0 28-1
(siehe Tabelle "codierung")
Beachte: V01303 - V01306
Infos R char[3] 6 v01125 R: Infos als Int-Wert 0 28-1
(siehe Tabelle "codierung")
Beachte: V01303 - V01306
Anzahl der Fehler R char[2] 5 v01300 R: Anzahl der Bitcodierten 0 32
Fehler aus V01303
Anzahl der Warnungen R char[1] 5 v01301 R: Anzahl der Bitcodierten 0 8
Warnungen aus V01304
Anzahl der Infos R char[1] 5 v01302 R: Anzahl der Bitcodierten Infos 0 8
aus V01305
Fehler R char[32] 20 v01303 R: Fehler als String - -
(siehe Tabelle "codierung")
Beachte: V01123 - V01125
Warnungen R char[8] 8 v01304 R: Warnungen als String (siehe - -
Tabelle "codierung")
Beachte: V01123 - V01125
Infos R char[8] 8 v01305 R: Infos als String - -
(siehe Tabelle "codierung")
Beachte: V01123 - V01125
Statusflags R char[32] 20 v01306 R: Sysflags als String (siehe - -
Tabelle "codierung")
KWL-FTF Konfig 1 R char[1] 5 v02020 R: 0 = Kein Sensor, 0 1
1 = Sensor installiert
KWL-FTF Konfig 2 R char[1] 5 v02021 R: 0 = Kein Sensor, 0 1
1 = Sensor installiert
KWL-FTF Konfig 3 R char[1] 5 v02022 R: 0 = Kein Sensor, 0 1
1 = Sensor installiert
KWL-FTF Konfig 4 R char[1] 9 v02023 R: 0 = Kein Sensor, 0 1
1 = Sensor installiert
KWL-FTF Konfig 5 R char[1] 5 v02024 R: 0 = Kein Sensor, 0 1
1 = Sensor installiert
KWL-FTF Konfig 6 R char[1] 5 v02025 R: 0 = Kein Sensor, 0 1
1 = Sensor installiert
KWL-FTF Konfig 7 R char[1] 5 v02026 R: 0 = Kein Sensor, 0 1
1 = Sensor installiert
KWL-FTF Konfig 8 R char[1] 5 v02027 R: 0 = Kein Sensor, 0 1
1 = Sensor installiert
Global.ManualWeb- RW char[1] 5 v02013 RW: 1 = Manuelles Update der 1 1
Update Daten (Profil 8: XGP, XWP, Firm-
ware, SD-Files wird gestartet)
0 = Download nicht gesetartet
oder abgeschlossen
PortalGlobals.Error- R char[3] 6 v02014 R: Immer der Letzte Fehler der 1 255
ForWeb aufgetreten ist.
Fehler Löschen W char[1] 5 v02015 W: 1 = Fehler wird zurück 1 1
gesetzt
(PortalGlobals.ErrorForWeb)

15
Funktionsbeschreibung
Modbus Gateway TCP/IP – easyControls

D
Tabelle „Codierung“

Fehler (Variable V01303)

Bit Bitmaske Fehler- Maske (hex) Fehlerbeschreibung


Nr.
0 0000 0000 0000 0000 0000 0000 0000 0001 1 0x00000001 Drehzahlfehler Lüfter "Zuluft" (Aussenluf)
1 0000 0000 0000 0000 0000 0000 0000 0010 2 0x00000002 Drehzahlfehler Lüfter "Abluft" (Fortluft)
2 0000 0000 0000 0000 0000 0000 0000 0100 3 0x00000004 -frei-
3 0000 0000 0000 0000 0000 0000 0000 1000 4 0x00000008 SD-Karten Fehler beim Schreiben der E-Eprom-
Daten bei "FLASH-Ringpuffer VOLL"

4 0000 0000 0000 0000 0000 0000 0001 0000 5 0x00000010 Bus Überstrom
5 0000 0000 0000 0000 0000 0000 0010 0000 6 0x00000020 -frei-
6 0000 0000 0000 0000 0000 0000 0100 0000 7 0x00000040 BASIS: 0-Xing Fehler VHZ EH (0-Xing = Zero-
Crossing, Null-Durchgangserkennung)

7 0000 0000 0000 0000 0000 0000 1000 0000 8 0x00000080 Erw. Modul (VHZ): 0-Xing Fehler VHZ EH

8 0000 0000 0000 0000 0000 0001 0000 0000 9 0x00000100 Erw. Modul (NHZ): 0-Xing Fehler NHZ EH

9 0000 0000 0000 0000 0000 0010 0000 0000 10 0x00000200 BASIS: Interner Temp-Sensorfehler - (T1) -Aussen-
luft (fehlt od. Kabelbruch)
10 0000 0000 0000 0000 0000 0100 0000 0000 11 0x00000400 BASIS: Interner Temp-Sensorfehler - (T2) -Zuluft-
(fehlt od. Kabelbruch)
11 0000 0000 0000 0000 0000 1000 0000 0000 12 0x00000800 BASIS: Interner Temp-Sensorfehler - (T3) -Abluft-
(fehlt od. Kabelbruch)
12 0000 0000 0000 0000 0001 0000 0000 0000 13 0x00001000 BASIS: Interner Temp-Sensorfehler - (T4) -Fortluft-
(fehlt od. Kabelbruch)
13 0000 0000 0000 0000 0010 0000 0000 0000 14 0x00002000 BASIS: Interner Temp-Sensorfehler - (T1) -Aussen-
luft- (Kurzschluss)
14 0000 0000 0000 0000 0100 0000 0000 0000 15 0x00004000 BASIS: Interner Temp-Sensorfehler - (T2) -Zuluft-
(Kurzschluss)
15 0000 0000 0000 0000 1000 0000 0000 0000 16 0x00008000 BASIS: Interner Temp-Sensorfehler - (T3) -Abluft-
(Kurzschluss)
16 0000 0000 0000 0001 0000 0000 0000 0000 17 0x00010000 BASIS: Interner Temp-Sensorfehler - (T4) -Fortluft-
(Kurzschluss)
17 0000 0000 0000 0010 0000 0000 0000 0000 18 0x00020000 Erw. Modul als VHZ konfiguriert, aber nicht vorh.
oder ausgefallen
18 0000 0000 0000 0100 0000 0000 0000 0000 19 0x00040000 Erw. Modul als NHZ konfiguriert, aber nicht vorh.
oder ausgefallen
19 0000 0000 0000 1000 0000 0000 0000 0000 20 0x00080000 Erw. Modul (VHZ): Kanalfühler (T5) -Aussenluft-
(fehlt od. Kabelbruch)
20 0000 0000 0001 0000 0000 0000 0000 0000 21 0x00100000 Erw. Modul (NHZ): Kanalfühler (T6) -Zuluft- (fehlt
od. Kabelbruch)
21 0000 0000 0010 0000 0000 0000 0000 0000 22 0x00200000 Erw. Modul (NHZ): Kanalfühler (T7) -Rücklauf WW-
Register- (fehlt od. Kabelbruch)
22 0000 0000 0100 0000 0000 0000 0000 0000 23 0x00400000 Erw. Modul (VHZ): Kanalfühler (T5) -Aussenluft-
(Kurzschluss)
23 0000 0000 1000 0000 0000 0000 0000 0000 24 0x00800000 Erw. Modul (NHZ): Kanalfühler (T6) -Zuluft- (Kurz-
schluss)
24 0000 0001 0000 0000 0000 0000 0000 0000 25 0x01000000 Erw. Modul (NHZ): Kanalfühler (T7) -Rücklauf WW-
Register- (Kurzschluss)
25 0000 0010 0000 0000 0000 0000 0000 0000 26 0x02000000 Erw. Modul (VHZ): Sicherheitsbegrenzer automa-
tisch
26 0000 0100 0000 0000 0000 0000 0000 0000 27 0x04000000 Erw. Modul (VHZ): Sicherheitsbegrenzer manuell
27 0000 1000 0000 0000 0000 0000 0000 0000 28 0x08000000 Erw. Modul (NHZ): Sicherheitsbegrenzer automa-
tisch
28 0001 0000 0000 0000 0000 0000 0000 0000 29 0x10000000 Erw. Modul (NHZ): Sicherheitsbegrenzer manuell
29 0010 0000 0000 0000 0000 0000 0000 0000 30 0x20000000 Erw. Modul (NHZ): Frostschutz WW-Reg. gemes-
sen über WW-Rücklauf (T7) (Schaltschwelle per
Variablenliste einstellbar z.B. < 7°C)
30 0100 0000 0000 0000 0000 0000 0000 0000 31 0x40000000 Erw. Modul (NHZ): Frostschutz WW-Reg. gemes-
sen über Zuluft-Fühler (T6)
(Schaltschwelle per Variablenliste einstellbar z.B.
< 7°C)
31 1000 0000 0000 0000 0000 0000 0000 0000 32 0x80000000 Frostschutz externes WW Reg.: ( fest < 5°C nur
PHI), gemessen entweder über
(1.) Erw. Modul (NHZ): Zuluftkanal-Fühler (T6)
oder
(2.) BASIS: Zuluftkanal-Fühler (T2)

16
Funktionsbeschreibung
Modbus Gateway TCP/IP – easyControls

D
Tabelle „Codierung“

Warnungen (Variable V01304)


Bit Bitmaske Fehler- Maske (hex) Fehlerbeschreibung
Nr.
0 0000 0001 1 0x01 Interner Feuchtefuehler liefert keinen Wert
1 0000 0010 2 0x02 -frei-
2 0000 0100 3 0x04 -frei-
3 0000 1000 4 0x08 -frei-
4 0001 0000 5 0x10 -frei-
5 0010 0000 6 0x20 -frei-
6 0100 0000 7 0x40 -frei-
7 1000 0000 8 0x80 -frei-

Infos (Variable V01305)


Bit Bitmaske Fehler- Maske (hex) Fehlerbeschreibung
Nr.
0 0000 0001 1 0x01 Filterwechsel
1 0000 0010 2 0x02 Frostschutz WT
2 0000 0100 3 0x04 SD-Karten Fehler
3 0000 1000 4 0x08 Ausfall eines Externen Moduls (weitere Info in
LOG-File)
4 0001 0000 5 0x10 -frei-
5 0010 0000 6 0x20 -frei-
6 0100 0000 7 0x40 -frei-
7 1000 0000 8 0x80 -frei-

StateFlags (Variable V01306)

Bit Bitmaske Fehler- Maske (hex) Fehlerbeschreibung


Nr.
0 0000 0000 0000 0000 0000 0000 0000 0001 1 0x00000001 1 = SYSTEM fertig initialisiert (Anzeige im BT bis
dahin: SYSTEM BOOTING)
1 0000 0000 0000 0000 0000 0000 0000 0010 2 0x00000002 1 = SYSTEM Softwareupdate aktiv (Anzeige im
BT bis dahin: SYSTEM LOADING)
2 0000 0000 0000 0000 0000 0000 0000 0100 3 0x00000004 1 = Firmwareupdate wird aktiviert
3 0000 0000 0000 0000 0000 0000 0000 1000 4 0x00000008 1 = INBA ist aktiv
4 0000 0000 0000 0000 0000 0000 0001 0000 5 0x00000010 1 = Partybetrieb
5 0000 0000 0000 0000 0000 0000 0010 0000 6 0x00000020 1 = Ruhebetrieb
6 0000 0000 0000 0000 0000 0000 0100 0000 7 0x00000040 1 = Urlaubsbetrieb
7 0000 0000 0000 0000 0000 0000 1000 0000 8 0x00000080 1 = VHZ ist auf BASIS-Modul konfiguriert
8 0000 0000 0000 0000 0000 0001 0000 0000 9 0x00000100 1 = VHZ ist auf ErwModul konfiguriert
9 0000 0000 0000 0000 0000 0010 0000 0000 10 0x00000200 1 = ErwModul VHZ aktiv (z.B. BT-Anzeige: Menü-
punkt VHZ einblenden)
10 0000 0000 0000 0000 0000 0100 0000 0000 11 0x00000400 1 = VHZ konfiguriert
11 0000 0000 0000 0000 0000 1000 0000 0000 12 0x00000800 VHZ: Heizungstyp (0 = Elektrisch / 1 = Sole (Erde
oder Luft)
12 0000 0000 0000 0000 0001 0000 0000 0000 13 0x00001000 1 = NHZ konfiguriert (Temperaturprofil eingestellt
ungl. HEIZUNG_AUS)
13 0000 0000 0000 0000 0010 0000 0000 0000 14 0x00002000 1 = ErwModul NHZ aktiv (z.B. BT-Anzeige: Menü-
punkt NHZ einblenden)
14 0000 0000 0000 0000 0100 0000 0000 0000 15 0x00004000 1 = NHZ aktiv (Regelung, Fehler, identisch mit
"Nachheizung.Ein")
15 0000 0000 0000 0000 1000 0000 0000 0000 16 0x00008000 NHZ: Heizungstyp (0 = Elektrisch / 1 = Warm-
wasser)
16 0000 0000 0000 0001 0000 0000 0000 0000 17 0x00010000 1 = CO2 Regelung ein
17 0000 0000 0000 0010 0000 0000 0000 0000 18 0x00020000 1 = Humi Regelung ein
18 0000 0000 0000 0100 0000 0000 0000 0000 19 0x00040000 1 = VOC Regelung ein
19 0000 0000 0000 1000 0000 0000 0000 0000 20 0x00080000 -frei-
20 0000 0000 0001 0000 0000 0000 0000 0000 21 0x00100000 1 = min. ein Externer Kontakt angeschlossen (EM
oder ES)
21 0000 0000 0010 0000 0000 0000 0000 0000 22 0x00200000 1 = Externe Kontaktfunktion AKTIV
22 0000 0000 0100 0000 0000 0000 0000 0000 23 0x00400000 1 = Externen Zugriff zulassen
23 0000 0000 1000 0000 0000 0000 0000 0000 24 0x00800000 1 = Externer Zugriff aktiv
24 0000 0001 0000 0000 0000 0000 0000 0000 25 0x01000000 1 = Defrost Wärmetauscher

17
Funktionsbeschreibung
Modbus Gateway TCP/IP – easyControls

D
StateFlags (Variable V01306)

Bit Bitmaske Fehler- Maske (hex) Fehlerbeschreibung


Nr.
25 0000 0010 0000 0000 0000 0000 0000 0000 26 0x02000000 1 = Defrost Warmwasserregister
26 0000 0100 0000 0000 0000 0000 0000 0000 27 0x04000000 1 = Filterwechsel fälling
27 0000 1000 0000 0000 0000 0000 0000 0000 28 0x08000000 1 = Konfig_1 (DIBT) / 0 = Konfig_2 (PHI)
28 0001 0000 0000 0000 0000 0000 0000 0000 29 0x10000000 1 = BEC-U1 über Web deaktiviert (reine Anzeige-
funktion)
29 0010 0000 0000 0000 0000 0000 0000 0000 30 0x20000000 1 = Bedienteil sperren
30 0100 0000 0000 0000 0000 0000 0000 0000 31 0x40000000 1 = Master Password required (Wird gesetzt
wenn 3 mal falsches pw eingegeben wurde)
31 1000 0000 0000 0000 0000 0000 0000 0000 32 0x80000000 1 = Anzeige der Lüfterstufe in %

18
Funktionsbeschreibung
Modbus Gateway TCP/IP – easyControls

D
5.0 Sonstiges / Hinweise
KAPITEL 5 Alle verwendeten externen Namen, Warenzeichen, WWW-Links sind Eigentum der jeweiligen Firmen und stehen in
keinem Zusammenhang zur Helios Ventilatoren GmbH + Co KG nachfolgend kurz Helios. Für die Inhalte der jeweili-
SONSTIGES/HINWEISE
gen WWW-Links sind die Eigentümer verantwortlich.

Helios übernimmt keine Haftung für inhaltliche Fehler. Abbildungen und Angaben sind unverbindlich.
Technische Änderungen ohne Ankündigung vorbehalten.
ACHTUNG ☞ Der Anwender verwendet das Protokoll Modbus auf eigene Gefahr.

19
Funktionsbeschreibung
Modbus Gateway TCP/IP – easyControls

Notizen:

20
Funktionsbeschreibung
Modbus Gateway TCP/IP – easyControls

Notizen:

21
Alle Abbildungen ohne Gewähr!
Als Referenz am Gerät griffbereit aufbewahren! Druckschrift-Nr. 82 269/09.16 www.heliosventilatoren.de
Service und Information
D HELIOS Ventilatoren GmbH + Co KG · Lupfenstraße 8 · 78056 VS-Schwenningen F HELIOS Ventilateurs · Le Carré des Aviateurs · 157 avenue Charles Floquet · 93155 Le Blanc Mesnil Cedex
CH HELIOS Ventilatoren AG · Tannstrasse 4 · 8112 Otelfingen GB HELIOS Ventilation Systems Ltd. · 5 Crown Gate · Wyncolls Road · Severalls Industrial Park ·
A HELIOS Ventilatoren · Postfach 854 · Siemensstraße 15 · 6023 Innsbruck Colchester · Essex · CO4 9HZ
Helios Ventilatoren
FUNCTIONAL AND INTERFACE DESCRIPTION NO. 82 269 UK

Building Control System Interface

Modbus Gateway TCP/IP with


ENGLISH
Helios Ventilatoren
FUNCTIONAL AND INTERFACE DESCRIPTION

Table of Contents
CHAPTER 1. GENERAL INFORMATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Page 1
1.0 General information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Page 1
1.1 Warning and safety instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Page 1
1.2 System requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Page 1
1.3 The Modbus interface (general) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Page 1
1.4 Modbus simulation – Programme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Page 1

CHAPTER 2. MODBUS WITH MODPOLL.EXE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Page 2


2.0 Example with the Modbus simulator modpoll.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Page 2
2.1 Writing of variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Page 2
1. example – Writing of variable v0003 System language – French . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Page 3
2. example – Writing of variable v00004 Date – 11.12.2013 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Page 3
2.2 Reading of variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Page 4
1. example – Reading of variable v00004 Date – 11.12.2013 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Page 4
2. example – Reading of outside air temperature sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Page 5
2.3 Reading an incorrect number of registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Page 5

CHAPTER 3. MODBUS WITH MODBUSPOLL.EXE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Page 6


3.0 Example with the Windows programme modbuspoll.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Page 6
3.1 Writing of variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Page 6
1. example – Writing of variable v00004 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Page 6
3.2 Reading of variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Page 7
1. example – Reading of variable v00004 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Page 7
2. example – Reading of variable v00104 – Outside air temperature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Page 8

CHAPTER 4. VARIABLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Page 9


4.0 Variable list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Page 9

CHAPTER 5. OTHER / NOTES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Page 19


5.0 Other / notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Page 19
Functional Description
Modbus Gateway TCP/IP – easyControls

UK
1.0 General information
CHAPTER 1
In order to ensure complete and effective operation and for your own safety, all of the following instructions should be
GENERAL
read carefully and observed. The relevant national standards, safety regulations and instructions (e.g. DIN EN VDE
INFORMATION 0100) as well as the technical connection conditions of the energy supply company must be observed and applied.

 1.1 Warning and safety instructions


The adjacent symbol is a safety-relevant warning symbol. All safety regulations and/or symbols must be abso-
lutely adhered to, so that any dangerous situation is avoided.

1.2 System requirements


IMPORTANT ☞ The unit control software version must be updated to at least version 2.01 (see Fig. below).
If an older version is installed on the KWL unit, the unit must be updated to the newest firmware version online in the
“Initial start-up” menu via the “update software now” button.
The corresponding settings are set in the "set-up network" menu and these are outlined in the EasyControls User Ma-
nual (No. 82 200).

1.3 The Modbus interface (general)


The communication of the KWL control system via Modbus is implemented with the Modbus TCP/IP protocol.
For this purpose, the TCP/IP-Port 502 is used.
IMPORTANT ☞ The Modbus address 180 must always be used!

Only the holding register supports read and write functions. Attempts to access another register will result in an error
message (ILLEGAL_DATA_ADDRESS).
When reading and writing, the start address is always the register address 1.
Each read and write access to a register is written in hexadecimal format and terminated with the ASCII character
“NUL” (0x00).
With regard to read access, it is necessary that the correct number of registers to be read (Count) is entered in the read
command.
The number is determined as follows:

Number of ASCII characters + null termination divided by 2 (rounded up)

1.4 Modbus simulation – Programme


In order to simulate the Modbus commands, the following programs are available on the internet:

a) The programme modpoll, as a free command line program, which runs on Windows in a DOSBox.
--> Download at: http://www.modbusdriver.com/modpoll.html

b) The Windows programme Modbus Poll, which can be used as a test version,
--> Download at: http://www.modbustools.com/modbus_poll.asp.

Furthermore, the Modbus demo programs are also available on the Helios website:

L IN K http://www.easycontrols.net ➞ Download

1
Functional Description
Modbus Gateway TCP/IP – easyControls

UK
2.0 Example with the Modbus simulator modpoll.exe
CHAPTER 2 The following examples (page 3) were carried out with the program “modpoll.exe” in a DOSBox on Windows.
The call-up in the DOS window is based on the following principle:
MOBBUS WITH
modpoll.exe -m tcp -a [Modbus address] -t4:hex -r 1 -0 -1 -o 2.0 [IP address] [variable number “vXXXXX\0” coded
MODPOLL.EXE
as HEX characters in 16 bit hex blocks]

The following parameters (see table) are used by modpoll.exe:

IMPORTANT ☞ Call-up: modpoll.exe [options] [host-IP] [command]

Command Meanings
-m tcp Definition of Modbus protocol TCP/IP
-a # Address of KWL unit to be controlled (1-255, default is 1)
-r # Start register (1-65536, default is 100)
-c Number of register values per call-up (1.100, default is 1)
-t4:hex 16-bit return of holding register, data displayed as HEX value
-1 (Number 1) Call-up just once, otherwise the command is sent each second
-0 (Number 0) The first reference is in place 0 (PDU address definition) rather than 1
-o # Time-out in seconds (0.01-10.0) Default is 1.0 seconds

2.1 Writing of variables


When writing via Modbus, the variables are coded in the format “VXXXXX=YYYYY...\0" as HEX characters.
The register start address is always 1.

Comparative table Conversion HEX and ASCII


The most frequently required values can be found in the following table:

HEX ASCII HEX ASCII HEX ASCII HEX ASCII


0x2E . 0x45 E 0x55 U 0x6B k
0x30 0 0x46 F 0x56 V 0x6C l
0x31 1 0x47 G 0x57 W 0x6D m
0x32 2 0x48 H 0x58 X 0x6E n
0x33 3 0x49 I 0x59 Y 0x6F o
0x34 4 0x4A J 0x5A Z 0x70 p
0x35 5 0x4B K 0x61 a 0x71 q
0x36 6 0x4C L 0x62 b 0x72 r
0x37 7 0x4D M 0x63 c 0x73 s
0x38 8 0x4E N 0x64 d 0x74 t
0x39 9 0x4F O 0x65 e 0x75 u
0x3D = 0x50 P 0x66 f 0x76 v
0x41 A 0x51 Q 0x67 g 0x77 w
0x42 B 0x52 R 0x68 h 0x78 x
0x43 C 0x53 S 0x69 i 0x79 y
0x44 D 0x54 T 0x6A j 0x7A z

2
Functional Description
Modbus Gateway TCP/IP – easyControls

UK
Example 1:
EXAMPLE ☞ Conversion of Variable v00102 from ASCII to HEX: “v00102=4” + End-Termination (termination):

ASCII HEX
“V” 76
“0” 30
“0” 30
“1” 31
“0” 30
“2” 32
“=” 3D
“4” 34
NUL 00

→ The HEX values are summarised in value pairs and preceded by 0x ("Null"x):
0x7630 0x3031 0x3032 0x3d34 0x0000
The number of registers (references) in this example = 5

→ Modbus call-up:
modpoll.exe -m tcp -a 180 -t4:hex -r 1 -0 -1 -o 2.0 192.168.1.10

Command Meaning
-m tcp Use protocol
-a 180 Use slave address 180 (always 180)
-r 1 Start reference. (always 1)
-0 Number Nil, First reference is 0. (always 0)
-1 Number One, Pole only once
-o 2.0 Letter “o” (lower case), Timeout 2 seconds
192.168.1.10 IP address of KWL unit

→ Summary of Modbus call-up and HEX-values for the following programme fetch:
Note: Write everything in one row.
modpoll.exe -m tcp -a 180 -t4:hex -r 1 -0 -1 -o 2.0 192.168.1.10 0x7630 0x3031 0x3032 0x3d34 0x0000
modpoll output: 5 values written (written 5 references)

EXAMPLE ☞ Example 2: – Writing of variable v0003 System language – French

Variable = v00003, value = fr (RegStr.BasisParameter.Language.SystemLanguage = fr):


Description Access Type count Variable Comment Range of validity
Min. Max.
Language RW char[2] 5 v00003 WR: “de”, “en”, “fr”, “sl” - -

ASCII “v” “0” “0” “0” “0” “3” “=” “f” “r” NUL
HEX 67 30 30 30 30 33 3D 66 75 00

modpoll -m tcp -a 180 -t4:hex -r 1 -0 -1 -o 2.0 192.168.1.10 0x7630 0x3030 0x3033 0x3D66 0x7200
modpoll output: 5 values written (written 5 references)

EXAMPLE ☞ Example 3: – Writing of variable v00004 Date – 11.12.2013

Variable = v00004, value = 11.12.13 (RegStr.DateTime.SystemDate.Day = 11,


RegStr.DateTime.SystemDate.Month = 12, RegStr.DateTime.SystemDate.Year = 13):
Description Access Type count Variable Comment Range of validity
Min. Max.
Datum RW char[10] 9 v00004 R: according to set format - -
(“dd.mm.yy” “yyyy.mm.dd”
“dd.mm.yyyyy”
W: Only in format: dd.mm.yy

ASCII “v” “0” “0” “0” “0” “4” “=” “1” “1” ”.” “1” “2” ”.” “1” “3” NUL
HEX 76 30 30 30 30 34 3d 31 31 2e 31 32 2e 31 33 00

modpoll -m tcp -a 180 -t4:hex -r 1 -0 -1 -o 2.0 192.168.1.10 0x7630 0x3030 0x3034 0x3d31 0x312e 0x3132 0x2e31 0x3300
modpoll output: 8 values written (written 8 references)

3
Functional Description
Modbus Gateway TCP/IP – easyControls

D
UK
2.2 Reading of variables
two-stage procedure is required for the reading of variables:

1. Firstly, the name of the variable to be read must be written in the format “vXXXXX\0” coded as HEX characters in the
Modbus register from register address 1.

2. The requested variable can be read from register address 1 with the subsequent query. The requested variable will
then be returned in the format “vXXXXX=YYYYY...\0" (coded as HEX characters).
In order for a variable to be read correctly, it is important that a sufficient number of registers are read. The
IMPORTANT ☞ number of registers is the number of HEX value pairs (as described above).

Reading an incorrect number of registers


If less registers are queried than are required for the output, the variable name will be returned in the format
“vXXXXX=YYYY....\0”.
If so few registers (count < 4) are queried that it is not possible for the Modbus slave to reply in the format
“vXXXXX=YYYY.....\0”, ILLEGAL_DATA_ADDRESS-Exception will be displayed.
If more registers are read than are required, the unneeded registers will be filled with 0x00.

IMPORTANT ☞ Example 1: – Reading of variable v00004 Date – 11.12.2013

Firstly, the variable to be read must be allocated to the Modbus register:


1. Writing of “v00004\0" coded as HEX characters (start address = 1)
Description Access Type count Variable Comment Range of validity
Min. Max.
Date RW char[10] 9 v00004 R: according to set format - -
(“dd.mm.yy” “yyyy.mm.dd”
“dd.mm.yyyyy”
W: Only in format: dd.mm.yy

ASCII “v” “0” “0” “0” “0” “4” NUL


HEX 76 30 30 30 30 34 00

modpoll -m tcp -a 180 -t4:hex -r 1 -0 -1 -o 2.0 192.168.1.10 0x7630 0x3030 0x3034 0x0000

– Programme output:
Protocol configuration: MODBUS/TCP
Slave configuration...: address = 180, start reference = 1 (PDU), count = 1
Communication.........: 10.8.11.61, port 502, t/o 2.00 s, poll rate 1000 ms
Data type.............: 16-bit register (hex), output (holding) register table
Written 4 references.

The value can now be read in the start address 1.

In this respect, the number (count) of register values, which can be seen in the variable overview in the
IMPORTANT ☞ "count" column of variables to be read, is important.

2. Reading of Modbus register from start address = 1, count = 9 (Count see variable overview):
modpoll -m tcp -a 180 -t4:hex -r 1 -c 9 -0 -1 -o 2.0 192.168.1.10

– KWL unit response:


Protocol configuration: MODBUS/TCP
Slave configuration...: address = 180, start reference = 1 (PDU), count = 9
Communication.........: 10.8.11.61, port 502, t/o 2.00 s, poll rate 1000 ms
Data type.............: 16-bit register (hex), output (holding) register table
-- Polling slave...

HEX values ASCII values


[1]: 0x7630 v0
[2]: 0x3030 00
[3]: 0x3034 04
[4]: 0x3D31 =1
[5]: 0x312E 1.
[6]: 0x3132 12
[7]: 0x2E30 .0
[8]: 0x3031 01
[9]: 0x3300 3/0

According to the conversion from HEX to ASCII, this response corresponds to: “v00004=11.12.0013\0“

4
Functional Description
Modbus Gateway TCP/IP – easyControls

D
UK
Example 2: – Reading of outside air temperature sensor
EXAMPLE ☞
Firstly, the variable to be read must be allocated to the Modbus register:
1. Writing of “v00104\0” coded as HEX characters (start address = 1):

ASCII “v” “0” “0” “0” “0” “4” NUL


HEX 76 30 30 30 30 34 00

modpoll.exe -m tcp -a 180 -t4:hex -r 1 -0 -1 -o 2.0 10.8.11.61 0x7630 0x3031 0x3034 0x0000

– Programme output:
Protocol configuration: MODBUS/TCP
Slave configuration...: address = 180, start reference = 1 (PDU), count = 1
Communication.........: 10.8.11.61, port 502, t/o 2.00 s, poll rate 1000 ms
Data type.............: 16-bit register (hex), output (holding) register table
Written 4 references.

2. Reading of Modbus register from start address 1, count = 8 :


modpoll.exe -m tcp -a 180 -t4:hex -r 1 -c 8 -0 -1 -o 2.0 10.8.11.61

– Programme output:
Protocol configuration: MODBUS/TCP
Slave configuration...: address = 180, start reference = 1 (PDU), count = 8
Communication.........: 10.8.11.61, port 502, t/o 2.00 s, poll rate 1000 ms
Data type.............: 16-bit register (hex), output (holding) register table
-- Polling slave...
HEX values ASCII values
[1]: 0x7630 V0
[2]: 0x3031 01
[3]: 0x3034 04
[4]: 0x3D32 =2
[5]: 0x352E 5.
[6]: 0x3500 50
[7]: 0x0000 00
[8]: 0x0000 00

RESULT ☞ This response corresponds to: 25.50 °C

2.3 Reading an incorrect number of registers


1. Reading of too few registers

Query start address = 1, count = 1


modpoll -m tcp -a 180 -t4:hex -r 1 -c 1 -0 -1 -o 2.0 192.168.1.10

– KWL unit response:


Illegal Data Address exception response!

2. Reading of too many registers

Query start address = 1, count = 11


modpoll -m tcp -a 180 -t4:hex -r 1 -c 11 -0 -1 -o 2.0 192.168.1.10

– KWL unit response:


HEX values ASCII values
[1]: 0x7630 v0
[2]: 0x3030 00
[3]: 0x3530 50
[4]: 0x3D00 =\0
[5]: 0x0000 00
[6]: 0x0000 00
[7]: 0x0000 00
[8]: 0x0000 00
[9]: 0x0000 00
[10]: 0x0000 00
[11]: 0x0000 00

This response corresponds to “v00050=\0“


RESULT ☞ In case of an excessive number of queried registers, the rest are returned without values with "0000".

5
Functional Description
Modbus Gateway TCP/IP – easyControls

UK
3.0 Example with the Windows programme modbuspoll.exe
CHAPTER 3
– Establishing a connection
MOBBUS WITH
In order to establish a connection with the control system via Modbus Poll, the following parameters must be set In the
MODBUSPOLL.EXE
programme “modbuspoll”:

As long as no other IP address has been assigned via DHCP, this is the standard: 192.168.1.199

3.1 Writing of variables

EXAMPLE ☞ Example 1: – Writing of variable v00004

Description Access Type count Variable Comment Range of validity


Min. Max.
Date RW char[10] 9 v00004 R: according to set format - -
(“dd.mm.yy” “yyyy.mm.dd”
“dd.mm.yyyyy”
W: Only in format: dd.mm.yy

Writing of Variable v00004


(RegStr.DateTime.SystemDate.Day, RegStr.DateTime.SystemDate.Month, RegStr.DateTime.SystemDate.Year)

1. Writing of current date: “v00004=24.04.2014\0“

6
Functional Description
Modbus Gateway TCP/IP – easyControls

UK
3.2 Reading of variables

EXAMPLE ☞ Example 1: – Reading of variable v00004


(RegStr.DateTime.SystemDate.Day, RegStr.DateTime.SystemDate.Month, RegStr.DateTime.SystemDate.Year)

1. Writing of “v00004\0" coded as ASCII characters (start address = 1)

2. Reading of Modbus register from start address = 1, count = 9:

The result is the output: “v00004=24.04.2014\0“


RESULT ☞ For this purpose, the contents of the nine Modbus registers must be converted into a ASCII character string.

7
Functional Description
Modbus Gateway TCP/IP – easyControls

UK
Example 2: – Reading of variable v00104 – Outside air temperature
EXAMPLE ☞
Description Access Type count Variable Comment Range of validity
Min. Max.
Outside air R char[7] 8 v00004 R: Format = .1f. -27 <9999
If val >= 9999 then “-”

Definitions for the reading of variable v00104:


Command 1 Command 2

Result of command 1 and 2:


RESULT ☞ The result 25.4 degrees is represented as a HEX value below in the right window:
3D=”=“ - 32=2 - 35=5 - 2E=”.“ - 34=4

8
Functional Description
Modbus Gateway TCP/IP – easyControls

UK
4.0 Variable list
CHAPTER 4 The registers which can be read and written are described in more detail below:
VARIABLES
– The “Description” column describes the membership of the variable.
– The available type of access is described by the “Access” column.
R stands for read, W stands for write and RW stands for read and write access.
– The “Type” column contains the characters to be expected. These should be specified when reading and writing via
Modbus.
– When writing, the exact number of characters must be specified, i.e. the value in the “count” column.
– The “Variables” column contains the names of the variables, which must be specified when accessing.
– The “Comments” involve the additional information concerning the format, length and other properties of the valu-
es.
– Finally, if available, the possible range of values for the variable is described in the “Range of validity” column.

Description Access Type count Variable Comment Range of validity


Min. Max.
Article description RW char[31] 20 v00000 W: 0 < strlen < 31 - -
Ref. no. RW char[16] 12 v00001 W: 0 < strlen < 17 - -
MAC address web server R char[18] 13 v00002 W: 0 < strlen < 17 - -
Language RW char[2] 5 v00003 WR: “de”, “en”, “fr”, “sl” - -
Date RW char[10] 9 v00004 R: according to set format - -
(“dd.mm.yy” “yyyy.mm.dd”
“dd.mm.yyyyy”
W: Only in format: dd.mm.yy
Time RW char[10] 9 v00005 R: Format: hh:mm:ss - -
W: Format: hh:mm:ss
Summer/winter RW char[1] 5 v00006 W: “o”-active - -
R: 0-wintertime,
1 = summertime
Enable auto. RW char[1] 5 v00007 W: “o”-active - -
software updates R: 0-wintertime
1 = activated
Enable access to Helios RW char[1] 5 v00008 W: “o”-active - -
portal R: 0-wintertime
1 = activated
Voltage fan stage 1 RW char[3] 6 v00012 R: Format = .1f 1.6 10
Extract air
Voltage fan stage 1 RW char[3] 6 v00013 R: Format = .1f 1.6 10
Supply air
Voltage fan stage 2 RW char[3] 6 v00014 R: Format = .1f 1.6 10
Extract air
Voltage fan stage 2 RW char[3] 6 v00015 R: Format = .1f 1.6 10
Supply air
Voltage fan stage 3 RW char[3] 6 v00016 R: Format = .1f 1.6 10
Extract air
Voltage fan stage 3 RW char[3] 6 v00017 R: Format = .1f 1.6 10
Supply air
Voltage fan stage 4 RW char[3] 6 v00018 R: Format = .1f 1.6 10
Extract air
Voltage fan stage 4 RW char[3] 6 v00019 R: Format = .1f 1.6 10
Supply air
Min. fan stage RW char[1] 5 v00020 RW: Fan stage 0 1

KWL-BE activated RW char[1] 5 v00020 RW: 0 = Off 0 1


1 = On
KWL-BEC activated RW char[1] 5 v00022 RW: 0 = Off 0 1
1 = On
Unit configuration RW char[1] 5 v00023 RW: 1-DiBt 1 2
2-Passivhaus

9
Functional Description
Modbus Gateway TCP/IP – easyControls

UK
Description Access Type count Variable Comment Range of validity
Min. Max.
Pre-heater status RW char[1] 5 v00024 RW: 0 = Off 0 1
1 = On
KWL-FTF config 0 RW char[1] 5 v00025 RW: 1=RF, 1 3
2=Temp., 3=Combined
KWL-FTF config 1 RW char[1] 5 v00026 RW: 1=RF, 1 3
2=Temp., 3=Combined
KWL-FTF config 2 RW char[1] 5 v00027 RW: 1=RF, 1 3
2=Temp., 3=Combined
KWL-FTF config 3 RW char[1] 5 v00028 RW: 1=RF, 1 3
2=Temp., 3=Combined
KWL-FTF config 4 RW char[10] 5 v00029 RW: 1=RF, 1 3
2=Temp., 3=Combined
KWL-FTF config 5 RW char[1] 5 v00030 RW: 1=RF, 1 3
2=Temp., 3=Combined
KWL-FTF config 6 RW char[1] 5 v00031 RW: 1=RF, 1 3
2=Temp., 3=Combined
KWL-FTF config 7 RW char[1] 5 v00032 RW: 1=RF, 0 2
2=Temp., 3=Combined
Humidity control status RW char[1] 5 v00033 RW: 1=RF, 0 2
2=Temp., 3=Combined
Humidity control RW char[2] 5 v00034 RW: in percentage 20 % 80 %
set value
Humidity control steps RW char[2] 5 v00035 RW: in percentage 5% 20 %

Humidity control stop time RW char[2] 5 v00036 RW: in hours 0h 24 h

CO2 control RW char[1] 5 v00037 RW: 0=Off, 0 2


Status 2 = Stepped, 3 = Continuous
CO2 control RW char[4] 6 v00038 RW: in ppm 300 2000
set value
CO2 control RW char[3] 6 v00039 RW: in ppm 50 400
steps
VOC control RW char[1] 5 v00040 RW: 0=Off, 0 2
Status 2 = Stepped, 3 = Continuous
VOC control RW char[4] 6 v00041 RW: in ppm 300 2000
set value
VOC control RW char[3] 6 v00042 RW: in ppm 50 400
steps
Comfort temp. RW char[4] 6 v00043 R: Format = .1f 10 25

Time zone difference to RW char[3] 6 v00051 RW: Time zones -12 14


GMT
Date format RW char[1] 5 v00052 R: 0 = “dd.mm.yy”, 0 2
1 = “mm.dd.yyyy”,
2 = “yyyyy.mm.dd”
Heat exchanger type RW char[1] 5 v00053 RW: 1 = “Polymer” 1 3
2 = “Aluminium”
3 = “Enthalpy”
Party-mode RW char[3] 6 v00091 RW: in minutes 5 180
Duration
Party-mode RW char[3] 5 v00092 RW: Fan stage 0 4
Fan stage
Party-mode R char[3] 6 v00093 RW: in minutes 0 180
Remaining time
Party-mode RW char[1] 5 v00094 RW: 0 = Off 0 1
Activate/deactivate 1 = On
Standby-mode RW char[3] 6 v00096 RW: in minutes 5 180
Duration

10
Functional Description
Modbus Gateway TCP/IP – easyControls

UK
Description Access Type count Variable Comment Range of validity
Min. Max.
Standby-mode RW char[1] 5 v00097 RW: Fan stage 0 4
Fan stage
Standby-mode R char[3] 6 v00098 R: in minutes 0 180
Remaining time
Standby-mode RW char[1] 5 v00099 RW: 0 = Off 0 1
Activate/deactivate 1 = On
Operating mode RW char[1] 5 v00101 R: 0 = Automatic. 0 1
1 = Manual
W: 0 = Automatic.
1 = Manual
Fan stage RW char[1] 5 v00102 RW: Fan stage 0 4
Percentage R char[3] 6 v00103 R: percentage 0 100
Fan stage fan control
Temperature R char[7] 8 v00104 R: Format = .1f. If -27 <9999
Outside air val >=9999 the “-”
Temperature R char[7] 8 v00105 R: Format = .1f. If -27 <9999
Supply air val >=9999 the “-”
Temperature R char[7] 8 v00106 R: Format = .1f. If -27 <9999
Outgoing air val >=9999 the “-”
Temperature R char[7] 8 v00107 R: Format = .1f. If -27 <9999
Extract air val >=9999 the “-”
VHZ duct sensor R char[7] 8 v00108 R: Format = .1f. If -27 <9999
(outside air – T5) val >=9999 the “-”
NHZ return sensor R char[7] 8 v00110 R: Format = .1f. If -27 <9999
(hot water register – T7) val >=9999 the “-”

External sensor R char[4] 6 v00111 R: If val >=9999 0 <9999


KWL-FTF humid. 1 then “-”
External sensor R char[4] 6 v00112 R: If val >=9999 0 <9999
KWL-FTF humid. 2 then “-”
External sensor R char[4] 6 v00113 R: If val >=9999 0 <9999
KWL-FTF humid. 3 then “-”
External sensor R char[4] 6 v00114 R: If val >=9999 0 <9999
KWL-FTF humid. 4 then “-”
External sensor R char[4] 6 v00115 R: If val >=9999 0 <9999
KWL-FTF humid. 5 then “-”
External sensor R char[4] 6 v00116 R: If val >=9999 0 <9999
KWL-FTF humid. 16 then “-”
External sensor R char[4] 6 v00117 R: If val >=9999 0 <9999
KWL-FTF humid. 7 then “-”
External sensor R char[4] 6 v00118 R: If val >=9999 0 <9999
KWL-FTF humid. 8 then “-”

11
Functional Description
Modbus Gateway TCP/IP – easyControls

UK
Description Access Type count Variable Comment Range of validity
Min. Max.
External sensor R char[7] 8 v00119 R: Format = .1f. If -27 <9999
KWL-FTF Temp 1 val >=9999 then “-”
External sensor R char[7] 8 v00120 R: Format = .1f. If -27 <9999
KWL-FTF Temp 2 val >=9999 then “-”
External sensor R char[7] 8 v00121 R: Format = .1f. If -27 <9999
KWL-FTF Temp 3 val >=9999 then “-”
External sensor R char[7] 8 v00122 R: Format = .1f. If -27 <9999
KWL-FTF Temp 4 val >=9999 then “-”
External sensor R char[7] 8 v00123 R: Format = .1f. If -27 <9999
KWL-FTF Temp 5 val >=9999 then “-”
External sensor R char[7] 8 v00124 R: Format = .1f. If -27 <9999
KWL-FTF Temp 6 val >=9999 then “-”
External sensor R char[7] 8 v00125 R: Format = .1f. If -27 <9999
KWL-FTF Temp 7 val >=9999 then “-”
External sensor R char[7] 8 v00126 R: Format = .1f. If -27 <9999
KWL-FTF Temp 8 val >=9999 then “-”
External sensor R char[4] 6 v00128 R: Format = .1f. If 0 <9999
KWL-CO2 1 val >=9999 then “-”
External sensor R char[4] 6 v00129 R: Format = .1f. If 0 <9999
KWL-CO2 2 val >=9999 then “-”
External sensor R char[4] 6 v00130 R: Format = .1f. If 0 <9999
KWL-CO2 3 val >=9999 then “-”
External sensor R char[4] 6 v00131 R: Format = .1f. If 0 <9999
KWL-CO2 4 val >=9999 then “-”
External sensor R char[4] 6 v00132 R: If val >=9999 0 <9999
KWL-CO2 5 then “-”
External sensor R char[4] 6 v00133 R: If val >=9999 0 <9999
KWL-CO2 6 then “-”
External sensor R char[4] 6 v00134 R: If val >=9999 0 <9999
KWL-CO2 7 then “-”
External sensor R char[4] 6 v00135 R: If val >=9999 0 <9999
KWL-CO2 8 then “-”
External sensor R char[4] 6 v00136 R: If val >=9999 0 <9999
KWL-VOC 1 then “-”
External sensor R char[4] 6 v00137 R: If val >=9999 0 <9999
KWL-VOC 2 then “-”
External sensor R char[4] 6 v00138 R: If val >=9999 0 <9999
KWL-VOC 3 then “-”
External sensor R char[4] 6 v00139 R: If val >=9999 0 <9999
KWL-VOC 4 then “-”
External sensor R char[4] 6 v00140 R: If val >=9999 0 <9999
KWL-VOC 5 then “-”
External sensor R char[4] 6 v00141 R: If val >=9999 0 <9999
KWL-VOC 6 then “-”
External sensor R char[4] 6 v00142 R: If val >=9999 0 <9999
KWL-VOC 7 then “-”
External sensor R char[4] 6 v00143 R: If val >=9999 0 <9999
KWL-VOC 8 then “-”
NHZ duct sensor R char[7] 8 v00146 R: Format = .1f. If -27 <9999
(-supply air- T6) val >=9999 then “-”
Week profile NHZ RW char[1] 5 v00201 RW: Value for the variables: 0 6
v00230..v00259 (y)
0 = Standard 1;
1 = Standard 2;
2 = Fixed value;
3 = Individual 1;
4 = Individual 2;
5 = NA; 6 = Off
Ser. No. RW char[16] 12 v00303 W: 0 < strlen > 16 - -
ProdCode RW char[13] 11 v00304 W: 0 < strlen > 13 - -
Supply air rpm R char[4] 6 v00348 R: min -1 0 9999
Extract air rpm R char[4] 6 v00349 R: min -1 0 9999
Logout W char[1] 5 v00403 W: Logout 1 1

12
Functional Description
Modbus Gateway TCP/IP – easyControls

UK
Description Access Type count Variable Comment Range of validity
Min. Max.
Holiday programme RW char[1] 5 v00601 RW: 0-Off; 0 2
1-Interval; 2-Constant
Fan stage RW char[1] 5 v00602 RW: Fan stage 1 4
Holiday programme
Start RW char[10] 9 v00603 RW: according to set format - -
(“dd.mm.yy” “yyyy.mm.dd”
“dd.mm.yyyyy”
End RW char[10] 9 v00604 RW: according to set format - -
(“dd.mm.yy” “yyyy.mm.dd”
“dd.mm.yyyyy”
Interval RW char[2] 5 v00605 RW: Time in hours 1 24

Activation time RW char[3] 6 v00606 RW: in minutes 5 300

VHZ type RW char[1] 5 v01010 RW: 1 = EH-basis; 2 = EH- 1 4


ERW; 3 = SEWT; 4 =
1-Interval; 2-Constant
Function type RW char[1] 5 v01017 RW: 1 = Function 1, 1 2
KWL-EM (assignm. relays 2 = Function 2
to terminal/error outputs)
Run-on time VHZ/NHZ RW char[3] 6 v01019 RW: Run-on time in sec. 60 120

External contact RW char[1] 5 v01020 RW: 1 = Function 1; 1 6


2 = Function 2;
3 = Function 3; ...
Error output function: RW char[1] 5 v01021 RW: 1 = collective error; 1 2
Collective error 2 = only error 2
or just error
Filter change RW char[1] 5 v01031 RW: 0 = No 0 1
1 = Yes
Change interval RW char[2] 5 v01032 RW: change interval 0 12
in months
Remaining time R char[10] 9 v01033 RW: in minutes 2 232-1

Bypass RW char[2] 5 v01035 RW: in °C 10 40


Room/temp.
Bypass RW char[2] 5 v01036 RW: in °C 5 20
min. outside temp.
RW char[2] 5 v01037 RW: in °C 3 10
Factory setting RW char[1] 5 v01041 W: 1 = Reset individual 1 1
WZU switching times
Factory reset RW char[1] 5 v01042 W: 1 = Reset Start 1 1
Supply air RW char[1] 5 v01050 RW: Fan stage 1 4
Extract air RW char[1] 5 v01051 RW: Fan stage 1 4
Assignment fan stages RW char[1] 5 v01061 RW: Fan stage 0 2
(for stepped) range 0-2
Assignment fan stages RW char[1] 5 v01062 RW: Fan stage 0 4
(for stepped) range 2-4
Assignment fan stages RW char[1] 5 v01063 RW: Fan stage 0 4
(for stepped) range 4-6
Assignment fan stages RW char[1] 5 v01064 RW: Fan stage 0 4
(for stepped) range 6-8
Assignment fan stages RW char[10] 5 v01065 RW: Fan stage 0 4
(for stepped) range 8-10
Offset extract air RW char[10] 9 v01066 RW: (Float_Value)
Assignment fan stages RW char[1] 5 v01068 W: 0 = 0...10V; 0 1
Stepped or 0-10 Volt 1 = stepped
Sensor name RW char[15] 12 v01071 W: 0 < strlen > 15 - -
Humidity and Temp.
Sensor name RW char[15] 12 v01072 W: 0 < strlen > 15 - -
Humidity and Temp.

13
Functional Description
Modbus Gateway TCP/IP – easyControls

UK
Description Access Type count Variable Comment Range of validity
Min. Max.
Sensor name RW char[15] 12 v01073 W: 0 < strlen > 15 - -
Humidity and Temp.
Sensor name RW char[15] 12 v01074 W: 0 < strlen > 15 - -
Humidity and Temp.
Sensor name RW char[15] 12 v01075 W: 0 < strlen > 15 - -
Humidity and Temp.
Sensor name RW char[15] 12 v01076 W: 0 < strlen > 15 - -
Humidity and Temp.
Sensor name RW char[15] 12 v01077 W: 0 < strlen > 15 - -
Humidity and Temp.
Sensor name RW char[15] 12 v01078 W: 0 < strlen > 15 - -
Humidity and Temp.
Sensor name CO2 RW char[15] 12 v01081 W: 0 < strlen > 15 - -
Sensor name CO2 RW char[15] 12 v01082 W: 0 < strlen > 15 - -
Sensor name CO2 RW char[15] 12 v01083 W: 0 < strlen > 15 - -
Sensor name CO2 RW char[15] 12 v01084 W: 0 < strlen > 15 - -
Sensor name CO2 RW char[15] 12 v01085 W: 0 < strlen > 15 - -
Sensor name CO2 RW char[15] 12 v01086 W: 0 < strlen > 15 - -
Sensor name CO2 RW char[15] 12 v01087 W: 0 < strlen > 15 - -
Sensor name CO2 R char[15] 12 v01088 W: 0 < strlen > 15 - -
Sensor name VOC RW char[15] 12 v01091 W: 0 < strlen > 15 - -
Sensor name VOC RW char[15] 12 v01092 W: 0 < strlen > 15 - -
Sensor name VOC RW char[15] 12 v01093 W: 0 < strlen > 15 - -
Sensor name VOC RW char[15] 12 v01094 W: 0 < strlen > 15 - -
Sensor name VOC RW char[15] 12 v01095 W: 0 < strlen > 15 - -
Sensor name VOC RW char[15] 12 v01096 W: 0 < strlen > 15 - -
Sensor name VOC RW char[15] 12 v01097 W: 0 < strlen > 15 - -
Sensor name VOC RW char[15] 12 v01098 W: 0 < strlen > 15 - -
Software version basis R char[5] 7 v01101 R: Format "xx.xx" 0 99.99
Op. hours Supply air vent. R char[10] 9 v01103 in minutes 0 232-1
Op. hours Extract air vent. R char[10] 9 v01104 in minutes 0 232-1
Op. hours VHZ R char[10] 9 v01105 in minutes 0 232-1
Op. hours NHZ R char[10] 9 v01106 in minutes 0 232-1
Output power R char[10] 9 v01108 Value/100 0 232-1
VHZ in %
Output power R char[10] 9 v01109 Value/100 0 232-1
NHZ in %
Reset Flag R char[1] 5 v01120 W: 1 = Reset Flag 1 1

14
Functional Description
Modbus Gateway TCP/IP – easyControls

UK
Description Access Type count Variable Comment Range of validity
Min. Max.
Error R char[10] 9 v01123 R: Errors as Int. value (see table 0 232-1
“coding”)
Note: V01303 - V013066
Warnings R char[3] 6 v01124 R: Warnings as Int. value (see 0 28-1
table “coding”)
Note: V01303 - V01306
Infos R char[3] 6 v01125 R: Infos as Int. value (see table 0 28-1
“coding”)
Note: V01303 - V01306
Number of errors R char[2] 5 v01300 R: Number of bit-coded errors 0 32
from V01303
Number of warnings R char[1] 5 v01301 R: Number of bit-coded war- 0 8
nings from V01304
Number of infos R char[1] 5 v01302 R: Number of bit-coded infos 0 8
from V01305
Errors R char[32] 20 v01303 R: Errors as string - -
(see table “coding”)
Note: V01123 – V01125
Warnings R char[8] 8 v01304 R: Warnings as string - -
(see table “coding”)
Note: V01123 – V01125
Infos R char[8] 8 v01305 R: Infos as string - -
(see table “coding”)
Note: V01123 – V01125
Statusflags R char[32] 20 v01306 R: Sysflags as string - -
(see table “coding”)
KWL-FTF config 1 R char[1] 5 v02020 R: 0 = No sensor, 0 1
1=Sensor installed
KWL-FTF config 2 R char[1] 5 v02021 R: 0 = No sensor, 0 1
1=Sensor installed
KWL-FTF config 3 R char[1] 5 v02022 R: 0 = No sensor, 0 1
1=Sensor installed
KWL-FTF config 4 R char[1] 9 v02023 R: 0 = No sensor, 0 1
1=Sensor installed
KWL-FTF config 5 R char[1] 5 v02024 R: 0 = No sensor, 0 1
1=Sensor installed
KWL-FTF config 6 R char[1] 5 v02025 R: 0 = No sensor, 0 1
1=Sensor installed
KWL-FTF config 7 R char[1] 5 v02026 R: 0 = No sensor, 0 1
1=Sensor installed
KWL-FTF config 8 R char[1] 5 v02027 R: 0 = No sensor, 0 1
1=Sensor installed
Global.ManualWeb- RW char[1] 5 v02013 RW: 1 = Manual update of data 1 1
Update (Profile 8: XGP, XWP, Firmware,
SD-Files are started)
0 = Download not started or
completed
PortalGlobals.Error- R char[3] 6 v02014 R: Always the latest error that 1 255
ForWeb has occurred
Clear error W char[1] 5 v02015 W: 1 = Error is reset 1 1
(PortalGlobals.ErrorForWeb)

15
Functional Description
Modbus Gateway TCP/IP – easyControls

UK
Table “Coding“

Error (Variable V01303)

Bit Bitmask Error no. Mask (hex) Error description

0 0000 0000 0000 0000 0000 0000 0000 0001 1 0x00000001 Fan speed error "Supply air" (outside air)
1 0000 0000 0000 0000 0000 0000 0000 0010 2 0x00000002 Fan speed error "Extract air" (outgoing air)
2 0000 0000 0000 0000 0000 0000 0000 0100 3 0x00000004 -free-
3 0000 0000 0000 0000 0000 0000 0000 1000 4 0x00000008 SD card error when writing E-Eprom data with
"FLASH ring buffer FULL"

4 0000 0000 0000 0000 0000 0000 0001 0000 5 0x00000010 Bus overcurrent
5 0000 0000 0000 0000 0000 0000 0010 0000 6 0x00000020 -free-
6 0000 0000 0000 0000 0000 0000 0100 0000 7 0x00000040 BASIS: 0-Xing error VHZ EH (0-Xing = Zero-
Crossing, Zero-crossing detection)

7 0000 0000 0000 0000 0000 0000 1000 0000 8 0x00000080 Ext. module (VHZ): 0-Xing error VHZ EH

8 0000 0000 0000 0000 0000 0001 0000 0000 9 0x00000100 Ext. module (NHZ): 0-Xing error NHZ EH

9 0000 0000 0000 0000 0000 0010 0000 0000 10 0x00000200 BASIS: Internal temp. sensor error - (T1) -Outside
air (missing or cable break)
10 0000 0000 0000 0000 0000 0100 0000 0000 11 0x00000400 BASIS: Internal temp. sensor error - (T2) -Supply
air- (missing or cable break)
11 0000 0000 0000 0000 0000 1000 0000 0000 12 0x00000800 BASIS: Internal temp. sensor error - (T3) -Extract
air- (missing or cable break)
12 0000 0000 0000 0000 0001 0000 0000 0000 13 0x00001000 BASIS: Internal temp. sensor error - (T4) -Out-
going air- (missing or cable break)
13 0000 0000 0000 0000 0010 0000 0000 0000 14 0x00002000 BASIS: Internal temp. sensor error - (T1) -Outside
air- (short circuit)
14 0000 0000 0000 0000 0100 0000 0000 0000 15 0x00004000 BASIS: Internal temp. sensor error - (T2) -Supply
air- (short circuit)
15 0000 0000 0000 0000 1000 0000 0000 0000 16 0x00008000 BASIS: Internal temp. sensor error - (T3) -Extract
air- (short circuit)
16 0000 0000 0000 0001 0000 0000 0000 0000 17 0x00010000 BASIS: Internal temp. sensor error - (T4) -Out-
going air- (short circuit)
17 0000 0000 0000 0010 0000 0000 0000 0000 18 0x00020000 Ext. module configured as VHZ, but missing or
malfunctioned
18 0000 0000 0000 0100 0000 0000 0000 0000 19 0x00040000 Ext. module configured as NHZ, but missing or
malfunctioned
19 0000 0000 0000 1000 0000 0000 0000 0000 20 0x00080000 Ext. module (VHZ): Duct sensor (T5) -Outside air-
(missing or cable break)
20 0000 0000 0001 0000 0000 0000 0000 0000 21 0x00100000 Ext. module (NHZ): Duct sensor (T6) -Supply air-
(missing or cable break)
21 0000 0000 0010 0000 0000 0000 0000 0000 22 0x00200000 Ext. module (NHZ): Duct sensor (T7) -Return WW-
Register- (missing or cable break)
22 0000 0000 0100 0000 0000 0000 0000 0000 23 0x00400000 Ext. module (VHZ): Duct sensor (T5) -Outside air-
(short circuit)
23 0000 0000 1000 0000 0000 0000 0000 0000 24 0x00800000 Ext. module (NHZ): Duct sensor (T6) -Supply air-
(short circuit)
24 0000 0001 0000 0000 0000 0000 0000 0000 25 0x01000000 Ext. module (NHZ): Duct sensor (T7) -Return WW-
Register- (short circuit)
25 0000 0010 0000 0000 0000 0000 0000 0000 26 0x02000000 Ext. module (VHZ): Safety limiter automatic

26 0000 0100 0000 0000 0000 0000 0000 0000 27 0x04000000 Ext. module (VHZ): Safety limiter manual
27 0000 1000 0000 0000 0000 0000 0000 0000 28 0x08000000 Ext. module (NHZ): Safety limiter automatic

28 0001 0000 0000 0000 0000 0000 0000 0000 29 0x10000000 Ext. module (NHZ): Safety limiter manual
29 0010 0000 0000 0000 0000 0000 0000 0000 30 0x20000000 Ext. module (NHZ): Frost protection WW-Reg.
measured via WW-return (T7) (switching threshold
adjustable per variable list e.g. < 7°C)
30 0100 0000 0000 0000 0000 0000 0000 0000 31 0x40000000 Ext. module (NHZ): Frost protection WW-Reg.
measured via supply air sensor (T6)
(switching threshold adjustable per variable list
e.g. < 7°C)
31 1000 0000 0000 0000 0000 0000 0000 0000 32 0x80000000 Frost protection external WW Reg.: ( fixed < 5°C
only PHI), measured either via
(1.) Ext. module (NHZ): Supply air duct sensor (T6)
or
(2.) BASIS: Supply air duct sensor (T2)

16
Functional Description
Modbus Gateway TCP/IP – easyControls

UK
Table “Coding“

Warnings (Variable V01304)


Bit Bitmask Error no. Mask (hex) Error description

0 0000 0001 1 0x01 Internal humidity sensor provides no value


1 0000 0010 2 0x02 -free-
2 0000 0100 3 0x04 -free-
3 0000 1000 4 0x08 -free-
4 0001 0000 5 0x10 -free-
5 0010 0000 6 0x20 -free-
6 0100 0000 7 0x40 -free-
7 1000 0000 8 0x80 -free-

Infos (Variable V01305)


Bit Bitmask Error no. Mask (hex) Error description

0 0000 0001 1 0x01 Filter change


1 0000 0010 2 0x02 Frost protection WT
2 0000 0100 3 0x04 SD card error
3 0000 1000 4 0x08 Failure of external module (more info in LOG-File)

4 0001 0000 5 0x10 -free-


5 0010 0000 6 0x20 -free-
6 0100 0000 7 0x40 -free-
7 1000 0000 8 0x80 -free-

StateFlags (Variable V01306)

Bit Bitmask Error no. Mask (hex) Error description

0 0000 0000 0000 0000 0000 0000 0000 0001 1 0x00000001 1 = SYSTEM pre-initialised (display in BT in the
meantime: SYSTEM BOOTING)
1 0000 0000 0000 0000 0000 0000 0000 0010 2 0x00000002 1 = SYSTEM Software update active (display in
BT in the meantime: SYSTEM LOADING)
2 0000 0000 0000 0000 0000 0000 0000 0100 3 0x00000004 1 = Firmware update is activated
3 0000 0000 0000 0000 0000 0000 0000 1000 4 0x00000008 1 = INBA is active
4 0000 0000 0000 0000 0000 0000 0001 0000 5 0x00000010 1 = Party mode
5 0000 0000 0000 0000 0000 0000 0010 0000 6 0x00000020 1 = Standby mode
6 0000 0000 0000 0000 0000 0000 0100 0000 7 0x00000040 1 = Holiday mode
7 0000 0000 0000 0000 0000 0000 1000 0000 8 0x00000080 1 = VHZ is configured on BASIS-Module
8 0000 0000 0000 0000 0000 0001 0000 0000 9 0x00000100 1 = VHZ is configured on ext. module
9 0000 0000 0000 0000 0000 0010 0000 0000 10 0x00000200 1 = Ext. module VHZ active (e.g. BT display: Me-
nu item VHZ overlay)
10 0000 0000 0000 0000 0000 0100 0000 0000 11 0x00000400 1 = VHZ configured
11 0000 0000 0000 0000 0000 1000 0000 0000 12 0x00000800 VHZ: Heating type (0 = Electrical / 1 = brine
(earth or air)
12 0000 0000 0000 0000 0001 0000 0000 0000 13 0x00001000 1 = NHZ configured (temperature profile set une-
qual HEATING OFF)
13 0000 0000 0000 0000 0010 0000 0000 0000 14 0x00002000 1 = Ext. module NHZ active (e.g. BT display: Me-
nu item NHZ overlay)
14 0000 0000 0000 0000 0100 0000 0000 0000 15 0x00004000 1 = NHZ active (control, error, identical to "Auxilia-
ry heating.On")
15 0000 0000 0000 0000 1000 0000 0000 0000 16 0x00008000 NHZ: Heating type (0 = Electrical / 1 = Warm wa-
ter)
16 0000 0000 0000 0001 0000 0000 0000 0000 17 0x00010000 1 = CO2 control on
17 0000 0000 0000 0010 0000 0000 0000 0000 18 0x00020000 1 = Humi control on
18 0000 0000 0000 0100 0000 0000 0000 0000 19 0x00040000 1 = VOC control on
19 0000 0000 0000 1000 0000 0000 0000 0000 20 0x00080000 -free-
20 0000 0000 0001 0000 0000 0000 0000 0000 21 0x00100000 1 = min. an external contact connected (EM or
ES)
21 0000 0000 0010 0000 0000 0000 0000 0000 22 0x00200000 1 = External contact function ACTIVE
22 0000 0000 0100 0000 0000 0000 0000 0000 23 0x00400000 1 = External access permitted
23 0000 0000 1000 0000 0000 0000 0000 0000 24 0x00800000 1 = External access active
24 0000 0001 0000 0000 0000 0000 0000 0000 25 0x01000000 1 = Defrost heat exchanger

17
Functional Description
Modbus Gateway TCP/IP – easyControls

UK StateFlags (Variable V01306)

Bit Bitmask Error no. Mask (hex) Error description

25 0000 0010 0000 0000 0000 0000 0000 0000 26 0x02000000 1 = Defrost Warm water register
26 0000 0100 0000 0000 0000 0000 0000 0000 27 0x04000000 1 = Filter change due
27 0000 1000 0000 0000 0000 0000 0000 0000 28 0x08000000 1 = Config_1 (DIBT) / 0 = Config_2 (PHI)
28 0001 0000 0000 0000 0000 0000 0000 0000 29 0x10000000 1 = BEC-U1 deactivated via Web (pure display
function)
29 0010 0000 0000 0000 0000 0000 0000 0000 30 0x20000000 1 = Lock control panel
30 0100 0000 0000 0000 0000 0000 0000 0000 31 0x40000000 1 = Master Password required (set when incor-
rect pw has been entered 3 times)
31 1000 0000 0000 0000 0000 0000 0000 0000 32 0x80000000 1 = Fan stage display in %

18
Functional Description
Modbus Gateway TCP/IP – easyControls

UK
5.0 Other / notes
CHAPTER 5 All external names, trademarks, WWW links used are the property of the respective companies and are in no way
connected to Helios Ventilatoren GmbH + Co KG, hereinafter Helios. The owners are responsible for the content of
OTHER/NOTES
the respective WWW links.

Helios accepts no liability for textual errors. figures and the information is non-binding.
The right is reserved to make technical changes without notification.
ATTENTION ☞ Use of the protocol Modbus is at the user's own risk.

19
Functional Description
Modbus Gateway TCP/IP – easyControls

Notes:

20
Functional Description
Modbus Gateway TCP/IP – easyControls

Notes:

21
All illustrations are without warranty!
Please keep this manual for reference with the unit! Print no. 82 269/09.16 www.heliosventilatoren.de
Service and Information
D HELIOS Ventilatoren GmbH + Co KG · Lupfenstraße 8 · 78056 VS-Schwenningen F HELIOS Ventilateurs · Le Carré des Aviateurs · 157 avenue Charles Floquet · 93155 Le Blanc Mesnil Cedex
CH HELIOS Ventilatoren AG · Tannstrasse 4 · 8112 Otelfingen GB HELIOS Ventilation Systems Ltd. · 5 Crown Gate · Wyncolls Road · Severalls Industrial Park ·
A HELIOS Ventilatoren · Postfach 854 · Siemensstraße 15 · 6023 Innsbruck Colchester · Essex · CO4 9HZ