Open-Meteo Wetter – Administratorhandbuch

1. Produktbeschreibung

Der Logikbaustein Open-Meteo Wetter bindet aktuelle Wetterdaten, Stunden- und Tagesprognosen sowie eine optionale PV-Ertragsprognose in Gira X1/L1-Projekte ein. Als Datenquelle dient die Open-Meteo Forecast API. Für den öffentlichen Endpunkt ist kein API-Schlüssel erforderlich.

Dieses Handbuch richtet sich an Elektrofachbetriebe, Systemintegratoren und Administratoren, die den Baustein im Gira Project Assistant (GPA) installieren, parametrieren, testen und warten.

Merkmal	Wert
Paketname	Open-Meteo Wetterlogik
Dokumentationsversion	1.3.8
Zielsystem	Gira X1/L1, GPA-Simulation
Standard-API	https://api.open-meteo.com/v1
Empfohlenes Abrufintervall	10 bis 15 Minuten
Standortarten	Stadtname oder WGS84-Koordinaten
Öffentlicher API-Schlüssel	nicht erforderlich

2. Voraussetzungen

• Gira Project Assistant mit einem kompatiblen X1-/L1-Projekt.
• Internetzugang vom Zielgerät zu Open-Meteo über HTTPS, TCP-Port 443.
• DNS-Auflösung und korrekte Uhrzeit auf dem Zielgerät.
• Das signierte Paket torsten_kaeker_gmail_com.logic.OpenMeteo-<Version>.zip.
• Für lizenzierte TerraBytes-Funktionen ein Aktivierungscode oder Offline-Token.

Der Wetterabruf ist fail-open ausgelegt: Ein Fehler bei Geräte- oder Lizenzinformationen darf den Forecast-Abruf nicht blockieren. Cloudfunktionen können hingegen eine gültige Lizenz bzw. Freischaltung benötigen.

3. Installation und Aktualisierung im GPA

1. Im GPA die Verwaltung der Logikbausteine öffnen.
2. Das signierte ZIP aus dem Projektunterordner zip installieren.
3. Den Baustein Open-Meteo Wetter auf das Logikblatt ziehen.
4. Bei einem Update mit geänderter Portstruktur den alten Baustein löschen und neu einsetzen.
5. Parameter kontrollieren und das Projekt prüfen.
6. Zunächst in der GPA-Simulation testen, anschließend das Projekt in Betrieb nehmen.

Bei der Aktualisierung von Versionen vor 1.3.7 muss der Baustein neu eingesetzt werden. Frühere Versionen konnten Standortports nicht korrekt initialisieren und beim Start an der Geräteermittlung abbrechen.

4. Empfohlener Logikblatt-Aufbau

Minimal erforderlich ist ein positiver Triggerimpuls. Ein Oszillator mit einer Periodendauer von 10 Minuten ist ein typischer Aufbau.

Oszillator, Zyklus 10 min
        Ausgang ───────────────► Trigger | Open-Meteo Wetter
                                   Aktiv | 1

Open-Meteo Wetter | Temp. ─────► Temperatur-Gruppenadresse
Open-Meteo Wetter | Luftfeuchte ► Feuchte-Gruppenadresse
Open-Meteo Wetter | Fehlertext ─► Diagnose/Visualisierung

Beispiel für einen Funktionstest:

Einstellung	Beispielwert
Aktiv	1
Modus	CityName / Anzeige im GPA: Stadt
Stadt	Berlin
Einheit	metric
API URL	https://api.open-meteo.com/v1
API Key	leer
Trigger	einmal von 0 auf 1 schalten

Ein erfolgreicher Test kann beispielsweise folgende Werte liefern. Wetterwerte ändern sich mit Ort und Zeitpunkt:

TempCurrent    = 13,3 °C
Humidity       = 80 %
Pressure       = 1019 hPa
WeatherCurrent = 💧0|☁46%|13.3°C|🌬7.6km/h
TotalErrors    = 0

5. Eingänge

