Modbus-Benachrichtigungen einrichten: Komplette Anleitung für Installateure 2026

Modbus-Benachrichtigungen sind automatische Meldungen, die ausgelöst werden, sobald ein Register einen Grenzwert überschreitet, ein Störcode erscheint oder eine Gateway keinen Kontakt mehr hat. Für Installateure entscheidet die richtige Alarmierung darüber, ob Sie eine Wärmepumpenstörung um 02:00 Uhr vom verärgerten Kunden erfahren oder rechtzeitig aus einer Meldung, auf die Sie reagieren können. Wer Modbus-Benachrichtigungen einrichten will, scheitert selten am Grenzwert selbst, sondern an der Vermeidung von Alarmsturm und an der Wahl des passenden Kanals je Schweregrad.

Sie erfahren hier, wie Sie Grenzwerte und Störcodes auswählen, wie Sie Rauschen um einen Grenzwert begrenzen, wie Sie einen Kommunikationsverlust erkennen, wie Sie Schweregrade an Kanäle koppeln und was die F-Gase-Verordnung an Aufzeichnungen verlangt. Bei jedem Schritt sehen Sie auch, wie es in ModbusCloud funktioniert. Gedacht für TGA-Installateure, Kältetechniker und Integratoren, die Modbus-Geräte aus der Ferne überwachen.

Key Takeaways

• Legen Sie Grenzwerte anhand der Herstellerdokumentation und einer Woche echter Messwerte fest, nicht nach Gefühl im Voraus.
• Ein Störcode-Register mit der Regel "ungleich 0" fängt mehr Störungen ab als zehn einzelne Temperaturgrenzwerte.
• Geben Sie jedem Schweregrad einen eigenen Kanal: Info bleibt im Portal, Warnung geht per E-Mail, Kritisch per E-Mail und per Webhook an Ihr Ticketsystem.

Was ist eine Modbus-Benachrichtigung?

Eine Modbus-Benachrichtigung ist eine Meldung, die der Master, ein Edge-Gateway oder eine Cloud-Plattform erzeugt, wenn ein gepollter Wert eine vorher definierte Regel trifft. Modbus selbst kennt keinen eingebauten Meldemechanismus. Ein Slave kann nicht von sich aus einen Alarm senden; der Master muss pollen und die Regel selbst auswerten (Modbus Organization Specification V1.1b3). Die Alarmlogik sitzt also immer oberhalb von Modbus: in einer SPS, in einem Gateway oder in einer Cloud-Plattform wie ModbusCloud.

In der Praxis begegnen Ihnen diese Alarmtypen:

In ModbusCloud legen Sie eine Alarmregel je Register mit einem von sechs Vergleichen an: größer als, kleiner als, größer oder gleich, kleiner oder gleich, gleich und ungleich. Damit decken Sie den Grenzwert, den digitalen Eingang (gleich 1) und den Störcode (ungleich 0) ab. Dazu kommen ein Offline-Alarm je Gateway und die automatische Überwachung mit fünf Detektoren, die weiter unten beschrieben ist. Alarme auf Änderungsgeschwindigkeit oder berechnete Werte gehören in eine SPS oder ein SCADA-System.

Die Modbus Exception Codes (Funktionscode plus 0x80, dazu Exception Code 1 bis 11, siehe die Modbus Organization Spec) sind Protokollfehler, keine Anwendungsalarme. Verlassen Sie sich für die Prozessalarmierung nicht darauf; sie sagen dem Master nur, dass die Anfrage selbst fehlgeschlagen ist.

Für die Protokollgrundlagen siehe den kompletten Modbus-Leitfaden sowie die Erklärungen zu Modbus RTU und Modbus TCP.

Was brauchen Sie, bevor Sie beginnen?

Eine funktionierende Alarmkette braucht ein paar Entscheidungen vorab. Überspringen Sie keine davon, denn eine falsche Wahl am Anfang kostet später oft eine Stunde Fehlersuche.

