# Sonnen sonnenBatterie

Quelle: https://docs.evcc.io/de/meters/sonnen-sonnenbatterie

Für die aktive Batteriesteuerung muss über das Webinterface der sonnenBatterie (unter Software-Integration) das "JSON Write API" aktiviert und das dort generierte API-Token in der Batteriekonfiguration unter `token` eingetragen werden.
Als Betriebsart der sonnenBatterie werden die beiden Modi "Eigenverbrauch" (Standard) und "Time-of-use" unterstützt. Der Modus kann über den Parameter `defaultmode` an die Konfiguration der sonnenBatterie angepasst werden.
Die Leistung für das Netzladen kann an die Wechselrichterleistung der sonnenBatterie über den Parameter `maxchargepower` angepasst werden.

Unterstützte Funktionen: battery-control

## Parameter

| Name | Beschreibung | Standard / Beispiel | |
| --- | --- | --- | --- |
| host | IP-Adresse oder Hostname | 192.0.2.2 |  |
| defaultmode | Standardmodus für die aktive Batteriesteuerung Wechselrichter fällt nach einem Laden des Speichers oder Unterbinden der Entladung zurück auf diesen Modus. (self-consumption, time-of-use) | self-consumption |  |
| port | Port | 8080 |  |
| 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 % |  |
| token | Token API Token (benötigt für aktive Batteriesteuerung) |  |  |
| maxchargepower | Maximale Ladeleistung Für erzwungenes Laden des Speichers. | 3300 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: sonnenbatterie
      usage: grid
      host: 192.0.2.2 # IP-Adresse oder Hostname
      port: 8080 # Port, optional
      cache: 1s # Cache, Zeitintervall für erneute Datenabfrage (optional)
```

```yaml
meters:
    - name: my_pv
      type: template
      template: sonnenbatterie
      usage: pv
      host: 192.0.2.2 # IP-Adresse oder Hostname
      port: 8080 # Port, optional
      cache: 1s # Cache, Zeitintervall für erneute Datenabfrage (optional)
```

```yaml
meters:
    - name: my_battery
      type: template
      template: sonnenbatterie
      usage: battery
      host: 192.0.2.2 # IP-Adresse oder Hostname
      defaultmode: self-consumption # Standardmodus für die aktive Batteriesteuerung, Wechselrichter fällt nach einem Laden des Speichers oder Unterbinden der Entladung zurück auf diesen Modus. [self-consumption, time-of-use]
      port: 8080 # Port, 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)
      token: # Token, API Token (benötigt für aktive Batteriesteuerung) (optional)
      maxchargepower: 3300 # 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)
```