67 lines
2.2 KiB
Markdown
67 lines
2.2 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 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:
|
|
|
|
```text
|
|
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:
|
|
|
|
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
|
|
```
|