• Einen Polling-Master: eine SPS, ein SCADA-System, eine Home-Assistant-Instanz oder eine Gateway wie die ModbusCloud Gateway, die die Werte an das Portal sendet.
• Eine stabile physikalische Schicht: für RS485 einen korrekt terminierten Bus mit 120 Ohm an beiden Enden, getrennt von Netzleitungen verlegt. Für TCP eine feste IP-Adresse je Modbus-Gerät.
• Grenzwerte aus der Herstellerdokumentation: notieren Sie je Register, welcher Bereich gesund ist und wie eine Störung aussieht.
• Einen Kanal je Schweregrad: mindestens E-Mail, und für Störungen, die sofort Handeln verlangen, einen Webhook an Ihre Einsatzplanung oder Ihr Ticketsystem.
• Absprachen zu Ruhezeiten: wer nachts gestört werden will und welche Meldungen bis zum Morgen warten können.
• Einen Ort für Ihre Aufzeichnungen: in der Kältetechnik bewahren Sie diese nach Artikel 7 der EU 2024/573 mindestens 5 Jahre auf.

Wie konfigurieren Sie einen Grenzwert-Alarm?

Ein Grenzwert-Alarm vergleicht den gepollten Registerwert mit einer Grenze. Sobald der Wert darüber (high) oder darunter (low) liegt, wird der Alarm ausgelöst. In ModbusCloud legen Sie ihn als Alarmregel auf dem Register eines Modbus-Geräts an: Register, Vergleich, Grenzwert und Schweregrad (Info, Warnung oder Kritisch) wählen.

Für eine Vaillant geoTHERM Wärmepumpe mit dem Vorlauftemperaturregister 0x008C (Modbus TCP über VR 920) sieht ein typischer Satz so aus:

Arbeiten Sie immer mit der Installateursdokumentation, nicht mit einer beliebigen Internetquelle. Vaillant veröffentlicht die offiziellen Register über pro.vaillant.de nach Login; Daikin im Stand Alone Modbus Interface Manual. Eine falsch übernommene Registeradresse oder ein falscher Skalierungsfaktor ist der häufigste Grund, warum ein Grenzwert nie oder ständig auslöst. Vergleichen Sie deshalb die ersten Messwerte mit dem Display des Geräts, bevor Sie Grenzwerte setzen.

Wie vermeiden Sie Alarmsturm mit Hysterese und Entprellung?

Ein nackter Grenzwert ohne Abstand erzeugt Flackern an der Grenze: der Wert pendelt innerhalb einer Minute mehrmals über und unter 65 °C, und Sie bekommen eine Serie von Meldungen. Die Alarmtechnik kennt dafür drei Spielregeln: Hysterese, Entprellung und Cooldown.

• Hysterese (Schaltdifferenz): getrennte Set- und Reset-Schwelle, wie oben. Viele Regler wenden sie bereits auf ihre eigenen Alarme an; lesen Sie in dem Fall lieber deren Störcode aus, statt dieselbe Grenze nachzubauen.
• Entprellung: der Wert muss eine Zeit lang ununterbrochen über der Grenze liegen, bevor der Alarm auslöst. Ein Ausleseintervall von einer Minute wirkt bereits als grober Filter gegen kurze Spitzen.
• Cooldown: eine Mindestzeit zwischen wiederholten Meldungen desselben Alarms.

Was davon in ModbusCloud steckt: je Alarmregel stellen Sie einen Cooldown in Minuten ein, damit Sie nicht jede Minute dieselbe E-Mail bekommen. Ein eigenes Feld für Hysterese oder Entprellung hat eine Alarmregel nicht. Wählen Sie den Grenzwert deshalb mit Abstand zum normalen Arbeitspunkt, oder nutzen Sie den Störcode des Reglers. Außerdem legen Sie Ruhezeiten je Regel oder für Ihre ganze Organisation fest und können E-Mails zu einer Übersicht bündeln, statt jede Meldung einzeln zu versenden.

Wie erkennen Sie, dass ein Modbus-Gerät offline ist?

Ein einzelner fehlgeschlagener Poll bedeutet nicht, dass das Gerät offline ist. Ein CRC-Fehler auf RS485 oder eine Anfrage, die knapp in einen Timeout läuft, kommt in jeder Anlage vor. Ein Master, der beim ersten Fehlschlag alarmiert, erzeugt vor allem Rauschen. Die übliche Regel lautet deshalb: erst nach drei fehlgeschlagenen Polls in Folge ist ein Gerät wirklich weg.

