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 HomeServer
- Version
- 0.1.0
- Lizenz
- Ein Schlüssel je HomeServer (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
Besonderheiten beim HomeServer
- Die Vorausschau hat immer 12 Ausgänge „Leistung in n Std.“, es gibt keinen Parameter „Anzahl Stunden Vorausschau“.
- HTTPS läuft direkt über Python (
urllib2), nicht über curl. Die Prüfung der zweiten Ebene ohne API-Key erfolgt beim Trigger (Meldung unter „Debug“), nicht im Editor.
- Statt Parametern gibt es Eingänge mit Startwert. Auswahllisten des X1 sind Zahlen, Ja/Nein-Werte sind
0und1. - Der Lizenzschlüssel ist der letzte Text-Eingang. Ein neuer Wert an diesem Eingang wird sofort geprüft.
- Eine Prüfung des Schlüssels im Editor und eine Simulation gibt es nicht, der HomeServer prüft immer.
Funktionen und Anschlüsse
Logikbaustein von SMoLabs für die PV-Ertragsprognose von Forecast.Solar (https://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 steuern. Der öffentliche Tarif braucht weder Konto noch API-Key.
Die Prognose rechnet für eine Dachfläche (Ebene) mit Standort, Neigung, Ausrichtung und Leistung. Eine zweite Ebene ist nur mit dem Personal-Tarif (API-Key) möglich.
Abruf: Forecast.Solar aktualisiert höchstens alle 15 Minuten, der öffentliche Tarif erlaubt 12 Abrufe je Stunde. Der Baustein ruft deshalb höchstens alle 15 Minuten ab und rechnet bei jedem weiteren Trigger die Ausgänge aus dem Zwischenspeicher neu. Beim Tageswechsel am Anlagenort wird sofort neu abgerufen. Alle Zeiten der Antwort sind Ortszeit der Anlage. Bei Fehlern bleiben Zwischenspeicher und Ausgänge auf dem letzten Stand, der Grund steht unter „Debug“.
Eingänge
| Nr. | Name | Init | Bedeutung |
|---|---|---|---|
| 1 | E1 Trigger | 0 | Ungleich 0: rechnet die Ausgänge neu und ruft bei Bedarf die Prognose ab (höchstens alle 15 Minuten, sonst aus dem Zwischenspeicher). |
| 2 | E2 Breitengrad | 52.521 | Standort der Anlage, -90 bis 90. Vorgabe 52.521 (Berlin), unbedingt auf den eigenen Standort ändern. |
| 3 | E3 Längengrad | 13.438 | Standort der Anlage, -180 bis 180. Vorgabe 13.438 (Berlin). |
| 4 | E4 Neigung in Grad (0 = flach, 90 = senkrecht) | 30 | 0 bis 90, Vorgabe 30. 0 = flach, 90 = senkrecht. |
| 5 | E5 Ausrichtung in Grad (0 = Süd, -90 = Ost, 90 = West) | 0 | -180 bis 180, Vorgabe 0. 0 = Süd, -90 = Ost, 90 = West, 180 oder -180 = Nord. |
| 6 | E6 Anlagenleistung in kWp | 5 | Modulleistung dieser Ebene in kWp, 0,1 bis 1000, Vorgabe 5. |
| 7 | E7 API-Key (optional, Personal-Tarif von forecast.solar) | „“ | Nur für den Personal-Tarif von Forecast.Solar. Den Key nicht veröffentlichen. Leer = öffentlicher Tarif. |
| 8 | E8 Ebene 2: Neigung in Grad (nur mit API-Key) | 30 | Zweite Ebene, nur mit API-Key. Vorgabe 30. |
| 9 | E9 Ebene 2: Ausrichtung in Grad (nur mit API-Key) | 0 | Zweite Ebene, nur mit API-Key. Vorgabe 0. |
| 10 | E10 Ebene 2: Anlagenleistung in kWp (0 = keine zweite Ebene) | 0 | Zweite Ebene in kWp, 0 = keine zweite Ebene. Braucht einen API-Key. |
| 11 | E11 Lizenzschlüssel | „“ | Lizenzschlüssel für diesen HomeServer (von smolabs.de). Ohne gültigen Schlüssel bleibt der Baustein untätig. |
Ausgänge
| Nr. | Name | Init | Bedeutung |
|---|---|---|---|
| 1 | A1 Leistung jetzt in W | 0 | Erwartete PV-Leistung zur aktuellen Ortszeit der Anlage. |
| 2 | A2 Ertrag heute in kWh | 0 | Erwarteter Tagesertrag in kWh. |
| 3 | A3 Restertrag heute in kWh | 0 | Erwarteter Ertrag von jetzt bis Sonnenuntergang in kWh. |
| 4 | A4 Ertrag morgen in kWh | 0 | Erwarteter Ertrag des nächsten Tages in kWh. |
| 5 | A5 Spitzenleistung heute in W | 0 | Höchster Prognosewert heute in W. |
| 6 | A6 Spitze heute um | „“ | Uhrzeit der Spitze heute, HH:mm. |
| 7 | A7 Spitzenleistung morgen in W | 0 | Höchster Prognosewert morgen in W. |
| 8 | A8 Spitze morgen um | „“ | Uhrzeit der Spitze morgen, HH:mm. |
| 9 | A9 Leistung in 1 Std. in W | 0 | Prognose für jetzt plus 1 Stunde in W. |
| 10 | A10 Leistung in 2 Std. in W | 0 | Prognose für jetzt plus 2 Stunden in W. |
| 11 | A11 Leistung in 3 Std. in W | 0 | Prognose für jetzt plus 3 Stunden in W. |
| 12 | A12 Leistung in 4 Std. in W | 0 | Prognose für jetzt plus 4 Stunden in W. |
| 13 | A13 Leistung in 5 Std. in W | 0 | Prognose für jetzt plus 5 Stunden in W. |
| 14 | A14 Leistung in 6 Std. in W | 0 | Prognose für jetzt plus 6 Stunden in W. |
| 15 | A15 Leistung in 7 Std. in W | 0 | Prognose für jetzt plus 7 Stunden in W. |
| 16 | A16 Leistung in 8 Std. in W | 0 | Prognose für jetzt plus 8 Stunden in W. |
| 17 | A17 Leistung in 9 Std. in W | 0 | Prognose für jetzt plus 9 Stunden in W. |
| 18 | A18 Leistung in 10 Std. in W | 0 | Prognose für jetzt plus 10 Stunden in W. |
| 19 | A19 Leistung in 11 Std. in W | 0 | Prognose für jetzt plus 11 Stunden in W. |
| 20 | A20 Leistung in 12 Std. in W | 0 | Prognose für jetzt plus 12 Stunden in W. |
| 21 | A21 Verbleibende Abfragen | 0 | Rest des Abfragekontingents laut Forecast.Solar (Zeitraum 60 Minuten). |
| 22 | A22 Letzte Abfrage | „“ | Zeit des letzten erfolgreichen Abrufs (deutsche Zeit), TT.MM.JJJJ HH:mm:ss. |
| 23 | A23 JSON | „“ | 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″}} |
| 24 | A24 Lizenzstatus | „“ | Ergebnis der Lizenzprüfung, z. B. „Lizenz gültig (2026-000123)“. |
| 25 | A25 Debug | „“ | Ergebnis bzw. Fehler der letzten Abfrage, „Zwischenspeicher, nächster Abruf in n Min“ bei einem Trigger ohne neuen Abruf. |
Lizenz
Der Lizenzschlüssel wird am letzten Text-Eingang des Bausteins eingetragen. Der Baustein prüft ihn auf dem HomeServer, offline und gebunden an die MAC-Adresse des HomeServers. Der Ausgang „Lizenzstatus“ zeigt das Ergebnis, bei einem Schlüssel für ein anderes Gerät auch die MAC-Adresse dieses HomeServers. Ohne gültigen Schlüssel bleibt der Baustein untätig. Den Schlüssel erhältst du beim Kauf über smolabs.de. Ein Schlüssel für den X1 schaltet keinen HomeServer-Baustein frei und umgekehrt.
Changelog
Version 0.1.0
- Erste Version für den HomeServer auf Basis der X1-Bausteine | SMoLabs.
Rezensionen
Es gibt noch keine Rezensionen.