Zum Inhalt springen
Smart laden

loadpoints

loadpoints (Ladepunkte) ist eine Liste von Ladepunkten, die jeweils eine Wallbox, Fahrzeuge und, falls notwendig, einen Zähler mit weiteren optionalen Parametern kombinieren. Eine minimale Konfiguration erfordert eine Wallbox.

Beispiel:

loadpoints:
- title: Garage # Anzeigename in der UI
charger: wallbox # Referenz auf die Wallbox
vehicle: audi # Referenz auf das Standardfahrzeug
mode: smart # Lademodus (off, smart, now)

Referenzen entsprechen immer den Werten des Parameters name (z. B. wallbox) in der jeweiligen Gerätekonfiguration.

Im Folgenden werden alle möglichen Parameter erklärt.


Eine Beschreibung des Ladepunkts, die in der UI angezeigt wird.

Beispiel:

title: Garage

Referenz auf eine charger-Konfiguration.

Beispiel:

charger: wallbox

Dabei entspricht der Wert wallbox dem Wert des Parameters name in der Wallbox-Definition.


Referenz auf eine meter-Konfiguration (Zähler).

Dieser Eintrag wird nur benötigt, wenn die verwendete Wallbox keine eigene Strommessung durchführt oder evcc die Messwerte nicht aus der Wallbox auslesen kann. Aber selbst dann ist dieser Eintrag optional, denn evcc nimmt an, dass mit dem eingestellten maximalen Strom auch geladen wird.

Beispiel:

meter: charge

Dabei entspricht der Wert charge dem Wert des Parameters name in der Zähler-Definition.


vehicle: Referenz auf eine vehicle-Konfiguration, die dem Ladepunkt als Standardfahrzeug zugewiesen wird.

Wird ein Fahrzeug an die Wallbox angeschlossen, geht evcc davon aus, dass es sich um dieses Fahrzeug handelt. Die automatische Fahrzeugerkennung wird umgangen. Ist ein anderes Fahrzeug angeschlossen (z. B. ein Gastfahrzeug), lässt es sich nachträglich manuell zuweisen.

Beispiel:

vehicle: renault

Dabei entspricht der Wert renault dem Wert des Parameters name in der Fahrzeug-Definition.


evcc merkt sich den zuletzt genutzten Lademodus. Mit dem Parameter mode kannst du den Lademodus festlegen, der nach dem Abstecken des Fahrzeugs gelten soll.

Mögliche Werte:

  • off: Das Laden ist gestoppt, auch wenn ein Fahrzeug an der Wallbox angeschlossen ist.
  • smart: Lädt mit PV-Überschuss, in günstigen Stunden eines dynamischen Tarifs und nach Ladeplänen. Pausiert, wenn keine günstige Energie verfügbar ist.
  • now: Lädt sofort mit der maximal möglichen Leistung.

Standardwert: smart

Die veralteten Werte pv und minpv werden beim Schreiben weiterhin akzeptiert: pv aktiviert smart und schaltet Dauerhaft laden aus, minpv aktiviert smart und schaltet Dauerhaft laden ein.

Beispiel:

mode: smart

Definiert die Standardeinstellungen für den Umgang mit dem Ladestand eines angeschlossenen Fahrzeugs.

Beispiel:

soc:
poll:
mode: charging
interval: 60m
estimate: true

Definiert, wie die Fahrzeug-APIs genutzt werden, um aktuelle Informationen über das Fahrzeug abzurufen.

Ist bei der Wallbox das features-Flag integrateddevice konfiguriert, werden die Daten fortlaufend abgerufen. In diesem Fall sind keine poll-Einstellungen notwendig, gesetzte Einstellungen werden ignoriert.

Definiert, unter welchen Bedingungen die Fahrzeugdaten abgerufen werden.

Mögliche Werte:

  • charging: Daten nur während eines Ladevorgangs aktualisieren (empfohlene Standardeinstellung).
  • connected: Daten aktualisieren, wenn das Fahrzeug mit der Wallbox verbunden ist (nicht nur beim Laden); der Parameter interval legt die Häufigkeit fest.
  • always: Daten immer aktualisieren, auch wenn das Fahrzeug nicht mit der Wallbox verbunden ist; der Parameter interval legt die Häufigkeit fest (wird nur für ein Fahrzeug pro Ladepunkt unterstützt).

Standardwert: charging

Beispiel:

mode: charging

Definiert, wie oft das Fahrzeug nach Daten abgefragt wird, wenn es nicht lädt.

Standardwert: 60m

Beispiel:

interval: 60m

Schätzt den aktuellen Ladestand anhand der gemessenen Ladeenergie (Extrapolation) zwischen den per interval eingestellten Fahrzeugabfragen.

Mögliche Werte:

  • true: evcc extrapoliert die Ladestandswerte zwischen den Fahrzeugabfragen (empfohlen).
  • false: evcc nutzt nur die Ladestandswerte, die das Fahrzeug zurückliefert.

Standardwert: true

Beispiel:

estimate: false # Keine Extrapolation

