# 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
```