SolarEdge Optimizers for Home Assistant

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)

Zusätzlich können Optimierer zu Dachflächen zusammengefasst werden. Pro Fläche entstehen zwei weitere Sensoren mit der Summe aller vollständig verfügbaren Optimiererwerte:

Fläche Tagesenergie in Wh
Fläche aktuelle Leistung in W

Die von SolarEdge gelieferten Strings wie 1.1 und 1.2 werden automatisch erkannt. Auch für jeden String entstehen Sensoren für die summierte Tagesenergie und aktuelle Leistung. Eine manuelle Zuordnung ist dafür nicht notwendig.

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.4.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.

Flächen konfigurieren

Öffne die Integration unter Einstellungen → Geräte & Dienste und wähle Konfigurieren. Die Flächen-Zuordnung ist ein JSON-Objekt, dessen Schlüssel die Flächennamen und dessen Werte Listen von Optimizer-IDs sind:

{
  "west1": ["1.1.1", "1.1.2"],
  "süd": ["1.1.15", "1.1.16"]
}

Ein Optimierer darf nur einer Fläche zugeordnet sein. Unbekannte IDs und leere Flächen werden beim Speichern abgewiesen. Für Site 4886699 sind west1, west2, gaube, süd, ost1 und ost2 bereits als Startwert hinterlegt. Mit {} können alle Flächensensoren deaktiviert werden.

Entwicklung

uv sync
uv run ruff check .
uv run pytest

3.3 KiB Raw Permalink Blame History