Zum Inhalt

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:

TIA Portal: Datenbaustein DB12 mit der Variablen CONNECT vom Typ TCON_IP_v4


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 Portal: Aufrufoptionen beim Einfügen von MB_CLIENT, Einzelinstanz DB10

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.

TIA Portal: vollständig beschalteter MB_CLIENT-Aufruf in OB1

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 RemoteAddress eine IP-Adresse und kein .local-Name?
  • Stimmt RemotePort (Standard 502) und ist ActiveEstablished = 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 ID in TCON_IP_v4 projektweit 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.