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

evcc bringt viele Steuerungen 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
…

Home Assistant evcc Integration (empfohlen)

Die ha-evcc Integration 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 Automationen verwenden kannst.

Installation über HACS:

HACS in Home Assistant öffnen und nach „evcc” suchen.
Den Eintrag evcc☀️🚘- Solar Charging von marq24 installieren.
Home Assistant neu starten.
Unter Einstellungen → Geräte & Dienste → Integration hinzufügen nach „evcc” suchen und die URL deiner evcc-Instanz angeben.

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

Alternativ kannst du evcc-Daten manuell über die REST API oder MQTT in Home Assistant einbinden.

REST API

evcc bietet eine REST API an. Diese Anleitung von marq24 beschreibt die Einbindung in Home Assistant im Detail.

MQTT

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 muss der gleiche Broker und das gleiche Topic konfiguriert sein, damit beide Systeme die Daten austauschen können.

Mit einem Tool wie MQTT Explorer kannst du prüfen, ob die Daten 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

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

Zähler (Netz, PV, Batterie, …) mit Leistung, Energie, Strömen, Spannungen, SoC
Wallboxen mit Status, Ein-/Ausschalten und maximalem Ladestrom
Schaltbare Steckdosen mit einfacher Ein-/Aus-Steuerung (für Smartplugs, Relais)
Fahrzeuge mit SoC, Reichweite, Status, Kilometerstand; optional Skripte zum Starten/Stoppen
Benachrichtigungen unter Konfiguration → Benachrichtigungen kannst du evcc-Meldungen über Home Assistant versenden

Einrichtung

Home Assistant Geräte werden wie jedes andere Gerät in der Konfigurationsoberfläche angelegt.

Unter Konfiguration ein Gerät hinzufügen, z. B. Zusätzlichen Zähler hinzufügen.
Als Hersteller „Home Assistant“ auswählen.
Die eigene Instanz auswählen. Instanzen im lokalen Netzwerk werden automatisch erkannt. Bleibt die Liste leer, z. B. weil Home Assistant in einem anderen Subnetz läuft, kann die Adresse manuell eingetragen werden (http://homeassistant.local:8123).
Zugriff autorisieren. Home Assistant öffnet sich in einem neuen Tab, dort anmelden und die Anfrage bestätigen. Der Token wird von deiner evcc-Instanz gespeichert und automatisch erneuert.
Den Feldern jeweils eine Entität zuweisen, z. B. „Leistung“. Du bekommst Autovervollständigung mit den Entitäten deiner Instanz, angeboten werden nur Entitäten, die zum Feld passen.
Überprüfen & speichern prüft, ob die Entitäten gelesen werden können.

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.

Zahlen

Felder für Leistung, Energie, Strom und SoC brauchen eine reine Zahl als Zustand, z. B. 1234. Ein Zustand wie 1234 W kann nicht gelesen werden, 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

Der Freigabe-Zustand einer Wallbox, eine schaltbare Steckdose und ähnliche Felder akzeptieren on, true, 1, active und yes sowie die Gegenstücke off, false, 0, inactive und no.

Ladestatus

Wallboxen und Fahrzeuge brauchen eine Status-Entität, die meldet, ob das Fahrzeug getrennt, verbunden oder am Laden ist. 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 der Entität an. Dieser Wert gehört in das passende Feld Zustände für Status A/B/C in den erweiterten Optionen des Geräts. Mehrere Werte werden durch Kommas getrennt, Groß- und Kleinschreibung spielt keine Rolle.

statusB: charging_stopped, charging_error
statusC: instant_charging

Ein binary_sensor als Status-Entität braucht ebenfalls eine explizite Zuordnung, z. B. statusA: off und statusC: on.