# SolarEdge Optimizer Apps

Home-Assistant-App-Repository für den browserlosen Abruf von Optimierer-Daten
aus dem SolarEdge Monitoring Portal.

## In Home Assistant installieren

Voraussetzung ist Home Assistant OS.

1. Öffne **Einstellungen → Apps → App Store**.
2. Öffne oben rechts **⋮ → Repositories**.
3. Füge diese Repository-URL hinzu:

   ```text
   https://git.jensneuber.de/jens/solaredge-optimizers
   ```

4. Installiere **SolarEdge Optimizer Data**.
5. Hinterlege im Tab **Konfiguration** Benutzername, Passwort und Site-ID.
6. Speichere die Konfiguration und starte die App.

Ab App-Version 0.2.0 meldet sich die App automatisch bei Home Assistant. Mit
der Custom Integration aus
`https://git.jensneuber.de/jens/ha-solaredge-optimizers` werden daraus Geräte
und Sensoren für Tagesenergie und aktuelle Leistung jedes Optimierers.

## SolarEdge Optimizer Data

Die App aktualisiert standardmäßig alle zehn Minuten und liefert für jedes
Modul beziehungsweise jeden Optimierer:

- logische ID, zum Beispiel `1.1.1`
- Seriennummer
- heutige Energie in Wh
- aktuelle Leistung in W
- Zeitpunkt der letzten Telemetrie

Die Daten sind über Home Assistant Ingress und intern unter
`GET /api/optimizers` verfügbar. Details stehen in
[`solaredge-optimizer-data/DOCS.md`](solaredge-optimizer-data/DOCS.md).

Das zur App-Version passende Multi-Arch-Image wird von
`git.jensneuber.de/jens/solaredgeoptimizers` geladen. Unterstützt werden
`amd64` und `aarch64`.

## Entwicklung

```sh
bun install --frozen-lockfile
bun run typecheck
bun run test
bun run build
```

Das erzeugte `solaredge-optimizer-data/dist/server.js` ist ein eigenständiges
Bun-Bundle und wird vom Docker-Image direkt ausgeführt.

> Die Optimierer-Endpunkte sind interne, nicht offiziell dokumentierte
> SolarEdge-Portal-Endpunkte und können sich ohne Ankündigung ändern.