OpenEMS Modbus-API (pv)
De OpenEMS Modbus-API is een software-interface die is ingebouwd in het OpenEMS Edge energiemanagementsysteem en interne kanalen beschikbaar stelt aan externe systemen via Modbus TCP. De PV-variant van deze template richt zich op de zonne-energieproductie binnen een OpenEMS-installatie. Er worden twee kanalen uitgelezen: het actuele productievermogen op adres 327 en de cumulatieve opgewekte energie op adres 367. Beide zijn drijvende-kommawaarden die elke cyclus worden bijgewerkt. Door de ModbusCloud Gateway te koppelen aan de TCP-poort van OpenEMS Edge krijg je direct inzicht in de actuale zonne-opbrengst en productietotalen.
- 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
- Bewaak het actuele PV-productievermogen om te controleren of de omvormer binnen de verwachte grenzen werkt.
- Volg de cumulatieve energieproductie om de maandelijkse en jaarlijkse zonne-opbrengst per locatie te berekenen.
- Stel een alert in bij nul-productie overdag om omvormerfouten of communicatiestoringen snel te detecteren.
- Vergelijk dagelijkse productietotalen over meerdere OpenEMS-locaties in het multi-site overzicht van ModbusCloud.
- Controleer of de energieteller na firmware- of configuratiewijzigingen op het EMS correct doorloopt.
Installatie
Activeer de Modbus-TCP API-controller in OpenEMS Edge via de Apache Felix Web Console onder het component 'Controller Api Modbus TCP', en controleer of het PV-component is opgenomen in de lijst met geëxporteerde kanalen.
Verbind de ModbusCloud Gateway met hetzelfde netwerk als de OpenEMS Edge-host en zorg dat TCP-poort 502 (of de geconfigureerde Modbus-poort) bereikbaar is vanuit de Gateway.
Voeg in het ModbusCloud-portaal de Gateway toe, importeer de OpenEMS Modbus-API (pv) template en stel het unit-ID in op het Modbus slave-ID dat is geconfigureerd in de OpenEMS-controller.
Controleer de verbinding door te bevestigen dat register 327 overdag een geldige float-waarde teruggeeft. Leest het register nul op een zonnige dag, controleer dan of het PV-component correct is opgenomen in de Modbus-registerexport van OpenEMS.
Veelvoorkomende aandachtspunten
Waarom geeft het vermogensregister nul terug overdag?
De OpenEMS Modbus-API wijst kanalen dynamisch toe op basis van welke componenten worden geëxporteerd. Als het PV-component niet is opgenomen in de componentlijst van de Modbus-API-controller, geeft register 327 nul of geen waarde terug. Ga naar de OpenEMS UI, open de configuratie van de Modbus-API-controller en controleer of het PV-component-ID staat vermeld als geëxporteerd component.
Waarom ontvang ik NaN of ongeldige float-waarden op register 327?
Register 327 gebruikt een 32-bit IEEE 754 float verdeeld over twee opeenvolgende Modbus-registers. Sommige tools lezen deze als twee afzonderlijke 16-bit integers. Zorg dat je Modbus-client twee registers leest vanaf adres 327 en ze decodeert als één float32 in big-endian bytevolgorde, de standaard in OpenEMS.
Register 367 geeft verouderde of bevroren waarden terug.
Register 367 bevat een float64-energieteller verdeeld over vier opeenvolgende registers. Als de leesaanvraag minder dan vier registers omvat, is de waarde onvolledig of lijkt bevroren. Controleer of het leesbereik alle vier registers (367 tot en met 370) dekt en of functiecode 3 wordt gebruikt, passend bij het holding-registertype.
De Modbus-verbinding wordt geweigerd terwijl OpenEMS Edge draait.
De Modbus-TCP API-controller moet expliciet worden geactiveerd in OpenEMS Edge. Een actieve Edge-instantie biedt standaard geen Modbus-toegang. Controleer in de Apache Felix Web Console of een component van het type 'Controller.Api.ModbusTcp.ReadOnly' of 'ReadWrite' actief is en of geen firewall TCP-poort 502 blokkeert tussen de ModbusCloud Gateway en de Edge-host.
Zelf zien hoe het werkt?
