Konfiguration

Einrichtung und Konfiguration

Hinweis zur Individualisierung

caution

In evcc sind sehr viele individuelle Einstellungen möglich. Die Default-Einstellungen der Parameter beruhen auf Erfahrungswerten und im Allgemeinen sind keine Änderungen notwendig.

Bei Individualisierung, bitte folgendes beachten:

• Da sich die Parameter teilweise gegenseitig beeinflussen, wird dringend empfohlen, Änderungen an diesen Einstellungen nur einzeln vorzunehmen und die Auswirkungen zu testen, bevor weitere Änderungen vorgenommen werden.

Sponsoring

info

Dadurch, dass Github die Bezahlmöglichkeiten für das Sponsoring geändert hat, ist leider kein Paypal mehr möglich.

Wer keine Kredit-/Debitkarte verwenden möchte, kann sich diesbezüglich per Mail an info@evcc.io wenden.

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).*/\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 unter Linux Autostart 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.

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.

Fehler: 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.

Fehler: 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.

Fehler: 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

Fehler: /tmp/evcc: operation not permitted oder/und 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 mit Hilfe 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.

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. Bislang konnte die Funktion auch über telemetry: true aktiviert werden. Dieser Weg ist nun allerdings veraltet ("deprecated").

Für die Teilnahme ist aktuell 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.