Forecast.Solar Smart-Home-Integration, kostenlos und Open Source
Solarertragsprognose für deine PV-Anlage: aktuelle Leistung, Energie heute und morgen.
Veröffentlicht von prohand
- Geräte
- Version 1.4.1
- Erfordert Gladys >=5.1.0
- ★ 0
Diese Integration zeigt in Gladys die Ertragsprognose deiner Solarmodule an, berechnet vom kostenlosen Dienst Forecast.Solar auf Grundlage der Wettervorhersage.
Erfordert Gladys 5.1.0 oder neuer.
Häuser
Der Standort stammt aus den in Gladys eingerichteten Häusern (Einstellungen > Zuhause): Bei der Installation bittet Gladys dich, den Zugriff auf den Standort der Häuser zu erlauben.
- Jedes Haus mit Standort erscheint als Gerät im Tab Entdecken.
- Füge nur die Häuser hinzu, die Solarmodule haben: Nur diese werden abgefragt (keine verschwendete Anfrage).
- Ein Haus ohne Standort erscheint nicht: Lege seinen Standort in Gladys fest und starte dann erneut eine Suche.
Was du erhältst
Für jedes hinzugefügte Haus ein Gerät Solar forecast mit 4 Sensoren:
| Sensor | Einheit | Inhalt |
|---|---|---|
| Estimated power now | W | Geschätzte Leistung im Moment |
| Estimated energy today | kWh | Geschätzte Produktion für den ganzen Tag |
| Estimated energy remaining today | kWh | Geschätzte Produktion bis Tagesende |
| Estimated energy tomorrow | kWh | Geschätzte Produktion für morgen |
Es handelt sich um Prognosen, nicht um Messwerte: Sie werden in der Energieüberwachung von Gladys nicht berücksichtigt.
Konfiguration
- Öffne den Tab Konfiguration der Integration.
- Beschreibe deine Module:
- Neigung: 0° = flach, 90° = senkrecht (auf einem Dach oft 30 bis 35°);
- Ausrichtung: 0° = Süden, -90° = Osten, 90° = Westen, 180° = Norden;
- Spitzenleistung in Wp, ganze Zahl (z. B. 3000 für 3 kWp; steht in deinem Vertrag oder auf dem Wechselrichter).
- Der API-Schlüssel ist optional: Lass ihn für den kostenlosen Tarif leer.
- Speichere und füge dann das Gerät deines Hauses über den Tab Entdecken hinzu.
Diese Einstellungen gelten für alle hinzugefügten Häuser.
Die Schaltfläche Prognose jetzt aktualisieren lädt die Prognose sofort herunter und zeigt eine Zusammenfassung für heute und morgen an.
Dashboard-Widgets
| Widget | Inhalt |
|---|---|
| Solarprognose | Aktuelle Leistung, Energie heute / Rest / morgen, Leistungskurve, Spitze |
| Bester Solar-Zeitraum | Bester Zeitpunkt für ein Gerät mit N Stunden Laufzeit, heute und morgen |
Wähle im Widget das Gerät (das Haus) und für den besten Zeitraum die Laufzeit des Geräts (Waschmaschine 2 h, Geschirrspüler 3 h…).
Szenen
Auslöser
| Auslöser | Wann |
|---|---|
| Solarprognose aktualisiert | Jedes Mal, wenn eine neue Prognose heruntergeladen wird |
| Beginn der Solarproduktion | Geschätzter Produktionsbeginn (Sonnenaufgang) |
| Spitze der Solarproduktion | Geschätzte Produktionsspitze des Tages |
| Ende der Solarproduktion | Geschätztes Produktionsende (Sonnenuntergang) |
Optionaler Filter auf das Haus (leer = alle). Für die folgenden Aktionen verfügbare Variablen: Haus, aktuelle Leistung, Energie heute, Rest, morgen, Spitzenleistung und Uhrzeit der Spitze.
Für einen Schwellenwert („wenn morgen > 10 kWh“) verwende den Standardauslöser „Änderung von Gerätestatus“ von Gladys auf dem Sensor „Estimated energy tomorrow“.
Aktionen
| Aktion | Parameter | Ergebnisse |
|---|---|---|
| Solarprognose lesen | Haus | Leistung, Energie heute / Rest / morgen, Spitze |
| Solarproduktion der nächsten Stunden | Haus, Stunden | Energie (kWh), durchschnittliche und maximale Leistung (W) |
| Besten Solar-Zeitraum finden | Haus, Dauer, Tag | gefunden, Start- / Endzeit, Energie, Minuten bis zum Start |
Beispiel: jeden Morgen um 8 Uhr „Besten Solar-Zeitraum finden“ (2 h, heute), dann „Minuten bis zum Start“ abwarten und die Waschmaschine starten.
Funktionsweise
- Die Prognose wird standardmäßig alle 60 Minuten heruntergeladen (15 bis 1440 Minuten), pro hinzugefügtem Haus.
- Der kostenlose Tarif erlaubt 12 Anfragen pro Stunde und IP-Adresse, für alle deine Häuser zusammen. Bei mehreren Häusern wird das Intervall automatisch verlängert, sodass sie nie mehr als 10 Anfragen pro Stunde stellen (3 Häuser: höchstens alle 20 Minuten, 4 oder 5 Häuser: alle 30 Minuten, 6 bis 10 Häuser: jede Stunde); das konfigurierte Intervall bleibt das Minimum.
- Bei einem Fehler versucht es die Integration 15 Minuten später erneut und behält die letzte bekannte Prognose. Ist das Limit erreicht, wartet sie bis zu der von Forecast.Solar genannten Uhrzeit, bevor sie eine neue Anfrage stellt.
- Die Schaltfläche Prognose jetzt aktualisieren lädt die Prognose erneut herunter, es sei denn, sie wurde vor weniger als 5 Minuten heruntergeladen.
- Zwischen zwei Downloads werden die Werte alle 5 Minuten neu berechnet (die Leistung folgt dem Sonnenverlauf) und veröffentlicht, wenn sie sich ändern, mindestens aber alle 30 Minuten, um den Verlauf klein zu halten.
- Nach dem letzten Punkt der Prognose (Sonnenuntergang morgen) wird die geschätzte Leistung nicht mehr veröffentlicht, wenn keine neue Prognose heruntergeladen werden konnte: Sie ist unbekannt, nicht 0 W.
- Die Häuser werden bei jedem Start, bei jeder Suche und jede Stunde neu gelesen (nach einem Fehler eine Minute später).
- Eine Modulfläche pro Haus. Gib bei einer Ost-/West-Anlage die Ausrichtung und die Spitzenleistung der Hauptfläche ein.
Fehlerbehebung
- „Konfiguration unvollständig oder ungültig“: Ein Pflichtfeld ist leer oder außerhalb des zulässigen Bereichs (der Feldname wird angegeben).
- „Kein Haus mit Standort“: Lege den Standort eines Hauses unter Einstellungen > Zuhause fest.
- „Anfragelimit von Forecast.Solar erreicht“: zu viele Anfragen von deiner IP-Adresse (vielleicht nutzt ein anderes Tool ebenfalls Forecast.Solar). Erhöhe das Aktualisierungsintervall.
- Für Details lies die Protokolle der Integration in Gladys (oder
docker logsauf dem Host) mitLOG_LEVEL=debug. Die Koordinaten deiner Häuser und dein API-Schlüssel werden in den protokollierten Anfragen maskiert (***).
Konfigurationseinstellungen
Diese Einstellungen fragt Forecast.Solar in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Erste Schritte | section | Nein | Die Prognose nutzt den Standort deiner Häuser in Gladys (Einstellungen > Zuhause): ein Gerät pro Haus mit Standort, füge nur die mit Solarmodulen hinzu. Beschreibe anschließend unten die Module. Kostenloser Tarif: kein Konto, 12 Anfragen pro Stunde. |
| Neigung (°) | number | Ja | Neigungswinkel der Module: 0 = flach, 90 = senkrecht. |
| Ausrichtung (°) | number | Ja | Himmelsrichtung der Module: 0 = Süden, -90 = Osten, 90 = Westen, 180 = Norden. |
| Spitzenleistung (Wp) | number | Ja | Installierte Spitzenleistung der Module in Watt-Peak (ganze Zahl), z. B. 3000 für 3 kWp oder 6200 für 6,2 kWp. |
| API-Schlüssel (optional) | secret | Nein | Für den kostenlosen Tarif leer lassen. |
| Aktualisierungsintervall der Prognose (min) | number | Nein | Wie oft die Prognose neu heruntergeladen wird. Die in Gladys angezeigten Werte werden trotzdem alle 5 Minuten aktualisiert. |
So installierst du Forecast.Solar in Gladys
- Öffne in Gladys Integrationen: Forecast.Solar erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/prohand/gladys-forecastsolar:1.4.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/prohand/gladys-forecastsolar.
Forecast.Solar benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Forecast.Solar ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von prohand veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation