Zum Hauptinhalt springen

Linux / Raspberry Pi

Diese Anleitung beschreibt die Installation für apt-basierte Linux Distributionen wie Debian, Ubuntu und Raspberry Pi OS.

hinweis

Für andere Linux Distributionen schau dir die Docker Anleitung oder den Manuelle Installation Abschnitt an.

Erstinstallation​

  • Öffne ein Terminal/Eingabeaufforderung

  • Installiere die benötigten Abhängigkeiten:

    sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl

  • Füge das evcc APT Repository hinzu:

Die aktuelle stabile Version

curl -1sLf 'https://dl.evcc.io/public/evcc/stable/setup.deb.sh' | sudo -E bash
hinweis

Hosted By: Cloudsmith

Wir bedanken uns bei Cloudsmith für das Hosting! Cloudsmith ist ein Service, welcher die Entwicklung von Software und Dienstleistungen für kostenlose und freie Plattformen ermöglicht.

  • Aktualisiere die Paketliste:

    sudo apt update

  • Installiere evcc:

    sudo apt install -y evcc

  • Starte den evcc-Server:

    sudo systemctl start evcc

  • Prüfe die Installation und öffne einen Browser und gib die folgende URL ein: http://localhost:7070. Die evcc Oberfläche sollte im Demo Modus zu sehen sein.

  • Stoppe den evcc-Server:

    sudo systemctl stop evcc
hinweis

Während der Installation wird ein Nutzer evcc angelegt, deshalb sollte der angemeldete Nutzer nicht den Namen evcc haben.

Konfiguration​

Für den Betrieb musst du eine funktionierende evcc.yaml Konfigurationsdatei erstellen. Neben allgemeinen Einstellungen beinhaltet die Konfiguration die Definition der einzelnen Komponenten (Zähler, Wallbox, Fahrzeug, ...).

Erstellen​

Wir empfehlen die Verwendung des Konfigurationsassistenten:

  • Starte den Konfigurationsassistenten und beantworte die Fragen:

    sudo evcc configure

  • Kopiere die erstellte Konfigurationsdatei nach /etc/evcc.yaml:

    sudo mv evcc.yaml /etc

  • Starte den evcc-Server:

    sudo systemctl restart evcc

  • Rufe die evcc Oberfläche auf http://localhost:7070

Anpassen​

Benötigt deine Konfiguration noch Anpassungen kannst du entweder den Konfigurationsassistenten erneut ausführen (siehe oben) oder die Konfigurationsdatei manuell anpassen.

  • Konfigurationsdatei bearbeiten:

    sudo nano /etc/evcc.yaml

  • Starte den evcc-Server neu:

    sudo systemctl restart evcc

Unter Konfiguration findest du weitere Informationen und Beispiele zur Konfiguration von evcc.

Aktualisierung​

Um auf eine neue Version von evcc zu aktualisieren, führe folgende Schritte durch:

  • Prüfe Releases für Breaking changes (BC) die deine Installation betreffen

  • Öffne ein Terminal/Eingabeaufforderung

  • Aktualisiere den Paketbestand:

    sudo apt update

  • Installiere evcc:

    sudo apt --only-upgrade install -y evcc
info

Wenn das unstable Repository (Nightly Versionen) hinzugefügt wurde, wird beim Update immer auf die letzte verfügbare Nightly Version aktualisiert. Sollte das nicht mehr erwünscht sein, muss das unstable Repository mittels sudo rm /etc/apt/sources.list.d/evcc-unstable.list entfernt werden.

Downgrade​

Mit folgendem Befehl kann man auf eine ältere Version von evcc wechseln:

sudo apt install evcc=x.xxx.x # Versionsnummer

Systemdienst​

evcc läuft als Systemdienst im Hintergrund. Mit folgenden Befehlen kann dieser Dienst gesteuert werden.

sudo systemctl status evcc # zeigt den Status
sudo systemctl start evcc # startet den Dienst
sudo systemctl stop evcc # stoppt den Dienst
sudo systemctl restart evcc # startet den Dienst neu
sudo systemctl enable evcc # aktiviert den Dienst
sudo systemctl disable evcc # deaktiviert den Dienst

Testen​

