Ga naar inhoud
slim laden

Fronius Solar API V1

Deze pagina toont de nightly-versie. Schakel over naar de releaseversie.

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!

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

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

Standaard: customer
optioneel
passwordPassword (for active battery control)

Service account password

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

Standaard: 100
Voorbeeld: 95
optioneel
batteryconfiguriBattery configuration URI

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

Standaard: /config
geavanceerd
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.

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

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: 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)