Ga naar inhoud
slim laden

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:
OpenEMS documentation:

Ondersteunde functies

  • Batterijaansturing: Externe aansturing van het laden en ontladen van de thuisbatterij door evcc.

Gebruik

  • Netmeter
  • Zonne-energieproductie
  • Batterij

Parameters

NaamOmschrijvingWaardeNiveau
hostIP address or hostname
Voorbeeld: 192.0.2.2
optioneel
capacity [kWh]Battery capacity
Voorbeeld: 50
optioneel
minsoc [%]Minimum charge

Lower limit as configured on the battery system. Used by optimizer.

Standaard: 0
Voorbeeld: 25
optioneel
maxsoc [%]Maximum charge

Upper limit as configured on the battery system. Used by optimizer and for grid charging.

Standaard: 100
Voorbeeld: 95
optioneel
passwordPassword

Service account password

Standaard: user
geavanceerd
maxacpower [W]Maximum AC power of the hybrid inverter
Standaard: 0
Voorbeeld: 5000
geavanceerd
batteryControllable battery component

active battery control (REST/JSON Write Access)

Voorbeeld: ess0
geavanceerd
watchdogFEMS/OpenEMS battery control API timeout

FEMS/OpenEMS standard 60s

Standaard: 60s
geavanceerd
maxchargepower [W]Maximum charge power

For forced charging of the battery.

geavanceerd
maxdischargepower [W]Maximum discharge power

Maximum discharge power of the storage.

geavanceerd
cacheCache

Time interval for data refresh

Standaard: 1s
Voorbeeld: 5m
geavanceerd
Configuratievoorbeeld voor evcc.yaml

Als u niet via de gebruikersinterface wilt configureren, kunt u ook dit YAML-blok gebruiken.

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)