# SunEnergyXT SunEnergyXT 500 / 500 PRO

Quelle: https://docs.evcc.io/de/meters/sunenergyxt-sunenergyxt-500-500-pro

Der lokale Modus der Batterie muss in der Hersteller-App aktiviert werden.
Des Weiteren muss die IP-Adresse des Geräts im Router auf eine feste, dauerhafte IP-Adresse eingestellt werden.
Mit der Batterie muss ein externer Zähler (z. B. Shelly) verbunden sein, der den Hausanschlusspunkt misst (dieser wird über die Hersteller-App hinzugefügt).
Er wird für die Verwendung `grid` benötigt und ebenso für die Verwendung `battery`, da der normale Batteriemodus die
Nulleinspeise-Regelung des Geräts aktiviert, die diesen Zähler ausliest.

Unterstützte Funktionen: battery-control

## Bekannte Einschränkungen

- Aktuell muss jeder Kopfspeicher einzeln in EVCC angelegt werden.
Mehrere Kopfspeicher in ein System zu verbinden, ist vom Hersteller angekündigt, jedoch softwareseitig noch nicht umgesetzt.

- `maxacpower` und `maxdischargepower` werden aus dem gewählten `model` abgeleitet, wenn sie leer bleiben.
Ein ausdrücklich gesetzter Wert hat Vorrang und wird nicht auf das Modell-Limit begrenzt.


## Parameter

| Name | Beschreibung | Standard / Beispiel | |
| --- | --- | --- | --- |
| model | Modell `standard` für die SunEnergyXT 500, `pro` für die SunEnergyXT 500 PRO. Bestimmt die maximale AC- und Entladeleistung (800 W bzw. 2400 W). (standard, pro) |  |  |
| host | IP-Adresse oder Hostname | 192.0.2.2 |  |
| capacity | Akkukapazität Gesamtkapazität des Speichers: Kopfspeicher 5 kWh, jede Erweiterung +5 kWh. Also 5 (nur Kopfspeicher), 10 (+1 Erweiterung) oder 15 (+2 Erweiterungen). Die Anzahl der erkannten Akkupakete steht im Feld `ON` unter `/read`. | 5 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 % |  |
| maxacpower | Maximale AC Leistung des Hybrid-Wechselrichters | 0 W | erweitert |
| maxchargepower | Maximale Ladeleistung Für erzwungenes Laden des Speichers. | 2400 W | erweitert |
| maxdischargepower | Maximale Entladeleistung Maximale Entladeleistung des Speichers. |  W | erweitert |
| cache | Cache Zeitintervall für erneute Datenabfrage | 2s | erweitert |
| timeout | Zeitüberschreitung | 10s | erweitert |

## Konfigurationsbeispiel für evcc.yaml

```yaml
meters:
    - name: my_grid
      type: template
      template: sunenergyxt-500
      usage: grid
      model: # Modell, `standard` für die SunEnergyXT 500, `pro` für die SunEnergyXT 500 PRO. Bestimmt die maximale AC- und Entladeleistung (800 W bzw. 2400 W). [standard, pro]
      host: 192.0.2.2 # IP-Adresse oder Hostname
      cache: 2s # Cache, Zeitintervall für erneute Datenabfrage (optional)
      timeout: 10s # Zeitüberschreitung, optional
```

```yaml
meters:
    - name: my_pv
      type: template
      template: sunenergyxt-500
      usage: pv
      model: # Modell, `standard` für die SunEnergyXT 500, `pro` für die SunEnergyXT 500 PRO. Bestimmt die maximale AC- und Entladeleistung (800 W bzw. 2400 W). [standard, pro]
      host: 192.0.2.2 # IP-Adresse oder Hostname
      maxacpower: 0 # Maximale AC Leistung des Hybrid-Wechselrichters (W), optional
      cache: 2s # Cache, Zeitintervall für erneute Datenabfrage (optional)
      timeout: 10s # Zeitüberschreitung, optional
```

```yaml
meters:
    - name: my_battery
      type: template
      template: sunenergyxt-500
      usage: battery
      model: # Modell, `standard` für die SunEnergyXT 500, `pro` für die SunEnergyXT 500 PRO. Bestimmt die maximale AC- und Entladeleistung (800 W bzw. 2400 W). [standard, pro]
      host: 192.0.2.2 # IP-Adresse oder Hostname
      capacity: 5 # Akkukapazität (kWh), Gesamtkapazität des Speichers: Kopfspeicher 5 kWh, jede Erweiterung +5 kWh. Also 5 (nur Kopfspeicher), 10 (+1 Erweiterung) oder 15 (+2 Erweiterungen). Die Anzahl der erkannten Akkupakete steht im Feld `ON` unter `/read`. (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)
      maxchargepower: 2400 # Maximale Ladeleistung (W), Für erzwungenes Laden des Speichers. (optional)
      maxdischargepower: # Maximale Entladeleistung (W), Maximale Entladeleistung des Speichers. (optional)
      cache: 2s # Cache, Zeitintervall für erneute Datenabfrage (optional)
      timeout: 10s # Zeitüberschreitung, optional
```