Modbus alerts instellen: complete gids voor installateurs (2026)

Modbus alerts zijn automatische meldingen die afgaan wanneer een register een drempel overschrijdt of een apparaat niet meer antwoordt. Voor installateurs zijn ze het verschil tussen een telefoontje om 02:00 over een warmtepompstoring waar je al uren van wist, en een tijdige push waar je op kunt reageren. Het knelpunt zit niet in het instellen van een drempel, maar in het voorkomen van alarmstorm en in de keuze van het juiste kanaal per ernstklasse.

Je leert hier hoe je drempelwaarden, hysterese en debounce instelt, hoe je communicatie-uitval detecteert met de drie-pollregel, hoe je ernstklassen koppelt aan kanalen (e-mail, SMS, Microsoft Teams), en hoe je de audit trail bewaart voor STEK en de F-gassenverordening. Bedoeld voor HVAC-installateurs, koeltechnici en integrators die een Modbus apparaten op afstand bewaken.

Key takeaways

• Stel hysterese in van 5 tot 10 procent van de drempel, gebruik een debounce van 30 tot 120 seconden voor temperatuur en 5 tot 10 seconden voor druk.
• Beschouw een Modbus apparaat pas als offline na drie achtereenvolgende mislukte polls, niet na een enkele CRC-fout.
• Routeer ernstklassen naar verschillende kanalen: informatie op dashboard, waarschuwing per e-mail, alarm en kritiek ook per SMS of Teams.

Wat is een Modbus alert?

Een Modbus alert is een door de master, edge gateway of cloud platform gegenereerde melding die afgaat als een gepolde waarde een vooraf gedefinieerde regel raakt. Modbus zelf kent geen ingebouwd push-mechanisme. Een slave kan niet uit eigen beweging een alarm sturen; de master moet polen en zelf de regel evalueren (Modbus Organization Specification V1.1b3). De alert engine zit dus altijd stroomopwaarts van Modbus: in een PLC, in de ModbusCloud Gateway, of in een cloud platform.

In de praktijk onderscheid je zeven alerttypes:

De Modbus exception codes (functieresponse byte gezet op 0x80 plus exceptioncode 1 tot 11, zie de Modbus Organization spec) zijn protocolfouten, geen applicatiealarmen. Reken er niet op voor procesalarmering; je gebruikt ze om de masterzijde te helpen begrijpen 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 alert-keten heeft drie hardware- en drie softwarekeuzes nodig. Sla geen stap over, want een verkeerde keuze stroomopwaarts kost vaak een uur troubleshooting stroomafwaarts.

• Een polling master: een PLC met IoT-licentie, een SCADA, een Home Assistant instantie of een edge gateway zoals de ModbusCloud Gateway.
• Stabiele fysieke laag: voor RS485 een correct afgesloten bus met 120 ohm aan beide einden en gescheiden van 230 V leidingen volgens NEN 1010 sectie 444. Voor TCP een statisch IP per Modbus apparaat.
• Drempelwaarden uit de fabrieksdocumentatie: noteer per register welk bereik gezond is en wat een storing inhoudt.
• Een notificatiekanaal per ernstklasse: minimaal e-mail, bij voorkeur ook SMS en een Microsoft Teams webhook.
• Een gedocumenteerde uitschakelroute: een installateur kan een alert tijdens onderhoud onderdrukken (snooze) zonder de regel te verwijderen.
• Een audit-trail-opslag: voor koeltechniek minimaal 5 jaar bewaartermijn volgens artikel 6 van EU 517/2014.

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, evalueert de master de regel. Bij ModbusCloud configureer je dit per device template: kies het register, kies operator (>, <, ==, !=, in range, out of range), kies de waarde, kies de ernst.

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 internetbron. Vaillant publiceert de officiele registers via pro.vaillant.nl na inlog; Daikin via het Stand Alone Modbus Interface Manual. Volgens Techniek Nederland (Brancherapport 2025) is een verkeerd genoteerd registeradres de oorzaak van ongeveer 18 procent van alle eerste-installatieproblemen met Modbus monitoring.

Hoe voorkom je alarmstorm met hysterese en debounce?

Een rauwe drempel zonder hysterese veroorzaakt geflikker rond de grens: de waarde wiebelt boven en onder 65 °C in een minuut, en je krijgt twintig meldingen. De drie spelregels zijn hysterese, debounce en cooldown.

• Hysterese (schakeldifferentie): aparte set en reset drempel. Typisch 5 tot 10 procent van de drempelgrootte. Voor 65 °C is dat 3 tot 6 °C; kies 2 °C als je een nauwkeurige sensor hebt.
• Debounce: de waarde moet N seconden achter elkaar boven de set blijven voordat het alarm vuurt. Voor temperatuur 30 tot 120 seconden. Voor drukken 5 tot 10 seconden. Voor PV-vermogen of EV-laadstroom houd je het op 5 seconden.
• Cooldown: minimumtijd tussen herhaalde meldingen van hetzelfde alarm. Standaard 15 minuten. Voor onderhoud kun je een aparte snooze van 4 of 24 uur gebruiken.

Hoe detecteer je dat een Modbus apparaat offline is?

Een enkele mislukte poll betekent niet dat het apparaat offline is. Een korte CRC-fout op RS485, een wifi-piek op een Modbus TCP gateway of een korte Modbus-uitwisseling die in een timeout valt zijn normaal. De drie-pollregel filtert deze ruis weg.

Concrete instellingen per device-klasse:

Hogere pollfrequentie betekent meer 4G dataverbruik, meer load op de RS485-bus, en minder ruimte voor andere slaves. In 80 procent van de installateurscases volstaat 30 seconden voor alarmering. De ModbusCloud Gateway poll standaard op 60 seconden en is configureerbaar tot 5 seconden via het dashboard.

