Modbus alerts instellen: complete gids voor installateurs (2026)

Modbus alerts zijn automatische meldingen die afgaan wanneer een register een drempel overschrijdt, een storingscode verschijnt of een gateway geen contact meer heeft. Voor installateurs zijn ze het verschil tussen een telefoontje om 02:00 over een warmtepompstoring waar je al uren van had kunnen weten, en een melding waar je op tijd op reageert. Het knelpunt bij Modbus alerts instellen zit zelden in de drempel zelf, maar in het voorkomen van alarmstorm en in de keuze van het juiste kanaal per ernstklasse.

Je leert hier hoe je drempelwaarden en storingscodes kiest, hoe je ruis rond een drempel beperkt, hoe je communicatie-uitval herkent, hoe je ernstklassen koppelt aan kanalen, en wat de F-gassenverordening vraagt aan registratie. Bij elke stap zie je ook hoe het in ModbusCloud werkt. Bedoeld voor HVAC-installateurs, koeltechnici en integrators die Modbus apparaten op afstand bewaken.

Key takeaways

• Baseer drempels op de fabrieksdocumentatie en op een week echte meetwaarden, niet op een gok vooraf.
• Een storingscode-register met de regel "ongelijk aan 0" vangt meer storingen dan tien losse temperatuurdrempels.
• Geef elke ernstklasse een eigen kanaal: info alleen in het portaal, warning per e-mail, critical per e-mail en webhook naar je ticketsysteem.

Wat is een Modbus alert?

Een Modbus alert is een melding die de master, een edge gateway of een cloudplatform genereert als een gepolde waarde een vooraf ingestelde regel raakt. Modbus zelf kent geen ingebouwd meldingsmechanisme. Een slave kan niet uit eigen beweging een alarm sturen; de master moet pollen en zelf de regel evalueren (Modbus Organization Specification V1.1b3). De alarmlogica zit dus altijd stroomopwaarts van Modbus: in een PLC, in een gateway, of in een cloudplatform zoals ModbusCloud.

In de praktijk kom je deze alerttypes tegen:

In ModbusCloud maak je een alarmregel per register met een van zes vergelijkingen: groter dan, kleiner dan, groter of gelijk, kleiner of gelijk, gelijk aan en ongelijk aan. Daarmee dek je de drempel, de discrete input (gelijk aan 1) en de storingscode (ongelijk aan 0). Daarnaast is er een offline-alarm per gateway en de automatische bewaking met vijf detectors, die verderop aan bod komt. Verandersnelheid en berekende alarmen horen thuis in een PLC of SCADA.

De Modbus exception codes (functieresponse met 0x80 opgeteld plus exceptioncode 1 tot 11, zie de Modbus Organization spec) zijn protocolfouten, geen applicatiealarmen. Reken er niet op voor procesalarmering; ze vertellen de master alleen dat het verzoek zelf is mislukt.

Voor de basis van het protocol zie de complete Modbus gids en de uitleg over Modbus RTU en Modbus TCP.

Wat heb je nodig voordat je begint?

Een werkende alarmketen vraagt een paar keuzes vooraf. Sla er geen over, want een verkeerde keuze stroomopwaarts kost vaak een uur zoeken stroomafwaarts.

• Een polling master: een PLC, een SCADA, een Home Assistant instantie of een gateway zoals de ModbusCloud Gateway, die de waarden naar het portaal stuurt.
• Stabiele fysieke laag: voor RS485 een correct afgesloten bus met 120 ohm aan beide einden, gescheiden van 230 V leidingen. Voor TCP een vast IP-adres per Modbus apparaat.
• Drempelwaarden uit de fabrieksdocumentatie: noteer per register welk bereik gezond is en wat een storing inhoudt.
• Een kanaal per ernstklasse: minimaal e-mail, en voor storingen die direct actie vragen een webhook naar je planning of ticketsysteem.
• Afspraken over stille uren: wie 's nachts wel en niet gestoord wil worden, en welke meldingen tot de ochtend kunnen wachten.
• Een plek voor je registratie: voor koeltechniek bewaar je de gegevens minimaal 5 jaar volgens artikel 7 van EU 2024/573.

Hoe stel je een drempelwaarde alarm in?

Een drempelalarm vergelijkt de gepolde registerwaarde met een grens. Zodra de waarde boven (high) of onder (low) de grens komt, gaat het alarm af. In ModbusCloud maak je dat als alarmregel op het register van een Modbus apparaat: kies het register, de vergelijking, de drempel en de ernstklasse (info, warning of critical).

Voor een Vaillant geoTHERM warmtepomp met aanvoertemperatuurregister 0x008C (Modbus TCP via VR 920) is een typische set:

