OpenEMS Modbus-API

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

Podporované funkce

Řízení baterie: Externí řízení nabíjení a vybíjení domácí baterie pomocí evcc.

Oblasti využití

Měřič sítě
Solární výroba
Baterie

Parametry

Název	Popis	Hodnota	Úroveň
`id`	Modbus ID Výchozí: `1`	int	povinné
`host`	IP adresa nebo název hostitele Příklad: `192.0.2.2`		povinné
`port`	Port Výchozí: `502`	int	povinné
`battery`	controls battery component active battery control (Modbus/TCP Write Access) Výchozí: `false`		volitelné
`capacity` [kWh]	Battery capacity Příklad: `50`		volitelné
`minsoc` [%]	Minimum charge Lower limit as configured on the battery system. Used by optimizer. Výchozí: `0` Příklad: `25`		volitelné
`maxsoc` [%]	Maximum charge Upper limit as configured on the battery system. Used by optimizer and, on some devices, for grid charging. Výchozí: `100` Příklad: `95`		volitelné
`grid_power_register`	Modbus register for grid power GridActivePower (W) Výchozí: `315`		pokročilé
`grid_energy_register`	Modbus register for grid import energy GridBuyActiveEnergy (Wh) Výchozí: `359`		pokročilé
`pv_power_register`	Modbus register for PV power ProductionActivePower (W) Výchozí: `327`		pokročilé
`pv_energy_register`	Modbus register for PV energy ProductionActiveEnergy (Wh) Výchozí: `367`		pokročilé
`maxacpower` [W]	Maximum AC power of the hybrid inverter Výchozí: `0` Příklad: `5000`		pokročilé
`battery_power_register`	Modbus register for battery power EssDischargePower (W) Výchozí: `415`		pokročilé
`battery_soc_register`	Modbus register for state of charge SoC (%) Výchozí: `302`		pokročilé
`battery_set_register`	Modbus register for charge power SetActivePowerLessOrEquals (W) Výchozí: `710`		pokročilé
`watchdog`	battery control API timeout Výchozí: `60s`		pokročilé
`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.		pokročilé
`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.		pokročilé

Příklad konfigurace pro evcc.yaml

Pokud nechcete konfigurovat přes uživatelské rozhraní, můžete místo toho použít tento blok YAML.

Měřič sítěSolární výrobaBaterie

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)