Getting started – Benutzerhandbuch
Open-Meteo Wetter – Benutzerhandbuch
1. Was zeigt der Baustein an?
Open-Meteo Wetter bringt aktuelle Wetterdaten und eine Vorhersage in Ihre Gira-Visualisierung. Je nach Einrichtung sehen Sie:
- aktuelle und gefühlte Temperatur,
- Tagesminimum und Tagesmaximum,
- Luftfeuchtigkeit, Luftdruck und Bewölkung,
- Windgeschwindigkeit, Böen und Windrichtung,
- Regen, Schnee und Niederschlagswahrscheinlichkeit,
- UV-Index sowie Sonnenauf- und -untergang,
- Stunden- und Acht-Tage-Vorhersagen,
- optional eine PV-Ertragsprognose für bis zu vier Dachflächen.
Die Werte stammen von Open-Meteo und sind Wettermodell- bzw. Prognosedaten. Sie können von einem lokalen Außensensor abweichen.
2. Beispiel einer aktuellen Wetteranzeige
Eine kompakte Ausgabe kann so aussehen:
💧0 | ☁46% | 13.3°C | 🌬7.6km/h
| Teil | Bedeutung |
|---|---|
💧0 |
aktuell kein gemeldeter Regen |
☁46% |
46 % Bewölkung |
13.3°C |
aktuelle Temperatur |
🌬7.6km/h |
aktuelle Windgeschwindigkeit |
Weitere mögliche Beispielwerte:
| Anzeige | Beispiel | Erklärung |
|---|---|---|
| Gefühlte Temperatur | 12,1 °C |
Temperaturwirkung auf den Menschen unter Berücksichtigung des Wetters. |
| Luftfeuchtigkeit | 80 % |
Relative Feuchtigkeit der Außenluft. |
| Luftdruck | 1019 hPa |
Auf Meereshöhe umgerechneter Luftdruck. |
| UV-Index | 0,3 |
Sehr geringe UV-Belastung. |
| Windrichtung | 273° / W |
Wind kommt ungefähr aus Westen. |
| Böen | 5,3 m/s |
Kurzzeitige maximale Windgeschwindigkeit. |
3. Bedeutung wichtiger Wetterwerte
Temperatur und gefühlte Temperatur
Die aktuelle Temperatur wird in der eingestellten Einheit angezeigt. Die gefühlte Temperatur kann beispielsweise bei Wind unter der tatsächlichen Lufttemperatur liegen.
Temperatur: 5,0 °C
Gefühlte Temperatur: 1,8 °C
Niederschlagswahrscheinlichkeit
Die Wahrscheinlichkeit beschreibt, wie wahrscheinlich Niederschlag für den betreffenden Ort und Zeitraum ist. Sie beschreibt nicht die Regenmenge.
Niederschlagswahrscheinlichkeit: 70 %
Regenmenge: 0,8 mm
Bewölkung
| Wert | Typische Interpretation |
|---|---|
| 0–10 % | klar |
| 11–30 % | überwiegend klar |
| 31–70 % | teilweise bewölkt |
| 71–90 % | stark bewölkt |
| 91–100 % | bedeckt |
Wind
Der Baustein stellt Wind in m/s und km/h bereit. Für eine alltagstaugliche Anzeige wird meist km/h verwendet.
Wind: 4,0 m/s = 14,4 km/h
Böen: 7,5 m/s = 27,0 km/h
Die Kompassangabe N, NO, O, SO, S, SW, W oder NW erleichtert die Lesbarkeit.
UV-Index
| UV-Index | Einordnung | Empfehlung |
|---|---|---|
| 0–2 | niedrig | normaler Aufenthalt im Freien |
| 3–5 | mittel | bei längerer Exposition Sonnenschutz verwenden |
| 6–7 | hoch | Haut und Augen schützen |
| 8–10 | sehr hoch | intensive Mittagssonne meiden |
| 11+ | extrem | besonderen Schutz beachten |
4. Vorhersagen
Der Baustein liefert kurzfristige Ausgaben für ungefähr +3, +6, +12, +24 und +48 Stunden sowie Tageswerte von heute bis Tag 7.
+3h: 15 °C, teilweise bewölkt
+12h: 11 °C, leichter Regen
Heute: 12–18 °C
Morgen: 10–20 °C
Je weiter ein Prognosezeitpunkt in der Zukunft liegt, desto größer ist die mögliche Abweichung.
5. Sonne, Mond und Warnmeldungen
Sonnenaufgang und Sonnenuntergang werden für den eingestellten Standort übernommen.
Sonnenaufgang: 05:38
Sonnenuntergang: 21:14
Die Felder Mondaufgang und Monduntergang werden von der aktuellen Datenabfrage nicht versorgt. Eventuell sichtbare Anfangszeiten sind keine echten Monddaten. Auch amtliche Unwetterwarnungen sind derzeit nicht Bestandteil des Abrufs.
6. PV-Ertragsprognose
Wenn Ihr Administrator die PV-Prognose eingerichtet hat, sehen Sie eine Schätzung der aktuellen Leistung und der zu erwartenden Energie.
Beispiel für eine Anlage mit 24 Modulen à 410 Wp:
Installierte Leistung: 9,84 kWp
Aktuelle Einstrahlung: 680 W/m²
Aktuelle PV-Leistung: 6.120 W
Ertrag heute: 38,20 kWh
Ertrag morgen: 31,60 kWh
Eine Zusammenfassung kann so aussehen:
PV Gesamt | 9.84 kWp | heute 38.20 kWh | jetzt 6120 W
Warum weicht die Prognose vom Wechselrichter ab?
Die Schätzung verwendet Wettermodell, Dachneigung, Ausrichtung, Modulanzahl, Modulleistung, Temperaturkoeffizient und pauschale Systemverluste. Nicht vollständig bekannt sind:
- lokale Wolken und Verschattung,
- Schnee, Schmutz oder nasse Module,
- exakte Wechselrichterkennlinie,
- Abregelung, Batteriebeladung oder Eigenverbrauch,
- individuelle Alterung und Modultoleranzen.
Die PV-Prognose dient zur Planung, nicht als Zähler- oder Abrechnungswert.
7. Aktualisierung der Werte
Üblicherweise werden die Wetterdaten alle 10 bis 15 Minuten aktualisiert. Der Ausgang Letztes Update zeigt, wann der letzte Abruf erfolgreich war.
Wenn sich Werte über längere Zeit nicht ändern:
- Prüfen, ob andere Internetdienste des Gira X1 funktionieren.
- Den Zeitpunkt Letztes Update ansehen.
- Die Anzeige Fehlernachricht kontrollieren.
- Den Administrator informieren und Zeitpunkt sowie Fehlertext nennen.
8. Häufige Fragen
Benötige ich ein Open-Meteo-Konto?
Nein. Für den normalen öffentlichen Wetterdienst ist kein Konto und kein API-Key erforderlich.
Warum ist meine Außensensortemperatur anders?
Open-Meteo liefert einen Modellwert für ein geografisches Raster. Ein lokaler Sensor misst unmittelbar an seinem Montageort und kann durch Sonne, Wandnähe oder Höhe beeinflusst werden.
Warum zeigt Regenalarm 0, obwohl die Niederschlagswahrscheinlichkeit hoch ist?
Die Wahrscheinlichkeit beschreibt die Chance auf Niederschlag. Der Regenalarm wird aus dem aktuellen Wetterzustand abgeleitet und kann deshalb noch 0 sein.
Warum sind Mondzeiten unplausibel?
Die aktuelle Open-Meteo-Abfrage liefert keine Mondzeiten. Diese Felder sollten in der Visualisierung nicht verwendet werden.
Warum steht im GPA „Simulationsmodus“?
Das ist bei einer laufenden GPA-Simulation normal. Nach der Inbetriebnahme auf dem Zielgerät wird der dort ermittelte Lizenzstatus angezeigt.
9. Datenschutz
Für den Wetterabruf werden der konfigurierte Ort oder die Koordinaten an Open-Meteo übertragen. Bei aktivierter TerraBytes-Cloud können zusätzliche Wetter-, Mandanten- und Geräteinformationen an den konfigurierten TerraBytes-Dienst gesendet werden. Aktivierungscode, Offline-Token und API-Key dürfen nicht veröffentlicht werden.
10. Parameter, Eingänge, Ausgänge und empfohlene KNX-Adressen
10.1 Adresskonzept
Die Gruppenadressen sind Vorschläge für eine freie KNX-Hauptgruppe 12. Standort-, Lizenz-, API- und PV-Anlagendaten bleiben normalerweise feste Parameter im GPA und benötigen keine Gruppenadresse.
| Bereich | Adressvorschlag |
|---|---|
| Steuerung | 12/0/x |
| Temperatur und aktuelles Wetter | 12/1/x |
| Wind und Niederschlag | 12/2/x |
| Binärzustände | 12/3/x |
| Texte und Prognosen | 12/4/x |
| PV-Gesamtwerte | 12/5/x |
| PV-Teilflächen | 12/6/x |
| Diagnose und Gerät | 12/7/x |
| Lizenz und Updates | 12/8/x |
| Zeitwerte | 12/9/x |
10.2 Eingänge
| GPA-Name | Technischer Name | Typ | Pflicht | Funktion | KNX-DPT | GA |
|---|---|---|---|---|---|---|
| Trigger | Trigger |
Binär/Bool | ja | Neu gesetzter positiver Wert startet den Abruf; Impuls 0 → 1 → 0 empfohlen. |
1.001 | 12/0/1 |
| Aktiv | Active |
Binär/Bool | ja | Globale Freigabe; bei 0 werden Trigger ignoriert. |
1.001 | 12/0/2 |
10.3 Allgemeine Parameter
| Parameter | Typ | Standard | Pflicht | Verwendung |
|---|---|---|---|---|
ApiUrl |
Text | https://api.open-meteo.com/v1 |
ja | Basisadresse der Forecast-API. |
ApiKey |
Text | leer | nein | Nur für Customer-Endpunkte. |
Language |
Auswahl | de-German |
ja | Sprache der Ortssuche. |
Unit |
Auswahl | metric |
ja | metric, imperial oder standard. |
Modus |
Auswahl | CityName |
ja | CityName oder Geo. |
SearchCity |
Text | leer | im Stadtmodus | Ort oder Postleitzahl. |
SearchLat, SearchLon |
Text | leer | im Geo-Modus | WGS84-Koordinaten; Punkt oder Komma möglich. |
Forecast |
Auswahl | NoForecast |
ja | Kompakter Prognosehorizont. |
ActivationCode |
Text | leer | produktiv* | TerraBytes-Aktivierungscode. |
OfflineToken |
Text | leer | alternativ | Signierter Offline-Nachweis. |
ReleaseChannel |
Auswahl | Stable |
nein | Stable, Beta, Rc. |
OfflineProfile |
Auswahl | Private |
bei Token | Private, Business, Partner. |
RequestedOfflineDays |
Ganzzahl | 30 |
nein | Gewünschte Laufzeit; serverseitig begrenzt. |
Cycle |
Zeitspanne | 7 Tage | nein | Wiederholungsintervall der Lizenzprüfung. |
CloudActive |
Bool | 0 |
nein | Optionale TerraBytes-Cloudübertragung. |
CloudTenantId |
Text | leer | bei Cloud | Mandantenkennung. |
CloudSendInterval |
Zeitspanne | 4 Minuten | bei Cloud | Mindestabstand der Übertragungen. |
* In der GPA-Simulation ist keine Produktivlizenz erforderlich; auf dem Zielgerät schon.
10.4 PV-Parameter je Teilfläche
Gruppe 1 verwendet Namen mit Solar...; Gruppen 2 bis 4 heißen entsprechend SolarGroup2..., SolarGroup3... und SolarGroup4....
| Gruppe | Aktiv | Hersteller/Modell | Anzahl/Wp | Neigung/Azimut | Verlust/Temperaturkoeffizient |
|---|---|---|---|---|---|
| 1 | SolarActive |
SolarPanelManufacturer, SolarPanelModel |
SolarPanelCount, SolarPanelWattPeak |
SolarTilt, SolarAzimuth |
SolarSystemLossPercent, SolarTemperatureCoefficient |
| 2 | SolarGroup2Active |
SolarGroup2Manufacturer, SolarGroup2Model |
SolarGroup2PanelCount, SolarGroup2PanelWattPeak |
SolarGroup2Tilt, SolarGroup2Azimuth |
SolarGroup2SystemLossPercent, SolarGroup2TemperatureCoefficient |
| 3 | SolarGroup3Active |
SolarGroup3Manufacturer, SolarGroup3Model |
SolarGroup3PanelCount, SolarGroup3PanelWattPeak |
SolarGroup3Tilt, SolarGroup3Azimuth |
SolarGroup3SystemLossPercent, SolarGroup3TemperatureCoefficient |
| 4 | SolarGroup4Active |
SolarGroup4Manufacturer, SolarGroup4Model |
SolarGroup4PanelCount, SolarGroup4PanelWattPeak |
SolarGroup4Tilt, SolarGroup4Azimuth |
SolarGroup4SystemLossPercent, SolarGroup4TemperatureCoefficient |
| Feld | Typ | Defaults Gruppe 1/2/3/4 | Einheit/Bedeutung |
|---|---|---|---|
| Aktiv | Bool | 0/0/0/0 |
Teilfläche einbeziehen |
| Hersteller, Modell | Text | leer | Metadaten, ohne Recheneinfluss |
| Modulanzahl | Ganzzahl | 1/0/0/0 |
Stück |
| Wattpeak je Modul | Gleitkomma | 400/400/400/400 |
Wp |
| Neigung | Gleitkomma | 35/35/35/10 |
Grad |
| Ausrichtung | Gleitkomma | 0/-90/90/0 |
0° Süd, -90° Ost, +90° West |
| Systemverluste | Gleitkomma | jeweils 14 |
% |
| Temperaturkoeffizient | Gleitkomma | jeweils -0,35 |
%/°C |
10.5 Wetterausgänge
| Gruppe | Ports | Typ | Einheit | KNX-DPT | GA |
|---|---|---|---|---|---|
| Aktuelle Temperaturen | TempCurrent, TempCurrentFl |
Gleitkomma | °C/°F/K | 9.001 | 12/1/1–2 |
| Min./Max. | TempMin, TempMax |
Gleitkomma | °C/°F/K | 9.001 | 12/1/3–4 |
| Tagesabschnitte | TempMorning, TempEvening, TempNight |
Gleitkomma | °C/°F/K | 9.001 | 12/1/5–7 |
| Gefühlte Tageswerte | FlTempDay, FlTempMorning, FlTempEvening, FlTempNight |
Gleitkomma | °C/°F/K | 9.001 | 12/1/8–11 |
| Luftdruck | Pressure |
Ganzzahl | hPa | 7.001 | 12/1/12 |
| Feuchte, Bewölkung | Humidity, Clouds |
Ganzzahl | % | 5.001 | 12/1/13–14 |
| UV-Index | UV |
Gleitkomma | Index | 9.001 | 12/1/15 |
| Wettercode | WeatherCondition |
Ganzzahl | Code | 7.001 | 12/1/16 |
| Wind m/s | WindSpeed, WindGust |
Gleitkomma | m/s | 9.005 | 12/2/1, 12/2/4 |
| Wind km/h | WindSpeedKm |
Gleitkomma | km/h | 9.001 | 12/2/2 |
| Windrichtung | WindDir |
Ganzzahl | Grad | 7.001 | 12/2/3 |
| Niederschlagswahrscheinlichkeit | Pop |
Gleitkomma | % | 5.001 | 12/2/5 |
| Regen, Schnee | Rain, Snow |
Gleitkomma | mm/API-Wert | 9.026 | 12/2/6–7 |
| Regen-/Schneestatus | IsRain, IsSnow |
Bool | 0/1 | 1.001 | 12/3/1–2 |
| Aktueller Wettertext | WeatherCurrent |
Text | Zusammenfassung | 16.001** | 12/4/1 |
| Windsektor | Compass |
Text | z. B. W |
16.001 | 12/4/2 |
| Zustand | ConditionMain, ConditionDescription, ConditionIcon |
Text | Gruppe/Text/Icon | 16.001** | 12/4/3–5 |
| Stundenprognosen | WeatherForecast03, 06, 12, 24, 48 |
Text | Prognose | 16.001** | 12/4/10–14 |
| Tagesprognosen | WeatherForecastDay0 … Day7 |
Text | Prognose | 16.001** | 12/4/20–27 |
| Warnungen | Alerts |
Text | derzeit leer | 16.001** | 12/4/30 |
| Sonnenzeiten | Sunrise, Sunset |
Uhrzeit | lokal | 10.001 | 12/9/1–2 |
| Mondzeiten | Moonrise, Moonset |
Uhrzeit | nicht befüllt | keine Zuordnung | – |
Ausgeschriebene Prognoseports: WeatherForecast03, WeatherForecast06, WeatherForecast12, WeatherForecast24, WeatherForecast48, WeatherForecastDay0, WeatherForecastDay1, WeatherForecastDay2, WeatherForecastDay3, WeatherForecastDay4, WeatherForecastDay5, WeatherForecastDay6, WeatherForecastDay7.
10.6 PV-Ausgänge
| Gruppe | Ports | Typ | Einheit | KNX-DPT | GA |
|---|---|---|---|---|---|
| Installierte Leistung | SolarInstalledPowerKw |
Gleitkomma | kWp | 9.001 | 12/5/1 |
| Einstrahlung | SolarIrradianceNow |
Gleitkomma | W/m² | 9.001 | 12/5/2 |
| Aktuelle Leistung | SolarPowerNowW |
Gleitkomma | W | 14.056 | 12/5/3 |
| Ertrag gesamt | SolarEnergyTodayKwh, SolarEnergyTomorrowKwh, SolarEnergyNext7DaysKwh |
Gleitkomma | kWh | 9.001*** | 12/5/4–6 |
| Tageserträge | SolarEnergyDay0Kwh … Day7Kwh |
Gleitkomma | kWh | 9.001*** | 12/5/10–17 |
| Gesamttext | SolarSummary |
Text | Zusammenfassung | 16.001** | 12/5/20 |
| Gruppenleistung | SolarGroup1PowerNowW … Group4PowerNowW |
Gleitkomma | W | 14.056 | 12/6/1–4 |
| Gruppeneinstrahlung | SolarGroup1Irradiance … Group4Irradiance |
Gleitkomma | W/m² | 9.001 | 12/6/10–13 |
| Gruppenertrag heute | SolarGroup1EnergyTodayKwh … Group4EnergyTodayKwh |
Gleitkomma | kWh | 9.001*** | 12/6/20–23 |
| Gruppenertrag morgen | SolarGroup1EnergyTomorrowKwh … Group4EnergyTomorrowKwh |
Gleitkomma | kWh | 9.001*** | 12/6/30–33 |
| Gruppentexte | SolarGroup1Summary … Group4Summary |
Text | Zusammenfassung | 16.001** | 12/6/40–43 |
Ausgeschriebene Tagesports: SolarEnergyDay0Kwh, SolarEnergyDay1Kwh, SolarEnergyDay2Kwh, SolarEnergyDay3Kwh, SolarEnergyDay4Kwh, SolarEnergyDay5Kwh, SolarEnergyDay6Kwh, SolarEnergyDay7Kwh.
Ausgeschriebene Gruppenports:
- Gruppe 1:
SolarGroup1PowerNowW,SolarGroup1Irradiance,SolarGroup1EnergyTodayKwh,SolarGroup1EnergyTomorrowKwh,SolarGroup1Summary. - Gruppe 2:
SolarGroup2PowerNowW,SolarGroup2Irradiance,SolarGroup2EnergyTodayKwh,SolarGroup2EnergyTomorrowKwh,SolarGroup2Summary. - Gruppe 3:
SolarGroup3PowerNowW,SolarGroup3Irradiance,SolarGroup3EnergyTodayKwh,SolarGroup3EnergyTomorrowKwh,SolarGroup3Summary. - Gruppe 4:
SolarGroup4PowerNowW,SolarGroup4Irradiance,SolarGroup4EnergyTodayKwh,SolarGroup4EnergyTomorrowKwh,SolarGroup4Summary.
10.7 Diagnose, Gerät, Lizenz und Update
| Ports | Typ | KNX-DPT | GA |
|---|---|---|---|
TotalErrors |
Ganzzahl | 7.001 | 12/7/1 |
ErrorMessage |
Text | 16.001** | 12/7/2 |
SerialNumber, MacAddress, Firmware, Platform |
Text | 16.001** | 12/7/3–6 |
LastUpdateUtc |
Datum/Zeit | 19.001 | 12/7/7 |
MobileTemplateUrl |
lange URL | nicht empfohlen | – |
LicenseStatus, LicenseOwner |
Text | 16.001** | 12/8/1–2 |
UpdateAvailable |
Bool | 1.001 | 12/3/3 |
LatestVersion |
Text | 16.001 | 12/8/3 |
DownloadUrl |
lange URL | nicht empfohlen | – |
OfflineExpiresAt |
Text | 16.001** | 12/8/4 |
** KNX DPT 16.001 ist auf 14 Zeichen begrenzt. Lange Texte, Prognosen, Fehler und URLs besser X1-intern verwenden oder vor der KNX-Ausgabe kürzen.
*** Für prognostizierte kWh-Werte wird DPT 9.001 empfohlen, weil die Ports Gleitkommawerte liefern. Die Einheit kWh muss im Zielobjekt beziehungsweise in der Visualisierung ergänzt werden.