Werk altijd vanuit de installateurshandleiding, niet vanuit een willekeurige internetbron. Vaillant publiceert de officiële registers via pro.vaillant.nl na inlog; Daikin via de Stand Alone Modbus Interface Manual. Een verkeerd overgenomen registeradres of een verkeerde schaalfactor is de meest voorkomende reden dat een drempel nooit, of juist steeds, afgaat. Controleer daarom de eerste meetwaarden naast het display van het apparaat voordat je drempels instelt.

Hoe voorkom je alarmstorm met hysterese en debounce?

Een kale drempel zonder marge veroorzaakt geflikker rond de grens: de waarde wiebelt in een minuut een paar keer boven en onder 65 °C, en je krijgt een reeks meldingen. In de alarmtechniek gebruik je daar drie spelregels voor: hysterese, debounce en cooldown.

• Hysterese (schakeldifferentie): een aparte set- en resetdrempel, zoals hierboven. Veel regelaars hebben die al voor hun eigen alarmen; lees in dat geval liever hun storingscode uit dan dezelfde grens nog eens na te bouwen.
• Debounce: de waarde moet een tijd aaneengesloten boven de drempel blijven voordat het alarm vuurt. Een uitleesinterval van een minuut werkt zelf al als een grove filter op korte pieken.
• Cooldown: een minimumtijd tussen herhaalde meldingen van hetzelfde alarm.

Wat daarvan in ModbusCloud zit: per alarmregel stel je een cooldown in minuten in, zodat je niet elke minuut dezelfde e-mail krijgt. Een apart hysterese- of debounceveld heeft een alarmregel niet. Kies de drempel daarom met marge boven het normale werkpunt, of gebruik de storingscode van de regelaar. Daarnaast stel je stille uren in per regel of voor je hele organisatie, en kun je e-mails bundelen in een overzicht in plaats van elke melding apart.

Hoe detecteer je dat een Modbus apparaat offline is?

Een enkele mislukte poll betekent niet dat het apparaat offline is. Een CRC-fout op RS485 of een verzoek dat net in een timeout valt, komt in elke installatie voor. Een master die bij de eerste misser alarm slaat, geeft vooral ruis. De gangbare regel is daarom: pas na drie mislukte polls op rij is een apparaat echt weg.

Hoe lang dat duurt, hangt af van het pollinginterval. Bij 30 seconden en drie missers weet je het na ongeveer anderhalve minuut, bij 60 seconden na ongeveer drie minuten. Sneller pollen geeft sneller zekerheid, maar kost meer 4G-data en meer belasting op de RS485-bus, die je deelt met de andere slaves.

In ModbusCloud stel je het uitleesinterval per Modbus apparaat in: standaard 5 minuten, via de kabel vanaf 1 seconde. Op 4G schakelt de Gateway zelf naar het SIM-interval van minimaal 60 seconden, zodat hij zuinig blijft met data. Het offline-alarm werkt op het niveau van de gateway: hoort het portaal langer dan zijn grens niets van de Gateway (standaard 120 seconden, ruimer voor een zuinige 4G-verbinding), dan gaat die offline en meldt een alarmregel met de conditie "offline" dat. Een nieuw gekoppelde gateway krijgt die regel meteen, als deel van de standaardalarmen. Komt de Gateway terug, dan sluit het offline-alarm zichzelf. Valt één Modbus apparaat uit terwijl de Gateway online blijft, dan meldt de automatische bewaking dat met de detector "Modbus apparaat levert geen data".

Welke kanalen kies je per ernstklasse?

Niet elke melding hoort iemand te storen. Een installateur die elke statuswijziging in zijn inbox krijgt, filtert die mails binnen twee weken weg, en dan mist hij ook de echte storing. De alarmrichtlijn EEMUA 191 (Alarm Systems guide) gaat uit van hooguit enkele alarmen per operator per tien minuten in normaal bedrijf. Vertaal dat naar installateursschaal door per ernstklasse een ander kanaal te kiezen.

• Informatie (info): alleen als melding in het portaal. Bijvoorbeeld een wissel van SG Ready mode of een regel die je nog aan het inregelen bent.
• Waarschuwing (warning): e-mail naar de serviceinbox. Bijvoorbeeld een aanvoertemperatuur die structureel hoger ligt dan normaal.
• Kritiek (critical): e-mail plus een webhook naar je planning of ticketsysteem. Een hogedrukpressostaat die afslaat, een lekdetector die contact maakt, een storingscode die niet 0 is, een gateway die offline gaat.

