Home Assistant
Home Assistant sammelt und visualisiert Daten aus deinem Smart Home und bietet umfangreiche Automatisierungsmöglichkeiten. evcc ist auf intelligentes Laden und Heizen spezialisiert. Beide Systeme ergänzen sich und lassen sich auf verschiedene Arten miteinander verbinden.
Visualisieren & Automatisieren
Abschnitt betitelt „Visualisieren & Automatisieren“evcc bringt viele Funktionen für intelligentes Laden und Heizen mit, kann aber nicht alle Anwendungsfälle abdecken. Durch die Integration mit Home Assistant bekommst du mehr Flexibilität. Hier ein paar Beispiele:
- Messwerte in Dashboards visualisieren
- Ladepläne basierend auf Kalendereinträgen erstellen
- Lademodus abhängig von Anwesenheit wechseln
- …
evcc-Integration für Home Assistant (empfohlen)
Abschnitt betitelt „evcc-Integration für Home Assistant (empfohlen)“Die Integration ha-evcc von marq24 bringt evcc-Daten und -Funktionen direkt in Home Assistant. Das funktioniert unabhängig davon, ob du evcc als Home-Assistant-App betreibst oder nicht. Voraussetzung ist, dass Home Assistant und evcc im gleichen Netzwerk erreichbar sind.
Die Integration stellt alle relevanten evcc-Entitäten bereit: Messwerte, Einstellungen, Ladepunkte und Fahrzeuge. Nach der Installation bekommst du eine umfangreiche Liste an Entitäten, die du in Dashboards und Automatisierungen verwenden kannst.
Installation über HACS:
- Öffne HACS in Home Assistant und suche nach „evcc“.
- Installiere den Eintrag evcc☀️🚘- Solar Charging von marq24.
- Starte Home Assistant neu.
- Gehe zu Einstellungen → Geräte & Dienste → Integration hinzufügen, suche nach „evcc“ und gib die URL deiner evcc-Instanz ein.
Weitere Installationsvarianten und Details findest du im GitHub-Repository.
Für Dashboards bietet die hass-evcc-card eine Lovelace-Karte, die die evcc-Übersicht in Home Assistant anzeigt.
Manuelle Integration
Abschnitt betitelt „Manuelle Integration“Alternativ kannst du evcc-Daten manuell über die REST-API oder MQTT in Home Assistant einbinden.
REST-API
Abschnitt betitelt „REST-API“evcc bietet eine REST-API an. Diese Anleitung von marq24 beschreibt die Einbindung in Home Assistant im Detail.
Du benötigst einen MQTT-Broker (z. B. Mosquitto, auch als Home-Assistant-App verfügbar).
Konfiguriere in evcc unter Konfiguration → MQTT die Verbindung zum Broker. In Home Assistant müssen derselbe Broker und dasselbe Topic konfiguriert sein, damit beide Systeme Daten austauschen können.
Mit einem Tool wie MQTT Explorer kannst du prüfen, ob die Nachrichten auf den Topics korrekt ankommen. Eine Anleitung zur Einrichtung von MQTT-Sensoren in Home Assistant findest du im Blog von Alkly.
Die verfügbaren Topics sind in der MQTT-API dokumentiert.
Home-Assistant-Entitäten nutzen
Abschnitt betitelt „Home-Assistant-Entitäten nutzen“evcc kann sich direkt mit Home Assistant verbinden und dessen Entitäten (Sensoren, Schalter, Zahlenwerte) als Datenquelle verwenden. So lassen sich z. B. Geräte in evcc einbinden, die nicht direkt unterstützt werden, wie Zigbee-Smartplugs, Sensoren aus anderen Integrationen oder selbstgebaute Lösungen. Solange die Daten als Home-Assistant-Entität vorliegen, kann evcc damit arbeiten.
Unterstützte Gerätetypen
Abschnitt betitelt „Unterstützte Gerätetypen“- Zähler (Netz, PV, Hausbatterie, …) mit Leistung, Energie, Strömen, Spannungen, Ladestand
- Wallboxen mit Status, Ein-/Ausschalten und maximalem Ladestrom
- Schaltbare Steckdosen mit einfacher Ein-/Aus-Steuerung (für Smartplugs, Relais)
- Fahrzeuge mit Ladestand, Reichweite, Status, Kilometerstand; optional Skripte zum Starten/Stoppen
- Benachrichtigungen: Unter Konfiguration → Benachrichtigungen kannst du evcc-Meldungen über Home Assistant versenden
Einrichtung
Abschnitt betitelt „Einrichtung“Home-Assistant-Geräte werden wie jedes andere Gerät in der Konfigurationsoberfläche angelegt.
- Füge unter Konfiguration ein Gerät hinzu, z. B. über Zusätzlichen Zähler hinzufügen.
- Wähle Home Assistant als Hersteller aus.
- Wähle deine Instanz aus. Instanzen im lokalen Netzwerk werden automatisch erkannt.
Bleibt die Liste leer, z. B. weil Home Assistant in einem anderen Subnetz läuft, trag die Adresse manuell ein (
http://homeassistant.local:8123). - Autorisiere den Zugriff. Home Assistant öffnet sich in einem neuen Tab, in dem du dich anmeldest und die Anfrage bestätigst. Der Token wird von deiner evcc-Instanz gespeichert und automatisch erneuert.
- Weise jedem Feld eine Entität zu, z. B. Leistung. Du bekommst eine Autovervollständigung mit den Entitäten deiner Instanz, und es werden nur Entitäten angeboten, die zum Feld passen.
- Mit Überprüfen & speichern testet evcc, ob sich die Entitäten lesen lassen.
Werte der Entitäten
Abschnitt betitelt „Werte der Entitäten“Jedes Feld erwartet eine bestimmte Art von Wert.
Eine Entität mit unknown oder unavailable gilt als vorübergehend nicht verfügbar und wird beim nächsten Update erneut gelesen.
Felder für Leistung, Energie, Strom und Ladestand brauchen eine reine Zahl als Zustand, z. B. 1234.
Ein Zustand wie 1234 W kann nicht gelesen werden, denn die Einheit gehört in das Attribut unit_of_measurement der Entität.
W/kW und Wh/kWh/MWh werden automatisch umgerechnet.
Um das Vorzeichen zu invertieren, stelle dem Entitätsnamen ein - voran (-sensor.inverter_power).
Ein/Aus
Abschnitt betitelt „Ein/Aus“Die Felder für den Freigabezustand einer Wallbox, einer schaltbaren Steckdose und ähnliche Felder akzeptieren on, true, 1, active und yes sowie die Gegenstücke off, false, 0, inactive und no.
Ladestatus
Abschnitt betitelt „Ladestatus“Wallboxen und Fahrzeuge brauchen eine Status-Entität, die meldet, ob das Fahrzeug getrennt oder verbunden ist oder lädt. Diese Zustände werden ohne weitere Konfiguration erkannt:
| Status | Bedeutung | Zustände |
|---|---|---|
| A | getrennt | a, disconnected, not_plugged |
| B | verbunden | b, connected, plugged, starting, stopped, paused, complete, charging_completed |
| C | lädt | c, charging |
Viele Integrationen verwenden eigene Bezeichnungen. Meldet die Entität einen Zustand, der nicht in der Tabelle steht, zeigt das Log den Rohwert zusammen mit dem Namen der Entität an. Trag diesen Wert in das passende Feld Zustände für Status A/B/C in den erweiterten Optionen des Geräts ein. Mehrere Werte werden durch Kommas getrennt, Groß- und Kleinschreibung spielt keine Rolle.
statusB: charging_stopped, charging_errorstatusC: instant_chargingEin binary_sensor als Status-Entität braucht ebenfalls eine explizite Zuordnung, z. B. statusA: off und statusC: on.