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

Fonctionnalités prises en charge

Pilotage de la batterie: Pilotage externe de la charge et de la décharge de la batterie domestique par evcc.

Domaines d’utilisation

Compteur avant réseau
Production solaire
Batterie

Paramètres

Nom	Description	Valeur	Niveau
`id`	ID Modbus Par défaut: `1`	int	obligatoire
`host`	Adresse IP ou nom d’hôte Exemple: `192.0.2.2`		obligatoire
`port`	Port Par défaut: `502`	int	obligatoire
`battery`	controls battery component active battery control (Modbus/TCP Write Access) Par défaut: `false`		facultatif
`capacity` [kWh]	Battery capacity Exemple: `50`		facultatif
`minsoc` [%]	Minimum charge Lower limit as configured on the battery system. Used by optimizer. Par défaut: `0` Exemple: `25`		facultatif
`maxsoc` [%]	Maximum charge Upper limit as configured on the battery system. Used by optimizer and, on some devices, for grid charging. Par défaut: `100` Exemple: `95`		facultatif
`grid_power_register`	Modbus register for grid power GridActivePower (W) Par défaut: `315`		avancé
`grid_energy_register`	Modbus register for grid import energy GridBuyActiveEnergy (Wh) Par défaut: `359`		avancé
`pv_power_register`	Modbus register for PV power ProductionActivePower (W) Par défaut: `327`		avancé
`pv_energy_register`	Modbus register for PV energy ProductionActiveEnergy (Wh) Par défaut: `367`		avancé
`maxacpower` [W]	Maximum AC power of the hybrid inverter Par défaut: `0` Exemple: `5000`		avancé
`battery_power_register`	Modbus register for battery power EssDischargePower (W) Par défaut: `415`		avancé
`battery_soc_register`	Modbus register for state of charge SoC (%) Par défaut: `302`		avancé
`battery_set_register`	Modbus register for charge power SetActivePowerLessOrEquals (W) Par défaut: `710`		avancé
`watchdog`	battery control API timeout Par défaut: `60s`		avancé
`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.		avancé
`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.		avancé

Exemple de configuration pour evcc.yaml

Si vous ne souhaitez pas passer par l’interface, vous pouvez utiliser ce bloc YAML à la place.

Compteur avant réseauProduction solaireBatterie

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)