Gå til indhold
smart opladning

Fronius Solar API V1

Denne side viser nightly-versionen. Skift til release-versionen.

Solar API should only be used as fallback. Integration via Modbus is preferred.

Username and password are only required for active battery control.

Attention: Active battery control should only be used if no other settings for time-dependent battery control were made in the inverter configuration under "Energy Management" - "Battery Management", as existing settings will be overwritten. Choose corresponding configuration URI!

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
userUsername (for active battery control)

e.g. email address, user id, etc.

Standard: customer
valgfri
passwordPassword (for active battery control)

Service account password

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, on some devices, for grid charging.

Standard: 100
Eksempel: 95
valgfri
batteryconfiguriBattery configuration URI

Firmware starting with 1.36.5-1 requires /api/config.

Standard: /config
avanceret
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.

avanceret
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.

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: fronius-solarapi-v1
usage: grid
host: 192.0.2.2 # IP address or hostname
user: customer # Username (for active battery control), e.g. email address, user id, etc. (optional)
password: # Password (for active battery control), Service account password (optional)
batteryconfiguri: /config # Battery configuration URI, Firmware starting with 1.36.5-1 requires /api/config. [/config, /api/config] (optional)
cache: 1s # Cache, Time interval for data refresh (optional)
meters:
- name: my_pv
type: template
template: fronius-solarapi-v1
usage: pv
host: 192.0.2.2 # IP address or hostname
user: customer # Username (for active battery control), e.g. email address, user id, etc. (optional)
password: # Password (for active battery control), Service account password (optional)
batteryconfiguri: /config # Battery configuration URI, Firmware starting with 1.36.5-1 requires /api/config. [/config, /api/config] (optional)
cache: 1s # Cache, Time interval for data refresh (optional)
meters:
- name: my_battery
type: template
template: fronius-solarapi-v1
usage: battery
host: 192.0.2.2 # IP address or hostname
user: customer # Username (for active battery control), e.g. email address, user id, etc. (optional)
password: # Password (for active battery control), Service account password (optional)
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)
batteryconfiguri: /config # Battery configuration URI, Firmware starting with 1.36.5-1 requires /api/config. [/config, /api/config] (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)