Energie-Datenbasis

1. Mit Nachweisen beginnen, nicht mit einer Markenliste

Ein Gerät ist für eine Automation nur dann geeignet, wenn Home Assistant die richtige Entität mit der richtigen Bedeutung bereitstellt. Zwei Zähler derselben Marke können sich je nach Modell, Region, Firmware, Integration oder Konto unterscheiden. Deshalb prüft dieser Guide das Verhalten der Entitäten und verspricht keine Kompatibilität anhand eines Logos.

2. Leistung, Energie, Lastspitze und Preis trennen

Home Assistant speichert Entitätszustände als Text. „Numerisch“ bedeutet daher, dass sich der aktuelle Zustand als endliche Zahl auswerten lässt. unknown, unavailable, leerer Text oder ein Zustand mit Währungssymbol sind nicht numerisch. Die Einheit gehört in das Attribut unit_of_measurement, nicht in den Zustandswert.

3. Entitäten in den Entwicklerwerkzeugen erfassen

1. Entwicklerwerkzeuge → Zustände öffnen. Nach Integration oder Gerätename suchen. Nicht nur anhand des Anzeigenamens entscheiden.
2. Exakte Entitäts-ID kopieren. Zustand, unit_of_measurement, device_class und die laut Integrationsdokumentation gemessene physische Größe notieren.
3. Numerisches Format prüfen. In Entwicklerwerkzeuge → Vorlagen die Beispiel-ID unten ersetzen. Die letzte Zeile muss True ergeben.
4. Reales Verhalten beobachten. Ein vorhandenes Gerät über seine normale Bedienung nutzen und mindestens zwei Aktualisierungen verfolgen. Keine Schutzfunktion für einen Test umgehen.
5. Unklarheit dokumentieren. „Wahrscheinlich Netzbezug“ reicht nicht. Die Entität bleibt aus Automationen, bis Bedeutung und Richtung bestätigt sind.

{{ states('sensor.ihre_entitaet') }}
{{ state_attr('sensor.ihre_entitaet', 'unit_of_measurement') }}
{{ state_attr('sensor.ihre_entitaet', 'device_class') }}
{{ is_number(states('sensor.ihre_entitaet')) }}

Die Zustandsansicht zeigt den aktuellen Softwarezustand. Sie beweist nicht, dass Zähler, Stromwandler, Kabel oder Stromkreis physisch korrekt sind.

4. Vorzeichen der Netzleistung nachweisen

Die optionale Foundation-Normalisierung erwartet genau eine vorzeichenbehaftete Netto-Netzleistung: Positiv bedeutet Bezug aus dem Netz, negativ bedeutet Einspeisung. Hausverbrauch, PV-Erzeugung oder Wechselrichterausgang sind andere Größen.

Liefert die Integration getrennte Bezugs- und Einspeiseleistungen, erfüllt keine davon allein den Vertrag einer vorzeichenbehafteten Quelle. Eine Kombination ist nur nach Prüfung von Einheiten, Aktualisierungstakt und Bedeutung zulässig. Die gelieferte Datei nimmt diese Gleichzeitigkeit nicht stillschweigend an.

5. Aktualität und ehrliches Ausfallverhalten prüfen

Auch eine Zahl kann veraltet sein. Beobachten Sie Verlauf oder Entitätsdetails, während sich die normale Last ändert. Notieren Sie die Reaktionszeit und ob die Integration auch bei gleichem Wert regelmäßig berichtet. Vergleichen Sie dieses Verhalten mit dem Zeitbedarf des ausgewählten Produkts.

• Der Wert reagiert innerhalb des dokumentierten oder beobachteten Takts.
• Eine kurze Quellstörung wird unavailable oder sichtbar fehlerhaft und nicht heimlich null.
• Nach Wiederherstellung kehren Wert und Einheit zurück, ohne eine zweite Entität anzulegen.
• Ein Neustart ändert weder Vorzeichenlogik noch kumulierte Bezugsenergie.
• Es ist geklärt, ob identische Folgemessungen bei dieser Integration als neue Meldungen gelten.

6. Optionales Normalisierungspaket installieren

Den öffentlichen Kern swf_grid.yaml und swf025_energy_data_health.yaml direkt herunterladen und erst verwenden, nachdem eine vorzeichenbehaftete Netzleistung in W oder kW und ein kumulierter Netzbezug in kWh identifiziert wurden. Zuerst ein Backup anlegen. Genau einen Grid-Kern installieren; bestehen die gemeinsamen Entitäten bereits, diese Kopie behalten und nur die Foundation-Energieprüfung ergänzen.

1. Den einzigen Platzhalter sensor.REPLACE_GRID_POWER in swf_grid.yaml durch die geprüfte vorzeichenbehaftete Leistungsentität ersetzen.
2. Jedes sensor.REPLACE_GRID_IMPORT_KWH durch die geprüfte kumulierte Bezugsentität ersetzen.
3. Entwicklerwerkzeuge → YAML → Konfiguration prüfen. Jeden Fehler vor dem Neustart beheben.
4. Nach dem Neustart müssen exakt diese Entitäten vorhanden sein:

sensor.swf_grid_power_w
sensor.swf_grid_import_w
sensor.swf_grid_export_w
binary_sensor.swf_grid_data_problem
sensor.swf025_grid_import_energy
binary_sensor.swf025_energy_data_problem

Der Produkt-Namensraum swf025_* ist beabsichtigt. Er trennt Unique IDs und Entitäts-IDs von SWF-020 und anderen Produkten. Nicht zu nackten swf_grid_*-IDs zurückbenennen. Erzeugt Home Assistant ein Suffix _2, unter Einstellungen → Geräte & Dienste → Entitäten den veralteten oder doppelten Eintrag auflösen. Interne Referenzen erwarten die oben genannten exakten IDs.

7. Trockenlauf ohne Eingriff in Live-Hardware

Für einen Vorabtest unter Einstellungen → Geräte & Dienste → Helfer zwei Zahlen-Helfer anlegen. Einer benötigt einen Bereich mit negativen Werten und Einheit W, der andere einen nicht negativen Bereich und kWh. Eindeutige IDs wie input_number.swf025_test_grid_power_w und input_number.swf025_test_import_kwh vergeben, beide in einer Testkopie des Pakets zuordnen, Konfiguration prüfen und neu starten.

Die Zustandswerkzeuge ändern nur die vorübergehende Home-Assistant-Darstellung und senden keinen Befehl an reale Geräte. Ausfälle nur mit Testhelfern simulieren und den Helfer danach normal ändern. Anschließend eine saubere Paketkopie auf verifizierte Live-Entitäten umstellen und die Konfigurationsprüfung wiederholen.

8. Eignungsmatrix für jedes Produkt

9. Go/No-Go dokumentieren

Datum, Home-Assistant-Version, Integration, exakte IDs, Einheiten, Vorzeichen, beobachteten Aktualisierungstakt, Ausfallverhalten und bestandene Produktzeile kurz festhalten. Nach Änderungen an Integration, Firmware, Zähler, Tarif oder Home Assistant erneut prüfen.