|
4 | 4 |
|
5 | 5 | # Enpal Solar – Home Assistant Integration |
6 | 6 |
|
7 | | -[](https://github.com/hacs/integration) |
| 7 | +[](https://github.com/hacs/integration) |
8 | 8 | [](https://github.com/derolli1976/enpal) |
9 | 9 | [](https://github.com/derolli1976/enpal/releases) |
10 | | - |
11 | | - |
| 10 | +[](https://my.home-assistant.io/redirect/hacs_repository/?owner=derolli1976&repository=enpal&category=integration) |
12 | 11 |
|
13 | 12 | <a href="https://buymeacoffee.com/derolli1976" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/default-orange.png" alt="Buy Me A Coffee" height="41" width="174"></a> |
14 | 13 |
|
15 | 14 | 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. |
16 | | -Getestet mit der Version 2 der Enpal Box und Solar Rel. 8.46.1-346390 (12.05.2025). |
| 15 | +Getestet mit Version 2 der Enpal Box und Solar Rel. 8.46.4-355926 (21.05.2025). |
17 | 16 |
|
18 | | -### WICHTIG: Nicht kompatibel mit allen Enpal Boxen der 1. Version! |
19 | | -### Nur wenn in Eurem lokalen Netzwerk unter der IP Adresse der Enpal Box eine Webseite ähnlich dieser hier erscheint, besteht die _Chance_, dass das hier funktioniert! |
| 17 | +### ⚠️ Hinweis: Einige Enpal Boxen der **1. Generation** werden **unterstützt**. |
| 18 | +Entscheidend ist, ob unter der IP-Adresse der Enpal Box im lokalen Netzwerk eine Webseite wie die folgende angezeigt wird: |
20 | 19 |
|
21 | | - |
| 20 | +<p align="left"> |
| 21 | + <img src="./images/enpal_box_webseite.png" alt="Enpal Box Webseite" width="600"/> |
| 22 | +</p> |
22 | 23 |
|
23 | 24 | --- |
24 | 25 |
|
25 | 26 | ## 🔧 Funktionen |
26 | 27 |
|
27 | 28 | - Liest Messwerte aus HTML-Tabellen auf der lokalen Enpal-Geräteseite |
28 | 29 | - Automatische Gruppierung nach Datenbereich (z. B. Wallbox, Battery, Inverter) |
29 | | -- Sensor-Namen sind sprechend und gruppiert |
30 | | -- Auto-Aktualisierung über einstellbares Intervall |
| 30 | +- Sprechende, gruppierte Sensor-Namen |
| 31 | +- Automatische Aktualisierung über einstellbares Intervall |
31 | 32 | - Sensoren erscheinen automatisch in Home Assistant |
32 | | -- Nicht ausgewählte Gruppen werden als deaktivierte Entitäten angezeigt |
33 | | -- Integration vollständig konfigurierbar über das Home Assistant UI (auch nachträglich) |
34 | | -- **NEU**: Experimentelle Steuerung einer Enpal-Wallbox (Start/Stopp, Moduswahl) über optionales Add-on |
| 33 | +- Nicht ausgewählte Gruppen werden als deaktivierte Entitäten angelegt |
| 34 | +- Konfiguration vollständig über das Home Assistant UI möglich |
| 35 | +- **NEU**: Experimentelle Wallbox-Steuerung über optionales Add-on |
35 | 36 |
|
36 | 37 | --- |
37 | 38 |
|
38 | 39 | ## ⚙️ Konfiguration |
39 | 40 |
|
40 | | -Die Integration kann über die Benutzeroberfläche von Home Assistant konfiguriert werden: |
| 41 | +Die Integration kann vollständig über das Home Assistant UI konfiguriert werden: |
41 | 42 |
|
42 | 43 | - **URL der Datenquelle**: z. B. `http://192.168.178.178/deviceMessages` |
43 | | -- **Aktualisierungsintervall**: Zeit in Sekunden |
44 | | -- **Sensorgruppen**: Mehrfachauswahl wie `Wallbox`, `Battery`, `Inverter`, etc. |
45 | | -- **Wallbox-Steuerung aktivieren**: Optional, wenn das Enpal Wallbox Add-on installiert ist |
| 44 | +- **Aktualisierungsintervall**: in Sekunden |
| 45 | +- **Sensorgruppen**: Auswahl von Bereichen wie `Wallbox`, `Battery`, `Inverter`, etc. |
| 46 | +- **Wallbox-Steuerung aktivieren**: Optional, wenn Add-on installiert |
46 | 47 |
|
47 | 48 | --- |
48 | 49 |
|
49 | 50 | ## 📦 Installation |
50 | 51 |
|
51 | | -### ✅ Variante 1: Manuell |
52 | | - |
53 | | -1. Kopiere den Ordner `custom_components/enpal_webparser/` in dein Home Assistant `custom_components` Verzeichnis. |
54 | | -2. Starte Home Assistant neu. |
55 | | -3. Gehe zu **Einstellungen → Geräte & Dienste → Integration hinzufügen** und wähle **Enpal Solar**. |
56 | | -4. Gib die URL, das Intervall und gewünschte Gruppen an. |
57 | | - |
58 | | -### 🧩 Variante 2: HACS (empfohlen) |
| 52 | +### 🧩 Variante 1: Installation über HACS (empfohlen) |
59 | 53 |
|
60 | | -[](https://my.home-assistant.io/redirect/hacs_repository/?owner=derolli1976&repository=enpal&category=integration) |
61 | | - |
62 | | ---- |
| 54 | +Diese Integration ist **offiziell in HACS gelistet** – ein manuelles Hinzufügen ist **nicht mehr nötig**. |
63 | 55 |
|
64 | | -## 🚗 Wallbox Add-on (Optional & Experimentell) |
| 56 | +#### Schritt-für-Schritt: |
65 | 57 |
|
66 | | -Zur Steuerung einer Enpal Wallbox ist das folgende Add-on erforderlich: |
67 | | -🔗 [https://github.com/derolli1976/enpal-wallbox-addon](https://github.com/derolli1976/enpal-wallbox-addon) |
| 58 | +1. Öffne **HACS** über die Seitenleiste in Home Assistant |
| 59 | +2. Gib im Suchfeld oben einfach **Enpal Solar** ein |
| 60 | +3. Wähle die Integration aus der Liste aus |
| 61 | +4. Klicke auf **„Installieren“** |
| 62 | +5. Starte Home Assistant neu |
| 63 | +6. Gehe zu **Einstellungen → Geräte & Dienste → Integration hinzufügen** |
| 64 | +7. Suche nach **Enpal Solar** und folge dem Konfigurationsdialog (z. B. URL, Intervall, Sensorgruppen) |
68 | 65 |
|
69 | | -### 🔌 Add-on Installation |
70 | | - |
71 | | -1. Öffne den Home Assistant **Add-on Store** |
72 | | -2. Gehe zu **Repositories** (3-Punkte-Menü oben rechts) |
73 | | -3. Füge folgendes Repository hinzu: |
74 | | - |
75 | | - ``` |
76 | | - https://github.com/derolli1976/enpal-wallbox-addon |
77 | | - ``` |
78 | | - |
79 | | -4. Installiere das Add-on und konfiguriere die IP-Adresse der Enpal Box |
80 | | -5. Starte das Add-on und aktiviere **"Start on boot"** bei Bedarf |
81 | | -6. Aktiviere die Wallbox-Steuerung in der Enpal-Integration |
82 | | - |
83 | | -> ⚠️ Das Feature ist experimentell. Fehler können auftreten. Feedback ist willkommen! |
| 66 | +> 💡 **Hinweis:** Installierte Integrationen erscheinen automatisch unter **Einstellungen → Geräte & Dienste**. Auch Updates und Reparaturhinweise werden dort angezeigt. |
84 | 67 |
|
85 | 68 | --- |
86 | 69 |
|
87 | | -## ❓ FAQ & Hilfe |
| 70 | +### 🛠️ Variante 2: Manuelle Installation |
88 | 71 |
|
89 | | -Antworten auf häufige Fragen findest du hier: |
90 | | -📘 [FAQ – Häufige Fragen zur Enpal Solar Integration](https://github.com/derolli1976/enpal/wiki) |
| 72 | +1. Lade das Repository herunter oder klone es |
| 73 | +2. Kopiere den Ordner `custom_components/enpal_webparser/` in dein Home Assistant `custom_components` Verzeichnis |
| 74 | +3. Starte Home Assistant neu |
| 75 | +4. Füge die Integration wie oben beschrieben hinzu |
91 | 76 |
|
92 | 77 | --- |
93 | 78 |
|
94 | | -## 🐛 Probleme & Feedback |
95 | | - |
96 | | -Bitte eröffne ein GitHub-Issue unter: |
97 | | -👉 [https://github.com/derolli1976/enpal/issues](https://github.com/derolli1976/enpal/issues) |
| 79 | +## 🚗 Wallbox Add-on (Optional & Experimentell) |
98 | 80 |
|
99 | | ---- |
| 81 | +Zur Steuerung einer Enpal Wallbox wird dieses Add-on benötigt: |
| 82 | +🔗 [https://github.com/derolli1976/enpal-wallbox-addon](https://github.com/derolli1976/enpal-wallbox-addon) |
100 | 83 |
|
101 | | -## ⚠️ Disclaimer |
| 84 | +### 🔌 Add-on Installation |
102 | 85 |
|
103 | | -Dieses Projekt steht in **keinerlei Verbindung zur Enpal B.V.** |
104 | | -Es handelt sich um eine **inoffizielle, private Integration**, die auf öffentlich zugänglichen HTML-Daten basiert, die lokal im Netzwerk bereitgestellt werden. |
| 86 | +1. Öffne den **Add-on Store** in Home Assistant |
| 87 | +2. Gehe zum Drei-Punkte-Menü (oben rechts) → **Repositories** |
| 88 | +3. Füge folgendes Repository hinzu: |
105 | 89 |
|
106 | | -Die Nutzung erfolgt auf **eigene Verantwortung**. |
107 | | -Funktionen können durch Firmware- oder UI-Änderungen von Enpal jederzeit beeinträchtigt werden. |
0 commit comments