OpenEMS Modbus-API (grid)
De OpenEMS Modbus-API is een software-interface die is ingebouwd in het OpenEMS Edge energiemanagementsysteem. Geconfigureerd als netaansluiting-component stelt het realtime gegevens beschikbaar via Modbus TCP op poort 502. Deze template leest twee kanalen: het actuele nettovermogen op adres 315 en de cumulatieve netenergie op adres 359, beide als floating-point waarden uit het OpenEMS _sum-componentblok. Door de ModbusCloud Gateway te koppelen aan een OpenEMS Edge-installatie met actieve Modbus-API Controller krijg je direct inzicht in de netstroom binnen het ModbusCloud-portaal, zonder extra hardware.
- Protocol
- Modbus TCP
- Aansluiting
- Ethernet, Modbus TCP
- Registers
- 2, alleen lezen
- Merk
- OpenEMS
- Ondersteunde modellen
- Modbus-API
- Laatst bijgewerkt
Registers (2)
2 lezen, 0 schrijven
| Naam | Eenheid | Toegang | Adres (Verborgen tot je je e-mailadres invult) | Functie (verborgen) | Type (verborgen) |
|---|---|---|---|---|---|
| power | W | Lezen | |||
| energy | Wh | Lezen |
Registers laden…
Stuur jouw apparatenlijst
Staat een apparaat niet in de bibliotheek, dan maken we de template gratis zodra we de registers hebben.
Gebruikstoepassingen
- Controleer het actuele nettovermogen om de zelfconsumptieratio op PV-gekoppelde installaties te verifiëren.
- Volg de cumulatieve netenergie over factureringsperiodes om meterstanden van de netbeheerder te controleren.
- Stel een alert in bij aanhoudend hoge teruglevering om onverwachte pieken in netlevering vroegtijdig te signaleren.
- Vergelijk netvermogenspatronen voor en na inbedrijfstelling van een accusysteem om piekafvlakking te bevestigen.
- Genereer dagelijkse en maandelijkse netenergierapportages voor energieprestatie-contracten of netbeheerder-submissions.
Installatie
Activeer de Modbus-API Controller in de OpenEMS Edge-configuratie onder Apps of Componenten, en controleer of TCP-poort 502 is ingesteld en het _sum-component is geëxporteerd.
Sluit de ModbusCloud Gateway aan op hetzelfde IP-netwerk als het OpenEMS Edge-apparaat en zorg dat poort 502 niet wordt geblokkeerd door een firewall of router.
Voeg in het ModbusCloud-portaal de Gateway toe, importeer de template OpenEMS Modbus-API (grid) en stel het Modbus-unit-ID in op 1, het standaard slave-adres van de OpenEMS Modbus-API Controller.
Controleer register 315 in de live registerweergave van het portaal: een float32-waarde die overeenkomt met het verwachte nettovermogen bevestigt dat de verbinding correct werkt.
Veelvoorkomende aandachtspunten
De Gateway verbindt maar beide registers geven geen waarde. Wat nu?
Controleer of de Modbus-API Controller actief is in OpenEMS Edge en of het _sum-component is opgenomen in de exportconfiguratie. Als de controller uitgeschakeld is of het component niet geëxporteerd wordt, bestaat het adresblok met registers 315 en 359 niet en geeft elke leespoging een uitzondering terug.
Register 315 geeft een plausibele waarde maar register 359 blijft nul of NaN.
Adres 359 is een float64 die vier aaneengesloten holdingregisters beslaat (FC3). Sommige Modbus-masters lezen standaard slechts twee registers per adres. Controleer of de ModbusCloud-template is ingesteld op type float64, zodat de Gateway alle vier registers in één transactie opvraagt. Een gedeeltelijke lezing levert een ongeldige waarde op.
Ik krijg een 'connection refused'-fout op poort 502. Hoe los ik dit op?
De OpenEMS Edge Modbus-API Controller moet actief zijn en gebonden aan de netwerkinterface van het Edge-apparaat. Controleer of de controller is ingeschakeld in de OpenEMS-configuratie, dat poort 502 niet wordt geblokkeerd door een lokale firewall en dat je het juiste IP-adres van de Edge-host gebruikt en niet een NAT- of gateway-adres.
Na een firmware-update van OpenEMS Edge zijn mijn registerwaarden verschoven of verdwenen.
De OpenEMS Modbus-API genereert een dynamische registertabel op basis van geconfigureerde componenten. Een firmware-update of componentwijziging kan blokoffsets verschuiven. Download het System Profile Excel opnieuw via de OpenEMS UI om te bevestigen dat adressen 315 en 359 nog steeds overeenkomen met de verwachte netvermogens- en energiekanalen in je bijgewerkte installatie.
Zelf zien hoe het werkt?
