60 lines
1.8 KiB
Markdown
60 lines
1.8 KiB
Markdown
# 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.
|