-blue){kind=icon}
Eine Home Assistant Custom Integration zur lokalen Überwachung von Enpal Solaranlagen. Liest Daten direkt aus der lokalen Weboberfläche der Enpal Box und stellt über 100 Sensoren für Solaranlage, Batterie, Wallbox und Wärmepumpe bereit.
Version 3.0.0 bringt einen Echtzeit-Modus und eine native Wallbox-Steuerung.
- WebSocket-Modus (Echtzeit): Sensor-Werte werden sofort aktualisiert statt nur im Intervall. Setzt Firmware 8.50 voraus.
- Native Wallbox-Steuerung ohne Add-on: Im WebSocket-Modus steuert die Integration die Wallbox direkt. Das separate Add-on bzw. die Wallbox App wird nicht mehr benötigt.
- Inkrementelles RenderBatch-Parsing: Senkt die CPU-Last der Enpal Box, weil bei jeder Änderung nur die geänderten Sensoren aktualisiert werden statt der ganzen Seite.
- Dynamische Sensoren zur Laufzeit: Neue Datenpunkte legt die Integration automatisch an. Werte bleiben über einen Neustart erhalten.
- Zuverlässigere Wallbox-Status-Erkennung: Erkennt mehrere Namensvarianten des Status-Sensors. Bei unbekanntem Namen führt eine Reparatur-Meldung durch die manuelle Auswahl.
Details in den Release Notes 3.0.0.
Update 3.0.1: Bugfix für den WebSocket-Modus. Sensoren, die direkt nach einem Neustart fehlten, froren ein oder blieben
unavailable. Details in den Release Notes 3.0.1.
Update 3.0.2: Geringere CPU-Last und ein Statussensor der Wallbox, der nicht mehr fehlerhaft als Spannungssensor behandelt wird. Details in den Release Notes 3.0.2.
Hinweis zur Firmware: Der WebSocket-Modus, die native Wallbox-Steuerung und das RenderBatch-Parsing setzen die Enpal-Firmware Solar Rel. 8.50.1-773465 (27.05.2026) voraus. Auf älteren Firmware-Ständen läuft weiterhin der HTML-Polling-Modus (Legacy), ohne die neuen Echtzeit- und Wallbox-Funktionen.
Hinweis zu fehlenden Sensoren: Seit Firmware 8.50 stellt Enpal einige Sensoren nicht mehr bereit. Die Integration kann das nicht ändern. Betroffene Entitäten kannst du in Home Assistant gefahrlos löschen.
- Lokale Kommunikation: Keine Cloud-Anbindung erforderlich, alle Daten werden lokal im Netzwerk abgerufen.
- Zwei Datenquellen: WebSocket-Echtzeitmodus (Firmware 8.50) oder HTML-Polling (Legacy), mit automatischer Erkennung der besten Methode.
- Umfangreiche Sensoren: Über 100 Datenpunkte für PV-Anlage, Batterie, Inverter, Wallbox und Wärmepumpe.
- Flexible Sensor-Gruppen: Wählbare Kategorien (Battery, Inverter, Wallbox, Heatpump und weitere).
- Auto-Discovery: Automatische Erkennung der Enpal Box im lokalen Netzwerk.
- Energy Dashboard: Volle Unterstützung für das Home Assistant Energy Dashboard.
- Wallbox-Steuerung: Nativ im WebSocket-Modus oder über separates Add-on im HTML-Modus.
- Reparatur-Flow: Geführte Auswahl des Wallbox-Status-Sensors, falls die automatische Erkennung fehlschlägt.
- UI-Konfiguration: Vollständige Einrichtung über die Home Assistant Oberfläche.
- Mehrsprachig: Deutsche und englische Übersetzungen.
- Leistung: DC-Strings, AC-Phasen, Gesamtleistung
- Energie: Tagesertrag, Gesamtertrag, Netzeinspeisung/-bezug
- Elektrik: Spannung, Strom, Frequenz pro Phase
- Status: Betriebszustand, Systemstatus, Alarme
- Ladestand: Prozent und absolute Werte (kWh)
- Leistung: Lade-/Entladeleistung, Max-Werte
- Elektrik: Spannung, Strom pro Batterie-Unit
- Status: Betriebsmodus, Zwangsladung/-entladung
- Laden: Ladestand, Leistung, Gesamtenergie
- Elektrik: Spannung, Strom pro Phase, Phasenanzahl
- Steuerung: Lademodus (Eco, Solar, Full, Smart), Start und Stop
- Status: Ladestatus, angebotene Leistung
- Temperaturen: Warmwasser, Außentemperatur
- Energie: Verbrauch (kWh), aktuelle Leistung (kW)
- Status: Betriebsmodus
- System: CPU-Last, Speichernutzung
- Netzwerk: LTE-Qualität, Datenverbrauch, Verbindungstyp
- Diagnose: Firmware-Version, Systemzustand
Die Integration funktioniert nur, wenn die Enpal Box eine lokale Weboberfläche bereitstellt. Ob dies der Fall ist, lässt sich einfach testen:
- IP-Adresse der Enpal Box im Router ermitteln (z.B.
192.168.178.178) - Im Browser die URL
http://<ENPAL-IP>/deviceMessagesaufrufen - Wenn eine Webseite wie folgt angezeigt wird, ist die Integration kompatibel:
Hinweis: Ältere Enpal Boxen (1. Generation) stellen diese Weboberfläche nicht immer bereit und werden aktuell nicht unterstützt.
- Home Assistant Core 2024.1.0 oder höher
- Enpal Box im selben Netzwerk wie Home Assistant
- DHCP-aktivierter Router (Enpal Box bezieht IP per DHCP)
- Für den WebSocket-Modus und die native Wallbox-Steuerung: Enpal-Firmware Solar Rel. 8.50 oder höher
Die Integration kennt zwei Wege, um Daten von der Enpal Box zu lesen. Die Auswahl triffst du im Setup-Assistenten unter Datenquelle.
Die Integration nutzt die native Schnittstelle der Enpal Box. Das ist dieselbe Technik, die auch die Weboberfläche intern verwendet.
- Sensor-Werte werden sofort aktualisiert.
- Die Integration hängt nicht an der HTML-Struktur der Webseite.
- Die Wallbox wird nativ gesteuert, ohne Add-on.
- Inkrementelles RenderBatch-Parsing senkt die CPU-Last der Box.
Die Integration ruft im eingestellten Intervall die Seite http://<ENPAL-IP>/deviceMessages ab und liest die Tabellen aus.
- Funktioniert auch auf Boxen ohne WebSocket-Unterstützung.
- Die Wallbox-Steuerung läuft über ein separates Add-on bzw. die Wallbox App.
- Auto-detect (empfohlen): Prüft, ob WebSocket verfügbar ist, und fällt im Zweifel auf HTML-Polling zurück.
- WebSocket (Echtzeit): Erzwingt die WebSocket-Verbindung.
- HTML-Polling (Legacy): Erzwingt die bisherige Methode.
Die Integration ist offiziell in HACS gelistet.
- HACS öffnen über die Seitenleiste in Home Assistant
- Im Suchfeld nach
Enpal Solarsuchen - Integration auswählen und auf Herunterladen klicken
- Home Assistant neu starten
Wichtig: Die Integration muss erst über HACS heruntergeladen werden (Schritt 1), bevor sie unter "Geräte & Dienste" hinzugefügt werden kann.
- Einstellungen → Geräte & Dienste öffnen
- Unten rechts auf + Integration hinzufügen klicken
- Nach
Enpal Solarsuchen und auswählen - Setup-Assistent folgen (siehe Konfiguration)
Klicken für manuelle Installationsanleitung
- Neueste Release herunterladen
- Den Ordner
custom_components/enpal_webparser/in das Home Assistantcustom_componentsVerzeichnis kopieren- Pfad:
/config/custom_components/enpal_webparser/ - Bei Hass.io: SAMBA verwenden
- Bei Supervised: Eventuell unter
/usr/share/hassio/homeassistant/
- Pfad:
- Home Assistant neu starten
- Zur Integration hinzufügen (siehe Konfiguration)
- Einstellungen → Geräte & Dienste öffnen
- Unten rechts auf + Integration hinzufügen klicken
- Nach
Enpal Solarsuchen und auswählen
Der Setup-Assistent führt durch folgende Schritte:
- Auto-Discovery: Automatische Suche der Enpal Box im Netzwerk (empfohlen)
- Manuelle Eingabe: URL manuell eingeben, falls Auto-Discovery fehlschlägt
- Bei Auto-Discovery: Gefundene Enpal Box auswählen
- Bei manueller Eingabe: URL eingeben (z.B.
http://192.168.178.178/deviceMessages) - Die Verbindung wird automatisch getestet
- Datenquelle: Auto-detect, WebSocket oder HTML-Polling (siehe Datenquellen)
- Aktualisierungsintervall: Empfohlen 60 Sekunden (Minimum 10 Sekunden). Im WebSocket-Modus steuert dieses Intervall den Vollabgleich im Hintergrund.
- Sensor-Gruppen: Auswahl der gewünschten Kategorien
Battery- Batterie-SensorenInverter- Wechselrichter-SensorenWallbox- Wallbox-Sensoren (falls vorhanden)Heatpump- Wärmepumpen-Sensoren (falls vorhanden)Site Data- Standort- und VerbrauchsdatenIoTEdgeDevice- System-SensorenPowerSensor- Stromsensor-Daten
- Wallbox-Steuerung: Bei Bedarf aktivieren (siehe Wallbox-Steuerung)
Sensor-Gruppen können jederzeit geändert werden:
- Einstellungen → Geräte & Dienste öffnen
- Bei der Enpal Integration auf das Zahnrad (Konfigurieren) klicken
- Weiter klicken bis zur Sensor-Gruppen-Auswahl
- Gewünschte Gruppen an-/abwählen
- Mit Senden bestätigen
Hinweis: Nicht ausgewählte Sensor-Gruppen werden als deaktivierte Entitäten angelegt und können bei Bedarf später manuell aktiviert werden.
Die Wallbox-Steuerung aktivierst du in den Integrationseinstellungen. Wie die Steuerung kommuniziert, hängt von der gewählten Datenquelle ab.
Im WebSocket-Modus steuert die Integration die Wallbox direkt. Das separate Wallbox Add-on bzw. die Wallbox App wird nicht mehr benötigt.
Wichtig: Stoppe das alte Wallbox Add-on bzw. die Wallbox App im WebSocket-Modus. Sonst kommt es zu doppelten Steuerbefehlen.
Unterstützte Funktionen:
- Lademodus umschalten: Eco, Solar, Full, Smart
- Laden starten und stoppen
- Status-Sensoren: aktueller Modus, Ladestatus, Leistung
Im HTML-Modus wird für die Wallbox-Steuerung ein separates Add-on benötigt, das die Kommunikation mit der Wallbox-Hardware übernimmt. Seit 2026.2 stellt Home Assistant dies als eigene "App" bereit.
- Add-on / App Store in Home Assistant öffnen (Einstellungen → Apps)
- Drei-Punkte-Menü (oben rechts) → Repositories
- Repository-URL hinzufügen:
https://github.com/derolli1976/enpal-wallbox-addon - Enpal Wallbox Control Add-on / App installieren
- Add-on / App starten
- In der Enpal Integration die Wallbox-Steuerung aktivieren (siehe Konfiguration)
📚 Vollständige Wallbox Add-on / App Dokumentation
Auto-Discovery findet keine Enpal Box
Ursachen:
- Enpal Box in anderem Subnetz
- Firewall blockiert Multicast-Traffic
- Docker/VM mit NAT statt Bridge-Modus
Lösungen:
- Manuelle Eingabe der URL verwenden
- IP-Adresse der Enpal Box im Router ermitteln
- Bei Docker:
--network hostverwenden - Bei VM: Bridge-Netzwerk statt NAT konfigurieren
Sensoren zeigen keine Werte an
Lösungen:
- Prüfen ob Sensor-Gruppe aktiviert ist
- Enpal Box und Home Assistant neu starten
- Logs prüfen: Einstellungen → System → Protokolle (nach
[Enpal]filtern) - URL im Browser öffnen und prüfen ob Daten vorhanden sind
Sensoren nach Enpal-Update verschwunden
Enpal aktualisiert gelegentlich die Firmware, was zu temporär fehlenden Sensoren führen kann.
Lösungen:
- Enpal Box neu starten (Hauptschalter aus/an)
- Home Assistant neu starten
- 1-2 Tage warten (Sensoren tauchen oft von selbst wieder auf)
- Im Forum nach ähnlichen Problemen suchen
Hinweis: Die Integration kann nur Daten anzeigen, die die Enpal Box bereitstellt. Bei Firmware-Updates können sich verfügbare Datenpunkte ändern.
⚠️ Seit Firmware 8.50 stellt Enpal einige Sensoren nicht mehr bereit. Die Integration kann das nicht ändern. Fehlende Werte kommen daher, dass die Enpal Box sie nicht mehr liefert. Die dauerhaft nicht mehr verfügbaren Sensoren kannst du in Home Assistant gefahrlos löschen (über Einstellungen → Geräte & Dienste → Entitäten die jeweilige Entität auswählen und entfernen). Liefert Enpal einen Sensor später wieder, legt die Integration ihn automatisch neu an.
Wallbox-Steuerung funktioniert nicht
Prüfungen im WebSocket-Modus:
- Datenquelle auf WebSocket (oder Auto-detect mit verfügbarem WebSocket)?
- Wallbox-Steuerung in der Integration aktiviert?
- Altes Wallbox Add-on bzw. die App gestoppt? Doppelte Steuerung führt zu Konflikten.
- Sensor
sensor.wallbox_statusvorhanden und aktualisiert?
Prüfungen im HTML-Modus:
- Wallbox Add-on bzw. App installiert und gestartet?
- Wallbox-Steuerung in der Integration aktiviert?
- Add-on bzw. App Logs prüfen: Einstellungen → Add-ons / Apps → Enpal Wallbox Control → Protokoll
- Sensor
sensor.wallbox_statusvorhanden und aktualisiert?
ℹ️ Wallbox-Status bleibt
unknown: Je nach Firmware liefert die Enpal Box den Status-Sensor unter verschiedenen Namen. Findet die Integration bei aktiver Wallbox-Steuerung keinen passenden Status-Sensor, legt sie eine Reparatur-Meldung an (Einstellungen → System → Reparaturen). Über Beheben wählst du den richtigen Sensor aus. Danach lädt die Integration neu und der Status wird angezeigt.
Bei Problemen Debug-Logs in configuration.yaml aktivieren:
logger:
default: warning
logs:
custom_components.enpal_webparser: debugDanach Home Assistant neu starten und Logs unter Einstellungen → System → Protokolle prüfen (nach [Enpal] filtern).
Die Integration ist vollständig mit dem Home Assistant Energy Dashboard kompatibel.
Netzverbrauch:
sensor.inverter_grid_import_power_total_calculated(Bezug vom Netz)
Einspeisung:
sensor.inverter_power_grid_export_calculated(Einspeisung ins Netz)
Solaranlage:
sensor.inverter_energy_produced_total_dc(Täglicher Ertrag)sensor.inverter_energy_production_total_lifetime(Gesamtertrag)
Batterie:
sensor.inverter_energy_battery_charge_lifetime(Batterieladung)sensor.inverter_energy_battery_discharge_lifetime(Batterieentladung)
Wärmepumpe (falls vorhanden):
sensor.heatpump_energy_consumption_total_lifetime(Gesamtverbrauch)
- Nur 1. Generation Enpal Boxen mit lokaler Weboberfläche werden unterstützt.
- Firmware 8.50 für neue Funktionen: WebSocket-Echtzeitmodus, native Wallbox-Steuerung und das inkrementelle RenderBatch-Parsing setzen Firmware 8.50 voraus. Ältere Stände nutzen den HTML-Polling-Modus.
- Sensor-Unterschiede zwischen den Modi: Im WebSocket-Modus stehen teilweise andere Sensoren zur Verfügung als im HTML-Modus. Siehe Sensor-Vergleich.
- Mehrdeutige Sensoren: Sensoren mit gleichem Namen in mehreren Gruppen aktualisieren im WebSocket-Modus erst im Vollabgleich-Intervall statt in Echtzeit.
- Firmware-Abhängigkeit: Verfügbare Sensoren können sich durch Enpal-Firmware-Updates ändern.
- Keine Cloud-Integration: Die Integration kommuniziert nur lokal, keine Anbindung an die Enpal-Cloud.
- Issues: GitHub Issues
- Diskussionen: GitHub Discussions
Pull Requests sind willkommen! Bitte vorher ein Issue öffnen, um Änderungen zu besprechen.
Wenn die Integration hilfreich ist:
Dies ist keine offizielle Integration von Enpal.
Dieses Projekt steht in keinerlei Verbindung zur Enpal B.V. und ist eine inoffizielle, privat entwickelte Erweiterung. Die Integration basiert ausschließlich auf lokal im Netzwerk bereitgestellten Daten.
Die Nutzung erfolgt auf eigene Verantwortung. Die Funktionalität kann durch Änderungen an der Firmware oder Weboberfläche der Enpal-Anlage jederzeit eingeschränkt oder unterbrochen werden.
Weder der Autor noch Mitwirkende übernehmen Haftung für Schäden, Datenverlust oder Fehlfunktionen.
MIT License - siehe LICENSE Datei für Details.
Getestet mit: Enpal Firmware Solar Rel. 8.50.1-773465 (27.05.2026)
