v2.9.9 Beta 1

2.9.9b1 - WebSocket & Native Wallbox-Steuerung (Beta)

---

⚠️ BETA-VERSION — WICHTIGE HINWEISE

Dies ist eine Beta-Version und NICHT für den produktiven Einsatz gedacht!

• 🧪 Nur zum Testen — diese Version kann noch Fehler enthalten.
• 💾 Backup erstellen! — Vor der Installation unbedingt ein Home Assistant-Backup anlegen.
• 🔄 Downgrade möglich — Bei Problemen kann jederzeit auf die stabile Version 2.3.1 zurückgewechselt werden (über HACS → Version auswählen).
• 🐛 Fehler melden — Bitte Fehler und Auffälligkeiten auf GitHub Issues melden, damit wir sie vor dem stabilen Release beheben können.
• 📊 Historische Daten — Beim Wechsel der Datenquelle (HTML → WebSocket) können sich Sensor-IDs ändern. Bestehende Historien-Daten bleiben erhalten, aber neue Sensoren starten ohne Historie.

---

🎉 Neue Funktionen

1. WebSocket-Verbindung (Echtzeit-Daten)

Was ist das?
Bisher hat die Integration regelmäßig die Webseite der Enpal Box abgefragt und die dort angezeigten Daten ausgelesen (sogenanntes "HTML-Scraping"). Das funktioniert, ist aber langsam und kann bei Änderungen an der Webseite brechen.

Die neue WebSocket-Verbindung nutzt stattdessen die native Schnittstelle der Enpal Box — dieselbe Technik, die auch die Weboberfläche intern verwendet. Die Daten werden dabei direkt und in Echtzeit an Home Assistant übertragen.

Vorteile auf einen Blick:

• ⚡ Schnellere Updates — Sensor-Werte werden sofort aktualisiert, statt nur alle 60 Sekunden
• 🔒 Stabiler — Keine Abhängigkeit von der HTML-Struktur der Webseite
• 📉 Weniger Systemlast — Eine dauerhafte Verbindung statt ständiger Seitenaufrufe
• 📊 Mehr Sensoren — Die WebSocket-API liefert zusätzliche aggregierte Werte (z.B. Tagesverbrauch, Gesamthausleistung)

2. Native Wallbox-Steuerung (ohne Add-on!)

Was ist das?
Bisher war zum Steuern der Wallbox ein separates Home Assistant Add-on nötig, das als Vermittler zwischen Home Assistant und der Enpal Box fungierte. Das war umständlich einzurichten und eine zusätzliche Fehlerquelle.

Neu: Direkte Wallbox-Steuerung — Im WebSocket-Modus kommuniziert die Integration jetzt direkt mit der Wallbox-Seite der Enpal Box. Das separate Wallbox Add-on wird im WebSocket-Modus nicht mehr benötigt!

Vorteile auf einen Blick:

• 🚫 Kein Extra-Add-on nötig — Weniger Abhängigkeiten, einfachere Installation
• ⚡ Schnellere Reaktion — Direkter Befehlsweg ohne Umweg über ein Add-on
• 🔧 Einfachere Einrichtung — Wallbox-Steuerung einfach in den Integrationseinstellungen aktivieren
• 🔄 Zuverlässiger — Keine Probleme mehr durch Add-on-Abstürze oder -Updates

Unterstützte Wallbox-Funktionen:

• Laden starten / stoppen
• Lademodus wechseln: Eco, Solar, Full, Smart
• Wallbox-Status auslesen (Modus, Verbindungsstatus)

3. Automatische Erkennung der besten Datenquelle

Bei der Einrichtung erkennt die Integration automatisch, ob die Enpal Box WebSocket unterstützt. Du musst dich nicht mit technischen Details befassen — die Integration wählt selbst die beste verfügbare Methode:

• Auto-detect (empfohlen) — Prüft automatisch, ob WebSocket verfügbar ist
• WebSocket (Echtzeit) — Erzwingt die neue WebSocket-Verbindung
• HTML-Polling (Legacy) — Nutzt die bisherige Methode (für ältere Enpal-Boxen)

---

🔧 Installation der Beta

Über HACS:

