Add SolarEdge Optimizers Home Assistant integration

README.md

@@ -0,0 +1,62 @@
+# 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
+```
+