OpenEMS Modbus-API

Lizenzhinweis:

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

FEMS-Dokumentation:

FEMS App Modbus/TCP Lesezugriff: docs.fenecon.de
FEMS App Modbus/TCP Schreibzugriff: docs.fenecon.de

OpenEMS-Dokumentation:

OpenEMS Edge Api Modbus Controller: openems.github.io

Unterstützte Funktionen

Batteriesteuerung: Externe Steuerung des Ladens und Entladens der Hausbatterie durch evcc.

Verwendung

Netzzähler
PV-Erzeugung
Batterie

Parameter

Name	Beschreibung	Wert	Stufe
`id`	Modbus-ID Standard: `1`	int	erforderlich
`host`	IP-Adresse oder Hostname Beispiel: `192.0.2.2`		erforderlich
`port`	Port Standard: `502`	int	erforderlich
`battery`	steuert Batterie Komponente aktive Batteriesteuerung (Modbus/TCP schreibend) Standard: `false`		optional
`capacity` [kWh]	Akkukapazität Beispiel: `50`		optional
`minsoc` [%]	Minimaler Ladestand Untere Grenze wie am Batteriesystem eingestellt. Wird vom Optimizer genutzt. Standard: `0` Beispiel: `25`		optional
`maxsoc` [%]	Maximaler Ladestand Obere Grenze wie am Batteriesystem eingestellt. Genutzt vom Optimizer und, bei manchen Geräten, für Netzladen. Standard: `100` Beispiel: `95`		optional
`grid_power_register`	Modbus-Register für Netzleistung GridActivePower (W) Standard: `315`		erweitert
`grid_energy_register`	Modbus-Register für Netzbezug Energie GridBuyActiveEnergy (Wh) Standard: `359`		erweitert
`pv_power_register`	Modbus-Register für PV-Leistung ProductionActivePower (W) Standard: `327`		erweitert
`pv_energy_register`	Modbus-Register für PV-Energie ProductionActiveEnergy (Wh) Standard: `367`		erweitert
`maxacpower` [W]	Maximale AC Leistung des Hybrid-Wechselrichters Standard: `0` Beispiel: `5000`		erweitert
`battery_power_register`	Modbus-Register für Batterie-Leistung EssDischargePower (W) Standard: `415`		erweitert
`battery_soc_register`	Modbus-Register für Batteriestand SoC (%) Standard: `302`		erweitert
`battery_set_register`	Modbus-Register für Ladeleistung SetActivePowerLessOrEquals (W) Standard: `710`		erweitert
`watchdog`	Batteriesteuerung API-Timeout Standard: `60s`		erweitert
`maxchargepower` [W]	Maximale Ladeleistung Höchste Leistung, mit der das Batteriesystem laden kann. Der Optimizer plant mit Laden bis zu dieser Leistung. Manche Geräte nutzen diesen Wert auch als Leistung für Netzladen.		erweitert
`maxdischargepower` [W]	Maximale Entladeleistung Höchste Leistung, mit der das Batteriesystem entladen kann. Der Optimizer plant mit Entladen bis zu dieser Leistung. Der Smart-Modus geht davon aus, dass die Batterie höchstens diese Leistung zum Fahrzeugladen beisteuert.		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ählerPV-ErzeugungBatterie

meters:
    - name: my_grid
      type: template
      template: openems-modbus
      usage: grid

      # Modbus TCP
      modbus: tcpip
      id: 1
      host:  # Hostname
      port: 502 # Port
      grid_power_register: 315 # Modbus-Register für Netzleistung, GridActivePower (W) (optional)
      grid_energy_register: 359 # Modbus-Register für Netzbezug Energie, GridBuyActiveEnergy (Wh) (optional)

meters:
    - name: my_pv
      type: template
      template: openems-modbus
      usage: pv

      # Modbus TCP
      modbus: tcpip
      id: 1
      host:  # Hostname
      port: 502 # Port
      pv_power_register: 327 # Modbus-Register für PV-Leistung, ProductionActivePower (W) (optional)
      pv_energy_register: 367 # Modbus-Register für PV-Energie, ProductionActiveEnergy (Wh) (optional)
      maxacpower: 0 # Maximale AC Leistung des Hybrid-Wechselrichters (W), optional

meters:
    - name: my_battery
      type: template
      template: openems-modbus
      usage: battery

      # Modbus TCP
      modbus: tcpip
      id: 1
      host:  # Hostname
      port: 502 # Port
      battery: false # steuert Batterie Komponente, aktive Batteriesteuerung (Modbus/TCP schreibend) (optional)
      capacity: 50 # Akkukapazität (kWh), optional
      minsoc: 0 # Minimaler Ladestand (%), Untere Grenze wie am Batteriesystem eingestellt. Wird vom Optimizer genutzt. (optional)
      maxsoc: 100 # Maximaler Ladestand (%), Obere Grenze wie am Batteriesystem eingestellt. Genutzt vom Optimizer und, bei manchen Geräten, für Netzladen. (optional)
      battery_power_register: 415 # Modbus-Register für Batterie-Leistung, EssDischargePower (W) (optional)
      battery_soc_register: 302 # Modbus-Register für Batteriestand, SoC (%) (optional)
      battery_set_register: 710 # Modbus-Register für Ladeleistung, SetActivePowerLessOrEquals (W) (optional)
      watchdog: 60s # Batteriesteuerung API-Timeout, optional
      maxchargepower: # Maximale Ladeleistung (W), Höchste Leistung, mit der das Batteriesystem laden kann. Der Optimizer plant mit Laden bis zu dieser Leistung. Manche Geräte nutzen diesen Wert auch als Leistung für Netzladen. (optional)
      maxdischargepower: # Maximale Entladeleistung (W), Höchste Leistung, mit der das Batteriesystem entladen kann. Der Optimizer plant mit Entladen bis zu dieser Leistung. Der Smart-Modus geht davon aus, dass die Batterie höchstens diese Leistung zum Fahrzeugladen beisteuert. (optional)