Häufige Fragen
Einrichtung
Kann ich evcc ohne Netzzähler betreiben?
Der Netzzähler ist das Kernstück für evcc und sollte, wenn möglich, eingebunden werden.
Es ist jedoch ebenso möglich, sonnengeführtes Laden ausschließlich auf der Grundlage der PV-Leistung zu betreiben.
In dieser Konstellation kann nicht mit PV-Überschuss geladen werden, da der dazu notwendige Messpunkt (Zähler) fehlt.
Stattdessen wird in den Lademodi PV und Min+PV mit der PV-Erzeugungsleistung gearbeitet.
Als Optimierung kann über die Einstellung residualPower
ein typischer mittlerer Hausverbrauch angegeben werden.
Beispiel:
site:
residualPower: 250 # 250W Hausverbrauch
Ich habe keine PV Anlage, kann ich evcc trotzdem sinnvoll einsetzen?
Hier gibt es verschiedene Nutzungsmöglichkeiten. Notwendig ist auf jeden Fall ein auslesbarer Netzzähler. Bei einem variablen Stromtarif (z.B. Nachtstrom, Tibber, Awattar) ist automatisches preisabhängiges Laden möglich. Ansonsten kann man evcc zur Fernsteuerung (start/stop) der Wallbox nutzen. Darüber hinaus kann man die Ladung einer Fahrzeugbatterie auf einen bestimmten Ladestand (SoC) begrenzen. In diesem Fall ist es aber zwingend notwendig, dass das Fahrzeug in die Konfiguration mit aufgenommen wird.
Kann ich evcc ausprobieren ohne alle Bestandteile (PV-Anlage, Wallbox, ...) zu haben?
Wenn einige Komponenten noch nicht vorhanden sind, lassen sich "Demo" Komponenten einsetzen. Dazu sind entsprechende Template eingerichtet.
Kann ich evcc ohne Einbindung des PV-Wechselrichters betreiben?
Ja, wenn ein Netzzähler und eine steuerbare Wallbox vorhanden sind, reicht dies für alle wesentlichen Funktionen von evcc inkl. Überschussladung aus. Es fehlt dann nur die Visualisierung der PV-Erzeugung sowie einige der daraus abgeleiteten Berechnungen und Statistiken. Darüber hinaus besteht aber die Möglichkeit, die PV-Erzeugungsleistung mit einem nachgerüsteten Erzeugungszähler direkt zu erfassen und somit alle Features wie bei einer direkten Anbindung des PV-Wechselrichters zu nutzen.
Kann ich mehrere Wallboxen nutzen?
Mehrere Wallboxen und damit Ladepunkte können in evcc verwendet werden. Es ist jedoch heute noch kein Lastmanagement möglich. Das ist auf unserer langen Liste für die weitere Entwicklung.
Meine Wallbox hat keine Phasenumschaltung. Kann ich trotzdem 1-phasig laden?
Bei kleinen PV-Anlagen und/oder im Winter macht es Sinn nur 1-phasig zu laden, um den vorhandenen Überschuss bestmöglich ohne Netzbezug zu nutzen.
Bei Wallboxen die keine automatische Phasenumschaltung beherrschen, kann man in der Zuleitung zur Wallbox mittels eines Lasttrennschalters (z.B. Hager HAB304) die Phasen 2 & 3 abschalten. Wenn die volle Leistung benötigt wird, schaltet man die Phasen wieder zu.
Dieses manuelle Umschalten darf nur erfolgen, wenn das Fahrzeug NICHT mit der Wallbox verbunden ist.
Alternativ kann im Winter auch einfach ein einphasiges Ladekabel verwendet werden.
Damit evcc weiß, dass nicht mehr 3-phasig geladen werden kann muss die entsprechende Einstellung am Ladepunkt über die UI angepasst werden.
Fehlersuche
Syntax-Fehler in der evcc.yaml finden
yaml ist sehr syntax-empfindlich. Fehler fallen nicht immer sofort ins Auge.
Eine schnelle Hilfe bieten yaml-Tester wie z.B. (https://onlineyamltools.com/validate-yaml)
Etwas funktioniert nicht. Was nun?
Bei evcc gibt es einen Community Support. Hier helfen sowohl Entwickler als auch Anwender bei verschiedenen Problemen. Es wäre gut, dabei möglichst genaue Informationen zu folgenden Bereichen mitzuteilen:
-
Welche Geräte (Fahrzeug, Hausinstallation, Wallbox) verwendet werden.
-
Die Konfigurationsdatei
evcc.yaml
,
d.h. deren Inhalt (bitte Benutzernamen, Passwörter und ähnliches entfernen).
egrep -v '^#|^\s+#' evcc.yaml |grep . |sed -E 's/(password|user|token|url|host|broker|accessToken|refreshToken|vin).*/\1: *****/'
-
alternativ kann mit
evcc dump --cfg >~/config.txt
eine anonymisierte Konfigurationsdatei erstellt und unter dem angegebenen Namen im Home-Verzeichnis gespeichert werden. -
Eine möglichst genaue Beschreibung was das Problem ist.
Erste Hilfe
Zur Erleichterung wurde eine Erste-Hilfe Funktionalität entwickelt. Durch Eingabe von evcc discuss
auf der Kommandozeile wird ein neuer Diskussionsbeitrag in der Rubrik "Erste Hilfe" erstellt. Dieser Beitrag beinhaltet automatisch die Fehlermeldung(en) und die anonymisierte Konfigurationsdatei. Ergänzt werden muss nur noch ein aussagekräftiger Titel und eine Problembeschreibung.
Diese Erste-Hilfe ist jeweils nur für die Erst-Erstellung eines Diskussionsbeitrages nutzbar. Sind im Zuge der Lösungsfindung weitere Informationen notwendig, müssen diese händisch erstellt werden.
Wir versuchen natürlich Probleme so gut es geht zu vermeiden, aber das kann aufgrund der Komplexität leider nicht immer gelingen.
Wie kann ich ein Logfile zur Fehleranalyse erstellen?
evcc gibt in seiner Standard Konfiguration nur dann Fehlermeldungen aus, wenn ein Fehler auftritt (siehe auch log
Parameter in der evcc.yaml
).
Wenn evcc auf der Konsole ausgeführt wird, werden die log
Nachrichten einfach in die normale Ausgabe geleitet.
Mittels evcc charger
oder evcc meter
oder evcc vehicle
können auf der Kommandozeile die verschiedenen Gerätetypen getestet werden. Dabei kommt der in evcc.yaml
konfigurierte Log-Parameter (siehe oben) zum Einsatz. Will man davon abweichende Tests durchführen, kann der Log-Parameter beim Aufruf entsprechend ergänzt werden.
Beispiel: evcc -l debug meter
Wird evcc als Linux Systemdienst, wie hier beschrieben, ausgeführt, können die log-Nachrichten über folgende Befehle verfolgt, bzw. aufgelistet werden:
- Kontinuierliche Anzeige der evcc log Meldungen
sudo journalctl -fau evcc
- Anzeige der evcc log Meldungen seit dem letzten Start des evcc Services (Abbruch mit Strg-c)
sudo journalctl -u evcc -q
- Speichern der Log-Ausgabe in eine Datei im Home-Verzeichnis
sudo journalctl -u evcc -q > ~/evcc.log
- Ergänzend kann auch noch Start- (
-S
) und Endzeitpunkt (-U
) der Log-Ausgabe bestimmt werden
sudo journalctl -u evcc -S "2023-03-21 07:00:00" -U "2023-03-21 08:00:00" -q > ~/evcc.log
Weiterführende Hilfe: wiki.ubuntuusers.de/systemd/journalctl
Im Falle einer Docker Installation kann man über docker logs
die Nachrichten anzeigen lassen, siehe Docker Dokumentation.
Als Ergänzung zu den Konsolenausgaben gibt es auch die Möglichkeit, das fortlaufenden Log im WebUI einzusehen und herunterzuladen. Dazu im Web-Menü (oben rechts) den Menüpunkt "Logs" auswählen. Dort kann auch nach verschiedenen Level und Bereichen gefiltert werden.
Dieses Log umfasst allerdings nur die letzten 10k Zeilen.
Weiterführende Hilfe bei der Geräteerkennung
evcc detect
ist ein spezielles Kommando, welches eine Art Hardwareerkennung und Netzwerksuche für bestimmte Geräte ermöglicht.
Insbesondere hilft es manchmal bei der ersten Einschätzung von "neuen" SunSpec-kompatiblen Modbus-Geräten und bei der Validierung von IP-Konfigurationen.
Es ist aber mehr ein Entwickler- und Supporttool zu Diagnosezwecken und erkennt auch nur einen nicht näher definierbaren Gerätetypenkreis.
Fehlermeldungen
Charger out of sync: expected disabled, got enabled
Charger logic error: disabled but charging
evcc erwartet nach einem Intervallzyklus bereits den neuen korrekten Status.
Wenn manche Geräte etwas zu langsam auf Anweisungen reagieren, kommt es kurzzeitig zu einem undefinierten Zustand, der mit diesen Fehlern quittiert wird.
Sollten ansonsten keine Probleme auftreten, kann die Meldung ignoriert werden.
Abhilfe schafft ein größeres interval
.
connection refused
Die IP-Verbindung zum betreffenden Gerät ist prinzipiell vorhanden, jedoch wird der Verbindungsaufbau von diesem Gerät zum angegebenen Port abgewiesen.
Die Gründe dafür können vielfältig sein. Typisch sind:
- Der am Gerät offene Port stimmt nicht mit dem in der evcc-Konfiguration angegebenen Zielport überein.
- Der externe Zugriff auf das Gerät ist nicht aktiviert (z.B. bei Solaredge-Wechselrichtern im Auslieferungszustand).
- Die maximal mögliche Anzahl an parallelen Verbindungen, die das Zielgerät verwalten kann, ist erschöpft. Andere Verbindungen z. B. von Hausautomationen, Skripten oder weiteren Instanzen von evcc müssen ggf. zunächst beendet werden, bevor eine neue Verbindung möglich ist. Im ungünstigsten Fall lässt das Zielsystem nur eine einzige Verbindung zu.
- Blockade durch eine Firewall.
i/o timeout
Hier ist eine Verbindung zum Gerät ggf. vorhanden, jedoch antwortet das Zielsystem nicht innerhalb der vorgesehenen Zeit. Entweder kommt die Anfrage gar nicht beim Zielsystem an, geht auf dem Rückweg verloren oder die Antwort dauert zu lange.
Typische Gründe sind:
- Langsame oder schlechte Netzwerkverbindung (insbesondere bei Verbindungen über WiFi oder PowerLAN)
- Fehlerhafte oder ungeeignete Verkabelung oder (bei RS485) falsche Terminierung
- Das Zielgerät ist überlastet oder ausgefallen
- Bestimmte Funktionen des Geräts sind nicht wie von evcc erwartet verfügbar (z. B. durch veraltete Firmware oder abweichende Konfigurationseinstellungen)
- Zu kurze Timeout- oder Abfragezykluszeiten seitens evcc
/tmp/evcc: operation not permitted
bind: address already in use
Diese Fehlermeldung erscheint, wenn z B. evcc bereits als Dienst läuft und evcc zusätzlich ein weiteres Mal auf der Kommandozeile (durch Eingabe evcc
) gestartet wird, ggf. auch noch mit unterschiedlichen Benutzerberechtigungen.
Es darf immer nur eine einzige Instanz von evcc zur gleichen Zeit laufen.
Eine Prüfung, ob mehrere evcc Prozesse laufen, kann unter Linux mithilfe von htop
erfolgen.
Sollte es Gründe geben, evcc auf der Kommandoebene zu starten, sollte vorher der Dienst mit sudo systemctl stop evcc
beendet werden.
evcc UI ist nicht erreichbar (Demo Modus funktioniert aber)
Es kommt immer wieder vor, dass Fehler in der Konfiguration übersehen werden und der Service gestartet wird. Dabei wird der Start von evcc abgebrochen, ohne das es dafür einen Hinweis gibt. Ergebnis ist, dass das UI nicht erreichbar ist.
In dem Fall sollte man evcc durch Eingabe von evcc
auf der Kommandozeile starten.
Dort werden dann auch Fehlerhinweise gegeben, die den Start des Service verhindert haben.
Mittels der oben genannten Tests kann man diesen Fehlern auf den Grund gehen und sie beheben. Erst wenn alles fehlerfrei ist, sollte der Service gestartet werden.
Laden
Auto lädt beim Einstecken obwohl kein Überschuss vorhanden ist
Bei einigen Wallboxen wird die Ladung sofort nach dem Einstecken gestartet oder durch das Präsentieren einer RFID-Karte ausgelöst. Das Startverhalten können wir leider nicht immer beeinflussen. evcc erkannt dieses Fehlverhalten aber und stoppt die Ladung nach kurzer Zeit.
PV-Erzeugung im Winter nutzen
In den Wintermonaten ist die PV Erzeugung meist unterhalb oder im Bereich der Mindestleistung. Um dennoch möglichst viel eigenen Strom ins Fahrzeug zu laden, kann man folgende "Tricks" anwenden:
mittels residualpower
In der Konfiguration unter site
setzt man residualPower
auf einen negativen Wert. Dieser bestimmt dann wieviel Netzbezug im PV Modus noch erlaubt ist. Eine Änderung ist per API möglich.
Beispiel:
site:
residualPower: -1000 # 1000W Netzbezug im PV Modus erlaubt
"Nachteil" dieser Lösung ist, dass auch bei ausreichendem Überschuss dieser erlaubte Netzbezug ausgenutzt wird.
mittels enable/disable
In der Konfiguration unter loadpoints
stellt man bei enable
und disable
das gewünschte Verhalten ein. Eine Änderung der threshold
Werte ist per API möglich.
Beispiel:
loadpoints:
enable:
delay: 1m
threshold: -200 # es wird eingeschaltet, wenn 1 Minute lang 200 W Einspeisung vorhanden sind
disable:
delay: 30m
threshold: 1200 # es wird ausgeschaltet, wenn 30 Minuten lang mehr als 1200 W Netzstrom bezogen wurde
PSA: Bei meinem Peugeot/Opel wird der Ladezustand nur aktualisiert, wenn ich die Hersteller-App benutze
Das ist leider eine Einschränkung der Herstellerschnittstelle. PSA liefert veraltete Werte aus, solange diese nicht über die App erneuert werden. Leider ist bislang noch keine Schnittstelle bekannt, um diese Erneuerung programmatisch anzustoßen.
Passwort
Ich habe mein Passwort vergessen. Wie kann ich es ändern?
Das Passwort wird verschlüsselt gespeichert, daher kann es nicht ausgelesen werden. Du kannst über die Kommandozeile ein neues Passwort setzen.
evcc password set
Alternativ kannst du das Passwort auch zurücksetzen. Dann wirst du beim nächsten Aufruf der evcc UI aufgefordert ein neues Passwort zu vergeben.
evcc password reset
Statistische Daten
Telemetry & Community Daten
Auf der evcc Webseite und im "Auswertung Ladeenergie" Dialog der evcc-UI zeigen wir aggregierte Live-Ladedaten der evcc-Installationen an. Wir sammeln diese Daten auf unserer zentralen api.evcc.io Instanz. Die Teilnahme daran ist selbstverständlich freiwillig.
Wie kann ich teilnehmen?
Im "Auswertung Ladeenergie" Dialog kannst du unter "Live-Community" deine Daten teilen.
Für die Teilnahme ist ein 💚 Sponsor Token erforderlich. Der Hauptgrund dafür ist die Datenqualität hoch zu halten und Fake-Daten zu minimieren.
Was wird aktuell übertragen?
- aktuelle Ladeleistung
- aktueller Anteil an Sonnenstrom
- geladene Energiemenge
- geladener Anteil an Sonnenenergie
Möglicherweise werden wir zukünftig noch weitere Daten hinzufügen. Dies werden aber auf keinen Fall personenbezogene Daten oder private Installationsdaten (Adresse, Zugänge) sein. Eure Privatsphäre ist uns wichtig!
Was passiert mit den Daten?
Wir speichern die Energiemengen aggregiert pro evcc-Instanz. Wir bilden keine Nutzerprofile über Zeit und haben auch kein Interesse daran dies zukünftig zu tun.
Unser Ziel ist es durch diese Daten mehr neue Nutzer für evcc zu begeistern, selbst mehr über das Nutzungsverhalten von evcc zu erfahren und vor allem das durch evcc nutzbar gemachte Potenzial regenerativer Sonnenenergie zu visualisieren.
Die dargestellten aggregierten Gesamtdaten können auch frei über https://api.evcc.io/v1/total abgerufen werden. Wenn ihr also Ideen für eigene kreative Visualisierungen habt, baut gerne was und erzählt uns davon.
Mehr Informationen findest du auch auf unserer Datenschutzseite.
Ersparnisberechnung
In der evcc Oberfläche wird dir unten rechts angezeigt wieviel Prozent deiner geladenen Energie aus eigenem Sonnenstrom stammt (Beispiel: 85% Sonnenenergie). Beim Klick darauf öffnet sich ein Dialog der mehr Details zur Ladenergie und deinen eingesparten Kosten zeigt. Damit diese Werte korrekt sind, musst du deinen Energie- und Einspeisepreis in der Konfiguration hinterlegen. Hier ein Beispiel:
Beispiel:
tariffs:
currency: EUR # (default EUR)
grid:
type: fixed
price: 0.294 # [currency]/kWh
feedin:
type: fixed
price: 0.08 # [currency]/kWh
Mehr Details zur Konfiguration findest du in tariffs
.
Für die Berechnung der Einsparungen erfasst evcc grob die Gesamtmenge der geladenen Energie und die verwendeten Energiequellen (Netz, Batterie, PV).
Was ist Sonnenenergie?
Die direkte PV-Nutzung und die vom Batteriesystem bereitgestellte Energie werden bei dieser Berechnung gleich behandelt. evcc geht davon aus, dass der Hausspeicher primär zur Speicherung von überschüssigem, selbstproduzierten Sonnenstrom verwendet wird. Erfüllt der Speicher auch netzdienliche Leistungen (bspw. Sonnen) oder führt eine Kalibrierung mit Netzstrom durch, ist diese Annahme nicht immer korrekt. Batterieverluste durch die Umwandlung werden nicht berücksichtigt.
Berechnung von Ersparnis und effektivem Energiepreis
Der Algorithmus unterscheidet zwischen Netzstrom und selbst erzeugter Sonnenenergie (PV, Batterie). Der Kostenvorteil deiner Sonnenenergie ergibt sich aus der Differenz zwischen deinem Netzbezugspreis (z.B. 30 ct/kWh) und deinem Einspeisetarif (z.B. 8 ct/kWh). Jede geladene kWh selbst produzierter Energie ist in diesem Beispiel 22 ct (30 ct - 8 ct) günstiger als der Netzbezug. Hast du 2 kWh eigene Energie geladen entspricht das einer Ersparnis von 44 ct.
Würdest du dein Auto zu 100% mit eigener Sonnenenergie laden, entspricht der angezeigte effektive Energiepreis deiner, nicht eingenommenen, Einspeisevergütung (bspw. 8 ct/kWh). Lädst du dein Auto zu 50% aus Sonnenenergie und zu 50% aus Netzstrom passt sich der Energiepreis entsprechend an (bspw. 19 ct/kWh).
Wenn du keine Einspeisevergütung erhältst, kannst du den Einspeisepreis auf 0 setzen. Die Sonnenenergie wird dann als kostenlos gerechnet.
Uns ist klar, dass diese Einsparung nicht allein evcc zuzuschreiben ist. Steckst du dein Auto an einem sonnigen Tag an eine dumme Wallbox, wird ein Teil der geladenen Energie auch Sonnenstrom sein. evcc hilft dir aber den Anteil der geladenen Sonnenenergie zu maximieren.
Berechnung des Sonnenenergieanteils
Wenn du gleichzeitig Energie aus verschiedenen Quellen beziehst (z.B. 50% PV, 50% Netzbezug), wird die selbst erzeugte Energie zuerst dem Haus, also allen nicht von evcc gesteuerten Verbrauchern, zugeordnet. Der verbleibende Anteil wird dann auf die Ladevorgänge aufgeteilt. Beispiel: Deine PV-Anlage erzeugt 3 kW. Diese 3 kW werden komplett vom Haus verbraucht (bspw. Waschmaschine). Parallel lädst du dein Auto mit 3 kW (bspw. Modus = schnell). Das Haus wird in diesem Fall mit 100% Sonnenanteil gerechnet, das Auto mit 0%.
Flexible Preise (Octopus Energy, Awattar, Tibber, etc) werden für die Ermittlung des effektiven Energiepreises berücksichtigt.
Heizstab & Wärmepumpe
Beispiel: SG-Ready-Kontakt mit Shelly
In dem Beispiel wird der SG-Ready-Kontakt einer Trinkwasserwärmepumpe gesteuert.
"Vehicle-Soc" dient dabei als Anzeige für die Temperatur.
- Shelly 3EM als Grid-Meter
- Shelly EM (Stromzange) als Charge-Meter
- Shelly 1 als Charger (öffnet/schließt den SG-Ready-Kontakt)
Beispielkonfiguration
network:
schema: http
host: evcc.local
port: 7070
interval: 10s
log: info
meters:
- name: grid
type: template
template: shelly-3em # Shelly 3EM als Grid-Meter
usage: grid
host: 192.168.178.28
- name: WP_Pwr
type: template
template: shelly-1pm # Shelly EM Stromzange 2
#usage: charge
host: 192.168.178.21
channel: 1
chargers:
- name: WP_SG
type: template
template: shelly # Shelly 1 für SG-Kontakt
host: 192.168.178.29
standbypower: -1
integrateddevice: true
heating: true
vehicles:
- name: WP
type: custom
title: Wärmepumpe
icon: waterheater
phases: 1
soc:
source: mqtt
topic: Haus/Wasser_Temp
loadpoints:
- title: Warmwasser
charger: WP_SG
meter: WP_Pwr
vehicle: WP
enable:
threshold: 0
delay: 1m
disable:
threshold: 0
delay: 15m # Laufzeit mindestens 15 Minuten
soc:
estimate: false
poll:
mode: always
interval: 5m
site:
- title: Wasser
meters:
grid: grid
mqtt:
broker: raspberrypi:1883
topic: evcc