Prüfe die Installation

  • Zeige den laufenden evcc Service an:

    sudo systemctl status evcc

  • Prüfe die letzten Log-Ausgaben des evcc Services:

    sudo journalctl -u evcc --since "yesterday"

  • Prüfe die evcc Meter-Konfiguration:

    sudo evcc -l debug meter

  • Prüfe die evcc Charger-Konfiguration:

    sudo evcc -l debug charger

  • Prüfe die evcc Vehicle-Konfiguration:

    sudo evcc -l debug vehicle

Öffne einen Browser und gib die folgende URL ein: http://127.0.0.1:7070.

hinweis

Ersetze 127.0.0.1 mit der IP Adresse oder dem Hostnamen des Computers, falls der Browser nicht auf dem gleichen Computer geöffnet wurde.

Backup und Restore​

Um nach einer Neuinstallation wieder den "Ursprungszustand" herzustellen zu können, reicht es die Konfigurationsdatei evcc.yaml und die Datenbankdatei evcc.db zu sichern. Der Speicherort wird im Logfile beim Programmstart angegeben. Üblicherweise liegt die Konfiguration unter /etc/evcc.yaml und die Datenbank unter /var/lib/evcc/evcc.db.

Beide Dateien können mit dem Linux-Befehl cp kopiert werden.

Beispiel (kopieren vom üblichen Speicherort ins Homelaufwerk):

yaml kopieren: sudo cp /etc/evcc.yaml /home/pi/evcc.yaml.bak

db kopieren: sudo cp /var/lib/evcc/evcc.db /home/pi/evcc.db.bak

Manuelle Installation​

Neben dem Debian/Ubuntu APT Paket, stellen wir auch weitere Binaries für Linux bereit.

Installation​

  • Lade die entsprechende Datei auf dein System herunter:

  • Entpacke die heruntergeladene Datei (z.B. per Doppelklick auf die Datei).

  • Im entpackten Ordner befindet sich ein evcc Programm.

  • Öffne ein Terminal und gehe in den Ordner neuen Ordner.

  • Mit folgendem Befehl kannst du prüfen, ob evcc funktioniert:

    ./evcc -v

  • Du solltest die aktuelle Version von evcc sehen (bspw. evcc version 0.xxx.y).

Konfiguration​

Erstelle dir nach der Anleitung unter Konfiguration eine funktionierende evcc.yaml Konfigurationsdatei. Diese kannst du mit folgendem Befehl starten:

./evcc -c evcc.yaml

Aktualisierung/Downgrade​

Führe die obigen Schritte aus und ersetze die evcc Programmdatei mit der neuen bzw. vorherigen Version. Die Konfiguration muss nicht erneut durchgeführt werden.

Service einrichten​

Im produktiven Einsatz möchtest du evcc als Systemdienst einrichten. Dieser sorgt dafür, dass evcc beim Starten des Computers ausgeführt wird. Außerdem wird evcc im Fehlerfall automatisch neu gestartet.

hinweis

Diese Dokumentation geht davon aus, dass Linux systemd unterstützt.

  • Führe folgenden Befehl aus, um einen Editor mit einer neuen Datei für den Dienst zu erstellen und zu öffnen:

    sudo nano /etc/systemd/system/evcc.service

  • Kopiere den folgenden Inhalt in die Datei

    [Unit]
    Description=evcc
    Requires=network-online.target
    After=syslog.target network.target network-online.target
    Wants=network-online.target
    StartLimitIntervalSec=10
    StartLimitBurst=10

    [Service]
    ExecStart=/usr/local/bin/evcc
    Restart=always
    RestartSec=5

    [Install]
    WantedBy=multi-user.target

    Passe den Pfad der evcc Datei in ExecStart an, falls die Datei in einem anderen Verzeichnis abgelegt ist. Dies geht auch davon aus, dass die Konfigurationsdatei evcc.yaml in /etc/evcc.yaml zu finden ist. Falls dies nicht der Fall ist, muss in ExecStart am Ende der Text -c /yourpath/evcc.yaml hinzugefügt werden. Der Text yourpath muss mit dem entsprechenden Verzeichnis ersetzt werden.

  • Teste den Dienst:

    sudo systemctl daemon-reload
    sudo systemctl start evcc
    sudo systemctl status evcc

    Die Ausgabe sollte bei Erfolg folgenden Text beinhalten: Active: active (running).

  • Konfiguriere den Dienst so, dass er beim Rechnerstart automatisch startet:

    sudo systemctl enable evcc.service

  • Fertig :-)

Weitere Informationen findest du oben im Abschnitt Systemdienst.