Siemens S7¶
Eigener Registerblock, kein SunSpec
Der WattWächter Gas spricht kein SunSpec wie der WattWächter Plus, sondern liefert einen eigenen Registerblock an den Protokolladressen 41000–41031 — siehe Modbus TCP → Registerblock. Alle Beispiele auf dieser Seite lesen diesen Block.
Der WattWächter Gas lässt sich über seinen Modbus-TCP-Server direkt an eine SIMATIC S7-1200 oder S7-1500 anbinden. Nötig ist dafür nur die Anweisung MB_CLIENT aus der TIA-Portal-Bibliothek — kein Zusatzmodul, kein CP.
Das Wichtigste zuerst: die Adressumrechnung
MB_CLIENT erwartet am Parameter MB_DATA_ADDR keine Protokolladresse, sondern
eine Modicon-Referenz — und rechnet sie vor dem Senden um. Wer die Adressen aus der
Registertabelle unverändert einträgt,
liest eine völlig andere Stelle und bekommt leere Register. Siehe
Adressen umrechnen.
Voraussetzungen¶
-
WattWächter Gas eingerichtet und mit dem WLAN verbunden
-
Modbus TCP am WattWächter aktiviert — Weboberfläche → Einstellungen → Modbus TCP → Modbus-TCP-Server aktivieren → Speichern. Weitere Wege unter Modbus TCP → Aktivieren
- S7-1200 oder S7-1500 mit integrierter PROFINET-Schnittstelle im selben Netzwerk
- TIA Portal mit der Anweisung
MB_CLIENT(Kommunikation → Weitere → MODBUS TCP) - Eine feste IP-Adresse für den WattWächter — per DHCP-Reservierung im Router oder fest am Gerät eingestellt. Wie du die aktuelle IP findest, steht in den FAQs
Der Loxone-Hinweis gilt auch hier
Die S7 löst keine mDNS-/.local-Namen auf. In die Verbindungsparameter gehört die
IP-Adresse, nicht wattwaechter-XXXXXXXXXXXX.local.
Adressen umrechnen¶
Alle Adressen in unserer Dokumentation sind Protokolladressen — die Zahl, die im Modbus-Telegramm steht. MB_DATA_ADDR nimmt stattdessen eine Modicon-Referenz entgegen und zieht davon ab:
Eingabe an MB_DATA_ADDR |
gesendete Protokolladresse | Function Code bei MB_MODE = 0 |
|---|---|---|
| 40001 … 49999 | Eingabe − 40001 | 0x03 Read Holding Registers |
| 400001 … 465535 | Eingabe − 400001 | 0x03 Read Holding Registers |
Der Bereich 40001–49999 reicht damit nur bis zur Protokolladresse 9998 — für die Register des WattWächters ist er unbrauchbar. Es gilt ausschließlich:
MB_DATA_ADDR = Protokolladresse + 400001
| Was | Protokolladresse | MB_DATA_ADDR |
|---|---|---|
Kennung "WWGW", Beginn des Blocks |
41000 | 441001 |
Zählerstand Vol |
41010 | 441011 |
Durchfluss VolFlw |
41012 | 441013 |
Energie Ene (nur Gas) |
41014 | 441015 |
Leistung Pwr (nur Gas) |
41020 | 441021 |
Impulse Pls |
41022 | 441023 |
Erst der Selbsttest, dann der Rest
Fang klein an: MB_DATA_ADDR = 441001, MB_DATA_LEN = 2. In den beiden Wörtern
müssen 16#5757 und 16#4757 stehen (dezimal 22359 und 18263) — das ist die
Kennung "WWGW" an Protokolladresse 41000. Kommt die an, stimmt die Adressierung und
du kannst auf den vollen Block erweitern. Kommt sie nicht an, liegt es an der
Umrechnung und nicht am Gerät.
Schritt 1 — Verbindungsparameter anlegen¶
Leg einen Datenbaustein mit einer Variablen vom Systemdatentyp TCON_IP_v4 an (z.B. DB12, Variable CONNECT). Er beschreibt die TCP-Verbindung zum WattWächter:
| Feld | Wert | Bemerkung |
|---|---|---|
InterfaceId |
Hardware-Kennung der PROFINET-Schnittstelle | Gerätekonfiguration → Eigenschaften → Hardware-Kennung |
ID |
frei wählbar, 1 … 4095 |
projektweit eindeutig; mehrere MB_CLIENT-Aufrufe mit derselben ID teilen sich eine Verbindung |
ConnectionType |
16#0B |
TCP/IPv4 |
ActiveEstablished |
TRUE |
die CPU baut die Verbindung auf |
RemoteAddress.ADDR |
IP des WattWächters, z.B. 192.168.178.106 |
vier einzelne Bytes |
RemotePort |
502 |
oder der abweichende Port aus den Geräteeinstellungen |
LocalPort |
0 |
von der CPU vergeben |
In der Bausteinansicht sieht das so aus — ConnectionType zeigt TIA dezimal als 11 an, ActiveEstablished als 1:
Schritt 2 — Datenbaustein für die Register anlegen¶
Leg einen zweiten Datenbaustein für die gelesenen Register an, z.B. DB11. Der ganze Registerblock des WattWächter Gas — 32 Register, 64 Byte — passt in einen einzigen Leseauftrag. Leg die Variablen genau in dieser Reihenfolge an, dann landet jedes Register von selbst in der passenden Variablen, und die Messwerte stehen direkt als Real bereit:
| Name | Datentyp | Offset | Protokolladresse | Inhalt |
|---|---|---|---|---|
Magic |
DWord |
0.0 |
41000–41001 | Kennung "WWGW" = 16#5757_4757 |
Ver |
UInt |
4.0 |
41002 | Layout-Version, aktuell 1 |
L |
UInt |
6.0 |
41003 | Länge des Datenteils in Registern, aktuell 22 |
Ser |
Array[0..5] of Byte |
8.0 |
41004–41006 | Seriennummer (MAC-Adresse) |
Fw |
DWord |
14.0 |
41007–41008 | Firmware-Version |
Reserve1 |
Word |
18.0 |
41009 | reserviert |
Vol |
Real |
20.0 |
41010–41011 | Zählerstand in m³ |
VolFlw |
Real |
24.0 |
41012–41013 | Durchfluss in m³/h |
Ene |
Real |
28.0 |
41014–41015 | Energie in kWh (nur Gas, bei Wasser NaN) |
EneF |
Real |
32.0 |
41016–41017 | Umrechnungsfaktor Zustandszahl × Brennwert in kWh/m³ (nur Gas, bei Wasser NaN) |
PlsVol |
Real |
36.0 |
41018–41019 | Volumen je Impuls in m³ |
Pwr |
Real |
40.0 |
41020–41021 | Leistung in kW (nur Gas, bei Wasser NaN) |
Pls |
UDInt |
44.0 |
41022–41023 | Impulse seit der Zählerstandseingabe |
Med |
UInt |
48.0 |
41024 | Medium: 0 = Gas, 1 = Wasser |
Src |
UInt |
50.0 |
41025 | Sensor: 1 = Magnetfeld, 2 = induktiv |
St |
Word |
52.0 |
41026 | Status (Bitfeld), siehe Schritt 4 |
StpRev |
UInt |
54.0 |
41027 | Impulse je Umdrehung (6) |
MedStr |
Array[0..7] of Char |
56.0 |
41028–41031 | Medium als Text (gas / water) |
Der Offset ist immer (Protokolladresse − 41000) × 2. Die beiden Reservefelder gehören mit hinein — fehlen sie, verrutscht alles dahinter.
Optimierten Bausteinzugriff ausschalten
MB_DATA_PTR braucht einen ANY-/Zeigerausdruck wie P#DB11.DBX0.0 WORD 32. Der lässt sich
nur auf einen Datenbaustein ohne optimierten Bausteinzugriff bilden.
Rechtsklick auf den DB → Eigenschaften → Attribute → Haken bei Optimierter
Bausteinzugriff entfernen. Danach zeigt die Bausteinansicht eine Spalte
Offset mit 0.0, 2.0, 4.0 … — daran erkennst du, dass es gepasst hat.
Die Spalte füllt sich erst nach dem Übersetzen; bis dahin steht dort ....
Vergleich die Spalte mit der Tabelle oben: Vol muss auf 20.0 stehen, MedStr
auf 56.0.
Schritt 3 — MB_CLIENT aufrufen¶
Zieh MB_CLIENT aus der Task Card Anweisungen (Kommunikation → Weitere → MODBUS TCP) in ein Netzwerk des zyklischen Programms, z.B. in Main [OB1]. TIA fragt dabei nach einem Instanz-Datenbaustein: Einzelinstanz wählen, Nummer nach Wunsch manuell vergeben (z.B. 10) und mit OK bestätigen.
TIA legt daraufhin den Funktionsbaustein MB_CLIENT (FB1084) unter Systembausteine → Programmressourcen und den Instanz-DB MB_CLIENT_DB an. Um beide musst du dich nicht weiter kümmern.
Parametriere den Aufruf dann so:
| Parameter | Wert | Bedeutung |
|---|---|---|
REQ |
Taktmerker oder eigene Zeitsteuerung | startet einen Auftrag; flankengesteuert |
DISCONNECT |
FALSE |
Verbindung aufbauen und halten |
MB_MODE |
0 |
Lesen |
MB_DATA_ADDR |
441001 |
Protokolladresse 41000 — siehe Adressen umrechnen |
MB_DATA_LEN |
32 |
Anzahl Register — der ganze Block 41000–41031 |
MB_DATA_PTR |
P#DB11.DBX0.0 WORD 32 |
Zielbereich aus Schritt 2 — der ganze DB |
CONNECT |
Variable CONNECT aus DB12 |
Verbindungsparameter aus Schritt 1 |
Ausgänge: DONE, BUSY, ERROR, STATUS.
Fertig beschaltet sieht der Aufruf so aus — REQ, DISCONNECT und die Ausgänge liegen hier auf Merkern. Der Screenshot stammt von einem WattWächter Plus: Bei dir stehen an MB_DATA_ADDR 441001, an MB_DATA_LEN 32 und an MB_DATA_PTR P#DB11.DBX0.0 WORD 32.
CONNECT symbolisch verschalten, MB_DATA_PTR mit Länge
Zieh die Variable CONNECT aus der Bausteinansicht direkt auf den Eingang. TIA zeigt
darüber dann die absolute Adresse an, z.B. P#DB12.DBX0.0. Diese Anzeige nicht von
Hand abtippen: ohne Länge zeigt der Pointer nur auf ein einzelnes Bit. Bei MB_DATA_PTR
gehört die Länge deshalb mit dazu: P#DB11.DBX0.0 WORD 32 deckt alle Variablen aus
Schritt 2 ab.
EN dauerhaft freigeben, REQ takten
MB_CLIENT muss in jedem Zyklus bearbeitet werden, bis DONE oder ERROR
ansteht. Gestartet wird ein Auftrag über REQ, nicht über EN. Fällt der
Freigabeeingang zwischendurch ab, bleibt BUSY stehen, DONE kommt nie, und der
Datenbaustein bleibt leer.
Mehrere WattWächter an einer S7
Jeder WattWächter braucht einen eigenen MB_CLIENT-Aufruf mit eigenem Instanz-DB, eigener
ID und eigenem TCON_IP_v4. Eine S7-1200 hält dabei höchstens 8 Modbus-TCP-Verbindungen
gleichzeitig offen. Sollen mehr Geräte abgefragt werden, arbeite die Aufrufe nacheinander
ab und schalte erst weiter, wenn der aktive Aufruf DONE oder ERROR gemeldet hat — wer
einem laufenden Auftrag die Freigabe entzieht, bekommt das hängende BUSY
aus dem Hinweis oben. Die Grenzen anderer CPUs (S7-1200 G2, S7-1500) stehen im jeweiligen Datenblatt
unter Open User Communication.
Den ganzen Block alle 5 s zu lesen ist ein guter Ausgangspunkt — so bleibt auch der Durchfluss aktuell. Brauchst du nur den Zählerstand, reichen 30 s.
Schritt 4 — Werte verwenden¶
Nach jedem DONE stehen die Werte direkt in DB11 — ohne Skalierungsfaktor und ohne Umrechnung:
| Wert | Protokolladresse | Variable | Typ |
|---|---|---|---|
| Zählerstand (m³) | 41010 | "DB11".Vol |
Real |
| Durchfluss (m³/h) | 41012 | "DB11".VolFlw |
Real |
| Energie (kWh) | 41014 | "DB11".Ene |
Real |
| Leistung (kW) | 41020 | "DB11".Pwr |
Real |
| Impulse seit der Zählerstandseingabe | 41022 | "DB11".Pls |
UDInt |
| Sensor antwortet | 41026, Bit 0 | "DB11".St.%X0 |
Bool |
| Durchfluss auf 0 gesetzt (Impulse bleiben aus) | 41026, Bit 1 | "DB11".St.%X1 |
Bool |
| Seit dem Start noch kein Impuls | 41026, Bit 2 | "DB11".St.%X2 |
Bool |
Byte-Reihenfolge. Der WattWächter sendet 32-Bit-Werte Big-Endian mit dem höherwertigen Register zuerst (ABCD). Genau so legt die S7 Real, DWord und UDInt ab — MB_CLIENT kopiert die Bytes unverändert in den DB, Wörter oder Bytes zu tauschen ist nicht nötig.
Kennung prüfen. Steht in "DB11".Magic nicht 16#5757_4757 ("WWGW"), liest das Programm nicht den Block des WattWächter Gas — dann nicht weiterrechnen. "DB11".Ver ist die Layout-Version; sie wird nur erhöht, falls sich das Layout je ändert.
Firmware-Version. "DB11".Fw trägt Major, Minor und Patch in je einem Byte, Major oben: 16#0001_0300 ist Firmware 1.3.0.
Nicht gelieferte Werte sind NaN. Ene, EneF und Pwr gibt es nur bei Gas, bei Wasser tragen sie NaN. Bis der Server die Messwerte nach dem Start zum ersten Mal befüllt hat, stehen auch Vol, VolFlw und PlsVol auf NaN. Ein Real mit NaN führt in Rechenoperationen zu ENO = FALSE — prüf solche Werte vor dem Weiterrechnen, z.B. mit der Anweisung OK (Gültigkeit prüfen).
Array statt einzelner Variablen. Liest du lieber in ein Array[0..31] of Word, liegt ein Register auf dem Index Protokolladresse − 41000. Einen Real setzt du dann aus zwei Wörtern zusammen, das höherwertige zuerst. DWORD_TO_REAL übernimmt dabei nur das Bitmuster und rechnet nichts um:
// "DB11".Daten: Array[0..31] of Word, gelesen ab MB_DATA_ADDR = 441001
// "DB11".Zaehlerstand: Real
// Zählerstand Vol = Protokolladresse 41010/41011 = Index [10]/[11]
"DB11".Zaehlerstand := DWORD_TO_REAL(SHL(IN := WORD_TO_DWORD("DB11".Daten[10]), N := 16)
OR WORD_TO_DWORD("DB11".Daten[11]));
Fehlerbehebung¶
Die Register bleiben alle auf 0
Mit Abstand häufigste Ursache: die Adressumrechnung. Steht an
MB_DATA_ADDR z.B. 41011 statt 441011, sendet die S7 die Protokolladresse 1010 —
dort liegt beim WattWächter nichts, und das Gerät antwortet mit der Modbus-Ausnahme
02. Dieselbe Ausnahme kommt, wenn du Adressen aus einer Anleitung für den WattWächter
Plus (ab 440001) verwendest oder Startadresse plus MB_DATA_LEN über 41031
hinausreicht: Der WattWächter Gas beantwortet nur 41000–41031.
Mach den Selbsttest mit 441001 und Länge 2. Und lass dir
ERROR und STATUS in einer Beobachtungstabelle speichern — beide stehen nur
einen Zyklus lang an und sind sonst nie zu sehen. Ein STATUS beginnend mit 16#838
bedeutet, dass der WattWächter die Anfrage mit einer Modbus-Ausnahme beantwortet hat.
BUSY bleibt stehen, DONE kommt nie
Wird MB_CLIENT wirklich in jedem Zyklus bearbeitet? Ein abfallender Freigabeeingang
lässt den Auftrag hängen. REQ ist das Startsignal, EN muss durchgängig anstehen.
Werte wie 16#7001 … 16#7006 an STATUS sind dabei kein Fehler, sondern
Zwischenzustände während der Bearbeitung.
MB_DATA_PTR lässt sich nicht eintragen
Der Zielbaustein hat noch optimierten Bausteinzugriff. Haken in den Baustein-Eigenschaften entfernen — siehe Schritt 2.
Verbindung kommt nicht zustande
- Ist Modbus am WattWächter aktiviert? Prüfe
/api/v1/modbus/status→enabled: true,running: true. - Steht in
RemoteAddresseine IP-Adresse und kein.local-Name? - Stimmt
RemotePort(Standard502) und istActiveEstablished = TRUE? - Der WattWächter erlaubt höchstens 2 gleichzeitige Modbus-Verbindungen. Läuft parallel noch ein Test mit
modpoll, Home Assistant oder Loxone, trenn den zuerst. - Ist die
IDinTCON_IP_v4projektweit eindeutig?
Der Zählerstand ist eine unsinnige Zahl
Die Variablen in DB11 passen nicht zum Registerblock — meist fehlt ein Reservefeld
oder ein Datentyp ist falsch, und alles dahinter ist verrutscht. Vergleich die Spalte
Offset mit der Tabelle in Schritt 2:
Vol muss auf 20.0 stehen. Liest du in ein Array of Word oder Int, musst du die
beiden Wörter erst zu einem Real zusammensetzen — siehe Schritt 4.
Weitere Punkte in der Modbus-TCP-Fehlerbehebung.


