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.

Beta: Die Integration befindet sich in der Beta-Phase (Version 0.5.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-Schlüssel mit den Berechtigungen smart-meters:read und data:read. Erstellen Sie ihn unter Integrationen → 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.

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-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.
7. Zähler auswählen (alle verbundenen Zähler sind vorausgewählt); pro Zähler 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. Verbrauchssensoren unter Netzverbrauch hinzufügen
3. Einspeise-Sensoren unter Ins Netz zurückgespeist hinzufügen

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.

Verbindung prüfen

Öffnen Sie Entwicklerwerkzeuge → Zustände und suchen Sie nach Sensoren mit dem Präfix sensor. gefolgt vom Zähler-Label. Jeder Sensor zeigt den letzten Viertelstunden-Messwert in kWh als Status.

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
• 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
• 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