# Fronius Solar API V1

Quelle: https://docs.evcc.io/de/meters/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: battery-control

## Parameter

| Name | Beschreibung | Standard / Beispiel | |
| --- | --- | --- | --- |
| host | IP-Adresse oder Hostname | 192.0.2.2 |  |
| user | Benutzername (für aktive Batteriesteuerung) bspw. E-Mail Adresse, User Id, etc. | customer |  |
| password | Passwort (für aktive Batteriesteuerung) Zugangspasswort des Dienstes |  |  |
| capacity | Akkukapazität | 50 kWh |  |
| minsoc | Minimaler Ladestand Untere Grenze wie am Batteriesystem eingestellt. Wird vom Optimizer genutzt. | 0 % |  |
| maxsoc | Maximaler Ladestand Obere Grenze wie am Batteriesystem eingestellt. Wird vom Optimizer und für Netzladen genutzt. | 100 % |  |
| batteryconfiguri | Batteriekonfigurations-URI Firmware Versionen ab 1.36.5-1 erfordern /api/config. (/config, /api/config) | /config | erweitert |
| maxchargepower | Maximale Ladeleistung Für erzwungenes Laden des Speichers. |  W | erweitert |
| maxdischargepower | Maximale Entladeleistung Maximale Entladeleistung des Speichers. |  W | erweitert |
| cache | Cache Zeitintervall für erneute Datenabfrage | 1s | erweitert |

## Konfigurationsbeispiel für evcc.yaml

```yaml
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)
```

```yaml
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)
```

```yaml
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. Wird vom Optimizer und für Netzladen genutzt. (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)
      cache: 1s # Cache, Zeitintervall für erneute Datenabfrage (optional)
```