# Home Assistant

> Zeigt, wie du evcc mit Home Assistant verbindest, am besten über die Integration ha-evcc oder manuell per REST-API und MQTT, für Dashboards und Automationen.

[Home Assistant](https://www.home-assistant.io) 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.

> **Hinweis**
>
> evcc kann auch als Home Assistant App installiert werden. Die Anleitung dafür findest du [hier](/de/installation/home-assistant).

## 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](https://github.com/marq24/ha-evcc) Integration von [marq24](https://github.com/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:**

1. [HACS](https://hacs.xyz/) in Home Assistant öffnen und nach „evcc” suchen.
2. Den Eintrag **evcc☀️🚘- Solar Charging** von marq24 installieren.
3. Home Assistant neu starten.
4. 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](https://github.com/marq24/ha-evcc).

Für Dashboards bietet die [hass-evcc-card](https://github.com/mkshb/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](/integrations/rest-api) an. [Diese Anleitung](https://github.com/marq24/ha-evcc/blob/main/HA_AS_EVCC_SOURCE.md) von [marq24](https://github.com/marq24) beschreibt die Einbindung in Home Assistant im Detail.

#### MQTT

Du benötigst einen MQTT-Broker (z. B. [Mosquitto](https://mosquitto.org/), 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](http://mqtt-explorer.com) 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](https://alkly.de/mqtt-mit-home-assistant-fuer-anfaenger).

Die verfügbaren Topics sind in der [MQTT API](/de/integrations/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](/de/meters#home-assistant)** (Netz, PV, Batterie, …) mit Leistung, Energie, Strömen, Spannungen, SoC
* **[Wallboxen](/de/chargers#home-assistant-charger)** mit Status, Ein-/Ausschalten und maximalem Ladestrom
* **[Schaltbare Steckdosen](/de/smartswitches#home-assistant-switch)** mit einfacher Ein-/Aus-Steuerung (für Smartplugs, Relais)
* **[Fahrzeuge](/de/vehicles#home-assistant)** mit SoC, Reichweite, Status, Kilometerstand; optional Skripte zum Starten/Stoppen
* **[Benachrichtigungen](/de/notifications)** 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.

1. Unter **Konfiguration** ein Gerät hinzufügen, z. B. **Zusätzlichen Zähler hinzufügen**.
2. Als Hersteller „Home Assistant“ auswählen.
3. 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`).
4. 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.
5. 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.
6. **Überprüfen & speichern** prüft, ob die Entitäten gelesen werden können.

> **Hinweis**
>
> Wenn du evcc innerhalb von Home Assistant als [App](/de/installation/home-assistant) betreibst, wähle in Schritt 3 die Instanz `http://supervisor/core` aus. Sie ist bereits autorisiert, Schritt 4 entfällt.

[]()

### 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.

```yaml
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`.

## Weitere Ressourcen (Videos)

* [smart home & more: evcc Basisinstallation und Konfiguration](https://youtu.be/aPq8k2MronY)
* [smart home & more: Schritt für Schritt - MQTT-Sensor mit Hilfe des MQTT-Explorer einrichten](https://youtu.be/0QQ3y8fgRVA)
* [smart home & more: Effizientes Energiedashboard für Home Assistant](https://youtu.be/V3p5-16U_oU)