Skip to content

README.md

Latest commit

 

History

History
107 lines (72 loc) · 4.25 KB

README.md

File metadata and controls

107 lines (72 loc) · 4.25 KB
Raw

Enpal Solar Logo

Enpal Solar – Home Assistant Integration

hacs_badge GitHub release Buy Me A Coffee

Diese Home Assistant Integration liest Daten von der lokalen Enpal-Webseite der Solaranlage (z. B. http://192.168.178.178/deviceMessages) aus und stellt die Werte als Sensoren in Home Assistant zur Verfügung.
Getestet mit der Version 2 der Enpal Box und Solar Rel. 8.46.1-346390 (12.05.2025).

WICHTIG: Nicht kompatibel mit der Version 1 der Enpal Box

🔧 Funktionen

  • Liest Messwerte aus HTML-Tabellen auf der lokalen Enpal-Geräteseite
  • Automatische Gruppierung nach Datenbereich (z. B. Wallbox, Battery, Inverter)
  • Sensor-Namen sind sprechend und gruppiert
  • Auto-Aktualisierung über einstellbares Intervall
  • Sensoren erscheinen automatisch in Home Assistant
  • Nicht ausgewählte Gruppen werden als deaktivierte Entitäten angezeigt
  • Integration vollständig konfigurierbar über das Home Assistant UI (auch nachträglich)
  • NEU: Experimentelle Steuerung einer Enpal-Wallbox (Start/Stopp, Moduswahl) über optionales Add-on

⚙️ Konfiguration

Die Integration kann über die Benutzeroberfläche von Home Assistant konfiguriert werden:

  • URL der Datenquelle: z. B. http://192.168.178.178/deviceMessages
  • Aktualisierungsintervall: Zeit in Sekunden
  • Sensorgruppen: Mehrfachauswahl wie Wallbox, Battery, Inverter, etc.
  • Wallbox-Steuerung aktivieren: Optional, wenn das Enpal Wallbox Add-on installiert ist

📦 Installation

✅ Variante 1: Manuell

  1. Kopiere den Ordner custom_components/enpal_webparser/ in dein Home Assistant custom_components Verzeichnis.
  2. Starte Home Assistant neu.
  3. Gehe zu Einstellungen → Geräte & Dienste → Integration hinzufügen und wähle Enpal Solar.
  4. Gib die URL, das Intervall und gewünschte Gruppen an.

🧩 Variante 2: HACS (Custom Repository)

  1. Öffne HACS in Home Assistant.
  2. Klicke auf "Integrationen" → "Benutzerdefiniertes Repository hinzufügen" (oben rechts: 3-Punkte-Menü).
  3. Gib die GitHub-URL dieses Repos ein:
    https://github.com/derolli1976/enpal
  4. Wähle als Typ "Integration".
  5. Installiere die Integration direkt über HACS.
  6. Starte Home Assistant neu.
  7. Füge die Integration wie gewohnt über das UI hinzu.

🚗 Wallbox Add-on (Optional & Experimentell)

Zur Steuerung einer Enpal Wallbox ist das folgende Add-on erforderlich:
🔗 https://github.com/derolli1976/enpal-wallbox-addon

🔌 Add-on Installation

  1. Öffne den Home Assistant Add-on Store

  2. Gehe zu Repositories (3-Punkte-Menü oben rechts)

  3. Füge folgendes Repository hinzu:

    https://github.com/derolli1976/enpal-wallbox-addon

  4. Installiere das Add-on und konfiguriere die IP-Adresse der Enpal Box

  5. Starte das Add-on und aktiviere "Start on boot" bei Bedarf

  6. Aktiviere die Wallbox-Steuerung in der Enpal-Integration

⚠️ Das Feature ist experimentell. Fehler können auftreten. Feedback ist willkommen!

❓ FAQ & Hilfe

Antworten auf häufige Fragen findest du hier:
📘 FAQ – Häufige Fragen zur Enpal Solar Integration

🐛 Probleme & Feedback

Bitte eröffne ein GitHub-Issue unter:
👉 https://github.com/derolli1976/enpal/issues

⚠️ Disclaimer

Dieses Projekt steht in keinerlei Verbindung zur Enpal B.V.
Es handelt sich um eine inoffizielle, private Integration, die auf öffentlich zugänglichen HTML-Daten basiert, die lokal im Netzwerk bereitgestellt werden.

Die Nutzung erfolgt auf eigene Verantwortung.
Funktionen können durch Firmware- oder UI-Änderungen von Enpal jederzeit beeinträchtigt werden.