OpenEMS Modbus-API (battery)
De OpenEMS Modbus-API is de ingebouwde Modbus TCP slave-interface van OpenEMS Edge, een open-source energiebeheersysteem dat wordt ingezet in woningen en commerciele gebouwen met batterijopslag. De Modbus-API Controller genereert een dynamische registerkaart die interne OpenEMS-kanalen beschikbaar stelt via TCP-poort 502. Deze battery-template leest twee kernwaarden uit het _sum-component: laadtoestand op register 302 en actief vermogen op register 415. Koppel de ModbusCloud Gateway aan hetzelfde netwerk als de OpenEMS Edge-host en importeer de template om accugedrag direct te volgen.
- 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 | |||
| soc | % | 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
- Monitor de laadtoestand van de accu continu om ongewone zelfontlading tussen laadcycli te detecteren.
- Volg het actieve vermogen op register 415 om te controleren of de accu laadt of ontlaadt volgens schema.
- Stel een alert in wanneer de laadtoestand tijdens nachtelijke ontlading onder een drempelwaarde zakt.
- Vergelijk vermogenswaarden van meerdere OpenEMS Edge-locaties vanuit het ModbusCloud multi-site overzicht.
- Verifieer dat het batterijvermogen na een gepland laadvenster terugkeert naar nul, ter bevestiging van het regelaarsgedrag.
Installatie
Activeer de Modbus-API Controller in je OpenEMS Edge-installatie: open de Apache Felix Web Console, voeg de component Controller.Api.ModbusTcp.ReadWrite of Controller.Api.ModbusTcp.ReadOnly toe en bevestig dat deze actief is op TCP-poort 502.
Sluit de ModbusCloud Gateway aan op hetzelfde LAN-segment als de OpenEMS Edge-host en zorg dat poort 502 niet geblokkeerd wordt door een firewallregel.
Voeg in het ModbusCloud-portaal de Gateway toe, importeer de template OpenEMS Modbus-API (battery) en stel het Modbus unit-ID in op het slave-ID dat geconfigureerd is in je Edge-installatie (standaard 1).
Controleer de verbinding door register 302 (soc) te lezen in de live weergave van het portaal; de waarde moet overeenkomen met de laadtoestand in het OpenEMS UI-dashboard.
Veelvoorkomende aandachtspunten
Waarom geeft register 302 altijd nul of geen waarde terug?
Register 302 is gekoppeld aan _sum/EssSoc en wordt alleen gevuld als er minimaal een actief ESS-component aanwezig is in OpenEMS Edge. Zonder geconfigureerde en actieve accu-component blijft het kanaal leeg en retourneert de Modbus-API nul. Controleer in de Apache Felix Web Console of een ESS-component de status RUNNING heeft.
De Gateway verbindt op poort 502, maar er verschijnen geen waarden. Wat nu?
Controleer of de Modbus-API Controller in OpenEMS Edge de status RUNNING heeft en niet alleen geconfigureerd is. Controleer ook het unit-ID: het standaard Modbus slave-ID van OpenEMS is 1. Als je Edge-installatie opnieuw is geconfigureerd, kan het slave-ID afwijken. Verifieer dit onder de controllerconfiguratie in de Felix Web Console.
Waarom leest register 415 als NaN of een onlogische float-waarde?
Register 415 gebruikt het float32-type dat twee opeenvolgende 16-bits registers beslaat. Als je client slechts een enkel registerwoord uitleest, wordt de float verkeerd gedecodeerd. Controleer of de ModbusCloud Gateway-template correct is toegepast en of geen andere Modbus-master tegelijk hetzelfde adres uitleest, want dat verstoort de twee-register-leesactie.
De registerkaart van mijn Edge-installatie wijkt af van deze template. Hoe kan dat?
OpenEMS Modbus-API genereert een dynamische registerkaart op basis van welke componenten worden geexporteerd. De adressen in deze template (302 voor soc, 415 voor power) passen bij het standaard _sum-componentblok. Als je Edge-configuratie extra of andere componenten exporteert, kunnen de registeradressen verschuiven. Download de installatiespecifieke registerkaart via het OpenEMS UI onder Systeemprofiel om dit te controleren.
Zelf zien hoe het werkt?
