Home Assistant verbinden

Funktioniert mit allen Plänen, einschließlich dem kostenlosen Community-Plan.

Home Assistant ist eine Open-Source-Smart-Home-Plattform für technisch Interessierte, Smart-Home-Nutzer und Entwickler. Die energiedaten.at HACS-Integration importiert Smart-Meter-Daten direkt in die Home Assistant Long-Term Statistics. Ein eigener Broker oder zusätzliche Middleware ist nicht nötig.

Voraussetzungen

  • energiedaten.at-Konto (Community-Plan oder höher)
  • Mindestens ein verbundener Zählpunkt mit Daten
  • Home Assistant ab Version 2025.12.0
  • HACS installiert
  • API-Schlüssel mit den Berechtigungen smart-meters:read und data:read. Erstellen Sie ihn unter Daten → API-Schlüssel. Wählen Sie die längstmögliche Lebensdauer Ihres Plans (Community: 1 Jahr, höhere Pläne: bis zu 3 Jahre), um seltener rotieren zu müssen. Alternativ klicken Sie unter Daten → Integrationen auf der Kachel Home Assistant auf Einrichten: Das erstellt den Schlüssel und verlinkt die Schritte für HACS und die Integration in Ihrem Home Assistant.

Installation

Die Integration ist jetzt offiziell in HACS gelistet und lässt sich direkt installieren.

  1. HACS öffnen und nach "energiedaten.at" suchen
  2. Den Eintrag öffnen und auf Herunterladen klicken
  3. Home Assistant neu starten
  4. Einstellungen → Integrationen → Integration hinzufügen → nach "energiedaten.at" suchen
  5. API-Schlüssel eingeben. Der Schlüssel wird in energiedaten.at nur einmal nach der Erstellung angezeigt, fügen Sie ihn daher direkt aus der Zwischenablage ein. Die Integration ermittelt Ihr Team aus dem Schlüssel; ein separater Team-Slug ist nicht mehr nötig.
  6. Zählpunkte auswählen (alle verbundenen Zählpunkte sind vorausgewählt); pro Zählpunkt und Energierichtung werden Sensoren erstellt

Schlüssel läuft ab: Wenn die Integration plötzlich keine neuen Daten mehr abruft und im Log 401 unauthenticated erscheint, ist Ihr Schlüssel abgelaufen oder wurde widerrufen. Erstellen Sie einen neuen Schlüssel und tragen Sie ihn unter Einstellungen → Integrationen → energiedaten.at → Konfigurieren ein.

Energy Dashboard einrichten

  1. Einstellungen → Dashboards → Energie öffnen
  2. Den Bezugs-Sensor Grid unter Netzverbrauch hinzufügen
  3. Den Einspeise-Sensor Grid unter Ins Netz zurückgespeist hinzufügen

Jeder Zählpunkt hat außerdem einen Measured-Sensor. Er zeigt die Gesamtmenge des Zählpunkts, lassen Sie ihn daher weg, wenn Sie Grid hinzufügen, sonst wird dieselbe Energie doppelt gezählt.

Die Daten erscheinen mit den korrekten historischen Zeitstempeln, nicht mit dem Import-Zeitpunkt. Das Energy Dashboard zeigt damit eine lückenlose Verbrauchshistorie ab dem ersten verfügbaren Messwert.

Sensoren für die Energiegemeinschaft

Gehört Ihr Zählpunkt zu einer Energiegemeinschaft, können Sie den Anteil der Gemeinschaft als eigene Sensoren importieren. Die Option ist standardmäßig aus, weil Zählpunkte außerhalb einer Energiegemeinschaft 0 liefern.

  1. Einstellungen → Geräte & Dienste → energiedaten.at → Konfigurieren öffnen
  2. Energy community sensors einschalten

Jeder Zählpunkt bekommt dann einen Community share-Sensor. Bei einem Bezugszählpunkt ist das die Energie, die Sie aus der Gemeinschaft bezogen haben, bei einem Einspeisezählpunkt die Energie, die Sie in sie eingespeist haben. Grid plus Community share ergibt Measured.

Um Energie aus der Gemeinschaft getrennt zu bewerten, fügen Sie Community share im Energy Dashboard als zweite Quelle neben Grid unter derselben Überschrift hinzu (Netzverbrauch oder Ins Netz zurückgespeist) und hinterlegen den Preis der Gemeinschaft.

Beim Einschalten der Option wird Ihre Historie einmal neu importiert. Beim Ausschalten werden die Sensoren entfernt, ihre Statistiken bleiben in Home Assistant erhalten.

Verbindung prüfen

Öffnen Sie Entwicklerwerkzeuge → Zustände und suchen Sie nach Sensoren mit dem Präfix sensor. gefolgt vom Zählpunkt-Label. Jeder Sensor zeigt den letzten Viertelstunden-Messwert in kWh als Status. Direkt nach dem Update auf Integrationsversion 0.7.0 kann ein Sensor bis zur nächsten täglichen Lieferung unknown anzeigen. Die Statistiken und das Energy Dashboard sind davon nicht betroffen.

EDA-Daten sind historisch (T-1), nicht in Echtzeit. Nach der Ersteinrichtung können erste Daten bis zu 24 Stunden auf sich warten lassen, abhängig vom EDA-Lieferplan des Netzbetreibers.

Hinweise

  • Die Integration fragt alle 6 Stunden inkrementell neue Daten ab
  • Ein Aktualisieren-Button löst eine sofortige Datenabfrage aus; die Sensoren behalten ihren letzten Wert, bis neuere Daten ankommen
  • Der Service energiedaten.reimport (Entwicklerwerkzeuge → Dienste) lädt alle historischen Daten auf Abruf neu
  • Wenn der Netzbetreiber korrigierte Messwerte nachsendet, werden die betroffenen Tage automatisch neu abgerufen
  • Zählpunkte in einer Energiegemeinschaft können einen zusätzlichen Community share-Sensor bekommen, siehe Abschnitt "Sensoren für die Energiegemeinschaft"
  • Quellcode und Issues: github.com/energiedaten-at/ha-energiedaten