97 lines
3.3 KiB
Markdown
97 lines
3.3 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`)
|
|
|
|
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:
|
|
|
|
```text
|
|
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:
|
|
|
|
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.
|
|
|
|
## 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:
|
|
|
|
```json
|
|
{
|
|
"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
|
|
|
|
```shell
|
|
uv sync
|
|
uv run ruff check .
|
|
uv run pytest
|
|
```
|