Zum Hauptinhalt springen

Konfiguration

Diese Anleitung beschreibt, wie du an eine funktionierende evcc.yaml Datei kommst.

Mit Assistenten​

Über den evcc configure Befehl kannst du dir eine Konfigurationsdatei über einen Terminal-basierten Assistenten erstellen lassen. In einem Frage-Antwort-Dialog kannst du deine jeweiligen Geräte konfigurieren.

Voraussetzungen​

Um den Assistenten nutzen zu können, muss evcc auf deinem System installiert sein. Zudem musst du den evcc Befehl mit der Kommandozeile (Terminal, Shell, Eingabeaufforderung) ausführen können. Läuft evcc auf einem System, wo du diesen Zugriff nicht hast (bspw. Home Assistant, Docker), kannst du den Assistenten leider nicht nutzen.

hinweis

evcc configure kann auch in einem Docker Container gestartet werden. Siehe dafür die Erklärung in Docker.

Assistent ausführen​

Starte die Konfiguration und folge den Anweisungen im Terminal Fenster:

evcc configure

Du solltest eine Ausgabe wie die folgende sehen:

evcc configure

Nach Abschluss der Konfiguration wird eine evcc.yaml Datei im aktuellen Verzeichnis erstellt.

hinweis

Mit --advanced kannst du den Assistenten auch in einem erweiterten Modus starten. Dann bekommst du zusätzliche Einstellungsmöglichkeiten. Für deine erste Konfiguration ist das aber nicht notwendig.

evcc configure --advanced

Teste, ob die Konfiguration funktioniert

evcc -c evcc.yaml

Öffne einen Browser und gib die folgende URL ein: http://localhost:7070. Die evcc Oberfläche sollte nun mit den eigenen Geräten zu sehen sein.

Wenn alles funktioniert kannst du deine evcc.yaml an die Stelle verschieben, die für deine Installation notwendig ist.

Fehlersuche​

Sollten Fehler auftreten, kannst du dir mit folgenden Befehlen weitere Informationen anzeigen lassen.

  • Syntaxprüfung

    evcc -c evcc.yaml checkconfig

  • Zähler (Netz, PV, Batterie)

    evcc -c evcc.yaml -l debug meter

  • Fahrzeuge

    evcc -c evcc.yaml -l debug vehicle

  • Wallboxen

    evcc -c evcc.yaml -l debug charger

Überprüfe die Ausgaben der jeweiligen Befehle auf Plausibilität.

Du kannst evcc configure auch erneut ausführen und deine Angaben korrigieren. Beachte, dass der Assistent immer eine komplett neue Konfiguration erstellt. Ein gezieltes Verändern einer bestehenden Konfiguration ist nicht möglich. Nutze dafür die manuelle Konfiguration.

Manuell​

Sollte der Assistent für dich nicht verfügbar sein, kannst du die evcc.yaml Datei manuell erstellen. Hier findest du eine minimale Vorlage, die du als Ausgangspunkt nutzen kannst.

Erstellen​

Kopiere den Inhalt in eine neue evcc.yaml Datei.

evcc.yaml
## minimal configuration example

site:
  title: Home # display name for UI
  meters:
    grid: my_grid
    pv:
      - my_pv
    battery:
      - my_battery

# define your loadpoints according your needs
# see https://docs.evcc.io/en/docs/reference/configuration/loadpoints
loadpoints:
  - title: Garage # display name for UI
    charger: my_charger # charger
    vehicle: my_car # default vehicle

# meter definitions
# name can be freely chosen and is used as reference when assigning meters to site and loadpoints
# for documentation see https://docs.evcc.io/docs/devices/meters
meters:
  # replace with your real grid meter
  - name: my_grid
    type: template
    template: demo-meter
    usage: grid
    power: -1000 # 1 kW feed-in
  # replace with your real pv system
  - name: my_pv
    type: template
    template: demo-meter
    usage: pv
    power: 4000 # 4 kW production
  # replace with your real battery
  - name: my_battery
    type: template
    template: demo-battery
    usage: battery
    power: -1000 # 1 kW battery charging
    soc: 50 # 50 % state of charge

# replace with your real charger
# see https://docs.evcc.io/docs/devices/chargers
chargers:
  - name: my_charger
    type: template
    template: demo-charger
    status: C # charging
    power: 2000 # 2 kW charging power
    enabled: true # optional

# replace with your real vehicle (optional)
# see https://docs.evcc.io/docs/devices/vehicles
vehicles:
  - name: my_car
    type: template
    template: offline
    title: blue e-Golf
    capacity: 50 # in kWh

# enter your real grid tariff and feed-in price
# see https://docs.evcc.io/docs/devices/tariffs
tariffs:
  currency: EUR
  grid:
    type: fixed
    price: 0.29 # EUR/kWh
  feedin:
    type: fixed
    price: 0.10 # EUR/kWh

Mit dieser Datei kannst du evcc starten. Nutze dafür die jeweilige Anleitung für dein System.

Testen​

Starte evcc neu und öffne deinen Browser unter http://<evcc-ip>:7070. Überprüfe, ob die Werte plausibel sind. Solltest du eine Fehlermeldung erhalten, überprüfe deine Angaben.

Oft sind es auch Einrückungs- oder Tippfehler. Die Datei ist im YAML Format verfasst. Mit dem Online-Tool YAML Lint kannst du prüfen ob deine Datei das richtige Format einhält.

Anpassen​

Die Datei beinhaltet lediglich Demo-Geräte (demo-charger, demo-meter, demo-battery, offline). Diese haben feste Werte. Gehe die Datei nun Stück für Stück durch und passe die Werte an dein Setup an:

  • Ersetze die Demo-Geräte durch deine eigenen Zähler, Wallboxen und Fahrzeuge.
  • Hast du keine Batterie, kannst du den entsprechenden Abschnitt komplett entfernen.
  • Hast du mehrere PV-Anlagen, kannst du die entsprechenden Abschnitte duplizieren.
  • Hast du mehrere Wallboxen, kopiere den Loadpoint- und Charger-Abschnitt und passe die Namen an.

Beachte, dass die einzelnen Einträge sich gegenseitig referenzieren. Im site Eintrag (meters), werden die Zähler (grid, pv, battery) ihren Rollen zugeordnet. Hierfür wird immer das name Feld benutzt. Namen müssen daher eindeutig sein.

Führe diese Änderungen möglichst Schritt für Schritt durch. Starte nach jeder Änderung evcc neu und überprüfe die Ausgaben im Browser. Dann bemerkst du schnell, wenn du einen Fehler gemacht hast.

Weitere Informationen​

Die evcc.dist.yaml im Hauptprojekt beinhaltet eine vollständige Liste aller möglichen Konfigurations-Optionen. Ausführlichere Erklärungen zu den Optionen findest du unter Referenz → evcc.yaml.

Willst du eine dynamische Demo sehen kannst du dir auch den Inhalt der Datei demo.yaml ansehen. Diese Datei beinhaltet JavaScript-basierte Demo-Geräte, die eine eingeschränkte Funktionalität simulieren. Sie wird auch für demo.evcc.io genutzt.