Gå til indhold
smart opladning

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:

Understøttede funktioner

  • Batteristyring: Ekstern styring af opladning og afladning af hjemmebatteriet via evcc.

Anvendelsesområder

  • Elnetsmåler
  • Solproduktion
  • Batteri

Parametre

NavnBeskrivelseVærdiNiveau
hostIP address or hostname
Eksempel: 192.0.2.2
valgfri
capacity [kWh]Battery capacity
Eksempel: 50
valgfri
minsoc [%]Minimum charge

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

Standard: 0
Eksempel: 25
valgfri
maxsoc [%]Maximum charge

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

Standard: 100
Eksempel: 95
valgfri
passwordPassword

Service account password

Standard: user
avanceret
maxacpower [W]Maximum AC power of the hybrid inverter
Standard: 0
Eksempel: 5000
avanceret
batteryControllable battery component

active battery control (REST/JSON Write Access)

Eksempel: ess0
avanceret
watchdogFEMS/OpenEMS battery control API timeout

FEMS/OpenEMS standard 60s

Standard: 60s
avanceret
maxchargepower [W]Maximum charge power

For forced charging of the battery.

avanceret
maxdischargepower [W]Maximum discharge power

Maximum discharge power of the storage.

avanceret
cacheCache

Time interval for data refresh

Standard: 1s
Eksempel: 5m
avanceret
Konfigurationseksempel til evcc.yaml

Hvis du ikke vil konfigurere via webgrænsefladen, kan du i stedet bruge denne YAML-blok.

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)