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 — ohne eigenen Broker oder zusätzliche Middleware.

Beta: Die Integration befindet sich in der Beta-Phase (Version 0.2.x). Funktionen und Konfigurationsdetails können sich noch ändern.

Voraussetzungen

  • energiedaten.at-Konto (Community-Plan oder höher)
  • Mindestens ein verbundener Zähler mit Daten
  • Home Assistant ab Version 2025.12.0
  • HACS installiert
  • API-Token mit den Berechtigungen meters:read und data:read — erstellen unter Profil → API Tokens

Installation

  1. HACS öffnen → Drei-Punkte-Menü → Benutzerdefinierte Repositories
  2. URL eingeben: https://github.com/energiedaten-at/ha-energiedaten, Kategorie: Integration
  3. Nach „energiedaten.at" suchen und installieren
  4. Home Assistant neu starten
  5. Einstellungen → Integrationen → Integration hinzufügen → nach „energiedaten.at" suchen
  6. API-Token und Team-Slug eingeben (Team-Slug aus der URL: energiedaten.at/app/{team-slug}/)
  7. Zähler auswählen — pro Zähler und Energierichtung werden Sensoren automatisch erstellt

Energy Dashboard einrichten

  1. Einstellungen → Dashboards → Energie öffnen
  2. Verbrauchssensoren unter Netzverbrauch hinzufügen
  3. Einspeise-Sensoren unter Ins Netz zurückgespeist hinzufügen

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

Verbindung prüfen

Öffnen Sie Entwicklerwerkzeuge → Zustände und suchen Sie nach Sensoren mit dem Präfix sensor. gefolgt vom Zähler-Label.

Die Sensoren zeigen keinen laufenden Echtzeit-Zustand — die Daten werden historisch importiert und erscheinen ausschließlich im Energy Dashboard. 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
  • Bei Zählern in einer Energiegemeinschaft können mehrere Sensoren pro Zähler angelegt werden (verschiedene OBIS-Codes)
  • Quellcode und Issues: github.com/energiedaten-at/ha-energiedaten