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 von Hausbatterie-Lade- und Entladevorgängen durch evcc.

Einsatzbereiche

Netzzähler
PV-Produktion
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 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
`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 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-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: 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)
      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), Für erzwungenes Laden des Speichers. (optional)
      maxdischargepower: # Maximale Entladeleistung (W), Maximale Entladeleistung des Speichers. (optional)