site

Beschreibt den Standort mit den vorhandenen und benötigten Geräten der Hausinstallation und ist für das Regeln der verfügbaren Leistung zuständig.

Um das Laden mit PV-Überschuss zu regeln, ist ein auslesbarer Zähler direkt hinter dem Netzanschlusspunkt notwendig. Zusätzlich können auch Geräte für die PV-Leistung und Hausbatterie(n) angegeben werden. Mehrere Geräte werden dabei in der Leistung intern automatisch addiert. Bei Batteriespeichern wird der Mittelwert des Ladezustands gebildet.

Beispiel:

site:
  title: Zuhause # display name for UI
  meters:
    grid: mygridmeter # grid meter reference
    pv:
      - mypv1 # first pv meter reference
      - mypv9 # second pv meter reference
    battery:
      - mybat5 # battery meter reference
    aux:
      - myaux1 # self-regulating consumer
    ext:
      - myext1 # for data logging, load management, etc.
  residualPower: 100

---

Erforderliche Parameter

title

Die angezeigte Beschreibung des Ladepunktes, wird in der UI angezeigt.

Beispiel:

title: Zuhause

---

meters

Definiert welche konfigurierten meter (Strommessgeräte) als welche Art Messpunkt verwendet werden sollen. Hier erfolgt somit die logische Verknüpfung der Gerätedefiniton mit dem Verwendungszweck. Ein zunächst universeller Zähler bekommt somit entsprechend seines Einbauortes in der Hausinstallation einen Zweck zugewiesen.

Hinweis

Es ist mindestens die Konfiguration eines grid oder eines pv Elementes notwendig!

Ohne mindestens einen der beiden Einträge kann evcc nicht verwendet werden!

Beispiel:

site:
  meters:
    grid: mygridmeter # grid meter reference
    pv: mypv1 # pv meter reference
    battery: mybat2 # battery meter reference
    aux: myaux1

---

Optionale Parameter

meters.grid

Definiert das meter (Strommessgerät), welches die Messwerte des Netzanschlusspunktes liefert.

Mögliche Werte: Wert eines name Parameters in der meters Konfiguration.

Beispiel:

grid: mygridmeter # grid meter reference

---

meters.pv

Definiert die meter (Strommessgeräte), welche die PV-Erzeugungswerte liefern. Es können mehrere Geräte angegeben werden. Die Leistungsdaten werden automatisch addiert.

Mögliche Werte: Ein Wert oder eine Liste von Werten eines name Parameters in der meters Konfiguration. Wobei die Listenversion auch bei Einzelwerten genutzt werden kann.

Beispiel:

pv: myonlypv # single pv meter reference

oder

pv: # (pvs = veraltet)
  - myoldpv # first pv meter reference
  - mynewestpv # second pv meter reference

---

meters.battery

Definiert die meter (Strommessgeräte), welche die Messdaten des/der Batteriespeicher(s) liefern. Es können mehrere Geräte angegeben werden. Die Leistungsdaten werden automatisch addiert und aus den Speicherfüllständen wird ein Mittelwert gebildet.

Mögliche Werte: Ein Wert oder eine Liste von Werten eines name Parameters in der meters Konfiguration. Wobei die Listenversion auch bei Einzelwerten genutzt werden kann.

Beispiel:

battery: myonlybat # single battery meter reference

oder

battery: # (batteries = veraltet)
  - mysmallbat # first battery meter reference
  - myhugebat # second battery meter reference

meters.aux

Definiert die meter (Strommessgeräte), welche die Messdaten externer Geräte liefern, die über eine eigene Überschussregelung verfügen, aber nicht direkt durch evcc gesteuert werden. Es können mehrere Geräte angegeben werden. Die Leistungsdaten werden automatisch addiert.

