Zum Inhalt springen
EN | DE

Fronius Solar API V1

Solar API sollte nur als Fallback genutzt werden. Die Integration über Modbus ist bevorzugt.

Benutzername und Passwort werden nur für die aktive Batteriesteuerung benötigt.

Achtung: Die aktive Batteriesteuerung sollte nur verwendet werden, wenn keine weiteren Einstellungen für die zeitabhängige Batteriesteuerung in der Wechselrichter-Konfiguration unter "Energiemanagement" - "Batteriemanagement" getätigt wurden, denn bestehende Einstellungen werden überschrieben. Es ist der geeignete Konfigurationspfad auszuwählen!

Unterstützte Funktionen

  • Batteriesteuerung: Externe Steuerung von Hausbatterie-Lade- und Entladevorgängen durch evcc.

Einsatzbereiche

  • Netzzähler
  • PV-Produktion
  • Batterie

Parameter

NameBeschreibungWertStufe
hostIP-Adresse oder Hostname
Beispiel: 192.0.2.2
optional
userBenutzername (für aktive Batteriesteuerung)

bspw. E-Mail Adresse, User Id, etc.

Standard: customer
optional
passwordPasswort (für aktive Batteriesteuerung)

Zugangspasswort des Dienstes

optional
capacity [kWh]Akkukapazität
Beispiel: 50
optional
minsoc [%]Minimaler Ladestand

Untere Grenze beim Entladen der Batterie im normalen Betrieb

Beispiel: 25
optional
maxsoc [%]Maximaler Ladestand

Oberes Limit beim Laden der Batterie aus dem Netz

Beispiel: 95
optional
batteryconfiguriBatteriekonfigurations-URI

Firmware Versionen ab 1.36.5-1 erfordern /api/config.

Standard: /config
erweitert
maxchargepower [W]Maximale Ladeleistung

Für erzwungenes Laden des Speichers.

erweitert
maxdischargepower [W]Maximale Entladeleistung

Maximale Entladeleistung des Speichers.

erweitert
Konfigurationsbeispiel für evcc.yaml

Falls du die Konfiguration nicht über die Oberfläche vornehmen möchtest, kannst du alternativ diesen YAML-Block verwenden.

meters:
- name: my_grid
type: template
template: fronius-solarapi-v1
usage: grid
host: 192.0.2.2 # IP-Adresse oder Hostname
user: customer # Benutzername (für aktive Batteriesteuerung), bspw. E-Mail Adresse, User Id, etc. (optional)
password: # Passwort (für aktive Batteriesteuerung), Zugangspasswort des Dienstes (optional)
batteryconfiguri: /config # Batteriekonfigurations-URI, Firmware Versionen ab 1.36.5-1 erfordern /api/config. [/config, /api/config] (optional)
meters:
- name: my_pv
type: template
template: fronius-solarapi-v1
usage: pv
host: 192.0.2.2 # IP-Adresse oder Hostname
user: customer # Benutzername (für aktive Batteriesteuerung), bspw. E-Mail Adresse, User Id, etc. (optional)
password: # Passwort (für aktive Batteriesteuerung), Zugangspasswort des Dienstes (optional)
batteryconfiguri: /config # Batteriekonfigurations-URI, Firmware Versionen ab 1.36.5-1 erfordern /api/config. [/config, /api/config] (optional)
meters:
- name: my_battery
type: template
template: fronius-solarapi-v1
usage: battery
host: 192.0.2.2 # IP-Adresse oder Hostname
user: customer # Benutzername (für aktive Batteriesteuerung), bspw. E-Mail Adresse, User Id, etc. (optional)
password: # Passwort (für aktive Batteriesteuerung), Zugangspasswort des Dienstes (optional)
capacity: 50 # Akkukapazität (kWh), optional
minsoc: 25 # Minimaler Ladestand (%), Untere Grenze beim Entladen der Batterie im normalen Betrieb (optional)
maxsoc: 95 # Maximaler Ladestand (%), Oberes Limit beim Laden der Batterie aus dem Netz (optional)
batteryconfiguri: /config # Batteriekonfigurations-URI, Firmware Versionen ab 1.36.5-1 erfordern /api/config. [/config, /api/config] (optional)
maxchargepower: # Maximale Ladeleistung (W), Für erzwungenes Laden des Speichers. (optional)
maxdischargepower: # Maximale Entladeleistung (W), Maximale Entladeleistung des Speichers. (optional)