Wie lange das dauert, hängt vom Polling-Intervall ab. Bei 30 Sekunden und drei Fehlschlägen wissen Sie es nach etwa anderthalb Minuten, bei 60 Sekunden nach etwa drei Minuten. Schnelleres Pollen bringt früher Gewissheit, kostet aber mehr 4G-Daten und belastet den RS485-Bus stärker, den Sie mit den anderen Slaves teilen.

In ModbusCloud stellen Sie das Ausleseintervall je Modbus-Gerät ein: standardmäßig 5 Minuten, über das Kabel ab 1 Sekunde. Über 4G schaltet die Gateway selbst auf das SIM-Intervall von mindestens 60 Sekunden, damit sie sparsam mit Daten umgeht. Der Offline-Alarm arbeitet auf Ebene der Gateway: hört das Portal länger als deren Grenze nichts von der Gateway (standardmäßig 120 Sekunden, länger bei einer sparsamen 4G-Verbindung), geht sie offline und eine Alarmregel mit der Bedingung "offline" meldet das. Eine neu verbundene Gateway erhält diese Regel sofort als Teil der Standardalarme. Kommt die Gateway zurück, schließt sich der Offline-Alarm von selbst. Fällt ein einzelnes Modbus-Gerät aus, während die Gateway online bleibt, meldet die automatische Überwachung das mit dem Detektor „Modbus-Gerät liefert keine Daten“.

Welche Kanäle wählen Sie je Schweregrad?

Nicht jede Meldung sollte jemanden stören. Ein Installateur, der jede Statusänderung im Postfach bekommt, filtert diese E-Mails nach zwei Wochen weg und übersieht dann auch die echte Störung. Die Alarmmanagement-Richtlinie EEMUA 191 (Alarm Systems Guide) geht im Normalbetrieb von höchstens wenigen Alarmen je Operator in zehn Minuten aus. Übertragen Sie das auf Installateursmaßstab, indem Sie je Schweregrad einen anderen Kanal wählen.

• Information (info): nur als Meldung im Portal. Zum Beispiel ein Wechsel des SG-Ready-Modus oder eine Regel, die Sie noch einregeln.
• Warnung (warning): E-Mail an das Service-Postfach. Zum Beispiel eine Vorlauftemperatur, die dauerhaft höher liegt als normal.
• Kritisch (critical): E-Mail plus Webhook an Ihre Einsatzplanung oder Ihr Ticketsystem. Ein auslösender Hochdruckpressostat, ein schaltender Leckagesensor, ein Störcode ungleich 0, eine Gateway, die offline geht.

ModbusCloud hat drei Kanäle. Jede Meldung erscheint im Portal. Die E-Mail geht an die Meldeliste Ihrer Organisation, an zusätzliche Adressen, die Sie je Regel angeben, und an alle, die eine Gateway abonniert haben. Sie nennt Kunde, Gateway, Regel und den gemessenen Wert im Vergleich zum Grenzwert. Ein Webhook sendet bei jedem neuen und jedem wiederkehrenden Alarm eine JSON-Nachricht mit Regel, Schweregrad, Wert und Grenzwert an eine URL Ihrer Wahl, signiert mit einer HMAC-Signatur, damit der Empfänger prüfen kann, dass die Nachricht wirklich von ModbusCloud kommt.

Audit-Trail: Wie viel Aufzeichnung ist Pflicht?

Für die meisten Anlagen ist eine Alarmhistorie eine Service-Eigenschaft; in der Kältetechnik mit fluorierten Gasen sind Aufzeichnungen eine gesetzliche Pflicht. Artikel 7 der EU-Verordnung 2024/573 verlangt, dass Sie je Anlage unter anderem Dichtheitskontrollen, Reparaturen und nachgefüllte Mengen aufzeichnen und mindestens 5 Jahre aufbewahren. Die Verordnung hat am 11. März 2024 die frühere EU 517/2014 abgelöst. Artikel 5 regelt die Dichtheitskontrollen, Artikel 6 die Leckage-Erkennungssysteme. In Deutschland ergänzt die Chemikalien-Klimaschutzverordnung (ChemKlimaschutzV) die EU-Vorgaben.