In evcc fließt diese Leistung in die Berechnung der prinzipiell zur Verfügung stehenden Überschussleistung zur Fahrzeugladung ein. Es wird davon ausgegangen, dass die mittels der Aux-Meter gemessenen Geräte ihren Leistungsbedarf selbstständig und zeitnah reduzieren bzw. vollständig unterbrechen, wenn die gemessene Aux-Leistung durch evcc der Fahrzeugladung zugeschlagen wird.

Positiver Wert: zusätzliche verfügbare Überschussleistung (steht der Fahrzeugladung zur Verfügung)

Negativer Wert: fehlende Überschussleistung (steht der Fahrzeugladung nicht zur Verfügung)

Beispiele:

• Ein Heizstab für die Warmwasserbereitung, welcher autark auf Basis des PV-Überschuss am Netzübergang geregelt wird. Wenn die Leistungsmessung dieses Heizstabes als aux-Meter gemessen und eingerichtet wird, steht die gesamte Überschussleistung (Leistung des Heizstabs plus ggf. verbleibende Netzeinspeisung) jederzeit bevorzugt der Fahrzeugladung zur Verfügung. Greift die Fahrzeugladung darauf zu, sorgt die autarke Regelung des Heizstabes selbstständig dafür, dass dessen Leistung entsprechend reduziert wird.

Mögliche Werte: Ein Wert oder eine Liste von Werten eines name Parameters in der meters Konfiguration. Wobei die Listenversion auch bei Einzelwerten genutzt werden kann.

Beispiel:

aux: myaux # single aux meter reference

oder

aux:
  - myaux1 # first aux meter reference
  - myaux2 # second aux meter reference

residualPower

Legt den Soll-Arbeitspunkt der Überschussregelung am Netzübergang (Gridmeter) fest. Der Standardwert ist 0 (Watt). Positive Werte verschieben den Sollwert in Richtung Netzeinspeisung, negative Werte in Richtung Netzbezug. Mit diesem Wert wird der durch die Steuerung einzustellende “Ruhezustand” des Regelkreises eingestellt.

Insbesondere im Zusammenspiel mit weiteren unabhängigen Überschussausregelungen wie z. B. der eines Batteriespeichers ist es obligatorisch, diesen Wert anzupassen, um ein definiertes Systemverhalten mit klaren Prioritäten zu erzielen.

Soll im PV-Modus ein Netzbezugsanteil verbleiben bzw. zugelassen werden, muss hier eine negative Leistung entsprechend des Maximalanteils des Netzbezugs konfiguriert werden.

grid meter vorhanden

• Positiver Wert: Verbleibende Netzeinspeiseleistung
• Negativer Wert: Verbleibende Netzbezugsleistung

Nur pv meter vorhanden

• Positiver Wert: Typischer Hausverbrauch, um damit den PV-Überschuss abschätzen zu können
• Negativer Wert: angegebene Leistung wird zur PV-Leistung addiert und erhöht die zur Verfügung stehende Ladeleistung (Achtung: Netzbezug)

Hinweis

Bei Existenz eines Batteriespeichers wird dringend empfohlen hier einen kleinen Wert von 100 bis 300 (Watt) einzutragen, um damit eine Speicherladung gemäß der konfigurierten Prioritäten (siehe prioritySoc) zu ermöglichen. Andernfalls “sieht” die unabhängige Regelung des Speichers keinen nutzbaren Überschuss.

Ebenso lässt sich damit bei schnellen Erzeugungs- und Lastwechseln auch ohne Speicher ein kurzzeitiger Netzbezug besser vermeiden.

Beispiel “Batteriespeicher”:

residualPower: 100

Beispiel “Netzbezugsanteil”:

Die Ladung soll im PV-Modus mit mindestens 6A (einphasig) auch bereits mit nur 50% PV-Anteil beginnen (Rest Netzbezug) Mindestladeleistung: 1 Phase _ 6A _ 230V = 1380 W, davon 50%: 690 W. Siehe auch die Alternative mittels enable/disable um anteilig PV und Netzbezug zu erlauben.

residualPower: -690