Definiert das Verhalten beim Starten des Ladens mit PV-Überschuss im Smart-Modus. Außerdem legt der Parameter das Verhalten bei der automatischen Phasenumschaltung von 1p auf 3p fest.

Beispiel:

enable:
threshold: 0
delay: 1m

Definiert den Leistungsschwellwert am Netzanschlusspunkt in Watt (W).

Mögliche Werte: Ein positiver Wert für Netzbezug, ein negativer Wert für Einspeisung. Bei 0 muss die Einspeisung die Mindestladeleistung erreichen.

Standardwert: 0

Beispiel:

threshold: 0

Definiert, wie lange der threshold erfüllt sein muss.

Standardwert: 1m

Beispiel:

delay: 1m

Definiert das Verhalten beim Beenden des Ladens mit PV-Überschuss im Smart-Modus. Außerdem legt der Parameter das Verhalten bei der automatischen Phasenumschaltung von 3p auf 1p fest.

Beispiel:

disable:
threshold: 200 # maximale Netzbezugsleistung (W)
delay: 10m

Definiert den Leistungsschwellwert am Netzanschlusspunkt in Watt (W).

Mögliche Werte: Ein positiver Wert für Netzbezug. Bei 0 stoppt das Laden, sobald der Überschuss die Mindestladeleistung nicht mehr deckt.

Standardwert: 0

Beispiel:

threshold: 200 # Ein maximaler Netzbezug von 200 W ist erlaubt

Definiert, wie lange der threshold erfüllt sein muss.

Standardwert: 3m

Beispiel:

delay: 10m

Wallbox ohne automatische Phasenumschaltung:

Definiert die Anzahl der Phasen, mit denen die Wallbox angeschlossen ist.

Dieser Parameter ändert nichts am elektrischen Anschluss der Wallbox, sondern dient dazu, beim Laden mit PV-Überschuss (in Verbindung mit minCurrent) die minimale Startleistung zu ermitteln.

Seit Kurzem werden die anliegenden Spannungen ausgewertet, wenn der Zähler der Wallbox diese liefert. Anhand der Spannungen wird der phases-Wert automatisch per API geändert. In Fällen, in denen die Wallbox per Schalter auf 1p oder 3p eingestellt wird, ist damit keine manuelle Änderung des phases-Werts mehr notwendig.

In Fällen, in denen das 1p/3p-Laden nicht per Schalter, sondern über ein entsprechendes Ladekabel umgesetzt wird, führt diese „Automatik“ zu Problemen. Dann muss der phases-Wert beim vehicle entsprechend angepasst werden. Da sich dieser Wert nicht per API ändern lässt, hilft folgender Umweg:

Konfiguriere das Fahrzeug zweimal: einmal mit phases: 1 und einmal mit phases: 3. Je nach gewünschter Ladeart wählst du dann in der UI das passende Fahrzeug aus.

Ist ein bekanntes Fahrzeug angeschlossen, wird der kleinere Wert aus vehicle: phases und loadpoint: phases zur Berechnung herangezogen. Bei unbekannten Fahrzeugen wird nur loadpoint: phases berücksichtigt.

Während das Fahrzeug lädt und die Wallbox bzw. der Ladezähler die Phasenströme liefert, wird die tatsächliche Anzahl der Phasen erkannt und (solange das Fahrzeug angeschlossen bleibt) für die weitere Berechnung der Schaltschwellen genutzt. Das funktioniert nur bei dreiphasigen Ladepunkten.

Standardwert: 3

Mögliche Werte: 1|3

Beispiel:

phases: 1

Wallbox mit automatischer Phasenumschaltung:

Über den Wert wird die automatische Phasenumschaltung ein- bzw. ausgeschaltet.

phases: 0 = Automatische Umschaltung eingeschaltet

phases: 1 oder 3 = Automatische Umschaltung ausgeschaltet, der gesetzte Wert ist fest

Standardwert: 3

Mögliche Werte: 0|1|3

Beispiel:

phases: 0

Dieser Parameter priorisiert Ladepunkte untereinander während des Ladens.

Dem priorisierten Ladepunkt wird die Ladeleistung anderer nicht oder niedriger priorisierter Ladepunkte zur Verfügung gestellt. Greift ein priorisierter Ladepunkt auf diese Leistung zu, kann es kurzzeitig zu Netzbezug kommen, bis sich die Regelung eingependelt hat.

Höhere Werte bedeuten eine höhere Priorität. Ladepunkte ohne Eintrag haben priority: 0.

Bei mehreren Ladepunkten hat dieser Parameter keinen Einfluss darauf, in welcher Reihenfolge die Ladevorgänge gestartet werden. Lädt jedoch ein niedriger priorisierter Ladepunkt, wird ein höher priorisierter unter Umständen eingeschaltet, wenn ihm die ungenutzte Ladeleistung zur Verfügung gestellt wird.

Diese Priorisierung wirkt im Modus smart. Ist Dauerhaft laden aktiv, wird das Laden nicht unterbrochen, sondern nur auf das Minimum reduziert.

Standardwert: 0

Beispiel:

priority: 2