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 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 For forced charging of the battery.		avancé
`maxdischargepower` [W]	Maximum discharge power Maximum discharge power of the storage.		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 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), For forced charging of the battery. (optional)
      maxdischargepower: # Maximum discharge power (W), Maximum discharge power of the storage. (optional)

Voir la version nightly