1. In HACS → Enpal Solar öffnen
2. Auf die drei Punkte (⋮) klicken → Version auswählen
3. Version 2.9.9b1 auswählen und installieren
4. Home Assistant neu starten

Ersteinrichtung:

Die Integration erkennt beim Einrichten automatisch die beste Datenquelle. Es sind keine speziellen Einstellungen nötig.

Bestehende Installation upgraden:

1. Beta-Version über HACS installieren (siehe oben)
2. Home Assistant neu starten
3. Einstellungen → Geräte & Dienste → Enpal Webparser → Konfigurieren
4. Bei Datenquelle die gewünschte Option wählen (oder "Auto-detect" belassen)
5. Ggf. Wallbox-Steuerung aktivieren (erfordert im HTML-Modus weiterhin das Add-on)
6. Speichern — die Integration lädt automatisch neu

---

⚠️ Bekannte Einschränkungen (Beta)

• WebSocket-Verfügbarkeit: Nicht alle Enpal-Boxen unterstützen WebSocket. Die Integration erkennt das automatisch und fällt im Zweifelsfall auf HTML-Polling zurück.
• Wallbox-Steuerung: Die native Wallbox-Steuerung wurde mit begrenzter Hardware-Vielfalt getestet. Bitte Rückmeldung geben, ob alles funktioniert!
• Verbindungsstabilität: Die WebSocket-Verbindung wird automatisch bei Abbruch neu aufgebaut. In seltenen Fällen kann es zu kurzen Aussetzern kommen.

---

📋 Zurück zur stabilen Version

Falls Probleme auftreten:

1. In HACS → Enpal Solar öffnen
2. Auf die drei Punkte (⋮) klicken → Version auswählen
3. Version 2.3.0 (stabile Version) auswählen und installieren
4. Home Assistant neu starten

Alle bisherigen Sensoren und Einstellungen bleiben erhalten.

---

ℹ️ Kompatibilität

• Rückwärtskompatibel: Bestehende Installationen werden automatisch migriert. Die Datenquelle wird auf "HTML" gesetzt, damit alles wie gewohnt funktioniert.
• Wallbox Add-on: Im HTML-Modus wird das Add-on weiterhin benötigt. Nur im WebSocket-Modus entfällt das Add-on.
• Keine Breaking Changes: Bestehende Sensoren und historische Daten bleiben unverändert.

---

🙏 Feedback erwünscht!

Als Beta-Version lebt diese Version von eurem Feedback. Bitte meldet:

• ✅ Was funktioniert gut?
• ❌ Was funktioniert nicht?
• 💡 Was fehlt oder könnte verbessert werden?

Rückmeldungen bitte auf GitHub Issues oder in den GitHub Discussions.

Vielen Dank an alle Tester! 🎉

---

🔍 Technische Details

• Blazor SignalR WebSocket-Protokoll mit MessagePack-Encoding
• Abstrakte API-Schicht (EnpalApiClient) für austauschbare Datenquellen
• EnpalWebSocketClient für Echtzeit-Daten, EnpalHtmlClient als Legacy-Wrapper
• WallboxBlazorClient für direkte Wallbox-Steuerung über die /wallbox-Seite
• Automatische Reconnect-Logik mit Keep-Alive-Pings
• Config Flow mit Auto-Detection, manueller Auswahl und Options Flow
• Automatische Migration bestehender Konfigurationen (inkl. Umbenennung use_wallbox_addon → use_wallbox)
• Credits: WebSocket-Protokoll basiert auf dem Reverse-Engineering von @arigon

2.3.1 - Konfigurierbares HTTP-Timeout

🐛 Bugfix

Sensoren werden häufig "Nicht verfügbar": Bei einigen Enpal-Boxen reagiert die Weboberfläche (/deviceMessages) langsam, wodurch das bisherige HTTP-Timeout von 30 Sekunden überschritten wurde. Alle Sensoren wechselten dann regelmäßig auf "Nicht verfügbar".

Das HTTP-Timeout ist jetzt über die Integrationseinstellungen konfigurierbar (10–120 Sekunden). Der Standardwert bleibt bei 30 Sekunden.

🔧 Anpassung

Wer häufig "Nicht verfügbar"-Meldungen sieht, sollte den Timeout-Wert erhöhen:

1. Einstellungen → Geräte & Dienste öffnen
2. Enpal Webparser Integration suchen
3. Auf das Zahnrad (Konfigurieren) klicken
4. Den Wert bei "HTTP Timeout" auf 60–90 Sekunden erhöhen
5. Mit Senden bestätigen

📋 Weitere Änderungen

• README aktualisiert: "Add-ons" umbenannt in "Apps" (Home Assistant Namensänderung)
• CodeQL GitHub Actions auf v4 aktualisiert
• Kleinere Korrekturen an Übersetzungen (Hassfest-Validierung)
• README: Klarstellung zur Enpal-Box-Kompatibilität

ℹ️ Kompatibilität

Keine Breaking Changes. Alle bestehenden Sensoren und historischen Daten bleiben unverändert.

Rückwärtskompatibel: Bestehende Installationen übernehmen automatisch den bisherigen Standardwert von 30 Sekunden.

📋 Update-Hinweise

1. Auf Version 2.3.1 aktualisieren (über HACS)
2. Home Assistant neu starten
3. Bei Bedarf den Timeout-Wert wie oben beschrieben anpassen

🎯 Betroffene Systeme

Relevant für alle Enpal-Anlagen, bei denen Sensoren häufig als "Nicht verfügbar" angezeigt werden. Installationen ohne dieses Problem sind nicht betroffen.

🙏 Danke

Vielen Dank an die Community für die Fehlermeldungen und das Feedback zur Sensor-Verfügbarkeit!

Feedback, Verbesserungsvorschläge oder Fehlermeldungen können auf GitHub oder in den Diskussionen gemeldet werden.

2.3.0 - Wärmepumpen-Unterstützung

🎉 Neue Funktion

Wärmepumpen-Sensoren: Die Integration unterstützt jetzt Sensoren für installierte Enpal-Wärmepumpen! Nach Aktivierung der Sensor-Gruppe werden alle verfügbaren Wärmepumpen-Sensoren automatisch in Home Assistant angelegt.

📊 Neue Sensoren

Die folgenden Wärmepumpen-Sensoren werden unterstützt (je nach vorhandener Hardware):

• Heatpump DomesticHotWater Temperature: Warmwasser-Temperatur
• Heatpump Outside Temperature: Außentemperatur
• Heatpump Power Consumption Total: Aktuelle Leistungsaufnahme (kW)
• Heatpump Energy Consumption Total Lifetime: Gesamter Energieverbrauch seit Installation (kWh)
• Heatpump Operation Mode Midea: Betriebsmodus der Wärmepumpe

Alle Sensoren werden mit passenden Icons und korrekten Device Classes sowie State Classes angelegt (z.B. Energy-Sensor als total_increasing für das HA Energy Dashboard).

🔧 Aktivierung

Wichtig: Die Wärmepumpen-Sensoren müssen explizit aktiviert werden:

1. Einstellungen → Geräte & Dienste öffnen
2. Enpal Webparser Integration suchen
3. Auf das Zahnrad (Konfigurieren) klicken
4. Bei der Sensor-Gruppen-Auswahl den Haken bei "Heatpump" setzen
5. Mit Senden bestätigen
6. Home Assistant neu laden (oder auf den nächsten Update-Zyklus warten)

Die Sensoren erscheinen anschließend automatisch unter dem Enpal-Gerät.

🎯 Betroffene Systeme

Relevant für alle Enpal-Anlagen mit installierter Wärmepumpe. Installationen ohne Wärmepumpe bleiben unverändert.

📋 Update-Hinweise

1. Auf Version 2.3.0 aktualisieren (über HACS)
2. Home Assistant neu starten
3. Wärmepumpen-Sensoren wie oben beschrieben aktivieren

Hinweis: Die Integration prüft automatisch, ob die Enpal-Box Wärmepumpen-Daten bereitstellt. Ohne vorhandene Wärmepumpe werden auch keine Sensoren erstellt.

ℹ️ Kompatibilität

Keine Breaking Changes. Alle bestehenden Sensoren und historischen Daten bleiben unverändert.

Rückwärtskompatibel: Bestehende Installationen ohne Wärmepumpe sind nicht betroffen.

