OpenEMS Modbus-API

← Zonne-energie, thuisbatterij, net, meters

License notice:

For active battery control on FENECON FEMS systems, a commercial license (FEMS App Modbus/TCP Write Access) is required.

FEMS documentation:

FEMS App Modbus/TCP Read Access: docs.fenecon.de
FEMS App Modbus/TCP Write Access: docs.fenecon.de

OpenEMS documentation:

OpenEMS Edge Api Modbus Controller: openems.github.io

Ondersteunde functies

Batterijaansturing: Externe aansturing van het laden en ontladen van de thuisbatterij door evcc.

Gebruik

Netmeter
Zonne-energieproductie
Batterij

Parameters

Naam	Omschrijving	Waarde	Niveau
`id`	Modbus-ID Standaard: `1`	int	verplicht
`host`	IP-adres of hostnaam Voorbeeld: `192.0.2.2`		verplicht
`port`	Poort Standaard: `502`	int	verplicht
`battery`	controls battery component active battery control (Modbus/TCP Write Access) Standaard: `false`		optioneel
`capacity` [kWh]	Battery capacity Voorbeeld: `50`		optioneel
`minsoc` [%]	Minimum charge Lower limit as configured on the battery system. Used by optimizer. Standaard: `0` Voorbeeld: `25`		optioneel
`maxsoc` [%]	Maximum charge Upper limit as configured on the battery system. Used by optimizer and, on some devices, for grid charging. Standaard: `100` Voorbeeld: `95`		optioneel
`grid_power_register`	Modbus register for grid power GridActivePower (W) Standaard: `315`		geavanceerd
`grid_energy_register`	Modbus register for grid import energy GridBuyActiveEnergy (Wh) Standaard: `359`		geavanceerd
`pv_power_register`	Modbus register for PV power ProductionActivePower (W) Standaard: `327`		geavanceerd
`pv_energy_register`	Modbus register for PV energy ProductionActiveEnergy (Wh) Standaard: `367`		geavanceerd
`maxacpower` [W]	Maximum AC power of the hybrid inverter Standaard: `0` Voorbeeld: `5000`		geavanceerd
`battery_power_register`	Modbus register for battery power EssDischargePower (W) Standaard: `415`		geavanceerd
`battery_soc_register`	Modbus register for state of charge SoC (%) Standaard: `302`		geavanceerd
`battery_set_register`	Modbus register for charge power SetActivePowerLessOrEquals (W) Standaard: `710`		geavanceerd
`watchdog`	battery control API timeout Standaard: `60s`		geavanceerd
`maxchargepower` [W]	Maximum charge power Highest power the battery system can charge with. The optimizer plans with charging up to this power. Some devices also use it as grid charging power.		geavanceerd
`maxdischargepower` [W]	Maximum discharge power Highest power the battery system can discharge with. The optimizer plans with discharging up to this power. Smart mode assumes the battery supplies at most this power to vehicle charging.		geavanceerd

Configuratievoorbeeld voor evcc.yaml

Als u niet via de gebruikersinterface wilt configureren, kunt u ook dit YAML-blok gebruiken.

NetmeterZonne-energieproductieBatterij

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 for grid power, GridActivePower (W) (optional)
      grid_energy_register: 359 # Modbus register for grid import energy, 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 for PV power, ProductionActivePower (W) (optional)
      pv_energy_register: 367 # Modbus register for PV energy, ProductionActiveEnergy (Wh) (optional)
      maxacpower: 0 # Maximum AC power of the hybrid inverter (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 # controls battery component, active battery control (Modbus/TCP Write Access) (optional)
      capacity: 50 # Battery capacity (kWh), optional
      minsoc: 0 # Minimum charge (%), Lower limit as configured on the battery system. Used by optimizer. (optional)
      maxsoc: 100 # Maximum charge (%), Upper limit as configured on the battery system. Used by optimizer and, on some devices, for grid charging. (optional)
      battery_power_register: 415 # Modbus register for battery power, EssDischargePower (W) (optional)
      battery_soc_register: 302 # Modbus register for state of charge, SoC (%) (optional)
      battery_set_register: 710 # Modbus register for charge power, SetActivePowerLessOrEquals (W) (optional)
      watchdog: 60s # battery control API timeout, optional
      maxchargepower: # Maximum charge power (W), Highest power the battery system can charge with. The optimizer plans with charging up to this power. Some devices also use it as grid charging power. (optional)
      maxdischargepower: # Maximum discharge power (W), Highest power the battery system can discharge with. The optimizer plans with discharging up to this power. Smart mode assumes the battery supplies at most this power to vehicle charging. (optional)