Home Assistant
Diese Anleitung beschreibt die Installation von evcc als Home-Assistant-App. Im Gegensatz zur Linux-Installation oder Docker-Installation benötigst du hier keine Kommandozeilenkenntnisse.
Voraussetzungen
Abschnitt betitelt „Voraussetzungen“Du benötigst eine Home-Assistant-Installation mit aktiviertem App-Store. Abhängig von deiner Installationsart kann es sein, dass diese Funktion nicht verfügbar ist. Weitere Informationen findest du in der Dokumentation von Home Assistant.
Installation
Abschnitt betitelt „Installation“Die aktuelle stabile Version.
- Repository automatisch hinzufügen: Klicke auf die folgende Schaltfläche, dann auf Link öffnen und anschließend auf Hinzufügen.
- Repository manuell hinzufügen:
- Klicke auf Einstellungen → Apps → App installieren.
- Klicke auf die drei Punkte → Repositories.
- Füge die Repository-URL ein und klicke auf Hinzufügen.
https://github.com/evcc-io/hassio-addon
- Lade die Webseite neu.
- Suche die App evcc und klicke sie an.
- Klicke auf die Schaltfläche Installieren.
- Aktiviere Watchdog, damit sich evcc selbst neu starten kann
Die aktuelle Entwicklerversion. Sie wird täglich aktualisiert und kann instabil sein.
Sie kann zwar parallel zur Release-Version installiert werden, es kann aber immer nur eine Version gleichzeitig laufen.
Wenn du die Nightly-Version nutzt, ändern sich die in dieser Anleitung genannten Pfade und Docker-Containernamen, d. h. statt evcc musst du evcc-nightly verwenden.
- Repository automatisch hinzufügen: Klicke auf die folgende Schaltfläche, dann auf Link öffnen und anschließend auf Hinzufügen.
- Repository manuell hinzufügen:
- Klicke auf Einstellungen → Apps → App installieren.
- Klicke auf die drei Punkte → Repositories.
- Füge die Repository-URL ein und klicke auf Hinzufügen.
https://github.com/evcc-io/hassio-addon
- Lade die Webseite neu.
- Suche die App evcc (nightly) und klicke sie an.
- Klicke auf die Schaltfläche Installieren.
- Aktiviere Watchdog, damit sich evcc selbst neu starten kann
Konfiguration
Abschnitt betitelt „Konfiguration“evcc kann auf zwei Arten konfiguriert werden:
Weboberfläche (empfohlen)
Abschnitt betitelt „Weboberfläche (empfohlen)“Gehe in der App evcc zum Tab Information und aktiviere In Seitenleiste anzeigen (Weboberfläche unter http://your-ha-instance-ip-address:7070).
Gehe zum Tab Konfiguration und wähle dein Arbeitsverzeichnis aus, z. B.:
- sqlite_file: /data/evcc.dbLass den Abschnitt Netzwerk unverändert.
Starte die App. Öffne dann die Weboberfläche über die Seitenleiste:
- Du wirst aufgefordert, ein Administrator-Passwort festzulegen.
- Anschließend kannst du deine Geräte direkt in der Weboberfläche einrichten.
- Die Einstellungen werden automatisch in der Datenbank gespeichert.
Konfigurationsdatei (klassisch)
Abschnitt betitelt „Konfigurationsdatei (klassisch)“Alternativ kannst du eine Konfigurationsdatei evcc.yaml verwenden.
Gehe zum Tab Konfiguration und füge die Konfigurationsdatei zu deinem Arbeitsverzeichnis hinzu:
- config_file: /config/evcc.yaml- sqlite_file: /data/evcc.dbLege eine evcc-Konfigurationsdatei evcc.yaml im Stammverzeichnis der App-Konfiguration (/addon_configs/49686a9f_evcc) an.
Falls dieser Ordner nicht existiert, lege ihn von Hand an.
Um die Konfigurationsdatei anzulegen oder zu bearbeiten, hast du mehrere Möglichkeiten:
- Visual Studio Code: Öffne oben links das Hamburger-Menü, wähle File → Open Folder… und dann
/addon_configs/49686a9f_evcc - File Editor: Stelle sicher, dass die Option Enforce Basepath in der App-Konfiguration deaktiviert ist, starte die App neu und navigiere zu
/addon_configs/49686a9f_evcc - Advanced SSH & Web Terminal: Navigiere zu
/addon_configs/49686a9f_evccund verwende z. B. nano
Details zum Anlegen der Konfigurationsdatei findest du unter Einrichtung.
Wenn du das System im Demo-Modus sehen möchtest, starte evcc einfach mit dem Parameter --demo.
Weitere Informationen findest du in der CLI-Referenz.
Aktualisierung
Abschnitt betitelt „Aktualisierung“Die Aktualisierung auf die neueste Version von evcc ist in den Aktualisierungsprozess von Home Assistant integriert.
Tipps für Fortgeschrittene
Abschnitt betitelt „Tipps für Fortgeschrittene“Für die folgenden Funktionen benötigst du SSH-Zugriff auf Home Assistant. Diesen bekommst du z. B. mit der oben erwähnten SSH-App.
- Installiere Advanced SSH & Web Terminal
- Deaktiviere den secure mode in der App-Konfiguration
- Starte die App neu
- Öffne die Benutzeroberfläche der App
Wie komme ich an die evcc-Datenbank?
Abschnitt betitelt „Wie komme ich an die evcc-Datenbank?“Zeige die Dateien in /data an:
docker exec addon_49686a9f_evcc ls -la /dataKopiere die evcc.db nach /addon_configs/49686a9f_evcc:
docker cp addon_49686a9f_evcc:/data/evcc.db /addon_configs/49686a9f_evcc/Wie kann ich die evcc-CLI nutzen?
Abschnitt betitelt „Wie kann ich die evcc-CLI nutzen?“Öffne eine Shell im Docker-Container von evcc:
docker exec -it addon_49686a9f_evcc /bin/shFühre evcc-CLI-Befehle aus (hier als Beispiel checkconfig):
evcc -c /config/evcc.yaml checkconfigSchließe die Shell im Docker-Container von evcc, wenn du fertig bist:
exitWie kann ich meinen externen Adapter oder HAT in der evcc-App für Home Assistant verwenden (Home Assistant OS, Raspberry Pi)?
Abschnitt betitelt „Wie kann ich meinen externen Adapter oder HAT in der evcc-App für Home Assistant verwenden (Home Assistant OS, Raspberry Pi)?“Wenn sich dein Home-Assistant-Gerät in der Nähe deines Zählers (PV-Anlage, Hausbatterie, Netz usw.) befindet, kannst du die Daten auch direkt per Modbus abrufen, z. B. über USB.
Dafür musst du externe Geräte für Home Assistant und damit auch für die evcc-App freigeben.
Kommentiere dazu die Zeile uart = 1 in der Datei config.txt auf der Boot-Partition von Home Assistant OS ein.
uart = 1Nach einem Neustart sollte dein Gerät für die evcc-App verfügbar sein (wahrscheinlich als /dev/ttyS0 oder /dev/ttyUSB).
Nächster Schritt: Integration
Abschnitt betitelt „Nächster Schritt: Integration“Sobald dein System läuft, kannst du die Integration zwischen evcc und Home Assistant einrichten. Unter Integrationen → Home Assistant findest du mehr Informationen. Du kannst evcc-Daten in Home Assistant visualisieren oder Automatisierungen auf Basis von evcc erstellen.