OpenEMS REST-API

Lizenzhinweis:

Für FENECON FEMS Systeme ist für die aktive Batteriesteuerung eine kommerzielle Lizenz FEMS App REST/JSON Schreibzugriff erforderlich.

FEMS-Dokumentation:

FEMS App REST/JSON Lesezugriff: docs.fenecon.de
FEMS App REST/JSON Schreibzugriff: docs.fenecon.de

OpenEMS-Dokumentation:

OpenEMS Edge REST-Api Controller: openems.github.io

Unterstützte Funktionen

Batteriesteuerung: Externe Steuerung von Hausbatterie-Lade- und Entladevorgängen durch evcc.

Einsatzbereiche

Netzzähler
PV-Produktion
Batterie

Parameter

Name	Beschreibung	Stufe
`host`	IP-Adresse oder Hostname Beispiel: `192.0.2.2`	optional
`capacity` [kWh]	Akkukapazität Beispiel: `50`	optional
`minsoc` [%]	Minimaler Ladestand Untere Grenze beim Entladen der Batterie im normalen Betrieb Beispiel: `25`	optional
`maxsoc` [%]	Maximaler Ladestand Oberes Limit beim Laden der Batterie aus dem Netz Beispiel: `95`	optional
`password`	Passwort Zugangspasswort des Dienstes Standard: `user`	erweitert
`maxacpower` [W]	Maximale AC Leistung des Hybrid-Wechselrichters Standard: `0` Beispiel: `5000`	erweitert
`battery`	Steuerbare Batterie Komponente aktive Batteriesteuerung (REST/JSON schreibend) Beispiel: `ess0`	erweitert
`watchdog`	FEMS/OpenEMS Batteriesteuerung API-Timeout FEMS/OpenEMS Standard 60s Standard: `60s`	erweitert
`maxchargepower` [W]	Maximale Ladeleistung Für erzwungenes Laden des Speichers.	erweitert
`maxdischargepower` [W]	Maximale Entladeleistung Maximale Entladeleistung des Speichers.	erweitert

Konfigurationsbeispiel für evcc.yaml

Falls du die Konfiguration nicht über die Oberfläche vornehmen möchtest, kannst du alternativ diesen YAML-Block verwenden.

Netzzähler PV-Produktion Batterie

meters:
    - name: my_grid
      type: template
      template: openems
      usage: grid
      host: 192.0.2.2 # IP-Adresse oder Hostname
      password: user # Passwort, Zugangspasswort des Dienstes (optional)

meters:
    - name: my_pv
      type: template
      template: openems
      usage: pv
      host: 192.0.2.2 # IP-Adresse oder Hostname
      password: user # Passwort, Zugangspasswort des Dienstes (optional)
      maxacpower: 0 # Maximale AC Leistung des Hybrid-Wechselrichters (W), optional

meters:
    - name: my_battery
      type: template
      template: openems
      usage: battery
      host: 192.0.2.2 # IP-Adresse oder Hostname
      capacity: 50 # Akkukapazität (kWh), optional
      minsoc: 25 # Minimaler Ladestand (%), Untere Grenze beim Entladen der Batterie im normalen Betrieb (optional)
      maxsoc: 95 # Maximaler Ladestand (%), Oberes Limit beim Laden der Batterie aus dem Netz (optional)
      password: user # Passwort, Zugangspasswort des Dienstes (optional)
      battery: ess0 # Steuerbare Batterie Komponente, aktive Batteriesteuerung (REST/JSON schreibend) (optional)
      watchdog: 60s # FEMS/OpenEMS Batteriesteuerung API-Timeout, FEMS/OpenEMS Standard 60s (optional)
      maxchargepower: # Maximale Ladeleistung (W), Für erzwungenes Laden des Speichers. (optional)
      maxdischargepower: # Maximale Entladeleistung (W), Maximale Entladeleistung des Speichers. (optional)