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 des Ladens und Entladens der Hausbatterie durch evcc.

Verwendung

Netzzähler
PV-Erzeugung
Batterie

Parameter

Name	Beschreibung	Stufe
`host`	IP-Adresse oder Hostname Beispiel: `192.0.2.2`	optional
`user`	Benutzername (für aktive Batteriesteuerung) bspw. E-Mail Adresse, User Id, etc. Standard: `customer`	optional
`password`	Passwort (für aktive Batteriesteuerung) Zugangspasswort des Dienstes	optional
`capacity` [kWh]	Akkukapazität Beispiel: `50`	optional
`minsoc` [%]	Minimaler Ladestand Untere Grenze wie am Batteriesystem eingestellt. Wird vom Optimizer genutzt. Standard: `0` Beispiel: `25`	optional
`maxsoc` [%]	Maximaler Ladestand Obere Grenze wie am Batteriesystem eingestellt. Genutzt vom Optimizer und, bei manchen Geräten, für Netzladen. Standard: `100` Beispiel: `95`	optional
`batteryconfiguri`	Batteriekonfigurations-URI Firmware Versionen ab 1.36.5-1 erfordern /api/config. Standard: `/config`	erweitert
`maxchargepower` [W]	Maximale Ladeleistung Höchste Leistung, mit der das Batteriesystem laden kann. Der Optimizer plant mit Laden bis zu dieser Leistung. Manche Geräte nutzen diesen Wert auch als Leistung für Netzladen.	erweitert
`maxdischargepower` [W]	Maximale Entladeleistung Höchste Leistung, mit der das Batteriesystem entladen kann. Der Optimizer plant mit Entladen bis zu dieser Leistung. Der Smart-Modus geht davon aus, dass die Batterie höchstens diese Leistung zum Fahrzeugladen beisteuert.	erweitert
`cache`	Cache Zeitintervall für erneute Datenabfrage Standard: `1s` Beispiel: `5m`	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.

NetzzählerPV-ErzeugungBatterie

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)
      cache: 1s # Cache, Zeitintervall für erneute Datenabfrage (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)
      cache: 1s # Cache, Zeitintervall für erneute Datenabfrage (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: 0 # Minimaler Ladestand (%), Untere Grenze wie am Batteriesystem eingestellt. Wird vom Optimizer genutzt. (optional)
      maxsoc: 100 # Maximaler Ladestand (%), Obere Grenze wie am Batteriesystem eingestellt. Genutzt vom Optimizer und, bei manchen Geräten, für Netzladen. (optional)
      batteryconfiguri: /config # Batteriekonfigurations-URI, Firmware Versionen ab 1.36.5-1 erfordern /api/config. [/config, /api/config] (optional)
      maxchargepower: # Maximale Ladeleistung (W), Höchste Leistung, mit der das Batteriesystem laden kann. Der Optimizer plant mit Laden bis zu dieser Leistung. Manche Geräte nutzen diesen Wert auch als Leistung für Netzladen. (optional)
      maxdischargepower: # Maximale Entladeleistung (W), Höchste Leistung, mit der das Batteriesystem entladen kann. Der Optimizer plant mit Entladen bis zu dieser Leistung. Der Smart-Modus geht davon aus, dass die Batterie höchstens diese Leistung zum Fahrzeugladen beisteuert. (optional)
      cache: 1s # Cache, Zeitintervall für erneute Datenabfrage (optional)