Salta ai contenuti
ricarica intelligente

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:

Funzionalità supportate

  • Controllo batteria: Controllo esterno della carica e della scarica della batteria domestica tramite evcc.

Ambiti di utilizzo

  • Contatore di rete
  • Produzione solare
  • Batteria

Parametri

NomeDescrizioneValoreLivello
hostIP address or hostname
Esempio: 192.0.2.2
facoltativo
capacity [kWh]Battery capacity
Esempio: 50
facoltativo
minsoc [%]Minimum charge

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

Predefinito: 0
Esempio: 25
facoltativo
maxsoc [%]Maximum charge

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

Predefinito: 100
Esempio: 95
facoltativo
passwordPassword

Service account password

Predefinito: user
avanzato
maxacpower [W]Maximum AC power of the hybrid inverter
Predefinito: 0
Esempio: 5000
avanzato
batteryControllable battery component

active battery control (REST/JSON Write Access)

Esempio: ess0
avanzato
watchdogFEMS/OpenEMS battery control API timeout

FEMS/OpenEMS standard 60s

Predefinito: 60s
avanzato
maxchargepower [W]Maximum charge power

For forced charging of the battery.

avanzato
maxdischargepower [W]Maximum discharge power

Maximum discharge power of the storage.

avanzato
cacheCache

Time interval for data refresh

Predefinito: 1s
Esempio: 5m
avanzato
Esempio di configurazione per evcc.yaml

Se preferisci non configurare il dispositivo dall’interfaccia, puoi usare questo blocco YAML.

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)