# EcoFlow Stream

Quelle: https://docs.evcc.io/de/meters/ecoflow-stream

Für die Nutzung des EcoFlow Stream Meters benötigen Sie:
- Einen gültigen Access Key von der EcoFlow Developer Console
- Den entsprechenden Secret Key
- Die Seriennummer des Hauptgerätes Ihres Stream Systems

Diese Credentials erhalten Sie über die EcoFlow Developer Console nach der Registrierung Ihrer Anwendung.

Im Normalbetrieb wird die Backup Reserve auf `minsoc` gesetzt, beim Netzladen auf `maxsoc`.

**Achtung**: Die aktive Batteriesteuerung überschreibt die in der EcoFlow App eingestellte
Backup Reserve. Das Gerät verlangt, dass die Backup Reserve das Entladelimit um 3 übersteigt,
niedrigere Werte für `minsoc` werden angehoben. Ohne `minsoc` entlädt die Batterie bis zum
Entladelimit des Geräts.

Unterstützte Funktionen: battery-control

## Parameter

| Name | Beschreibung | Standard / Beispiel | |
| --- | --- | --- | --- |
| accesskey | Access Key Access Key aus der EcoFlow Developer Console |  |  |
| secretkey | Secret Key Secret Key aus der EcoFlow Developer Console |  |  |
| serial | Seriennummer Seriennummer des Hauptgeräts (normalerweise das erste Gerät) Ihres Stream Systems |  |  |
| 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 % |  |
| region | API Region Manche Nutzer, z.B. mit Starlink-Internet, sehen gelegentlich in den Logs den "error code 8513". Das passiert, wenn die API Region nicht korrekt erkannt wird. Um das zu beheben, kann man die API Region manuell setzen. Mögliche Werte: auto (Standard), europe oder america. (auto, europe, america) | auto | erweitert |
| cache | Cache Zeitintervall für erneute Datenabfrage | 30s | erweitert |
| maxchargepower | Maximale Ladeleistung Für erzwungenes Laden des Speichers. |  W | erweitert |
| maxdischargepower | Maximale Entladeleistung Maximale Entladeleistung des Speichers. |  W | erweitert |

## Konfigurationsbeispiel für evcc.yaml

```yaml
meters:
    - name: my_grid
      type: template
      template: ecoflow-stream
      usage: grid
      accesskey: # Access Key, Access Key aus der EcoFlow Developer Console
      secretkey: # Secret Key, Secret Key aus der EcoFlow Developer Console
      serial: # Seriennummer, Seriennummer des Hauptgeräts (normalerweise das erste Gerät) Ihres Stream Systems
      region: auto # API Region, Manche Nutzer, z.B. mit Starlink-Internet, sehen gelegentlich in den Logs den "error code 8513". Das passiert, wenn die API Region nicht korrekt erkannt wird. Um das zu beheben, kann man die API Region manuell setzen. Mögliche Werte: auto (Standard), europe oder america. [auto, europe, america] (optional)
      cache: 30s # Cache, Zeitintervall für erneute Datenabfrage (optional)
```

```yaml
meters:
    - name: my_pv
      type: template
      template: ecoflow-stream
      usage: pv
      accesskey: # Access Key, Access Key aus der EcoFlow Developer Console
      secretkey: # Secret Key, Secret Key aus der EcoFlow Developer Console
      serial: # Seriennummer, Seriennummer des Hauptgeräts (normalerweise das erste Gerät) Ihres Stream Systems
      region: auto # API Region, Manche Nutzer, z.B. mit Starlink-Internet, sehen gelegentlich in den Logs den "error code 8513". Das passiert, wenn die API Region nicht korrekt erkannt wird. Um das zu beheben, kann man die API Region manuell setzen. Mögliche Werte: auto (Standard), europe oder america. [auto, europe, america] (optional)
      cache: 30s # Cache, Zeitintervall für erneute Datenabfrage (optional)
```

```yaml
meters:
    - name: my_battery
      type: template
      template: ecoflow-stream
      usage: battery
      accesskey: # Access Key, Access Key aus der EcoFlow Developer Console
      secretkey: # Secret Key, Secret Key aus der EcoFlow Developer Console
      serial: # Seriennummer, Seriennummer des Hauptgeräts (normalerweise das erste Gerät) Ihres Stream Systems
      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)
      region: auto # API Region, Manche Nutzer, z.B. mit Starlink-Internet, sehen gelegentlich in den Logs den "error code 8513". Das passiert, wenn die API Region nicht korrekt erkannt wird. Um das zu beheben, kann man die API Region manuell setzen. Mögliche Werte: auto (Standard), europe oder america. [auto, europe, america] (optional)
      cache: 30s # Cache, Zeitintervall für erneute Datenabfrage (optional)
      maxchargepower: # Maximale Ladeleistung (W), Für erzwungenes Laden des Speichers. (optional)
      maxdischargepower: # Maximale Entladeleistung (W), Maximale Entladeleistung des Speichers. (optional)
```