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