Welke kanalen kies je per ernstklasse?

Niet elke melding hoort een SMS te zijn. Een installateur die elke status-wijziging op zijn telefoon krijgt, sluit het kanaal binnen twee weken. De industriestandaard EEMUA 191 (Alarm Systems guide) adviseert maximaal 1 tot 2 alarmen per operator per 10 minuten in normaal bedrijf. Vertaal dat naar installateurschaal door per ernstklasse een ander kanaal te kiezen.

• Voortgang (info): alleen op het dashboard. Bijvoorbeeld een SG Ready mode-wissel of een onderhoudsherinnering.
• Waarschuwing (warning): e-mail naar de installateursinbox. Bijvoorbeeld aanvoer 5 °C buiten gemiddelde, of COP daalt onder 3,0 zonder dat de regeling het meldt.
• Alarm: e-mail plus SMS plus Microsoft Teams webhook. Een hoge-druk pressostat trip, een lekkage-detector die contact maakt, een communicatie-uitval die langer duurt dan 10 minuten.
• Kritiek: alle kanalen plus eventueel webhook naar het ticketsysteem (Topdesk, ServiceNow, Jira Service Management). Compressor stilstand, F-gassen lekkage-alarm volgens artikel 4 EU 517/2014, brandalarm.

Bij ModbusCloud zit in de Professional licentie 100 SMS-berichten per maand per Gateway inbegrepen. Een typische SMS-bericht ziet er zo uit (maximaal 160 tekens, geen emoji's, geen accenten omdat oudere GSM-handsets ASCII verwerken):

ALARM Gateway-A12 Nibe S1255 register 45001=164 (lekkage primair circuit) tijd 2026-06-01 02:14 (Amsterdam)

Audit trail: hoeveel logging is verplicht?

Voor de meeste installaties is logging een service-eigenschap; voor koeltechniek is het een wettelijke verplichting. Artikel 6 lid 1 van EU Verordening 517/2014 eist een register met daarin lekkagecontroles, reparaties en stilstand-incidenten dat minimaal 5 jaar bewaard wordt. STEK verlangt hetzelfde via het Besluit gefluoreerde broeikasgassen en ozonlaagafbrekende stoffen (BGB) en het digitale logboek. Een e-mail-archief telt niet: bij STEK-audit moet je per installatie de complete tijdlijn van alarmen reproduceerbaar tonen.

Voor energiemonitoring gelden geen meldingsplichten maar wel auditverwachtingen. NEN-EN-ISO 50001 (Energy Management System) clause 9.1 vereist een gedocumenteerde monitoring en correctieve actie. RVO subsidies voor warmtepompmonitoring (BTA, ISDE) verwachten dat installateurs storingsmomenten kunnen tonen tijdens de geldigheidsperiode van de subsidie.

In het ModbusCloud dashboard vind je per Gateway een tijdlijn waarin elke alert is gelogd met UTC-timestamp, register, gemeten waarde, ernst, en wie de melding heeft bevestigd. Exporteer per kwartaal naar CSV voor je STEK-administratie.

Stap voor stap: een Modbus alert configureren

Dit voorbeeld koppelt een Eastron SDM630 energiemeter aan een drempel- en offline-alarm. Dezelfde structuur werkt voor warmtepompen (Nibe, Vaillant, Daikin) en koeltechniek (Carel pCO, Danfoss ADAP-KOOL).

1. 1

   Polling configureren

   Voeg de SDM630 toe als Modbus RTU slave (default address 1, 9600 baud, 8N1). Stel scan_interval op 30 seconden via het ModbusCloud dashboard. Voor RS485-bekabeling is een twisted pair shielded kabel verplicht en 120 ohm afsluitweerstand aan beide einden.

2. 2

   Registers selecteren

   Voor netbewaking polt je minimaal registers 0x0000 (V L1), 0x0002 (V L2), 0x0004 (V L3), 0x0034 (totaal kWh) en 0x0048 (vermogen). De volledige Eastron SDM630 register-map staat in onze vergelijking van Modbus energiemeters.

3. 3

   Drempel en hysterese instellen

   Voeg een alarm-regel toe: register 0x0000 (V L1) high 253 V, low 207 V (10 procent boven en onder 230 V). Hysterese 1 V, debounce 5 s, cooldown 15 min, ernst warning, kanaal e-mail.

4. 4

   Offline-alarm activeren

   Activeer de drie-pollregel met timeout 1 s per poll en alarm na 3 missers (totaal 90 s). Ernst alarm, kanaal SMS plus Teams webhook. Geef een vriendelijke device-naam (bijvoorbeeld "Hoofdmeter pand A") die meteen herkenbaar is in het SMS-bericht.

5. 5

   Snooze-regel toevoegen

   Maak een geplande uitzondering aan voor onderhoud: snooze 4 uur per installatie via een knop in het dashboard, geactiveerd door de installateur die ter plekke is. Zo voorkom je een storm tijdens reguliere stilstand.

6. 6

   Test door fysiek te ontkoppelen

   Trek de A/B draad eenmaal los om de offline-detectie te testen. Na 90 seconden moet je een SMS plus Teams-melding ontvangen. Sluit weer aan en controleer of het alarm herstelt en in het dashboard als "resolved" verschijnt met tijdstempel.

Troubleshooting

FAQ

Gerelateerde artikelen

• Warmtepomp Modbus monitoring voor de complete monitoring-aanpak van warmtepompinstallaties.
• Koeltechniek monitoring en F-gassen compliance voor het audit-trail vraagstuk en STEK eisen.
• Modbus gateway kopen, koopgids voor installateurs voor hardware-keuze.