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

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	Úroveň
`host`	IP address or hostname Příklad: `192.0.2.2`	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é
`password`	Password Service account password Výchozí: `user`	pokročilé
`maxacpower` [W]	Maximum AC power of the hybrid inverter Výchozí: `0` Příklad: `5000`	pokročilé
`battery`	Controllable battery component active battery control (REST/JSON Write Access) Příklad: `ess0`	pokročilé
`watchdog`	FEMS/OpenEMS battery control API timeout FEMS/OpenEMS standard 60s 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é
`cache`	Cache Time interval for data refresh Výchozí: `1s` Příklad: `5m`	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
      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, on some devices, 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), 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)
      cache: 1s # Cache, Time interval for data refresh (optional)