ha-solaredge-optimizers/README.md

SolarEdge Optimizers for Home Assistant

Diese Custom Integration liest den lokalen Cache der SolarEdge Optimizer Data App 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

uv sync
uv run ruff check .
uv run pytest