OFM-InternetWeatherModule

Dies ist ein Modul zur Integration von Internet Wetterdiensten.

Abhängigkeiten

Das Modul setzt OFM-Network oder OFM-WLAN voraus.

Warning

Achtung blockierende Netzwerkabfragen!

Die aktuelle Implementierung nutzt (derzeit noch) lange blockierenden HTTP-Requests, diese können die Funktion bzw. das Zeitverhalten anderer Module stören. Von einem kombinierten Einsatz wird daher abgeraten, bzw. sollte dieser nur nach sorgfältiger Abwegung der Risiken erfolgen.

Features

• Aktuelle Werte
• Prognose Heute
• Prognose Morgen
• Prognose Umschaltbar Heute/Morgen
• Prognose nächste Stunde
• Prognose übernächste Stunde

KO's für

• Wetterbeschreibung
• Tagestemperatur
• Nachttemperatur
• Frühtemperatur
• Abendtemperatur
• Minimum Temperatur
• Maximum Temperatur
• Gefühlte Tagestemperatur
• Gefühlte Nachtemperatur
• Gefühlte Frühtemperatur
• Gefühlte Abendtemperatur
• Luftdruck
• Luftfeuchte
• Wind
• Windböen
• Windrichtung
• Regen
• Schnee
• Niederschlagswahrscheinlichkeit
• UV-Index
• Wolken

Release Notes

Änderungen in Releases siehe Changelog

Hardware Unterstützung

Prozessor	Status	Anmerkung
RP2040	Beta	Keine Unterstützung für HTTPS
ESP32	Beta

Getestete Hardware:

• OpenKNX Reg1-ETH
• Adafruit ESP32 Feather V2

Einbindung in die Anwendung

In das Anwendungs XML muss OFM-Network (oder OFM-WLAN) und das OFM-InternetWeatherModule aufgenommen werden:

<!-- Set current version to use: -->
<op:configname="%IW_VerifyVersion%"value="..." />
<op:defineprefix="NET"ModuleType="11"share="../lib/OFM-Network/src/Network.share.xml">
<op:verifyFile="../lib/OFM-Network/library.json"ModuleVersion="2" /> </op:define>
<op:defineprefix="IW"ModuleType="21"share= "../lib/OFM-InternetWeatherModule/src/InternetWeatherModule.share.xml"template="../lib/OFM-InternetWeatherModule/src/InternetWeatherModule.templ.xml"NumChannels="5"KoSingleOffset="400"KoOffset="410">
<op:verifyFile="../lib/OFM-InternetWeatherModule/library.json"ModuleVersion="%IW_VerifyVersion%" /> </op:define>

Hinweis: Pro Kanal werden 102 KO's benötigt. Dies muss bei nachfolgenden Modulen bei KoOffset und KoSingleOffset entsprechend berücksichtigt werden.

In main.cpp muss das ebenfalls das Network- (oder WLAN-) und InternetWeatherModule hinzugefügt werden:

[...]
#include "NetworkModule.h"
#include "InternetWeatherModule.h"
[...]
void setup()
{
[...]
openknx.addModule(1, openknxNetwork);
openknx.addModule(3, openknxInternetWeatherModule);
[...]
}

Wetterdienste

Die Architektur dieses Moduls erlaubt die Nutzung verschiedener Wetter-Dienste.

Derzeit sind folgende Wetteranbieter integriert:

• OpenWeatherMap
• Open-Meteo

Pull Requests für weitere Dienste sind willkommen!

OpenWeatherMap

Für die Anfragen wird ein API Key von https://openweathermap.org benötigt. 1000 Aufrufe pro Tag können gratis durchgeführt werden, jedoch muss auch dafür ein Account angelegt werden und die Subscription für das One Call API 3.0 aktiviert werden. Bei der Subscription sollte das Call per day limit auf 1000 eingestellt werden, damit keine Kosten anfallen können.

Siehe https://openweathermap.org/price

Open-Meteo

Open-Meteo ist eine "Open-Source-Wetter-API" und bietet für nicht-kommerzielle Nutzung einen Zugang ohne API-Key ("Free-API"). Dieser ist auf maximal 10.000 gewichtete Aufrufe ("API calls") pro Tag beschränkt (Stand 2025-06-01, entspricht mit etwa 3.000 Aktualisierungen in Summe für alle Orte deutlich mehr als zu erwarten); Nutzungsbedingungen siehe https://open-meteo.com/en/terms (nur englisch).

Lizenz

GNU GPL v3