Skip to content

Commit b276b5e

Browse files
authored
Merge pull request #39 from derolli1976/derolli1976-patch-2
Update README.md
2 parents 1bd6751 + c01f953 commit b276b5e

1 file changed

Lines changed: 40 additions & 58 deletions

File tree

README.md

Lines changed: 40 additions & 58 deletions
Original file line numberDiff line numberDiff line change
@@ -4,104 +4,86 @@
44

55
# Enpal Solar – Home Assistant Integration
66

7-
[![hacs_badge](https://img.shields.io/badge/HACS-Custom-41BDF5.svg)](https://github.com/hacs/integration)
7+
[![hacs_badge](https://img.shields.io/badge/HACS-Default-41BDF5.svg)](https://github.com/hacs/integration)
88
[![HACS installs](https://img.shields.io/badge/dynamic/json?color=41BDF5&logo=home-assistant&label=integration%20usage&suffix=%20installs&cacheSeconds=15600&url=https://analytics.home-assistant.io/custom_integrations.json&query=$.enpal_webparser.total)](https://github.com/derolli1976/enpal)
99
[![GitHub release](https://img.shields.io/github/release/derolli1976/enpal.svg)](https://github.com/derolli1976/enpal/releases)
10-
11-
10+
[![hacs_install](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=derolli1976&repository=enpal&category=integration)
1211

1312
<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>
1413

1514
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).
1716

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:
2019

21-
![Enpal Box Webseite](./images/enpal_box_webseite.png)
20+
<p align="left">
21+
<img src="./images/enpal_box_webseite.png" alt="Enpal Box Webseite" width="600"/>
22+
</p>
2223

2324
---
2425

2526
## 🔧 Funktionen
2627

2728
- Liest Messwerte aus HTML-Tabellen auf der lokalen Enpal-Geräteseite
2829
- 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
3132
- 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
3536

3637
---
3738

3839
## ⚙️ Konfiguration
3940

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:
4142

4243
- **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
4647

4748
---
4849

4950
## 📦 Installation
5051

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)
5953

60-
[![hacs_install](https://my.home-assistant.io/badges/hacs_repository.svg)](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**.
6355

64-
## 🚗 Wallbox Add-on (Optional & Experimentell)
56+
#### Schritt-für-Schritt:
6557

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)
6865

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.
8467
8568
---
8669

87-
## ❓ FAQ & Hilfe
70+
### 🛠️ Variante 2: Manuelle Installation
8871

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
9176

9277
---
9378

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)
9880

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)
10083

101-
## ⚠️ Disclaimer
84+
### 🔌 Add-on Installation
10285

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:
10589

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

Comments
 (0)