GPA-Name	Technischer Name	Typ	Standard	Beschreibung
Trigger	Trigger	Binär	0	Ein positiver, neu gesetzter Wert startet einen Abruf. Empfohlen ist ein Impuls bzw. wechselndes Oszillatorsignal. Ein dauerhaft anliegender Wert ohne neues Telegramm löst keinen weiteren Abruf aus.
Aktiv	Active	Binär	1	Globale Freigabe. Bei 0 werden Trigger ignoriert.

6. Standort- und API-Parameter

GPA-Name	Technischer Name	Standard	Beschreibung und Beispiel
API URL	ApiUrl	https://api.open-meteo.com/v1	Basisadresse ohne abschließendes /forecast. Nur für einen Customer-Endpunkt ändern.
API Key	ApiKey	leer	Für die öffentliche API leer lassen. Bei Customer-Endpunkten wird der Wert als apikey übertragen.
Sprache	Language	de-German	Sprache der Ortssuche. Aus dem Wert werden die ersten zwei Zeichen, z. B. de, verwendet.
Einheit	Unit	metric	metric: °C; imperial: °F; standard: Kelvin. Wind steht zusätzlich in m/s und km/h bereit.
Modus	Modus	CityName	CityName/Stadt verwendet die Ortssuche; Geo verwendet Koordinaten.
Stadt	SearchCity	leer	Ort oder Postleitzahl, z. B. Berlin, 80331 München oder Hamburg. Der erste Geocoding-Treffer wird verwendet.
Breitengrad	SearchLat	leer	WGS84-Breitengrad im Geo-Modus, z. B. 52,5200 oder 52.5200.
Längengrad	SearchLon	leer	WGS84-Längengrad im Geo-Modus, z. B. 13,4050 oder 13.4050.
Wettervorhersage	Forecast	NoForecast	Auswahl für kompakte Prognoseausgaben. Separate Stunden- und Tagesausgänge werden unabhängig davon befüllt.

Punkt und Komma werden bei manuell eingetragenen Koordinaten akzeptiert. Numerische Koordinaten aus der Geocoding-Antwort werden kulturunabhängig verarbeitet.

7. Lizenz- und Cloudparameter

GPA-Name	Technischer Name	Standard	Beschreibung
ActivationCode	ActivationCode	leer	TerraBytes-Aktivierungscode. Nicht in Screenshots, Tickets oder Quellcode veröffentlichen.
Offline-Token	OfflineToken	leer	Signierter Token für zeitweise Offline-Nutzung.
Versionskanal	ReleaseChannel	Stable	Stable, Beta oder Rc.
Nutzungsprofil	OfflineProfile	Private	Private, Business oder Partner.
Offline-Laufzeit	RequestedOfflineDays	30	Gewünschte Laufzeit eines Offline-Tokens in Tagen.
Cloud aktiv	CloudActive	0	Sendet Wetter-Snapshots an die TerraBytes-Cloud, sofern lizenziert.
Tenant	CloudTenantId	leer	Mandantenkennung für die Cloudvisualisierung.
Sendeintervall	CloudSendInterval	4 Minuten	Mindestabstand zwischen Cloudübertragungen. Ersetzt nicht das Wetter-Abrufintervall.

In der GPA-Simulation wird als Lizenzstatus Simulationsmodus ausgegeben und der Wetterabruf bleibt ohne Produktivlizenz möglich. Auf dem Gira X1 ist dagegen eine bestätigte Online- oder Offline-Lizenz erforderlich. Ist der Lizenzdienst vorübergehend nicht erreichbar, läuft eine zuvor bestätigte Test-, Grace- oder Offline-Lizenz nur bis zu ihrem bekannten Ablauf weiter. Danach wird der Wetterabruf gesperrt; TotalErrors wird auf 1 gesetzt und ErrorMessage enthält die Lizenzmeldung. Eine erfolgreiche spätere Lizenzprüfung hebt die Sperre automatisch wieder auf.

8. Wetterausgänge

8.1 Aktuelle Mess- und Modellwerte