🧪 Getestet mit

• Enpal-Anlagen mit Wärmepumpe (reale Daten)
• Verschiedenen Sensor-Gruppen-Kombinationen

🙏 Danke

Vielen Dank an die Community für die Anfrage nach Wärmepumpen-Unterstützung und das bereitgestellte Test-HTML!

Feedback, Verbesserungsvorschläge oder Fehlermeldungen können auf GitHub oder in den Diskussionen gemeldet werden.

2.2.2 - Multi-Inverter Support für Energiesensor

🐞 Fix

Energiesensor funktioniert jetzt mit allen Inverter-Typen: Der Sensor sensor.inverter_energy_produced_total_dc zeigte bei Nicht-Huawei-Anlagen keine Werte an (Issue #87). Die Integration erkennt nun automatisch den passenden DC-Leistungssensor für alle Inverter-Hersteller.

Transparenz: Der Sensor zeigt im Attribut source_sensor an, welcher DC-Leistungssensor verwendet wird.

🎯 Betroffene Systeme

Besonders wichtig für Anlagen mit Nicht-Huawei-Invertern
Huawei-Anlagen funktionieren weiterhin wie bisher ohne Änderung.

📋 Update-Hinweise

Auf 2.2.2 aktualisieren und Home Assistant neu starten (wichtig: nicht nur Integration neu laden).

Nach dem Neustart:

• Der Energiesensor sensor.inverter_energy_produced_total_dc sollte nun Werte anzeigen
• Im Attribut source_sensor sieht man, welcher Sensor verwendet wird
• Bei Bedarf in den Logs nach [Enpal] suchen für Details zur Sensor-Auswahl

ℹ️ Kompatibilität

Keine Breaking Changes. Alle bestehenden Sensoren und historischen Daten bleiben unverändert.

Rückwärtskompatibel: Huawei-Anlagen nutzen weiterhin den optimierten Huawei-Sensor.

🧪 Getestet mit

• Huawei Invertern (Priorität 1)
• Generic DC Total Sensor

🙏 Danke

Danke für die Fehlermeldung zu Issue #87 und das bereitgestellte HTML von @fabfive für Tests!

Feedback, Verbesserungsvorschläge oder Fehlermeldungen können auf GitHub oder in den Diskussionen gemeldet werden.

2.2.1 - Fehlende Stromsensoren ergänzt

🐞 Fix

Stromsensoren wieder verfügbar: Bei manchen Enpal-Anlagen werden die PowerSensor-Stromsensoren (Phase A, B, C) nicht mehr bereitgestellt. Die Integration berechnet diese nun automatisch aus den vorhandenen Leistungs- und Spannungswerten.

Die drei Sensoren erscheinen nach dem Update automatisch:

• sensor.powersensor_current_phase_a
• sensor.powersensor_current_phase_b
• sensor.powersensor_current_phase_c

Zukunftssicher: Sollte Enpal die Sensoren später wieder bereitstellen, erkennt die Integration das automatisch und verhindert Duplikate.

🚀 Update-Hinweise

Auf 2.2.1 aktualisieren und Home Assistant neu starten (wichtig: nicht nur Integration neu laden).

Nach dem Neustart erscheinen die drei Stromsensoren automatisch - keine weitere Konfiguration erforderlich.

ℹ️ Kompatibilität

Keine Breaking Changes. Alle bestehenden Sensoren und historischen Daten bleiben unverändert.

🙏 Danke

Danke für die Fehlerberichte zu den fehlenden Stromsensoren!

Feedback, Verbesserungsvorschläge oder Fehlermeldungen können auf GitHub oder in den Diskussionen gemeldet werden.

2.2.0 - Setup leicht gemacht

✨ Neu

🔍 Automatische Erkennung der Enpal-Box

Die Integration findet Enpal-Boxen im Netzwerk jetzt automatisch.
Beim Einrichten kann "Automatische Erkennung" gewählt werden – die Integration durchsucht das Heimnetzwerk und zeigt alle gefundenen Enpal-Geräte an.

Falls nichts gefunden wird oder die URL lieber manuell eingegeben werden soll, funktioniert das weiterhin wie gewohnt.

Bequem: Statt IP-Adresse herauszusuchen, kann direkt auf "OK" geklickt werden (Scan dauert 1-2 Minuten).

🔧 Verbesserte Wallbox-Steuerung

Die Kommunikation mit dem Wallbox-Addon wurde überarbeitet:

• Zuverlässigere Verbindung (längere Wartezeit beim Start)
• Schnellere Reaktion auf Befehle
• Klarere Fehlermeldungen bei Problemen

🐞 Fix

• Wallbox-Verbindung stabiler: Die Integration wartet nun länger auf das Wallbox-Addon, bevor ein Fehler gemeldet wird
• Keine Duplikate mehr: Dieselbe Enpal-Box kann nicht mehr versehentlich zweimal hinzugefügt werden

📊 Vorteile

Einfachere Einrichtung:
Keine IP-Adressen mehr im Router suchen oder Browser-URLs kopieren – einfach "Automatische Erkennung" wählen.

Praktisch bei DHCP:
Wenn der Router der Enpal-Box eine neue IP-Adresse zuweist, wird diese bei der Einrichtung automatisch gefunden.

🚀 Update-Hinweise

Auf 2.2.0 aktualisieren und Home Assistant neu starten.

Neue Installationen:
Beim Hinzufügen der Integration "Automatische Erkennung" auswählen und kurz warten.

Bestehende Installationen:
Keine Änderungen erforderlich. Die automatische Erkennung steht nur für neue Geräte zur Verfügung.

Wallbox-Nutzer:
Die Verbindung sollte nun zuverlässiger funktionieren.

ℹ️ Kompatibilität

Keine Breaking Changes.
Bestehende Installationen, alle Sensoren und historische Daten bleiben unverändert.

Voraussetzungen für die automatische Erkennung:

• Enpal-Box und Home Assistant müssen im gleichen Heimnetzwerk sein (z.B. beide im 192.168.x.x-Netz)
• Die Enpal-Box muss über das Netzwerk erreichbar sein

🙏 Danke

Danke an alle, die sich eine einfachere Einrichtung gewünscht haben.

Feedback, Verbesserungsvorschläge oder Fehlermeldungen können auf GitHub oder in den Diskussionen gemeldet werden.

2.1.9 - Aufgeschlüsselter Inverter-Status

✨ Neu

Der Inverter System State wird jetzt automatisch in mehrere, klar strukturierte Sensoren aufgeteilt.
Zusätzlich bleibt der ursprüngliche Langtext-Sensor erhalten (gekürzt auf 240 Zeichen), um die Kompatibilität zu wahren.

Neu erzeugte Sensoren:

• inverter_system_state_decimal
• inverter_system_state_flags
• einzelne Bit-Sensoren (z. B. Grid-connected, Stop due to faults, Shutdown u. a.)

Dadurch lassen sich Statusänderungen des Wechselrichters gezielt in Automationen, Grafiken oder Energie-Analysen verwenden.

🐞 Fix

• Bug #71: sensor.energy_battery_charge_load hat nun
  • device_class: energy_storage (vorher: energy)
  • state_class: measurement
    -> Korrekte Zuordnung in Statistik- und Energie-Karten.
• Der 255-Zeichen-Fehler bei sensor.inverter_system_state wurde behoben (State fällt nicht mehr auf unknown).

📊 Wofür ist das gut?

Klarere Statusdarstellung und bessere Automatisierungen:

• Erkennung einzelner Betriebszustände wie Standby, Shutdown oder Grid derating
• Keine Log-Fehler durch zu lange Sensorwerte
• Verbesserte Auswertung der Batterieladeleistung dank korrekter device_class

🚀 Update-Hinweise

Auf 2.1.9 aktualisieren und Home Assistant neu starten.
Danach erscheinen die neuen inverter_system_state_*-Sensoren automatisch (ggf. zunächst deaktiviert).

Vorherige Entitäten bleiben unverändert erhalten.

ℹ️ Kompatibilität

Keine Breaking Changes.
Alle bestehenden Entity-IDs bleiben unverändert, historische Daten bleiben erhalten.

🙏 Danke

Danke an alle Community-Tester für die Hinweise zu den State-Overflow-Logs und die Rückmeldung zu energy_battery_charge_load.
Weitere Vorschläge oder Tests gerne als Issue oder Pull Request einreichen.

2.1.8 - Stabilere Statistiken und Texte

✨ Neu

Standard-state_class für numerische Live-Sensoren ist jetzt measurement.
Damit landen passende Sensoren automatisch im Recorder und in den Langzeitstatistiken. Energie-Zähler bleiben total_increasing.

🐞 Fix

Robustere Nummernerkennung: Textwerte werden nicht mehr nach einer führenden Zahl abgeschnitten.
Beispiele: „BT3082472938472“ bleibt vollständig Text.
„230 V“, „12,3 A“, „25 °C“ werden korrekt als Zahl mit Einheit erkannt.
Reine Zahlen ohne Einheit werden weiterhin als Zahl verarbeitet.

📊 Wofür ist das gut?

Mehr Sensoren erscheinen in Statistik-Karten (min, max, Durchschnitt pro Tag).
Weniger Datenmüll durch falsch interpretierte Texte. Bessere Auswertungen ohne manuelle Nacharbeit.

🚀 Update-Hinweise

Auf 2.1.8 aktualisieren.
Home Assistant neu starten.
Statistik-Karten prüfen: neue Sensoren können ab Update-Zeitpunkt Daten liefern (Vergangenheit wird nicht rückwirkend klassifiziert).

ℹ️ Kompatibilität

Keine Breaking Changes. Bestehende Entity-IDs bleiben unverändert.

🙏 Danke

Danke für die Bugreports und Tests aus der Community. Meldet euch gern, wenn weitere Sensoren eine spezielle Behandlung brauchen.

2.1.7 – Zuverlässigere Aktualisierung der Wallbox-Sensoren

⏱️ Neu: Kurze Wartezeit vor Sensor-Update
Nach Änderungen über Buttons oder Auswahlfelder (z. B. Lade­modus wechseln) wartet die Integration jetzt ein paar Sekunden, bevor die Wallbox-Sensoren neu abgefragt werden. So bleibt Zeit für die API, den Status korrekt zu übernehmen.

📊 Wofür ist das gut?
Bisher kam es vor, dass direkt nach einem Schaltbefehl noch der alte Wert im Sensor stand. Mit der Verzögerung werden nun konsistente und aktuelle Zustände angezeigt.

🚀 Update-Hinweise

• Keine Konfigurationsänderungen erforderlich.
• Einfach aktualisieren und Integration neu laden.
• Alle Entitäten bleiben unverändert erhalten.

💡 Tipp
Ideal für Automationen, die direkt nach einem Wallbox-Befehl den Sensorwert weiterverarbeiten -> hier stimmen die Zustände jetzt zuverlässiger.

2.1.6 – Statistiken für den Batteriestand

✨ Neu: state_class = measurement für Batteriestand

Die Battery-Level-Sensoren (sensor.energy_battery_charge_level sowie ggf. gerätespezifische Varianten) werden jetzt als Measurement klassifiziert. Dadurch landen sie automatisch im Recorder und in den Long-Term-Statistics. Du kannst sie direkt in Statistik-Karten verwenden (min, max, Durchschnitt pro Tag).

📊 Wofür ist das gut?

Tägliche Min/Max-Werte des SoC im Blick behalten, Lade- und Entladefenster erkennen, Abschätzen ob mehr Kapazität sinnvoll wäre. Ideal für Statistik-Karten und Auswertungen.

🔧 Weitere Anpassungen

• Per-Entity State-Class-Overrides eingebaut. SoC wird gezielt als Measurement gesetzt.
• Keine Änderung an unique_id, keine Konfigurationsänderung notwendig.

🚀 Update-Hinweise

• Nach dem Update Integration neu laden oder Home Assistant neu starten.
• Statistik-Karte hinzufügen und den SoC-Sensor auswählen.
• Historie entsteht ab Installation dieser Version. Falls der Recorder die Entitäten bisher ausgeschlossen hat, die Excludes entfernen.

💡 Tipp

Wer bisher keine Statistik-Werte sah: einfach aktualisieren und die Integration neu laden, dann erscheinen die Daten in den Statistik-Karten.