ModbusCloud heeft drie kanalen. Elke melding verschijnt in het portaal. E-mail gaat naar de meldlijst van je organisatie, naar extra adressen die je per regel opgeeft, en naar wie zich op een gateway heeft geabonneerd. Een webhook stuurt bij elk nieuw en elk teruggekeerd alarm een JSON-bericht met regel, ernst, waarde en drempel naar een URL van jouw keuze, ondertekend met een HMAC-handtekening zodat de ontvanger kan controleren dat het bericht echt van ModbusCloud komt. Een e-mail ziet er in de kern zo uit:

Onderwerp: Van Dijk - Storingscode warmtepomp
Klant:     Van Dijk, Utrecht
Gateway:   Hoofdgebouw A
Melding:   Storingscode warmtepomp (lekkage primair circuit)
Waarde:    164 (niet gelijk aan 0)

Audit trail: hoeveel registratie is verplicht?

Voor de meeste installaties is een alarmhistorie een service-eigenschap; voor koeltechniek met F-gassen is registratie een wettelijke plicht. Artikel 7 van EU Verordening 2024/573 eist dat je per installatie onder meer lekcontroles, reparaties en bijgevulde hoeveelheden vastlegt en minimaal 5 jaar bewaart. Die verordening vervangt sinds 11 maart 2024 de oude EU 517/2014. Artikel 5 regelt de lekcontroles, artikel 6 de lekdetectiesystemen. In Nederland controleert de ILT de naleving, en installatiebedrijven werken onder een STEK-certificaat.

Voor energiemonitoring gelden geen meldplichten maar wel verwachtingen bij een audit. NEN-EN-ISO 50001 (energiemanagement) vraagt in clausule 9.1 om gedocumenteerde monitoring en correctieve acties.

In ModbusCloud houdt elk alarm zijn eigen tijdlijn bij: wanneer het afging, wanneer iemand het bevestigde, wanneer de waarde terugkeerde en wanneer het is opgelost. De meetwaarden zelf blijven 365 dagen bewaard en kun je als CSV exporteren. Voor de wettelijke termijn van 5 jaar bewaar je die exports, of de PDF-rapporten uit het portaal, in je eigen administratie. Het portaal is geen F-gassenlogboek; lekcontroles en reparaties leg je vast in het logboek dat je daarvoor gebruikt.

Stap voor stap: een Modbus alert configureren

Dit voorbeeld koppelt een Eastron SDM630 energiemeter aan een spanningsalarm en een offline-alarm. Dezelfde opbouw werkt voor warmtepompen (Nibe, Vaillant, Daikin) en voor koeltechniek.

1. 1

   Uitlezen instellen

   Voeg de SDM630 toe als Modbus RTU apparaat op de Gateway (standaardadres 1, 9600 baud, 8N1) en stel het uitleesinterval in op 1 minuut. Voor RS485-bekabeling gebruik je afgeschermde twisted pair kabel met 120 ohm afsluitweerstand aan beide einden.

2. 2

   Registers selecteren

   Voor netbewaking lees je minimaal de spanning per fase (0x0000, 0x0002, 0x0004), de totale kWh (0x0034) en het vermogen. De volledige registerlijst staat in onze vergelijking van Modbus energiemeters.

3. 3

   Eerst meten, dan de drempel

   Laat de meter een week lopen en kijk in de historie hoe ver de spanning rond 230 V beweegt. Maak daarna twee alarmregels op register 0x0000 (spanning L1): groter dan 253 V en kleiner dan 207 V (10 procent boven en onder 230 V). Ernst warning, cooldown 15 minuten.

4. 4

   Offline-alarm aanzetten

   Maak voor de Gateway een alarmregel met de conditie "offline" en ernst critical. Geef de Gateway een herkenbare naam (bijvoorbeeld "Hoofdmeter pand A"), want die naam staat in de melding.

5. 5

   Stille uren en ontvangers kiezen

   Bepaal wie de mail krijgt en stel stille uren in voor meldingen die tot de ochtend kunnen wachten. Koppel een webhook aan je ticketsysteem als critical meldingen daar direct een melding moeten openen.

6. 6

   Test door fysiek te ontkoppelen

   Haal de voeding van de Gateway er even af. Na de offline-grens (standaard 120 seconden) hoort het offline-alarm af te gaan. Sluit weer aan en controleer dat het alarm zichzelf sluit en in het portaal met tijdstempel als opgelost staat.

Troubleshooting

FAQ

Gerelateerde artikelen

• Warmtepomp Modbus monitoring voor de complete monitoringaanpak van warmtepompinstallaties.
• Koeltechniek monitoring en F-gassen compliance voor registratie en STEK-eisen.
• Modbus gateway kopen, koopgids voor installateurs voor de hardwarekeuze.