Für das Energiemanagement ist ISO 50001:2018 Abschnitt 9.1 (Überwachung, Messung, Analyse und Bewertung) die internationale Referenz. Sie schreibt keine feste Aufbewahrungsfrist vor, verlangt aber einen dokumentierten Kreislauf aus Überwachung und Verbesserung.

In ModbusCloud führt jeder Alarm seine eigene Zeitachse: wann er ausgelöst wurde, wer ihn wann quittiert hat, wann der Wert zurückgekehrt ist und wann er gelöst wurde. Die Messwerte selbst werden 365 Tage gespeichert und lassen sich als CSV exportieren. Für die gesetzliche Frist von 5 Jahren bewahren Sie diese Exporte oder die PDF-Berichte aus dem Portal in Ihren eigenen Unterlagen auf. Das Portal ist kein F-Gase-Logbuch; Dichtheitskontrollen und Reparaturen tragen Sie in das Logbuch ein, das Sie dafür verwenden.

Schritt für Schritt: Eine Modbus-Benachrichtigung konfigurieren

Dieses Beispiel verbindet einen Eastron SDM630 Energiezähler mit einem Spannungsalarm und einem Offline-Alarm. Derselbe Aufbau funktioniert für Wärmepumpen (Nibe, Vaillant, Daikin) und für die Kältetechnik.

1. 1

   Auslesen einrichten

   Fügen Sie den SDM630 als Modbus-RTU-Gerät an der Gateway hinzu (Standardadresse 1, 9600 Baud, 8N1) und stellen Sie das Ausleseintervall auf 1 Minute. Für die RS485-Verkabelung verwenden Sie geschirmtes Twisted-Pair-Kabel mit 120 Ohm Abschlusswiderstand an beiden Enden.

2. 2

   Register auswählen

   Für die Netzüberwachung lesen Sie mindestens die Spannung je Phase (0x0000, 0x0002, 0x0004), die Gesamt-kWh (0x0034) und die Leistung. Die vollständige Registerliste finden Sie in unserem Vergleich von Modbus-Energiezählern.

3. 3

   Erst messen, dann den Grenzwert setzen

   Lassen Sie den Zähler eine Woche laufen und prüfen Sie im Verlauf, wie weit die Spannung um 230 V schwankt. Legen Sie danach zwei Alarmregeln auf Register 0x0000 (Spannung L1) an: größer als 253 V und kleiner als 207 V (10 Prozent über und unter 230 V). Schweregrad Warnung, Cooldown 15 Minuten.

4. 4

   Offline-Alarm einschalten

   Legen Sie für die Gateway eine Alarmregel mit der Bedingung "offline" und dem Schweregrad Kritisch an. Geben Sie der Gateway einen gut erkennbaren Namen (zum Beispiel "Hauptzähler Gebäude A"), denn dieser Name steht in der Meldung.

5. 5

   Ruhezeiten und Empfänger festlegen

   Legen Sie fest, wer die E-Mail bekommt, und stellen Sie Ruhezeiten für Meldungen ein, die bis zum Morgen warten können. Verbinden Sie einen Webhook mit Ihrem Ticketsystem, wenn kritische Alarme dort sofort ein Ticket eröffnen sollen.

6. 6

   Durch Trennen testen

   Nehmen Sie der Gateway kurz die Versorgung weg. Nach der Offline-Grenze (standardmäßig 120 Sekunden) sollte der Offline-Alarm auslösen. Schließen Sie wieder an und prüfen Sie, dass sich der Alarm von selbst schließt und im Portal mit Zeitstempel als gelöst erscheint.

Troubleshooting

FAQ

Verwandte Artikel

• Wärmepumpen-Modbus-Monitoring für den kompletten Monitoring-Ansatz bei Wärmepumpenanlagen.
• Kältetechnik-Monitoring und F-Gase-Compliance für Aufzeichnungspflichten.
• Modbus-Gateway-Kaufberatung für die Hardwarewahl.