Voraussetzungen
- Eine laufende Home-Assistant-Installation (Version 2025.x oder neuer empfohlen) mit Internetzugang.
- Den Home Assistant Community Store (HACS) auf dieser Instanz. Zur Installation siehe die offizielle HACS-Anleitung.
Einrichtung
1. Konto im Datenportal anlegen
Lege im Datenportal ein Konto an. Du brauchst einen Benutzernamen und ein Passwort. Die Angabe einer E-Mail-Adresse ist optional.
Nach der Registrierung erscheint ein Einrichtungsassistent. Er bleibt auf dem Dashboard verfügbar.
2. Home Assistant als Integration auswählen
Wähle im Einrichtungsassistenten Home Assistant aus. Andere Systeme sind aufgeführt, aber noch nicht verfügbar.
Der Assistent zeigt drei Schritte, jeweils mit einer Schaltfläche, die die passende Seite in deinem Home Assistant öffnet. Die Links laufen über my.home-assistant.io und leiten auf die in deinem Browser hinterlegte Instanz weiter; deren Adresse erfahren wir nicht.
3. HACS installieren
Überspringe diesen Schritt, wenn HACS bereits eingerichtet ist. Andernfalls folge der HACS-Installationsanleitung.
4. Repository hinzufügen und Integration herunterladen
Die Datenspende-Integration ist nicht Teil von Home Assistant und wird über HACS als benutzerdefiniertes Repository installiert.
Die Schaltfläche im Portal öffnet die Datenspende-Seite in deinem HACS. Klicke dort unten rechts auf Herunterladen.
Falls die Schaltfläche nicht funktioniert, füge das Repository in HACS manuell unter ⋮ → Benutzerdefinierte Repositories hinzu, mit:
- Repository:
https://github.com/COMSYS/Datenspende - Typ / Kategorie: Integration
Starte Home Assistant nach dem Download neu. Erst danach steht die Integration zur Verfügung.
5. Integration in Home Assistant hinzufügen
Füge die Integration unter Einstellungen → Geräte & Dienste → Integration hinzufügen → Datenspende hinzu. Die Schaltfläche im Portal öffnet diesen Dialog direkt.
6. In der Integration anmelden
Die Integration fragt nach denselben Zugangsdaten, die du im Datenportal verwendest. Mit der Anmeldung wird dein Haushalt angelegt und die von dir ausgewählten Zähler werden registriert.
Wähle anschließend aus, welche deiner Home-Assistant-Geräte ihre Messwerte spenden sollen.
Das Portal erkennt den neuen Haushalt innerhalb weniger Sekunden und schließt das Einrichtungsfenster.
Nach der Einrichtung
Beschrifte deine Zähler. Ordne jedem Zähler das Gerät zu, das er misst (Kühlschrank, Waschmaschine, Wärmepumpe, …). Beschriftete Zeitreihen sind für die Forschung deutlich wertvoller. Unbeschriftete Zähler werden auf dem Dashboard aufgelistet.
Fehlerbehebung
Die Schaltflächen im Portal öffnen eine fremde Website. Die Links nutzen my.home-assistant.io und leiten zu deiner eigenen Instanz weiter. Hinterlege die Adresse deiner Instanz einmalig über My Home Assistant oder öffne die Seiten manuell in Home Assistant.
„Datenspende“ taucht nicht in der Liste der Integrationen auf. Der Neustart nach dem HACS-Download fehlt oder war unvollständig. Starte Home Assistant neu und lade die Seite anschließend neu.
Das Portal wartet weiterhin auf deinen Haushalt. Die Anmeldung in der Integration wurde nicht abgeschlossen. Prüfe die Zugangsdaten und melde dich erneut an.
Die Integration zeigt „Noch keine Daten“ oder „Keine Übertragung“. Es sind keine Messwerte angekommen, oder die Übertragung ist abgebrochen. Auf der Integrationsseite im Portal steht, wann zuletzt Daten eingegangen sind. Prüfe außerdem, ob die ausgewählten Geräte in Home Assistant weiterhin Werte liefern.