OFM-InternetWeatherModule

Dies ist ein Modul zur Integration von Internet Wetterdiensten.

Abhängigkeiten

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

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

Hardware Unterstützung

Prozessor	Status	Anmerkung
RP2040	Beta
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:

  <op:define prefix="NET" ModuleType="11" 
    share="../lib/OFM-Network/src/Network.share.xml">
    <op:verify File="../lib/OFM-Network/library.json" ModuleVersion="2" /> 
  </op:define>

  <op:define prefix="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:verify File="../lib/OFM-InternetWeatherModule/library.json" ModuleVersion="0.1" /> 
  </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. Dieser ist auf maximal 10.000 Aufrufe pro Tag beschränkt (Stand 2024-08-11), Nutzungsbedingungen siehe https://open-meteo.com/en/terms (nur englisch).

Lizenz

GNU GPL v3