OpenEMS REST-API

License notice:

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

FEMS documentation:

FEMS App REST/JSON Read Access: docs.fenecon.de
FEMS App REST/JSON Write Access: docs.fenecon.de

OpenEMS documentation:

OpenEMS Edge REST-Api 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	Niveau
`host`	IP address or hostname Exemple: `192.0.2.2`	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
`password`	Password Service account password Par défaut: `user`	avancé
`maxacpower` [W]	Maximum AC power of the hybrid inverter Par défaut: `0` Exemple: `5000`	avancé
`battery`	Controllable battery component active battery control (REST/JSON Write Access) Exemple: `ess0`	avancé
`watchdog`	FEMS/OpenEMS battery control API timeout FEMS/OpenEMS standard 60s 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é
`cache`	Cache Time interval for data refresh Par défaut: `1s` Exemple: `5m`	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
      usage: grid
      host: 192.0.2.2 # IP address or hostname
      password: user # Password, Service account password (optional)
      cache: 1s # Cache, Time interval for data refresh (optional)

meters:
    - name: my_pv
      type: template
      template: openems
      usage: pv
      host: 192.0.2.2 # IP address or hostname
      password: user # Password, Service account password (optional)
      maxacpower: 0 # Maximum AC power of the hybrid inverter (W), optional
      cache: 1s # Cache, Time interval for data refresh (optional)

meters:
    - name: my_battery
      type: template
      template: openems
      usage: battery
      host: 192.0.2.2 # IP address or hostname
      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)
      password: user # Password, Service account password (optional)
      battery: ess0 # Controllable battery component, active battery control (REST/JSON Write Access) (optional)
      watchdog: 60s # FEMS/OpenEMS battery control API timeout, FEMS/OpenEMS standard 60s (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)
      cache: 1s # Cache, Time interval for data refresh (optional)

Voir la version nightly