Beschreibung
Logikbaustein für die PV-Ertragsprognose von Forecast.Solar. Er liefert die Leistung jetzt, den Ertrag heute (gesamt und noch zu erwarten) und morgen, die Spitzenleistung und die Leistung der nächsten Stunden. Damit lassen sich z. B. Heizstab, Pool oder Wärmepumpe vorausschauend planen, passend zu [PV-Überschuss | SMoLabs](PvUeberschussSMoLabs.md).
Der öffentliche Tarif von Forecast.Solar braucht weder Konto noch API-Key.
- Gerät
- Gira X1
- Version
- 1.0.0
- Lizenz
- Ein Schlüssel je X1 (MAC-Adresse), dauerhaft nutzbar
- Thema
- Energie
Hinweis zur Schnittstelle: Der Baustein nutzt die Schnittstelle von forecast.solar. Ändert der Anbieter sie oder stellt sie ein, kann der Baustein eingeschränkt oder gar nicht mehr funktionieren, bis er angepasst ist. Wir passen ihn nach Möglichkeit an, einen Anspruch darauf gibt es nicht.
Anleitung
Standort und Anlage
Die Prognose rechnet für eine Dachfläche (Ebene) mit Standort, Neigung, Ausrichtung und Leistung:
| Angabe | Bedeutung |
|---|---|
| Breitengrad, Längengrad | Standort der Anlage, z. B. 52.521 / 13.438. Das ist auch die Vorgabe (Berlin), unbedingt auf den eigenen Standort ändern |
| Neigung | 0 = flach, 90 = senkrecht |
| Ausrichtung | 0 = Süd, -90 = Ost, 90 = West, 180 oder -180 = Nord |
| Anlagenleistung | Modulleistung dieser Ebene in kWp |
Mit einem Personal-Tarif von Forecast.Solar (API-Key) lässt sich eine zweite Ebene (z. B. Ost/West-Anlage) angeben. Sie wird in derselben Anfrage berechnet, die Ausgänge zeigen die Summe beider Ebenen.
Abfrageintervall
Abgefragt wird, wenn der Eingang „Trigger“ den Wert 1 bekommt. Forecast.Solar aktualisiert die Prognose frühestens alle 15 Minuten, der öffentliche Tarif erlaubt 12 Abfragen je Stunde und IP-Adresse. Der Baustein hält deshalb die letzte Antwort im Speicher:
- Ein neuer Abruf erfolgt beim ersten Trigger, danach höchstens alle 15 Minuten und zusätzlich sofort nach dem Tageswechsel am Anlagenort.
- Jeder weitere Trigger rechnet die Ausgänge aus dem Speicher neu. Man kann also z. B. jede Minute triggern, damit „Leistung jetzt“ gleichmäßig nachläuft, und verbraucht trotzdem nur 4 Abfragen je Stunde.
- Schlägt ein Abruf fehl, versucht der Baustein es frühestens nach weiteren 15 Minuten, auch nach dem Tageswechsel. Bis dahin gelten die zuletzt geladenen Werte.
Forecast.Solar liefert Prognosewerte zu einzelnen Zeitpunkten (etwa stündlich). „Leistung jetzt“ und die Leistung der folgenden Stunden werden dazwischen gleichmäßig (linear) berechnet. Vor dem ersten Wert des Tages ist die Leistung 0, über Nacht gilt der letzte Wert des Vortags (0 W). Die Zeiten der Prognose und der Spitzen sind Ortszeit der Anlage.
Parameter
| Parameter | Bedeutung |
|---|---|
| Breitengrad, Längengrad | Standort, -90 bis 90 bzw. -180 bis 180. Vorgabe 52.521 / 13.438 (Berlin) |
| Neigung in Grad (0 = flach, 90 = senkrecht) | 0 bis 90, Vorgabe 30 |
| Ausrichtung in Grad (0 = Süd, -90 = Ost, 90 = West) | -180 bis 180, Vorgabe 0 |
| Anlagenleistung in kWp | 0,1 bis 1000, Vorgabe 5 |
| API-Key (optional, Personal-Tarif von forecast.solar) (ausgeblendet) | Nur für den Personal-Tarif von Forecast.Solar. Den Key nicht veröffentlichen. |
| Ebene 2: Neigung in Grad (nur mit API-Key), Ebene 2: Ausrichtung in Grad (nur mit API-Key), Ebene 2: Anlagenleistung in kWp (0 = keine zweite Ebene) (ausgeblendet) | Zweite Ebene, nur mit API-Key. Vorgabe 30 / 0 / 0 |
| Anzahl Stunden Vorausschau | 1 bis 12, Vorgabe 3. So viele Ausgänge „Leistung in i Std. in W“ gibt es |
| Lizenzschlüssel | Schlüssel für diesen X1, siehe „Lizenz“ |
Eine zweite Ebene ohne API-Key meldet die Projektprüfung im GPA (Gira Projekt Assistent) als Fehler.
Ausgänge
| Ausgang | Bedeutung |
|---|---|
| Leistung jetzt in W | Erwartete PV-Leistung zur aktuellen Ortszeit |
| Ertrag heute in kWh | Erwarteter Tagesertrag |
| Restertrag heute in kWh | Erwarteter Ertrag von jetzt bis Sonnenuntergang |
| Ertrag morgen in kWh | Erwarteter Ertrag des nächsten Tages |
| Spitzenleistung heute in W, Spitzenleistung morgen in W (ausgeblendet) | Höchster Prognosewert des Tages |
| Spitze heute um, Spitze morgen um (ausgeblendet) | Uhrzeit der Spitze, HH:mm |
| Leistung in i Std. in W | Prognose für jetzt plus i Stunden |
| Verbleibende Abfragen (ausgeblendet) | Rest des Abfragekontingents laut Forecast.Solar (Zeitraum 60 Minuten) |
| Letzte Abfrage (ausgeblendet) | Zeit des letzten erfolgreichen Abrufs, TT.MM.JJJJ HH:mm:ss, in der Zeitzone des X1 |
| JSON (ausgeblendet) | Zusammenfassung, z. B. {"jetzt_w":602,"heute":{"kwh":4.199,"rest_kwh":2.4,"spitze_w":686,"spitze_um":"13:00"},"morgen":{"kwh":4.364,"spitze_w":784,"spitze_um":"13:00"}} |
| Lizenzstatus, Debug | Lizenzprüfung, Ergebnis bzw. Fehler der letzten Abfrage |
Ausgeblendete Parameter und Ausgänge lassen sich im GPA am Baustein einblenden.
Fehlerverhalten: Bei Verbindungsproblemen, Wartung (HTTP 503), erreichtem Limit (HTTP 429) oder abgelehnten Angaben (HTTP 400/422) bleiben die Ausgänge auf dem letzten Stand, der Grund steht unter „Debug“.
Hinweise
- Forecast.Solar rechnet mit Wetterdaten, die Prognose ist eine Schätzung. Im öffentlichen Tarif fließt kein lokales Wetter ein.
- Das Abfragekontingent gilt je IP-Adresse. Mehrere Geräte hinter demselben Internetanschluss teilen es sich.
- Zu Beginn jedes Quartals gibt es ein Wartungsfenster um Mitternacht UTC (laut Dokumentation am 1. des Monats).
Datenquelle
Die Daten kommen von Forecast.Solar, es gelten deren Nutzungsbedingungen. Wer die Prognose in einer Visualisierung zeigt, nennt forecast.solar als Quelle.
Lizenz
Der Lizenzschlüssel wird im GPA im Parameter „Lizenzschlüssel“ eingetragen. Der Baustein prüft ihn beim Start auf dem X1, offline und gebunden an die MAC-Adresse des X1. Der Ausgang „Lizenzstatus“ zeigt das Ergebnis, bei einem Schlüssel für ein anderes Gerät auch die MAC-Adresse dieses X1. Ohne gültigen Schlüssel fragt der Baustein nichts ab. In der Simulation des GPA am PC läuft er ohne Lizenzprüfung, damit sich Logikblätter testen lassen.
Läuft eine Testlizenz ab, ignoriert der Baustein ab dem nächsten Trigger alle Abfragen, bis ein neuer Schlüssel eingetragen ist. Die Ausgänge bleiben auf dem letzten Stand. Den Schlüssel erhältst du beim Kauf über smolabs.de.
Changelog
Version 1.0.0
- Erste Version.
Rezensionen
Es gibt noch keine Rezensionen.