63 lines
2.1 KiB
Markdown
63 lines
2.1 KiB
Markdown
# SolarEdge Optimizers for Home Assistant
|
|
|
|
Diese Custom Integration liest den lokalen Cache der
|
|
[SolarEdge Optimizer Data App](https://git.jensneuber.de/jens/solaredge-optimizers)
|
|
und stellt jeden Leistungsoptimierer als eigenes Home-Assistant-Gerät bereit.
|
|
|
|
Pro Optimierer werden zwei Sensoren angelegt:
|
|
|
|
- **Tagesenergie** in Wh (`total_increasing`)
|
|
- **Aktuelle Leistung** in W (`measurement`)
|
|
|
|
Die Seriennummer bleibt die stabile Gerätekennung. Optimierer-ID, String-ID,
|
|
Wechselrichter-ID und Zeitpunkt der letzten Messung stehen als Attribute zur
|
|
Verfügung.
|
|
|
|
## Voraussetzungen
|
|
|
|
- Home Assistant 2026.6 oder neuer
|
|
- SolarEdge Optimizer Data App 0.2.0 oder neuer
|
|
- eine laufende und konfigurierte App mit bereits verfügbaren Optimizer-Daten
|
|
|
|
Die SolarEdge-Zugangsdaten bleiben ausschließlich in der App-Konfiguration.
|
|
Die Integration spricht nur mit der lokalen App-API.
|
|
|
|
## Installation mit HACS
|
|
|
|
1. In HACS **Integrationen** öffnen.
|
|
2. Über das Menü **Benutzerdefinierte Repositories** öffnen.
|
|
3. `https://git.jensneuber.de/jens/ha-solaredge-optimizers` als Typ
|
|
**Integration** hinzufügen.
|
|
4. **SolarEdge Optimizers** installieren.
|
|
5. Home Assistant neu starten.
|
|
|
|
Alternativ den Ordner `custom_components/solaredge_optimizers` nach
|
|
`/config/custom_components/solaredge_optimizers` kopieren und Home Assistant
|
|
neu starten.
|
|
|
|
## Einrichtung
|
|
|
|
Bei Home Assistant OS/Supervised meldet sich die App automatisch bei Home
|
|
Assistant. Unter **Einstellungen → Geräte & Dienste** erscheint anschließend
|
|
eine gefundene Integration **SolarEdge Optimizers**, die nur noch bestätigt
|
|
werden muss.
|
|
|
|
Falls keine automatische Erkennung verfügbar ist:
|
|
|
|
1. **Einstellungen → Geräte & Dienste → Integration hinzufügen** öffnen.
|
|
2. Nach **SolarEdge Optimizers** suchen.
|
|
3. Die Basis-URL der App eintragen, beispielsweise `http://host:8099`.
|
|
|
|
Die Integration liest den Cache standardmäßig alle 600 Sekunden. Dieser Wert
|
|
kann über **Neu konfigurieren** geändert werden. Dadurch entstehen keine
|
|
zusätzlichen SolarEdge-Portalabrufe; diese steuert die App selbst.
|
|
|
|
## Entwicklung
|
|
|
|
```shell
|
|
uv sync
|
|
uv run ruff check .
|
|
uv run pytest
|
|
```
|
|
|