Diese Custom Integration liest den lokalen Cache der SolarEdge Optimizer Data App und stellt die Messwerte jedes Leistungsoptimierers als Sensoren bereit.

Alle Optimierer werden unter einem gemeinsamen Home-Assistant-Gerät pro SolarEdge-Site zusammengefasst.

Pro Optimierer werden zwei Sensoren angelegt:

Tagesenergie in Wh (total_increasing)
Aktuelle Leistung in W (measurement)

Die Seriennummer bleibt Bestandteil der stabilen Entity-ID. 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

HACS unterstützt keine Gitea-Repositories. Lade deshalb das Archiv der gewünschten Version herunter und entpacke es:

https://git.jensneuber.de/jens/ha-solaredge-optimizers/archive/v0.2.0.zip

Kopiere anschließend den enthaltenen Ordner custom_components/solaredge_optimizers nach /config/custom_components/solaredge_optimizers und starte Home Assistant neu. Eine Installation über HACS ist erst mit einem öffentlichen GitHub-Mirror möglich.

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:

Einstellungen → Geräte & Dienste → Integration hinzufügen öffnen.
Nach SolarEdge Optimizers suchen.
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