GPA-Ausgang	Technischer Name	Einheit	Beispiel	Bedeutung
Temp.	TempCurrent	°C/°F/K	13,3 °C	Aktuelle Lufttemperatur in 2 m Höhe.
aktuelles Wetter	WeatherCurrent	Text	`💧0	☁46%
Temp. gefühlt	TempCurrentFl	°C/°F/K	12,1 °C	Wahrgenommene Temperatur.
Temp. min./max.	TempMin, TempMax	°C/°F/K	11,8 / 18,5 °C	Tagesminimum und Tagesmaximum.
morgens/abends/nachts	TempMorning, TempEvening, TempNight	°C/°F/K	14,1 °C	Prognose für typische Tageszeiten.
gefühlt Tag/Morgen/Abend/Nacht	FlTempDay, FlTempMorning, FlTempEvening, FlTempNight	°C/°F/K	13,6 °C	Gefühlte Temperaturen für Tagesabschnitte.
Luftdruck	Pressure	hPa	1019	Auf Meereshöhe reduzierter Luftdruck.
Luftfeuchtigkeit	Humidity	%	80	Relative Luftfeuchtigkeit in 2 m Höhe.
Bewölkung	Clouds	%	46	Bedeckungsgrad, 0 % klar bis 100 % bedeckt.
UV-Index	UV	Index	0,3	Aktueller UV-Index.
Niederschlagswahrscheinlichkeit	Pop	%	20	Wahrscheinlichkeit für Niederschlag.
Regen	Rain	mm	0,4	Regen plus Schauer im aktuellen Zeitraum.
Schnee	Snow	API-Wert	0	Von Open-Meteo gemeldeter Schneefall.
Regenalarm	IsRain	Binär	1	Aus dem Wettercode abgeleiteter Regenzustand.
Schneealarm	IsSnow	Binär	0	Aus dem Wettercode abgeleiteter Schneezustand.

8.2 Wind

Ausgang	Einheit	Beispiel	Beschreibung
WindSpeed	m/s	2,1	Aktuelle Windgeschwindigkeit.
WindSpeedKm	km/h	7,6	Derselbe Wert in km/h.
WindDir	Grad	273°	Meteorologische Windrichtung.
Compass	Text	W	Aus Gradwert berechneter Kompasssektor.
WindGust	m/s	5,3	Aktuelle Windböe.

8.3 Wetterzustand und Prognosen

Ausgang	Beispiel	Beschreibung
WeatherCondition	804	Auf bestehende Wettercodes abgebildeter WMO-Zustand.
ConditionMain	Clouds	Technische Hauptgruppe.
ConditionDescription	Bedeckt	Lesbarer Wettertext.
ConditionIcon	04d	Symbolkennung für Visualisierungen.
WeatherForecast03 … WeatherForecast48	+3h: 15 °C, bewölkt	Prognosen für 3, 6, 12, 24 und 48 Stunden.
WeatherForecastDay0 … WeatherForecastDay7	Heute: 12–19 °C	Tagesprognosen von heute bis Tag 7.
Sunrise, Sunset	05:38, 21:14	Lokale Sonnenauf- und -untergangszeit.
Moonrise, Moonset	nicht verwenden	Der Abruf liefert keine Monddaten. Angezeigte Initialwerte sind keine Messwerte.
Alerts	leer	Der aktuelle Abruf liefert keine amtlichen Warnmeldungen.

9. PV-Ertragsprognose

Der Baustein unterstützt bis zu vier unterschiedlich ausgerichtete Modulgruppen. Für jede aktive Gruppe wird die geneigte Globalstrahlung separat angefordert. Gesamtwerte summieren die aktiven Gruppen.

9.1 Parameter je Gruppe

Parameter	Standard PV1	Beispiel Süddach	Beschreibung
Aktiv	0	1	Schaltet die Gruppe ein.
Hersteller	leer	Muster Solar	Metadatum, verändert die Berechnung nicht.
Modell	leer	MS-410	Metadatum.
Modulanzahl	1	24	Anzahl gleichartiger Module.
Wp je Modul	400 Wp	410 Wp	Nennleistung laut Datenblatt.
Neigung	35°	35°	0° horizontal, 90° vertikal.
Ausrichtung	0°	0°	0° Süd, -90° Ost, +90° West, ±180° Nord.
Systemverluste	14 %	14 %	Wechselrichter-, Kabel-, Verschmutzungs- und Mismatchverluste.
Temperaturkoeffizient	-0,35 %/°C	-0,34 %/°C	Leistungsänderung relativ zu 25 °C Zelltemperatur.

Beispiel für eine Ost-/Westanlage:

Gruppe	Anzahl × Wp	Neigung	Azimut
PV1 Ost	12 × 410 Wp	35°	-90°
PV2 West	12 × 410 Wp	35°	+90°

9.2 PV-Ausgänge

• Gesamt: SolarInstalledPowerKw, SolarIrradianceNow, SolarPowerNowW, SolarEnergyTodayKwh, SolarEnergyTomorrowKwh, SolarEnergyNext7DaysKwh.
• Tage: SolarEnergyDay0Kwh bis SolarEnergyDay7Kwh.
• Je Gruppe: aktuelle Leistung, Einstrahlung, Ertrag heute, Ertrag morgen und Zusammenfassung.
• SolarSummary liefert beispielsweise: PV Gesamt | 9.84 kWp | heute 38.20 kWh | jetzt 6120 W.

Die Werte sind Modellprognosen. Sie ersetzen weder Wechselrichterdaten noch einen geeichten Energiezähler.

10. Diagnoseausgänge

Ausgang	Normalwert	Verwendung
TotalErrors	0	Anzahl der Fehler des letzten Abrufs.
ErrorMessage	leer	Technische Fehlerbeschreibung. Bei Inbetriebnahme sichtbar schalten oder verbinden.
LastUpdateUtc	aktueller Zeitstempel	Zeitpunkt des letzten erfolgreichen Abrufs. Trotz des historischen Namens wird derzeit lokale Systemzeit gesetzt.
Platform	z. B. Win32NT oder Unix	Erkannte Laufzeitplattform.
LicenseStatus	Simulationsmodus bzw. Lizenzstatus	Ergebnis der Lizenzprüfung.
LicenseOwner	Lizenznehmer	Vom Lizenzdienst gelieferter Inhaber.
UpdateAvailable, LatestVersion, DownloadUrl	abhängig vom Dienst	Updateinformationen.

11. Fehlerdiagnose

Keine Werte, alle Ausgänge bleiben auf 0

1. Kontrollieren, dass Aktiv = 1 ist.
2. Trigger manuell von 0 auf 1 schalten; ein dauerhaft anliegender Wert erzeugt keine periodischen Folgeabrufe.
3. TotalErrors, ErrorMessage, LastUpdateUtc, Platform und LicenseStatus sichtbar schalten.
4. Bei Stadtmodus einen eindeutigen Ortsnamen eintragen.
5. Bei Geo-Modus beide Koordinaten eintragen.
6. Sicherstellen, dass Version 1.3.8 oder neuer installiert und der Baustein neu eingesetzt wurde.

Meldung	Ursache	Maßnahme
Missing city name	Stadtmodus ohne Suchtext	Stadt oder Postleitzahl eintragen.
Missing coordinates (lat/lon)	Geo-Modus unvollständig	Breiten- und Längengrad ergänzen.
geocoding returned no matching location	Kein eindeutiger Treffer	Ort präzisieren oder Geo-Modus verwenden.
forecast failed: curl ... http=400	Ungültige URL, Koordinaten oder API-Parameter	Standard-URL wiederherstellen und Parameter prüfen.
curl could not be started	Systemtransport nicht verfügbar	Zielgerät/Firmware und Paketabhängigkeiten prüfen.
Parse error	Unerwartetes JSON	Customer-Endpunkt und API-Version prüfen.
MAC-Ermittlung uebersprungen	Bridge nicht kompatibel	Bridge/Paketabhängigkeit aktualisieren; ohne Gerätekennung kann die X1-Lizenzprüfung fehlschlagen.
Wetterabruf gesperrt – keine gültige Lizenz	Lizenz abgelehnt, nicht prüfbar oder Test-/Grace-Zeitraum abgelaufen	Aktivierungscode, Offline-Token, Netzwerkverbindung und LicenseStatus prüfen.

12. Netzwerkziele

Zweck	Ziel
Forecast	https://api.open-meteo.com/v1/forecast
Ortssuche	https://geocoding-api.open-meteo.com/v1/search
Lizenz/Cloud	TerraBytes-Dienste laut Projekt-/Lizenzkonfiguration

Proxy, Firewall und DNS müssen diese Ziele vom X1/L1 aus erreichen können. Ein Browseraufruf auf dem GPA-PC beweist nicht den Internetzugang des Zielgeräts.

13. Wartung und Datenschutz

• Abrufintervalle unter 5 Minuten vermeiden, sofern kein fachlicher Grund besteht.
• Aktivierungscode, Offline-Token und API-Key vertraulich behandeln.
• Wetter- und PV-Werte regelmäßig auf Plausibilität prüfen.
• Nach Paketupdates Simulation und Live-Inbetriebnahme erneut testen.
• Für Supportfälle Version, Plattform, TotalErrors, ErrorMessage und Zeitpunkt des letzten Updates angeben; Geheimnisse vorher entfernen.

14. Technische Portmatrix nach Typ

Die folgende Matrix gilt für Paketversion 1.3.8. Sie basiert auf den im Konstruktor tatsächlich erzeugten ValueObject-Typen. Parameter bleiben normalerweise lokal im GPA; nur Steuerung und benötigte Ausgänge werden mit KNX verbunden.

14.1 Steuerports

Port	SDK-/GPA-Typ	Default	Pflicht	Verhalten	KNX-DPT	GA
Trigger	Input, BoolValueObject, Binary	0	ja	Verarbeitung bei neu gesetztem positiven Wert; Impuls 0 → 1 → 0	1.001	12/0/1
Active	Input mit IsInput=false, BoolValueObject	1	ja	globale Freigabe	1.001*	12/0/2*

* Active ist eigenschaftsartig deklariert. Zeigt die GPA-Version keinen verdrahtbaren Anschluss, bleibt der Wert als feste Einstellung auf 1 und erhält keine GA.

14.2 Allgemeine, Standort-, Lizenz- und Cloudparameter

Port	ValueObject	Default	SDK-pflichtig	Fachliche Verwendung
ApiUrl	String	https://api.open-meteo.com/v1	ja	Basis-URL ohne /forecast.
ApiKey	String	leer	nein	interner Name APIkey; nur Customer-Endpunkte.
Language	Enum	de-German	ja	Geocoding-Sprache.
Unit	Enum	metric	ja	metric, imperial, standard.
Modus	Enum	CityName	ja	CityName oder Geo.
SearchCity	String	leer	nein	intern CityString; im Stadtmodus erforderlich.
SearchLat	String	leer	nein	intern Lat; im Geo-Modus erforderlich.
SearchLon	String	leer	nein	intern Lon; im Geo-Modus erforderlich.
Forecast	Enum	NoForecast	ja	kompakter Prognosehorizont.
ActivationCode	String	leer	nein**	Online-Aktivierung.
OfflineToken	String	leer	nein**	Offline-Nachweis.
ReleaseChannel	Enum	Stable	nein	Stable, Beta, Rc.
OfflineProfile	Enum	Private	nein	Private, Business, Partner.
RequestedOfflineDays	Integer	30	nein	vom Server begrenzte Anforderung.
Cycle	TimeSpan	7 Tage	nein	Lizenz-/Geräte-Recheck.
CloudActive	Bool	false	nein	Snapshotversand; Feature weather.cloud_upload oder cloud_upload erforderlich.
CloudTenantId	String	leer	nein	fachlich bei Cloudbetrieb erforderlich.
CloudSendInterval	TimeSpan	4 Minuten	nein	Mindestabstand der Cloudübertragung.

** Auf dem X1/L1 ist fachlich eine bestätigte Online- oder Offline-Lizenz erforderlich, auch wenn das SDK-Attribut optional ist.

14.3 PV-Parameter aller Gruppen

Gruppe	Aktiv	Hersteller	Modell	Anzahl	Wp	Neigung	Azimut	Verlust	Temp.-Koeffizient
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	Einheit	Defaults G1/G2/G3/G4
Aktiv	Bool	–	0/0/0/0
Hersteller/Modell	String	–	leer
Anzahl	Integer	Stück	1/0/0/0
Wp	Double/Float	Wp	400/400/400/400
Neigung	Double/Float	°	35/35/35/10
Azimut	Double/Float	°	0/-90/90/0
Verlust	Double/Float	%	jeweils 14
Temperaturkoeffizient	Double/Float	%/°C	jeweils -0,35

14.4 Wetterausgänge

Portgruppe	Ports	ValueObject	Einheit	KNX-DPT	GA
Temperatur aktuell	TempCurrent, TempCurrentFl	Double	°C/°F/K	9.001	12/1/1–2
Temperatur min/max	TempMin, TempMax	Double	°C/°F/K	9.001	12/1/3–4
Tagesabschnitte	TempMorning, TempEvening, TempNight	Double	°C/°F/K	9.001	12/1/5–7
Gefühlte Werte	FlTempDay, FlTempMorning, FlTempEvening, FlTempNight	Double	°C/°F/K	9.001	12/1/8–11
Luftdruck	Pressure	Integer	hPa	7.001	12/1/12
Prozentwerte	Humidity, Clouds	Integer	%	5.001	12/1/13–14
UV	UV	Double	Index	9.001	12/1/15
Wettercode	WeatherCondition	Integer	Code	7.001	12/1/16
Wind m/s	WindSpeed, WindGust	Double	m/s	9.005	12/2/1, 12/2/4
Wind km/h	WindSpeedKm	Double	km/h	9.001	12/2/2
Windrichtung	WindDir	Integer	°	7.001	12/2/3
Wahrscheinlichkeit	Pop	Double, Min 0, Max 100	%	5.001	12/2/5
Niederschlag	Rain, Snow	Double	mm	9.026	12/2/6–7
Niederschlagsstatus	IsRain, IsSnow	Bool	0/1	1.001	12/3/1–2
Wettertext	WeatherCurrent	String	Text	16.001***	12/4/1
Windsektor	Compass	String	Text	16.001	12/4/2
Zustand	ConditionMain, ConditionDescription, ConditionIcon	String	Text/ID	16.001***	12/4/3–5
Stundenprognose	WeatherForecast03, 06, 12, 24, 48	String	Text	16.001***	12/4/10–14
Tagesprognose	WeatherForecastDay0 … Day7	String	Text	16.001***	12/4/20–27
Warnungen	Alerts	String	derzeit leer	16.001***	12/4/30
Sonnenzeiten	Sunrise, Sunset	TimeSpan/Time	lokale Zeit	10.001	12/9/1–2
Mondzeiten	Moonrise, Moonset	TimeSpan/Time	nicht befüllt	keine GA	–

Vollständige Prognoseports: WeatherForecast03, WeatherForecast06, WeatherForecast12, WeatherForecast24, WeatherForecast48, WeatherForecastDay0, WeatherForecastDay1, WeatherForecastDay2, WeatherForecastDay3, WeatherForecastDay4, WeatherForecastDay5, WeatherForecastDay6, WeatherForecastDay7.

14.5 PV-Ausgänge

Gruppe	Ports	ValueObject	Einheit	KNX-DPT	GA
Installierte Leistung	SolarInstalledPowerKw	Double	kWp	9.001	12/5/1
Einstrahlung	SolarIrradianceNow	Double	W/m²	9.001	12/5/2
Gesamtleistung	SolarPowerNowW	Double	W	14.056	12/5/3
Gesamtenergie	SolarEnergyTodayKwh, SolarEnergyTomorrowKwh, SolarEnergyNext7DaysKwh	Double	kWh	9.001****	12/5/4–6
Tagesenergie	SolarEnergyDay0Kwh … Day7Kwh	Double	kWh	9.001****	12/5/10–17
Gesamttext	SolarSummary	String	Text	16.001***	12/5/20
Gruppenleistung	SolarGroup1PowerNowW … Group4PowerNowW	Double	W	14.056	12/6/1–4
Gruppeneinstrahlung	SolarGroup1Irradiance … Group4Irradiance	Double	W/m²	9.001	12/6/10–13
Gruppe heute	SolarGroup1EnergyTodayKwh … Group4EnergyTodayKwh	Double	kWh	9.001****	12/6/20–23
Gruppe morgen	SolarGroup1EnergyTomorrowKwh … Group4EnergyTomorrowKwh	Double	kWh	9.001****	12/6/30–33
Gruppentexte	SolarGroup1Summary … Group4Summary	String	Text	16.001***	12/6/40–43

Vollständige Tagesports: SolarEnergyDay0Kwh, SolarEnergyDay1Kwh, SolarEnergyDay2Kwh, SolarEnergyDay3Kwh, SolarEnergyDay4Kwh, SolarEnergyDay5Kwh, SolarEnergyDay6Kwh, SolarEnergyDay7Kwh.

Vollständige Teilflächenports:

• 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.

14.6 Diagnose-, Geräte-, Lizenz- und Updateausgänge

Port	ValueObject	Inhalt	KNX-DPT	GA
TotalErrors	Integer	Fehleranzahl	7.001	12/7/1
ErrorMessage	String	Diagnose	16.001***	12/7/2
SerialNumber	String	Geräte-Seriennummer	16.001***	12/7/3
MacAddress	String	Geräte-MAC	16.001***	12/7/4
Firmware	String	Firmware	16.001***	12/7/5
Platform	String	Laufzeitplattform	16.001	12/7/6
LastUpdateUtc	DateTime	derzeit lokale Systemzeit trotz historischem Namen	19.001	12/7/7
MobileTemplateUrl	String	lange URL	nicht auf KNX	–
LicenseStatus	String	Lizenzstatus	16.001***	12/8/1
LicenseOwner	String	Lizenznehmer	16.001***	12/8/2
UpdateAvailable	Bool	Update vorhanden	1.001	12/3/3
LatestVersion	String	Versionsnummer	16.001	12/8/3
DownloadUrl	String	lange URL	nicht auf KNX	–
OfflineExpiresAt	String	Ablauftext	16.001***	12/8/4

*** DPT 16.001 ist auf 14 Zeichen begrenzt. Lange Texte, Prognosen, Fehler und URLs X1-intern verwenden oder vor der KNX-Ausgabe kürzen.

**** Die PV-Ports liefern Gleitkomma-kWh. DPT 9.001 ist deshalb die kompatible Übergabeempfehlung; die Einheit kWh im Zielobjekt/der Visualisierung kennzeichnen.

15. Empfohlenes KNX-Adressschema

Mittelgruppe	Inhalt	Reservierter Bereich
12/0	Steuerung	12/0/1–2
12/1	aktuelle Wetterwerte	12/1/1–16
12/2	Wind und Niederschlag	12/2/1–7
12/3	Binärstatus	12/3/1–3
12/4	Wettertexte/Prognosen	12/4/1–30
12/5	PV-Gesamt	12/5/1–20
12/6	PV-Teilflächen	12/6/1–43
12/7	Diagnose/Gerät	12/7/1–7
12/8	Lizenz/Update	12/8/1–4
12/9	Zeitwerte	12/9/1–2

Die Lücken sind für spätere Erweiterungen reserviert. Geheimnisse wie ActivationCode, OfflineToken, ApiKey, Koordinaten und CloudTenantId nicht über KNX übertragen.