http://wiki.fhem.de/w/api.php?action=feedcontributions&feedformat=atom&user=JensBFHEMWiki - Benutzerbeiträge [de]2026-04-10T02:20:36ZBenutzerbeiträgeMediaWiki 1.43.6http://wiki.fhem.de/w/index.php?title=DWD_OpenData&diff=38892DWD OpenData2024-01-10T21:43:39Z<p>JensB: Modulname in 98_DWD_OpenData_Weblink.pm geändert</p>
<hr />
<div>{{Hinweis|Versionsänderung: Die Vorhersagedaten wurden Mitte September 2018 von CSV auf KML umgestellt. Diese Umstellung ist inkompatibel: das DWD_OpenData-Modul muss aktualisiert werden, einige Reading-Namen haben sich geändert und der Weblink muss deinstalliert und neu installiert werden (siehe diesen {{Link2Forum|Topic=83097|Message=840270|Linktext=Beitrag im Forum}}).}}<br />
<br />
{{Infobox Modul<br />
|ModPurpose=Daten vom DWD OpenData Server abrufen<br />
|ModType=d<br />
|ModCmdRef=DWD_OpenData<br />
|ModForumArea=Unterstützende Dienste/Wettermodule<br />
|ModTechName=55_DWD_OpenData.pm<br />
|ModOwner=JensB ({{Link2FU|14024|Forum}}/[[Benutzer Diskussion:JensB|Wiki]])<br />
}}<br />
<br />
Der Deutsche Wetterdienst (DWD) stellt Wetterdaten über den [https://www.dwd.de/DE/leistungen/opendata/opendata.html Open Data Server] zur Verfügung. Die Verwendung dieses Dienstes und der vom DWD zur Verfügung gestellten Daten unterliegt den auf der OpenData Webseite beschriebenen Bedingungen. Einen Überblick über die verfügbaren Daten findet man in der Tabelle [https://www.dwd.de/DE/leistungen/opendata/help/inhalt_allgemein/opendata_content_de_en_xls.xls OpenData_weather_content.xls] oder hier: https://opendata.dwd.de/weather/lib/MetElementDefinition.xml.<br />
<br />
== Anwendung ==<br />
Aufgrund der unterschiedlichen vom DWD bereitgestellten Datenformate benötigt das Modul zur Dekodierung je nach gewünschtem Funktionsumfang zusätzliche Perl-Module, die nicht standardmäßig vorinstalliert sind und je nach Systemkonfiguration nachinstalliert werden müssen. Außerdem unterstützt das Modul Zeitzonen, um z.B. die Wettervorhersage internationaler Stationen in Ortszeit darstellen zu können. Hierfür sind je nach Systemkonfiguration weitere Einstellungen erforderlich. Auch die Sprache der Wochentage für die Wettervorhersage ist frei wählbar. Je nach Systemkonfiguration ist aber die Standardsprache u.U. auf Englisch eingestellt, was weitere Anpassungen der Systemkonfiguration erforderlich macht.<br />
<br />
=== Vorbereitung ===<br />
Im folgenden wird z.T. von einem System mit Rasbian oder Debian mit System-V Startsystem ausgegangen. Auf anderen Betriebssystemen und auf Systemen mit System-D müssen die Installationsschritte ggf. angepasst werden.<br />
<br />
1. Für die Wettervorhersage und die Wetterwarnungen:<br />
Installation des Perl-Moduls ''XML::LibXML'' über die System-Kommandozeile mit<br />
<syntaxhighlight lang="bash"><br />
sudo apt-get install libxml-libxml-perl<br />
</syntaxhighlight> <br />
oder mit CPAN.<br />
<br />
2. Weiterhin ist das Perl-Modul '' DateTime'' erforderlich. Dieses lässt sich mit <syntaxhighlight lang="bash">sudo apt-get install libdatetime-perl</syntaxhighlight> installieren.<br />
<br />
3. Falls man einen eigenen Internet-Proxy nutzt:<br />
Die Konfiguration des Proxies für FHEM erfolgt z.B. durch Eintrag von<br />
<pre><br />
attr global proxy <myProxyHost>:<myProxyPort><br />
</pre> <br />
in die [[Konfiguration]], wobei ''myProxyHost'' durch den Namen oder die IP-Adresse des Proxy-Servers ersetzt werden muss und für ''myProxyPort'' der Port des Proxy-Servers eingetragen werden muss (oft 3128).<br />
<br />
3. FHEM Uhrzeit und Zeitzone:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre><br />
in die FHEM-Kommandozeile überprüfen, ob die FHEM-Uhrzeit plausibel ist. Ist dies nicht der Fall sollten die Uhrzeit auf Systemebene überprüft werden und ggf. die Systemeinstellungen angepasst werden.<br />
Ermitteln der Bezeichnung der eigenen Zeitzone über die System-Kommandozeile mit<br />
<pre><br />
tzselect<br />
</pre><br />
und diese Bezeichnung in die Datei ''/etc/timezone'' eintragen und <br />
<pre><br />
export TZ=`cat /etc/timezone`<br />
</pre><br />
der Datei ''/etc/profile'' hinzufügen und dann das System neu starten. Nun muss die Zeitanzeige in FHEM korrekt sein.<br />
<br />
4. FHEM Sprache:<br />
Durch Eingabe von <br />
<pre><br />
{$ENV{LANG}}<br />
</pre> in die FHEM-Kommandozeile überprüfen, in welcher Sprache der Wochentag angezeigt wird. Stimmt die Sprache nicht, dann auf der System-Kommandozeile<br />
<pre><br />
dpkg-reconfigure locales<br />
</pre> eingeben und aus der Liste z.B. ''de_DE.UTF-8'' zusätzlich auswählen. Dieser Befehl gilt für Debian-basierte Betriebssysteme - für andere Betriebssysteme ist eine analoge Funktion zu verwenden. Mit Eingabe von <br />
<pre><br />
locale -a<br />
</pre> auf der System-Kommandozeile überprüfen, ob die ausgewählte Sprache nun zur Verfügung steht. Sollte FHEM nach einem Neustart noch immer nicht die gewünschte Sprache verwenden, kann man auf einem System V Linux durch Hinzufügen von z.B.<br />
<pre><br />
export LANG=de_DE.UTF-8<br />
</pre> in die Datei ''/etc/init.d/fhem'' (irgendwo zwischen ''start'' und ''perl'') und erneutem Neustart von FHEM die Sprache für FHEM erzwingen. Bei einem Systemd Linux kann man die Einstellungen mit ''systemctl edit --full fhem.service'' bearbeiten. Spätestes jetzt muss die Wochentagsanzeige in FHEM korrekt sein.<br />
<br />
5. Nur für den Weblink erforderlich:<br />
Installation des Perl-Moduls ''DateTime'' über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libdatetime-perl<br />
</pre> <br />
oder mit CPAN.<br />
<br />
=== Define ===<br />
Siehe {{Link2CmdRef|Anker=DWD_OpenDatadefine|Label=Commandref}}.<br />
<br />
=== Attributes ===<br />
Siehe {{Link2CmdRef|Anker=DWD_OpenDataattr|Label=Commandref}}.<br />
<br />
== Anwendungsbeispiele ==<br />
=== Beispiel zur Modul-Einrichtung ===<br />
<br />
* Wettervorhersage<br />
Für die Wettervorhersage muss der Stationscode ermittelt werden. Dazu den [https://www.dwd.de/DE/leistungen/met_verfahren_mosmix/mosmix_stationskatalog.pdf MOSMIX Stationskatalog] herunterladen, öffnen und die gewünschte Station heraussuchen (Spalte ''id''). Einen Teil der deutschen Stationen kann man auch der [https://www.dwd.de/DE/derdwd/messnetz/bodenbeobachtung/messnetzkarte_boden.pdf Bodenmessnetzkarte] entnehmen. Den ermittelten Stationscode kann man dann entweder für eine Einzelabfrage als Parameter für das Kommando ''get forecast'' verwenden oder für die automatische Aktualisierung als Attribut ''forecastStation'' hinterlegen. Insgesamt werden vom DWD mehr als 70 Merkmale zur Verfügung gestellt. Eine Auflistung findet sich im Dokument [https://opendata.dwd.de/weather/lib/MetElementDefinition.xml MetElementDefinition]. Nur ein kleiner Teil der Merkmale wird in der Standardeinstellung des Moduls als Reading zur Verfügung gestellt. Wer andere Merkmale benötigt muss sie mit Komma getrennt dem Attribut ''forecastProperties'' zuweisen. Es empfiehlt sich zur Performance-Optimierung sowohl das Attribut ''forecastDays'' als auch das Attribut ''forecastProperties'' auf den tatsächlichen Bedarf einzustellen.<br />
<br />
* Wetterwarnungen<br />
Für die Wetterwarnungen muss die Warnzelle ermittelt werden. Dazu [https://www.dwd.de/DE/leistungen/opendata/help/warnungen/cap_warncellids_csv.csv Warnzellen-ID Katalog] herunterladen, öffnen und die gewünschte Warnzelle heraussuchen. Unterstützt werden Gemeinden (beginnen mit 8), Landkreise (beginnen mit 1 oder 9) oder Küste (beginnen mit 5). Die Warnzellen-ID kann man dann entweder für eine Einzelabfrage als Parameter für das Kommando ''get alerts'' verwenden oder für die automatische Aktualisierung als Attribut ''alertArea'' hinterlegen. Die Warnzellen-ID ist ab der 2. Stelle identisch mit den ersten Ziffern des amtlichen Gemeindeschlüssels. Man kann z.B. den Namen von Gemeinde oder Landkreis bei den [https://www.statistik-bw.de/Statistik-Portal/gemeindeverz.asp Statistischen Ämtern des Bundes und der Länder] eingeben, den amtlichen Gemeindeschlüssel ermitteln und dann mit vorangestellter 1, 8 oder 9 im Warnzellen-ID Katalog des DWD nach einem Eintrag mit exakter oder weitgehender Übereinstimmung suchen. Wem das zu kompliziert vorkommt, der kann bei mehrdeutigen Gemeinde- bzw. Landkreisbezeichnungen auch versuchen auszuprobieren, welche die richtige Warnzellen-ID ist.<br />
<br />
Um das Modul mit automatisch Aktualisierung von Vorhersage und Wetterwarnungen zu nutzen, kann z.B. folgendes in die [[Konfiguration]] eingetragen werden:<br />
<br />
<pre><br />
define DWD DWD_OpenData<br />
attr DWD alertArea 111000000<br />
attr DWD forecastStation 99810<br />
attr DWD forecastDays 3<br />
attr DWD forecastWW2Text 1<br />
</pre><br />
<br />
* Performance<br />
Das DWD_OpenData-Modul ist ein Datenmodul mit relativ vielen Readings. In der Standardkonfiguration wird, wie bei jedem anderen FHEM Modul, bei jeder Änderung jedes Readings ein FHEM internes Ereignis erzeugt, damit andere FHEM Devices auf diese Änderungen reagieren können. Diese Ereignisse sorgen auch dafür, dass man Änderungen in der Weboberfläche sofort angezeigt bekommt, ohne die Webseite neu aufzurufen. Interessiert sich aber kein FHEM Device für die Änderungsbenachrichtigung bestimmter Readings, entsteht unnötiger Verarbeitungs-Overhead, der je nach FHEM Konfiguration und verfügbarer CPU-Leistung auch mehrere Sekunden benötigen kann und in dieser Zeit andere Abläufe blockiert. Um die Performance zu optimieren, empfiehlt es sich, mit [[event-on-update-reading]] für eine angepasste und dadurch effizientere Verarbeitung zu sorgen, indem man nur für jene Readings Ereignisse zulässt, welche man für die Weiterverarbeitung braucht. Der DWD_OpenData_Weblink braucht z.B. gar keine Ereignisse, um zu funktionieren. Hier eine minimalistische Beispielkonfiguration:<br />
<br />
<pre><br />
attr DWD event-on-update-reading state,fc_state,a_state<br />
</pre><br />
<br />
Weitere Details zur Installation und Konfiguration des Moduls finden sich in der<br />
{{Link2CmdRef|Anker=DWD_OpenData|Label=Commandref}}.<br />
<br />
=== Beispiel für die Einrichtung eines Meteogramms ===<br />
Um den vorhergesagten Wetterverlauf als Meteogramm in Kurvenform mit [[SVG]] darzustellen, kann man wie folgt vorgehen:<br />
<br />
1. 99_myUtils.pm<br />
<br />
Für die Bestimmung der Werte für den SVG-Plot wird eine Perl-Funktion benötigt, die in die Datei 99_myUtils.pm vor dem Ende eingefügt wird. Wer diese FHEM-Datei noch nicht nutzt, legt sie einfach an (siehe [[99_myUtils_anlegen]]).<br />
<syntaxhighlight lang="perl"><br />
package main;<br />
<br />
use strict;<br />
use warnings;<br />
<br />
...<br />
<br />
#<br />
# (c) mumpitzstuff 19.12.2018<br />
#<br />
# see https://forum.fhem.de/index.php/topic,83097.msg874150.html#msg874150<br />
#<br />
sub logProxy_dwd2Plot($$$$;$$$)<br />
{<br />
my ($device, $fcValue, $from, $to, $fcHour, $expMode, $shiftTime) = @_;<br />
my $regex;<br />
my @rl;<br />
<br />
return undef if(!$device);<br />
<br />
if ($fcValue =~ s/_$//)<br />
{<br />
$regex = "^fc[\\d]+_[\\d]+_".$fcValue."\$";<br />
}<br />
else<br />
{<br />
$regex = "^fc[\\d]+_".$fcValue."\$";<br />
}<br />
<br />
$fcHour = 12 if(!defined($fcHour));<br />
$expMode = "point" if(!defined($expMode));<br />
#Log3 undef,2, "Regex: ".$regex;<br />
<br />
# ermitteln aller relevanten Readings<br />
if ( defined($defs{$device}) )<br />
{<br />
if ( $defs{$device}{TYPE} eq "DWD_OpenData" )<br />
{<br />
@rl = sort<br />
{<br />
my ($an) = ($a =~ m/fc(\d+)_.*/);<br />
my ($bn) = ($b =~ m/fc(\d+)_.*/);<br />
my ($ao) = ($a =~ m/fc\d+_(\d+).*/);<br />
my ($bo) = ($b =~ m/fc\d+_(\d+).*/);<br />
$an <=> $bn or $ao <=> $bo or $a cmp $b;<br />
} ( grep /${regex}/,keys %{$defs{$device}{READINGS}} );<br />
return undef if ( !@rl );<br />
}<br />
else<br />
{<br />
Log3 undef, 2, "logProxy_dwd2Plot: $device is not a DWD_OpenData device";<br />
return undef;<br />
}<br />
}<br />
<br />
my $fromsec = SVG_time_to_sec($from);<br />
my $tosec = SVG_time_to_sec($to);<br />
my $sec = $fromsec;<br />
my ($h, $hp, $fcDay, $mday, $mon, $year);<br />
my $timestamp;<br />
<br />
my $reading;<br />
my $value;<br />
my $prev_value;<br />
my $min = 999999;<br />
my $max = -999999;<br />
my $ret = "";<br />
<br />
# while not end of plot range reached<br />
while (($sec < $tosec) && @rl)<br />
{<br />
#remember previous value for start of plot range<br />
$prev_value = $value;<br />
<br />
$reading = shift @rl;<br />
($fcDay) = $reading =~ m/^fc(\d+).*/;<br />
($hp) = $reading =~ m/^fc\d+_(\d+).*/;<br />
#Log 1, "hp: ".$hp;<br />
<br />
if ($hp)<br />
{<br />
$h = ReadingsVal($device, "fc".$fcDay."_".$hp."_time", $fcHour);<br />
if ($h =~ m/^(\d+):\d+/)<br />
{<br />
$h = $1;<br />
}<br />
}<br />
else<br />
{<br />
$h = $fcHour;<br />
}<br />
<br />
$value = ReadingsVal($device, $reading, undef);<br />
<br />
# calculate minutes of sunshine per hour<br />
if ($fcValue =~ /^SunD(\d+)/)<br />
{<br />
if (defined($1))<br />
{<br />
$value = $value / ($1 * 36);<br />
}<br />
else<br />
{<br />
$value = $value / (12 * 36);<br />
}<br />
}<br />
<br />
# calculate amount of rain per hour<br />
if ($fcValue =~ /^RR(\d+)c$/)<br />
{<br />
if (defined($1))<br />
{<br />
$value /= $1;<br />
}<br />
}<br />
<br />
($year, $mon, $mday) = split('\-',ReadingsVal($device, "fc".$fcDay."_date",undef));<br />
$timestamp = sprintf("%04d-%02d-%02d_%02d:%02d:%02d", $year, $mon, $mday, $h, 0, 0);<br />
$sec = SVG_time_to_sec($timestamp);<br />
if (defined($shiftTime))<br />
{<br />
$sec += $shiftTime;<br />
$timestamp = logProxy_shiftTime($timestamp, $shiftTime);<br />
}<br />
<br />
# skip all values before start of plot range<br />
next if ( $sec < $fromsec );<br />
<br />
# add first value at start of plot range<br />
if ( !$ret && $prev_value )<br />
{<br />
$min = $prev_value if ( $prev_value < $min );<br />
$max = $prev_value if ( $prev_value > $max );<br />
$ret .= "$from $prev_value\n";<br />
}<br />
<br />
# done if after end of plot range<br />
last if ($sec > $tosec);<br />
<br />
$min = $value if ( $value < $min );<br />
$max = $value if ( $value > $max );<br />
<br />
# add actual control point<br />
$ret .= "$timestamp $value\n";<br />
}<br />
<br />
if (($sec < $tosec) && !@rl && ($expMode eq "day"))<br />
{<br />
$timestamp = sprintf("%04d-%02d-%02d_%02d:%02d:%02d", $year, $mon, $mday, 23, 59, 59);<br />
$_ = SVG_time_to_sec($timestamp);<br />
if (defined($shiftTime))<br />
{<br />
$_ += $shiftTime;<br />
$timestamp = logProxy_shiftTime($timestamp, $shiftTime);<br />
}<br />
<br />
if ($_ < $tosec)<br />
{<br />
$ret .= "$timestamp $value\n";<br />
}<br />
else<br />
{<br />
$ret .= "$to $value\n";<br />
}<br />
}<br />
elsif (($sec > $tosec) && ($expMode eq "day"))<br />
{<br />
$value = $prev_value + ($value - $prev_value) * (86400 + ($tosec - $sec)) / 86400;<br />
$ret .= "$to $value\n";<br />
}<br />
<br />
return ($ret, $min, $max, $prev_value);<br />
} <br />
<br />
1;<br />
</syntaxhighlight><br />
<br />
2. LogProxy<br />
<br />
Wer bereits ein [[logProxy]]-Device hat, muss den Namen seines logProxy-Devices in die weiter unter aufgeführte GPlot-Konfiguration eintragen. Ansonsten wird es wie folgt neu erstellt:<br />
<pre><br />
define LogProxy logProxy<br />
</pre><br />
<br />
3. FileLog<br />
<br />
Das Meteogramm kennt anders als andere FHEM-Plots keine Vergangenheit außer heute. Trotzdem wird aus formalen Gründen ein [[FileLog]]-Device benötigt. Dazu kann ein beliebiges vorhandenes FileLog-Device verwendet werden. Wer will, kann hierfür aber auch ein neues FileLog Device für das DWD_OpenData-Device anlegen (Achtung: wird schnell umfangreich):<br />
<pre><br />
define FileLog_DWD FileLog ./log/DWD-%Y-%m.log DWD<br />
</pre><br />
<br />
Im folgenden wird für das FileLog-Device der Platzhalter ''FileLog_Dummy'' verwendet, der mit dem Namen des gewählten FileLog-Devices zu ersetzen ist.<br />
<br />
4. SVG Plot<br />
<br />
Das eigentliche Meteogramm ist ein SVG-Device. Will man mehrere Tage darstellen bietet sich die folgende Definition an:<br />
<pre><br />
define SVG_DWD SVG FileLog_Dummy:SVG_DWD:CURRENT<br />
attr SVG_DWD fixedoffset 6<br />
attr SVG_DWD fixedrange 7days<br />
attr SVG_DWD nrAxis 1,2<br />
</pre><br />
<br />
Dabei muss das SVG-Attribut ''fixedoffset'' entweder gleich oder kleiner als die Einstellung des DWD_OpenData-Attributs ''forecastDays'' (Standardwert: 6 Tage) gewählt werden und das SVG-Attribut ''fixedrange'' um eins größer als ''fixedoffset'' eingestellt werden.<br />
<br />
Will man stattdessen nur die nächsten 24 Stunden anzeigen, nimmt man folgende Einstellungen:<br />
<pre><br />
define SVG_DWD SVG FileLog_Dummy:SVG_DWD:CURRENT<br />
attr SVG_DWD endPlotNow 1<br />
attr SVG_DWD fixedoffset 1<br />
attr SVG_FileLog_WETTER_DWD_3 label "Tmin: $data{max1} °C, Tmax: $data{min1} °C"<br />
attr SVG_DWD nrAxis 1,2<br />
</pre><br />
<br />
Um die DWD_OpenData-Readings mit dem Plot zu verknüpfen, muss man nun die GPlot-Konfigurationsdatei des SVG-Plots manuell bearbeiten. Dazu auf den Link klicken, der im SVG_DWD-Device am Internal ''GPLOTFILE'' steht. Die y-Wertebereiche für die Regenmenge und die Temperaturen sind im Beispiel auskommentiert (Autorange). Das kann man so lassen oder man stellt sie nach den eigenen Wetter-Gegebenheiten ein. Je nach Konfiguration des DWD_OpenData-Attributs ''forecastResolution'' sind aber noch einige weitere Einstellungen anzupassen. Das folgende Beispiel ist für die 3h-Auflösung:<br />
<pre><br />
set terminal png transparent size <SIZE> crop<br />
set output '<OUT>.png'<br />
set xdata time<br />
set timefmt "%Y-%m-%d_%H:%M:%S"<br />
set xlabel " "<br />
set title 'Wettervorhersage'<br />
set ytics <br />
set y2tics <br />
set grid ytics<br />
set ylabel "Regen [mm]"<br />
#set yrange [0:4]<br />
set y2label "Temperatur [°C]"<br />
#set y2range [-5:35]<br />
set y3label "Wolken/Regen/Sonne [%]"<br />
set y3range [0:100]<br />
<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","TTT_",$from,$to,0,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Tx",$from,$to,18,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Tn",$from,$to,6,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","SunD3_",$from,$to,0,"day",(-3*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","RR3c_",$from,$to,0,"day",(-3*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","FX1_",$from,$to,0,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","R600_",$from,$to,0,"day",(-3*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Neff_",$from,$to,0,"day")<br />
#LogProxy ConstX:TimeNow(),0,100<br />
#LogProxy ConstY:0<br />
<br />
plot "<IN>" using 1:2 axes x1y2 title 'T' ls l0 lw 2 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y2 title 'Tmax' ls l0dot lw 2 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y2 title 'Tmin' ls l0dot lw 2 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 title 'Sonne' ls l4fill lw 1 with lines,\<br />
"<IN>" using 1:2 axes x1y1 title 'Regenmenge' ls l2fill lw 1 with steps,\<br />
"<IN>" using 1:2 axes x1y3 title 'Wind' ls l1 lw 1 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 title 'Regen' ls l5fill lw 1 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 title 'Wolken' ls l6fill lw 1 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 notitle ls l5 lw 4 with lines,\<br />
"<IN>" using 1:2 axes x1y2 notitle ls l5 lw 1 with lines<br />
</pre><br />
<br />
Verwendet man dagegen eine Auflösung von 1 Stunde, sind folgende LogProxy-Einträge erforderlich:<br />
<pre><br />
#LogProxy Func:logProxy_dwd2Plot("DWD","TTT_",$from,$to,0,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Tx",$from,$to,18,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Tn",$from,$to,6,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","SunD1_",$from,$to,0,"day",(-1*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","RR1c_",$from,$to,0,"day",(-1*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","FX1_",$from,$to,0,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","R101_",$from,$to,0,"day",(-0.5*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Neff_",$from,$to,0,"day")<br />
#LogProxy ConstX:TimeNow(),0,100<br />
#LogProxy ConstY:0<br />
</pre><br />
<br />
Für die Darstellung der nächsten 24 Stunden mit einer Auflösung von 1 Stunde nimmt man folgende GPlot-Konfiguration:<br />
<pre><br />
set terminal png transparent size <SIZE> crop<br />
set output '<OUT>.png'<br />
set xdata time<br />
set timefmt "%Y-%m-%d_%H:%M:%S"<br />
set xlabel " "<br />
set title '<L1>'<br />
set ytics<br />
set y2tics<br />
set y3tics<br />
set grid xtics y2tics<br />
set ylabel "Regen [mm]"<br />
set y2label "Temperatur [°C]"<br />
set y3label "Wolken/Regen/Sonne [%]"<br />
set y3range [0:100]<br />
<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","TTT_",$from,$to,0,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","SunD1_",$from,$to,0,"day",(-1*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","RR1c_",$from,$to,0,"day",(-1*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","FX1_",$from,$to,0,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","R101_",$from,$to,0,"day",(-0.5*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Neff_",$from,$to,0,"day")<br />
#LogProxy ConstY:0<br />
<br />
plot "<IN>" using 1:2 axes x1y2 title 'T' ls l0 lw 2 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 title 'Sonne' ls l4fill lw 1 with lines,\<br />
"<IN>" using 1:2 axes x1y1 title 'Regenmenge' ls l2fill lw 1 with steps,\<br />
"<IN>" using 1:2 axes x1y3 title 'Wind' ls l1 lw 1 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 title 'Regen' ls l5fill lw 1 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 title 'Wolken' ls l6fill lw 1 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y2 notitle ls l2 lw 2 with lines<br />
</pre><br />
<br />
Je nachdem, welche Auflösung man verwendet, werden unterschiedliche Readings des DWD_OpenData-Devices benötigt. Diese sind in den LogProxy-Zeilen in der GPlot-Konfigurationsdatei zu finden und müssen auf jeden Fall dem Attribut ''forecastProperties'' des DWD_OpenData-Device hinzugefügt werden.<br />
<br />
Viele Detaileinstellungen des Meteogramms lassen sich individualisieren. Man kann z.B. mehr oder weniger Daten anzeigen und zumindest für ''heute'' auch aktuelle Messwerte hinzufügen.<br />
<br />
Hier ein Beispiel für ein Meteogramm über 4 Tage mit 3 Stunden Auflösung:<br />
<br />
[[File:DWDODmeteogram4d3h.png|500px]]<br />
<br />
<br />
=== Beispiel für die Einrichtung eines Weblinks ===<br />
Zur graphischen Darstellung der Vorhersage und der Wetterwarnungen mit [[FHEMWEB]] steht das Modul [https://raw.githubusercontent.com/jnsbyr/fhem/master/FHEM/98_DWD_OpenData_Weblink.pm 98_DWD_OpenData_Weblink.pm] zur Verfügung.<br />
<br />
Zunächst die Moduldatei herunterladen und in das Modulverzeichnis ''fhem/FHEM'' kopieren. Entweder die Datei direkt auf den FHEM-Server herunterladen (z.B. mit ''wget'') oder beim indirekten Herunterladen darauf achten, dass dabei das Encoding nicht verändert wird (also z.B. bei WinSCP den Binär-Modus und nicht den Text-Modus verwenden). Ansonsten werden später z.B. Sonderzeichen wie ''°C'' falsch angezeigt. <br />
<br />
Anschließend kann in die [[Konfiguration]] z.B. folgendes eingetragen werden:<br />
<br />
<pre><br />
define DWD_Weblink_Generator DWD_OpenData_Weblink<br />
attr DWD_Weblink_Generator IODev DWD<br />
attr DWD_Weblink_Generator forecastDays 4<br />
# refreshRate nur dann setzten, wenn der Browser Java-Script beherrscht:<br />
attr DWD_Weblink_Generator refreshRate 900<br />
<br />
define DWD_Weblink weblink htmlCode { DWD_OpenData_Weblink::AsHtmlH("DWD_Weblink_Generator") } <br />
</pre><br />
<br />
Damit legt man das Weblink-Generator-Device an und verknüpft es mit dem DWD_OpenData-Device. Außerdem wird der [[weblink ]] selbst angelegt, der seinerseits mit dem Weblink-Generator-Device verknüpft wird. Der Weblink benötigt für seine Funktion eine bestimmte Auswahl der Vorhersage-Merkmale. Wer das Attribut ''forecastProperties'' des DWD_OpenData-Moduls anpassen will, muss diese Merkmale auf jeden Fall mit berücksichtigen. <br />
<br />
Wenn vom Weblink nichts im Browser zu sehen ist, kann das daran liegen, dass der Browser kein aktuelles JavaScript verwendet oder JavaScript deaktiviert ist. Dann sollte das Attribut ''refreshRate'' auf 0 Sekunden eingestellt oder gelöscht werden. Mit aktiviertem Refresh werden die Daten auch ohne Seitenneuaufbau regelmäßig und bei Tab-Wechsel aktualisiert.<br />
<br />
Die Liste der erforderlichen Vorhersage-Merkmale finden sich zusammen mit allen weiteren Details zur Installation und Konfiguration in der Modulhilfe von ''98_DWD_OpenData_Weblink.pm'', die man z.B. nach dem Anlegen des Weblink-Generator-Devices über die Weboberfläche abrufen kann.<br />
<br />
Hier ein Ausschnitt aus der Darstellung des Weblinks mit [[FHEMWEB]]:<br />
<br />
[[File:DWDODweblink.png|500px]]</div>JensBhttp://wiki.fhem.de/w/index.php?title=DWD_OpenData&diff=37057DWD OpenData2022-01-09T18:34:16Z<p>JensB: </p>
<hr />
<div>{{Hinweis|Versionsänderung: Die Vorhersagedaten wurden Mitte September 2018 von CSV auf KML umgestellt. Diese Umstellung ist inkompatibel: das DWD_OpenData-Modul muss aktualisiert werden, einige Reading-Namen haben sich geändert und der Weblink muss deinstalliert und neu installiert werden (siehe diesen {{Link2Forum|Topic=83097|Message=840270|Linktext=Beitrag im Forum}}).}}<br />
<br />
{{Infobox Modul<br />
|ModPurpose=Daten vom DWD OpenData Server abrufen<br />
|ModType=d<br />
|ModCmdRef=DWD_OpenData<br />
|ModForumArea=Unterstützende Dienste/Wettermodule<br />
|ModTechName=55_DWD_OpenData.pm<br />
|ModOwner=JensB ({{Link2FU|14024|Forum}}/[[Benutzer Diskussion:JensB|Wiki]])<br />
}}<br />
<br />
Der Deutsche Wetterdienst (DWD) stellt Wetterdaten über den [https://www.dwd.de/DE/leistungen/opendata/opendata.html Open Data Server] zur Verfügung. Die Verwendung dieses Dienstes und der vom DWD zur Verfügung gestellten Daten unterliegt den auf der OpenData Webseite beschriebenen Bedingungen. Einen Überblick über die verfügbaren Daten findet man in der Tabelle [https://www.dwd.de/DE/leistungen/opendata/help/inhalt_allgemein/opendata_content_de_en_xls.xls OpenData_weather_content.xls].<br />
<br />
== Anwendung ==<br />
Aufgrund der unterschiedlichen vom DWD bereitgestellten Datenformate benötigt das Modul zur Dekodierung je nach gewünschtem Funktionsumfang zusätzliche Perl-Module, die nicht standardmäßig vorinstalliert sind und je nach Systemkonfiguration nachinstalliert werden müssen. Außerdem unterstützt das Modul Zeitzonen, um z.B. die Wettervorhersage internationaler Stationen in Ortszeit darstellen zu können. Hierfür sind je nach Systemkonfiguration weitere Einstellungen erforderlich. Auch die Sprache der Wochentage für die Wettervorhersage ist frei wählbar. Je nach Systemkonfiguration ist aber die Standardsprache u.U. auf Englisch eingestellt, was weitere Anpassungen der Systemkonfiguration erforderlich macht.<br />
<br />
=== Vorbereitung ===<br />
Im folgenden wird z.T. von einem System mit Rasbian oder Debian mit System-V Startsystem ausgegangen. Auf anderen Betriebssystemen und auf Systemen mit System-D müssen die Installationsschritte ggf. angepasst werden.<br />
<br />
1. Für die Wettervorhersage und die Wetterwarnungen:<br />
Installation des Perl-Moduls ''XML::LibXML'' über die System-Kommandozeile mit<br />
<source lang="bash"><br />
sudo apt-get install libxml-libxml-perl<br />
</source> <br />
oder mit CPAN.<br />
<br />
2. Weiterhin ist das Perl-Modul '' DateTime'' erforderlich. Dieses lässt sich mit <source lang="bash">sudo apt-get install libdatetime-perl</source> installieren.<br />
<br />
3. Falls man einen eigenen Internet-Proxy nutzt:<br />
Die Konfiguration des Proxies für FHEM erfolgt z.B. durch Eintrag von<br />
<pre><br />
attr global proxy <myProxyHost>:<myProxyPort><br />
</pre> <br />
in die [[Konfiguration]], wobei ''myProxyHost'' durch den Namen oder die IP-Adresse des Proxy-Servers ersetzt werden muss und für ''myProxyPort'' der Port des Proxy-Servers eingetragen werden muss (oft 3128).<br />
<br />
3. FHEM Uhrzeit und Zeitzone:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre><br />
in die FHEM-Kommandozeile überprüfen, ob die FHEM-Uhrzeit plausibel ist. Ist dies nicht der Fall sollten die Uhrzeit auf Systemebene überprüft werden und ggf. die Systemeinstellungen angepasst werden.<br />
Ermitteln der Bezeichnung der eigenen Zeitzone über die System-Kommandozeile mit<br />
<pre><br />
tzselect<br />
</pre><br />
und diese Bezeichnung in die Datei ''/etc/timezone'' eintragen und <br />
<pre><br />
export TZ=`cat /etc/timezone`<br />
</pre><br />
der Datei ''/etc/profile'' hinzufügen und dann das System neu starten. Nun muss die Zeitanzeige in FHEM korrekt sein.<br />
<br />
4. FHEM Sprache:<br />
Durch Eingabe von <br />
<pre><br />
{$ENV{LANG}}<br />
</pre> in die FHEM-Kommandozeile überprüfen, in welcher Sprache der Wochentag angezeigt wird. Stimmt die Sprache nicht, dann auf der System-Kommandozeile<br />
<pre><br />
dpkg-reconfigure locales<br />
</pre> eingeben und aus der Liste z.B. ''de_DE.UTF-8'' zusätzlich auswählen. Dieser Befehl gilt für Debian-basierte Betriebssysteme - für andere Betriebssysteme ist eine analoge Funktion zu verwenden. Mit Eingabe von <br />
<pre><br />
locale -a<br />
</pre> auf der System-Kommandozeile überprüfen, ob die ausgewählte Sprache nun zur Verfügung steht. Sollte FHEM nach einem Neustart noch immer nicht die gewünschte Sprache verwenden, kann man auf einem System V Linux durch Hinzufügen von z.B.<br />
<pre><br />
export LANG=de_DE.UTF-8<br />
</pre> in die Datei ''/etc/init.d/fhem'' (irgendwo zwischen ''start'' und ''perl'') und erneutem Neustart von FHEM die Sprache für FHEM erzwingen. Bei einem Systemd Linux kann man die Einstellungen mit ''systemctl edit --full fhem.service'' bearbeiten. Spätestes jetzt muss die Wochentagsanzeige in FHEM korrekt sein.<br />
<br />
5. Nur für den Weblink erforderlich:<br />
Installation des Perl-Moduls ''DateTime'' über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libdatetime-perl<br />
</pre> <br />
oder mit CPAN.<br />
<br />
=== Define ===<br />
Siehe {{Link2CmdRef|Anker=DWD_OpenDatadefine|Label=Commandref}}.<br />
<br />
=== Attributes ===<br />
Siehe {{Link2CmdRef|Anker=DWD_OpenDataattr|Label=Commandref}}.<br />
<br />
== Anwendungsbeispiele ==<br />
=== Beispiel zur Modul-Einrichtung ===<br />
<br />
* Wettervorhersage<br />
Für die Wettervorhersage muss der Stationscode ermittelt werden. Dazu den [https://www.dwd.de/DE/leistungen/met_verfahren_mosmix/mosmix_stationskatalog.pdf MOSMIX Stationskatalog] herunterladen, öffnen und die gewünschte Station heraussuchen (Spalte ''id''). Einen Teil der deutschen Stationen kann man auch der [https://www.dwd.de/DE/derdwd/messnetz/bodenbeobachtung/messnetzkarte_boden.pdf Bodenmessnetzkarte] entnehmen. Den ermittelten Stationscode kann man dann entweder für eine Einzelabfrage als Parameter für das Kommando ''get forecast'' verwenden oder für die automatische Aktualisierung als Attribut ''forecastStation'' hinterlegen. Insgesamt werden vom DWD mehr als 70 Merkmale zur Verfügung gestellt. Eine Auflistung findet sich im Dokument [https://opendata.dwd.de/weather/lib/MetElementDefinition.xml MetElementDefinition]. Nur ein kleiner Teil der Merkmale wird in der Standardeinstellung des Moduls als Reading zur Verfügung gestellt. Wer andere Merkmale benötigt muss sie mit Komma getrennt dem Attribut ''forecastProperties'' zuweisen. Es empfiehlt sich zur Performance-Optimierung sowohl das Attribut ''forecastDays'' als auch das Attribut ''forecastProperties'' auf den tatsächlichen Bedarf einzustellen.<br />
<br />
* Wetterwarnungen<br />
Für die Wetterwarnungen muss die Warnzelle ermittelt werden. Dazu [https://www.dwd.de/DE/leistungen/opendata/help/warnungen/cap_warncellids_csv.csv Warnzellen-ID Katalog] herunterladen, öffnen und die gewünschte Warnzelle heraussuchen. Unterstützt werden Gemeinden (beginnen mit 8), Landkreise (beginnen mit 1 oder 9) oder Küste (beginnen mit 5). Die Warnzellen-ID kann man dann entweder für eine Einzelabfrage als Parameter für das Kommando ''get alerts'' verwenden oder für die automatische Aktualisierung als Attribut ''alertArea'' hinterlegen. Die Warnzellen-ID ist ab der 2. Stelle identisch mit den ersten Ziffern des amtlichen Gemeindeschlüssels. Man kann z.B. den Namen von Gemeinde oder Landkreis bei den [https://www.statistik-bw.de/Statistik-Portal/gemeindeverz.asp Statistischen Ämtern des Bundes und der Länder] eingeben, den amtlichen Gemeindeschlüssel ermitteln und dann mit vorangestellter 1, 8 oder 9 im Warnzellen-ID Katalog des DWD nach einem Eintrag mit exakter oder weitgehender Übereinstimmung suchen. Wem das zu kompliziert vorkommt, der kann bei mehrdeutigen Gemeinde- bzw. Landkreisbezeichnungen auch versuchen auszuprobieren, welche die richtige Warnzellen-ID ist.<br />
<br />
Um das Modul mit automatisch Aktualisierung von Vorhersage und Wetterwarnungen zu nutzen, kann z.B. folgendes in die [[Konfiguration]] eingetragen werden:<br />
<br />
<pre><br />
define DWD DWD_OpenData<br />
attr DWD alertArea 111000000<br />
attr DWD forecastStation 99810<br />
attr DWD forecastDays 3<br />
attr DWD forecastWW2Text 1<br />
</pre><br />
<br />
* Performance<br />
Das DWD_OpenData-Modul ist ein Datenmodul mit relativ vielen Readings. In der Standardkonfiguration wird, wie bei jedem anderen FHEM Modul, bei jeder Änderung jedes Readings ein FHEM internes Ereignis erzeugt, damit andere FHEM Devices auf diese Änderungen reagieren können. Diese Ereignisse sorgen auch dafür, dass man Änderungen in der Weboberfläche sofort angezeigt bekommt, ohne die Webseite neu aufzurufen. Interessiert sich aber kein FHEM Device für die Änderungsbenachrichtigung bestimmter Readings, entsteht unnötiger Verarbeitungs-Overhead, der je nach FHEM Konfiguration und verfügbarer CPU-Leistung auch mehrere Sekunden benötigen kann und in dieser Zeit andere Abläufe blockiert. Um die Performance zu optimieren, empfiehlt es sich, mit [[event-on-update-reading]] für eine angepasste und dadurch effizientere Verarbeitung zu sorgen, indem man nur für jene Readings Ereignisse zulässt, welche man für die Weiterverarbeitung braucht. Der DWD_OpenData_Weblink braucht z.B. gar keine Ereignisse, um zu funktionieren. Hier eine minimalistische Beispielkonfiguration:<br />
<br />
<pre><br />
attr DWD event-on-update-reading state,fc_state,a_state<br />
</pre><br />
<br />
Weitere Details zur Installation und Konfiguration des Moduls finden sich in der<br />
{{Link2CmdRef|Anker=DWD_OpenData|Label=Commandref}}.<br />
<br />
=== Beispiel für die Einrichtung eines Meteogramms ===<br />
Um den vorhergesagten Wetterverlauf als Meteogramm in Kurvenform mit [[SVG]] darzustellen, kann man wie folgt vorgehen:<br />
<br />
1. 99_myUtils.pm<br />
<br />
Für die Bestimmung der Werte für den SVG-Plot wird eine Perl-Funktion benötigt, die in die Datei 99_myUtils.pm vor dem Ende eingefügt wird. Wer diese FHEM-Datei noch nicht nutzt, legt sie einfach an (siehe [[99_myUtils_anlegen]]).<br />
<source lang="perl"><br />
package main;<br />
<br />
use strict;<br />
use warnings;<br />
<br />
...<br />
<br />
#<br />
# (c) mumpitzstuff 19.12.2018<br />
#<br />
# see https://forum.fhem.de/index.php/topic,83097.msg874150.html#msg874150<br />
#<br />
sub logProxy_dwd2Plot($$$$;$$$)<br />
{<br />
my ($device, $fcValue, $from, $to, $fcHour, $expMode, $shiftTime) = @_;<br />
my $regex;<br />
my @rl;<br />
<br />
return undef if(!$device);<br />
<br />
if ($fcValue =~ s/_$//)<br />
{<br />
$regex = "^fc[\\d]+_[\\d]+_".$fcValue."\$";<br />
}<br />
else<br />
{<br />
$regex = "^fc[\\d]+_".$fcValue."\$";<br />
}<br />
<br />
$fcHour = 12 if(!defined($fcHour));<br />
$expMode = "point" if(!defined($expMode));<br />
#Log3 undef,2, "Regex: ".$regex;<br />
<br />
# ermitteln aller relevanten Readings<br />
if ( defined($defs{$device}) )<br />
{<br />
if ( $defs{$device}{TYPE} eq "DWD_OpenData" )<br />
{<br />
@rl = sort<br />
{<br />
my ($an) = ($a =~ m/fc(\d+)_.*/);<br />
my ($bn) = ($b =~ m/fc(\d+)_.*/);<br />
my ($ao) = ($a =~ m/fc\d+_(\d+).*/);<br />
my ($bo) = ($b =~ m/fc\d+_(\d+).*/);<br />
$an <=> $bn or $ao <=> $bo or $a cmp $b;<br />
} ( grep /${regex}/,keys %{$defs{$device}{READINGS}} );<br />
return undef if ( !@rl );<br />
}<br />
else<br />
{<br />
Log3 undef, 2, "logProxy_dwd2Plot: $device is not a DWD_OpenData device";<br />
return undef;<br />
}<br />
}<br />
<br />
my $fromsec = SVG_time_to_sec($from);<br />
my $tosec = SVG_time_to_sec($to);<br />
my $sec = $fromsec;<br />
my ($h, $hp, $fcDay, $mday, $mon, $year);<br />
my $timestamp;<br />
<br />
my $reading;<br />
my $value;<br />
my $prev_value;<br />
my $min = 999999;<br />
my $max = -999999;<br />
my $ret = "";<br />
<br />
# while not end of plot range reached<br />
while (($sec < $tosec) && @rl)<br />
{<br />
#remember previous value for start of plot range<br />
$prev_value = $value;<br />
<br />
$reading = shift @rl;<br />
($fcDay) = $reading =~ m/^fc(\d+).*/;<br />
($hp) = $reading =~ m/^fc\d+_(\d+).*/;<br />
#Log 1, "hp: ".$hp;<br />
<br />
if ($hp)<br />
{<br />
$h = ReadingsVal($device, "fc".$fcDay."_".$hp."_time", $fcHour);<br />
if ($h =~ m/^(\d+):\d+/)<br />
{<br />
$h = $1;<br />
}<br />
}<br />
else<br />
{<br />
$h = $fcHour;<br />
}<br />
<br />
$value = ReadingsVal($device, $reading, undef);<br />
<br />
# calculate minutes of sunshine per hour<br />
if ($fcValue =~ /^SunD(\d+)/)<br />
{<br />
if (defined($1))<br />
{<br />
$value = $value / ($1 * 36);<br />
}<br />
else<br />
{<br />
$value = $value / (12 * 36);<br />
}<br />
}<br />
<br />
# calculate amount of rain per hour<br />
if ($fcValue =~ /^RR(\d+)c$/)<br />
{<br />
if (defined($1))<br />
{<br />
$value /= $1;<br />
}<br />
}<br />
<br />
($year, $mon, $mday) = split('\-',ReadingsVal($device, "fc".$fcDay."_date",undef));<br />
$timestamp = sprintf("%04d-%02d-%02d_%02d:%02d:%02d", $year, $mon, $mday, $h, 0, 0);<br />
$sec = SVG_time_to_sec($timestamp);<br />
if (defined($shiftTime))<br />
{<br />
$sec += $shiftTime;<br />
$timestamp = logProxy_shiftTime($timestamp, $shiftTime);<br />
}<br />
<br />
# skip all values before start of plot range<br />
next if ( $sec < $fromsec );<br />
<br />
# add first value at start of plot range<br />
if ( !$ret && $prev_value )<br />
{<br />
$min = $prev_value if ( $prev_value < $min );<br />
$max = $prev_value if ( $prev_value > $max );<br />
$ret .= "$from $prev_value\n";<br />
}<br />
<br />
# done if after end of plot range<br />
last if ($sec > $tosec);<br />
<br />
$min = $value if ( $value < $min );<br />
$max = $value if ( $value > $max );<br />
<br />
# add actual control point<br />
$ret .= "$timestamp $value\n";<br />
}<br />
<br />
if (($sec < $tosec) && !@rl && ($expMode eq "day"))<br />
{<br />
$timestamp = sprintf("%04d-%02d-%02d_%02d:%02d:%02d", $year, $mon, $mday, 23, 59, 59);<br />
$_ = SVG_time_to_sec($timestamp);<br />
if (defined($shiftTime))<br />
{<br />
$_ += $shiftTime;<br />
$timestamp = logProxy_shiftTime($timestamp, $shiftTime);<br />
}<br />
<br />
if ($_ < $tosec)<br />
{<br />
$ret .= "$timestamp $value\n";<br />
}<br />
else<br />
{<br />
$ret .= "$to $value\n";<br />
}<br />
}<br />
elsif (($sec > $tosec) && ($expMode eq "day"))<br />
{<br />
$value = $prev_value + ($value - $prev_value) * (86400 + ($tosec - $sec)) / 86400;<br />
$ret .= "$to $value\n";<br />
}<br />
<br />
return ($ret, $min, $max, $prev_value);<br />
} <br />
<br />
1;<br />
</source><br />
<br />
2. LogProxy<br />
<br />
Wer bereits ein [[logProxy]]-Device hat, muss den Namen seines logProxy-Devices in die weiter unter aufgeführte GPlot-Konfiguration eintragen. Ansonsten wird es wie folgt neu erstellt:<br />
<pre><br />
define LogProxy logProxy<br />
</pre><br />
<br />
3. FileLog<br />
<br />
Das Meteogramm kennt anders als andere FHEM-Plots keine Vergangenheit außer heute. Trotzdem wird aus formalen Gründen ein [[FileLog]]-Device benötigt. Dazu kann ein beliebiges vorhandenes FileLog-Device verwendet werden. Wer will, kann hierfür aber auch ein neues FileLog Device für das DWD_OpenData-Device anlegen (Achtung: wird schnell umfangreich):<br />
<pre><br />
define FileLog_DWD FileLog ./log/DWD-%Y-%m.log DWD<br />
</pre><br />
<br />
Im folgenden wird für das FileLog-Device der Platzhalter ''FileLog_Dummy'' verwendet, der mit dem Namen des gewählten FileLog-Devices zu ersetzen ist.<br />
<br />
4. SVG Plot<br />
<br />
Das eigentliche Meteogramm ist ein SVG-Device. Will man mehrere Tage darstellen bietet sich die folgende Definition an:<br />
<pre><br />
define SVG_DWD SVG FileLog_Dummy:SVG_DWD:CURRENT<br />
attr SVG_DWD fixedoffset 6<br />
attr SVG_DWD fixedrange 7days<br />
attr SVG_DWD nrAxis 1,2<br />
</pre><br />
<br />
Dabei muss das SVG-Attribut ''fixedoffset'' entweder gleich oder kleiner als die Einstellung des DWD_OpenData-Attributs ''forecastDays'' (Standardwert: 6 Tage) gewählt werden und das SVG-Attribut ''fixedrange'' um eins größer als ''fixedoffset'' eingestellt werden.<br />
<br />
Will man stattdessen nur die nächsten 24 Stunden anzeigen, nimmt man folgende Einstellungen:<br />
<pre><br />
define SVG_DWD SVG FileLog_Dummy:SVG_DWD:CURRENT<br />
attr SVG_DWD endPlotNow 1<br />
attr SVG_DWD fixedoffset 1<br />
attr SVG_FileLog_WETTER_DWD_3 label "Tmin: $data{max1} °C, Tmax: $data{min1} °C"<br />
attr SVG_DWD nrAxis 1,2<br />
</pre><br />
<br />
Um die DWD_OpenData-Readings mit dem Plot zu verknüpfen, muss man nun die GPlot-Konfigurationsdatei des SVG-Plots manuell bearbeiten. Dazu auf den Link klicken, der im SVG_DWD-Device am Internal ''GPLOTFILE'' steht. Die y-Wertebereiche für die Regenmenge und die Temperaturen sind im Beispiel auskommentiert (Autorange). Das kann man so lassen oder man stellt sie nach den eigenen Wetter-Gegebenheiten ein. Je nach Konfiguration des DWD_OpenData-Attributs ''forecastResolution'' sind aber noch einige weitere Einstellungen anzupassen. Das folgende Beispiel ist für die 3h-Auflösung:<br />
<pre><br />
set terminal png transparent size <SIZE> crop<br />
set output '<OUT>.png'<br />
set xdata time<br />
set timefmt "%Y-%m-%d_%H:%M:%S"<br />
set xlabel " "<br />
set title 'Wettervorhersage'<br />
set ytics <br />
set y2tics <br />
set grid ytics<br />
set ylabel "Regen [mm]"<br />
#set yrange [0:4]<br />
set y2label "Temperatur [°C]"<br />
#set y2range [-5:35]<br />
set y3label "Wolken/Regen/Sonne [%]"<br />
set y3range [0:100]<br />
<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","TTT_",$from,$to,0,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Tx",$from,$to,18,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Tn",$from,$to,6,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","SunD3_",$from,$to,0,"day",(-3*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","RR3c_",$from,$to,0,"day",(-3*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","FX1_",$from,$to,0,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","R600_",$from,$to,0,"day",(-3*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Neff_",$from,$to,0,"day")<br />
#LogProxy ConstX:TimeNow(),0,100<br />
#LogProxy ConstY:0<br />
<br />
plot "<IN>" using 1:2 axes x1y2 title 'T' ls l0 lw 2 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y2 title 'Tmax' ls l0dot lw 2 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y2 title 'Tmin' ls l0dot lw 2 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 title 'Sonne' ls l4fill lw 1 with lines,\<br />
"<IN>" using 1:2 axes x1y1 title 'Regenmenge' ls l2fill lw 1 with steps,\<br />
"<IN>" using 1:2 axes x1y3 title 'Wind' ls l1 lw 1 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 title 'Regen' ls l5fill lw 1 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 title 'Wolken' ls l6fill lw 1 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 notitle ls l5 lw 4 with lines,\<br />
"<IN>" using 1:2 axes x1y2 notitle ls l5 lw 1 with lines<br />
</pre><br />
<br />
Verwendet man dagegen eine Auflösung von 1 Stunde, sind folgende LogProxy-Einträge erforderlich:<br />
<pre><br />
#LogProxy Func:logProxy_dwd2Plot("DWD","TTT_",$from,$to,0,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Tx",$from,$to,18,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Tn",$from,$to,6,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","SunD1_",$from,$to,0,"day",(-1*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","RR1c_",$from,$to,0,"day",(-1*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","FX1_",$from,$to,0,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","R101_",$from,$to,0,"day",(-0.5*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Neff_",$from,$to,0,"day")<br />
#LogProxy ConstX:TimeNow(),0,100<br />
#LogProxy ConstY:0<br />
</pre><br />
<br />
Für die Darstellung der nächsten 24 Stunden mit einer Auflösung von 1 Stunde nimmt man folgende GPlot-Konfiguration:<br />
<pre><br />
set terminal png transparent size <SIZE> crop<br />
set output '<OUT>.png'<br />
set xdata time<br />
set timefmt "%Y-%m-%d_%H:%M:%S"<br />
set xlabel " "<br />
set title '<L1>'<br />
set ytics<br />
set y2tics<br />
set y3tics<br />
set grid xtics y2tics<br />
set ylabel "Regen [mm]"<br />
set y2label "Temperatur [°C]"<br />
set y3label "Wolken/Regen/Sonne [%]"<br />
set y3range [0:100]<br />
<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","TTT_",$from,$to,0,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","SunD1_",$from,$to,0,"day",(-1*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","RR1c_",$from,$to,0,"day",(-1*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","FX1_",$from,$to,0,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","R101_",$from,$to,0,"day",(-0.5*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Neff_",$from,$to,0,"day")<br />
#LogProxy ConstY:0<br />
<br />
plot "<IN>" using 1:2 axes x1y2 title 'T' ls l0 lw 2 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 title 'Sonne' ls l4fill lw 1 with lines,\<br />
"<IN>" using 1:2 axes x1y1 title 'Regenmenge' ls l2fill lw 1 with steps,\<br />
"<IN>" using 1:2 axes x1y3 title 'Wind' ls l1 lw 1 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 title 'Regen' ls l5fill lw 1 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 title 'Wolken' ls l6fill lw 1 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y2 notitle ls l2 lw 2 with lines<br />
</pre><br />
<br />
Je nachdem, welche Auflösung man verwendet, werden unterschiedliche Readings des DWD_OpenData-Devices benötigt. Diese sind in den LogProxy-Zeilen in der GPlot-Konfigurationsdatei zu finden und müssen auf jeden Fall dem Attribut ''forecastProperties'' des DWD_OpenData-Device hinzugefügt werden.<br />
<br />
Viele Detaileinstellungen des Meteogramms lassen sich individualisieren. Man kann z.B. mehr oder weniger Daten anzeigen und zumindest für ''heute'' auch aktuelle Messwerte hinzufügen.<br />
<br />
Hier ein Beispiel für ein Meteogramm über 4 Tage mit 3 Stunden Auflösung:<br />
<br />
[[File:DWDODmeteogram4d3h.png|500px]]<br />
<br />
<br />
=== Beispiel für die Einrichtung eines Weblinks ===<br />
Zur graphischen Darstellung der Vorhersage und der Wetterwarnungen mit [[FHEMWEB]] steht das Modul [https://raw.githubusercontent.com/jnsbyr/fhem/master/FHEM/99_DWD_OpenData_Weblink.pm 99_DWD_OpenData_Weblink.pm] zur Verfügung.<br />
<br />
Zunächst die Moduldatei herunterladen und in das Modulverzeichnis ''fhem/FHEM'' kopieren. Entweder die Datei direkt auf den FHEM-Server herunterladen (z.B. mit ''wget'') oder beim indirekten Herunterladen darauf achten, dass dabei das Encoding nicht verändert wird (also z.B. bei WinSCP den Binär-Modus und nicht den Text-Modus verwenden). Ansonsten werden später z.B. Sonderzeichen wie ''°C'' falsch angezeigt. <br />
<br />
Anschließend kann in die [[Konfiguration]] z.B. folgendes eingetragen werden:<br />
<br />
<pre><br />
define DWD_Weblink_Generator DWD_OpenData_Weblink<br />
attr DWD_Weblink_Generator IODev DWD<br />
attr DWD_Weblink_Generator forecastDays 4<br />
# refreshRate nur dann setzten, wenn der Browser Java-Script beherrscht:<br />
attr DWD_Weblink_Generator refreshRate 900<br />
<br />
define DWD_Weblink weblink htmlCode { DWD_OpenData_Weblink::AsHtmlH("DWD_Weblink_Generator") } <br />
</pre><br />
<br />
Damit legt man das Weblink-Generator-Device an und verknüpft es mit dem DWD_OpenData-Device. Außerdem wird der [[weblink ]] selbst angelegt, der seinerseits mit dem Weblink-Generator-Device verknüpft wird. Der Weblink benötigt für seine Funktion eine bestimmte Auswahl der Vorhersage-Merkmale. Wer das Attribut ''forecastProperties'' des DWD_OpenData-Moduls anpassen will, muss diese Merkmale auf jeden Fall mit berücksichtigen. <br />
<br />
Wenn vom Weblink nichts im Browser zu sehen ist, kann das daran liegen, dass der Browser kein aktuelles JavaScript verwendet oder JavaScript deaktiviert ist. Dann sollte das Attribut ''refreshRate'' auf 0 Sekunden eingestellt oder gelöscht werden. Mit aktiviertem Refresh werden die Daten auch ohne Seitenneuaufbau regelmäßig und bei Tab-Wechsel aktualisiert.<br />
<br />
Die Liste der erforderlichen Vorhersage-Merkmale finden sich zusammen mit allen weiteren Details zur Installation und Konfiguration in der Modulhilfe von ''99_DWD_OpenData_Weblink.pm'', die man z.B. nach dem Anlegen des Weblink-Generator-Devices über die Weboberfläche abrufen kann.<br />
<br />
Hier ein Ausschnitt aus der Darstellung des Weblinks mit [[FHEMWEB]]:<br />
<br />
[[File:DWDODweblink.png|500px]]</div>JensBhttp://wiki.fhem.de/w/index.php?title=Arduino_Firmata&diff=34120Arduino Firmata2020-10-25T19:28:02Z<p>JensB: Umstellung von Device::Firmata von FHEM auf CPAN, Liste der FRM-Client-Module vervollständigt</p>
<hr />
<div>{{Hinweis|Device::Firmata Updates: Bis Oktober 2020 wurde eine Kopie des Perl-Moduls ''Device::Firmata'' als Teil von FHEM zur Verfügung gestellt, zuletzt die Version 0.64 aus 05/2018. In neueren Installation von FHEM ist das Modul nicht mehr enthalten. Die aktuelle Version des Moduls gibt es über [[#CPAN|CPAN]]. Bei bestehenden Installationen sollte die vorhandene Kopie des Moduls gelöscht und auf die aktuelle Version umgestellt werden (siehe Punkt 1 dieses {{Link2Forum|Topic=114552|Message=1087982|Linktext=Beitrag}}s im Forum).<br />
}}<br />
<br />
{{<br />
Infobox Modul<br />
|ModPurpose=Schnittstelle für Firmata-Devices (USB, LAN, WiFi)<br />
|ModType=d<br />
|ModCmdRef=FRM<br />
|ModForumArea=Sonstige Systeme<br />
|ModTechName=10_FRM.pm<br />
|ModOwner=JensB ({{Link2FU|14024|Forum}}/[[Benutzer Diskussion:JensB|Wiki]])<br />
}}<br />
<br />
== Firmata-Devices ==<br />
<br />
Für Arduinos (und diverse kompatible Boards) gibt es eine Standardimplementierung des Kommunikationsprotokolls ''Firmata'' [https://github.com/firmata/protocol]. Mit Hilfe des Perl-Moduls ''Device::Firmata'', auch bekannt als perl-firmata [https://github.com/ntruchsess/perl-firmata], kann das Firmata-Protokoll in Perl genutzt werden und mit dem Modul [[#FRM|FRM]] auch in FHEM.<br />
<br />
Für die Kommunikation zwischen FHEM (Master) und Firmata-Device (Slave) stehen mehrere Schnittstellen zur Auswahl: RS-232, USB, Ethernet und WiFi. Insbesondere Ethernet und WiFi erlauben die Integration dezentraler IO-Periperie mit FHEM.<br />
<br />
Firmata möglich es, mit nur geringen Arduino-Kenntnissen digitale und analoge Signale aus eigenen Schaltungen in FHEM zu verarbeiten. Dabei können Signale sowohl eingelesen als auch ausgegeben werden. Ein Verständnis der Bedienung der Arduino-IDE und elektronische Kenntnisse zum Anschluss von Sensoren und Aktoren sind natürlich erforderlich.<br />
<br />
=== Arduino IDE ===<br />
<br />
Zur Installation von Firmware auf dem Firmata-Device wird natürlich erst mal die Arduino-IDE (Version 1.8 oder höher) benötigt [https://www.arduino.cc/en/main/software]. Die gibt es für die Betriebssysteme Windows, Mac OS X und Linux.<br />
<br />
Über die Bibliotheksverwaltung der Arduino-IDE (Menü 'Sketch'-&gt;'Bibliothek einbinden'-&gt;'Bibliotheken verwalten...') stehen verschiedene Firmware-Versionen von Firmata zur Auswahl. Im folgenden wird auf die Version "Firmata by Firmata Developers" und "ConfigurableFirmata by Firmata Developers" eingegangen. Diese beiden Versionen unterscheiden sich in den unterstützten Hardware-Funktionen:<br />
<br />
* Firmata: digitale und analoge I/Os, Servos, I2C<br />
* ConfigurableFirmata: zusätzlich 1-Wire und Schrittmotoren<br />
<br />
Bei ConfigurableFirmata ist es auch außerdem einfacher, nicht benötigte Funktionen zu deaktivieren, damit die Firmware möglichst wenig Speicher belegt. Wenn man den zusätzlichen Funktionsumfang von ConfigurableFirmata nicht benötigt, kann man mit etwas Geschick durch Auskommentieren von nicht benötigtem Code aus Firmata z.T. ein noch kompakteres Ergebnis erzielen (das ist aber nur etwas für Fortgeschrittene).<br />
<br />
Bei Firmata ist zwischen der Firmata-Protokoll-Version (z.B. 2.6.0) und der Version der jeweiligen Firmware (Firmata: z.B. 2.5.7, ConfigurableFirmata: z.B. 2.10.0) zu unterscheiden, die insbesondere bei ConfigurableFirmata voneinander unabhängig sind.<br />
<br />
Nach Installation der gewünschten Firmata-Firmware wählt man eines der funktionsfertigen Beispiele über das Arduino-IDE Menü 'Datei'-&gt;'Beispiele'-&gt;'Firmata' bzw. 'Datei'-&gt;'Beispiele'-&gt;'ConfigurableFirmata' aus. Je nach ausgewähltem Beispielprojekt sind noch Anpassungen direkt im Sketch oder in einer zusätzlichen Konfigurationsdatei erforderlich (z.B. um für Ethernet- und WiFi-Schnittstellen die Netzwerkparameter einzustellen).<br />
<br />
Über das Arduino-IDE Menü 'Werkzeuge'-&gt;'Bords' wählt man das Board aus, das dem eigenen Firmata-Device entspricht. Fehlt das Board in der Auswahl, kann die erforderliche Unterstützung oft über das Menü 'Werkzeuge'-&gt;'Bords'-&gt;'Boardverwalter...' nachinstalliert werden. Ansonsten hilft ein Blick auf die Hersteller-Webseiten des Boards.<br />
<br />
Ist das Firmata-Device korrekt angeschlossen, drückt man den 'Upload'-Knopf (der mit dem Rechspfeil oben links), um den Arduino-Sketch zu kompilieren und auf das Board hochzuladen. Die Vorgehensweise zum Hochladen ist sehr stark davon abhängig, welches Board man verwendet und mit welcher Technik es angeschlossen ist. Bitte die jeweiligen Angaben des Board-Herstellers beachten.<br />
<br />
Wer zum ersten mal mit der Arduino-IDE arbeitet, sollte statt Firmata zunächst das Standard Arduino Beispielprojekt 'Blink' auswählen und es auf dem Firmata-Device installieren. Sobald das klappt, kann man mit Firmata weiter machen.<br />
<br />
=== Firmata mit Ethernet oder WiFi ===<br />
<br />
Vor dem Kompilieren muss man unbedingt die Netzwerkparameter anpassen, d.h. die IP-Adresse des FHEM-Servers und den Port des FRM-Moduls eintragen (ggf. auch eine neue eindeutige MAC-Adresse), bei WiFi auch die SSID und den PSK. In älteren Firmata-Versionen und bei ConfigurableFirmata geschieht das direkt im Sketch. Aktuelle Firmata-Versionen haben dazu eine getrennte Konfigurationsdatei (ethernetConfig.h bzw. wifiConfig.h), so dass keine Änderungen am Sketch erforderlich sind.<br />
<br />
Falls der Speicherbedarf der kompilierten Firmware die Möglichkeiten des Boards übersteigt (insbesondere bei Verwendung eines ENC28J60-Ethernet-Shields [https://github.com/ntruchsess/arduino_uip] in Kombination mit einem "kleinen" Arduiono wie den Uno oder Nano) kann man bei Verwendung von ConfigurableFirmata nicht benötigten Features im Sketch auskommentieren. Wenn der Speicherbedarf nur "knapp" ausreicht, läuft die Firmware u.U. trotzdem nicht zuverlässig.<br />
<br />
Als ersten Funktionstest für die Netzwerkverbindung empfiehlt sich ein Ping von FHEM zum Firmata-Device.<br />
<br />
=== Sonderfälle ===<br />
<br />
Je nach verwendetem Board sind u.U. individuelle Besonderheiten zu berücksichtigen. Hier ein paar Beispiele:<br />
<br />
Ein MEGA256 z.B. benutzt einen anderen Pin als SS (Slave select) zur Kommunikation mit dem Ethernetmodul. Man muss der Firmata im Setup mitteilen, welche Pins zu ignorieren sind, damit es keine Wechselwirkungen zwischen Firmata und Ethernet Library gibt. Das ist im ConfigurableFirmata-Sketch [https://github.com/firmata/arduino/blob/configurable/examples/ConfigurableFirmata/ConfigurableFirmata.ino] vorbereitet und muss (wenn man etwas anderes als ein Standard-Ethernetshield am Uno verwendet) geeignet angepasst werden (Beim Mega muss man z.B. den Pin 10 ignorieren und Pin 53 als hardcodiert auf Output stellen). Das gleiche gilt, wenn man eine andere Hardware (z.B. mit ENC28J60 anstelle des WizNet W5100 des Ethernetshields) benutzen möchte, die einen anderen Pin als CS/SS benutzt.<br />
<br />
== FHEM FRM-Device ==<br />
<br />
Bei FHEM stellt ein FRM-Device (Modul 10_FRM.pm) für die FRM-Client-Devices die Schnittstelle (das IODev) zum Firmata-Device zur Verfügung. Jeder FRM-Client erlaubt die Konfiguration eines oder mehrerer Pins eines Firmata-Devices z.B. als analoger Eingang, digitaler Ausang oder I2C-Bus. Es können so viele FRM-Clients für ein FRM-Device definiert werden, bis alle Pins zugeordnet sind. Dabei muss man darauf achten, dass nicht alle Pins alle Ein-/Ausgabemöglichkeiten besitzen. Konfiguriert man einen Pin für einen nicht unterstützen Modus so gibt es bei aktuellen Firmata-Versionen eine Fehlermeldung. Ältere Versionen (vor 2.3) schlucken Fehlkonfigurationen aber der betreffende Pin funktioniert dann nicht.<br />
<br />
Vor dem Anlegen des FRM-Devices muss das Perl-Modul ''Device::Firmata'' installiert werden. Dies kann abhänig von den vorhandenen Voraussetzung und Vorlieben auf unterschiedliche Weise erfolgen, Details zur Installation und zum Update von Perl-Modulen finden sich im [[#CPAN|Artikel über CPAN]]. Eine mögliche Installationsvariante auf einem Raspberry Pi ist:<br />
<br />
<pre><br />
sudo cpan install Device::Firmata<br />
</pre> <br />
<br />
Beispiele für das Anlegen eines FRM-Devices:<br />
<br />
<hr/><br />
<br />
<nowiki># definiere FRM mit USB-Schnittstelle /dev/ttyUSB0, Baudrate 57600 ist Default für StandardFirmata<br />
define FIRMATA FRM /dev/ttyUSB0@57600</nowiki><br />
<br />
<nowiki># definiere FRM mit TCP/IP-Schnittstelle auf Port 3030<br />
define FIRMATA FRM 3030 global</nowiki><br />
<br />
FRM öffnet bei Netzwerkverbindungen FHEM-seitig einen Serverport (dieser wird in der define-Zeile angegeben). 'global' muss zusätzlich angegeben werden, damit der Serversocket an alle IP-Adressen gebunden wird. Ohne 'global' sind nur Verbindungen für 'localhost' möglich. Das Firmata-Device verbindet sich aktiv zu diesem Port, sonst gilt im Prinzip alles was auch für den über USB angebunden Firmata-Device gilt.<br />
<br />
<nowiki># für alle analogen Eingangs-Pins<br />
attr FIRMATA sampling-interval 1000 # [ms] - maximal 16384 setzbar</nowiki><br />
<br />
siehe auch: {{Link2CmdRef|Anker=FRM}} FRM<br />
<br />
Hat man mehrere FRM-Devices definiert, muss man nach dem Anlegen eines FRM-Client-Devices dessen Attribut ''IODev'' überprüfen und ggf. ändern, wenn das gewünschte FRM-Device nicht automatisch erkannt wurde.<br />
<br />
Es folgt eine Auflistung der generischen FRM-Client-Devices. Darüber hinaus gibe es noch mehrere spezialisierte FRM-Client-Devices, vor allem für I2C-Bus-Devices (siehe {{Link2CmdRef}}):<br />
<br />
<br />
=== 20_FRM_IN.pm ===<br />
<br />
Macht einen Pin als digitalen Eingang nutzbar.<br />
<br />
<nowiki>define Firmata_IN FRM_IN 12 # definiert Pin 12 als digitalen Eingang</nowiki><br />
<br />
siehe auch: {{Link2CmdRef|Anker=FRM_IN}} FRM_IN<br />
<br />
=== 20_FRM_OUT.pm ===<br />
<br />
Macht einen Pin als digitalen Ausgang nutzbar.<br />
<br />
<nowiki>define Firmata_OUT FRM_OUT 11 # definiert Pin 11 als digitalen Ausgang</nowiki><br />
<br />
siehe auch: {{Link2CmdRef|Anker=FRM_OUT}} FRM_OUT<br />
<br />
=== 20_FRM_AD.pm ===<br />
<br />
Macht einen Pin als analogen Eingang nutzbar.<br />
<br />
<nowiki>define Firmata_ANALOG FRM_AD 17 # definiert Pin 17 als analogen Eingang</nowiki><br />
<br />
siehe auch: {{Link2CmdRef|Anker=FRM_AD}} FRM_AD<br />
<br />
=== 20_FRM_PWM.pm ===<br />
<br />
Macht einen Pin als analogen Ausgang nutzbar. Es wird ein pulsweitenmoduliertes Signal ausgegeben.<br />
<br />
define Firmata_ANALOG FRM_PWM 10 # definiert Pin 10 als PWM-Ausgang<br />
<br />
siehe auch: {{Link2CmdRef|Anker=FRM_PWM}} FRM_PWM<br />
<br />
=== 20_FRM_SERVO.pm ===<br />
<br />
Erlaubt die Ansteuerung eines analogen Modelbauservos über einen Pin per PWM.<br />
<br />
define Firmata_ANALOG FRM_SERVO 9 # definiert Pin 9 als Servo-Ausgang<br />
<br />
siehe auch: {{Link2CmdRef|Anker=FRM_SERVO}} FRM_SERVO<br />
<br />
=== 20_FRM_I2C.pm ===<br />
<br />
<p>Erlaubt das Lesen und Schreiben über den I2C-Bus am Firmata-Device.</p><br />
siehe auch: {{Link2CmdRef|Anker=FRM_I2C}}FRM_I2C<br />
<br />
=== 20_FRM_RGB.pm ===<br />
<br />
<p>Erlaubt das Ansteuern eines RGB-LED-Controller per PWM.</p><br />
siehe auch: {{Link2CmdRef|Anker=FRM_RGB}}FRM_RGB<br />
<br />
=== 20_FRM_ROTENC.pm ===<br />
<br />
<p>Erlaubt das Auswerten eines Drehgebers.</p><br />
siehe auch: {{Link2CmdRef|Anker=FRM_ROTENC}}FRM_ROTENC<br />
<br />
=== 20_FRM_STEPPER.pm ===<br />
<br />
<p>Erlaubt das Ansteuern eines Schrittmotors.</p><br />
siehe auch: {{Link2CmdRef|Anker=FRM_STEPPER}}FRM_STEPPER<br />
<br />
=== OneWire-Firmata ===<br />
<br />
<p>Der Artikel [[Arduino mit OneWireFirmata]] beschreibt, wie man am Firmata-Device angeschlossene 1-Wire Devices in FHEM einzubindet.</p><br />
siehe auch: {{Link2CmdRef|Anker=OWX}} OWX<br />
<br />
[[Kategorie:Other_Components]]<br />
[[Kategorie:Arduino]]<br />
[[Kategorie:HOWTOS]]</div>JensBhttp://wiki.fhem.de/w/index.php?title=Arduino_Firmata&diff=33146Arduino Firmata2020-05-03T08:53:36Z<p>JensB: Beschreibung von FRM_PWM und FRM_SERVO korrigiert.</p>
<hr />
<div>== Arduino mit Firmata ==<br />
Für Arduinos (und diverse Arduino kompatible Boards) gibt es eine Standardimplementierung des Kommunikationsprotokolls ''Firmata'' [https://github.com/firmata/protocol]. Mit Hilfe des Perl-Moduls ''Device::Firmata'', auch bekannt als perl-firmata [https://github.com/ntruchsess/perl-firmata], kann das Firmata-Protokoll in Perl genutzt werden und mit dem Modul [[#FRM|FRM]] auch in FHEM.<br />
<br />
Für die Kommunikation zwischen FHEM (Master) und Arduino (Slave) stehen mehrere Schnittstellen zur Auswahl: RS-232, USB, Ethernet und WiFi. Insbesondere Ethernet und WiFi erlauben die Integration dezentraler IO-Periperie mit FHEM.<br />
<br />
Firmata möglich es, mit nur geringen Arduino-Kenntnissen digitale und analoge Signale aus eigenen Schaltungen in FHEM zu verarbeiten. Dabei können Signale sowohl eingelesen als auch ausgegeben werden. Ein Verständnis der Bedienung der Arduino-IDE und elektronische Kenntnisse zum Anschluss von Sensoren und Aktoren sind natürlich erforderlich.<br />
<br />
=== Arduino IDE ===<br />
Zur Installation von Firmware auf den Arduino wird natürlich erst mal die Arduino-IDE (Version 1.8 oder höher) benötigt [https://www.arduino.cc/en/main/software]. Die gibt es für die Betriebssysteme Windows, Mac OS X und Linux.<br />
<br />
Über die Bibliotheksverwaltung der Arduino-IDE (Menü 'Sketch'-&gt;'Bibliothek einbinden'-&gt;'Bibliotheken verwalten...') stehen verschiedene Firmware-Versionen von Firmata zur Auswahl. Im folgenden wird auf die Version "Firmata by Firmata Developers" und "ConfigurableFirmata by Firmata Developers" eingegangen. Diese beiden Versionen unterscheiden sich in den unterstützten Hardware-Funktionen:<br />
<br />
* Firmata: digitale und analoge I/Os, Servos, I2C<br />
* ConfigurableFirmata: zusätzlich 1-Wire und Schrittmotoren<br />
<br />
Bei ConfigurableFirmata ist es auch außerdem einfacher, nicht benötigte Funktionen zu deaktivieren, damit die Arduino-Firmware möglichst wenig Speicher belegt. Wenn man den zusätzlichen Funktionsumfang von ConfigurableFirmata nicht benötigt, kann man mit etwas Geschick durch Auskommentieren von nicht benötigtem Code aus Firmata z.T. ein noch kompakteres Ergebnis erzielen (das ist aber nur etwas für Fortgeschrittene).<br />
<br />
Bei Firmata ist zwischen der Firmata-Protokoll-Version (aktuell 2.6.0) und der Version der jeweiligen Firmware (Firmata: aktuell 2.5.7, ConfigurableFirmata: aktuell 2.10.0) zu unterscheiden, die insbesondere bei ConfigurableFirmata voneinander unabhängig sind.<br />
<br />
Nach Installation der gewünschten Firmata-Firmware wählt man eines der funktionsfertigen Beispiele über das Arduino-IDE Menü 'Datei'-&gt;'Beispiele'-&gt;'Firmata' bzw. 'Datei'-&gt;'Beispiele'-&gt;'ConfigurableFirmata' aus. Je nach ausgewähltem Beispielprojekt sind noch Anpassungen direkt im Sketch oder in einer zusätzlichen Konfigurationsdatei erforderlich (z.B. um für Ethernet- und WiFi-Schnittstellen die Netzwerkparameter einzustellen).<br />
<br />
Über das Arduino-IDE Menü 'Werkzeuge'-&gt;'Bords' wählt man das Board aus, das dem eigenen Arduino entspricht. Fehlt das Board in der Auswahl, kann die erforderliche Unterstützung oft über das Menü 'Werkzeuge'-&gt;'Bords'-&gt;'Boardverwalter...' nachinstalliert werden. Ansonsten hilft ein Blick auf die Hersteller-Webseiten des Boards.<br />
<br />
Ist der Arduino korrekt angeschlossen, drückt man den 'Upload'-Knopf (der mit dem Rechspfeil oben links), um den Arduino-Sketch zu kompilieren und auf das Board hochzuladen. Die Vorgehensweise zum Hochladen ist sehr stark davon abhängig, welches Board man verwendet und mit welcher Technik es angeschlossen ist. Bitte die jeweiligen Angaben des Board-Herstellers beachten.<br />
<br />
Wer zum ersten mal mit der Arduino-IDE arbeitet, sollte statt Firmata zunächst das Standard Arduino Beispielprojekt 'Blink' auswählen und es auf dem Arduino installieren. Sobald das klappt, kann man mit Firmata weiter machen.<br />
<br />
=== Firmata mit Ethernet oder WiFi ===<br />
<br />
Vor dem Kompilieren muss man unbedingt die Netzwerkparameter anpassen, d.h. die IP-Adresse des FHEM-Servers und den Port des FRM-Moduls eintragen (ggf. auch eine neue eindeutige MAC-Adresse), bei WiFi auch die SSID und den PSK. In älteren Firmata-Versionen und bei ConfigurableFirmata geschieht das direkt im Sketch. Aktuelle Firmata-Versionen haben dazu eine getrennte Konfigurationsdatei (ethernetConfig.h bzw. wifiConfig.h), so dass keine Änderungen am Sketch erforderlich sind.<br />
<br />
Falls der Speicherbedarf der kompilierten Arduino-Firmware die Möglichkeiten des Boards übersteigt (insbesondere bei Verwendung eines ENC28J60-Ethernet-Shields [https://github.com/ntruchsess/arduino_uip] in Kombination mit einem "kleinen" Arduiono wie den Uno oder Nano) kann man bei Verwendung von ConfigurableFirmata nicht benötigten Features im Sketch auskommentieren. Wenn der Speicherbedarf nur "knapp" ausreicht, läuft die Firmware u.U. trotzdem nicht zuverlässig.<br />
<br />
Als ersten Funktionstest für die Netzwerkverbindung empfiehlt sich ein Ping von FHEM zum Arduino.<br />
<br />
=== Sonderfälle ===<br />
<br />
Je nach verwendetem Board sind u.U. individuelle Besonderheiten zu berücksichtigen. Hier ein paar Beispiele:<br />
<br />
Ein MEGA256 z.B. benutzt einen anderen Pin als SS (Slave select) zur Kommunikation mit dem Ethernetmodul. Man muss der Firmata im Setup mitteilen, welche Pins zu ignorieren sind, damit es keine Wechselwirkungen zwischen Firmata und Ethernet Library gibt. Das ist im ConfigurableFirmata-Sketch [https://github.com/firmata/arduino/blob/configurable/examples/ConfigurableFirmata/ConfigurableFirmata.ino] vorbereitet und muss (wenn man etwas anderes als ein Standard-Ethernetshield am Uno verwendet) geeignet angepasst werden (Beim Mega muss man z.B. den Pin 10 ignorieren und Pin 53 als hardcodiert auf Output stellen). Das gleiche gilt, wenn man eine andere Hardware (z.B. mit ENC28J60 anstelle des WizNet W5100 des Ethernetshields) benutzen möchte, die einen anderen Pin als CS/SS benutzt.<br />
<br />
== FRM ==<br />
Der Arduino wird in FHEM über das Modul 10_FRM.pm angesprochen. 10_FRM ist für andere FHEM-Module die Schnittstelle (das IODev) zum Arduino. Es lassen sich jeweils so viele Ein/Ausgabe Devices pro Arduino konfigurieren, wie dieser physikalisch besitzt (natürlich muss man darauf achten, dass nicht alle Arduino-Pins alle Ein-/Ausgabemöglichkeiten besitzen). Konfiguriert man einen Pin für einen nicht unterstützen Modus so gibt es mit der aktuellen Firmata-Version direkt einen Fehler - ältere Versionen (vor 2.3) schlucken Fehlkonfigurationen einfach so, der betreffende Pin funktioniert dann aber nicht.<br />
<br />
Hier ein kurzer Ausschnitt aus der fhem.cfg:<br />
<br />
<hr /><br />
<nowiki># definiere FRM mit USB-Schnittstelle /dev/ttyUSB0, Baudrate 57600 ist Default für StandardFirmata<br />
define FIRMATA FRM /dev/ttyUSB0@57600</nowiki><br />
<br />
<nowiki># definiere FRM mit TCP/IP-Schnittstelle auf Port 3030<br />
define FIRMATA FRM 3030 global</nowiki><br />
FRM macht bei Netzwerkverbindungen FHEM-seitig einen Serverport auf (dieser wird in der define-Zeile angegeben). 'global' muss zusätzlich angegeben werden, damit der Serversocket an alle IP-addressen gebunden wird. (Sonst wird nur 'localhost' verwendet, was nicht funktionieren würde). Der Arduino verbindet sich aktiv zu diesem Port, sonst gilt im Prinzip alles was auch für den über USB angebunden Arduino gilt.<br />
<br />
<nowiki># für alle analogen Eingangs-Pins<br />
attr FIRMATA sampling-interval 1000 # [ms] - maximal 16384 setzbar</nowiki><br />
<br />
siehe auch: {{Link2CmdRef|Anker=FRM}} FRM<br />
=== 20_FRM_IN.pm ===<br />
Macht einen Arduino-pin als digitalen Eingang nutzbar.<br />
<nowiki>define Firmata_IN FRM_IN 12 # definiert Arduino Pin 12 als digitalen Eingang</nowiki><br />
siehe auch: {{Link2CmdRef|Anker=FRM_IN}} FRM_IN<br />
=== 20_FRM_OUT.pm ===<br />
Macht einen Arduino-pin als digitalen Ausgang nutzbar.<br />
<nowiki>define Firmata_OUT FRM_OUT 11 # definiert Arduino Pin 11 als digitalen Ausgang</nowiki><br />
siehe auch: {{Link2CmdRef|Anker=FRM_OUT}} FRM_OUT<br />
=== 20_FRM_AD.pm ===<br />
Macht einen Arduino-pin als analogen Eingang nutzbar.<br />
<nowiki>define Firmata_ANALOG FRM_AD 17 # definiert Arduino Pin 17 als analogen Eingang</nowiki><br />
siehe auch: {{Link2CmdRef|Anker=FRM_AD}} FRM_AD<br />
=== 20_FRM_PWM.pm ===<br />
Macht einen Arduino-pin als analogen Ausgang nutzbar. Es wird ein pulsweitenmoduliertes Signal ausgegeben.<br />
define Firmata_ANALOG FRM_PWM 10 # definiert Arduino Pin 10 als PWM-Ausgang<br />
siehe auch: {{Link2CmdRef|Anker=FRM_PWM}} FRM_PWM<br />
=== 20_FRM_SERVO.pm ===<br />
Erlaubt die Ansteuerung von analogen Modelbauservos (Ansteuerung über PWM) am Arduino.<br />
define Firmata_ANALOG FRM_SERVO 9 # definiert Arduino Pin 9 als Servo-Ausgang<br />
siehe auch: {{Link2CmdRef|Anker=FRM_SERVO}} FRM_SERVO<br />
=== 20_FRM_I2C.pm ===<br />
<p>Erlaubt das Auslesen von über I2C angeschlossenen ICs</p><br />
siehe auch: {{Link2CmdRef|Anker=FRM_I2C}}FRM_I2C<br />
=== Arduino mit OneWireFirmata ===<br />
<p>die Seite [[Arduino mit OneWireFirmata]] beschreibt, wie es möglich ist, mit einer um OneWire erweiterten Version der Standard Firmata an den Arduino angeschlossene 1-Wire Devices in FHEM einzubinden.</p><br />
siehe auch: {{Link2CmdRef|Anker=OWX}} OWX<br />
<br />
[[Kategorie:Other_Components]]<br />
[[Kategorie:Arduino]]<br />
[[Kategorie:HOWTOS]]</div>JensBhttp://wiki.fhem.de/w/index.php?title=DWD_OpenData&diff=29985DWD OpenData2019-03-26T19:04:46Z<p>JensB: </p>
<hr />
<div>{{SEITENTITEL:DWD_OpenData}}<br />
<br />
{{Hinweis|Versionsänderung: Die Vorhersagedaten wurden Mitte September 2018 von CSV auf KML umgestellt. Diese Umstellung ist inkompatibel: das DWD_OpenData-Modul muss aktualisiert werden, einige Reading-Namen haben sich geändert und der Weblink muss deinstalliert und neu installiert werden (siehe diesen {{Link2Forum|Topic=83097|Message=840270}} im Forum).}}<br />
<br />
{{<br />
Infobox Modul<br />
|ModPurpose=Daten vom DWD OpenData Server abrufen<br />
|ModType=d<br />
|ModCmdRef=DWD_OpenData<br />
|ModForumArea=Unterstützende Dienste/Wettermodule<br />
|ModTechName=55_DWD_OpenData.pm<br />
|ModOwner=JensB ({{Link2FU|14024|Forum}}/[[Benutzer Diskussion:JensB|Wiki]])<br />
}}<br />
<br />
Der Deutsche Wetterdienst (DWD) stellt Wetterdaten über den [https://www.dwd.de/DE/leistungen/opendata/opendata.html Open Data Server] zur Verfügung. Die Verwendung dieses Dienstes und der vom DWD zur Verf&uuml;gung gestellten Daten unterliegt den auf der OpenData Webseite beschriebenen Bedingungen. Einen Überblick über die verfügbaren Daten findet man in der Tabelle [https://www.dwd.de/DE/leistungen/opendata/help/inhalt_allgemein/opendata_content_de_en_xls.xls OpenData_weather_content.xls].<br />
<br />
<br />
== Anwendung ==<br />
Aufgrund der unterschiedlichen vom DWD bereitgestellten Datenformate benötigt das Modul zur Dekodierung je nach gewünschtem Funktionsumfang zusätzliche Perl-Module, die nicht standardmäßig vorinstalliert sind und je nach Systemkonfiguration nachinstalliert werden müssen. Außerdem unterstützt das Modul Zeitzonen, um z.B. die Wettervorhersage internationaler Stationen in Ortszeit darstellen zu können. Hierfür sind je nach Systemkonfiguration weitere Einstellungen erforderlich. Auch die Sprache der Wochentage für die Wettervorhersage ist frei wählbar. Je nach Systemkonfiguration ist aber die Standardsprache u.U. auf Englisch eingestellt, was weitere Anpassungen der Systemkonfiguration erforderlich macht.<br />
<br />
=== Vorbereitung ===<br />
Im folgenden wird z.T. von einem System mit Rasbian oder Debian mit System-V Startsystem ausgegangen. Auf anderen Betriebssystemen und auf Systemen mit System-D müssen die Installationsschritte ggf. angepasst werden.<br />
<br />
<br />
1. Für die Wettervorhersage und die Wetterwarnungen:<br />
Installation des Perl-Moduls ''XML::LibXML'' über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libxml-libxml-perl<br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
2. Falls man einen eigenen Internet-Proxy nutzt:<br />
Die Konfiguration des Proxies für FHEM erfolgt z.B. durch Eintrag von<br />
<pre><br />
attr global proxy <myProxyHost>:<myProxyPort><br />
</pre> <br />
in die [[Konfiguration]], wobei ''myProxyHost'' durch den Namen oder die IP-Adresse des Proxy-Servers ersetzt werden muss und für ''myProxyPort'' der Port des Proxy-Servers eingetragen werden muss (oft 3128).<br />
<br />
<br />
3. FHEM Uhrzeit und Zeitzone:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre><br />
in die FHEM-Kommandozeile überprüfen, ob die FHEM-Uhrzeit plausibel ist. Ist dies nicht der Fall sollten die Uhrzeit auf Systemebene überprüft werden und ggf. die Systemeinstellungen angepasst werden.<br />
Ermitteln der Bezeichnung der eigenen Zeitzone über die System-Kommandozeile mit<br />
<pre><br />
tzselect<br />
</pre><br />
und diese Bezeichnung in die Datei ''/etc/timezone'' eintragen und <br />
<pre><br />
export TZ=`cat /etc/timezone`<br />
</pre><br />
der Datei ''/etc/profile'' hinzufügen und dann das System neu starten. Nun muss die Zeitanzeige in FHEM korrekt sein.<br />
<br />
<br />
4. FHEM Sprache:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre> in die FHEM-Kommandozeile überprüfen, in welcher Sprache der Wochentag angezeigt wird. Stimmt die Sprache nicht, dann auf der System-Kommandozeile<br />
<pre><br />
dpkg-reconfigure locales<br />
</pre> eingeben und aus der Liste z.B. ''de_DE.UTF-8'' zusätzlich auswählen. Dieser Befehl gilt für Debian-basierte Betriebssysteme - für andere Betriebssysteme ist eine analoge Funktion zu verwenden. Mit Eingabe von <br />
<pre><br />
locale -a<br />
</pre> auf der System-Kommandozeile überprüfen, ob die ausgewählte Sprache nun zur Verfügung steht. Sollte FHEM nach einem Neustart noch immer nicht die gewünschte Sprache verwenden, kann man auf einem System V Linux durch Hinzufügen von z.B.<br />
<pre><br />
export LANG=de_DE.UTF-8<br />
</pre> in die Datei ''/etc/init.d/fhem'' (irgendwo zwischen ''start'' und ''perl'') und erneutem Neustart von FHEM die Sprache für FHEM erzwingen. Bei einem Systemd Linux kann man die Einstellungen mit ''systemctl edit --full fhem.service'' bearbeiten. Spätestes jetzt muss die Wochentagsanzeige in FHEM korrekt sein.<br />
<br />
<br />
5. Nur für den Weblink erforderlich:<br />
Installation des Perl-Moduls ''DateTime'' über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libdatetime-perl<br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
=== Define ===<br />
siehe [https://fhem.de/commandref.html#DWD_OpenDatadefine Commandref].<br />
<br />
=== Attributes ===<br />
siehe [https://fhem.de/commandref.html#DWD_OpenDataattr Commandref].<br />
<br />
<br />
== Anwendungsbeispiele ==<br />
=== Beispiel zur Modul-Einrichtung ===<br />
<br />
* Wettervorhersage<br />
Für die Wettervorhersage muss der Stationscode ermittelt werden. Dazu den [https://www.dwd.de/DE/leistungen/met_verfahren_mosmix/mosmix_stationskatalog.pdf MOSMIX Stationskatalog] herunterladen, öffnen und die gewünschten Station heraussuchen (Spalte ''id''). Einen Teil der deutschen Stationen kann man auch der [https://www.dwd.de/DE/derdwd/messnetz/bodenbeobachtung/messnetzkarte_boden.pdf Bodenmessnetzkarte] entnehmen. Den ermittelten Stationscode kann man dann entweder für eine Einzelabfrage als Parameter für das Kommando ''get forecast'' verwenden oder für die automatische Aktualisierung als Attribut ''forecastStation'' hinterlegen. Insgesamt werden vom DWD mehr als 70 Merkmale zur Verfügung gestellt. Eine Auflistung findet sich im Dokument [https://opendata.dwd.de/weather/lib/MetElementDefinition.xml MetElementDefinition]. Nur ein kleiner Teil der Merkmale wird in der Standardeinstellung des Moduls als Reading zur Verfügung gestellt. Wer andere Merkmale benötigt muss sie mit Komma getrennt dem Attribut ''forecastProperties'' zuweisen. Es empfiehlt sich zur Performance-Optimierung sowohl das Attribut ''forecastDays'' als auch das Attribut ''forecastProperties'' auf den tatsächlichen Bedarf einzustellen.<br />
<br />
* Wetterwarnungen<br />
Für die Wetterwarnungen muss die Warnzelle ermittelt werden. Dazu [https://www.dwd.de/DE/leistungen/opendata/help/warnungen/cap_warncellids_csv.csv Warnzellen-ID Katalog] herunterladen, öffnen und die gewünschte Warnzelle heraussuchen. Unterstützt werden Gemeinden (beginnen mit 8), Landkreise (beginnen mit 1 oder 9) oder Küste (beginnen mit 5). Die Warnzellen-ID kann man dann entweder für eine Einzelabfrage als Parameter für das Kommando ''get alerts'' verwenden oder für die automatische Aktualisierung als Attribut ''alertArea'' hinterlegen. Die Warnzellen-ID ist ab der 2. Stelle identisch mit den ersten Ziffern des amtlichen Gemeindeschlüssels. Man kann z.B. den Namen von Gemeinde oder Landkreis bei den [https://www.statistik-bw.de/Statistik-Portal/gemeindeverz.asp Statistischen Ämtern des Bundes und der Länder] eingeben, den amtlichen Gemeindeschlüssels ermitteln und dann mit vorangestellter 1, 8 oder 9 im Warnzellen-ID Katalog des DWD nach einem Eintrag mit exakter oder weitgehender Übereinstimmung suchen. Wem das zu kompliziert vorkommt, kann bei mehrdeutigen Gemeinde- bzw. Landkreisbezeichnungen auch versuchen auszuprobieren, welche die richtige Wanrzellen-ID ist.<br />
<br />
Um das Modul mit automatisch Aktualisierung von Vorhersage und Wetterwarnungen zu nutzen, kann z.B. folgendes in die [[Konfiguration]] eingetragen werden:<br />
<br />
<pre><br />
define DWD DWD_OpenData<br />
attr DWD alertArea 111000000<br />
attr DWD forecastStation 99810<br />
attr DWD forecastDays 3<br />
attr DWD forecastWW2Text 1<br />
</pre><br />
<br />
* Performance<br />
Das DWD_OpenData-Modul ist ein Datenmodul mit relativ vielen Readings. In der Standardkonfiguration wird, wie bei jedem anderen FHEM Modul, bei jeder Änderung jedes Readings ein FHEM internes Ereignis erzeugt, damit andere FHEM Devices auf diese Änderungen reagieren können. Diese Ereignisse sorgen auch dafür, dass man Änderungen in der Weboberfläche sofort angezeigt bekommt, ohne die Webseite neu aufzurufen. Interessiert sich aber kein FHEM Device für die Änderungsbenachrichtung bestimmter Readings, entsteht unnötiger Verarbeitsoverhead, der je nach FHEM Konfiguration und verfügbarer CPU-Leistung auch mehrere Sekunden benötigen kann und in dieser Zeit andere Abläufe blockiert. Um die Performance zu optimieren, empfiehlt es sich, mit [[event-on-update-reading]] für eine angepasste und dadurch effizientere Verarbeitung sorgen, indem man nur für die Readings Ereignisse zulässt, die man für die Weiterverarbeitung braucht. Der DWD_OpenData_Weblink braucht z.B. gar keine Ereignisse, um zu funktionieren. Hier eine minimalistische Beispielkonfiguration:<br />
<br />
<pre><br />
attr DWD event-on-update-reading state,fc_state,a_state<br />
</pre><br />
<br />
Weitere Details zur Installation und Konfiguration des Moduls finden sich in der [https://fhem.de/commandref.html#DWD_OpenData Commandref].<br />
<br />
<br />
=== Beispiel für die Einrichtung eines Meteogramms ===<br />
Um den vorhergesagten Wetterverlauf als Meteogramm in Kurvenfrom mit [[SVG]] darzustellen, kann man wie folgt vorgehen:<br />
<br />
1. 99_myUtils.pm<br />
<br />
Für die Bestimmung der Werte für den SVG-Plot wird eine Perl-Funktion benötigt, die in die Datei 99_myUtils.pm vor dem Ende eingefügt wird. Wer diese FHEM-Datei noch nicht nutzt, legt sie einfach an (siehe [[99_myUtils_anlegen]]).<br />
<source lang="perl"><br />
package main;<br />
<br />
use strict;<br />
use warnings;<br />
<br />
...<br />
<br />
#<br />
# (c) mumpitzstuff 19.12.2018<br />
#<br />
# see https://forum.fhem.de/index.php/topic,83097.msg874150.html#msg874150<br />
#<br />
sub logProxy_dwd2Plot($$$$;$$$)<br />
{<br />
my ($device, $fcValue, $from, $to, $fcHour, $expMode, $shiftTime) = @_;<br />
my $regex;<br />
my @rl;<br />
<br />
return undef if(!$device);<br />
<br />
if ($fcValue =~ s/_$//)<br />
{<br />
$regex = "^fc[\\d]+_[\\d]+_".$fcValue."\$";<br />
}<br />
else<br />
{<br />
$regex = "^fc[\\d]+_".$fcValue."\$";<br />
}<br />
<br />
$fcHour = 12 if(!defined($fcHour));<br />
$expMode = "point" if(!defined($expMode));<br />
#Log3 undef,2, "Regex: ".$regex;<br />
<br />
# ermitteln aller relevanten Readings<br />
if ( defined($defs{$device}) )<br />
{<br />
if ( $defs{$device}{TYPE} eq "DWD_OpenData" )<br />
{<br />
@rl = sort<br />
{<br />
my ($an) = ($a =~ m/fc(\d+)_.*/);<br />
my ($bn) = ($b =~ m/fc(\d+)_.*/);<br />
my ($ao) = ($a =~ m/fc\d+_(\d+).*/);<br />
my ($bo) = ($b =~ m/fc\d+_(\d+).*/);<br />
$an <=> $bn or $ao <=> $bo or $a cmp $b;<br />
} ( grep /${regex}/,keys %{$defs{$device}{READINGS}} );<br />
return undef if ( !@rl );<br />
}<br />
else<br />
{<br />
Log3 undef, 2, "logProxy_dwd2Plot: $device is not a DWD_OpenData device";<br />
return undef;<br />
}<br />
}<br />
<br />
my $fromsec = SVG_time_to_sec($from);<br />
my $tosec = SVG_time_to_sec($to);<br />
my $sec = $fromsec;<br />
my ($h, $hp, $fcDay, $mday, $mon, $year);<br />
my $timestamp;<br />
<br />
my $reading;<br />
my $value;<br />
my $prev_value;<br />
my $min = 999999;<br />
my $max = -999999;<br />
my $ret = "";<br />
<br />
# while not end of plot range reached<br />
while (($sec < $tosec) && @rl)<br />
{<br />
#remember previous value for start of plot range<br />
$prev_value = $value;<br />
<br />
$reading = shift @rl;<br />
($fcDay) = $reading =~ m/^fc(\d+).*/;<br />
($hp) = $reading =~ m/^fc\d+_(\d+).*/;<br />
#Log 1, "hp: ".$hp;<br />
<br />
if ($hp)<br />
{<br />
$h = ReadingsVal($device, "fc".$fcDay."_".$hp."_time", $fcHour);<br />
if ($h =~ m/^(\d+):\d+/)<br />
{<br />
$h = $1;<br />
}<br />
}<br />
else<br />
{<br />
$h = $fcHour;<br />
}<br />
<br />
$value = ReadingsVal($device, $reading, undef);<br />
<br />
# calculate minutes of sunshine per hour<br />
if ($fcValue =~ /^SunD(\d+)/)<br />
{<br />
if (defined($1))<br />
{<br />
$value = $value / ($1 * 36);<br />
}<br />
else<br />
{<br />
$value = $value / (12 * 36);<br />
}<br />
}<br />
<br />
# calculate amount of rain per hour<br />
if ($fcValue =~ /^RR(\d+)c$/)<br />
{<br />
if (defined($1))<br />
{<br />
$value /= $1;<br />
}<br />
}<br />
<br />
($year, $mon, $mday) = split('\-',ReadingsVal($device, "fc".$fcDay."_date",undef));<br />
$timestamp = sprintf("%04d-%02d-%02d_%02d:%02d:%02d", $year, $mon, $mday, $h, 0, 0);<br />
$sec = SVG_time_to_sec($timestamp);<br />
if (defined($shiftTime))<br />
{<br />
$sec += $shiftTime;<br />
$timestamp = logProxy_shiftTime($timestamp, $shiftTime);<br />
}<br />
<br />
# skip all values before start of plot range<br />
next if ( $sec < $fromsec );<br />
<br />
# add first value at start of plot range<br />
if ( !$ret && $prev_value )<br />
{<br />
$min = $prev_value if ( $prev_value < $min );<br />
$max = $prev_value if ( $prev_value > $max );<br />
$ret .= "$from $prev_value\n";<br />
}<br />
<br />
# done if after end of plot range<br />
last if ($sec > $tosec);<br />
<br />
$min = $value if ( $value < $min );<br />
$max = $value if ( $value > $max );<br />
<br />
# add actual control point<br />
$ret .= "$timestamp $value\n";<br />
}<br />
<br />
if (($sec < $tosec) && !@rl && ($expMode eq "day"))<br />
{<br />
$timestamp = sprintf("%04d-%02d-%02d_%02d:%02d:%02d", $year, $mon, $mday, 23, 59, 59);<br />
$_ = SVG_time_to_sec($timestamp);<br />
if (defined($shiftTime))<br />
{<br />
$_ += $shiftTime;<br />
$timestamp = logProxy_shiftTime($timestamp, $shiftTime);<br />
}<br />
<br />
if ($_ < $tosec)<br />
{<br />
$ret .= "$timestamp $value\n";<br />
}<br />
else<br />
{<br />
$ret .= "$to $value\n";<br />
}<br />
}<br />
elsif (($sec > $tosec) && ($expMode eq "day"))<br />
{<br />
$value = $prev_value + ($value - $prev_value) * (86400 + ($tosec - $sec)) / 86400;<br />
$ret .= "$to $value\n";<br />
}<br />
<br />
return ($ret, $min, $max, $prev_value);<br />
} <br />
<br />
1;<br />
</source><br />
<br />
2. LogProxy<br />
<br />
Wer bereits ein [[logProxy]]-Device hat, muss den Namen seines logProxy-Devices in die weiter unter aufgeführte GPlot-Konfiguration eintragen. Ansonsten wird es wie folgt neu erstellt:<br />
<pre><br />
define LogProxy logProxy<br />
</pre><br />
<br />
3. FileLog<br />
<br />
Das Meteogramm kennt anders als andere FHEM-Plots keine Vergangenheit außer heute. Trotzdem wird aus formalen Gründen eine [[FileLog]]-Device benötigt. Dazu kann ein beliebiges vorhandenes FileLog-Device verwendet werden. Wer will, kann hierfür aber auch ein neues FileLog Device für das DWD_OpenData-Device anlegen (Achtung: wird schnell umfangreich):<br />
<pre><br />
define FileLog_DWD FileLog ./log/DWD-%Y-%m.log DWD<br />
</pre><br />
<br />
Im folgenden wird für das FileLog-Device der Platzhalter ''FileLog_Dummy'' verwendet, der mit dem Namen des gewählten FileLog-Devices zu ersetzen ist.<br />
<br />
4. SVG Plot<br />
<br />
Das eigentliche Meteogramm ist ein SVG-Device. Will man mehrere Tage darstellen bietet sich die folgende Definition an:<br />
<pre><br />
define SVG_DWD SVG FileLog_Dummy:SVG_DWD:CURRENT<br />
attr SVG_DWD fixedoffset 6<br />
attr SVG_DWD fixedrange 7days<br />
attr SVG_DWD nrAxis 1,2<br />
</pre><br />
<br />
Dabei muss das SVG-Attribut ''fixedoffset'' entweder gleich oder kleiner als die Einstellung des DWD_OpenData-Attributs ''forecastDays'' (Standardwert: 6 Tage) gewählt werden und das SVG-Attribut ''fixedrange'' um eins größer als ''fixedoffset'' eingestellt werden.<br />
<br />
Will man statt dessen nur die nächsten 24 Stunden anzeigen, nimmt man folgende Einstellungen:<br />
<pre><br />
define SVG_DWD SVG FileLog_Dummy:SVG_DWD:CURRENT<br />
attr SVG_DWD endPlotNow 1<br />
attr SVG_DWD fixedoffset 1<br />
attr SVG_FileLog_WETTER_DWD_3 label "Tmin: $data{max1} °C, Tmax: $data{min1} °C"<br />
attr SVG_DWD nrAxis 1,2<br />
</pre><br />
<br />
Um die DWD_OpenData-Readings mit dem Plot zu verknüpfen, muss man nun die GPlot-Konfigurationsdatei des SVG-Plots manuell bearbeiten. Dazu auf den Link klicken, der im SVG_DWD-Device am Internal ''GPLOTFILE'' steht. Die y-Wertebereiche für die Regenmenge und die Temperaturen sind im Beispiel auskommentiert (Autorange). Das kann man so lassen oder man stellt sie nach den eigenen Wettergegebenheiten ein. Je nach Konfiguration des DWD_OpenData-Attributs ''forecastResolution'' sind aber noch einige weitere Einstellungen anzupassen. Das folgende Beispiel ist für die 3h-Auflösung:<br />
<pre><br />
set terminal png transparent size <SIZE> crop<br />
set output '<OUT>.png'<br />
set xdata time<br />
set timefmt "%Y-%m-%d_%H:%M:%S"<br />
set xlabel " "<br />
set title 'Wettervorhersage'<br />
set ytics <br />
set y2tics <br />
set grid ytics<br />
set ylabel "Regen [mm]"<br />
#set yrange [0:4]<br />
set y2label "Temperatur [°C]"<br />
#set y2range [-5:35]<br />
set y3label "Wolken/Regen/Sonne [%]"<br />
set y3range [0:100]<br />
<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","TTT_",$from,$to,0,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Tx",$from,$to,18,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Tn",$from,$to,6,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","SunD3_",$from,$to,0,"day",(-3*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","RR3c_",$from,$to,0,"day",(-3*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","FX1_",$from,$to,0,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","R600_",$from,$to,0,"day",(-3*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Neff_",$from,$to,0,"day")<br />
#LogProxy ConstX:TimeNow(),0,100<br />
#LogProxy ConstY:0<br />
<br />
plot "<IN>" using 1:2 axes x1y2 title 'T' ls l0 lw 2 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y2 title 'Tmax' ls l0dot lw 2 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y2 title 'Tmin' ls l0dot lw 2 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 title 'Sonne' ls l4fill lw 1 with lines,\<br />
"<IN>" using 1:2 axes x1y1 title 'Regenmenge' ls l2fill lw 1 with steps,\<br />
"<IN>" using 1:2 axes x1y3 title 'Wind' ls l1 lw 1 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 title 'Regen' ls l5fill lw 1 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 title 'Wolken' ls l6fill lw 1 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 notitle ls l5 lw 4 with lines,\<br />
"<IN>" using 1:2 axes x1y2 notitle ls l5 lw 1 with lines<br />
</pre><br />
<br />
Verwendet man dagegen eine Auflösung von 1 Stunde, sind folgende LogProxy-Einträge erforderlich:<br />
<pre><br />
#LogProxy Func:logProxy_dwd2Plot("DWD","TTT_",$from,$to,0,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Tx",$from,$to,18,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Tn",$from,$to,6,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","SunD1_",$from,$to,0,"day",(-1*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","RR1c_",$from,$to,0,"day",(-1*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","FX1_",$from,$to,0,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","R101_",$from,$to,0,"day",(-0.5*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Neff_",$from,$to,0,"day")<br />
#LogProxy ConstX:TimeNow(),0,100<br />
#LogProxy ConstY:0<br />
</pre><br />
<br />
Für die Darstellung der nächsten 24 Stunden mit einer Auflösung von 1 Stunde nimmt man folgende GPlot-Konfiguration:<br />
<pre><br />
set terminal png transparent size <SIZE> crop<br />
set output '<OUT>.png'<br />
set xdata time<br />
set timefmt "%Y-%m-%d_%H:%M:%S"<br />
set xlabel " "<br />
set title '<L1>'<br />
set ytics<br />
set y2tics<br />
set y3tics<br />
set grid xtics y2tics<br />
set ylabel "Regen [mm]"<br />
set y2label "Temperatur [°C]"<br />
set y3label "Wolken/Regen/Sonne [%]"<br />
set y3range [0:100]<br />
<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","TTT_",$from,$to,0,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","SunD1_",$from,$to,0,"day",(-1*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","RR1c_",$from,$to,0,"day",(-1*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","FX1_",$from,$to,0,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","R101_",$from,$to,0,"day",(-0.5*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Neff_",$from,$to,0,"day")<br />
#LogProxy ConstY:0<br />
<br />
plot "<IN>" using 1:2 axes x1y2 title 'T' ls l0 lw 2 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 title 'Sonne' ls l4fill lw 1 with lines,\<br />
"<IN>" using 1:2 axes x1y1 title 'Regenmenge' ls l2fill lw 1 with steps,\<br />
"<IN>" using 1:2 axes x1y3 title 'Wind' ls l1 lw 1 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 title 'Regen' ls l5fill lw 1 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 title 'Wolken' ls l6fill lw 1 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y2 notitle ls l2 lw 2 with lines<br />
</pre><br />
<br />
Je nachdem, welche Auflösung man verwendet, werden unterschiedliche Readings des DWD_OpenData-Devices benötigt. Diese sind in den LogProxy-Zeilen in der GPlot-Konfigurationsdatei zu finden und müssen auf jeden Fall dem Attribut ''forecastProperties'' des DWD_OpenData-Device hinzugefügt werden.<br />
<br />
Viele Detaileinstellungen des Meteogramms lassen sich individualisieren. Man kann z.B. mehr oder weniger Daten anzeigen und zumindest für ''heute'' auch aktuelle Messwerte hinzufügen.<br />
<br />
Hier ein Beispiel für ein Meteogramm über 4 Tage mit 3 Stunden Auflösung:<br />
<br />
[[File:DWDODmeteogram4d3h.png|500px]]<br />
<br />
<br />
=== Beispiel für die Einrichtung eines Weblinks ===<br />
Zur graphischen Darstellung der Vorhersage und der Wetterwarnungen mit [[FHEMWEB]] steht das Modul [https://raw.githubusercontent.com/jnsbyr/fhem/master/FHEM/99_DWD_OpenData_Weblink.pm 99_DWD_OpenData_Weblink.pm] zur Verfügung.<br />
<br />
Zunächst die Moduldatei herunterladen und in das Modulverzeichnis ''fhem/FHEM'' kopieren. Entweder die Datei direkt auf den FHEM-Server herunterladen (z.B. mit ''wget'') oder beim indirekten Herunterladen darauf achten, dass dabei das Encoding nicht verändert wird (also z.B. bei WinSCP den Binär-Modus und nicht den Text-Modus verwenden). Ansonsten werden später z.B. Sonderzeichen wie ''°C'' falsch angezeigt. <br />
<br />
Anschließend kann in die [[Konfiguration]] z.B. folgendes eingetragen werden:<br />
<br />
<pre><br />
define DWD_Weblink_Generator DWD_OpenData_Weblink<br />
attr DWD_Weblink_Generator IODev DWD<br />
attr DWD_Weblink_Generator forecastDays 4<br />
# refreshRate nur dann setzten, wenn der Browser Java-Script beherrscht:<br />
attr DWD_Weblink_Generator refreshRate 900<br />
<br />
define DWD_Weblink weblink htmlCode { DWD_OpenData_Weblink::AsHtmlH("DWD_Weblink_Generator") } <br />
</pre><br />
<br />
Damit legt man das Weblink-Generator-Device an und verknüpft es mit dem DWD_OpenData-Device. Außerdem wird der [[weblink ]] selbst angelegt, der seinerseits mit dem Weblink-Generator-Device verknüpft wird. Der Weblink benötigt für seine Funktion eine bestimmte Auswahl der Vorhersage-Merkmale. Wer das Attribut ''forecastProperties'' des DWD_OpenData-Moduls anpassen will, muss diese Merkmale auf jeden Fall mit berücksichtigen. <br />
<br />
Wenn vom Weblink nichts im Browser zu sehen ist, kann das daran liegen, dass der Browser kein aktuelles JavaScript verwendet oder JavaScript deaktiviert ist. Dann sollte das Attribut ''refreshRate'' auf 0 Sekunden eingestellt oder gelöscht werden. Mit aktiviertem Refresh werden die Daten auch ohne Seitenneuaufbau regelmäßig und bei Tab-Wechsel aktualisiert.<br />
<br />
Die Liste der erforderlichen Vorhersage-Merkmale finden sich zusammen mit allen weitere Details zur Installation und Konfiguration in der Modulhilfe von ''99_DWD_OpenData_Weblink.pm'', die man z.B. nach dem Anlegen des Weblink-Generator-Devices über die Weboberfläche abrufen kann.<br />
<br />
Hier ein Ausschnitt aus der Darstellung des Weblinks mit [[FHEMWEB]]:<br />
<br />
[[File:DWDODweblink.png|500px]]</div>JensBhttp://wiki.fhem.de/w/index.php?title=DWD_OpenData&diff=29928DWD OpenData2019-03-17T10:38:07Z<p>JensB: </p>
<hr />
<div>{{SEITENTITEL:DWD_OpenData}}<br />
<br />
{{Hinweis|Versionsänderung: Die Vorhersagedaten wurden Mitte September 2018 von CSV auf KML umgestellt. Diese Umstellung ist inkompatibel: das DWD_OpenData-Modul muss aktualisiert werden, einige Reading-Namen haben sich geändert und der Weblink muss deinstalliert und neu installiert werden (siehe diesen {{Link2Forum|Topic=83097|Message=840270}} im Forum).}}<br />
<br />
{{<br />
Infobox Modul<br />
|ModPurpose=Daten vom DWD OpenData Server abrufen<br />
|ModType=d<br />
|ModCmdRef=DWD_OpenData<br />
|ModForumArea=Unterstützende Dienste/Wettermodule<br />
|ModTechName=55_DWD_OpenData.pm<br />
|ModOwner=JensB ({{Link2FU|14024|Forum}}/[[Benutzer Diskussion:JensB|Wiki]])<br />
}}<br />
<br />
Der Deutsche Wetterdienst (DWD) stellt Wetterdaten über den [https://www.dwd.de/DE/leistungen/opendata/opendata.html Open Data Server] zur Verfügung. Die Verwendung dieses Dienstes und der vom DWD zur Verf&uuml;gung gestellten Daten unterliegt den auf der OpenData Webseite beschriebenen Bedingungen. Einen Überblick über die verfügbaren Daten findet man in der Tabelle [https://www.dwd.de/DE/leistungen/opendata/help/inhalt_allgemein/opendata_content_de_en_xls.xls OpenData_weather_content.xls].<br />
<br />
<br />
== Anwendung ==<br />
Aufgrund der unterschiedlichen vom DWD bereitgestellten Datenformate benötigt das Modul zur Dekodierung je nach gewünschtem Funktionsumfang zusätzliche Perl-Module, die nicht standardmäßig vorinstalliert sind und je nach Systemkonfiguration nachinstalliert werden müssen. Außerdem unterstützt das Modul Zeitzonen, um z.B. die Wettervorhersage internationaler Stationen in Ortszeit darstellen zu können. Hierfür sind je nach Systemkonfiguration weitere Einstellungen erforderlich. Auch die Sprache der Wochentage für die Wettervorhersage ist frei wählbar. Je nach Systemkonfiguration ist aber die Standardsprache u.U. auf Englisch eingestellt, was weitere Anpassungen der Systemkonfiguration erforderlich macht.<br />
<br />
=== Vorbereitung ===<br />
Im folgenden wird z.T. von einem System mit Rasbian oder Debian mit System-V Startsystem ausgegangen. Auf anderen Betriebssystemen und auf Systemen mit System-D müssen die Installationsschritte ggf. angepasst werden.<br />
<br />
<br />
1. Für die Wettervorhersage und die Wetterwarnungen:<br />
Installation des Perl-Moduls ''XML::LibXML'' über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libxml-libxml-perl<br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
2. Falls man einen eigenen Internet-Proxy nutzt:<br />
Die Konfiguration des Proxies für FHEM erfolgt z.B. durch Eintrag von<br />
<pre><br />
attr global proxy <myProxyHost>:<myProxyPort><br />
</pre> <br />
in die [[Konfiguration]], wobei ''myProxyHost'' durch den Namen oder die IP-Adresse des Proxy-Servers ersetzt werden muss und für ''myProxyPort'' der Port des Proxy-Servers eingetragen werden muss (oft 3128).<br />
<br />
<br />
3. FHEM Uhrzeit und Zeitzone:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre><br />
in die FHEM-Kommandozeile überprüfen, ob die FHEM-Uhrzeit plausibel ist. Ist dies nicht der Fall sollten die Uhrzeit auf Systemebene überprüft werden und ggf. die Systemeinstellungen angepasst werden.<br />
Ermitteln der Bezeichnung der eigenen Zeitzone über die System-Kommandozeile mit<br />
<pre><br />
tzselect<br />
</pre><br />
und diese Bezeichnung in die Datei ''/etc/timezone'' eintragen und <br />
<pre><br />
export TZ=`cat /etc/timezone`<br />
</pre><br />
der Datei ''/etc/profile'' hinzufügen und dann das System neu starten. Nun muss die Zeitanzeige in FHEM korrekt sein.<br />
<br />
<br />
4. FHEM Sprache:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre> in die FHEM-Kommandozeile überprüfen, in welcher Sprache der Wochentag angezeigt wird. Stimmt die Sprache nicht, dann auf der System-Kommandozeile<br />
<pre><br />
dpkg-reconfigure locales<br />
</pre> eingeben und aus der Liste z.B. ''de_DE.UTF-8'' zusätzlich auswählen. Dieser Befehl gilt für Debian-basierte Betriebssysteme - für andere Betriebssysteme ist eine analoge Funktion zu verwenden. Mit Eingabe von <br />
<pre><br />
locale -a<br />
</pre> auf der System-Kommandozeile überprüfen, ob die ausgewählte Sprache nun zur Verfügung steht. Sollte FHEM nach einem Neustart noch immer nicht die gewünschte Sprache verwenden, kann man auf einem System V Linux durch Hinzufügen von z.B.<br />
<pre><br />
export LANG=de_DE.UTF-8<br />
</pre> in die Datei ''/etc/init.d/fhem'' (irgendwo zwischen ''start'' und ''perl'') und erneutem Neustart von FHEM die Sprache für FHEM erzwingen. Bei einem Systemd Linux kann man die Einstellungen mit ''systemctl edit --full fhem.service'' bearbeiten. Spätestes jetzt muss die Wochentagsanzeige in FHEM korrekt sein.<br />
<br />
<br />
5. Nur für den Weblink erforderlich:<br />
Installation des Perl-Moduls ''DateTime'' über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libdatetime-perl<br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
=== Define ===<br />
siehe [https://fhem.de/commandref.html#DWD_OpenDatadefine Commandref].<br />
<br />
=== Attributes ===<br />
siehe [https://fhem.de/commandref.html#DWD_OpenDataattr Commandref].<br />
<br />
<br />
== Anwendungsbeispiele ==<br />
=== Beispiel zur Modul-Einrichtung ===<br />
<br />
* Wettervorhersage<br />
Für die Wettervorhersage muss der Stationscode ermittelt werden. Dazu den [https://www.dwd.de/DE/leistungen/met_verfahren_mosmix/mosmix_stationskatalog.pdf MOSMIX Stationskatalog] herunterladen, öffnen und die gewünschte Station heraussuchen. Einen Teil der deutschen Stationen kann man auch der [https://www.dwd.de/DE/derdwd/messnetz/bodenbeobachtung/messnetzkarte_boden.pdf Bodenmessnetzkarte] entnehmen. Den ermittelten Stationscode kann man dann entweder für eine Einzelabfrage als Parameter für das Kommando ''get forecast'' verwenden oder für die automatische Aktualisierung als Attribut ''forecastStation'' hinterlegen. Insgesamt werden vom DWD mehr als 70 Merkmale zur Verfügung gestellt. Eine Auflistung findet sich im Dokument [https://opendata.dwd.de/weather/lib/MetElementDefinition.xml MetElementDefinition]. Nur ein kleiner Teil der Merkmale wird in der Standardeinstellung des Moduls als Reading zur Verfügung gestellt. Wer andere Merkmale benötigt muss sie mit Komma getrennt dem Attribut ''forecastProperties'' zuweisen. Es empfiehlt sich zur Performance-Optimierung sowohl das Attribut ''forecastDays'' als auch das Attribut ''forecastProperties'' auf den tatsächlichen Bedarf einzustellen.<br />
<br />
* Wetterwarnungen<br />
Für die Wetterwarnungen muss die Warnzelle ermittelt werden. Dazu [https://www.dwd.de/DE/leistungen/opendata/help/warnungen/cap_warncellids_csv.csv Warnzellen-ID Katalog] herunterladen, öffnen und die gewünschte Warnzelle heraussuchen. Unterstützt werden Gemeinden (beginnen mit 8), Landkreise (beginnen mit 1 oder 9) oder Küste (beginnen mit 5). Die Warnzellen-ID kann man dann entweder für eine Einzelabfrage als Parameter für das Kommando ''get alerts'' verwenden oder für die automatische Aktualisierung als Attribut ''alertArea'' hinterlegen. Die Warnzellen-ID ist ab der 2. Stelle identisch mit den ersten Ziffern des amtlichen Gemeindeschlüssels. Man kann z.B. den Namen von Gemeinde oder Landkreis bei den [https://www.statistik-bw.de/Statistik-Portal/gemeindeverz.asp Statistischen Ämtern des Bundes und der Länder] eingeben, den amtlichen Gemeindeschlüssels ermitteln und dann mit vorangestellter 1, 8 oder 9 im Warnzellen-ID Katalog des DWD nach einem Eintrag mit exakter oder weitgehender Übereinstimmung suchen. Wem das zu kompliziert vorkommt, kann bei mehrdeutigen Gemeinde- bzw. Landkreisbezeichnungen auch versuchen auszuprobieren, welche die richtige Wanrzellen-ID ist.<br />
<br />
Um das Modul mit automatisch Aktualisierung von Vorhersage und Wetterwarnungen zu nutzen, kann z.B. folgendes in die [[Konfiguration]] eingetragen werden:<br />
<br />
<pre><br />
define DWD DWD_OpenData<br />
attr DWD alertArea 111000000<br />
attr DWD forecastStation 99810<br />
attr DWD forecastDays 3<br />
attr DWD forecastWW2Text 1<br />
</pre><br />
<br />
* Performance<br />
Das DWD_OpenData-Modul ist ein Datenmodul mit relativ vielen Readings. In der Standardkonfiguration wird, wie bei jedem anderen FHEM Modul, bei jeder Änderung jedes Readings ein FHEM internes Ereignis erzeugt, damit andere FHEM Devices auf diese Änderungen reagieren können. Diese Ereignisse sorgen auch dafür, dass man Änderungen in der Weboberfläche sofort angezeigt bekommt, ohne die Webseite neu aufzurufen. Interessiert sich aber kein FHEM Device für die Änderungsbenachrichtung bestimmter Readings, entsteht unnötiger Verarbeitsoverhead, der je nach FHEM Konfiguration und verfügbarer CPU-Leistung auch mehrere Sekunden benötigen kann und in dieser Zeit andere Abläufe blockiert. Um die Performance zu optimieren, empfiehlt es sich, mit [[event-on-update-reading]] für eine angepasste und dadurch effizientere Verarbeitung sorgen, indem man nur für die Readings Ereignisse zulässt, die man für die Weiterverarbeitung braucht. Der DWD_OpenData_Weblink braucht z.B. gar keine Ereignisse, um zu funktionieren. Hier eine minimalistische Beispielkonfiguration:<br />
<br />
<pre><br />
attr DWD event-on-update-reading state,fc_state,a_state<br />
</pre><br />
<br />
Weitere Details zur Installation und Konfiguration des Moduls finden sich in der [https://fhem.de/commandref.html#DWD_OpenData Commandref].<br />
<br />
<br />
=== Beispiel für die Einrichtung eines Meteogramms ===<br />
Um den vorhergesagten Wetterverlauf als Meteogramm in Kurvenfrom mit [[SVG]] darzustellen, kann man wie folgt vorgehen:<br />
<br />
1. 99_myUtils.pm<br />
<br />
Für die Bestimmung der Werte für den SVG-Plot wird eine Perl-Funktion benötigt, die in die Datei 99_myUtils.pm vor dem Ende eingefügt wird. Wer diese FHEM-Datei noch nicht nutzt, legt sie einfach an (siehe [[99_myUtils_anlegen]]).<br />
<source lang="perl"><br />
package main;<br />
<br />
use strict;<br />
use warnings;<br />
<br />
...<br />
<br />
#<br />
# (c) mumpitzstuff 19.12.2018<br />
#<br />
# see https://forum.fhem.de/index.php/topic,83097.msg874150.html#msg874150<br />
#<br />
sub logProxy_dwd2Plot($$$$;$$$)<br />
{<br />
my ($device, $fcValue, $from, $to, $fcHour, $expMode, $shiftTime) = @_;<br />
my $regex;<br />
my @rl;<br />
<br />
return undef if(!$device);<br />
<br />
if ($fcValue =~ s/_$//)<br />
{<br />
$regex = "^fc[\\d]+_[\\d]+_".$fcValue."\$";<br />
}<br />
else<br />
{<br />
$regex = "^fc[\\d]+_".$fcValue."\$";<br />
}<br />
<br />
$fcHour = 12 if(!defined($fcHour));<br />
$expMode = "point" if(!defined($expMode));<br />
#Log3 undef,2, "Regex: ".$regex;<br />
<br />
# ermitteln aller relevanten Readings<br />
if ( defined($defs{$device}) )<br />
{<br />
if ( $defs{$device}{TYPE} eq "DWD_OpenData" )<br />
{<br />
@rl = sort<br />
{<br />
my ($an) = ($a =~ m/fc(\d+)_.*/);<br />
my ($bn) = ($b =~ m/fc(\d+)_.*/);<br />
my ($ao) = ($a =~ m/fc\d+_(\d+).*/);<br />
my ($bo) = ($b =~ m/fc\d+_(\d+).*/);<br />
$an <=> $bn or $ao <=> $bo or $a cmp $b;<br />
} ( grep /${regex}/,keys %{$defs{$device}{READINGS}} );<br />
return undef if ( !@rl );<br />
}<br />
else<br />
{<br />
Log3 undef, 2, "logProxy_dwd2Plot: $device is not a DWD_OpenData device";<br />
return undef;<br />
}<br />
}<br />
<br />
my $fromsec = SVG_time_to_sec($from);<br />
my $tosec = SVG_time_to_sec($to);<br />
my $sec = $fromsec;<br />
my ($h, $hp, $fcDay, $mday, $mon, $year);<br />
my $timestamp;<br />
<br />
my $reading;<br />
my $value;<br />
my $prev_value;<br />
my $min = 999999;<br />
my $max = -999999;<br />
my $ret = "";<br />
<br />
# while not end of plot range reached<br />
while (($sec < $tosec) && @rl)<br />
{<br />
#remember previous value for start of plot range<br />
$prev_value = $value;<br />
<br />
$reading = shift @rl;<br />
($fcDay) = $reading =~ m/^fc(\d+).*/;<br />
($hp) = $reading =~ m/^fc\d+_(\d+).*/;<br />
#Log 1, "hp: ".$hp;<br />
<br />
if ($hp)<br />
{<br />
$h = ReadingsVal($device, "fc".$fcDay."_".$hp."_time", $fcHour);<br />
if ($h =~ m/^(\d+):\d+/)<br />
{<br />
$h = $1;<br />
}<br />
}<br />
else<br />
{<br />
$h = $fcHour;<br />
}<br />
<br />
$value = ReadingsVal($device, $reading, undef);<br />
<br />
# calculate minutes of sunshine per hour<br />
if ($fcValue =~ /^SunD(\d+)/)<br />
{<br />
if (defined($1))<br />
{<br />
$value = $value / ($1 * 36);<br />
}<br />
else<br />
{<br />
$value = $value / (12 * 36);<br />
}<br />
}<br />
<br />
# calculate amount of rain per hour<br />
if ($fcValue =~ /^RR(\d+)c$/)<br />
{<br />
if (defined($1))<br />
{<br />
$value /= $1;<br />
}<br />
}<br />
<br />
($year, $mon, $mday) = split('\-',ReadingsVal($device, "fc".$fcDay."_date",undef));<br />
$timestamp = sprintf("%04d-%02d-%02d_%02d:%02d:%02d", $year, $mon, $mday, $h, 0, 0);<br />
$sec = SVG_time_to_sec($timestamp);<br />
if (defined($shiftTime))<br />
{<br />
$sec += $shiftTime;<br />
$timestamp = logProxy_shiftTime($timestamp, $shiftTime);<br />
}<br />
<br />
# skip all values before start of plot range<br />
next if ( $sec < $fromsec );<br />
<br />
# add first value at start of plot range<br />
if ( !$ret && $prev_value )<br />
{<br />
$min = $prev_value if ( $prev_value < $min );<br />
$max = $prev_value if ( $prev_value > $max );<br />
$ret .= "$from $prev_value\n";<br />
}<br />
<br />
# done if after end of plot range<br />
last if ($sec > $tosec);<br />
<br />
$min = $value if ( $value < $min );<br />
$max = $value if ( $value > $max );<br />
<br />
# add actual control point<br />
$ret .= "$timestamp $value\n";<br />
}<br />
<br />
if (($sec < $tosec) && !@rl && ($expMode eq "day"))<br />
{<br />
$timestamp = sprintf("%04d-%02d-%02d_%02d:%02d:%02d", $year, $mon, $mday, 23, 59, 59);<br />
$_ = SVG_time_to_sec($timestamp);<br />
if (defined($shiftTime))<br />
{<br />
$_ += $shiftTime;<br />
$timestamp = logProxy_shiftTime($timestamp, $shiftTime);<br />
}<br />
<br />
if ($_ < $tosec)<br />
{<br />
$ret .= "$timestamp $value\n";<br />
}<br />
else<br />
{<br />
$ret .= "$to $value\n";<br />
}<br />
}<br />
elsif (($sec > $tosec) && ($expMode eq "day"))<br />
{<br />
$value = $prev_value + ($value - $prev_value) * (86400 + ($tosec - $sec)) / 86400;<br />
$ret .= "$to $value\n";<br />
}<br />
<br />
return ($ret, $min, $max, $prev_value);<br />
} <br />
<br />
1;<br />
</source><br />
<br />
2. LogProxy<br />
<br />
Wer bereits ein [[logProxy]]-Device hat, muss den Namen seines logProxy-Devices in die weiter unter aufgeführte GPlot-Konfiguration eintragen. Ansonsten wird es wie folgt neu erstellt:<br />
<pre><br />
define LogProxy logProxy<br />
</pre><br />
<br />
3. FileLog<br />
<br />
Das Meteogramm kennt anders als andere FHEM-Plots keine Vergangenheit außer heute. Trotzdem wird aus formalen Gründen eine [[FileLog]]-Device benötigt. Dazu kann ein beliebiges vorhandenes FileLog-Device verwendet werden. Wer will, kann hierfür aber auch ein neues FileLog Device für das DWD_OpenData-Device anlegen (Achtung: wird schnell umfangreich):<br />
<pre><br />
define FileLog_DWD FileLog ./log/DWD-%Y-%m.log DWD<br />
</pre><br />
<br />
Im folgenden wird für das FileLog-Device der Platzhalter ''FileLog_Dummy'' verwendet, der mit dem Namen des gewählten FileLog-Devices zu ersetzen ist.<br />
<br />
4. SVG Plot<br />
<br />
Das eigentliche Meteogramm ist ein SVG-Device. Will man mehrere Tage darstellen bietet sich die folgende Definition an:<br />
<pre><br />
define SVG_DWD SVG FileLog_Dummy:SVG_DWD:CURRENT<br />
attr SVG_DWD fixedoffset 6<br />
attr SVG_DWD fixedrange 7days<br />
attr SVG_DWD nrAxis 1,2<br />
</pre><br />
<br />
Dabei muss das SVG-Attribut ''fixedoffset'' entweder gleich oder kleiner als die Einstellung des DWD_OpenData-Attributs ''forecastDays'' (Standardwert: 6 Tage) gewählt werden und das SVG-Attribut ''fixedrange'' um eins größer als ''fixedoffset'' eingestellt werden.<br />
<br />
Will man statt dessen nur die nächsten 24 Stunden anzeigen, nimmt man folgende Einstellungen:<br />
<pre><br />
define SVG_DWD SVG FileLog_Dummy:SVG_DWD:CURRENT<br />
attr SVG_DWD endPlotNow 1<br />
attr SVG_DWD fixedoffset 1<br />
attr SVG_FileLog_WETTER_DWD_3 label "Tmin: $data{max1} °C, Tmax: $data{min1} °C"<br />
attr SVG_DWD nrAxis 1,2<br />
</pre><br />
<br />
Um die DWD_OpenData-Readings mit dem Plot zu verknüpfen, muss man nun die GPlot-Konfigurationsdatei des SVG-Plots manuell bearbeiten. Dazu auf den Link klicken, der im SVG_DWD-Device am Internal ''GPLOTFILE'' steht. Die y-Wertebereiche für die Regenmenge und die Temperaturen sind im Beispiel auskommentiert (Autorange). Das kann man so lassen oder man stellt sie nach den eigenen Wettergegebenheiten ein. Je nach Konfiguration des DWD_OpenData-Attributs ''forecastResolution'' sind aber noch einige weitere Einstellungen anzupassen. Das folgende Beispiel ist für die 3h-Auflösung:<br />
<pre><br />
set terminal png transparent size <SIZE> crop<br />
set output '<OUT>.png'<br />
set xdata time<br />
set timefmt "%Y-%m-%d_%H:%M:%S"<br />
set xlabel " "<br />
set title 'Wettervorhersage'<br />
set ytics <br />
set y2tics <br />
set grid ytics<br />
set ylabel "Regen [mm]"<br />
#set yrange [0:4]<br />
set y2label "Temperatur [°C]"<br />
#set y2range [-5:35]<br />
set y3label "Wolken/Regen/Sonne [%]"<br />
set y3range [0:100]<br />
<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","TTT_",$from,$to,0,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Tx",$from,$to,18,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Tn",$from,$to,6,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","SunD3_",$from,$to,0,"day",(-3*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","RR3c_",$from,$to,0,"day",(-3*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","FX1_",$from,$to,0,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","R600_",$from,$to,0,"day",(-3*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Neff_",$from,$to,0,"day")<br />
#LogProxy ConstX:TimeNow(),0,100<br />
#LogProxy ConstY:0<br />
<br />
plot "<IN>" using 1:2 axes x1y2 title 'T' ls l0 lw 2 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y2 title 'Tmax' ls l0dot lw 2 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y2 title 'Tmin' ls l0dot lw 2 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 title 'Sonne' ls l4fill lw 1 with lines,\<br />
"<IN>" using 1:2 axes x1y1 title 'Regenmenge' ls l2fill lw 1 with steps,\<br />
"<IN>" using 1:2 axes x1y3 title 'Wind' ls l1 lw 1 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 title 'Regen' ls l5fill lw 1 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 title 'Wolken' ls l6fill lw 1 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 notitle ls l5 lw 4 with lines,\<br />
"<IN>" using 1:2 axes x1y2 notitle ls l5 lw 1 with lines<br />
</pre><br />
<br />
Verwendet man dagegen eine Auflösung von 1 Stunde, sind folgende LogProxy-Einträge erforderlich:<br />
<pre><br />
#LogProxy Func:logProxy_dwd2Plot("DWD","TTT_",$from,$to,0,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Tx",$from,$to,18,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Tn",$from,$to,6,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","SunD1_",$from,$to,0,"day",(-1*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","RR1c_",$from,$to,0,"day",(-1*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","FX1_",$from,$to,0,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","R101_",$from,$to,0,"day",(-0.5*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Neff_",$from,$to,0,"day")<br />
#LogProxy ConstX:TimeNow(),0,100<br />
#LogProxy ConstY:0<br />
</pre><br />
<br />
Für die Darstellung der nächsten 24 Stunden mit einer Auflösung von 1 Stunde nimmt man folgende GPlot-Konfiguration:<br />
<pre><br />
set terminal png transparent size <SIZE> crop<br />
set output '<OUT>.png'<br />
set xdata time<br />
set timefmt "%Y-%m-%d_%H:%M:%S"<br />
set xlabel " "<br />
set title '<L1>'<br />
set ytics<br />
set y2tics<br />
set y3tics<br />
set grid xtics y2tics<br />
set ylabel "Regen [mm]"<br />
set y2label "Temperatur [°C]"<br />
set y3label "Wolken/Regen/Sonne [%]"<br />
set y3range [0:100]<br />
<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","TTT_",$from,$to,0,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","SunD1_",$from,$to,0,"day",(-1*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","RR1c_",$from,$to,0,"day",(-1*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","FX1_",$from,$to,0,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","R101_",$from,$to,0,"day",(-0.5*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Neff_",$from,$to,0,"day")<br />
#LogProxy ConstY:0<br />
<br />
plot "<IN>" using 1:2 axes x1y2 title 'T' ls l0 lw 2 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 title 'Sonne' ls l4fill lw 1 with lines,\<br />
"<IN>" using 1:2 axes x1y1 title 'Regenmenge' ls l2fill lw 1 with steps,\<br />
"<IN>" using 1:2 axes x1y3 title 'Wind' ls l1 lw 1 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 title 'Regen' ls l5fill lw 1 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 title 'Wolken' ls l6fill lw 1 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y2 notitle ls l2 lw 2 with lines<br />
</pre><br />
<br />
Je nachdem, welche Auflösung man verwendet, werden unterschiedliche Readings des DWD_OpenData-Devices benötigt. Diese sind in den LogProxy-Zeilen in der GPlot-Konfigurationsdatei zu finden und müssen auf jeden Fall dem Attribut ''forecastProperties'' des DWD_OpenData-Device hinzugefügt werden.<br />
<br />
Viele Detaileinstellungen des Meteogramms lassen sich individualisieren. Man kann z.B. mehr oder weniger Daten anzeigen und zumindest für ''heute'' auch aktuelle Messwerte hinzufügen.<br />
<br />
Hier ein Beispiel für ein Meteogramm über 4 Tage mit 3 Stunden Auflösung:<br />
<br />
[[File:DWDODmeteogram4d3h.png|500px]]<br />
<br />
<br />
=== Beispiel für die Einrichtung eines Weblinks ===<br />
Zur graphischen Darstellung der Vorhersage und der Wetterwarnungen mit [[FHEMWEB]] steht das Modul [https://raw.githubusercontent.com/jnsbyr/fhem/master/FHEM/99_DWD_OpenData_Weblink.pm 99_DWD_OpenData_Weblink.pm] zur Verfügung.<br />
<br />
Zunächst die Moduldatei herunterladen und in das Modulverzeichnis ''fhem/FHEM'' kopieren. Entweder die Datei direkt auf den FHEM-Server herunterladen (z.B. mit ''wget'') oder beim indirekten Herunterladen darauf achten, dass dabei das Encoding nicht verändert wird (also z.B. bei WinSCP den Binär-Modus und nicht den Text-Modus verwenden). Ansonsten werden später z.B. Sonderzeichen wie ''°C'' falsch angezeigt. <br />
<br />
Anschließend kann in die [[Konfiguration]] z.B. folgendes eingetragen werden:<br />
<br />
<pre><br />
define DWD_Weblink_Generator DWD_OpenData_Weblink<br />
attr DWD_Weblink_Generator IODev DWD<br />
attr DWD_Weblink_Generator forecastDays 4<br />
# refreshRate nur dann setzten, wenn der Browser Java-Script beherrscht:<br />
attr DWD_Weblink_Generator refreshRate 900<br />
<br />
define DWD_Weblink weblink htmlCode { DWD_OpenData_Weblink::AsHtmlH("DWD_Weblink_Generator") } <br />
</pre><br />
<br />
Damit legt man das Weblink-Generator-Device an und verknüpft es mit dem DWD_OpenData-Device. Außerdem wird der [[weblink ]] selbst angelegt, der seinerseits mit dem Weblink-Generator-Device verknüpft wird. Der Weblink benötigt für seine Funktion eine bestimmte Auswahl der Vorhersage-Merkmale. Wer das Attribut ''forecastProperties'' des DWD_OpenData-Moduls anpassen will, muss diese Merkmale auf jeden Fall mit berücksichtigen. <br />
<br />
Wenn vom Weblink nichts im Browser zu sehen ist, kann das daran liegen, dass der Browser kein aktuelles JavaScript verwendet oder JavaScript deaktiviert ist. Dann sollte das Attribut ''refreshRate'' auf 0 Sekunden eingestellt oder gelöscht werden. Mit aktiviertem Refresh werden die Daten auch ohne Seitenneuaufbau regelmäßig und bei Tab-Wechsel aktualisiert.<br />
<br />
Die Liste der erforderlichen Vorhersage-Merkmale finden sich zusammen mit allen weitere Details zur Installation und Konfiguration in der Modulhilfe von ''99_DWD_OpenData_Weblink.pm'', die man z.B. nach dem Anlegen des Weblink-Generator-Devices über die Weboberfläche abrufen kann.<br />
<br />
Hier ein Ausschnitt aus der Darstellung des Weblinks mit [[FHEMWEB]]:<br />
<br />
[[File:DWDODweblink.png|500px]]</div>JensBhttp://wiki.fhem.de/w/index.php?title=DWD_OpenData&diff=29922DWD OpenData2019-03-16T19:25:18Z<p>JensB: Beispiel für die Einrichtung eines Meteogramms</p>
<hr />
<div>{{SEITENTITEL:DWD_OpenData}}<br />
<br />
{{Hinweis|Versionsänderung: Die Vorhersagedaten wurden Mitte September 2018 von CSV auf KML umgestellt. Diese Umstellung ist inkompatibel: das DWD_OpenData-Modul muss aktualisiert werden, einige Reading-Namen haben sich geändert und der Weblink muss deinstalliert und neu installiert werden (siehe diesen {{Link2Forum|Topic=83097|Message=840270}} im Forum).}}<br />
<br />
{{<br />
Infobox Modul<br />
|ModPurpose=Daten vom DWD OpenData Server abrufen<br />
|ModType=d<br />
|ModCmdRef=DWD_OpenData<br />
|ModForumArea=Unterstützende Dienste/Wettermodule<br />
|ModTechName=55_DWD_OpenData.pm<br />
|ModOwner=JensB ({{Link2FU|14024|Forum}}/[[Benutzer Diskussion:JensB|Wiki]])<br />
}}<br />
<br />
Der Deutsche Wetterdienst (DWD) stellt Wetterdaten über den [https://www.dwd.de/DE/leistungen/opendata/opendata.html Open Data Server] zur Verfügung. Die Verwendung dieses Dienstes und der vom DWD zur Verf&uuml;gung gestellten Daten unterliegt den auf der OpenData Webseite beschriebenen Bedingungen. Einen Überblick über die verfügbaren Daten findet man in der Tabelle [https://www.dwd.de/DE/leistungen/opendata/help/inhalt_allgemein/opendata_content_de_en_xls.xls OpenData_weather_content.xls].<br />
<br />
<br />
== Anwendung ==<br />
Aufgrund der unterschiedlichen vom DWD bereitgestellten Datenformate benötigt das Modul zur Dekodierung je nach gewünschtem Funktionsumfang zusätzliche Perl-Module, die nicht standardmäßig vorinstalliert sind und je nach Systemkonfiguration nachinstalliert werden müssen. Außerdem unterstützt das Modul Zeitzonen, um z.B. die Wettervorhersage internationaler Stationen in Ortszeit darstellen zu können. Hierfür sind je nach Systemkonfiguration weitere Einstellungen erforderlich. Auch die Sprache der Wochentage für die Wettervorhersage ist frei wählbar. Je nach Systemkonfiguration ist aber die Standardsprache u.U. auf Englisch eingestellt, was weitere Anpassungen der Systemkonfiguration erforderlich macht.<br />
<br />
=== Vorbereitung ===<br />
Im folgenden wird z.T. von einem System mit Rasbian oder Debian mit System-V Startsystem ausgegangen. Auf anderen Betriebssystemen und auf Systemen mit System-D müssen die Installationsschritte ggf. angepasst werden.<br />
<br />
<br />
1. Für die Wettervorhersage und die Wetterwarnungen:<br />
Installation des Perl-Moduls ''XML::LibXML'' über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libxml-libxml-perl<br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
2. Falls man einen eigenen Internet-Proxy nutzt:<br />
Die Konfiguration des Proxies für FHEM erfolgt z.B. durch Eintrag von<br />
<pre><br />
attr global proxy <myProxyHost>:<myProxyPort><br />
</pre> <br />
in die [[Konfiguration]], wobei ''myProxyHost'' durch den Namen oder die IP-Adresse des Proxy-Servers ersetzt werden muss und für ''myProxyPort'' der Port des Proxy-Servers eingetragen werden muss (oft 3128).<br />
<br />
<br />
3. FHEM Uhrzeit und Zeitzone:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre><br />
in die FHEM-Kommandozeile überprüfen, ob die FHEM-Uhrzeit plausibel ist. Ist dies nicht der Fall sollten die Uhrzeit auf Systemebene überprüft werden und ggf. die Systemeinstellungen angepasst werden.<br />
Ermitteln der Bezeichnung der eigenen Zeitzone über die System-Kommandozeile mit<br />
<pre><br />
tzselect<br />
</pre><br />
und diese Bezeichnung in die Datei ''/etc/timezone'' eintragen und <br />
<pre><br />
export TZ=`cat /etc/timezone`<br />
</pre><br />
der Datei ''/etc/profile'' hinzufügen und dann das System neu starten. Nun muss die Zeitanzeige in FHEM korrekt sein.<br />
<br />
<br />
4. FHEM Sprache:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre> in die FHEM-Kommandozeile überprüfen, in welcher Sprache der Wochentag angezeigt wird. Stimmt die Sprache nicht, dann auf der System-Kommandozeile<br />
<pre><br />
dpkg-reconfigure locales<br />
</pre> eingeben und aus der Liste z.B. ''de_DE.UTF-8'' zusätzlich auswählen. Dieser Befehl gilt für Debian-basierte Betriebssysteme - für andere Betriebssysteme ist eine analoge Funktion zu verwenden. Mit Eingabe von <br />
<pre><br />
locale -a<br />
</pre> auf der System-Kommandozeile überprüfen, ob die ausgewählte Sprache nun zur Verfügung steht. Sollte FHEM nach einem Neustart noch immer nicht die gewünschte Sprache verwenden, kann man auf einem System V Linux durch Hinzufügen von z.B.<br />
<pre><br />
export LANG=de_DE.UTF-8<br />
</pre> in die Datei ''/etc/init.d/fhem'' (irgendwo zwischen ''start'' und ''perl'') und erneutem Neustart von FHEM die Sprache für FHEM erzwingen. Bei einem Systemd Linux kann man die Einstellungen mit ''systemctl edit --full fhem.service'' bearbeiten. Spätestes jetzt muss die Wochentagsanzeige in FHEM korrekt sein.<br />
<br />
<br />
5. Nur für den Weblink erforderlich:<br />
Installation des Perl-Moduls ''DateTime'' über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libdatetime-perl<br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
=== Define ===<br />
siehe [https://fhem.de/commandref.html#DWD_OpenDatadefine Commandref].<br />
<br />
=== Attributes ===<br />
siehe [https://fhem.de/commandref.html#DWD_OpenDataattr Commandref].<br />
<br />
<br />
== Anwendungsbeispiele ==<br />
=== Beispiel zur Modul-Einrichtung ===<br />
<br />
* Wettervorhersage<br />
Für die Wettervorhersage muss der Stationscode ermittelt werden. Dazu den [https://www.dwd.de/DE/leistungen/met_verfahren_mosmix/mosmix_stationskatalog.pdf MOSMIX Stationskatalog] herunterladen, öffnen und die gewünschte Station heraussuchen. Einen Teil der deutschen Stationen kann man auch der [https://www.dwd.de/DE/derdwd/messnetz/bodenbeobachtung/messnetzkarte_boden.pdf Bodenmessnetzkarte] entnehmen. Den ermittelten Stationscode kann man dann entweder für eine Einzelabfrage als Parameter für das Kommando ''get forecast'' verwenden oder für die automatische Aktualisierung als Attribut ''forecastStation'' hinterlegen. Insgesamt werden vom DWD mehr als 70 Merkmale zur Verfügung gestellt. Eine Auflistung findet sich im Dokument [https://opendata.dwd.de/weather/lib/MetElementDefinition.xml MetElementDefinition]. Nur ein kleiner Teil der Merkmale wird in der Standardeinstellung des Moduls als Reading zur Verfügung gestellt. Wer andere Merkmale benötigt muss sie mit Komma getrennt dem Attribut ''forecastProperties'' zuweisen. Es empfiehlt sich zur Performance-Optimierung sowohl das Attribut ''forecastDays'' als auch das Attribut ''forecastProperties'' auf den tatsächlichen Bedarf einzustellen.<br />
<br />
* Wetterwarnungen<br />
Für die Wetterwarnungen muss die Warnzelle ermittelt werden. Dazu [https://www.dwd.de/DE/leistungen/opendata/help/warnungen/cap_warncellids_csv.csv Warnzellen-ID Katalog] herunterladen, öffnen und die gewünschte Warnzelle heraussuchen. Unterstützt werden Gemeinden (beginnen mit 8), Landkreise (beginnen mit 1 oder 9) oder Küste (beginnen mit 5). Die Warnzellen-ID kann man dann entweder für eine Einzelabfrage als Parameter für das Kommando ''get alerts'' verwenden oder für die automatische Aktualisierung als Attribut ''alertArea'' hinterlegen. Die Warnzellen-ID ist ab der 2. Stelle identisch mit den ersten Ziffern des amtlichen Gemeindeschlüssels. Man kann z.B. den Namen von Gemeinde oder Landkreis bei den [https://www.statistik-bw.de/Statistik-Portal/gemeindeverz.asp Statistischen Ämtern des Bundes und der Länder] eingeben, den amtlichen Gemeindeschlüssels ermitteln und dann mit vorangestellter 1, 8 oder 9 im Warnzellen-ID Katalog des DWD nach einem Eintrag mit exakter oder weitgehender Übereinstimmung suchen. Wem das zu kompliziert vorkommt, kann bei mehrdeutigen Gemeinde- bzw. Landkreisbezeichnungen auch versuchen auszuprobieren, welche die richtige Wanrzellen-ID ist.<br />
<br />
Um das Modul mit automatisch Aktualisierung von Vorhersage und Wetterwarnungen zu nutzen, kann z.B. folgendes in die [[Konfiguration]] eingetragen werden:<br />
<br />
<pre><br />
define DWD DWD_OpenData<br />
attr DWD alertArea 111000000<br />
attr DWD forecastStation 99810<br />
attr DWD forecastDays 3<br />
attr DWD forecastWW2Text 1<br />
</pre><br />
<br />
* Performance<br />
Das DWD_OpenData-Modul ist ein Datenmodul mit relativ vielen Readings. In der Standardkonfiguration wird, wie bei jedem anderen FHEM Modul, bei jeder Änderung jedes Readings ein FHEM internes Ereignis erzeugt, damit andere FHEM Devices auf diese Änderungen reagieren können. Diese Ereignisse sorgen auch dafür, dass man Änderungen in der Weboberfläche sofort angezeigt bekommt, ohne die Webseite neu aufzurufen. Interessiert sich aber kein FHEM Device für die Änderungsbenachrichtung bestimmter Readings, entsteht unnötiger Verarbeitsoverhead, der je nach FHEM Konfiguration und verfügbarer CPU-Leistung auch mehrere Sekunden benötigen kann und in dieser Zeit andere Abläufe blockiert. Um die Performance zu optimieren, empfiehlt es sich, mit [[event-on-update-reading]] für eine angepasste und dadurch effizientere Verarbeitung sorgen, indem man nur für die Readings Ereignisse zulässt, die man für die Weiterverarbeitung braucht. Der DWD_OpenData_Weblink braucht z.B. gar keine Ereignisse, um zu funktionieren. Hier eine minimalistische Beispielkonfiguration:<br />
<br />
<pre><br />
attr DWD event-on-update-reading state,fc_state,a_state<br />
</pre><br />
<br />
Weitere Details zur Installation und Konfiguration des Moduls finden sich in der [https://fhem.de/commandref.html#DWD_OpenData Commandref].<br />
<br />
<br />
=== Beispiel für die Einrichtung eines Meteogramms ===<br />
Um den vorhergesagten Wetterverlauf als Meteogramm in Kurvenfrom mit [[SVG]] darzustellen, kann man wie folgt vorgehen:<br />
<br />
1. 99_myUtils.pm<br />
<br />
Für die Bestimmung der Werte für den SVG-Plot wird eine Perl-Funktion benötigt, die in die Datei 99_myUtils.pm vor dem Ende eingefügt wird. Wer diese FHEM-Datei noch nicht nutzt, legt sie einfach an (siehe [[99_myUtils_anlegen]]).<br />
<source lang="perl"><br />
package main;<br />
<br />
use strict;<br />
use warnings;<br />
<br />
...<br />
<br />
#<br />
# (c) mumpitzstuff 19.12.2018<br />
#<br />
# see https://forum.fhem.de/index.php/topic,83097.msg874150.html#msg874150<br />
#<br />
sub logProxy_dwd2Plot($$$$;$$$)<br />
{<br />
my ($device, $fcValue, $from, $to, $fcHour, $expMode, $shiftTime) = @_;<br />
my $regex;<br />
my @rl;<br />
<br />
return undef if(!$device);<br />
<br />
if ($fcValue =~ s/_$//)<br />
{<br />
$regex = "^fc[\\d]+_[\\d]+_".$fcValue."\$";<br />
}<br />
else<br />
{<br />
$regex = "^fc[\\d]+_".$fcValue."\$";<br />
}<br />
<br />
$fcHour = 12 if(!defined($fcHour));<br />
$expMode = "point" if(!defined($expMode));<br />
#Log3 undef,2, "Regex: ".$regex;<br />
<br />
# ermitteln aller relevanten Readings<br />
if ( defined($defs{$device}) )<br />
{<br />
if ( $defs{$device}{TYPE} eq "DWD_OpenData" )<br />
{<br />
@rl = sort<br />
{<br />
my ($an) = ($a =~ m/fc(\d+)_.*/);<br />
my ($bn) = ($b =~ m/fc(\d+)_.*/);<br />
my ($ao) = ($a =~ m/fc\d+_(\d+).*/);<br />
my ($bo) = ($b =~ m/fc\d+_(\d+).*/);<br />
$an <=> $bn or $ao <=> $bo or $a cmp $b;<br />
} ( grep /${regex}/,keys %{$defs{$device}{READINGS}} );<br />
return undef if ( !@rl );<br />
}<br />
else<br />
{<br />
Log3 undef, 2, "logProxy_dwd2Plot: $device is not a DWD_OpenData device";<br />
return undef;<br />
}<br />
}<br />
<br />
my $fromsec = SVG_time_to_sec($from);<br />
my $tosec = SVG_time_to_sec($to);<br />
my $sec = $fromsec;<br />
my ($h, $hp, $fcDay, $mday, $mon, $year);<br />
my $timestamp;<br />
<br />
my $reading;<br />
my $value;<br />
my $prev_value;<br />
my $min = 999999;<br />
my $max = -999999;<br />
my $ret = "";<br />
<br />
# while not end of plot range reached<br />
while (($sec < $tosec) && @rl)<br />
{<br />
#remember previous value for start of plot range<br />
$prev_value = $value;<br />
<br />
$reading = shift @rl;<br />
($fcDay) = $reading =~ m/^fc(\d+).*/;<br />
($hp) = $reading =~ m/^fc\d+_(\d+).*/;<br />
#Log 1, "hp: ".$hp;<br />
<br />
if ($hp)<br />
{<br />
$h = ReadingsVal($device, "fc".$fcDay."_".$hp."_time", $fcHour);<br />
if ($h =~ m/^(\d+):\d+/)<br />
{<br />
$h = $1;<br />
}<br />
}<br />
else<br />
{<br />
$h = $fcHour;<br />
}<br />
<br />
$value = ReadingsVal($device, $reading, undef);<br />
<br />
# calculate minutes of sunshine per hour<br />
if ($fcValue =~ /^SunD(\d+)/)<br />
{<br />
if (defined($1))<br />
{<br />
$value = $value / ($1 * 36);<br />
}<br />
else<br />
{<br />
$value = $value / (12 * 36);<br />
}<br />
}<br />
<br />
# calculate amount of rain per hour<br />
if ($fcValue =~ /^RR(\d+)c$/)<br />
{<br />
if (defined($1))<br />
{<br />
$value /= $1;<br />
}<br />
}<br />
<br />
($year, $mon, $mday) = split('\-',ReadingsVal($device, "fc".$fcDay."_date",undef));<br />
$timestamp = sprintf("%04d-%02d-%02d_%02d:%02d:%02d", $year, $mon, $mday, $h, 0, 0);<br />
$sec = SVG_time_to_sec($timestamp);<br />
if (defined($shiftTime))<br />
{<br />
$sec += $shiftTime;<br />
$timestamp = logProxy_shiftTime($timestamp, $shiftTime);<br />
}<br />
<br />
# skip all values before start of plot range<br />
next if ( $sec < $fromsec );<br />
<br />
# add first value at start of plot range<br />
if ( !$ret && $prev_value )<br />
{<br />
$min = $prev_value if ( $prev_value < $min );<br />
$max = $prev_value if ( $prev_value > $max );<br />
$ret .= "$from $prev_value\n";<br />
}<br />
<br />
# done if after end of plot range<br />
last if ($sec > $tosec);<br />
<br />
$min = $value if ( $value < $min );<br />
$max = $value if ( $value > $max );<br />
<br />
# add actual control point<br />
$ret .= "$timestamp $value\n";<br />
}<br />
<br />
if (($sec < $tosec) && !@rl && ($expMode eq "day"))<br />
{<br />
$timestamp = sprintf("%04d-%02d-%02d_%02d:%02d:%02d", $year, $mon, $mday, 23, 59, 59);<br />
$_ = SVG_time_to_sec($timestamp);<br />
if (defined($shiftTime))<br />
{<br />
$_ += $shiftTime;<br />
$timestamp = logProxy_shiftTime($timestamp, $shiftTime);<br />
}<br />
<br />
if ($_ < $tosec)<br />
{<br />
$ret .= "$timestamp $value\n";<br />
}<br />
else<br />
{<br />
$ret .= "$to $value\n";<br />
}<br />
}<br />
elsif (($sec > $tosec) && ($expMode eq "day"))<br />
{<br />
$value = $prev_value + ($value - $prev_value) * (86400 + ($tosec - $sec)) / 86400;<br />
$ret .= "$to $value\n";<br />
}<br />
<br />
return ($ret, $min, $max, $prev_value);<br />
} <br />
<br />
1;<br />
</source><br />
<br />
2. LogProxy<br />
<br />
Wer bereits ein [[logProxy]]-Device hat, muss den Namen seines logProxy-Devices in die weiter unter aufgeführte GPlot-Konfiguration eintragen. Ansonsten wird es wie folgt neu erstellt:<br />
<pre><br />
define LogProxy logProxy<br />
</pre><br />
<br />
3. FileLog<br />
<br />
Das Meteogramm kennt anders als andere FHEM-Plots keine Vergangenheit außer heute. Trotzdem wird aus formalen Gründen eine [[FileLog]]-Device benötigt. Dazu kann ein beliebiges vorhandenes FileLog-Device verwendet werden. Wer will, kann hierfür aber auch ein neues FileLog Device für das DWD_OpenData-Device anlegen (Achtung: wird schnell umfangreich):<br />
<pre><br />
define FileLog_DWD FileLog ./log/DWD-%Y-%m.log DWD<br />
</pre><br />
<br />
Im folgenden wird für das FileLog-Device der Platzhalter ''FileLog_Dummy'' verwendet, der mit dem Namen des gewählten FileLog-Devices zu ersetzen ist.<br />
<br />
4. SVG Plot<br />
<br />
Das eigentliche Meteogramm ist ein SVG-Device. Will man mehrere Tage darstellen bietet sich die folgende Definition an:<br />
<pre><br />
define SVG_DWD SVG FileLog_Dummy:SVG_DWD:CURRENT<br />
attr SVG_DWD fixedoffset 6<br />
attr SVG_DWD fixedrange 7days<br />
attr SVG_DWD nrAxis 1,2<br />
</pre><br />
<br />
Dabei muss das SVG-Attribut ''fixedoffset'' entweder gleich oder kleiner als die Einstellung des DWD_OpenData-Attributs ''forecastDays'' (Standardwert: 6 Tage) gewählt werden und das SVG-Attribut ''fixedrange'' um eins größer als ''fixedoffset'' eingestellt werden.<br />
<br />
Will man statt dessen nur die nächsten 24 Stunden anzeigen, nimmt man folgende Einstellungen:<br />
<pre><br />
define SVG_DWD SVG FileLog_Dummy:SVG_DWD:CURRENT<br />
attr SVG_DWD endPlotNow 1<br />
attr SVG_DWD fixedoffset 1<br />
attr SVG_DWD nrAxis 1,2<br />
</pre><br />
<br />
Um die DWD_OpenData-Readings mit dem Plot zu verknüpfen, muss man nun die GPlot-Konfigurationsdatei des SVG-Plots manuell bearbeiten. Dazu auf den Link klicken, der im SVG_DWD-Device am Internal ''GPLOTFILE'' steht. Für die y-Wertebereiche sollte man die eigenen Wettergegebenheiten zu Grunde legen. Je nach Konfiguration des DWD_OpenData-Attributs ''forecastResolution'' sind aber noch einige weitere Einstellungen anzupassen. Das folgende Beispiel ist für die 3h-Auflösung:<br />
<pre><br />
set terminal png transparent size <SIZE> crop<br />
set output '<OUT>.png'<br />
set xdata time<br />
set timefmt "%Y-%m-%d_%H:%M:%S"<br />
set xlabel " "<br />
set title 'Wettervorhersage'<br />
set ytics <br />
set y2tics <br />
set grid ytics<br />
set ylabel "Regen [mm]"<br />
set yrange [0:4]<br />
set y2label "Temperatur [°C]"<br />
set y2range [-5:35]<br />
set y3label "Wolken/Regen/Sonne [%]"<br />
set y3range [0:100]<br />
<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","TTT_",$from,$to,0,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Tx",$from,$to,18,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Tn",$from,$to,6,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","SunD3_",$from,$to,0,"day",(-3*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","RR3c_",$from,$to,0,"day",(-3*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","FX1_",$from,$to,0,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","R600_",$from,$to,0,"day",(-3*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Neff_",$from,$to,0,"day")<br />
#LogProxy ConstX:TimeNow(),0,100<br />
#LogProxy ConstY:0<br />
<br />
plot "<IN>" using 1:2 axes x1y2 title 'T' ls l0 lw 2 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y2 title 'Tmax' ls l0dot lw 2 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y2 title 'Tmin' ls l0dot lw 2 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 title 'Sonne' ls l4fill lw 1 with lines,\<br />
"<IN>" using 1:2 axes x1y1 title 'Regenmenge' ls l2fill lw 1 with steps,\<br />
"<IN>" using 1:2 axes x1y3 title 'Wind' ls l1 lw 1 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 title 'Regen' ls l5fill lw 1 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 title 'Wolken' ls l6fill lw 1 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 notitle ls l5 lw 4 with lines,\<br />
"<IN>" using 1:2 axes x1y2 notitle ls l5 lw 1 with lines<br />
</pre><br />
<br />
Verwendet man dagegen eine Auflösung von 1 Stunde, sind folgende LogProxy-Einträge erforderlich:<br />
<pre><br />
#LogProxy Func:logProxy_dwd2Plot("DWD","TTT_",$from,$to,0,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Tx",$from,$to,18,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Tn",$from,$to,6,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","SunD1_",$from,$to,0,"day",(-1*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","RR1c_",$from,$to,0,"day",(-1*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","FX1_",$from,$to,0,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","R101_",$from,$to,0,"day",(-0.5*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Neff_",$from,$to,0,"day")<br />
#LogProxy ConstX:TimeNow(),0,100<br />
#LogProxy ConstY:0<br />
</pre><br />
<br />
Für die Darstellung der nächsten 24 Stunden mit einer Auflösung von 1 Stunde nimmt man folgende GPlot-Konfiguration:<br />
<pre><br />
set terminal png transparent size <SIZE> crop<br />
set output '<OUT>.png'<br />
set xdata time<br />
set timefmt "%Y-%m-%d_%H:%M:%S"<br />
set xlabel " "<br />
set title 'Wettervorhersage'<br />
set ytics<br />
set y2tics<br />
set y3tics<br />
set grid xtics y2tics<br />
set ylabel "Regen [mm]"<br />
set y2label "Temperatur [°C]"<br />
set y3label "Wolken/Regen/Sonne [%]"<br />
set y3range [0:100]<br />
<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","TTT_",$from,$to,0,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","SunD1_",$from,$to,0,"day",(-1*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","RR1c_",$from,$to,0,"day",(-1*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","FX1_",$from,$to,0,"day")<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","R101_",$from,$to,0,"day",(-0.5*3600))<br />
#LogProxy Func:logProxy_dwd2Plot("DWD","Neff_",$from,$to,0,"day")<br />
#LogProxy ConstX:TimeNow(),0,100<br />
#LogProxy ConstY:0<br />
<br />
plot "<IN>" using 1:2 axes x1y2 title 'T' ls l0 lw 2 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 title 'Sonne' ls l4fill lw 1 with lines,\<br />
"<IN>" using 1:2 axes x1y1 title 'Regenmenge' ls l2fill lw 1 with steps,\<br />
"<IN>" using 1:2 axes x1y3 title 'Wind' ls l1 lw 1 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 title 'Regen' ls l5fill lw 1 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 title 'Wolken' ls l6fill lw 1 with quadraticSmooth,\<br />
"<IN>" using 1:2 axes x1y3 notitle ls l5 lw 4 with lines,\<br />
"<IN>" using 1:2 axes x1y2 notitle ls l2 lw 2 with lines<br />
</pre><br />
<br />
Je nachdem, welche Auflösung man verwendet, werden unterschiedliche Readings des DWD_OpenData-Devices benötigt. Diese sind in den LogProxy-Zeilen in der GPlot-Konfigurationsdatei zu finden und müssen auf jeden Fall dem Attribut ''forecastProperties'' des DWD_OpenData-Device hinzugefügt werden.<br />
<br />
Viele Detaileinstellungen des Meteogramms lassen sich individualisieren. Man kann z.B. mehr oder weniger Daten anzeigen und zumindest für ''heute'' auch aktuelle Messwerte hinzufügen.<br />
<br />
Hier ein Beispiel für ein Meteogramm über 4 Tage mit 3 Stunden Auflösung:<br />
<br />
[[File:DWDODmeteogram4d3h.png|500px]]<br />
<br />
<br />
=== Beispiel für die Einrichtung eines Weblinks ===<br />
Zur graphischen Darstellung der Vorhersage und der Wetterwarnungen mit [[FHEMWEB]] steht das Modul [https://raw.githubusercontent.com/jnsbyr/fhem/master/FHEM/99_DWD_OpenData_Weblink.pm 99_DWD_OpenData_Weblink.pm] zur Verfügung.<br />
<br />
Zunächst die Moduldatei herunterladen und in das Modulverzeichnis ''fhem/FHEM'' kopieren. Entweder die Datei direkt auf den FHEM-Server herunterladen (z.B. mit ''wget'') oder beim indirekten Herunterladen darauf achten, dass dabei das Encoding nicht verändert wird (also z.B. bei WinSCP den Binär-Modus und nicht den Text-Modus verwenden). Ansonsten werden später z.B. Sonderzeichen wie ''°C'' falsch angezeigt. <br />
<br />
Anschließend kann in die [[Konfiguration]] z.B. folgendes eingetragen werden:<br />
<br />
<pre><br />
define DWD_Weblink_Generator DWD_OpenData_Weblink<br />
attr DWD_Weblink_Generator IODev DWD<br />
attr DWD_Weblink_Generator forecastDays 4<br />
# refreshRate nur dann setzten, wenn der Browser Java-Script beherrscht:<br />
attr DWD_Weblink_Generator refreshRate 900<br />
<br />
define DWD_Weblink weblink htmlCode { DWD_OpenData_Weblink::AsHtmlH("DWD_Weblink_Generator") } <br />
</pre><br />
<br />
Damit legt man das Weblink-Generator-Device an und verknüpft es mit dem DWD_OpenData-Device. Außerdem wird der [[weblink ]] selbst angelegt, der seinerseits mit dem Weblink-Generator-Device verknüpft wird. Der Weblink benötigt für seine Funktion eine bestimmte Auswahl der Vorhersage-Merkmale. Wer das Attribut ''forecastProperties'' des DWD_OpenData-Moduls anpassen will, muss diese Merkmale auf jeden Fall mit berücksichtigen. <br />
<br />
Wenn vom Weblink nichts im Browser zu sehen ist, kann das daran liegen, dass der Browser kein aktuelles JavaScript verwendet oder JavaScript deaktiviert ist. Dann sollte das Attribut ''refreshRate'' auf 0 Sekunden eingestellt oder gelöscht werden. Mit aktiviertem Refresh werden die Daten auch ohne Seitenneuaufbau regelmäßig und bei Tab-Wechsel aktualisiert.<br />
<br />
Die Liste der erforderlichen Vorhersage-Merkmale finden sich zusammen mit allen weitere Details zur Installation und Konfiguration in der Modulhilfe von ''99_DWD_OpenData_Weblink.pm'', die man z.B. nach dem Anlegen des Weblink-Generator-Devices über die Weboberfläche abrufen kann.<br />
<br />
Hier ein Ausschnitt aus der Darstellung des Weblinks mit [[FHEMWEB]]:<br />
<br />
[[File:DWDODweblink.png|500px]]</div>JensBhttp://wiki.fhem.de/w/index.php?title=Datei:DWDODmeteogram4d3h.png&diff=29921Datei:DWDODmeteogram4d3h.png2019-03-16T18:13:03Z<p>JensB: Meteogramm für DWD_OpenData-Device über 4 Tage mit 3 Stunden Auflösung</p>
<hr />
<div>== Beschreibung ==<br />
Meteogramm für DWD_OpenData-Device über 4 Tage mit 3 Stunden Auflösung</div>JensBhttp://wiki.fhem.de/w/index.php?title=DWD_OpenData&diff=28960DWD OpenData2019-01-05T17:51:59Z<p>JensB: Link auf FHEMWEB</p>
<hr />
<div>{{SEITENTITEL:DWD_OpenData}}<br />
<br />
{{Hinweis|Versionsänderung: Die Vorhersagedaten wurden Mitte September 2018 von CSV auf KML umgestellt. Diese Umstellung ist inkompatibel: das DWD_OpenData-Modul muss aktualisiert werden, einige Reading-Namen haben sich geändert und der Weblink muss deinstalliert und neu installiert werden (siehe diesen {{Link2Forum|Topic=83097|Message=840270}} im Forum).}}<br />
<br />
{{<br />
Infobox Modul<br />
|ModPurpose=Daten vom DWD OpenData Server abrufen<br />
|ModType=d<br />
|ModCmdRef=DWD_OpenData<br />
|ModForumArea=Unterstützende Dienste/Wettermodule<br />
|ModTechName=55_DWD_OpenData.pm<br />
|ModOwner=JensB ({{Link2FU|14024|Forum}}/[[Benutzer Diskussion:JensB|Wiki]])<br />
}}<br />
<br />
Der Deutsche Wetterdienst (DWD) stellt Wetterdaten über den [https://www.dwd.de/DE/leistungen/opendata/opendata.html Open Data Server] zur Verfügung. Die Verwendung dieses Dienstes und der vom DWD zur Verf&uuml;gung gestellten Daten unterliegt den auf der OpenData Webseite beschriebenen Bedingungen. Einen Überblick über die verfügbaren Daten findet man in der Tabelle [https://www.dwd.de/DE/leistungen/opendata/help/inhalt_allgemein/opendata_content_de_en_xls.xls OpenData_weather_content.xls].<br />
<br />
<br />
== Anwendung ==<br />
Aufgrund der unterschiedlichen vom DWD bereitgestellten Datenformate benötigt das Modul zur Dekodierung je nach gewünschtem Funktionsumfang zusätzliche Perl-Module, die nicht standardmäßig vorinstalliert sind und je nach Systemkonfiguration nachinstalliert werden müssen. Außerdem unterstützt das Modul Zeitzonen, um z.B. die Wettervorhersage internationaler Stationen in Ortszeit darstellen zu können. Hierfür sind je nach Systemkonfiguration weitere Einstellungen erforderlich. Auch die Sprache der Wochentage für die Wettervorhersage ist frei wählbar. Je nach Systemkonfiguration ist aber die Standardsprache u.U. auf Englisch eingestellt, was weitere Anpassungen der Systemkonfiguration erforderlich macht.<br />
<br />
=== Vorbereitung ===<br />
Im folgenden wird z.T. von einem System mit Rasbian oder Debian mit System-V Startsystem ausgegangen. Auf anderen Betriebssystemen und auf Systemen mit System-D müssen die Installationsschritte ggf. angepasst werden.<br />
<br />
<br />
1. Für die Wettervorhersage und die Wetterwarnungen:<br />
Installation des Perl-Moduls ''XML::LibXML'' über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libxml-libxml-perl<br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
2. Falls man einen eigenen Internet-Proxy nutzt:<br />
Die Konfiguration des Proxies für FHEM erfolgt z.B. durch Eintrag von<br />
<pre><br />
attr global proxy <myProxyHost>:<myProxyPort><br />
</pre> <br />
in die [[Konfiguration]], wobei ''myProxyHost'' durch den Namen oder die IP-Adresse des Proxy-Servers ersetzt werden muss und für ''myProxyPort'' der Port des Proxy-Servers eingetragen werden muss (oft 3128).<br />
<br />
<br />
3. FHEM Uhrzeit und Zeitzone:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre><br />
in die FHEM-Kommandozeile überprüfen, ob die FHEM-Uhrzeit plausibel ist. Ist dies nicht der Fall sollten die Uhrzeit auf Systemebene überprüft werden und ggf. die Systemeinstellungen angepasst werden.<br />
Ermitteln der Bezeichnung der eigenen Zeitzone über die System-Kommandozeile mit<br />
<pre><br />
tzselect<br />
</pre><br />
und diese Bezeichnung in die Datei ''/etc/timezone'' eintragen und <br />
<pre><br />
export TZ=`cat /etc/timezone`<br />
</pre><br />
der Datei ''/etc/profile'' hinzufügen und dann das System neu starten. Nun muss die Zeitanzeige in FHEM korrekt sein.<br />
<br />
<br />
4. FHEM Sprache:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre> in die FHEM-Kommandozeile überprüfen, in welcher Sprache der Wochentag angezeigt wird. Stimmt die Sprache nicht, dann auf der System-Kommandozeile<br />
<pre><br />
dpkg-reconfigure locales<br />
</pre> eingeben und aus der Liste z.B. ''de_DE.UTF-8'' zusätzlich auswählen. Dieser Befehl gilt für Debian-basierte Betriebssysteme - für andere Betriebssysteme ist eine analoge Funktion zu verwenden. Mit Eingabe von <br />
<pre><br />
locale -a<br />
</pre> auf der System-Kommandozeile überprüfen, ob die ausgewählte Sprache nun zur Verfügung steht. Durch Hinzufügen von z.B.<br />
<pre><br />
export LANG=de_DE.UTF-8<br />
</pre> in die Datei ''/etc/init.d/fhem'' (irgendwo zwischen ''start'' und ''perl'') und anschließendem Neustart von FHEM wird die Sprache für FHEM eingestellt. Nun muss die Wochentagsanzeige in FHEM korrekt sein.<br />
<br />
<br />
5. Nur für den Weblink erforderlich:<br />
Installation des Perl-Moduls ''DateTime'' über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libdatetime-perl<br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
=== Define ===<br />
siehe [https://fhem.de/commandref.html#DWD_OpenDatadefine Commandref].<br />
<br />
=== Attributes ===<br />
siehe [https://fhem.de/commandref.html#DWD_OpenDataattr Commandref].<br />
<br />
== Anwendungsbeispiele ==<br />
=== Beispiel zur Modul-Einrichtung ===<br />
<br />
* Wettervorhersage<br />
Für die Wettervorhersage muss der Stationscode ermittelt werden. Dazu den [https://www.dwd.de/DE/leistungen/met_verfahren_mosmix/mosmix_stationskatalog.pdf MOSMIX Stationskatalog] herunterladen, öffnen und die gewünschte Station heraussuchen. Einen Teil der deutschen Stationen kann man auch der [https://www.dwd.de/DE/derdwd/messnetz/bodenbeobachtung/messnetzkarte_boden.pdf Bodenmessnetzkarte] entnehmen. Den ermittelten Stationscode kann man dann entweder für eine Einzelabfrage als Parameter für das Kommando ''get forecast'' verwenden oder für die automatische Aktualisierung als Attribut ''forecastStation'' hinterlegen. Insgesamt werden vom DWD mehr als 70 Merkmale zur Verfügung gestellt. Eine Auflistung findet sich im Dokument [https://opendata.dwd.de/weather/lib/MetElementDefinition.xml MetElementDefinition]. Nur ein kleiner Teil der Merkmale wird in der Standardeinstellung des Moduls als Reading zur Verfügung gestellt. Wer andere Merkmale benötigt muss sie mit Komma getrennt dem Attribut ''forecastProperties'' zuweisen. Es empfiehlt sich zur Performance-Optimierung sowohl das Attribut ''forecastDays'' als auch das Attribut ''forecastProperties'' auf den tatsächlichen Bedarf einzustellen.<br />
<br />
* Wetterwarnungen<br />
Für die Wetterwarnungen muss die Warnzelle ermittelt werden. Dazu [https://www.dwd.de/DE/leistungen/opendata/help/warnungen/cap_warncellids_csv.csv Warnzellen-ID Katalog] herunterladen, öffnen und die gewünschte Warnzelle heraussuchen. Unterstützt werden Gemeinden (beginnen mit 8), Landkreise (beginnen mit 1 oder 9) oder Küste (beginnen mit 5). Die Warnzellen-ID kann man dann entweder für eine Einzelabfrage als Parameter für das Kommando ''get alerts'' verwenden oder für die automatische Aktualisierung als Attribut ''alertArea'' hinterlegen. Die Warnzellen-ID ist ab der 2. Stelle identisch mit den ersten Ziffern des amtlichen Gemeindeschlüssels. Man kann z.B. den Namen von Gemeinde oder Landkreis bei den [https://www.statistik-bw.de/Statistik-Portal/gemeindeverz.asp Statistischen Ämtern des Bundes und der Länder] eingeben, den amtlichen Gemeindeschlüssels ermitteln und dann mit vorangestellter 1, 8 oder 9 im Warnzellen-ID Katalog des DWD nach einem Eintrag mit exakter oder weitgehender Übereinstimmung suchen. Wem das zu kompliziert vorkommt, kann bei mehrdeutigen Gemeinde- bzw. Landkreisbezeichnungen auch versuchen auszuprobieren, welche die richtige Wanrzellen-ID ist.<br />
<br />
Um das Modul mit automatisch Aktualisierung von Vorhersage und Wetterwarnungen zu nutzen, kann z.B. folgendes in die [[Konfiguration]] eingetragen werden:<br />
<br />
<pre><br />
define DWD DWD_OpenData<br />
attr DWD alertArea 111000000<br />
attr DWD forecastStation 99810<br />
attr DWD forecastDays 3<br />
attr DWD forecastWW2Text 1<br />
</pre><br />
<br />
* Performance<br />
Das DWD_OpenData-Modul ist ein Datenmodul mit relativ vielen Readings. In der Standardkonfiguration wird, wie bei jedem anderen FHEM Modul, bei jeder Änderung jedes Readings ein FHEM internes Ereignis erzeugt, damit andere FHEM Devices auf diese Änderungen reagieren können. Diese Ereignisse sorgen auch dafür, dass man Änderungen in der Weboberfläche sofort angezeigt bekommt, ohne die Webseite neu aufzurufen. Interessiert sich aber kein FHEM Device für die Änderungsbenachrichtung bestimmter Readings, entsteht unnötiger Verarbeitsoverhead, der je nach FHEM Konfiguration und verfügbarer CPU-Leistung auch mehrere Sekunden benötigen kann und in dieser Zeit andere Abläufe blockiert. Um die Performance zu optimieren, empfiehlt es sich, mit [[event-on-update-reading]] für eine angepasste und dadurch effizientere Verarbeitung sorgen, indem man nur für die Readings Ereignisse zulässt, die man für die Weiterverarbeitung braucht. Der DWD_OpenData_Weblink braucht z.B. gar keine Ereignisse, um zu funktionieren. Hier eine minimalistische Beispielkonfiguration:<br />
<br />
<pre><br />
attr DWD event-on-update-reading state,fc_state,a_state<br />
</pre><br />
<br />
Weitere Details zur Installation und Konfiguration des Moduls finden sich in der [https://fhem.de/commandref.html#DWD_OpenData Commandref].<br />
<br />
=== Beispiel für die Einrichtung eines Weblinks ===<br />
Zur graphischen Darstellung der Vorhersage und der Wetterwarnungen mit [[FHEMWEB]] steht das Modul [https://raw.githubusercontent.com/jnsbyr/fhem/master/FHEM/99_DWD_OpenData_Weblink.pm 99_DWD_OpenData_Weblink.pm] zur Verfügung.<br />
<br />
Zunächst die Moduldatei herunterladen und in das Modulverzeichnis ''fhem/FHEM'' kopieren. Entweder die Datei direkt auf den FHEM-Server herunterladen (z.B. mit ''wget'') oder beim indirekten Herunterladen darauf achten, dass dabei das Encoding nicht verändert wird (also z.B. bei WinSCP den Binär-Modus und nicht den Text-Modus verwenden). Ansonsten werden später z.B. Sonderzeichen wie ''°C'' falsch angezeigt. <br />
<br />
Anschließend kann in die [[Konfiguration]] z.B. folgendes eingetragen werden:<br />
<br />
<pre><br />
define DWD_Weblink_Generator DWD_OpenData_Weblink<br />
attr DWD_Weblink_Generator IODev DWD<br />
attr DWD_Weblink_Generator forecastDays 4<br />
# refreshRate nur dann setzten, wenn der Browser Java-Script beherrscht:<br />
attr DWD_Weblink_Generator refreshRate 900<br />
<br />
define DWD_Weblink weblink htmlCode { DWD_OpenData_Weblink::AsHtmlH("DWD_Weblink_Generator") } <br />
</pre><br />
<br />
Damit legt man das Weblink-Generator-Device an und verknüpft es mit dem DWD_OpenData-Device. Außerdem wird der [[weblink ]] selbst angelegt, der seinerseits mit dem Weblink-Generator-Device verknüpft wird. Der Weblink benötigt für seine Funktion eine bestimmte Auswahl der Vorhersage-Merkmale. Wer das Attribut ''forecastProperties'' des DWD_OpenData-Moduls anpassen will, muss diese Merkmale auf jeden Fall mit berücksichtigen. <br />
<br />
Wenn vom Weblink nichts im Browser zu sehen ist, kann das daran liegen, dass der Browser kein aktuelles JavaScript verwendet oder JavaScript deaktiviert ist. Dann sollte das Attribut ''refreshRate'' auf 0 Sekunden eingestellt oder gelöscht werden. Mit aktiviertem Refresh werden die Daten auch ohne Seitenneuaufbau regelmäßig und bei Tab-Wechsel aktualisiert.<br />
<br />
Die Liste der erforderlichen Vorhersage-Merkmale finden sich zusammen mit allen weitere Details zur Installation und Konfiguration in der Modulhilfe von ''99_DWD_OpenData_Weblink.pm'', die man z.B. nach dem Anlegen des Weblink-Generator-Devices über die Weboberfläche abrufen kann.<br />
<br />
Hier ein Ausschnitt aus der Darstellung des Weblinks mit [[FHEMWEB]]:<br />
<br />
[[File:DWDODweblink.png|500px]]</div>JensBhttp://wiki.fhem.de/w/index.php?title=DWD_OpenData&diff=28959DWD OpenData2019-01-05T17:47:00Z<p>JensB: falschen Link korrigiert</p>
<hr />
<div>{{SEITENTITEL:DWD_OpenData}}<br />
<br />
{{Hinweis|Versionsänderung: Die Vorhersagedaten wurden Mitte September 2018 von CSV auf KML umgestellt. Diese Umstellung ist inkompatibel: das DWD_OpenData-Modul muss aktualisiert werden, einige Reading-Namen haben sich geändert und der Weblink muss deinstalliert und neu installiert werden (siehe diesen {{Link2Forum|Topic=83097|Message=840270}} im Forum).}}<br />
<br />
{{<br />
Infobox Modul<br />
|ModPurpose=Daten vom DWD OpenData Server abrufen<br />
|ModType=d<br />
|ModCmdRef=DWD_OpenData<br />
|ModForumArea=Unterstützende Dienste/Wettermodule<br />
|ModTechName=55_DWD_OpenData.pm<br />
|ModOwner=JensB ({{Link2FU|14024|Forum}}/[[Benutzer Diskussion:JensB|Wiki]])<br />
}}<br />
<br />
Der Deutsche Wetterdienst (DWD) stellt Wetterdaten über den [https://www.dwd.de/DE/leistungen/opendata/opendata.html Open Data Server] zur Verfügung. Die Verwendung dieses Dienstes und der vom DWD zur Verf&uuml;gung gestellten Daten unterliegt den auf der OpenData Webseite beschriebenen Bedingungen. Einen Überblick über die verfügbaren Daten findet man in der Tabelle [https://www.dwd.de/DE/leistungen/opendata/help/inhalt_allgemein/opendata_content_de_en_xls.xls OpenData_weather_content.xls].<br />
<br />
<br />
== Anwendung ==<br />
Aufgrund der unterschiedlichen vom DWD bereitgestellten Datenformate benötigt das Modul zur Dekodierung je nach gewünschtem Funktionsumfang zusätzliche Perl-Module, die nicht standardmäßig vorinstalliert sind und je nach Systemkonfiguration nachinstalliert werden müssen. Außerdem unterstützt das Modul Zeitzonen, um z.B. die Wettervorhersage internationaler Stationen in Ortszeit darstellen zu können. Hierfür sind je nach Systemkonfiguration weitere Einstellungen erforderlich. Auch die Sprache der Wochentage für die Wettervorhersage ist frei wählbar. Je nach Systemkonfiguration ist aber die Standardsprache u.U. auf Englisch eingestellt, was weitere Anpassungen der Systemkonfiguration erforderlich macht.<br />
<br />
=== Vorbereitung ===<br />
Im folgenden wird z.T. von einem System mit Rasbian oder Debian mit System-V Startsystem ausgegangen. Auf anderen Betriebssystemen und auf Systemen mit System-D müssen die Installationsschritte ggf. angepasst werden.<br />
<br />
<br />
1. Für die Wettervorhersage und die Wetterwarnungen:<br />
Installation des Perl-Moduls ''XML::LibXML'' über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libxml-libxml-perl<br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
2. Falls man einen eigenen Internet-Proxy nutzt:<br />
Die Konfiguration des Proxies für FHEM erfolgt z.B. durch Eintrag von<br />
<pre><br />
attr global proxy <myProxyHost>:<myProxyPort><br />
</pre> <br />
in die [[Konfiguration]], wobei ''myProxyHost'' durch den Namen oder die IP-Adresse des Proxy-Servers ersetzt werden muss und für ''myProxyPort'' der Port des Proxy-Servers eingetragen werden muss (oft 3128).<br />
<br />
<br />
3. FHEM Uhrzeit und Zeitzone:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre><br />
in die FHEM-Kommandozeile überprüfen, ob die FHEM-Uhrzeit plausibel ist. Ist dies nicht der Fall sollten die Uhrzeit auf Systemebene überprüft werden und ggf. die Systemeinstellungen angepasst werden.<br />
Ermitteln der Bezeichnung der eigenen Zeitzone über die System-Kommandozeile mit<br />
<pre><br />
tzselect<br />
</pre><br />
und diese Bezeichnung in die Datei ''/etc/timezone'' eintragen und <br />
<pre><br />
export TZ=`cat /etc/timezone`<br />
</pre><br />
der Datei ''/etc/profile'' hinzufügen und dann das System neu starten. Nun muss die Zeitanzeige in FHEM korrekt sein.<br />
<br />
<br />
4. FHEM Sprache:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre> in die FHEM-Kommandozeile überprüfen, in welcher Sprache der Wochentag angezeigt wird. Stimmt die Sprache nicht, dann auf der System-Kommandozeile<br />
<pre><br />
dpkg-reconfigure locales<br />
</pre> eingeben und aus der Liste z.B. ''de_DE.UTF-8'' zusätzlich auswählen. Dieser Befehl gilt für Debian-basierte Betriebssysteme - für andere Betriebssysteme ist eine analoge Funktion zu verwenden. Mit Eingabe von <br />
<pre><br />
locale -a<br />
</pre> auf der System-Kommandozeile überprüfen, ob die ausgewählte Sprache nun zur Verfügung steht. Durch Hinzufügen von z.B.<br />
<pre><br />
export LANG=de_DE.UTF-8<br />
</pre> in die Datei ''/etc/init.d/fhem'' (irgendwo zwischen ''start'' und ''perl'') und anschließendem Neustart von FHEM wird die Sprache für FHEM eingestellt. Nun muss die Wochentagsanzeige in FHEM korrekt sein.<br />
<br />
<br />
5. Nur für den Weblink erforderlich:<br />
Installation des Perl-Moduls ''DateTime'' über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libdatetime-perl<br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
=== Define ===<br />
siehe [https://fhem.de/commandref.html#DWD_OpenDatadefine Commandref].<br />
<br />
=== Attributes ===<br />
siehe [https://fhem.de/commandref.html#DWD_OpenDataattr Commandref].<br />
<br />
== Anwendungsbeispiele ==<br />
=== Beispiel zur Modul-Einrichtung ===<br />
<br />
* Wettervorhersage<br />
Für die Wettervorhersage muss der Stationscode ermittelt werden. Dazu den [https://www.dwd.de/DE/leistungen/met_verfahren_mosmix/mosmix_stationskatalog.pdf MOSMIX Stationskatalog] herunterladen, öffnen und die gewünschte Station heraussuchen. Einen Teil der deutschen Stationen kann man auch der [https://www.dwd.de/DE/derdwd/messnetz/bodenbeobachtung/messnetzkarte_boden.pdf Bodenmessnetzkarte] entnehmen. Den ermittelten Stationscode kann man dann entweder für eine Einzelabfrage als Parameter für das Kommando ''get forecast'' verwenden oder für die automatische Aktualisierung als Attribut ''forecastStation'' hinterlegen. Insgesamt werden vom DWD mehr als 70 Merkmale zur Verfügung gestellt. Eine Auflistung findet sich im Dokument [https://opendata.dwd.de/weather/lib/MetElementDefinition.xml MetElementDefinition]. Nur ein kleiner Teil der Merkmale wird in der Standardeinstellung des Moduls als Reading zur Verfügung gestellt. Wer andere Merkmale benötigt muss sie mit Komma getrennt dem Attribut ''forecastProperties'' zuweisen. Es empfiehlt sich zur Performance-Optimierung sowohl das Attribut ''forecastDays'' als auch das Attribut ''forecastProperties'' auf den tatsächlichen Bedarf einzustellen.<br />
<br />
* Wetterwarnungen<br />
Für die Wetterwarnungen muss die Warnzelle ermittelt werden. Dazu [https://www.dwd.de/DE/leistungen/opendata/help/warnungen/cap_warncellids_csv.csv Warnzellen-ID Katalog] herunterladen, öffnen und die gewünschte Warnzelle heraussuchen. Unterstützt werden Gemeinden (beginnen mit 8), Landkreise (beginnen mit 1 oder 9) oder Küste (beginnen mit 5). Die Warnzellen-ID kann man dann entweder für eine Einzelabfrage als Parameter für das Kommando ''get alerts'' verwenden oder für die automatische Aktualisierung als Attribut ''alertArea'' hinterlegen. Die Warnzellen-ID ist ab der 2. Stelle identisch mit den ersten Ziffern des amtlichen Gemeindeschlüssels. Man kann z.B. den Namen von Gemeinde oder Landkreis bei den [https://www.statistik-bw.de/Statistik-Portal/gemeindeverz.asp Statistischen Ämtern des Bundes und der Länder] eingeben, den amtlichen Gemeindeschlüssels ermitteln und dann mit vorangestellter 1, 8 oder 9 im Warnzellen-ID Katalog des DWD nach einem Eintrag mit exakter oder weitgehender Übereinstimmung suchen. Wem das zu kompliziert vorkommt, kann bei mehrdeutigen Gemeinde- bzw. Landkreisbezeichnungen auch versuchen auszuprobieren, welche die richtige Wanrzellen-ID ist.<br />
<br />
Um das Modul mit automatisch Aktualisierung von Vorhersage und Wetterwarnungen zu nutzen, kann z.B. folgendes in die [[Konfiguration]] eingetragen werden:<br />
<br />
<pre><br />
define DWD DWD_OpenData<br />
attr DWD alertArea 111000000<br />
attr DWD forecastStation 99810<br />
attr DWD forecastDays 3<br />
attr DWD forecastWW2Text 1<br />
</pre><br />
<br />
* Performance<br />
Das DWD_OpenData-Modul ist ein Datenmodul mit relativ vielen Readings. In der Standardkonfiguration wird, wie bei jedem anderen FHEM Modul, bei jeder Änderung jedes Readings ein FHEM internes Ereignis erzeugt, damit andere FHEM Devices auf diese Änderungen reagieren können. Diese Ereignisse sorgen auch dafür, dass man Änderungen in der Weboberfläche sofort angezeigt bekommt, ohne die Webseite neu aufzurufen. Interessiert sich aber kein FHEM Device für die Änderungsbenachrichtung bestimmter Readings, entsteht unnötiger Verarbeitsoverhead, der je nach FHEM Konfiguration und verfügbarer CPU-Leistung auch mehrere Sekunden benötigen kann und in dieser Zeit andere Abläufe blockiert. Um die Performance zu optimieren, empfiehlt es sich, mit [[event-on-update-reading]] für eine angepasste und dadurch effizientere Verarbeitung sorgen, indem man nur für die Readings Ereignisse zulässt, die man für die Weiterverarbeitung braucht. Der DWD_OpenData_Weblink braucht z.B. gar keine Ereignisse, um zu funktionieren. Hier eine minimalistische Beispielkonfiguration:<br />
<br />
<pre><br />
attr DWD event-on-update-reading state,fc_state,a_state<br />
</pre><br />
<br />
Weitere Details zur Installation und Konfiguration des Moduls finden sich in der [https://fhem.de/commandref.html#DWD_OpenData Commandref].<br />
<br />
=== Beispiel für die Einrichtung eines Weblinks ===<br />
Zur graphischen Darstellung der Vorhersage und der Wetterwarnungen steht das Modul [https://raw.githubusercontent.com/jnsbyr/fhem/master/FHEM/99_DWD_OpenData_Weblink.pm 99_DWD_OpenData_Weblink.pm] zur Verfügung.<br />
<br />
Zunächst die Moduldatei herunterladen und in das Modulverzeichnis ''fhem/FHEM'' kopieren. Entweder die Datei direkt auf den FHEM-Server herunterladen (z.B. mit ''wget'') oder beim indirekten Herunterladen darauf achten, dass dabei das Encoding nicht verändert wird (also z.B. bei WinSCP den Binär-Modus und nicht den Text-Modus verwenden). Ansonsten werden später z.B. Sonderzeichen wie ''°C'' falsch angezeigt. <br />
<br />
Anschließend kann in die [[Konfiguration]] z.B. folgendes eingetragen werden:<br />
<br />
<pre><br />
define DWD_Weblink_Generator DWD_OpenData_Weblink<br />
attr DWD_Weblink_Generator IODev DWD<br />
attr DWD_Weblink_Generator forecastDays 4<br />
# refreshRate nur dann setzten, wenn der Browser Java-Script beherrscht:<br />
attr DWD_Weblink_Generator refreshRate 900<br />
<br />
define DWD_Weblink weblink htmlCode { DWD_OpenData_Weblink::AsHtmlH("DWD_Weblink_Generator") } <br />
</pre><br />
<br />
Damit legt man das Weblink-Generator-Device an und verknüpft es mit dem DWD_OpenData-Device. Außerdem wird der [[weblink ]] selbst angelegt, der seinerseits mit dem Weblink-Generator-Device verknüpft wird. Der Weblink benötigt für seine Funktion eine bestimmte Auswahl der Vorhersage-Merkmale. Wer das Attribut ''forecastProperties'' des DWD_OpenData-Moduls anpassen will, muss diese Merkmale auf jeden Fall mit berücksichtigen. <br />
<br />
Wenn vom Weblink nichts im Browser zu sehen ist, kann das daran liegen, dass der Browser kein aktuelles JavaScript verwendet oder JavaScript deaktiviert ist. Dann sollte das Attribut ''refreshRate'' auf 0 Sekunden eingestellt oder gelöscht werden. Mit aktiviertem Refresh werden die Daten auch ohne Seitenneuaufbau regelmäßig und bei Tab-Wechsel aktualisiert.<br />
<br />
Die Liste der erforderlichen Vorhersage-Merkmale finden sich zusammen mit allen weitere Details zur Installation und Konfiguration in der Modulhilfe von ''99_DWD_OpenData_Weblink.pm'', die man z.B. nach dem Anlegen des Weblink-Generator-Devices über die Weboberfläche abrufen kann.<br />
<br />
Hier ein Ausschnitt aus der Darstellung des Weblinks mit [[FHEMWEB]]:<br />
<br />
[[File:DWDODweblink.png|500px]]</div>JensBhttp://wiki.fhem.de/w/index.php?title=DWD_OpenData&diff=28695DWD OpenData2018-12-16T20:18:10Z<p>JensB: Hinweis zur Performance-Optimierung</p>
<hr />
<div>{{SEITENTITEL:DWD_OpenData}}<br />
<br />
{{Hinweis|Versionänderung: Die Vorhersagedaten wurden Mitte September 2018 von CSV auf KML umgestellt. Diese Umstellung ist inkompatibel: das DWD_OpenData-Modul muss aktualisiert werden, einige Reading-Namen haben sich geändert und der Weblink muss deinstalliert und neu installiert werden (siehe {{Link2Forum|Topic=83097|Message=840270}}).}}<br />
<br />
{{<br />
Infobox Modul<br />
|ModPurpose=Daten vom DWD OpenData Server abrufen<br />
|ModType=d<br />
<!-- |ModCategory= (noch?) nicht verwendet --><br />
|ModCmdRef=DWD_OpenData<br />
|ModForumArea=Unterstützende Dienste/Wettermodule<br />
|ModTechName=55_DWD_OpenData.pm<br />
|ModOwner=JensB<br />
}}<br />
<br />
Der Deutsche Wetterdienst (DWD) stellt Wetterdaten über den [https://www.dwd.de/DE/leistungen/opendata/opendata.html Open Data Server] zur Verfügung. Die Verwendung dieses Dienstes und der vom DWD zur Verf&uuml;gung gestellten Daten unterliegt den auf der OpenData Webseite beschriebenen Bedingungen. Einen Überblick über die verfügbaren Daten findet man in der Tabelle [https://www.dwd.de/DE/leistungen/opendata/help/inhalt_allgemein/opendata_content_de_en_xls.xls OpenData_weather_content.xls].<br />
<br />
<br />
== Anwendung ==<br />
Aufgrund der unterschiedlichen vom DWD bereitgestellten Datenformate benötigt das Modul zur Dekodierung je nach gewünschtem Funktionsumfang zusätzliche Perl-Module, die nicht standardmäßig vorinstalliert sind und je nach Systemkonfiguration nachinstalliert werden müssen. Außerdem unterstützt das Modul Zeitzonen, um z.B. die Wettervorhersage internationaler Stationen in Ortszeit darstellen zu können. Hierfür sind je nach Systemkonfiguration weitere Einstellungen erforderlich. Auch die Sprache der Wochentage für die Wettervorhersage ist frei wählbar. Je nach Systemkonfiguration ist aber die Standardsprache u.U. auf Englisch eingestellt, was weitere Anpassungen der Systemkonfiguration erforderlich macht.<br />
<br />
=== Vorbereitung ===<br />
Im folgenden wird z.T. von einem System mit Rasbian oder Debian mit System-V Startsystem ausgegangen. Auf anderen Betriebssystemen und auf Systemen mit System-D müssen die Installationsschritte ggf. angepasst werden.<br />
<br />
<br />
1. Für die Wettervorhersage und die Wetterwarnungen:<br />
Installation des Perl-Moduls ''XML::LibXML'' über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libxml-libxml-perl<br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
2. Falls man einen eigenen Internet-Proxy nutzt:<br />
Die Konfiguration des Proxies für FHEM erfolgt z.B. durch Eintrag von<br />
<pre><br />
attr global proxy <myProxyHost>:<myProxyPort><br />
</pre> <br />
in die [[Konfiguration]], wobei ''myProxyHost'' durch den Namen oder die IP-Adresse des Proxy-Servers ersetzt werden muss und für ''myProxyPort'' der Port des Proxy-Servers eingetragen werden muss (oft 3128).<br />
<br />
<br />
3. FHEM Uhrzeit und Zeitzone:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre><br />
in die FHEM-Kommandozeile überprüfen, ob die FHEM-Uhrzeit plausibel ist. Ist dies nicht der Fall sollten die Uhrzeit auf Systemebene überprüft werden und ggf. die Systemeinstellungen angepasst werden.<br />
Ermitteln der Bezeichnung der eigenen Zeitzone über die System-Kommandozeile mit<br />
<pre><br />
tzselect<br />
</pre><br />
und diese Bezeichnung in die Datei ''/etc/timezone'' eintragen und <br />
<pre><br />
export TZ=`cat /etc/timezone`<br />
</pre><br />
der Datei ''/etc/profile'' hinzufügen und dann das System neu starten. Nun muss die Zeitanzeige in FHEM korrekt sein.<br />
<br />
<br />
4. FHEM Sprache:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre> in die FHEM-Kommandozeile überprüfen, in welcher Sprache der Wochentag angezeigt wird. Stimmt die Sprache nicht, dann auf der System-Kommandozeile<br />
<pre><br />
dpkg-reconfigure locales<br />
</pre> eingeben und aus der Liste z.B. ''de_DE.UTF-8'' zusätzlich auswählen. Dieser Befehl gilt für Debian-basierte Betriebssysteme - für andere Betriebssysteme ist eine analoge Funktion zu verwenden. Mit Eingabe von <br />
<pre><br />
locale -a<br />
</pre> auf der System-Kommandozeile überprüfen, ob die ausgewählte Sprache nun zur Verfügung steht. Durch Hinzufügen von z.B.<br />
<pre><br />
export LANG=de_DE.UTF-8<br />
</pre> in die Datei ''/etc/init.d/fhem'' (irgendwo zwischen ''start'' und ''perl'') und anschließendem Neustart von FHEM wird die Sprache für FHEM eingestellt. Nun muss die Wochentagsanzeige in FHEM korrekt sein.<br />
<br />
<br />
5. Nur für den Weblink erforderlich:<br />
Installation des Perl-Moduls ''DateTime'' über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libdatetime-perl<br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
=== Define ===<br />
siehe [https://fhem.de/commandref.html#DWD_OpenDatadefine Commandref].<br />
<br />
=== Attributes ===<br />
siehe [https://fhem.de/commandref.html#DWD_OpenDataattr Commandref].<br />
<br />
== Anwendungsbeispiele ==<br />
=== Beispiel zur Modul-Einrichtung ===<br />
<br />
* Wettervorhersage<br />
Für die Wettervorhersage muss der Stationscode ermittelt werden. Dazu den [https://www.dwd.de/DE/leistungen/met_verfahren_mosmix/mosmix_stationskatalog.pdf MOSMIX Stationskatalog] herunterladen, öffnen und die gewünschte Station heraussuchen. Einen Teil der deutschen Stationen kann man auch der [https://www.dwd.de/DE/derdwd/messnetz/bodenbeobachtung/messnetzkarte_boden.pdf Bodenmessnetzkarte] entnehmen. Den ermittelten Stationscode kann man dann entweder für eine Einzelabfrage als Parameter für das Kommando ''get forecast'' verwenden oder für die automatische Aktualisierung als Attribut ''forecastStation'' hinterlegen. Insgesamt werden vom DWD mehr als 70 Merkmale zur Verfügung gestellt. Eine Auflistung findet sich im Dokument [https://opendata.dwd.de/weather/lib/MetElementDefinition.xml MetElementDefinition]. Nur ein kleiner Teil der Merkmale wird in der Standardeinstellung des Moduls als Reading zur Verfügung gestellt. Wer andere Merkmale benötigt muss sie mit Komma getrennt dem Attribut ''forecastProperties'' zuweisen. Es empfiehlt sich zur Performance-Optimierung sowohl das Attribut ''forecastDays'' als auch das Attribut ''forecastProperties'' auf den tatsächlichen Bedarf einzustellen.<br />
<br />
* Wetterwarnungen<br />
Für die Wetterwarnungen muss die Warnzelle ermittelt werden. Dazu [https://www.dwd.de/DE/leistungen/opendata/help/warnungen/cap_warncellids_csv.csv Warnzellen-ID Katalog] herunterladen, öffnen und die gewünschte Warnzelle heraussuchen. Unterstützt werden Gemeinden (beginnen mit 8), Landkreise (beginnen mit 1 oder 9) oder Küste (beginnen mit 5). Die Warnzellen-ID kann man dann entweder für eine Einzelabfrage als Parameter für das Kommando ''get alerts'' verwenden oder für die automatische Aktualisierung als Attribut ''alertArea'' hinterlegen. Die Warnzellen-ID ist ab der 2. Stelle identisch mit den ersten Ziffern des amtlichen Gemeindeschlüssels. Man kann z.B. den Namen von Gemeinde oder Landkreis bei den [https://www.statistik-bw.de/Statistik-Portal/gemeindeverz.asp Statistischen Ämtern des Bundes und der Länder] eingeben, den amtlichen Gemeindeschlüssels ermitteln und dann mit vorangestellter 1, 8 oder 9 im Warnzellen-ID Katalog des DWD nach einem Eintrag mit exakter oder weitgehender Übereinstimmung suchen. Wem das zu kompliziert vorkommt, kann bei mehrdeutigen Gemeinde- bzw. Landkreisbezeichnungen auch versuchen auszuprobieren, welche die richtige Wanrzellen-ID ist.<br />
<br />
Um das Modul mit automatisch Aktualisierung von Vorhersage und Wetterwarnungen zu nutzen, kann z.B. folgendes in die [[Konfiguration]] eingetragen werden:<br />
<br />
<pre><br />
define DWD DWD_OpenData<br />
attr DWD alertArea 111000000<br />
attr DWD forecastStation 99810<br />
attr DWD forecastDays 3<br />
attr DWD forecastWW2Text 1<br />
</pre><br />
<br />
* Performance<br />
Das DWD_OpenData-Modul ist ein Datenmodul mit relativ vielen Readings. In der Standardkonfiguration wird, wie bei jedem anderen FHEM Modul, bei jeder Änderung jedes Readings ein FHEM internes Ereignis erzeugt, damit andere FHEM Devices auf diese Änderungen reagieren können. Diese Ereignisse sorgen auch dafür, dass man Änderungen in der Weboberfläche sofort angezeigt bekommt, ohne die Webseite neu aufzurufen. Interessiert sich aber kein FHEM Device für die Änderungsbenachrichtung bestimmter Readings, entsteht unnötiger Verarbeitsoverhead, der je nach FHEM Konfiguration und verfügbarer CPU-Leistung auch mehrere Sekunden benötigen kann und in dieser Zeit andere Abläufe blockiert. Um die Performance zu optimieren, empfiehlt es sich, mit [[event-on-update-reading]] für eine angepasste und dadurch effizientere Verarbeitung sorgen, indem man nur für die Readings Ereignisse zulässt, die man für die Weiterverarbeitung braucht. Der DWD_OpenData_Weblink braucht z.B. gar keine Ereignisse, um zu funktionieren. Hier eine minimalistische Beispielkonfiguration:<br />
<br />
<pre><br />
attr DWD event-on-update-reading state,fc_state,a_state<br />
</pre><br />
<br />
Weitere Details zur Installation und Konfiguration des Moduls finden sich in der [https://fhem.de/commandref.html#DWD_OpenData Commandref].<br />
<br />
=== Beispiel für die Einrichtung eines Weblinks ===<br />
Zur graphischen Darstellung der Vorhersage und der Wetterwarnungen steht das Modul [https://raw.githubusercontent.com/jnsbyr/fhem/master/FHEM/55_DWD_OpenData.pm 99_DWD_OpenData_Weblink.pm] zur Verfügung.<br />
<br />
Zunächst die Moduldatei herunterladen und in das Modulverzeichnis ''fhem/FHEM'' kopieren. Entweder die Datei direkt auf den FHEM-Server herunterladen (z.B. mit ''wget'') oder beim indirekten Herunterladen darauf achten, dass dabei das Encoding nicht verändert wird (also z.B. bei WinSCP den Binär-Modus und nicht den Text-Modus verwenden). Ansonsten werden später z.B. Sonderzeichen wie ''°C'' falsch angezeigt. <br />
<br />
Anschließend kann in die [[Konfiguration]] z.B. folgendes eingetragen werden:<br />
<br />
<pre><br />
define DWD_Weblink_Generator DWD_OpenData_Weblink<br />
attr DWD_Weblink_Generator IODev DWD<br />
attr DWD_Weblink_Generator forecastDays 4<br />
# refreshRate nur dann setzten, wenn der Browser Java-Script beherrscht:<br />
attr DWD_Weblink_Generator refreshRate 900<br />
<br />
define DWD_Weblink weblink htmlCode { DWD_OpenData_Weblink::AsHtmlH("DWD_Weblink_Generator") } <br />
</pre><br />
<br />
Damit legt man das Weblink-Generator-Device an und verknüpft es mit dem DWD_OpenData-Device. Außerdem wird der [[weblink ]] selbst angelegt, der seinerseits mit dem Weblink-Generator-Device verknüpft wird. Der Weblink benötigt für seine Funktion eine bestimmte Auswahl der Vorhersage-Merkmale. Wer das Attribut ''forecastProperties'' des DWD_OpenData-Moduls anpassen will, muss diese Merkmale auf jeden Fall mit berücksichtigen. <br />
<br />
Wenn vom Weblink nichts im Browser zu sehen ist, kann das daran liegen, dass der Browser kein aktuelles JavaScript verwendet oder JavaScript deaktiviert ist. Dann sollte das Attribut ''refreshRate'' auf 0 Sekunden eingestellt oder gelöscht werden. Mit aktiviertem Refresh werden die Daten auch ohne Seitenneuaufbau regelmäßig und bei Tab-Wechsel aktualisiert.<br />
<br />
Die Liste der erforderlichen Vorhersage-Merkmale finden sich zusammen mit allen weitere Details zur Installation und Konfiguration in der Modulhilfe von ''99_DWD_OpenData_Weblink.pm'', die man z.B. nach dem Anlegen des Weblink-Generator-Devices über die Weboberfläche abrufen kann.<br />
<br />
Hier ein Ausschnitt aus der Darstellung des Weblinks mit [[FHEMWEB]]:<br />
<br />
[[File:DWDODweblink.png|500px]]</div>JensBhttp://wiki.fhem.de/w/index.php?title=DWD_OpenData&diff=27958DWD OpenData2018-10-03T15:26:09Z<p>JensB: Installationshinweise ergänzt</p>
<hr />
<div>{{SEITENTITEL:DWD_OpenData}}<br />
<br />
{{Hinweis|Versionänderung: Die Vorhersagedaten wurden Mitte September 2018 von CSV auf KML umgestellt. Diese Umstellung ist inkompatibel: das DWD_OpenData-Modul muss aktualisiert werden, einige Reading-Namen haben sich geändert und der Weblink muss deinstalliert und neu installiert werden (siehe {{Link2Forum|Topic=83097|Message=840270}}).}}<br />
<br />
{{<br />
Infobox Modul<br />
|ModPurpose=Daten vom DWD OpenData Server abrufen<br />
|ModType=d<br />
<!-- |ModCategory= (noch?) nicht verwendet --><br />
|ModCmdRef=DWD_OpenData<br />
|ModForumArea=Unterstützende Dienste/Wettermodule<br />
|ModTechName=55_DWD_OpenData.pm<br />
|ModOwner=JensB<br />
}}<br />
<br />
Der Deutsche Wetterdienst (DWD) stellt Wetterdaten über den [https://www.dwd.de/DE/leistungen/opendata/opendata.html Open Data Server] zur Verfügung. Die Verwendung dieses Dienstes und der vom DWD zur Verf&uuml;gung gestellten Daten unterliegt den auf der OpenData Webseite beschriebenen Bedingungen. Einen Überblick über die verfügbaren Daten findet man in der Tabelle [https://www.dwd.de/DE/leistungen/opendata/help/inhalt_allgemein/opendata_content_de_en_xls.xls OpenData_weather_content.xls].<br />
<br />
<br />
== Anwendung ==<br />
Aufgrund der unterschiedlichen vom DWD bereitgestellten Datenformate benötigt das Modul zur Dekodierung je nach gewünschtem Funktionsumfang zusätzliche Perl-Module, die nicht standardmäßig vorinstalliert sind und je nach Systemkonfiguration nachinstalliert werden müssen. Außerdem unterstützt das Modul Zeitzonen, um z.B. die Wettervorhersage internationaler Stationen in Ortszeit darstellen zu können. Hierfür sind je nach Systemkonfiguration weitere Einstellungen erforderlich. Auch die Sprache der Wochentage für die Wettervorhersage ist frei wählbar. Je nach Systemkonfiguration ist aber die Standardsprache u.U. auf Englisch eingestellt, was weitere Anpassungen der Systemkonfiguration erforderlich macht.<br />
<br />
=== Vorbereitung ===<br />
Im folgenden wird z.T. von einem System mit Rasbian oder Debian mit System-V Startsystem ausgegangen. Auf anderen Betriebssystemen und auf Systemen mit System-D müssen die Installationsschritte ggf. angepasst werden.<br />
<br />
<br />
1. Für die Wettervorhersage und die Wetterwarnungen:<br />
Installation des Perl-Moduls ''XML::LibXML'' über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libxml-libxml-perl<br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
2. Falls man einen eigenen Internet-Proxy nutzt:<br />
Die Konfiguration des Proxies für FHEM erfolgt z.B. durch Eintrag von<br />
<pre><br />
attr global proxy <myProxyHost>:<myProxyPort><br />
</pre> <br />
in die [[Konfiguration]], wobei ''myProxyHost'' durch den Namen oder die IP-Adresse des Proxy-Servers ersetzt werden muss und für ''myProxyPort'' der Port des Proxy-Servers eingetragen werden muss (oft 3128).<br />
<br />
<br />
3. FHEM Uhrzeit und Zeitzone:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre><br />
in die FHEM-Kommandozeile überprüfen, ob die FHEM-Uhrzeit plausibel ist. Ist dies nicht der Fall sollten die Uhrzeit auf Systemebene überprüft werden und ggf. die Systemeinstellungen angepasst werden.<br />
Ermitteln der Bezeichnung der eigenen Zeitzone über die System-Kommandozeile mit<br />
<pre><br />
tzselect<br />
</pre><br />
und diese Bezeichnung in die Datei ''/etc/timezone'' eintragen und <br />
<pre><br />
export TZ=`cat /etc/timezone`<br />
</pre><br />
der Datei ''/etc/profile'' hinzufügen und dann das System neu starten. Nun muss die Zeitanzeige in FHEM korrekt sein.<br />
<br />
<br />
4. FHEM Sprache:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre> in die FHEM-Kommandozeile überprüfen, in welcher Sprache der Wochentag angezeigt wird. Stimmt die Sprache nicht, dann auf der System-Kommandozeile<br />
<pre><br />
dpkg-reconfigure locales<br />
</pre> eingeben und aus der Liste z.B. ''de_DE.UTF-8'' zusätzlich auswählen. Dieser Befehl gilt für Debian-basierte Betriebssysteme - für andere Betriebssysteme ist eine analoge Funktion zu verwenden. Mit Eingabe von <br />
<pre><br />
locale -a<br />
</pre> auf der System-Kommandozeile überprüfen, ob die ausgewählte Sprache nun zur Verfügung steht. Durch Hinzufügen von z.B.<br />
<pre><br />
export LANG=de_DE.UTF-8<br />
</pre> in die Datei ''/etc/init.d/fhem'' (irgendwo zwischen ''start'' und ''perl'') und anschließendem Neustart von FHEM wird die Sprache für FHEM eingestellt. Nun muss die Wochentagsanzeige in FHEM korrekt sein.<br />
<br />
<br />
5. Nur für den Weblink erforderlich:<br />
Installation des Perl-Moduls ''DateTime'' über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libdatetime-perl<br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
=== Define ===<br />
siehe [https://fhem.de/commandref.html#DWD_OpenDatadefine Commandref].<br />
<br />
=== Attributes ===<br />
siehe [https://fhem.de/commandref.html#DWD_OpenDataattr Commandref].<br />
<br />
== Anwendungsbeispiele ==<br />
=== Beispiel zur Modul-Einrichtung ===<br />
<br />
* Wettervorhersage<br />
Für die Wettervorhersage muss der Stationscode ermittelt werden. Dazu den [https://www.dwd.de/DE/leistungen/met_verfahren_mosmix/mosmix_stationskatalog.pdf MOSMIX Stationskatalog] herunterladen, öffnen und die gewünschte Station heraussuchen. Einen Teil der deutschen Stationen kann man auch der [https://www.dwd.de/DE/derdwd/messnetz/bodenbeobachtung/messnetzkarte_boden.pdf Bodenmessnetzkarte] entnehmen. Den ermittelten Stationscode kann man dann entweder für eine Einzelabfrage als Parameter für das Kommando ''get forecast'' verwenden oder für die automatische Aktualisierung als Attribut ''forecastStation'' hinterlegen. Insgesamt werden vom DWD mehr als 70 Merkmale zur Verfügung gestellt. Eine Auflistung findet sich im Dokument [https://opendata.dwd.de/weather/lib/MetElementDefinition.xml MetElementDefinition]. Nur ein kleiner Teil der Merkmale wird in der Standardeinstellung des Moduls als Reading zur Verfügung gestellt. Wer andere Merkmale benötigt muss sie mit Komma getrennt dem Attribut ''forecastProperties'' zuweisen. Es empfiehlt sich zur Performance-Optimierung sowohl das Attribut ''forecastDays'' als auch das Attribut ''forecastProperties'' auf den tatsächlichen Bedarf einzustellen.<br />
<br />
* Wetterwarnungen<br />
Für die Wetterwarnungen muss die Warnzelle ermittelt werden. Dazu [https://www.dwd.de/DE/leistungen/opendata/help/warnungen/cap_warncellids_csv.csv Warnzellen-ID Katalog] herunterladen, öffnen und die gewünschte Warnzelle heraussuchen. Unterstützt werden Gemeinden (beginnen mit 8), Landkreise (beginnen mit 1 oder 9) oder Küste (beginnen mit 5). Die Warnzellen-ID kann man dann entweder für eine Einzelabfrage als Parameter für das Kommando ''get alerts'' verwenden oder für die automatische Aktualisierung als Attribut ''alertArea'' hinterlegen. Die Warnzellen-ID ist ab der 2. Stelle identisch mit den ersten Ziffern des amtlichen Gemeindeschlüssels. Man kann z.B. den Namen von Gemeinde oder Landkreis bei den [https://www.statistik-bw.de/Statistik-Portal/gemeindeverz.asp Statistischen Ämtern des Bundes und der Länder] eingeben, den amtlichen Gemeindeschlüssels ermitteln und dann mit vorangestellter 1, 8 oder 9 im Warnzellen-ID Katalog des DWD nach einem Eintrag mit exakter oder weitgehender Übereinstimmung suchen. Wem das zu kompliziert vorkommt, kann bei mehrdeutigen Gemeinde- bzw. Landkreisbezeichnungen auch versuchen auszuprobieren, welche die richtige Wanrzellen-ID ist.<br />
<br />
Um das Modul mit automatisch Aktualisierung von Vorhersage und Wetterwarnungen zu nutzen, kann z.B. folgendes in die [[Konfiguration]] eingetragen werden:<br />
<br />
<pre><br />
define DWD DWD_OpenData<br />
attr DWD alertArea 111000000<br />
attr DWD forecastStation 99810<br />
attr DWD forecastDays 3<br />
attr DWD forecastWW2Text 1<br />
</pre><br />
<br />
Weitere Details zur Installation und Konfiguration finden sich in der [https://fhem.de/commandref.html#DWD_OpenData Commandref].<br />
<br />
=== Beispiel für die Einrichtung eines Weblinks ===<br />
Zur graphischen Darstellung der Vorhersage und der Wetterwarnungen steht das Modul [https://raw.githubusercontent.com/jnsbyr/fhem/master/FHEM/55_DWD_OpenData.pm 99_DWD_OpenData_Weblink.pm] zur Verfügung.<br />
<br />
Zunächst die Moduldatei herunterladen und in das Modulverzeichnis ''fhem/FHEM'' kopieren. Entweder die Datei direkt auf den FHEM-Server herunterladen (z.B. mit ''wget'') oder beim indirekten Herunterladen darauf achten, dass dabei das Encoding nicht verändert wird (also z.B. bei WinSCP den Binär-Modus und nicht den Text-Modus verwenden). Ansonsten werden später z.B. Sonderzeichen wie ''°C'' falsch angezeigt. <br />
<br />
Anschließend kann in die [[Konfiguration]] z.B. folgendes eingetragen werden:<br />
<br />
<pre><br />
define DWD_Weblink_Generator DWD_OpenData_Weblink<br />
attr DWD_Weblink_Generator IODev DWD<br />
attr DWD_Weblink_Generator forecastDays 4<br />
# refreshRate nur dann setzten, wenn der Browser Java-Script beherrscht:<br />
attr DWD_Weblink_Generator refreshRate 900<br />
<br />
define DWD_Weblink weblink htmlCode { DWD_OpenData_Weblink::AsHtmlH("DWD_Weblink_Generator") } <br />
</pre><br />
<br />
Damit legt man das Weblink-Generator-Device an und verknüpft es mit dem DWD_OpenData-Device. Außerdem wird der [[weblink ]] selbst angelegt, der seinerseits mit dem Weblink-Generator-Device verknüpft wird. Der Weblink benötigt für seine Funktion eine bestimmte Auswahl der Vorhersage-Merkmale. Wer das Attribut ''forecastProperties'' des DWD_OpenData-Moduls anpassen will, muss diese Merkmale auf jeden Fall mit berücksichtigen. <br />
<br />
Wenn vom Weblink nichts im Browser zu sehen ist, kann das daran liegen, dass der Browser kein aktuelles JavaScript verwendet oder JavaScript deaktiviert ist. Dann sollte das Attribut ''refreshRate'' auf 0 Sekunden eingestellt oder gelöscht werden. Mit aktiviertem Refresh werden die Daten auch ohne Seitenneuaufbau regelmäßig und bei Tab-Wechsel aktualisiert.<br />
<br />
Die Liste der erforderlichen Vorhersage-Merkmale finden sich zusammen mit allen weitere Details zur Installation und Konfiguration in der Modulhilfe von ''99_DWD_OpenData_Weblink.pm'', die man z.B. nach dem Anlegen des Weblink-Generator-Devices über die Weboberfläche abrufen kann.<br />
<br />
Hier ein Ausschnitt aus der Darstellung des Weblinks mit [[FHEMWEB]]:<br />
<br />
[[File:DWDODweblink.png|500px]]</div>JensBhttp://wiki.fhem.de/w/index.php?title=DWD_OpenData&diff=27943DWD OpenData2018-09-28T18:31:16Z<p>JensB: Installationsbeschreibung aktualisiert</p>
<hr />
<div>{{SEITENTITEL:DWD_OpenData}}<br />
<br />
{{Hinweis|Versionänderung: Die Vorhersagedaten wurden Mitte September 2018 von CSV auf KML umgestellt. Diese Umstellung ist inkompatibel: das DWD_OpenData-Modul muss aktualisiert werden, einige Reading-Namen haben sich geändert und der Weblink muss deinstalliert und neu installiert werden (siehe {{Link2Forum|Topic=83097|Message=840270}}).}}<br />
<br />
{{<br />
Infobox Modul<br />
|ModPurpose=Daten vom DWD OpenData Server abrufen<br />
|ModType=d<br />
<!-- |ModCategory= (noch?) nicht verwendet --><br />
|ModCmdRef=DWD_OpenData<br />
|ModForumArea=Unterstützende Dienste/Wettermodule<br />
|ModTechName=55_DWD_OpenData.pm<br />
|ModOwner=JensB<br />
}}<br />
<br />
Der Deutsche Wetterdienst (DWD) stellt Wetterdaten über den [https://www.dwd.de/DE/leistungen/opendata/opendata.html Open Data Server] zur Verfügung. Die Verwendung dieses Dienstes und der vom DWD zur Verf&uuml;gung gestellten Daten unterliegt den auf der OpenData Webseite beschriebenen Bedingungen. Einen Überblick über die verfügbaren Daten findet man in der Tabelle [https://www.dwd.de/DE/leistungen/opendata/help/inhalt_allgemein/opendata_content_de_en_xls.xls OpenData_weather_content.xls].<br />
<br />
<br />
== Anwendung ==<br />
Aufgrund der unterschiedlichen vom DWD bereitgestellten Datenformate benötigt das Modul zur Dekodierung je nach gewünschtem Funktionsumfang zusätzliche Perl-Module, die nicht standardmäßig vorinstalliert sind und je nach Systemkonfiguration nachinstalliert werden müssen. Außerdem unterstützt das Modul Zeitzonen, um z.B. die Wettervorhersage internationaler Stationen in Ortszeit darstellen zu können. Hierfür sind je nach Systemkonfiguration weitere Einstellungen erforderlich. Auch die Sprache der Wochentage für die Wettervorhersage ist frei wählbar. Je nach Systemkonfiguration ist aber die Standardsprache u.U. auf Englisch eingestellt, was weitere Anpassungen der Systemkonfiguration erforderlich macht.<br />
<br />
=== Vorbereitung ===<br />
Im folgenden wird z.T. von einem System mit Rasbian oder Debian mit System-V Startsystem ausgegangen. Auf anderen Betriebssystemen und auf Systemen mit System-D müssen die Installationsschritte ggf. angepasst werden.<br />
<br />
<br />
1. Für die Wettervorhersage und die Wetterwarnungen:<br />
Installation des Perl-Moduls ''XML::LibXML'' über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libxml-libxml-perl<br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
2. Falls man einen eigenen Internet-Proxy nutzt:<br />
Die Konfiguration des Proxies für FHEM erfolgt z.B. durch Eintrag von<br />
<pre><br />
attr global proxy <myProxyHost>:<myProxyPort><br />
</pre> <br />
in die [[Konfiguration]], wobei ''myProxyHost'' durch den Namen oder die IP-Adresse des Proxy-Servers ersetzt werden muss und für ''myProxyPort'' der Port des Proxy-Servers eingetragen werden muss (oft 3128).<br />
<br />
<br />
3. FHEM Uhrzeit und Zeitzone:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre><br />
in die FHEM-Kommandozeile überprüfen, ob die FHEM-Uhrzeit plausibel ist. Ist dies nicht der Fall sollten die Uhrzeit auf Systemebene überprüft werden und ggf. die Systemeinstellungen angepasst werden.<br />
Ermitteln der Bezeichnung der eigenen Zeitzone über die System-Kommandozeile mit<br />
<pre><br />
tzselect<br />
</pre><br />
und diese Bezeichnung in die Datei ''/etc/timezone'' eintragen und <br />
<pre><br />
export TZ=`cat /etc/timezone`<br />
</pre><br />
der Datei ''/etc/profile'' hinzufügen und dann das System neu starten. Nun muss die Zeitanzeige in FHEM korrekt sein.<br />
<br />
<br />
4. FHEM Sprache:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre> in die FHEM-Kommandozeile überprüfen, in welcher Sprache der Wochentag angezeigt wird. Stimmt die Sprache nicht, dann auf der System-Kommandozeile<br />
<pre><br />
dpkg-reconfigure locales<br />
</pre> eingeben und aus der Liste z.B. ''de_DE.UTF-8'' zusätzlich auswählen. Mit Eingabe von <br />
<pre><br />
locale -a<br />
</pre> auf der System-Kommandozeile überprüfen, ob die ausgewählte Sprache nun zur Verfügung steht. Durch Hinzufügen von z.B.<br />
<pre><br />
export LANG=de_DE.UTF-8<br />
</pre> in die Datei ''/etc/init.d/fhem'' (irgendwo zwischen ''start'' und ''perl'') und anschließendem Neustart von FHEM wird die Sprache für FHEM eingestellt. Nun muss die Wochentagsanzeige in FHEM korrekt sein.<br />
<br />
<br />
5. Nur für den Weblink erforderlich:<br />
Installation des Perl-Moduls ''DateTime'' über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libdatetime-perl<br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
=== Define ===<br />
siehe [https://fhem.de/commandref.html#DWD_OpenDatadefine Commandref].<br />
<br />
=== Attributes ===<br />
siehe [https://fhem.de/commandref.html#DWD_OpenDataattr Commandref].<br />
<br />
== Anwendungsbeispiele ==<br />
=== Beispiel zur Modul-Einrichtung ===<br />
<br />
* Wettervorhersage<br />
Für die Wettervorhersage muss der Stationscode ermittelt werden. Dazu den [https://www.dwd.de/DE/leistungen/met_verfahren_mosmix/mosmix_stationskatalog.pdf MOSMIX Stationskatalog] herunterladen, öffnen und die gewünschte Station heraussuchen. Einen Teil der deutschen Stationen kann man auch der [https://www.dwd.de/DE/derdwd/messnetz/bodenbeobachtung/messnetzkarte_boden.pdf Bodenmessnetzkarte] entnehmen. Den ermittelten Stationscode kann man dann entweder für eine Einzelabfrage als Parameter für das Kommando ''get forecast'' verwenden oder für die automatische Aktualisierung als Attribut ''forecastStation'' hinterlegen. Insgesamt werden vom DWD mehr als 70 Merkmale zur Verfügung gestellt. Eine Auflistung findet sich im Dokument [https://opendata.dwd.de/weather/lib/MetElementDefinition.xml MetElementDefinition]. Nur ein kleiner Teil der Merkmale wird in der Standardeinstellung des Moduls als Reading zur Verfügung gestellt. Wer andere Merkmale benötigt muss sie mit Komma getrennt dem Attribut ''forecastProperties'' zuweisen. Es empfiehlt sich zur Performance-Optimierung sowohl das Attribut ''forecastDays'' als auch das Attribut ''forecastProperties'' auf den tatsächlichen Bedarf einzustellen.<br />
<br />
* Wetterwarnungen<br />
Für die Wetterwarnungen muss die Warnzelle ermittelt werden. Dazu [https://www.dwd.de/DE/leistungen/opendata/help/warnungen/cap_warncellids_csv.csv Warnzellen-ID Katalog] herunterladen, öffnen und die gewünschte Warnzelle heraussuchen. Unterstützt werden Gemeinden (beginnen mit 8), Landkreise (beginnen mit 1 oder 9) oder Küste (beginnen mit 5). Die Warnzellen-ID kann man dann entweder für eine Einzelabfrage als Parameter für das Kommando ''get alerts'' verwenden oder für die automatische Aktualisierung als Attribut ''alertArea'' hinterlegen. Die Warnzellen-ID ist ab der 2. Stelle identisch mit den ersten Ziffern des amtlichen Gemeindeschlüssels. Man kann z.B. den Namen von Gemeinde oder Landkreis bei den [https://www.statistik-bw.de/Statistik-Portal/gemeindeverz.asp Statistischen Ämtern des Bundes und der Länder] eingeben, den amtlichen Gemeindeschlüssels ermitteln und dann mit vorangestellter 1, 8 oder 9 im Warnzellen-ID Katalog des DWD nach einem Eintrag mit exakter oder weitgehender Übereinstimmung suchen. Wem das zu kompliziert vorkommt, kann bei mehrdeutigen Gemeinde- bzw. Landkreisbezeichnungen auch versuchen auszuprobieren, welche die richtige Wanrzellen-ID ist.<br />
<br />
Um das Modul mit automatisch Aktualisierung von Vorhersage und Wetterwarnungen zu nutzen, kann z.B. folgendes in die [[Konfiguration]] eingetragen werden:<br />
<br />
<pre><br />
define DWD DWD_OpenData<br />
attr DWD alertArea 111000000<br />
attr DWD forecastStation 99810<br />
attr DWD forecastDays 3<br />
attr DWD forecastWW2Text 1<br />
</pre><br />
<br />
Weitere Details zur Installation und Konfiguration finden sich in der [https://fhem.de/commandref.html#DWD_OpenData Commandref].<br />
<br />
=== Beispiel für die Einrichtung eines Weblinks ===<br />
Zur graphischen Darstellung der Vorhersage und der Wetterwarnungen steht das Modul [https://github.com/jnsbyr/fhem/blob/master/FHEM/99_DWD_OpenData_Weblink.pm 99_DWD_OpenData_Weblink.pm] zur Verfügung.<br />
<br />
Zunächst die Moduldatei herunterladen und in das Modulverzeichnis ''fhem/FHEM'' kopieren. Dann in die [[Konfiguration]] z.B. folgendes eingetragen werden:<br />
<br />
<pre><br />
define DWD_Weblink_Generator DWD_OpenData_Weblink<br />
attr DWD_Weblink_Generator IODev DWD<br />
attr DWD_Weblink_Generator forecastDays 4<br />
attr DWD_Weblink_Generator refreshRate 900<br />
<br />
define DWD_Weblink weblink htmlCode { DWD_OpenData_Weblink::AsHtmlH("DWD_Weblink_Generator") } <br />
</pre><br />
<br />
Damit legt man das Weblink-Generator-Device an und verknüpft es mit dem DWD_OpenData-Device. Außerdem wird der [[weblink ]] selbst angelegt, der seinerseits mit dem Weblink-Generator-Device verknüpft wird. Der Weblink benötigt für seine Funktion eine bestimmte Auswahl der Vorhersage-Merkmale. Wer das Attribut ''forecastProperties'' des DWD_OpenData-Moduls anpassen will, muss diese Merkmale auf jeden Fall mit berücksichtigen. <br />
<br />
Wer einen Browser ohne aktuelles JavaScript verwendet, sollte das Attribut ''refreshRate'' auf 0 Sekunden eingestellt lassen oder löschen. Mit aktiviertem Refresh werden die Daten auch ohne Seitenneuaufbau regelmäßig und bei Tab-Wechsel aktualisiert.<br />
<br />
Die Liste der erforderlichen Vorhersage-Merkmale finden sich zusammen mit allen weitere Details zur Installation und Konfiguration in der Modulhilfe von ''99_DWD_OpenData_Weblink.pm'', die man z.B. nach dem Anlegen des Weblink-Generator-Devices über die Weboberfläche abrufen kann.<br />
<br />
Hier ein Ausschnitt aus der Darstellung des Weblinks mit [[FHEMWEB]]:<br />
<br />
[[File:DWDODweblink.png|500px]]</div>JensBhttp://wiki.fhem.de/w/index.php?title=Wetter_und_Wettervorhersagen&diff=27942Wetter und Wettervorhersagen2018-09-28T17:21:37Z<p>JensB: Vorhersagezeitraum von DWD_OpenData an neue Datenlage angepasst</p>
<hr />
<div>Wetterdaten und Wettervorhersagen können auf verschiedene Weise in FHEM eingebunden werden.<br />
<br />
== Yahoo-Wetter ==<br />
Für die einfache Einbindung des Yahoo-Wetters gibt es das spezielle Modul [[Weather]].<br />
<br />
== Unwetterzentrale ==<br />
Informationen der Seite(n) Unwetterzentrale.de können mit Hilfe des Moduls [[UWZ]] eingebunden werden.<br />
<br />
== Modul OPENWEATHER ==<br />
Das Modul [[OPENWEATHER]] extrahiert Wetterdaten über die "openweather"-Schnittstelle (API) von www.wetter.com. <br />
*Vorschau-Zeitraum: 3 Tage<br />
*Vorschau-Interval: 6:00, 11:00, 17:00, 23:00<br />
*Aktuelle Daten: keine<br />
<br />
== Modul PROPLANTA ==<br />
Das Modul [[PROPLANTA]] extrahiert Wetterdaten von der Website www.proplanta.de. (keine API)<br />
*Vorschau-Zeitraum: 12 Tage<br />
*Vorschau-Interval: 3 h<br />
*Aktuelle Daten: jede volle Stunde<br />
<br />
== Modul WWO ==<br />
Das Modul extrahiert Wetterdaten über die (alte) API von worldweatheronline.com<br />
*Vorschau-Zeitraum: ?? Tage<BR><br />
*Vorschau-Interval: ??<br><br />
*Aktuelle Daten: ??<br />
<br />
== Deutscher Wetterdienst (DWD) ==<br />
<br />
=== Modul DWD_OpenData ===<br />
Das Modul [[DWD_OpenData]] stellt einen Teil der frei verfügbaren Daten des Deutschen Wetterdienstes (DWD) bereit, die über den [https://www.dwd.de/DE/leistungen/opendata/opendata.html Open Data Server] abgerufen werden können (diverse Datenformate, keine API). <br />
*Vorschau-Zeitraum: 10 Tage<br />
*Vorschau-Interval: datenabhängig, viele mit 3 h<br />
*Vorschau-Orte: national und international<br />
*Aktuelle Daten: nicht implementiert<br />
*Wetterwarnungen: für Landkreise und Gemeinden in deutsch oder englisch<br />
<br />
Es gibt zum Modul auch einen Weblink für [[FHEMWEB]], der 2 Icons pro Tag in horizontaler Form darstellt. Die Anzahl der insgesamt dargestellten Icons ist konfigurierbar. Liegen Wetterwarnungen vor, wird zusätzlich ein Warnsymbol angezeigt, über das man per Klick weitere Details zur Wetterwarnung abrufen kann.<br />
<br />
[[DWD_OpenData|Weitere Details und Installationsbeschreibung]]<br />
<br />
=== Wetterwarnungen als Karte ===<br />
Der Deutsche Wetterdienst [http://www.dwd.de DWD] stellt neben diversen Wetterdaten auch Wetterwarnungen in Bildform bereit. Diese können sehr einfach via [http://fhem.de/commandref_DE.html#weblink weblink iframe] in FHEM eingebunden werden - das ist zwar nicht die schönste Form, aber die schnellste.<br />
<br />
Dazu sucht man sich zuerst auf der [http://www.dwd.de/bvbw/appmanager/bvbw/dwdwwwDesktop?_nfpb=true&_pageLabel=_dwdwww_wetter_warnungen_warnungen&T92053gsbDocumentPath=BEA__Navigation%2FWetter__Warnungen%2FWarnungen.html%3F__nnn%3Dtrue&lastPageLabel=dwdwww_wetter_warnungen Warnungsseite des DWD] die eigene Region heraus (in der Karte durchklicken). Die gewünschte URL für Berlin Stadt ist z.B. <code>http://www.dwd.de/dyn/app/ws/html/reports/BXX_warning_de.html#WS_ANCHOR_0</code>. Das Anhängsel <code>#WS_ANCHOR_0</code> kann man in der Konfiguration auch weglassen.<br />
<br />
Die Einbindung in FHEM sieht dann wie folgt aus:<br />
<pre><br />
define dwd_warnmeldung weblink iframe http://www.dwd.de/dyn/app/ws/html/reports/BXX_warning_de.html<br />
attr dwd_warnmeldung group Wetterwarnungen (DWD)<br />
attr dwd_warnmeldung htmlattr width="100%" height="300" frameborder="0" marginheight="0" marginwidth="0"<br />
attr dwd_warnmeldung room Wettervorhersage,Startseite<br />
</pre><br />
<br />
== Vorhersage-Diagramm von YR ==<br />
[http://www.yr.no YR] ist die Seite des norwegischen Wetterdiensts. Er ist zwar nur in Teilen auf Englisch (und gar nicht auf Deutsch) verfügbar, bietet aber sehr gute Wettervorhersagen - auch mit eigenen Vorhersagen für kleine Dörfer. Neben etlichen Detailinfos bietet YR eine sehr schicke 48h-Vorhersage-Grafik. Diese kann sehr einfach via [http://fhem.de/commandref_DE.html#weblink weblink iframe] in FHEM eingebunden werden.<br />
<br />
Dazu geht man auf die [http://www.yr.no Startseite von YR] und gibt in das Suchfeld den Namen seines Dörfchens ein - die Ergebnissliste kann ziemlich lang werden, sodass man evtl. sehr genau schauen muss, welches das eigene Kaff ist - bei mir war es an 29. Stelle... ;-) Auf der gewünschten Seite gibt es einen Unterpunkt "Hour by hour", wo sich die besagte Grafik findet. Hier kopiert man sich einfach die URL der Grafik.<br />
<br />
Die Einbindung in FHEM sieht dann bspw. wie folgt aus:<br />
<pre><br />
define Wetter_yr_Vorhersage weblink iframe http://www.yr.no/place/Germany/Berlin/Berlin/meteogram.png<br />
attr Wetter_yr_Vorhersage group Wettervorhersage (yr)<br />
attr Wetter_yr_Vorhersage htmlattr width="100%" height="300" frameborder="0" marginheight="0" marginwidth="0"<br />
attr Wetter_yr_Vorhersage room Wettervorhersage,Start<br />
</pre><br />
<br />
== Wetter von Weather Underground ==<br />
{{Randnotiz|RNTyp=y|RNText=Neben dem hier vorgestellten Abruf der Weather Underground-Daten mit [[HTTPMOD]] kann auf Weather Underground-Daten auch mit dem darauf spezialisierten Modul [http://fhem.de/commandref.html#Wunderground Wunderground] zugegriffen werden.}}<br />
<br />
'''Hinweis:''' Dieses Vorgehen ist etwas anspruchsvoller und somit eher für erfahrene FHEM-User geeignet.<br />
<br />
[http://www.wunderground.com/ Weather Underground] ist bietet eine sehr umfassende Sammlung aller möglichen offiziellen und privaten (aber teils sehr professionellen) Wetterstationen weltweit. Es besteht eine recht hohe Wahrscheinlichkeit, dass es in der eigenen Umgebung schon eine Wetterstation gibt. Anstatt nun selbst eine komplette Wetterstation aufzubauen, kann man alternativ auf die Daten der Nachbarstation zugreifen.<br />
<br />
Dazu sind grundsätzlich die folgenden Schritte notwendig:<br />
* Finden der geeigneten Station<br />
* Auswerten der XML-Daten<br />
* Erstellen passender gplot-Dateien<br />
<br />
=== Finden der geeigneten Station ===<br />
Als erstes geht man auf die [http://www.wunderground.com Startseite von Weather Underground] und gibt in das Suchfeld den Namen seines Dörfchens oder der nächsten Stadt ein - für Berlin landet man bspw. auf Seite für "Berlin Alexanderplatz". Es gibt aber manchmal sehr viele Wetterstationen in der direkten Umgebung. Diese findet man indem am auf "Change Station" klickt und sich eine passende Station aussucht. Nähere Infos (zB. zur verwendeten Hard- und Software) zu der gewählten Wetterstation erhält man, wenn man auf den Namen der Station klickt und dann auf "About this PWS". <br />
<br />
Weather Underground stellt die Daten der Wetterstation auch über eine API als XML bereit, die wir auswerten können. Die entsprechende URL findet sich ebenfalls unter "About this PWS" unter "Download current conditions XML". Für Berlin Prenzlauer Berg wäre dies bspw. <br />
<code>http://api.wunderground.com/weatherstation/WXDailyHistory.asp?ID=IBERLIN15&format=XML</code>.<br />
<br />
Entscheidend für die jeweilige Station ist der Teil nach "?=ID", also in diesem Fall "IBERLIN15". Dieser Teil des Links lässt sich leicht durch die ID einer anderen Station ersetzen und die Suche nach dem entsprechenden Link auf der Seite der Station bleibt erspart.<br />
<br />
=== Auswerten der XML-Daten ===<br />
Die Auswertung der XML-Daten erfolgt via [[HTTPMOD]]. Da dies nicht ganz trivial ist, sind im Folgenden zuerst die wesentlichen Konfigurationsschritte exemplarisch beschrieben. Weiter unten findet sich dann die fertige vollständige Konfiguration.<br />
<br />
Es erstes wird das Device HTTPMOD definiert (die 600 am Schluss ist der Aktualisierungszyklus in Sekunden, also alle 10 min):<br />
:<code>define wetter_prenzelberg HTTPMOD http://api.wunderground.com/weatherstation/WXCurrentObXML.asp?ID=IBERLIN15 600 </code><br />
<br />
Dann werden Attribute für alle Readings definiert:<br />
:<code>attr wetter_prenzelberg userattr readingsName_cloudiness readingsName_date ... </code><br />
<br />
Dann wird jedem Attribut ein Name zugewiesen (unter diesem Namen wird der Wert ins Log geschrieben):<br />
:<code>attr wetter_prenzelberg readingsName_cloudiness cloudiness </code><br />
<br />
Zum Schluss wird das Reading selbst definiert:<br />
:<code>attr wetter_prenzelberg readingsRegex_cloudiness cloudiness id="NN" percent="([\d\.]+) </code><br />
<br />
Die gesamte Konfiguration für alle von der API angebotenen Wetterwerte sieht dann wie folgt aus:<br />
<pre><br />
define wetter_prenzelberg HTTPMOD http://api.wunderground.com/weatherstation/WXCurrentObXML.asp?ID=IBERLIN15 600<br />
attr wetter_prenzelberg userattr readingsName_cloudiness readingsName_date readingsName_dewpointTemperature readingsName_fog readingsName_heatindex readingsName_humidity readingsName_pressure readingsName_solarRadiation readingsName_solarUV readingsName_temperature readingsName_time readingsName_windChill readingsName_windDegrees readingsName_windDirection readingsName_windGust readingsName_windSpeed readingsRegex_cloudiness readingsRegex_date readingsRegex_dewpointTemperature readingsRegex_fog readingsRegex_heatindex readingsRegex_humidity readingsRegex_pressure readingsRegex_solarRadiation readingsRegex_solarUV readingsRegex_temperature readingsRegex_time readingsRegex_windChill readingsRegex_windDegrees readingsRegex_windDirection readingsRegex_windGust readingsRegex_windSpeed<br />
attr wetter_prenzelberg readingsName_cloudiness cloudiness<br />
attr wetter_prenzelberg readingsName_date date<br />
attr wetter_prenzelberg readingsName_dewpointTemperature dewpointTemperature<br />
attr wetter_prenzelberg readingsName_fog fog<br />
attr wetter_prenzelberg readingsName_heatindex heatindex<br />
attr wetter_prenzelberg readingsName_humidity humidity<br />
attr wetter_prenzelberg readingsName_pressure pressure<br />
attr wetter_prenzelberg readingsName_solarRadiation solarRadiation<br />
attr wetter_prenzelberg readingsName_solarUV solarUV<br />
attr wetter_prenzelberg readingsName_temperature temperature<br />
attr wetter_prenzelberg readingsName_time time<br />
attr wetter_prenzelberg readingsName_windChill windChill<br />
attr wetter_prenzelberg readingsName_windDegrees windDegrees<br />
attr wetter_prenzelberg readingsName_windDirection windDirection<br />
attr wetter_prenzelberg readingsName_windGust windGust<br />
attr wetter_prenzelberg readingsName_windSpeed windSpeed<br />
attr wetter_prenzelberg readingsRegex_cloudiness cloudiness id="NN" percent="([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_date date date" content="([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_dewpointTemperature <dewpoint_c>(\+|-?[\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_fog fog id="FOG" percent="([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_heatindex <heat_index_c>(\+|-?[\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_humidity <relative_humidity>([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_pressure <pressure_mb>([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_solarRadiation <solar_radiation>([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_solarUV <UV>([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_temperature <temp_c>(\+|-?[\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_time time Zeit([\d\:]+)<br />
attr wetter_prenzelberg readingsRegex_windChill <windchill_c>(\+|-?[\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_windDegrees <wind_degrees>([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_windDirection <wind_dir>([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_windGust <wind_gust_mph>([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_windSpeed <wind_mph>([\d\.]+)<br />
</pre><br />
Hinweis: Nicht immer werden alle Werte geliefert (wenn keine Sonne, dann kein UV-Wert...). Im System-Log kann das als Fehler auftauchen, ist aber kein Problem.<br />
<br />
=== Erstellen passender gplot-Dateien ===<br />
Um die ausgelesenen Werte als Graphen darstellen zu können müssen eigene gplot-Dateien erstellt werden. Eine grundsätzliche Anleitung dazu findet sich unter [[Creating Plots]]. Deshalb sollen hier nur Beispiele für die eigentlichen gplot-Dateien vorgestellt werden. Beispiele sollten sowohl für [[FileLog]] wie [[DbLog]] funktionieren.<br />
<br />
Temperatur und Luftfeuchte:<br />
<pre><br />
set terminal png transparent size <SIZE> crop<br />
set output '<OUT>.png'<br />
set xdata time<br />
set timefmt "%Y-%m-%d_%H:%M:%S"<br />
set xlabel " "<br />
#set title '<L1>'<br />
set title ''<br />
set ytics <br />
set y2tics <br />
set grid ytics<br />
set ylabel "Temperature in C"<br />
set y2label "Humidity (%)"<br />
<br />
#FileLog 4:temperature\x3a::<br />
#FileLog 4:windChill\x3a::<br />
#FileLog 4:humidity\x3a::<br />
<br />
#DbLog <SPEC1>:temperature::<br />
#DbLog <SPEC1>:windChill::<br />
#DbLog <SPEC1>:humidity::<br />
<br />
plot "<IN>" using 1:2 axes x1y1 title 'Temperatur (C)' ls l0 lw 1.5 with lines,\<br />
"<IN>" using 1:2 axes x1y1 title 'Gefühlte Temperatur (C)' ls l1 lw 1.5 with lines,\<br />
"<IN>" using 1:2 axes x1y2 title 'Luftfeuchtigkeit (%)' ls l2fill lw 0.2 with lines<br />
</pre><br />
<br />
Wind und Windrichtung:<br />
<pre><br />
set terminal png transparent size <SIZE> crop<br />
<br />
set output '<OUT>.png'<br />
set xdata time<br />
set timefmt "%Y-%m-%d_%H:%M:%S"<br />
set xlabel " "<br />
<br />
set ytics<br />
set y2tics ("Nord" 0, "Ost" 80, "S&#252;d" 180, "West" 270, "Nord" 360)<br />
<br />
#set title '<L1>'<br />
set title ''<br />
<br />
set grid xtics ytics<br />
<br />
set yrange [0:20]<br />
set y2range [0:360]<br />
<br />
set ylabel "Wind (mph)"<br />
set y2label "Richtung"<br />
<br />
#FileLog 4:windSpeed:0:<br />
#FileLog 4:windGust:0:<br />
#FileLog 4:windDegrees:0:<br />
<br />
#DbLog <SPEC1>:windSpeed::<br />
#DbLog <SPEC1>:windGust::<br />
#DbLog <SPEC1>:windDegrees::<br />
<br />
plot "<IN>" using 1:2 axes x1y1 title 'Wind (mph)' ls l0 lw 1.5 with lines,\<br />
"<IN>" using 1:2 axes x1y1 title 'Böen (mph)' ls l1 lw 1.5 with lines,\<br />
"<IN>" using 1:2 axes x1y2 title 'Windrichtung (°)' ls l2fill lw 0.2 with points<br />
</pre><br />
<br />
Sonnenintensität und UV-Werte:<br />
<pre><br />
set terminal png transparent size <SIZE> crop<br />
<br />
set output '<OUT>.png'<br />
set xdata time<br />
set timefmt "%Y-%m-%d_%H:%M:%S"<br />
set xlabel " "<br />
<br />
set ytics<br />
set y2tics<br />
<br />
#set title '<L1>'<br />
set title ''<br />
<br />
set grid xtics ytics<br />
<br />
set ylabel "Sonnenstrahlung (W/qm)"<br />
set y2label "UV"<br />
<br />
#FileLog 4:solarRadiation:0:<br />
#FileLog 4:solarUV:0:<br />
<br />
#DbLog <SPEC1>:solarRadiation::<br />
#DbLog <SPEC1>:solarUV::<br />
<br />
plot "<IN>" using 1:2 axes x1y1 title 'Strahlung' ls l0 lw 1.5 with lines,\<br />
"<IN>" using 1:2 axes x1y1 title 'UV' ls l1 lw 1.5 with lines<br />
</pre><br />
<br />
'''Weitere TBD'''<br />
<br />
=== Vergangene Daten abfragen ===<br />
Ein konkretes vergangenes Datum der Wetterstation kann man übrigens auch abrufen - für den 28.11.2014 wäre dies bspw. <br />
<code>http://www.wunderground.com/weatherstation/WXDailyHistory.asp?ID=IBERLIN15&day=28&month=11&year=2014&graphspan=day&format=1</code>.<br />
<br />
=== Eigene Wetterdaten hochladen ===<br />
{{Randnotiz|RNTyp=g|RNText=Unterstützung für das Modul gibt es im dazugehörigen {{Link2Forum|Topic=65587|LinkText=Forumsthread }}.}}<br />
<br />
Wer eigene Wetterdaten hochladen will, kann hierzu das Modul [http://fhem.de/commandref.html#WUup WUup] verwenden. Dazu benötigt man die Zugangsdaten (stationID und Paßwort) für eine eigene Wetterstation. Mit dem Modul können die meisten vom [http://wiki.wunderground.com/index.php/PWS_-_Upload_Protocol PWS Upload Protocol] unterstützten Daten hochgeladen werden:<br />
* Winddir - [0-360 momentane Windrichtung]<br />
* Windspeedmph - [mph momentane Windgeschwindigkeit]<br />
* Windgustmph - [mph aktuellen Böe, mit Software-spezifischem Zeitraum]<br />
* Windgustdir - [0-360 mit Software-spezifischer Zeit]<br />
* Windspdmph_avg2m - [mph durchschnittliche Windgeschwindigkeit innerhalb 2 Minuten]<br />
* Winddir_avg2m - [0-360 durchschnittliche Windrichtung innerhalb 2 Minuten]<br />
* Windgustmph_10m - [mph Böen der vergangenen 10 Minuten]<br />
* Windgustdir_10m - [0-360 Richtung der Böen der letzten 10 Minuten]<br />
* Feuchtigkeit - [% Außenfeuchtigkeit 0-100%]<br />
* Dewptf- [F Taupunkt im Freien]<br />
* Tempf - [F Außentemperatur]<br />
* Rainin - [in Regen in der vergangenen Stunde]<br />
* Dailyrainin - [in Regenmenge bisher heute]<br />
* Baromin - [inHg barometrischer Druck]<br />
* Soiltempf - [F Bodentemperatur]<br />
* Bodenfeuchtigkeit - [%]<br />
* Solarradiation - [W/m²]<br />
* UV - [Index]<br />
<br />
Die Werte werden im Modul für Wunderground ins anglo-amerikanische System umgerechnet. Temperaturen werden also automatisch von °Celsius in Fahrenheit, Windgeschwindigkeiten von km/h in mph, mm in Inch und der barometrische Druck von hPa in inHg umgerechnet.<br />
<br />
== Wetternetzwerk auf wetter.com ==<br />
Ein vollständiges Beispiel zur Nutzung der Informationen über die Regenmenge (Station 1445, Weinheim) von wetter.com ist in {{Link2Forum|Topic=39600|Message=332837|LinkText=diesem Forenbeitrag}} beschrieben.<br />
<br />
== Wetter von netatmo ==<br />
Das FHEM-Modul [[netatmo]] ermöglicht den Datenimport von privaten und öffentlichen netatmo Wetterstationen sowie den Abruf der in der Netatmo App verfügbaren Wettervorhersage. Eine Übersicht über die verfügbaren öffentlichen Stationen findet sich auf der Seite [http://www.netatmo.com/de-DE/weathermap Weathermap]. Die meisten öffentlichen Stationen liefern Temperatur, Luftfeuchte und Luftdruck, einige auch Wind, Regen und Daten zur Luftqualität (CO<sub>2</sub>).<br />
<br />
== Links ==<br />
* {{Link2Forum|Topic=33610}} mit Sammlung und Beipielen von Internet-Links für die Anzeige von teilweise animierten Wetterbildern<br />
* [http://bloglich.de/art/rpi/wetterdaten-auf-dem-raspberry-pi-in-fhem/ Beispiel in Blog(de)]<br />
* [[HTTPMOD]]<br />
<br />
[[Kategorie:Code Snippets]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Wetterstationen]] <!-- eigentlich eine "Hardware-Kategorie", passt aber trotzdem --></div>JensBhttp://wiki.fhem.de/w/index.php?title=DWD_OpenData&diff=26702DWD OpenData2018-05-13T09:27:07Z<p>JensB: Bezug zum amtlichen Gemeindeschlüssel</p>
<hr />
<div>{{SEITENTITEL:DWD_OpenData}}<br />
{{<br />
Infobox Modul<br />
|ModPurpose=Daten vom DWD OpenData Server abrufen<br />
|ModType=d<br />
<!-- |ModCategory= (noch?) nicht verwendet --><br />
|ModCmdRef=DWD_OpenData<br />
|ModForumArea=Unterstützende Dienste/Wettermodule<br />
|ModTechName=55_DWD_OpenData.pm<br />
|ModOwner=JensB<br />
}}<br />
<br />
Der Deutsche Wetterdienst (DWD) stellt Wetterdaten über den [https://www.dwd.de/DE/leistungen/opendata/opendata.html Open Data Server] zur Verfügung. Die Verwendung dieses Dienstes und der vom DWD zur Verf&uuml;gung gestellten Daten unterliegt den auf der OpenData Webseite beschriebenen Bedingungen. Einen Überblick über die verfügbaren Daten findet man in der Tabelle [https://www.dwd.de/DE/leistungen/opendata/help/inhalt_allgemein/opendata_content_de_en_xls.xls OpenData_weather_content.xls].<br />
<br />
<br />
== Anwendung ==<br />
Aufgrund der unterschiedlichen vom DWD bereitgestellten Datenformate benötigt das Modul zur Dekodierung je nach gewünschtem Funktionsumfang zusätzliche Perl-Module, die nicht standardmäßig vorinstalliert sind und je nach Systemkonfiguration nachinstalliert werden müssen. Außerdem unterstützt das Modul Zeitzonen, um z.B. die Wettervorhersage internationaler Stationen in Ortszeit darstellen zu können. Hierfür sind je nach Systemkonfiguration weitere Einstellungen erforderlich. Auch die Sprache der Wochentage für die Wettervorhersage ist frei wählbar. Je nach Systemkonfiguration ist aber die Standardsprache u.U. auf Englisch eingestellt, was weitere Anpassungen der Systemkonfiguration erforderlich macht.<br />
<br />
=== Vorbereitung ===<br />
Im folgenden wird z.T. von einem System mit Rasbian oder Debian mit System-V Startsystem ausgegangen. Auf anderen Betriebssystemen und auf Systemen mit System-D müssen die Installationsschritte ggf. angepasst werden.<br />
<br />
<br />
1. Für die Wettervorhersage:<br />
Installation des Perl-Moduls ''Text::CSV_XS'' in Version 0.40 oder höher über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libtext-csv-xs-perl <br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
2. Für die Wetterwarnungen:<br />
Installation des Perl-Moduls ''XML::LibXML'' über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libxml-libxml-perl<br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
3. Falls man einen eigenen Internet-Proxy nutzt:<br />
Die Konfiguration des Proxies für FHEM erfolgt z.B. durch Eintrag von<br />
<pre><br />
attr global proxy <myProxyHost>:<myProxyPort><br />
</pre> <br />
in die [[Konfiguration]], wobei ''myProxyHost'' durch den Namen oder die IP-Adresse des Proxy-Servers ersetzt werden muss und für ''myProxyPort'' der Port des Proxy-Servers eingetragen werden muss (oft 3128).<br />
<br />
<br />
4. FHEM Uhrzeit und Zeitzone:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre><br />
in die FHEM-Kommandozeile überprüfen, ob die FHEM-Uhrzeit plausibel ist. Ist dies nicht der Fall sollten die Uhrzeit auf Systemebene überprüft werden und ggf. die Systemeinstellungen angepasst werden.<br />
Ermitteln der Bezeichnung der eigenen Zeitzone über die System-Kommandozeile mit<br />
<pre><br />
tzselect<br />
</pre><br />
und diese Bezeichnung in die Datei ''/etc/timezone'' eintragen und <br />
<pre><br />
export TZ=`cat /etc/timezone`<br />
</pre><br />
der Datei ''/etc/profile'' hinzufügen und dann das System neu starten. Nun muss die Zeitanzeige in FHEM korrekt sein.<br />
<br />
<br />
5. FHEM Sprache:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre> in die FHEM-Kommandozeile überprüfen, in welcher Sprache der Wochentag angezeigt wird. Stimmt die Sprache nicht, dann auf der System-Kommandozeile<br />
<pre><br />
dpkg-reconfigure locales<br />
</pre> eingeben und aus der Liste z.B. ''de_DE.UTF-8'' zusätzlich auswählen. Mit Eingabe von <br />
<pre><br />
locale -a<br />
</pre> auf der System-Kommandozeile überprüfen, ob die ausgewählte Sprache nun zur Verfügung steht. Durch Hinzufügen von z.B.<br />
<pre><br />
export LANG=de_DE.UTF-8<br />
</pre> in die Datei ''/etc/init.d/fhem'' (irgendwo zwischen ''start'' und ''perl'') und anschließendem Neustart von FHEM wird die Sprache für FHEM eingestellt. Nun muss die Wochentagsanzeige in FHEM korrekt sein.<br />
<br />
<br />
6. Für den Weblink:<br />
Installation des Perl-Moduls ''DateTime'' über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libdatetime-perl<br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
=== Define ===<br />
siehe [https://fhem.de/commandref.html#DWD_OpenDatadefine Commandref].<br />
<br />
=== Attributes ===<br />
siehe [https://fhem.de/commandref.html#DWD_OpenDataattr Commandref].<br />
<br />
== Anwendungsbeispiele ==<br />
=== Beispiel zur Modul-Einrichtung ===<br />
<br />
* Wettervorhersage<br />
Für die Wettervorhersage muss der Stationscode ermittelt werden. Dazu den [https://www.dwd.de/DE/leistungen/met_verfahren_mosmix/mosmix_stationskatalog.pdf MOSMIX Stationskatalog] herunterladen, öffnen und die gewünschte Station heraussuchen. Einen Teil der deutschen Stationen kann man auch der [https://www.dwd.de/DE/derdwd/messnetz/bodenbeobachtung/messnetzkarte_boden.pdf Bodenmessnetzkarte] entnehmen. Den ermittelten Stationscode kann man dann entweder für eine Einzelabfrage als Parameter für das Kommando ''get forecast'' verwenden oder für die automatische Aktualisierung als Attribut ''forecastStation'' hinterlegen.<br />
<br />
* Wetterwarnungen<br />
Für die Wetterwarnungen muss die Warnzelle ermittelt werden. Dazu [https://www.dwd.de/DE/leistungen/opendata/help/warnungen/cap_warncellids_csv.csv Warnzellen-ID Katalog] herunterladen, öffnen und die gewünschte Warnzelle heraussuchen. Unterstützt werden Gemeinden (beginnen mit 8), Landkreise (beginnen mit 1 oder 9) oder Küste (beginnen mit 5). Die Warnzellen-ID kann man dann entweder für eine Einzelabfrage als Parameter für das Kommando ''get alerts'' verwenden oder für die automatische Aktualisierung als Attribut ''alertArea'' hinterlegen. Die Warnzellen-ID ist ab der 2. Stelle identisch mit den ersten Ziffern des amtlichen Gemeindeschlüssels. Man kann z.B. den Namen von Gemeinde oder Landkreis bei den [https://www.statistik-bw.de/Statistik-Portal/gemeindeverz.asp Statistischen Ämtern des Bundes und der Länder] eingeben, den amtlichen Gemeindeschlüssels ermitteln und dann mit vorangestellter 1, 8 oder 9 im Warnzellen-ID Katalog des DWD nach einem Eintrag mit exakter oder weitgehender Übereinstimmung suchen. Wem das zu kompliziert vorkommt, kann bei mehrdeutigen Gemeinde- bzw. Landkreisbezeichnungen auch versuchen auszuprobieren, welche die richtige Wanrzellen-ID ist.<br />
<br />
Um das Modul mit automatisch Aktualisierung von Vorhersage und Wetterwarnungen zu nutzen, kann z.B. folgendes in die [[Konfiguration]] eingetragen werden:<br />
<br />
<pre><br />
define DWD DWD_OpenData<br />
attr DWD alertArea 111000000<br />
attr DWD forecastStation 99810<br />
attr DWD forecastDays 3<br />
attr DWD forecastWW2Text 1<br />
</pre><br />
<br />
Weitere Details zur Installation und Konfiguration finden sich in der [https://fhem.de/commandref.html#DWD_OpenData Commandref].<br />
<br />
=== Beispiel für die Einrichtung eines Weblinks ===<br />
Zur graphischen Darstellung der Vorhersage und der Wetterwarnungen steht ein {{Link2Forum|Topic=83097|Message=753155|LinkText=Weblink}} zur Verfügung.<br />
<br />
Die Datei DWDODweblink.pm herunterladen, in das Modulverzeichnis ''fhem/FHEM'' kopieren, irgendwo hinter ''package main'' in die Datei [[99_myUtils_anlegen|99_myUtils.pm]] (nicht verwechseln mit 99_Utils.pm!) den Eintrag<br />
<pre><br />
eval "use DWDODweblink;";<br />
</pre> hinzufügen und FHEM neu starten. Nun kann in die [[Konfiguration]] z.B. folgendes eingetragen werden:<br />
<pre><br />
define DWDweblink weblink htmlCode { DWDOD_AsHtmlH("DWD", 4, 0) }<br />
</pre><br />
<br />
Weitere Details zur Installation und Konfiguration finden sich am Ende der Datei ''DWDODweblink.pm'', die man dazu mit einem Texteditor öffnen sollte, da Weblinks nicht in der Commandref aufgeführt werden.<br />
<br />
Hier ein Ausschnitt aus der Darstellung des Weblinks mit [[FHEMWEB]]:<br />
<br />
[[File:DWDODweblink.png|500px]]</div>JensBhttp://wiki.fhem.de/w/index.php?title=DWD_OpenData&diff=26699DWD OpenData2018-05-12T17:42:51Z<p>JensB: Abbildung Weblink</p>
<hr />
<div>{{SEITENTITEL:DWD_OpenData}}<br />
{{<br />
Infobox Modul<br />
|ModPurpose=Daten vom DWD OpenData Server abrufen<br />
|ModType=d<br />
<!-- |ModCategory= (noch?) nicht verwendet --><br />
|ModCmdRef=DWD_OpenData<br />
|ModForumArea=Unterstützende Dienste/Wettermodule<br />
|ModTechName=55_DWD_OpenData.pm<br />
|ModOwner=JensB<br />
}}<br />
<br />
Der Deutsche Wetterdienst (DWD) stellt Wetterdaten über den [https://www.dwd.de/DE/leistungen/opendata/opendata.html Open Data Server] zur Verfügung. Die Verwendung dieses Dienstes und der vom DWD zur Verf&uuml;gung gestellten Daten unterliegt den auf der OpenData Webseite beschriebenen Bedingungen. Einen Überblick über die verfügbaren Daten findet man in der Tabelle [https://www.dwd.de/DE/leistungen/opendata/help/inhalt_allgemein/opendata_content_de_en_xls.xls OpenData_weather_content.xls].<br />
<br />
<br />
== Anwendung ==<br />
Aufgrund der unterschiedlichen vom DWD bereitgestellten Datenformate benötigt das Modul zur Dekodierung je nach gewünschtem Funktionsumfang zusätzliche Perl-Module, die nicht standardmäßig vorinstalliert sind und je nach Systemkonfiguration nachinstalliert werden müssen. Außerdem unterstützt das Modul Zeitzonen, um z.B. die Wettervorhersage internationaler Stationen in Ortszeit darstellen zu können. Hierfür sind je nach Systemkonfiguration weitere Einstellungen erforderlich. Auch die Sprache der Wochentage für die Wettervorhersage ist frei wählbar. Je nach Systemkonfiguration ist aber die Standardsprache u.U. auf Englisch eingestellt, was weitere Anpassungen der Systemkonfiguration erforderlich macht.<br />
<br />
=== Vorbereitung ===<br />
Im folgenden wird z.T. von einem System mit Rasbian oder Debian mit System-V Startsystem ausgegangen. Auf anderen Betriebssystemen und auf Systemen mit System-D müssen die Installationsschritte ggf. angepasst werden.<br />
<br />
<br />
1. Für die Wettervorhersage:<br />
Installation des Perl-Moduls ''Text::CSV_XS'' in Version 0.40 oder höher über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libtext-csv-xs-perl <br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
2. Für die Wetterwarnungen:<br />
Installation des Perl-Moduls ''XML::LibXML'' über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libxml-libxml-perl<br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
3. Falls man einen eigenen Internet-Proxy nutzt:<br />
Die Konfiguration des Proxies für FHEM erfolgt z.B. durch Eintrag von<br />
<pre><br />
attr global proxy <myProxyHost>:<myProxyPort><br />
</pre> <br />
in die [[Konfiguration]], wobei ''myProxyHost'' durch den Namen oder die IP-Adresse des Proxy-Servers ersetzt werden muss und für ''myProxyPort'' der Port des Proxy-Servers eingetragen werden muss (oft 3128).<br />
<br />
<br />
4. FHEM Uhrzeit und Zeitzone:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre><br />
in die FHEM-Kommandozeile überprüfen, ob die FHEM-Uhrzeit plausibel ist. Ist dies nicht der Fall sollten die Uhrzeit auf Systemebene überprüft werden und ggf. die Systemeinstellungen angepasst werden.<br />
Ermitteln der Bezeichnung der eigenen Zeitzone über die System-Kommandozeile mit<br />
<pre><br />
tzselect<br />
</pre><br />
und diese Bezeichnung in die Datei ''/etc/timezone'' eintragen und <br />
<pre><br />
export TZ=`cat /etc/timezone`<br />
</pre><br />
der Datei ''/etc/profile'' hinzufügen und dann das System neu starten. Nun muss die Zeitanzeige in FHEM korrekt sein.<br />
<br />
<br />
5. FHEM Sprache:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre> in die FHEM-Kommandozeile überprüfen, in welcher Sprache der Wochentag angezeigt wird. Stimmt die Sprache nicht, dann auf der System-Kommandozeile<br />
<pre><br />
dpkg-reconfigure locales<br />
</pre> eingeben und aus der Liste z.B. ''de_DE.UTF-8'' zusätzlich auswählen. Mit Eingabe von <br />
<pre><br />
locale -a<br />
</pre> auf der System-Kommandozeile überprüfen, ob die ausgewählte Sprache nun zur Verfügung steht. Durch Hinzufügen von z.B.<br />
<pre><br />
export LANG=de_DE.UTF-8<br />
</pre> in die Datei ''/etc/init.d/fhem'' (irgendwo zwischen ''start'' und ''perl'') und anschließendem Neustart von FHEM wird die Sprache für FHEM eingestellt. Nun muss die Wochentagsanzeige in FHEM korrekt sein.<br />
<br />
<br />
6. Für den Weblink:<br />
Installation des Perl-Moduls ''DateTime'' über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libdatetime-perl<br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
=== Define ===<br />
siehe [https://fhem.de/commandref.html#DWD_OpenDatadefine Commandref].<br />
<br />
=== Attributes ===<br />
siehe [https://fhem.de/commandref.html#DWD_OpenDataattr Commandref].<br />
<br />
== Anwendungsbeispiele ==<br />
=== Beispiel zur Modul-Einrichtung ===<br />
<br />
* Wettervorhersage<br />
Für die Wettervorhersage muss der Stationscode ermittelt werden. Dazu den [https://www.dwd.de/DE/leistungen/met_verfahren_mosmix/mosmix_stationskatalog.pdf MOSMIX Stationskatalog] herunterladen, öffnen und die gewünschte Station heraussuchen. Einen Teil der deutschen Stationen kann man auch der [https://www.dwd.de/DE/derdwd/messnetz/bodenbeobachtung/messnetzkarte_boden.pdf Bodenmessnetzkarte] entnehmen.<br />
<br />
* Wetterwarnungen<br />
Für die Wetterwarnungen muss die Warnzelle ermittelt werden. Dazu [https://www.dwd.de/DE/leistungen/opendata/help/warnungen/cap_warncellids_csv.csv Warncell-IDs Katalog] herunterladen, öffnen und die gewünschte Warnzelle heraussuchen. Unterstützt werden Gemeinden (beginnen mit 8), Landkreise (beginnen mit 1 oder 9) oder Küste (beginnen mit 5). Da zur Orientierung nur die Bezeichnungen zur Verfügung stehen, ist die Auswahl u.U. mehrdeutig und man muss ausprobieren, welche die gewünschte Warnzelle ist.<br />
<br />
Um das Modul mit Vorhersage und Wetterwarnungen zu nutzen, kann z.B. folgendes in die [[Konfiguration]] eingetragen werden:<br />
<br />
<pre><br />
define DWD DWD_OpenData<br />
attr DWD alertArea 111000000<br />
attr DWD forecastStation 99810<br />
attr DWD forecastDays 3<br />
attr DWD forecastWW2Text 1<br />
</pre><br />
<br />
Weitere Details zur Installation und Konfiguration finden sich in der [https://fhem.de/commandref.html#DWD_OpenData Commandref].<br />
<br />
=== Beispiel für die Einrichtung eines Weblinks ===<br />
Zur graphischen Darstellung der Vorhersage und der Wetterwarnungen steht ein {{Link2Forum|Topic=83097|Message=753155|LinkText=Weblink}} zur Verfügung.<br />
<br />
Die Datei DWDODweblink.pm herunterladen, in das Modulverzeichnis ''fhem/FHEM'' kopieren, irgendwo hinter ''package main'' in die Datei [[99_myUtils_anlegen|99_myUtils.pm]] (nicht verwechseln mit 99_Utils.pm!) den Eintrag<br />
<pre><br />
eval "use DWDODweblink;";<br />
</pre> hinzufügen und FHEM neu starten. Nun kann in die [[Konfiguration]] z.B. folgendes eingetragen werden:<br />
<pre><br />
define DWDweblink weblink htmlCode { DWDOD_AsHtmlH("DWD", 4, 0) }<br />
</pre><br />
<br />
Weitere Details zur Installation und Konfiguration finden sich am Ende der Datei ''DWDODweblink.pm'', die man dazu mit einem Texteditor öffnen sollte, da Weblinks nicht in der Commandref aufgeführt werden.<br />
<br />
Hier ein Ausschnitt aus der Darstellung des Weblinks mit [[FHEMWEB]]:<br />
<br />
[[File:DWDODweblink.png|500px]]</div>JensBhttp://wiki.fhem.de/w/index.php?title=Datei:DWDODweblink.png&diff=26698Datei:DWDODweblink.png2018-05-12T17:36:52Z<p>JensB: Ausschnitt aus der Darstellung des DWD OpenData Weblinks mit FHEMWEB mit hohen Temperaturen, Niederschlag und Wetterwarnungen.</p>
<hr />
<div>Ausschnitt aus der Darstellung des DWD OpenData Weblinks mit FHEMWEB mit hohen Temperaturen, Niederschlag und Wetterwarnungen.</div>JensBhttp://wiki.fhem.de/w/index.php?title=DWD_OpenData&diff=26697DWD OpenData2018-05-12T17:26:20Z<p>JensB: </p>
<hr />
<div>{{SEITENTITEL:DWD_OpenData}}<br />
{{<br />
Infobox Modul<br />
|ModPurpose=Daten vom DWD OpenData Server abrufen<br />
|ModType=d<br />
<!-- |ModCategory= (noch?) nicht verwendet --><br />
|ModCmdRef=DWD_OpenData<br />
|ModForumArea=Unterstützende Dienste/Wettermodule<br />
|ModTechName=55_DWD_OpenData.pm<br />
|ModOwner=JensB<br />
}}<br />
<br />
Der Deutsche Wetterdienst (DWD) stellt Wetterdaten über den [https://www.dwd.de/DE/leistungen/opendata/opendata.html Open Data Server] zur Verfügung. Die Verwendung dieses Dienstes und der vom DWD zur Verf&uuml;gung gestellten Daten unterliegt den auf der OpenData Webseite beschriebenen Bedingungen. Einen Überblick über die verfügbaren Daten findet man in der Tabelle [https://www.dwd.de/DE/leistungen/opendata/help/inhalt_allgemein/opendata_content_de_en_xls.xls OpenData_weather_content.xls].<br />
<br />
<br />
== Anwendung ==<br />
Aufgrund der unterschiedlichen vom DWD bereitgestellten Datenformate benötigt das Modul zur Dekodierung je nach gewünschtem Funktionsumfang zusätzliche Perl-Module, die nicht standardmäßig vorinstalliert sind und je nach Systemkonfiguration nachinstalliert werden müssen. Außerdem unterstützt das Modul Zeitzonen, um z.B. die Wettervorhersage internationaler Stationen in Ortszeit darstellen zu können. Hierfür sind je nach Systemkonfiguration weitere Einstellungen erforderlich. Auch die Sprache der Wochentage für die Wettervorhersage ist frei wählbar. Je nach Systemkonfiguration ist aber die Standardsprache u.U. auf Englisch eingestellt, was weitere Anpassungen der Systemkonfiguration erforderlich macht.<br />
<br />
=== Vorbereitung ===<br />
Im folgenden wird z.T. von einem System mit Rasbian oder Debian mit System-V Startsystem ausgegangen. Auf anderen Betriebssystemen und auf Systemen mit System-D müssen die Installationsschritte ggf. angepasst werden.<br />
<br />
<br />
1. Für die Wettervorhersage:<br />
Installation des Perl-Moduls ''Text::CSV_XS'' in Version 0.40 oder höher über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libtext-csv-xs-perl <br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
2. Für die Wetterwarnungen:<br />
Installation des Perl-Moduls ''XML::LibXML'' über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libxml-libxml-perl<br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
3. Falls man einen eigenen Internet-Proxy nutzt:<br />
Die Konfiguration des Proxies für FHEM erfolgt z.B. durch Eintrag von<br />
<pre><br />
attr global proxy <myProxyHost>:<myProxyPort><br />
</pre> <br />
in die [[Konfiguration]], wobei ''myProxyHost'' durch den Namen oder die IP-Adresse des Proxy-Servers ersetzt werden muss und für ''myProxyPort'' der Port des Proxy-Servers eingetragen werden muss (oft 3128).<br />
<br />
<br />
4. FHEM Uhrzeit und Zeitzone:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre><br />
in die FHEM-Kommandozeile überprüfen, ob die FHEM-Uhrzeit plausibel ist. Ist dies nicht der Fall sollten die Uhrzeit auf Systemebene überprüft werden und ggf. die Systemeinstellungen angepasst werden.<br />
Ermitteln der Bezeichnung der eigenen Zeitzone über die System-Kommandozeile mit<br />
<pre><br />
tzselect<br />
</pre><br />
und diese Bezeichnung in die Datei ''/etc/timezone'' eintragen und <br />
<pre><br />
export TZ=`cat /etc/timezone`<br />
</pre><br />
der Datei ''/etc/profile'' hinzufügen und dann das System neu starten. Nun muss die Zeitanzeige in FHEM korrekt sein.<br />
<br />
<br />
5. FHEM Sprache:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre> in die FHEM-Kommandozeile überprüfen, in welcher Sprache der Wochentag angezeigt wird. Stimmt die Sprache nicht, dann auf der System-Kommandozeile<br />
<pre><br />
dpkg-reconfigure locales<br />
</pre> eingeben und aus der Liste z.B. ''de_DE.UTF-8'' zusätzlich auswählen. Mit Eingabe von <br />
<pre><br />
locale -a<br />
</pre> auf der System-Kommandozeile überprüfen, ob die ausgewählte Sprache nun zur Verfügung steht. Durch Hinzufügen von z.B.<br />
<pre><br />
export LANG=de_DE.UTF-8<br />
</pre> in die Datei ''/etc/init.d/fhem'' (irgendwo zwischen ''start'' und ''perl'') und anschließendem Neustart von FHEM wird die Sprache für FHEM eingestellt. Nun muss die Wochentagsanzeige in FHEM korrekt sein.<br />
<br />
<br />
6. Für den Weblink:<br />
Installation des Perl-Moduls ''DateTime'' über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libdatetime-perl<br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
=== Define ===<br />
siehe [https://fhem.de/commandref.html#DWD_OpenDatadefine Commandref].<br />
<br />
=== Attributes ===<br />
siehe [https://fhem.de/commandref.html#DWD_OpenDataattr Commandref].<br />
<br />
== Anwendungsbeispiele ==<br />
=== Beispiel zur Modul-Einrichtung ===<br />
<br />
* Wettervorhersage<br />
Für die Wettervorhersage muss der Stationscode ermittelt werden. Dazu den [https://www.dwd.de/DE/leistungen/met_verfahren_mosmix/mosmix_stationskatalog.pdf MOSMIX Stationskatalog] herunterladen, öffnen und die gewünschte Station heraussuchen. Einen Teil der deutschen Stationen kann man auch der [https://www.dwd.de/DE/derdwd/messnetz/bodenbeobachtung/messnetzkarte_boden.pdf Bodenmessnetzkarte] entnehmen.<br />
<br />
* Wetterwarnungen<br />
Für die Wetterwarnungen muss die Warnzelle ermittelt werden. Dazu [https://www.dwd.de/DE/leistungen/opendata/help/warnungen/cap_warncellids_csv.csv Warncell-IDs Katalog] herunterladen, öffnen und die gewünschte Warnzelle heraussuchen. Unterstützt werden Gemeinden (beginnen mit 8), Landkreise (beginnen mit 1 oder 9) oder Küste (beginnen mit 5). Da zur Orientierung nur die Bezeichnungen zur Verfügung stehen, ist die Auswahl u.U. mehrdeutig und man muss ausprobieren, welche die gewünschte Warnzelle ist.<br />
<br />
Um das Modul mit Vorhersage und Wetterwarnungen zu nutzen, kann z.B. folgendes in die [[Konfiguration]] eingetragen werden:<br />
<br />
<pre><br />
define DWD DWD_OpenData<br />
attr DWD alertArea 111000000<br />
attr DWD forecastStation 99810<br />
attr DWD forecastDays 3<br />
attr DWD forecastWW2Text 1<br />
</pre><br />
<br />
Weitere Details zur Installation und Konfiguration finden sich in der [https://fhem.de/commandref.html#DWD_OpenData Commandref].<br />
<br />
=== Beispiel für die Einrichtung eines Weblinks ===<br />
Zur graphischen Darstellung der Vorhersage und der Wetterwarnungen steht ein {{Link2Forum|Topic=83097|Message=753155|LinkText=Weblink}} zur Verfügung.<br />
<br />
Die Datei DWDODweblink.pm herunterladen, in das Modulverzeichnis ''fhem/FHEM'' kopieren, irgendwo hinter ''package main'' in die Datei [[99_myUtils_anlegen|99_myUtils.pm]] (nicht verwechseln mit 99_Utils.pm!) den Eintrag<br />
<pre><br />
eval "use DWDODweblink;";<br />
</pre> hinzufügen und FHEM neu starten. Nun kann in die [[Konfiguration]] z.B. folgendes eingetragen werden:<br />
<pre><br />
define DWDweblink weblink htmlCode { DWDOD_AsHtmlH("DWD", 4, 0) }<br />
</pre><br />
<br />
Weitere Details zur Installation und Konfiguration finden sich am Ende der Datei ''DWDODweblink.pm'', die man dazu mit einem Texteditor öffnen sollte, da Weblinks nicht in der Commandref aufgeführt werden.</div>JensBhttp://wiki.fhem.de/w/index.php?title=DWD_OpenData&diff=26696DWD OpenData2018-05-12T17:19:49Z<p>JensB: </p>
<hr />
<div>{{SEITENTITEL:DWD_OpenData}}<br />
{{<br />
Infobox Modul<br />
|ModPurpose=Daten vom DWD OpenData Server abrufen<br />
|ModType=d<br />
<!-- |ModCategory= (noch?) nicht verwendet --><br />
|ModCmdRef=DWD_OpenData<br />
|ModForumArea=Unterstützende Dienste/Wettermodule<br />
|ModTechName=55_DWD_OpenData.pm<br />
|ModOwner=JensB<br />
}}<br />
<br />
Der Deutsche Wetterdienst (DWD) stellt Wetterdaten über den [https://www.dwd.de/DE/leistungen/opendata/opendata.html Open Data Server] zur Verfügung. Die Verwendung dieses Dienstes und der vom DWD zur Verf&uuml;gung gestellten Daten unterliegt den auf der OpenData Webseite beschriebenen Bedingungen. Einen Überblick über die verfügbaren Daten findet man in der Tabelle [https://www.dwd.de/DE/leistungen/opendata/help/inhalt_allgemein/opendata_content_de_en_xls.xls OpenData_weather_content.xls].<br />
<br />
<br />
== Anwendung ==<br />
Aufgrund der unterschiedlichen vom DWD bereitgestellten Datenformate benötigt das Modul zur Dekodierung je nach gewünschten Funktionsumfang zusätzliche Perl-Module, die nicht standardmäßig vorinstalliert sind und je nach Systemkonfiguration nachinstalliert werden müssen. Außerdem unterstützt das Modul Zeitzonen, um z.B. die Wettervorhersage internationaler Stationen in Ortszeit darstellen zu können. Hierfür sind je nach Systemkonfiguration weitere Einstellungen erforderlich. Auch die Sprache der Wochentage für die Wettervorhersage ist frei wählbar. Je nach Systemkonfiguration ist aber die Standardsprache u.U. auf Englisch eingestellt, was weitere Anpassungen der Systemkonfiguration erforderlich macht.<br />
<br />
=== Vorbereitung ===<br />
Im folgenden wird z.T. von einem System mit Rasbian oder Debian mit System-V Startsystem ausgegangen. Auf anderen Betriebssystemen und auf Systemen mit System-D müssen die Installationsschritte ggf. angepasst werden.<br />
<br />
<br />
1. Für die Wettervorhersage:<br />
Installation des Perl-Moduls ''Text::CSV_XS'' in Version 0.40 oder höher über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libtext-csv-xs-perl <br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
2. Für die Wetterwarnungen:<br />
Installation des Perl-Moduls ''XML::LibXML'' über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libxml-libxml-perl<br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
3. Falls man einen eigenen Internet-Proxy nutzt:<br />
Die Konfiguration des Proxies für FHEM erfolgt z.B. durch Eintrag von<br />
<pre><br />
attr global proxy <myProxyHost>:<myProxyPort><br />
</pre> <br />
in die [[Konfiguration]], wobei ''myProxyHost'' durch den Namen oder die IP-Adresse des Proxy-Servers ersetzt werden muss und für ''myProxyPort'' der Port des Proxy-Servers eingetragen werden muss (oft 3128).<br />
<br />
<br />
4. FHEM Uhrzeit und Zeitzone:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre><br />
in die FHEM-Kommandozeile überprüfen, ob die FHEM-Uhrzeit plausibel ist. Ist dies nicht der Fall sollten die Uhrzeit auf Systemebene überprüft werden und ggf. die Systemeinstellungen angepasst werden.<br />
Ermitteln der Bezeichnung der eigenen Zeitzone über die System-Kommandozeile mit<br />
<pre><br />
tzselect<br />
</pre><br />
und diese Bezeichnung in die Datei ''/etc/timezone'' eintragen und <br />
<pre><br />
export TZ=`cat /etc/timezone`<br />
</pre><br />
der Datei ''/etc/profile'' hinzufügen und dann das System neu starten. Nun muss die Zeitanzeige in FHEM korrekt sein.<br />
<br />
<br />
5. FHEM Sprache:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre> in die FHEM-Kommandozeile überprüfen, in welcher Sprache der Wochentag angezeigt wird. Stimmt die Sprache nicht, dann auf der System-Kommandozeile<br />
<pre><br />
dpkg-reconfigure locales<br />
</pre> eingeben und aus der Liste z.B. ''de_DE.UTF-8'' zusätzlich auswählen. Mit Eingabe von <br />
<pre><br />
locale -a<br />
</pre> auf der System-Kommandozeile überprüfen, ob die ausgewählte Sprache nun zur Verfügung steht. Durch Hinzufügen von z.B.<br />
<pre><br />
export LANG=de_DE.UTF-8<br />
</pre> in die Datei ''/etc/init.d/fhem'' (irgendwo zwischen ''start'' und ''perl'') und anschließendem Neustart von FHEM wird die Sprache für FHEM eingestellt. Nun muss die Wochentagsanzeige in FHEM korrekt sein.<br />
<br />
<br />
6. Für den Weblink:<br />
Installation des Perl-Moduls ''DateTime'' über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libdatetime-perl<br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
=== Define ===<br />
siehe [https://fhem.de/commandref.html#DWD_OpenDatadefine Commandref].<br />
<br />
=== Attributes ===<br />
siehe [https://fhem.de/commandref.html#DWD_OpenDataattr Commandref].<br />
<br />
== Anwendungsbeispiele ==<br />
=== Beispiel zur Modul-Einrichtung ===<br />
<br />
* Wettervorhersage<br />
Für die Werttervorhersage muss der Stationscode ermittelt werden. Dazu [https://www.dwd.de/DE/leistungen/met_verfahren_mosmix/mosmix_stationskatalog.pdf MOSMIX Stationskatalog] herunterladen, öffnen und die gewünschte Station heraussuchen. Einen Teil der deutschen Stationen kann man auch der [https://www.dwd.de/DE/derdwd/messnetz/bodenbeobachtung/messnetzkarte_boden.pdf Bodenmessnetzkarte] entnehmen.<br />
<br />
* Wetterwarnungen<br />
Für die Wetterwarnungen muss die Warnzelle ermittelt werden. Dazu [https://www.dwd.de/DE/leistungen/opendata/help/warnungen/cap_warncellids_csv.csv Warncell-IDs Katalog] herunterladen, öffnen und die gewünschte Warnzelle heraussuchen. Unterstützt werden Gemeinden (beginnen mit 8), Landkreise (beginnen mit 1 oder 9) oder Küste (beginnen mit 5). Da zur Orientierung nur die Bezeichnungen zur Verfügung stehen, ist die Auswahl u.U. mehrdeutig und man muss ausprobieren, welche die gewünschte Warnzelle ist.<br />
<br />
Um das Modul mit Vorhersage und Wetterwarnungen zu nutzen, kann z.B. folgendes in die [[Konfiguration]] eingetragen werden:<br />
<br />
<pre><br />
define DWD DWD_OpenData<br />
attr DWD alertArea 111000000<br />
attr DWD forecastStation 99810<br />
attr DWD forecastDays 3<br />
attr DWD forecastWW2Text 1<br />
</pre><br />
<br />
Weitere Details zur Installation und Konfiguration finden sich in der [https://fhem.de/commandref.html#DWD_OpenData Commandref].<br />
<br />
=== Beispiel für die Einrichtung eines Weblinks ===<br />
Zur graphischen Darstellung der Vorhersage und der Wetterwarnungen steht ein {{Link2Forum|Topic=83097|Message=753155|LinkText=Weblink}} zur Verfügung.<br />
<br />
Die Datei DWDODweblink.pm herunterladen, in das Modulverzeichnis ''fhem/FHEM'' kopieren, irgendwo hinter ''package main'' in die Datei [[99_myUtils_anlegen|99_myUtils.pm]] (nicht verwechseln mit 99_Utils.pm!) den Eintrag<br />
<pre><br />
eval "use DWDODweblink;";<br />
</pre> hinzufügen und FHEM neu starten. Nun kann in die [[Konfiguration]] z.B. folgendes eingetragen werden:<br />
<pre><br />
define DWDweblink weblink htmlCode { DWDOD_AsHtmlH("DWD", 4, 0) }<br />
</pre><br />
<br />
Weitere Details zur Installation und Konfiguration finden sich am Ende der Datei ''DWDODweblink.pm'', die man dazu mit einem Texteditor öffnen sollte, da Weblinks nicht in der Commandref aufgeführt werden.</div>JensBhttp://wiki.fhem.de/w/index.php?title=DWD_OpenData&diff=26678DWD OpenData2018-05-11T20:12:57Z<p>JensB: </p>
<hr />
<div>{{SEITENTITEL:DWD_OpenData}}<br />
{{<br />
Infobox Modul<br />
|ModPurpose=Daten vom DWD OpenData Server abrufen<br />
|ModType=d<br />
<!-- |ModCategory= (noch?) nicht verwendet --><br />
|ModCmdRef=DWD_OpenData<br />
|ModForumArea=Unterstützende Dienste/Wettermodule<br />
|ModTechName=55_DWD_OpenData.pm<br />
|ModOwner=JensB<br />
}}<br />
<br />
Der Deutsche Wetterdienst (DWD) stellt Wetterdaten über den [https://www.dwd.de/DE/leistungen/opendata/opendata.html Open Data Server] zur Verfügung. Die Verwendung dieses Dienstes und der vom DWD zur Verf&uuml;gung gestellten Daten unterliegt den auf der OpenData Webseite beschriebenen Bedingungen. Einen Überblick über die verfügbaren Daten findet man in der Tabelle [https://www.dwd.de/DE/leistungen/opendata/help/inhalt_allgemein/opendata_content_de_en_xls.xls OpenData_weather_content.xls].<br />
<br />
<br />
== Anwendung ==<br />
Aufgrund der unterschiedlichen vom DWD bereitgestellten Datenformate benötigt das Modul zur Dekodierung je nach gewünschten Funktionsumfang zusätzliche Perl-Module, die nicht standardmäßig vorinstalliert sind und je nach Systemkonfiguration nachinstalliert werden müssen. Außerdem unterstützt das Modul Zeitzonen, um z.B. die Wettervorhersage internationaler Stationen in Ortszeit darstellen zu können. Hierfür sind je nach Systemkonfiguration weitere Einstellungen erforderlich. Auch die Sprache der Wochentage für die Wettervorhersage ist frei wählbar. Je nach Systemkonfiguration ist aber die Standardsprache u.U. auf Englisch eingestellt, was weitere Anpassungen der Systemkonfiguration erforderlich macht.<br />
<br />
=== Vorbereitung ===<br />
Im folgenden wird z.T. von einem System mit Rasbian oder Debian mit System-V Startsystem ausgegangen. Auf anderen Betriebssystemen und auf Systemen mit System-D müssen die Installationsschritte ggf. angepasst werden.<br />
<br />
<br />
1. Für die Wettervorhersage:<br />
Installation des Perl-Moduls ''Text::CSV_XS'' in Version 0.40 oder höher über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libtext-csv-xs-perl <br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
2. Für die Wetterwarnungen:<br />
Installation des Perl-Moduls ''XML::LibXML'' über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libxml-libxml-perl<br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
3. Eigener Internet-Proxy:<br />
Die Konfiguration des Proxies erfolgt z.B. durch Eintrag von<br />
<pre><br />
attr global proxy <myProxyHost>:<myProxyPort><br />
</pre> <br />
in die [[Konfiguration]], wobei ''myProxyHost'' durch den Namen oder die IP-Adresse des Proxy-Servers ersetzt werden muss und für ''myProxyPort'' der Port des Proxy-Servers eingetragen werden muss (oft 3128).<br />
<br />
<br />
4. Eigene Zeitzone:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre><br />
in die FHEM-Kommandozeile überprüfen, ob die FHEM-Uhrzeit plausibel ist. Ist dies nicht der Fall sollten die Uhrzeit auf Systemebene überprüft werden und ggf. die Systemeinstellungen angepasst werden.<br />
Ermitteln der Bezeichnung der eigenen Zeitzone über die System-Kommandozeile mit<br />
<pre><br />
tzselect<br />
</pre><br />
und diese Bezeichnung in die Datei ''/etc/timezone'' eintragen und <br />
<pre><br />
export TZ=`cat /etc/timezone`<br />
</pre><br />
der Datei ''/etc/profile'' hinzufügen und dann das System neu starten. Nun muss die Zeitanzeige in FHEM korrekt sein.<br />
<br />
<br />
5. Eigene Sprache:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre> in die FHEM-Kommandozeile überprüfen, in welcher Sprache der Wochentag angezeigt wird. Stimmt die Sprache nicht, dann auf der System-Kommandozeile<br />
<pre><br />
dpkg-reconfigure locales<br />
</pre> eingeben und aus der Liste z.B. ''de_DE.UTF-8'' zusätzlich auswählen. Mit Eingabe von <br />
<pre><br />
locale -a<br />
</pre> auf der System-Kommandozeile überprüfen, ob die ausgewählte Sprache nun zur Verfügung steht. Durch Hinzufügen von z.B.<br />
<pre><br />
export LANG=de_DE.UTF-8<br />
</pre> in die Datei ''/etc/init.d/fhem'' (irgendwo zwischen ''start'' und ''perl'') und anschließendem Neustart von FHEM wird die Sprache für FHEM eingestellt. Nun muss die Wochentagsanzeige in FHEM korrekt sein.<br />
<br />
<br />
6. Für Weblink:<br />
Installation des Perl-Moduls ''DateTime'' über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libdatetime-perl<br />
</pre> <br />
oder mit CPAN.<br />
<br />
=== Define ===<br />
siehe [https://fhem.de/commandref.html#DWD_OpenDatadefine Commandref].<br />
<br />
=== Attributes ===<br />
siehe [https://fhem.de/commandref.html#DWD_OpenDataattr Commandref].<br />
<br />
== Anwendungsbeispiele ==<br />
=== Beispiel zur Modul-Einrichtung ===<br />
<br />
* Wettervorhersage<br />
Für die Werttervorhersage muss der Stationscode ermittelt werden. Dazu [https://www.dwd.de/DE/leistungen/met_verfahren_mosmix/mosmix_stationskatalog.pdf MOSMIX Stationskatalog] herunterladen, öffnen und die gewünschte Station heraussuchen. Einen Teil der deutschen Stationen kann man auch der [https://www.dwd.de/DE/derdwd/messnetz/bodenbeobachtung/messnetzkarte_boden.pdf Bodenmessnetzkarte] entnehmen.<br />
<br />
* Wetterwarnungen<br />
Für die Wetterwarnungen muss die Warnzelle ermittelt werden. Dazu [https://www.dwd.de/DE/leistungen/opendata/help/warnungen/cap_warncellids_csv.csv Warncell-IDs Katalog] herunterladen, öffnen und die gewünschte Warnzelle heraussuchen. Unterstützt werden Gemeinden (beginnen mit 8), Landkreise (beginnen mit 1 oder 9) oder Küste (beginnen mit 5). Da zur Orientierung nur die Bezeichnungen zur Verfügung stehen, ist die Auswahl u.U. mehrdeutig und man muss ausprobieren, welche die gewünschte Warnzelle ist.<br />
<br />
Um das Modul mit Vorhersage und Wetterwarnungen zu nutzen, kann z.B. folgendes in die [[Konfiguration]] eingetragen werden:<br />
<br />
<pre><br />
define DWD DWD_OpenData<br />
attr DWD alertArea 111000000<br />
attr DWD forecastStation 99810<br />
attr DWD forecastDays 3<br />
attr DWD forecastWW2Text 1<br />
</pre><br />
<br />
Weitere Details zur Installation und Konfiguration finden sich in der [https://fhem.de/commandref.html#DWD_OpenData Commandref].<br />
<br />
=== Beispiel für die Einrichtung eines Weblinks ===<br />
Zur graphischen Darstellung der Vorhersage und der Wetterwarnungen steht ein [https://forum.fhem.de/index.php/topic,83097.msg753155.html#msg753155 Weblink] zur Verfügung.<br />
<br />
Die Datei DWDODweblink.pm herunterladen, in das Modulverzeichnis ''fhem/FHEM'' kopieren, irgendwo hinter ''package main'' in die Datei [[99_myUtils_anlegen|99_myUtils.pm]] den Eintrag<br />
<pre><br />
eval "use DWDODweblink;";<br />
</pre> hinzufügen und FHEM neu starten. Nun kann in die [[Konfiguration]] z.B. folgendes eingetragen werden:<br />
<pre><br />
define DWDweblink weblink htmlCode { DWDOD_AsHtmlH("DWD", 4, 0) }<br />
</pre><br />
<br />
Weitere Details zur Installation und Konfiguration finden sich am Ende der Datei ''DWDODweblink.pm'', die man dazu mit einem Texteditor öffnen sollte, da Weblinks nicht in der Commandref aufgeführt werden.</div>JensBhttp://wiki.fhem.de/w/index.php?title=Wetter_und_Wettervorhersagen&diff=26677Wetter und Wettervorhersagen2018-05-11T19:48:07Z<p>JensB: Gliederung der DWD-Abschnitte</p>
<hr />
<div>Wetterdaten und Wettervorhersagen können auf verschiedene Weise in FHEM eingebunden werden.<br />
<br />
== Yahoo-Wetter ==<br />
Für die einfache Einbindung des Yahoo-Wetters gibt es das spezielle Modul [[Weather]].<br />
<br />
== Unwetterzentrale ==<br />
Informationen der Seite(n) Unwetterzentrale.de können mit Hilfe des Moduls [[UWZ]] eingebunden werden.<br />
<br />
== Modul OPENWEATHER ==<br />
Das Modul [[OPENWEATHER]] extrahiert Wetterdaten über die "openweather"-Schnittstelle (API) von www.wetter.com. <br />
*Vorschau-Zeitraum: 3 Tage<br />
*Vorschau-Interval: 6:00, 11:00, 17:00, 23:00<br />
*Aktuelle Daten: keine<br />
<br />
== Modul PROPLANTA ==<br />
Das Modul [[PROPLANTA]] extrahiert Wetterdaten von der Website www.proplanta.de. (keine API)<br />
*Vorschau-Zeitraum: 12 Tage<br />
*Vorschau-Interval: 3 h<br />
*Aktuelle Daten: jede volle Stunde<br />
<br />
== Modul WWO ==<br />
Das Modul extrahiert Wetterdaten über die (alte) API von worldweatheronline.com<br />
*Vorschau-Zeitraum: ?? Tage<BR><br />
*Vorschau-Interval: ??<br><br />
*Aktuelle Daten: ??<br />
<br />
== Deutscher Wetterdienst (DWD) ==<br />
<br />
=== Modul DWD_OpenData ===<br />
Das Modul [[DWD_OpenData]] stellt einen Teil der frei verfügbaren Daten des Deutschen Wetterdienstes (DWD) bereit, die über den [https://www.dwd.de/DE/leistungen/opendata/opendata.html Open Data Server] abgerufen werden können (diverse Datenformate, keine API). <br />
*Vorschau-Zeitraum: 7 Tage<br />
*Vorschau-Interval: datenabhängig, viele mit 3 h<br />
*Vorschau-Orte: national und international<br />
*Aktuelle Daten: nicht implementiert<br />
*Wetterwarnungen: für Landkreise und Gemeinden in deutsch oder englisch<br />
<br />
Es gibt zum Modul auch einen passenden [https://forum.fhem.de/index.php/topic,83097.msg753155.html#msg753155 Weblink], der 2 Icons pro Tag in horizontaler Form darstellt. Die Anzahl der insgesamt dargestellten Icons ist konfigurierbar. Liegen Wetterwarnungen vor, wird zusätzlich ein Warnsymbol angezeigt, über das man per Klick weitere Details zur Wetterwarnung abrufen kann.<br />
<br />
[[DWD_OpenData|Weitere Details und Installationsbeschreibung]]<br />
<br />
=== Wetterwarnungen als Karte ===<br />
Der Deutsche Wetterdienst [http://www.dwd.de DWD] stellt neben diversen Wetterdaten auch Wetterwarnungen in Bildform bereit. Diese können sehr einfach via [http://fhem.de/commandref_DE.html#weblink weblink iframe] in FHEM eingebunden werden - das ist zwar nicht die schönste Form, aber die schnellste.<br />
<br />
Dazu sucht man sich zuerst auf der [http://www.dwd.de/bvbw/appmanager/bvbw/dwdwwwDesktop?_nfpb=true&_pageLabel=_dwdwww_wetter_warnungen_warnungen&T92053gsbDocumentPath=BEA__Navigation%2FWetter__Warnungen%2FWarnungen.html%3F__nnn%3Dtrue&lastPageLabel=dwdwww_wetter_warnungen Warnungsseite des DWD] die eigene Region heraus (in der Karte durchklicken). Die gewünschte URL für Berlin Stadt ist z.B. <code>http://www.dwd.de/dyn/app/ws/html/reports/BXX_warning_de.html#WS_ANCHOR_0</code>. Das Anhängsel <code>#WS_ANCHOR_0</code> kann man in der Konfiguration auch weglassen.<br />
<br />
Die Einbindung in FHEM sieht dann wie folgt aus:<br />
<pre><br />
define dwd_warnmeldung weblink iframe http://www.dwd.de/dyn/app/ws/html/reports/BXX_warning_de.html<br />
attr dwd_warnmeldung group Wetterwarnungen (DWD)<br />
attr dwd_warnmeldung htmlattr width="100%" height="300" frameborder="0" marginheight="0" marginwidth="0"<br />
attr dwd_warnmeldung room Wettervorhersage,Startseite<br />
</pre><br />
<br />
== Vorhersage-Diagramm von YR ==<br />
[http://www.yr.no YR] ist die Seite des norwegischen Wetterdiensts. Er ist zwar nur in Teilen auf Englisch (und gar nicht auf Deutsch) verfügbar, bietet aber sehr gute Wettervorhersagen - auch mit eigenen Vorhersagen für kleine Dörfer. Neben etlichen Detailinfos bietet YR eine sehr schicke 48h-Vorhersage-Grafik. Diese kann sehr einfach via [http://fhem.de/commandref_DE.html#weblink weblink iframe] in FHEM eingebunden werden.<br />
<br />
Dazu geht man auf die [http://www.yr.no Startseite von YR] und gibt in das Suchfeld den Namen seines Dörfchens ein - die Ergebnissliste kann ziemlich lang werden, sodass man evtl. sehr genau schauen muss, welches das eigene Kaff ist - bei mir war es an 29. Stelle... ;-) Auf der gewünschten Seite gibt es einen Unterpunkt "Hour by hour", wo sich die besagte Grafik findet. Hier kopiert man sich einfach die URL der Grafik.<br />
<br />
Die Einbindung in FHEM sieht dann bspw. wie folgt aus:<br />
<pre><br />
define Wetter_yr_Vorhersage weblink iframe http://www.yr.no/place/Germany/Berlin/Berlin/meteogram.png<br />
attr Wetter_yr_Vorhersage group Wettervorhersage (yr)<br />
attr Wetter_yr_Vorhersage htmlattr width="100%" height="300" frameborder="0" marginheight="0" marginwidth="0"<br />
attr Wetter_yr_Vorhersage room Wettervorhersage,Start<br />
</pre><br />
<br />
== Wetter von Weather Underground ==<br />
{{Randnotiz|RNTyp=y|RNText=Neben dem hier vorgestellten Abruf der Weather Underground-Daten mit [[HTTPMOD]] kann auf Weather Underground-Daten auch mit dem darauf spezialisierten Modul [http://fhem.de/commandref.html#Wunderground Wunderground] zugegriffen werden.}}<br />
<br />
'''Hinweis:''' Dieses Vorgehen ist etwas anspruchsvoller und somit eher für erfahrene FHEM-User geeignet.<br />
<br />
[http://www.wunderground.com/ Weather Underground] ist bietet eine sehr umfassende Sammlung aller möglichen offiziellen und privaten (aber teils sehr professionellen) Wetterstationen weltweit. Es besteht eine recht hohe Wahrscheinlichkeit, dass es in der eigenen Umgebung schon eine Wetterstation gibt. Anstatt nun selbst eine komplette Wetterstation aufzubauen, kann man alternativ auf die Daten der Nachbarstation zugreifen.<br />
<br />
Dazu sind grundsätzlich die folgenden Schritte notwendig:<br />
* Finden der geeigneten Station<br />
* Auswerten der XML-Daten<br />
* Erstellen passender gplot-Dateien<br />
<br />
=== Finden der geeigneten Station ===<br />
Als erstes geht man auf die [http://www.wunderground.com Startseite von Weather Underground] und gibt in das Suchfeld den Namen seines Dörfchens oder der nächsten Stadt ein - für Berlin landet man bspw. auf Seite für "Berlin Alexanderplatz". Es gibt aber manchmal sehr viele Wetterstationen in der direkten Umgebung. Diese findet man indem am auf "Change Station" klickt und sich eine passende Station aussucht. Nähere Infos (zB. zur verwendeten Hard- und Software) zu der gewählten Wetterstation erhält man, wenn man auf den Namen der Station klickt und dann auf "About this PWS". <br />
<br />
Weather Underground stellt die Daten der Wetterstation auch über eine API als XML bereit, die wir auswerten können. Die entsprechende URL findet sich ebenfalls unter "About this PWS" unter "Download current conditions XML". Für Berlin Prenzlauer Berg wäre dies bspw. <br />
<code>http://api.wunderground.com/weatherstation/WXDailyHistory.asp?ID=IBERLIN15&format=XML</code>.<br />
<br />
Entscheidend für die jeweilige Station ist der Teil nach "?=ID", also in diesem Fall "IBERLIN15". Dieser Teil des Links lässt sich leicht durch die ID einer anderen Station ersetzen und die Suche nach dem entsprechenden Link auf der Seite der Station bleibt erspart.<br />
<br />
=== Auswerten der XML-Daten ===<br />
Die Auswertung der XML-Daten erfolgt via [[HTTPMOD]]. Da dies nicht ganz trivial ist, sind im Folgenden zuerst die wesentlichen Konfigurationsschritte exemplarisch beschrieben. Weiter unten findet sich dann die fertige vollständige Konfiguration.<br />
<br />
Es erstes wird das Device HTTPMOD definiert (die 600 am Schluss ist der Aktualisierungszyklus in Sekunden, also alle 10 min):<br />
:<code>define wetter_prenzelberg HTTPMOD http://api.wunderground.com/weatherstation/WXCurrentObXML.asp?ID=IBERLIN15 600 </code><br />
<br />
Dann werden Attribute für alle Readings definiert:<br />
:<code>attr wetter_prenzelberg userattr readingsName_cloudiness readingsName_date ... </code><br />
<br />
Dann wird jedem Attribut ein Name zugewiesen (unter diesem Namen wird der Wert ins Log geschrieben):<br />
:<code>attr wetter_prenzelberg readingsName_cloudiness cloudiness </code><br />
<br />
Zum Schluss wird das Reading selbst definiert:<br />
:<code>attr wetter_prenzelberg readingsRegex_cloudiness cloudiness id="NN" percent="([\d\.]+) </code><br />
<br />
Die gesamte Konfiguration für alle von der API angebotenen Wetterwerte sieht dann wie folgt aus:<br />
<pre><br />
define wetter_prenzelberg HTTPMOD http://api.wunderground.com/weatherstation/WXCurrentObXML.asp?ID=IBERLIN15 600<br />
attr wetter_prenzelberg userattr readingsName_cloudiness readingsName_date readingsName_dewpointTemperature readingsName_fog readingsName_heatindex readingsName_humidity readingsName_pressure readingsName_solarRadiation readingsName_solarUV readingsName_temperature readingsName_time readingsName_windChill readingsName_windDegrees readingsName_windDirection readingsName_windGust readingsName_windSpeed readingsRegex_cloudiness readingsRegex_date readingsRegex_dewpointTemperature readingsRegex_fog readingsRegex_heatindex readingsRegex_humidity readingsRegex_pressure readingsRegex_solarRadiation readingsRegex_solarUV readingsRegex_temperature readingsRegex_time readingsRegex_windChill readingsRegex_windDegrees readingsRegex_windDirection readingsRegex_windGust readingsRegex_windSpeed<br />
attr wetter_prenzelberg readingsName_cloudiness cloudiness<br />
attr wetter_prenzelberg readingsName_date date<br />
attr wetter_prenzelberg readingsName_dewpointTemperature dewpointTemperature<br />
attr wetter_prenzelberg readingsName_fog fog<br />
attr wetter_prenzelberg readingsName_heatindex heatindex<br />
attr wetter_prenzelberg readingsName_humidity humidity<br />
attr wetter_prenzelberg readingsName_pressure pressure<br />
attr wetter_prenzelberg readingsName_solarRadiation solarRadiation<br />
attr wetter_prenzelberg readingsName_solarUV solarUV<br />
attr wetter_prenzelberg readingsName_temperature temperature<br />
attr wetter_prenzelberg readingsName_time time<br />
attr wetter_prenzelberg readingsName_windChill windChill<br />
attr wetter_prenzelberg readingsName_windDegrees windDegrees<br />
attr wetter_prenzelberg readingsName_windDirection windDirection<br />
attr wetter_prenzelberg readingsName_windGust windGust<br />
attr wetter_prenzelberg readingsName_windSpeed windSpeed<br />
attr wetter_prenzelberg readingsRegex_cloudiness cloudiness id="NN" percent="([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_date date date" content="([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_dewpointTemperature <dewpoint_c>(\+|-?[\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_fog fog id="FOG" percent="([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_heatindex <heat_index_c>(\+|-?[\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_humidity <relative_humidity>([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_pressure <pressure_mb>([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_solarRadiation <solar_radiation>([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_solarUV <UV>([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_temperature <temp_c>(\+|-?[\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_time time Zeit([\d\:]+)<br />
attr wetter_prenzelberg readingsRegex_windChill <windchill_c>(\+|-?[\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_windDegrees <wind_degrees>([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_windDirection <wind_dir>([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_windGust <wind_gust_mph>([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_windSpeed <wind_mph>([\d\.]+)<br />
</pre><br />
Hinweis: Nicht immer werden alle Werte geliefert (wenn keine Sonne, dann kein UV-Wert...). Im System-Log kann das als Fehler auftauchen, ist aber kein Problem.<br />
<br />
=== Erstellen passender gplot-Dateien ===<br />
Um die ausgelesenen Werte als Graphen darstellen zu können müssen eigene gplot-Dateien erstellt werden. Eine grundsätzliche Anleitung dazu findet sich unter [[Creating Plots]]. Deshalb sollen hier nur Beispiele für die eigentlichen gplot-Dateien vorgestellt werden. Beispiele sollten sowohl für [[FileLog]] wie [[DbLog]] funktionieren.<br />
<br />
Temperatur und Luftfeuchte:<br />
<pre><br />
set terminal png transparent size <SIZE> crop<br />
set output '<OUT>.png'<br />
set xdata time<br />
set timefmt "%Y-%m-%d_%H:%M:%S"<br />
set xlabel " "<br />
#set title '<L1>'<br />
set title ''<br />
set ytics <br />
set y2tics <br />
set grid ytics<br />
set ylabel "Temperature in C"<br />
set y2label "Humidity (%)"<br />
<br />
#FileLog 4:temperature\x3a::<br />
#FileLog 4:windChill\x3a::<br />
#FileLog 4:humidity\x3a::<br />
<br />
#DbLog <SPEC1>:temperature::<br />
#DbLog <SPEC1>:windChill::<br />
#DbLog <SPEC1>:humidity::<br />
<br />
plot "<IN>" using 1:2 axes x1y1 title 'Temperatur (C)' ls l0 lw 1.5 with lines,\<br />
"<IN>" using 1:2 axes x1y1 title 'Gefühlte Temperatur (C)' ls l1 lw 1.5 with lines,\<br />
"<IN>" using 1:2 axes x1y2 title 'Luftfeuchtigkeit (%)' ls l2fill lw 0.2 with lines<br />
</pre><br />
<br />
Wind und Windrichtung:<br />
<pre><br />
set terminal png transparent size <SIZE> crop<br />
<br />
set output '<OUT>.png'<br />
set xdata time<br />
set timefmt "%Y-%m-%d_%H:%M:%S"<br />
set xlabel " "<br />
<br />
set ytics<br />
set y2tics ("Nord" 0, "Ost" 80, "S&#252;d" 180, "West" 270, "Nord" 360)<br />
<br />
#set title '<L1>'<br />
set title ''<br />
<br />
set grid xtics ytics<br />
<br />
set yrange [0:20]<br />
set y2range [0:360]<br />
<br />
set ylabel "Wind (mph)"<br />
set y2label "Richtung"<br />
<br />
#FileLog 4:windSpeed:0:<br />
#FileLog 4:windGust:0:<br />
#FileLog 4:windDegrees:0:<br />
<br />
#DbLog <SPEC1>:windSpeed::<br />
#DbLog <SPEC1>:windGust::<br />
#DbLog <SPEC1>:windDegrees::<br />
<br />
plot "<IN>" using 1:2 axes x1y1 title 'Wind (mph)' ls l0 lw 1.5 with lines,\<br />
"<IN>" using 1:2 axes x1y1 title 'Böen (mph)' ls l1 lw 1.5 with lines,\<br />
"<IN>" using 1:2 axes x1y2 title 'Windrichtung (°)' ls l2fill lw 0.2 with points<br />
</pre><br />
<br />
Sonnenintensität und UV-Werte:<br />
<pre><br />
set terminal png transparent size <SIZE> crop<br />
<br />
set output '<OUT>.png'<br />
set xdata time<br />
set timefmt "%Y-%m-%d_%H:%M:%S"<br />
set xlabel " "<br />
<br />
set ytics<br />
set y2tics<br />
<br />
#set title '<L1>'<br />
set title ''<br />
<br />
set grid xtics ytics<br />
<br />
set ylabel "Sonnenstrahlung (W/qm)"<br />
set y2label "UV"<br />
<br />
#FileLog 4:solarRadiation:0:<br />
#FileLog 4:solarUV:0:<br />
<br />
#DbLog <SPEC1>:solarRadiation::<br />
#DbLog <SPEC1>:solarUV::<br />
<br />
plot "<IN>" using 1:2 axes x1y1 title 'Strahlung' ls l0 lw 1.5 with lines,\<br />
"<IN>" using 1:2 axes x1y1 title 'UV' ls l1 lw 1.5 with lines<br />
</pre><br />
<br />
'''Weitere TBD'''<br />
<br />
=== Vergangene Daten abfragen ===<br />
Ein konkretes vergangenes Datum der Wetterstation kann man übrigens auch abrufen - für den 28.11.2014 wäre dies bspw. <br />
<code>http://www.wunderground.com/weatherstation/WXDailyHistory.asp?ID=IBERLIN15&day=28&month=11&year=2014&graphspan=day&format=1</code>.<br />
<br />
=== Eigene Wetterdaten hochladen ===<br />
{{Randnotiz|RNTyp=g|RNText=Unterstützung für das Modul gibt es im dazugehörigen {{Link2Forum|Topic=65587|LinkText=Forumsthread }}.}}<br />
<br />
Wer eigene Wetterdaten hochladen will, kann hierzu das Modul [http://fhem.de/commandref.html#WUup WUup] verwenden. Dazu benötigt man die Zugangsdaten (stationID und Paßwort) für eine eigene Wetterstation. Mit dem Modul können die meisten vom [http://wiki.wunderground.com/index.php/PWS_-_Upload_Protocol PWS Upload Protocol] unterstützten Daten hochgeladen werden:<br />
* Winddir - [0-360 momentane Windrichtung]<br />
* Windspeedmph - [mph momentane Windgeschwindigkeit]<br />
* Windgustmph - [mph aktuellen Böe, mit Software-spezifischem Zeitraum]<br />
* Windgustdir - [0-360 mit Software-spezifischer Zeit]<br />
* Windspdmph_avg2m - [mph durchschnittliche Windgeschwindigkeit innerhalb 2 Minuten]<br />
* Winddir_avg2m - [0-360 durchschnittliche Windrichtung innerhalb 2 Minuten]<br />
* Windgustmph_10m - [mph Böen der vergangenen 10 Minuten]<br />
* Windgustdir_10m - [0-360 Richtung der Böen der letzten 10 Minuten]<br />
* Feuchtigkeit - [% Außenfeuchtigkeit 0-100%]<br />
* Dewptf- [F Taupunkt im Freien]<br />
* Tempf - [F Außentemperatur]<br />
* Rainin - [in Regen in der vergangenen Stunde]<br />
* Dailyrainin - [in Regenmenge bisher heute]<br />
* Baromin - [inHg barometrischer Druck]<br />
* Soiltempf - [F Bodentemperatur]<br />
* Bodenfeuchtigkeit - [%]<br />
* Solarradiation - [W/m²]<br />
* UV - [Index]<br />
<br />
Die Werte werden im Modul für Wunderground ins anglo-amerikanische System umgerechnet. Temperaturen werden also automatisch von °Celsius in Fahrenheit, Windgeschwindigkeiten von km/h in mph, mm in Inch und der barometrische Druck von hPa in inHg umgerechnet.<br />
<br />
== Wetternetzwerk auf wetter.com ==<br />
Ein vollständiges Beispiel zur Nutzung der Informationen über die Regenmenge (Station 1445, Weinheim) von wetter.com ist in {{Link2Forum|Topic=39600|Message=332837|LinkText=diesem Forenbeitrag}} beschrieben.<br />
<br />
== Wetter von netatmo ==<br />
Das FHEM-Modul [[netatmo]] ermöglicht den Datenimport von privaten und öffentlichen netatmo Wetterstationen. Eine Übersicht über die verfügbaren öffentlichen Stationen findet sich auf der Seite [http://www.netatmo.com/de-DE/weathermap Weathermap]. Die meisten öffentlichen Stationen liefern Temperatur, Luftfeuchte und Luftdruck, einige auch Wind, Regen und Daten zur Luftqualität (CO<sub>2</sub>).<br />
<br />
== Links ==<br />
* {{Link2Forum|Topic=33610}} mit Sammlung und Beipielen von Internet-Links für die Anzeige von teilweise animierten Wetterbildern<br />
* [http://bloglich.de/art/rpi/wetterdaten-auf-dem-raspberry-pi-in-fhem/ Beispiel in Blog(de)]<br />
* [[HTTPMOD]]<br />
<br />
[[Kategorie:Code Snippets]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Wetterstationen]] <!-- eigentlich eine "Hardware-Kategorie", passt aber trotzdem --></div>JensBhttp://wiki.fhem.de/w/index.php?title=DWD_OpenData&diff=26674DWD OpenData2018-05-11T12:58:52Z<p>JensB: </p>
<hr />
<div>{{SEITENTITEL:DWD_OpenData}}<br />
{{<br />
Infobox Modul<br />
|ModPurpose=Daten vom DWD OpenData Server abrufen<br />
|ModType=d<br />
<!-- |ModCategory= (noch?) nicht verwendet --><br />
|ModCmdRef=DWD_OpenData<br />
|ModForumArea=Unterstützende Dienste/Wettermodule<br />
|ModTechName=55_DWD_OpenData.pm<br />
|ModOwner=JensB<br />
}}<br />
<br />
Der Deutsche Wetterdienst (DWD) stellt Wetterdaten über den [https://www.dwd.de/DE/leistungen/opendata/opendata.html Open Data Server] zur Verfügung. Die Verwendung dieses Dienstes und der vom DWD zur Verf&uuml;gung gestellten Daten unterliegt den auf der OpenData Webseite beschriebenen Bedingungen. Einen Überblick über die verfügbaren Daten findet man in der Tabelle [https://www.dwd.de/DE/leistungen/opendata/help/inhalt_allgemein/opendata_content_de_en_xls.xls OpenData_weather_content.xls].<br />
<br />
<br />
== Anwendung ==<br />
Aufgrund der unterschiedlichen vom DWD bereitgestellten Datenformate benötigt das Modul zur Dekodierung je nach gewünschten Funktionsumfang zusätzliche Perl-Module, die nicht standardmäßig vorinstalliert sind und je nach Systemkonfiguration nachinstalliert werden müssen. Außerdem unterstützt das Modul Zeitzonen, um z.B. die Wettervorhersage internationaler Stationen in Ortszeit darstellen zu können. Hierfür sind je nach Systemkonfiguration weitere Einstellungen erforderlich. Auch die Sprache der Wochentage für die Wettervorhersage ist frei wählbar. Je nach Systemkonfiguration ist aber die Standardsprache u.U. auf Englisch eingestellt, was weitere Anpassungen der Systemkonfiguration erforderlich macht.<br />
<br />
=== Vorbereitung ===<br />
Im folgenden wird z.T. von einem System mit Rasbian oder Debian mit System-V Startsystem ausgegangen. Auf anderen Betriebssystemen und auf Systemen mit System-D müssen die Installationsschritte ggf. angepasst werden.<br />
<br />
<br />
1. Für die Wettervorhersage:<br />
Installation des Perl-Moduls ''Text::CSV_XS'' in Version 0.40 oder höher über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libtext-csv-xs-perl <br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
2. Für die Wetterwarnungen:<br />
Installation des Perl-Moduls ''XML::LibXML'' über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libxml-libxml-perl<br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
3. Eigener Internet-Proxy:<br />
Die Konfiguration des Proxies erfolgt z.B. durch Eintrag von<br />
<pre><br />
attr global proxy <myProxyHost>:<myProxyPort><br />
</pre> <br />
in die [[Konfiguration]], wobei ''myProxyHost'' durch den Namen oder die IP-Adresse des Proxy-Servers ersetzt werden muss und für ''myProxyPort'' der Port des Proxy-Servers eingetragen werden muss (oft 3128).<br />
<br />
<br />
4. Eigene Zeitzone:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre><br />
in die FHEM-Kommandozeile überprüfen, ob die FHEM-Uhrzeit plausibel ist. Ist dies nicht der Fall sollten die Uhrzeit auf Systemebene überprüft werden und ggf. die Systemeinstellungen angepasst werden.<br />
Ermitteln der Bezeichnung der eigenen Zeitzone über die System-Kommandozeile mit<br />
<pre><br />
tzselect<br />
</pre><br />
und diese Bezeichnung in die Datei ''/etc/timezone'' eintragen und <br />
<pre><br />
export TZ=`cat /etc/timezone`<br />
</pre><br />
der Datei ''/etc/profile'' hinzufügen und dann das System neu starten. Nun muss die Zeitanzeige in FHEM korrekt sein.<br />
<br />
<br />
5. Eigene Sprache:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre> in die FHEM-Kommandozeile überprüfen, in welcher Sprache der Wochentag angezeigt wird. Stimmt die Sprache nicht, dann auf der System-Kommandozeile<br />
<pre><br />
dpkg-reconfigure locales<br />
</pre> eingeben und aus der Liste z.B. ''de_DE.UTF-8'' zusätzlich auswählen. Mit Eingabe von <br />
<pre><br />
locale -a<br />
</pre> auf der System-Kommandozeile überprüfen, ob die ausgewählte Sprache nun zur Verfügung steht. Durch Hinzufügen von z.B.<br />
<pre><br />
export LANG=de_DE.UTF-8<br />
</pre> in die Datei ''/etc/init.d/fhem'' (irgendwo zwischen ''start'' und ''perl'') und anschließendem Neustart von FHEM wird die Sprache für FHEM eingestellt. Nun muss die Wochentagsanzeige in FHEM korrekt sein.<br />
<br />
<br />
6. Für Weblink:<br />
Installation des Perl-Moduls ''DateTime'' über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libdatetime-perl<br />
</pre> <br />
oder mit CPAN.<br />
<br />
=== Define ===<br />
siehe [https://fhem.de/commandref.html#DWD_OpenDatadefine Commandref].<br />
<br />
=== Attributes ===<br />
siehe [https://fhem.de/commandref.html#DWD_OpenDataattr Commandref].<br />
<br />
== Anwendungsbeispiele ==<br />
=== Beispiel zur Modul-Einrichtung ===<br />
<br />
* Wettervorhersage<br />
Für die Werttervorhersage muss der Stationscode ermittelt werden. Dazu [https://www.dwd.de/DE/leistungen/met_verfahren_mosmix/mosmix_stationskatalog.pdf MOSMIX Stationskatalog] herunterladen, öffnen und die gewünschte Station heraussuchen. Einen Teil der deutschen Stationen kann man auch der [https://www.dwd.de/DE/derdwd/messnetz/bodenbeobachtung/messnetzkarte_boden.pdf Bodenmessnetzkarte] entnehmen.<br />
<br />
* Wetterwarnungen<br />
Für die Wetterwarnungen muss die Warnzelle ermittelt werden. Dazu [https://www.dwd.de/DE/leistungen/opendata/help/warnungen/cap_warncellids_csv.csv Warncell-IDs Katalog] herunterladen, öffnen und die gewünschte Warnzelle heraussuchen. Unterstützt werden Gemeinden (beginnen mit 8), Landkreise (beginnen mit 1 oder 9) oder Küste (beginnen mit 5). Da zur Orientierung nur die Bezeichnungen zur Verfügung stehen, ist die Auswahl u.U. mehrdeutig und man muss ausprobieren, welche die gewünschte Warnzelle ist.<br />
<br />
Um das Modul mit Vorhersage und Wetterwarnungen zu nutzen, kann z.B. folgendes in die [[Konfiguration]] eingetragen werden:<br />
<br />
<pre><br />
define DWD DWD_OpenData<br />
attr DWD alertArea 111000000<br />
attr DWD forecastStation 99810<br />
attr DWD forecastDays 3<br />
attr DWD forecastWW2Text 1<br />
</pre><br />
<br />
Weitere Details zur Installation und Konfiguration finden sich in der [https://fhem.de/commandref.html#DWD_OpenData Commandref].<br />
<br />
=== Beispiel für die Einrichtung eines Weblinks ===<br />
Zur graphischen Darstellung der Vorhersage und der Wetterwarnungen steht ein [https://forum.fhem.de/index.php/topic,83097.msg753155.html#msg753155 Weblink] zur Verfügung.<br />
<br />
Die Datei DWDODweblink.pm herunterladen, in das Modulverzeichnis ''fhem/FHEM'' kopieren, irgendwo hinter ''package main'' in die Datei [[99_myUtils_anlegen|99_myUtils.pm]] den Eintrag<br />
<pre><br />
use DWDODweblink;<br />
</pre> hinzufügen und FHEM neu starten. Nun kann in die [[Konfiguration]] z.B. folgendes eingetragen werden:<br />
<pre><br />
define DWDweblink weblink htmlCode { DWDOD_AsHtmlH("DWD", 4, 0) }<br />
</pre><br />
<br />
Weitere Details zur Installation und Konfiguration finden sich am Ende der Datei ''DWDODweblink.pm'', die man dazu mit einem Texteditor öffnen sollte, da Weblinks nicht in der Commandref aufgeführt werden.</div>JensBhttp://wiki.fhem.de/w/index.php?title=DWD_OpenData&diff=26659DWD OpenData2018-05-10T20:53:34Z<p>JensB: </p>
<hr />
<div>{{SEITENTITEL:DWD_OpenData}}<br />
{{<br />
Infobox Modul<br />
|ModPurpose=Daten vom DWD OpenData Server abrufen<br />
|ModType=d<br />
<!-- |ModCategory= (noch?) nicht verwendet --><br />
|ModCmdRef=DWD_OpenData<br />
|ModForumArea=Unterstützende Dienste/Wettermodule<br />
|ModTechName=55_DWD_OpenData.pm<br />
|ModOwner=JensB<br />
}}<br />
<br />
Der Deutsche Wetterdienst (DWD) stellt Wetterdaten über den [https://www.dwd.de/DE/leistungen/opendata/opendata.html Open Data Server] zur Verfügung. Die Verwendung dieses Dienstes und der vom DWD zur Verf&uuml;gung gestellten Daten unterliegt den auf der OpenData Webseite beschriebenen Bedingungen. Einen Überblick über die verfügbaren Daten findet man in der Tabelle [https://www.dwd.de/DE/leistungen/opendata/help/inhalt_allgemein/opendata_content_de_en_xls.xls OpenData_weather_content.xls].<br />
<br />
<br />
== Anwendung ==<br />
Aufgrund der unterschiedlichen vom DWD bereitgestellten Datenformate benötigt das Modul zur Dekodierung je nach gewünschten Funktionsumfang zusätzliche Perl-Module, die nicht standardmäßig vorinstalliert sind und je nach Systemkonfiguration nachinstalliert werden müssen. Außerdem unterstützt das Modul Zeitzonen, um z.B. die Wettervorhersage internationaler Stationen in Ortszeit darstellen zu können. Hierfür sind je nach Systemkonfiguration weitere Einstellungen erforderlich. Auch die Sprache der Wochentage für die Wettervorhersage ist frei wählbar. Je nach Systemkonfiguration ist aber die Standardsprache u.U. auf Englisch eingestellt, was weitere Anpassungen der Systemkonfiguration erforderlich macht.<br />
<br />
=== Vorbereitung ===<br />
Im folgenden wird z.T. von einem System mit Rasbian oder Debian mit System-V Startsystem ausgegangen. Auf anderen Betriebssystemen und auf Systemen mit System-D müssen die Installationsschritte ggf. angepasst werden.<br />
<br />
<br />
1. Für die Wettervorhersage:<br />
Installation des Perl-Moduls ''Text::CSV_XS'' in Version 0.40 oder höher über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libtext-csv-xs-perl <br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
2. Für die Wetterwarnungen:<br />
Installation des Perl-Moduls ''XML::LibXML'' über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libxml-libxml-perl<br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
3. Eigener Internet-Proxy:<br />
Die Konfiguration des Proxies erfolgt z.B. durch Eintrag von<br />
<pre><br />
attr global proxy <myProxyHost>:<myProxyPort><br />
</pre> <br />
in die [[Konfiguration]], wobei ''myProxyHost'' durch den Namen oder die IP-Adresse des Proxy-Servers ersetzt werden muss und für ''myProxyPort'' der Port des Proxy-Servers eingetragen werden muss (oft 3128).<br />
<br />
<br />
4. Eigene Zeitzone:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre><br />
in die FHEM-Kommandozeile überprüfen, ob die FHEM-Uhrzeit plausibel ist. Ist dies nicht der Fall sollten die Uhrzeit auf Systemebene überprüft werden und ggf. die Systemeinstellungen angepasst werden.<br />
Ermitteln der Bezeichnung der eigenen Zeitzone über die System-Kommandozeile mit<br />
<pre><br />
tzselect<br />
</pre><br />
und diese Bezeichnung in die Datei ''/etc/timezone'' eintragen und <br />
<pre><br />
export TZ=`cat /etc/timezone`<br />
</pre><br />
der Datei ''/etc/profile'' hinzufügen und dann das System neu starten. Nun muss die Zeitanzeige in FHEM korrekt sein.<br />
<br />
<br />
5. Eigene Sprache:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre> in die FHEM-Kommandozeile überprüfen, in welcher Sprache der Wochentag angezeigt wird. Stimmt die Sprache nicht, dann auf der System-Kommandozeile<br />
<pre><br />
dpkg-reconfigure locales<br />
</pre> eingeben und aus der Liste z.B. ''de_DE.UTF-8'' zusätzlich auswählen. Mit Eingabe von <br />
<pre><br />
locale -a<br />
</pre> auf der System-Kommandozeile überprüfen, ob die ausgewählte Sprache nun zur Verfügung steht. Durch Hinzufügen von z.B.<br />
<pre><br />
export LANG=de_DE.UTF-8<br />
</pre> in die Datei ''/etc/init.d/fhem'' (irgendwo zwischen ''start'' und ''perl'') und anschließendem Neustart von FHEM wird die Sprache für FHEM eingestellt. Nun muss die Wochentagsanzeige in FHEM korrekt sein.<br />
<br />
<br />
=== Define ===<br />
siehe [https://fhem.de/commandref.html#DWD_OpenDatadefine Commandref].<br />
<br />
=== Attributes ===<br />
siehe [https://fhem.de/commandref.html#DWD_OpenDataattr Commandref].<br />
<br />
== Anwendungsbeispiele ==<br />
=== Beispiel zur Modul-Einrichtung ===<br />
<br />
* Wettervorhersage<br />
Für die Werttervorhersage muss der Stationscode ermittelt werden. Dazu [https://www.dwd.de/DE/leistungen/met_verfahren_mosmix/mosmix_stationskatalog.pdf MOSMIX Stationskatalog] herunterladen, öffnen und die gewünschte Station heraussuchen. Einen Teil der deutschen Stationen kann man auch der [https://www.dwd.de/DE/derdwd/messnetz/bodenbeobachtung/messnetzkarte_boden.pdf Bodenmessnetzkarte] entnehmen.<br />
<br />
* Wetterwarnungen<br />
Für die Wetterwarnungen muss die Warnzelle ermittelt werden. Dazu [https://www.dwd.de/DE/leistungen/opendata/help/warnungen/cap_warncellids_csv.csv Warncell-IDs Katalog] herunterladen, öffnen und die gewünschte Warnzelle heraussuchen. Unterstützt werden Gemeinden (beginnen mit 8), Landkreise (beginnen mit 1 oder 9) oder Küste (beginnen mit 5). Da zur Orientierung nur die Bezeichnungen zur Verfügung stehen, ist die Auswahl u.U. mehrdeutig und man muss ausprobieren, welche die gewünschte Warnzelle ist.<br />
<br />
Um das Modul mit Vorhersage und Wetterwarnungen zu nutzen, kann z.B. folgendes in die [[Konfiguration]] eingetragen werden:<br />
<br />
<pre><br />
define DWD DWD_OpenData<br />
attr DWD alertArea 111000000<br />
attr DWD forecastStation 99810<br />
attr DWD forecastDays 3<br />
attr DWD forecastWW2Text 1<br />
</pre><br />
<br />
Weitere Details zur Installation und Konfiguration finden sich in der [https://fhem.de/commandref.html#DWD_OpenData Commandref].<br />
<br />
=== Beispiel für die Einrichtung eines Weblinks ===<br />
Zur graphischen Darstellung der Vorhersage und der Wetterwarnungen steht ein [https://forum.fhem.de/index.php/topic,83097.msg753155.html#msg753155 Weblink] zur Verfügung.<br />
<br />
Die Datei DWDODweblink.pm herunterladen, in das Modulverzeichnis ''fhem/FHEM'' kopieren, irgendwo hinter ''package main'' in die Datei [[99_myUtils_anlegen|99_myUtils.pm]] den Eintrag<br />
<pre><br />
use DWDODweblink;<br />
</pre> hinzufügen und FHEM neu starten. Nun kann in die [[Konfiguration]] z.B. folgendes eingetragen werden:<br />
<pre><br />
define DWDweblink weblink htmlCode { DWDOD_AsHtmlH("DWD", 4, 0) }<br />
</pre><br />
<br />
Weitere Details zur Installation und Konfiguration finden sich am Ende der Datei ''DWDODweblink.pm'', die man dazu mit einem Texteditor öffnen sollte, da Weblinks nicht in der Commandref aufgeführt werden.</div>JensBhttp://wiki.fhem.de/w/index.php?title=DWD_OpenData&diff=26658DWD OpenData2018-05-10T20:02:46Z<p>JensB: DWD OpenData Installationsbeschreibung</p>
<hr />
<div>{{SEITENTITEL:DWD_OpenData}}<br />
{{<br />
Infobox Modul<br />
|ModPurpose=Daten vom DWD OpenData Server abrufen<br />
|ModType=d<br />
<!-- |ModCategory= (noch?) nicht verwendet --><br />
|ModCmdRef=DWD_OpenData<br />
|ModForumArea=Unterstützende Dienste/Wettermodule<br />
|ModTechName=55_DWD_OpenData.pm<br />
|ModOwner=JensB<br />
}}<br />
<br />
Der Deutsche Wetterdienst (DWD) stellt Wetterdaten über den [https://www.dwd.de/DE/leistungen/opendata/opendata.html Open Data Server] zur Verfügung. Die Verwendung dieses Dienstes und der vom DWD zur Verf&uuml;gung gestellten Daten unterliegt den auf der Webseite beschriebenen Bedingungen. Einen Überblick über die verfügbaren Daten findet man in der Tabelle [https://www.dwd.de/DE/leistungen/opendata/help/inhalt_allgemein/opendata_content_de_en_xls.xls OpenData_weather_content.xls].<br />
<br />
<br />
== Anwendung ==<br />
Aufgrund der unterschiedlichen vom DWD bereitgestellten Datenformate benötigt das Modul zur Dekodierung je nach gewünschten Funktionsumfang zusätzliche Perl-Module, die nicht standardmäßig vorinstalliert sind und je nach Systemkonfiguration nachinstalliert werden müssen. Außerdem unterstützt das Modul Zeitzonen, um z.B. die Wettervorhersage internationaler Stationen in Ortszeit darstellen zu können. Hierfür sind je nach Systemkonfiguration weitere Einstellungen erforderlich. Auch die Sprache der Wochentage für die Wettervorhersage ist frei wählbar. Je nach Systemkonfiguration ist aber die Standardsprache u.U. auf Englisch eingestellt, was weitere Anpassungen der Systemkonfiguration erforderlich macht.<br />
<br />
=== Vorbereitung ===<br />
Im folgenden wird z.T. von einem System mit Rasbian oder Debian mit System-V Startsystem ausgegangen. Auf anderen Betriebssystemen und auf Systemen mit System-D müssen die Installationsschritte ggf. angepasst werden.<br />
<br />
<br />
1. Für die Wettervorhersage:<br />
Installation des Perl-Moduls ''Text::CSV_XS'' in Version 0.40 oder höher über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libtext-csv-xs-perl <br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
2. Für die Wetterwarnungen:<br />
Installation des Perl-Moduls ''XML::LibXML'' über die System-Kommandozeile mit<br />
<pre><br />
sudo apt-get install libxml-libxml-perl<br />
</pre> <br />
oder mit CPAN.<br />
<br />
<br />
3. Eigener Internet-Proxy:<br />
Die Konfiguration des Proxies erfolgt z.B. durch Eintrag von<br />
<pre><br />
attr global proxy <myProxyHost>:<myProxyPort><br />
</pre> <br />
in die [[Konfiguration]], wobei ''myProxyHost'' durch den Namen oder die IP-Adresse des Proxy-Servers ersetzt werden muss und für ''myProxyPort'' der Port des Proxy-Servers eingetragen werden muss (oft 3128).<br />
<br />
<br />
4. Eigene Zeitzone:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre><br />
in die FHEM-Kommandozeile überprüfen, ob die FHEM-Uhrzeit plausibel ist. Ist dies nicht der Fall sollten die Uhrzeit auf Systemebene überprüft werden und ggf. die Systemeinstellungen angepasst werden.<br />
Ermitteln der Bezeichnung der eigenen Zeitzone über die System-Kommandozeile mit<br />
<pre><br />
tzselect<br />
</pre><br />
und diese Bezeichnung in die Datei ''/etc/timezone'' eintragen und <br />
<pre><br />
export TZ=`cat /etc/timezone`<br />
</pre><br />
der Datei ''/etc/profile'' hinzufügen und dann das System neu starten. Nun muss die Zeitanzeige in FHEM korrekt sein.<br />
<br />
<br />
5. Eigene Sprache:<br />
Durch Eingabe von <br />
<pre><br />
{localtime()}<br />
</pre> in die FHEM-Kommandozeile überprüfen, in welcher Sprache der Wochentag angezeigt wird. Stimmt die Sprache nicht, dann auf der System-Kommandozeile<br />
<pre><br />
dpkg-reconfigure locales<br />
</pre> eingeben und aus der Liste z.B. ''de_DE.UTF-8'' zusätzlich auswählen. Mit Eingabe von <br />
<pre><br />
locale -a<br />
</pre> auf der System-Kommandozeile überprüfen, ob die ausgewählte Sprache nun zur Verfügung steht. Durch Hinzufügen von z.B.<br />
<pre><br />
export LANG=de_DE.UTF-8<br />
</pre> in die Datei ''/etc/init.d/fhem'' (irgendwo zwischen ''start'' und ''perl'') und anschließendem Neustart von FHEM wird die Sprache für FHEM eingestellt. Nun muss die Wochentagsanzeige in FHEM korrekt sein.<br />
<br />
<br />
=== Define ===<br />
siehe [https://fhem.de/commandref.html#DWD_OpenDatadefine Commandref].<br />
<br />
=== Attributes ===<br />
siehe [https://fhem.de/commandref.html#DWD_OpenDataattr Commandref].<br />
<br />
== Anwendungsbeispiele ==<br />
=== Beispiel zur Modul-Einrichtung ===<br />
<br />
* Wettervorhersage<br />
Für die Werttervorhersage muss der Stationscode ermittelt werden. Dazu [https://www.dwd.de/DE/leistungen/met_verfahren_mosmix/mosmix_stationskatalog.pdf MOSMIX Stationskatalog] herunterladen, öffnen und die gewünschte Station heraussuchen. Einen Teil der deutschen Stationen kann man auch der [https://www.dwd.de/DE/derdwd/messnetz/bodenbeobachtung/messnetzkarte_boden.pdf Bodenmessnetzkarte] entnehmen.<br />
<br />
* Wetterwarnungen<br />
Für die Wetterwarnungen muss die Warnzelle ermittelt werden. Dazu [https://www.dwd.de/DE/leistungen/opendata/help/warnungen/cap_warncellids_csv.csv Warncell-IDs Katalog] herunterladen, öffnen und die gewünschte Warnzelle heraussuchen. Unterstützt werden Gemeinden (beginnen mit 8), Landkreise (beginnen mit 1 oder 9) oder Küste (beginnen mit 5). Da zur Orientierung nur die Bezeichnungen zur Verfügung stehen, ist die Auswahl u.U. mehrdeutig und man muss ausprobieren, welche die gewünschte Warnzelle ist.<br />
<br />
Um das Modul mit Vorhersage und Wetterwarnungen zu nutzen, kann z.B. folgendes in die [[Konfiguration]] eingetragen werden:<br />
<br />
<pre><br />
define DWD DWD_OpenData<br />
attr DWD alertArea 111000000<br />
attr DWD forecastStation 99810<br />
attr DWD forecastDays 3<br />
attr DWD forecastWW2Text 1<br />
</pre><br />
<br />
Weitere Details zur Installation und Konfiguration finden sich in der [https://fhem.de/commandref.html#DWD_OpenData Commandref].<br />
<br />
=== Beispiel für die Einrichtung eines Weblinks ===<br />
Zur graphischen Darstellung der Vorhersage und der Wetterwarnungen steht ein [https://forum.fhem.de/index.php/topic,83097.msg753155.html#msg753155 Weblink] zur Verfügung.<br />
<br />
Die Datei DWDODweblink.pm herunterladen, in das Modulverzeichnis ''fhem/FHEM'' kopieren, irgendwo hinter ''package main'' in die Datei [[99_myUtils_anlegen|99_myUtils.pm]] den Eintrag<br />
<pre><br />
use DWDODweblink;<br />
</pre> hinzufügen und FHEM neu starten. Nun kann in die [[Konfiguration]] z.B. folgendes eingetragen werden:<br />
<pre><br />
define DWDweblink weblink htmlCode { DWDOD_AsHtmlH("DWD", 4, 0) }<br />
</pre><br />
<br />
Weitere Details zur Installation und Konfiguration finden sich am Ende der Datei ''DWDODweblink.pm'', die man dazu mit einem Texteditor öffnen sollte, da Weblinks nicht in der Commandref aufgeführt werden.</div>JensBhttp://wiki.fhem.de/w/index.php?title=Wetter_und_Wettervorhersagen&diff=26657Wetter und Wettervorhersagen2018-05-10T19:32:48Z<p>JensB: Wetterwarnungen und Verweise auf Installationsbeschreibung</p>
<hr />
<div>Wetterdaten und Wettervorhersagen können auf verschiedene Weise in FHEM eingebunden werden.<br />
<br />
== Yahoo-Wetter ==<br />
Für die einfache Einbindung des Yahoo-Wetters gibt es das spezielle Modul [[Weather]].<br />
<br />
== Unwetterzentrale ==<br />
Informationen der Seite(n) Unwetterzentrale.de können mit Hilfe des Moduls [[UWZ]] eingebunden werden.<br />
<br />
== Modul OPENWEATHER ==<br />
Das Modul [[OPENWEATHER]] extrahiert Wetterdaten über die "openweather"-Schnittstelle (API) von www.wetter.com. <br />
*Vorschau-Zeitraum: 3 Tage<br />
*Vorschau-Interval: 6:00, 11:00, 17:00, 23:00<br />
*Aktuelle Daten: keine<br />
<br />
== Modul PROPLANTA ==<br />
Das Modul [[PROPLANTA]] extrahiert Wetterdaten von der Website www.proplanta.de. (keine API)<br />
*Vorschau-Zeitraum: 12 Tage<br />
*Vorschau-Interval: 3 h<br />
*Aktuelle Daten: jede volle Stunde<br />
<br />
== Modul WWO ==<br />
Das Modul extrahiert Wetterdaten über die (alte) API von worldweatheronline.com<br />
*Vorschau-Zeitraum: ?? Tage<BR><br />
*Vorschau-Interval: ??<br><br />
*Aktuelle Daten: ??<br />
<br />
== Modul DWD_OpenData ==<br />
Das Modul [https://forum.fhem.de/index.php/topic,83097.msg753155.html#msg753155 DWD_OpenData] stellt einen Teil der frei verfügbaren Daten des Deutschen Wetterdienstes (DWD) bereit, die über den [https://www.dwd.de/DE/leistungen/opendata/opendata.html Open Data Server] abgerufen werden können (diverse Datenformate, keine API). <br />
*Vorschau-Zeitraum: 7 Tage<br />
*Vorschau-Interval: datenabhängig, viele mit 3 h<br />
*Vorschau-Orte: national und international<br />
*Aktuelle Daten: nicht implementiert<br />
*Wetterwarnungen: für Landkreise und Gemeinden in deutsch oder englisch<br />
<br />
Es gibt zum Modul auch einen passenden [https://forum.fhem.de/index.php/topic,83097.msg753155.html#msg753155 Weblink], der 2 Icons pro Tag in horizontaler Form darstellt. Die Anzahl der insgesamt dargestellten Icons ist konfigurierbar. Liegen Wetterwarnungen vor, wird zusätzlich ein Warnsymbol angezeigt, über das man per Klick weitere Details zur Wetterwarnung abrufen kann.<br />
<br />
[[DWD_OpenData|Weitere Details und Installationsbeschreibung]]<br />
<br />
== Wetterwarnungen des DWD ==<br />
Der Deutsche Wetterdienst [http://www.dwd.de DWD] stellt neben diversen Wetterdaten auch Wetterwarnungen in Bildform bereit. Diese können sehr einfach via [http://fhem.de/commandref_DE.html#weblink weblink iframe] in FHEM eingebunden werden - das ist zwar nicht die schönste Form, aber die schnellste.<br />
<br />
Dazu sucht man sich zuerst auf der [http://www.dwd.de/bvbw/appmanager/bvbw/dwdwwwDesktop?_nfpb=true&_pageLabel=_dwdwww_wetter_warnungen_warnungen&T92053gsbDocumentPath=BEA__Navigation%2FWetter__Warnungen%2FWarnungen.html%3F__nnn%3Dtrue&lastPageLabel=dwdwww_wetter_warnungen Warnungsseite des DWD] die eigene Region heraus (in der Karte durchklicken). Die gewünschte URL für Berlin Stadt ist z.B. <code>http://www.dwd.de/dyn/app/ws/html/reports/BXX_warning_de.html#WS_ANCHOR_0</code>. Das Anhängsel <code>#WS_ANCHOR_0</code> kann man in der Konfiguration auch weglassen.<br />
<br />
Die Einbindung in FHEM sieht dann wie folgt aus:<br />
<pre><br />
define dwd_warnmeldung weblink iframe http://www.dwd.de/dyn/app/ws/html/reports/BXX_warning_de.html<br />
attr dwd_warnmeldung group Wetterwarnungen (DWD)<br />
attr dwd_warnmeldung htmlattr width="100%" height="300" frameborder="0" marginheight="0" marginwidth="0"<br />
attr dwd_warnmeldung room Wettervorhersage,Startseite<br />
</pre><br />
<br />
== Vorhersage-Diagramm von YR ==<br />
[http://www.yr.no YR] ist die Seite des norwegischen Wetterdiensts. Er ist zwar nur in Teilen auf Englisch (und gar nicht auf Deutsch) verfügbar, bietet aber sehr gute Wettervorhersagen - auch mit eigenen Vorhersagen für kleine Dörfer. Neben etlichen Detailinfos bietet YR eine sehr schicke 48h-Vorhersage-Grafik. Diese kann sehr einfach via [http://fhem.de/commandref_DE.html#weblink weblink iframe] in FHEM eingebunden werden.<br />
<br />
Dazu geht man auf die [http://www.yr.no Startseite von YR] und gibt in das Suchfeld den Namen seines Dörfchens ein - die Ergebnissliste kann ziemlich lang werden, sodass man evtl. sehr genau schauen muss, welches das eigene Kaff ist - bei mir war es an 29. Stelle... ;-) Auf der gewünschten Seite gibt es einen Unterpunkt "Hour by hour", wo sich die besagte Grafik findet. Hier kopiert man sich einfach die URL der Grafik.<br />
<br />
Die Einbindung in FHEM sieht dann bspw. wie folgt aus:<br />
<pre><br />
define Wetter_yr_Vorhersage weblink iframe http://www.yr.no/place/Germany/Berlin/Berlin/meteogram.png<br />
attr Wetter_yr_Vorhersage group Wettervorhersage (yr)<br />
attr Wetter_yr_Vorhersage htmlattr width="100%" height="300" frameborder="0" marginheight="0" marginwidth="0"<br />
attr Wetter_yr_Vorhersage room Wettervorhersage,Start<br />
</pre><br />
<br />
== Wetter von Weather Underground ==<br />
{{Randnotiz|RNTyp=y|RNText=Neben dem hier vorgestellten Abruf der Weather Underground-Daten mit [[HTTPMOD]] kann auf Weather Underground-Daten auch mit dem darauf spezialisierten Modul [http://fhem.de/commandref.html#Wunderground Wunderground] zugegriffen werden.}}<br />
<br />
'''Hinweis:''' Dieses Vorgehen ist etwas anspruchsvoller und somit eher für erfahrene FHEM-User geeignet.<br />
<br />
[http://www.wunderground.com/ Weather Underground] ist bietet eine sehr umfassende Sammlung aller möglichen offiziellen und privaten (aber teils sehr professionellen) Wetterstationen weltweit. Es besteht eine recht hohe Wahrscheinlichkeit, dass es in der eigenen Umgebung schon eine Wetterstation gibt. Anstatt nun selbst eine komplette Wetterstation aufzubauen, kann man alternativ auf die Daten der Nachbarstation zugreifen.<br />
<br />
Dazu sind grundsätzlich die folgenden Schritte notwendig:<br />
* Finden der geeigneten Station<br />
* Auswerten der XML-Daten<br />
* Erstellen passender gplot-Dateien<br />
<br />
=== Finden der geeigneten Station ===<br />
Als erstes geht man auf die [http://www.wunderground.com Startseite von Weather Underground] und gibt in das Suchfeld den Namen seines Dörfchens oder der nächsten Stadt ein - für Berlin landet man bspw. auf Seite für "Berlin Alexanderplatz". Es gibt aber manchmal sehr viele Wetterstationen in der direkten Umgebung. Diese findet man indem am auf "Change Station" klickt und sich eine passende Station aussucht. Nähere Infos (zB. zur verwendeten Hard- und Software) zu der gewählten Wetterstation erhält man, wenn man auf den Namen der Station klickt und dann auf "About this PWS". <br />
<br />
Weather Underground stellt die Daten der Wetterstation auch über eine API als XML bereit, die wir auswerten können. Die entsprechende URL findet sich ebenfalls unter "About this PWS" unter "Download current conditions XML". Für Berlin Prenzlauer Berg wäre dies bspw. <br />
<code>http://api.wunderground.com/weatherstation/WXDailyHistory.asp?ID=IBERLIN15&format=XML</code>.<br />
<br />
Entscheidend für die jeweilige Station ist der Teil nach "?=ID", also in diesem Fall "IBERLIN15". Dieser Teil des Links lässt sich leicht durch die ID einer anderen Station ersetzen und die Suche nach dem entsprechenden Link auf der Seite der Station bleibt erspart.<br />
<br />
=== Auswerten der XML-Daten ===<br />
Die Auswertung der XML-Daten erfolgt via [[HTTPMOD]]. Da dies nicht ganz trivial ist, sind im Folgenden zuerst die wesentlichen Konfigurationsschritte exemplarisch beschrieben. Weiter unten findet sich dann die fertige vollständige Konfiguration.<br />
<br />
Es erstes wird das Device HTTPMOD definiert (die 600 am Schluss ist der Aktualisierungszyklus in Sekunden, also alle 10 min):<br />
:<code>define wetter_prenzelberg HTTPMOD http://api.wunderground.com/weatherstation/WXCurrentObXML.asp?ID=IBERLIN15 600 </code><br />
<br />
Dann werden Attribute für alle Readings definiert:<br />
:<code>attr wetter_prenzelberg userattr readingsName_cloudiness readingsName_date ... </code><br />
<br />
Dann wird jedem Attribut ein Name zugewiesen (unter diesem Namen wird der Wert ins Log geschrieben):<br />
:<code>attr wetter_prenzelberg readingsName_cloudiness cloudiness </code><br />
<br />
Zum Schluss wird das Reading selbst definiert:<br />
:<code>attr wetter_prenzelberg readingsRegex_cloudiness cloudiness id="NN" percent="([\d\.]+) </code><br />
<br />
Die gesamte Konfiguration für alle von der API angebotenen Wetterwerte sieht dann wie folgt aus:<br />
<pre><br />
define wetter_prenzelberg HTTPMOD http://api.wunderground.com/weatherstation/WXCurrentObXML.asp?ID=IBERLIN15 600<br />
attr wetter_prenzelberg userattr readingsName_cloudiness readingsName_date readingsName_dewpointTemperature readingsName_fog readingsName_heatindex readingsName_humidity readingsName_pressure readingsName_solarRadiation readingsName_solarUV readingsName_temperature readingsName_time readingsName_windChill readingsName_windDegrees readingsName_windDirection readingsName_windGust readingsName_windSpeed readingsRegex_cloudiness readingsRegex_date readingsRegex_dewpointTemperature readingsRegex_fog readingsRegex_heatindex readingsRegex_humidity readingsRegex_pressure readingsRegex_solarRadiation readingsRegex_solarUV readingsRegex_temperature readingsRegex_time readingsRegex_windChill readingsRegex_windDegrees readingsRegex_windDirection readingsRegex_windGust readingsRegex_windSpeed<br />
attr wetter_prenzelberg readingsName_cloudiness cloudiness<br />
attr wetter_prenzelberg readingsName_date date<br />
attr wetter_prenzelberg readingsName_dewpointTemperature dewpointTemperature<br />
attr wetter_prenzelberg readingsName_fog fog<br />
attr wetter_prenzelberg readingsName_heatindex heatindex<br />
attr wetter_prenzelberg readingsName_humidity humidity<br />
attr wetter_prenzelberg readingsName_pressure pressure<br />
attr wetter_prenzelberg readingsName_solarRadiation solarRadiation<br />
attr wetter_prenzelberg readingsName_solarUV solarUV<br />
attr wetter_prenzelberg readingsName_temperature temperature<br />
attr wetter_prenzelberg readingsName_time time<br />
attr wetter_prenzelberg readingsName_windChill windChill<br />
attr wetter_prenzelberg readingsName_windDegrees windDegrees<br />
attr wetter_prenzelberg readingsName_windDirection windDirection<br />
attr wetter_prenzelberg readingsName_windGust windGust<br />
attr wetter_prenzelberg readingsName_windSpeed windSpeed<br />
attr wetter_prenzelberg readingsRegex_cloudiness cloudiness id="NN" percent="([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_date date date" content="([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_dewpointTemperature <dewpoint_c>(\+|-?[\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_fog fog id="FOG" percent="([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_heatindex <heat_index_c>(\+|-?[\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_humidity <relative_humidity>([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_pressure <pressure_mb>([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_solarRadiation <solar_radiation>([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_solarUV <UV>([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_temperature <temp_c>(\+|-?[\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_time time Zeit([\d\:]+)<br />
attr wetter_prenzelberg readingsRegex_windChill <windchill_c>(\+|-?[\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_windDegrees <wind_degrees>([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_windDirection <wind_dir>([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_windGust <wind_gust_mph>([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_windSpeed <wind_mph>([\d\.]+)<br />
</pre><br />
Hinweis: Nicht immer werden alle Werte geliefert (wenn keine Sonne, dann kein UV-Wert...). Im System-Log kann das als Fehler auftauchen, ist aber kein Problem.<br />
<br />
=== Erstellen passender gplot-Dateien ===<br />
Um die ausgelesenen Werte als Graphen darstellen zu können müssen eigene gplot-Dateien erstellt werden. Eine grundsätzliche Anleitung dazu findet sich unter [[Creating Plots]]. Deshalb sollen hier nur Beispiele für die eigentlichen gplot-Dateien vorgestellt werden. Beispiele sollten sowohl für [[FileLog]] wie [[DbLog]] funktionieren.<br />
<br />
Temperatur und Luftfeuchte:<br />
<pre><br />
set terminal png transparent size <SIZE> crop<br />
set output '<OUT>.png'<br />
set xdata time<br />
set timefmt "%Y-%m-%d_%H:%M:%S"<br />
set xlabel " "<br />
#set title '<L1>'<br />
set title ''<br />
set ytics <br />
set y2tics <br />
set grid ytics<br />
set ylabel "Temperature in C"<br />
set y2label "Humidity (%)"<br />
<br />
#FileLog 4:temperature\x3a::<br />
#FileLog 4:windChill\x3a::<br />
#FileLog 4:humidity\x3a::<br />
<br />
#DbLog <SPEC1>:temperature::<br />
#DbLog <SPEC1>:windChill::<br />
#DbLog <SPEC1>:humidity::<br />
<br />
plot "<IN>" using 1:2 axes x1y1 title 'Temperatur (C)' ls l0 lw 1.5 with lines,\<br />
"<IN>" using 1:2 axes x1y1 title 'Gefühlte Temperatur (C)' ls l1 lw 1.5 with lines,\<br />
"<IN>" using 1:2 axes x1y2 title 'Luftfeuchtigkeit (%)' ls l2fill lw 0.2 with lines<br />
</pre><br />
<br />
Wind und Windrichtung:<br />
<pre><br />
set terminal png transparent size <SIZE> crop<br />
<br />
set output '<OUT>.png'<br />
set xdata time<br />
set timefmt "%Y-%m-%d_%H:%M:%S"<br />
set xlabel " "<br />
<br />
set ytics<br />
set y2tics ("Nord" 0, "Ost" 80, "S&#252;d" 180, "West" 270, "Nord" 360)<br />
<br />
#set title '<L1>'<br />
set title ''<br />
<br />
set grid xtics ytics<br />
<br />
set yrange [0:20]<br />
set y2range [0:360]<br />
<br />
set ylabel "Wind (mph)"<br />
set y2label "Richtung"<br />
<br />
#FileLog 4:windSpeed:0:<br />
#FileLog 4:windGust:0:<br />
#FileLog 4:windDegrees:0:<br />
<br />
#DbLog <SPEC1>:windSpeed::<br />
#DbLog <SPEC1>:windGust::<br />
#DbLog <SPEC1>:windDegrees::<br />
<br />
plot "<IN>" using 1:2 axes x1y1 title 'Wind (mph)' ls l0 lw 1.5 with lines,\<br />
"<IN>" using 1:2 axes x1y1 title 'Böen (mph)' ls l1 lw 1.5 with lines,\<br />
"<IN>" using 1:2 axes x1y2 title 'Windrichtung (°)' ls l2fill lw 0.2 with points<br />
</pre><br />
<br />
Sonnenintensität und UV-Werte:<br />
<pre><br />
set terminal png transparent size <SIZE> crop<br />
<br />
set output '<OUT>.png'<br />
set xdata time<br />
set timefmt "%Y-%m-%d_%H:%M:%S"<br />
set xlabel " "<br />
<br />
set ytics<br />
set y2tics<br />
<br />
#set title '<L1>'<br />
set title ''<br />
<br />
set grid xtics ytics<br />
<br />
set ylabel "Sonnenstrahlung (W/qm)"<br />
set y2label "UV"<br />
<br />
#FileLog 4:solarRadiation:0:<br />
#FileLog 4:solarUV:0:<br />
<br />
#DbLog <SPEC1>:solarRadiation::<br />
#DbLog <SPEC1>:solarUV::<br />
<br />
plot "<IN>" using 1:2 axes x1y1 title 'Strahlung' ls l0 lw 1.5 with lines,\<br />
"<IN>" using 1:2 axes x1y1 title 'UV' ls l1 lw 1.5 with lines<br />
</pre><br />
<br />
'''Weitere TBD'''<br />
<br />
=== Vergangene Daten abfragen ===<br />
Ein konkretes vergangenes Datum der Wetterstation kann man übrigens auch abrufen - für den 28.11.2014 wäre dies bspw. <br />
<code>http://www.wunderground.com/weatherstation/WXDailyHistory.asp?ID=IBERLIN15&day=28&month=11&year=2014&graphspan=day&format=1</code>.<br />
<br />
=== Eigene Wetterdaten hochladen ===<br />
{{Randnotiz|RNTyp=g|RNText=Unterstützung für das Modul gibt es im dazugehörigen {{Link2Forum|Topic=65587|LinkText=Forumsthread }}.}}<br />
<br />
Wer eigene Wetterdaten hochladen will, kann hierzu das Modul [http://fhem.de/commandref.html#WUup WUup] verwenden. Dazu benötigt man die Zugangsdaten (stationID und Paßwort) für eine eigene Wetterstation. Mit dem Modul können die meisten vom [http://wiki.wunderground.com/index.php/PWS_-_Upload_Protocol PWS Upload Protocol] unterstützten Daten hochgeladen werden:<br />
* Winddir - [0-360 momentane Windrichtung]<br />
* Windspeedmph - [mph momentane Windgeschwindigkeit]<br />
* Windgustmph - [mph aktuellen Böe, mit Software-spezifischem Zeitraum]<br />
* Windgustdir - [0-360 mit Software-spezifischer Zeit]<br />
* Windspdmph_avg2m - [mph durchschnittliche Windgeschwindigkeit innerhalb 2 Minuten]<br />
* Winddir_avg2m - [0-360 durchschnittliche Windrichtung innerhalb 2 Minuten]<br />
* Windgustmph_10m - [mph Böen der vergangenen 10 Minuten]<br />
* Windgustdir_10m - [0-360 Richtung der Böen der letzten 10 Minuten]<br />
* Feuchtigkeit - [% Außenfeuchtigkeit 0-100%]<br />
* Dewptf- [F Taupunkt im Freien]<br />
* Tempf - [F Außentemperatur]<br />
* Rainin - [in Regen in der vergangenen Stunde]<br />
* Dailyrainin - [in Regenmenge bisher heute]<br />
* Baromin - [inHg barometrischer Druck]<br />
* Soiltempf - [F Bodentemperatur]<br />
* Bodenfeuchtigkeit - [%]<br />
* Solarradiation - [W/m²]<br />
* UV - [Index]<br />
<br />
Die Werte werden im Modul für Wunderground ins anglo-amerikanische System umgerechnet. Temperaturen werden also automatisch von °Celsius in Fahrenheit, Windgeschwindigkeiten von km/h in mph, mm in Inch und der barometrische Druck von hPa in inHg umgerechnet.<br />
<br />
== Wetternetzwerk auf wetter.com ==<br />
Ein vollständiges Beispiel zur Nutzung der Informationen über die Regenmenge (Station 1445, Weinheim) von wetter.com ist in {{Link2Forum|Topic=39600|Message=332837|LinkText=diesem Forenbeitrag}} beschrieben.<br />
<br />
== Wetter von netatmo ==<br />
Das FHEM-Modul [[netatmo]] ermöglicht den Datenimport von privaten und öffentlichen netatmo Wetterstationen. Eine Übersicht über die verfügbaren öffentlichen Stationen findet sich auf der Seite [http://www.netatmo.com/de-DE/weathermap Weathermap]. Die meisten öffentlichen Stationen liefern Temperatur, Luftfeuchte und Luftdruck, einige auch Wind, Regen und Daten zur Luftqualität (CO<sub>2</sub>).<br />
<br />
== Links ==<br />
* {{Link2Forum|Topic=33610}} mit Sammlung und Beipielen von Internet-Links für die Anzeige von teilweise animierten Wetterbildern<br />
* [http://bloglich.de/art/rpi/wetterdaten-auf-dem-raspberry-pi-in-fhem/ Beispiel in Blog(de)]<br />
* [[HTTPMOD]]<br />
<br />
[[Kategorie:Code Snippets]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Wetterstationen]] <!-- eigentlich eine "Hardware-Kategorie", passt aber trotzdem --></div>JensBhttp://wiki.fhem.de/w/index.php?title=Wetter_und_Wettervorhersagen&diff=25886Wetter und Wettervorhersagen2018-03-10T21:58:40Z<p>JensB: Modul für DWD Open Data Server hinzugefügt, Verweis auf GDS Modul entfernt</p>
<hr />
<div>Wetterdaten und Wettervorhersagen können auf verschiedene Weise in FHEM eingebunden werden.<br />
<br />
== Yahoo-Wetter ==<br />
Für die einfache Einbindung des Yahoo-Wetters gibt es das spezielle Modul [[Weather]].<br />
<br />
== Unwetterzentrale ==<br />
Informationen der Seite(n) Unwetterzentrale.de können mit Hilfe des Moduls [[UWZ]] eingebunden werden.<br />
<br />
== Modul OPENWEATHER ==<br />
Das Modul [[OPENWEATHER]] extrahiert Wetterdaten über die "openweather"-Schnittstelle (API) von www.wetter.com. <br />
*Vorschau-Zeitraum: 3 Tage<br />
*Vorschau-Interval: 6:00, 11:00, 17:00, 23:00<br />
*Aktuelle Daten: keine<br />
<br />
== Modul PROPLANTA ==<br />
Das Modul [[PROPLANTA]] extrahiert Wetterdaten von der Website www.proplanta.de. (keine API)<br />
*Vorschau-Zeitraum: 12 Tage<br />
*Vorschau-Interval: 3 h<br />
*Aktuelle Daten: jede volle Stunde<br />
<br />
== Modul WWO ==<br />
Das Modul extrahiert Wetterdaten über die (alte) API von worldweatheronline.com<br />
*Vorschau-Zeitraum: ?? Tage<BR><br />
*Vorschau-Interval: ??<br><br />
*Aktuelle Daten: ??<br />
<br />
== Modul DWD_OpenData ==<br />
Das Modul [https://forum.fhem.de/index.php/topic,83097.msg753155.html#msg753155 DWD_OpenData] bereitet Wetterdaten des DWD auf, die über den [https://www.dwd.de/DE/leistungen/opendata/opendata.html Open Data Server] bereitgestellt werden (diverse Datenformate, keine API). <br />
*Vorschau-Zeitraum: 7 Tage<br />
*Vorschau-Interval: datenabhängig, viele mit 3 h<br />
*Vorschau-Orte: national und international<br />
*Aktuelle Daten: nicht implementiert<br />
<br />
Das Modul unterstützt Zeitzonen, um z.B. internationale Stationen in Ortszeit darstellen zu können. <br />
<br />
Die Installation wird in der Modulhilfe beschrieben. Zum Lesen der Modulhilfe nach dem Download des Moduls in das Unterverzeichnis ''FHEM'' im Verzeichnis ''fhem'' auf der Kommandozeile "contrib/commandref_join.pl" ausführen. <br />
<br />
Es gibt zum Modul auch einen passenden Weblink, der 2 Icons pro Tag in horizontaler Form darstellt. Die Anzahl der dargestellten Icons ist konfigurierbar. Zur Installation des Weblinks die Datei [https://forum.fhem.de/index.php/topic,83097.msg753155.html#msg753155 DWDODweblink.pm] mit einem Texteditor öffnen und die Beschreibung am Ende der Datei lesen.<br />
<br />
== Wetterwarnungen des DWD ==<br />
Der Deutsche Wetterdienst [http://www.dwd.de DWD] stellt neben diversen Wetterdaten auch Wetterwarnungen in Bildform bereit. Diese können sehr einfach via [http://fhem.de/commandref_DE.html#weblink weblink iframe] in FHEM eingebunden werden - das ist zwar nicht die schönste Form, aber die schnellste.<br />
<br />
Dazu sucht man sich zuerst auf der [http://www.dwd.de/bvbw/appmanager/bvbw/dwdwwwDesktop?_nfpb=true&_pageLabel=_dwdwww_wetter_warnungen_warnungen&T92053gsbDocumentPath=BEA__Navigation%2FWetter__Warnungen%2FWarnungen.html%3F__nnn%3Dtrue&lastPageLabel=dwdwww_wetter_warnungen Warnungsseite des DWD] die eigene Region heraus (in der Karte durchklicken). Die gewünschte URL für Berlin Stadt ist z.B. <code>http://www.dwd.de/dyn/app/ws/html/reports/BXX_warning_de.html#WS_ANCHOR_0</code>. Das Anhängsel <code>#WS_ANCHOR_0</code> kann man in der Konfiguration auch weglassen.<br />
<br />
Die Einbindung in FHEM sieht dann wie folgt aus:<br />
<pre><br />
define dwd_warnmeldung weblink iframe http://www.dwd.de/dyn/app/ws/html/reports/BXX_warning_de.html<br />
attr dwd_warnmeldung group Wetterwarnungen (DWD)<br />
attr dwd_warnmeldung htmlattr width="100%" height="300" frameborder="0" marginheight="0" marginwidth="0"<br />
attr dwd_warnmeldung room Wettervorhersage,Startseite<br />
</pre><br />
<br />
== Vorhersage-Diagramm von YR ==<br />
[http://www.yr.no YR] ist die Seite des norwegischen Wetterdiensts. Er ist zwar nur in Teilen auf Englisch (und gar nicht auf Deutsch) verfügbar, bietet aber sehr gute Wettervorhersagen - auch mit eigenen Vorhersagen für kleine Dörfer. Neben etlichen Detailinfos bietet YR eine sehr schicke 48h-Vorhersage-Grafik. Diese kann sehr einfach via [http://fhem.de/commandref_DE.html#weblink weblink iframe] in FHEM eingebunden werden.<br />
<br />
Dazu geht man auf die [http://www.yr.no Startseite von YR] und gibt in das Suchfeld den Namen seines Dörfchens ein - die Ergebnissliste kann ziemlich lang werden, sodass man evtl. sehr genau schauen muss, welches das eigene Kaff ist - bei mir war es an 29. Stelle... ;-) Auf der gewünschten Seite gibt es einen Unterpunkt "Hour by hour", wo sich die besagte Grafik findet. Hier kopiert man sich einfach die URL der Grafik.<br />
<br />
Die Einbindung in FHEM sieht dann bspw. wie folgt aus:<br />
<pre><br />
define Wetter_yr_Vorhersage weblink iframe http://www.yr.no/place/Germany/Berlin/Berlin/meteogram.png<br />
attr Wetter_yr_Vorhersage group Wettervorhersage (yr)<br />
attr Wetter_yr_Vorhersage htmlattr width="100%" height="300" frameborder="0" marginheight="0" marginwidth="0"<br />
attr Wetter_yr_Vorhersage room Wettervorhersage,Start<br />
</pre><br />
<br />
== Wetter von Weather Underground ==<br />
{{Randnotiz|RNTyp=y|RNText=Neben dem hier vorgestellten Abruf der Weather Underground-Daten mit [[HTTPMOD]] kann auf Weather Underground-Daten auch mit dem darauf spezialisierten Modul [http://fhem.de/commandref.html#Wunderground Wunderground] zugegriffen werden.}}<br />
<br />
'''Hinweis:''' Dieses Vorgehen ist etwas anspruchsvoller und somit eher für erfahrene FHEM-User geeignet.<br />
<br />
[http://www.wunderground.com/ Weather Underground] ist bietet eine sehr umfassende Sammlung aller möglichen offiziellen und privaten (aber teils sehr professionellen) Wetterstationen weltweit. Es besteht eine recht hohe Wahrscheinlichkeit, dass es in der eigenen Umgebung schon eine Wetterstation gibt. Anstatt nun selbst eine komplette Wetterstation aufzubauen, kann man alternativ auf die Daten der Nachbarstation zugreifen.<br />
<br />
Dazu sind grundsätzlich die folgenden Schritte notwendig:<br />
* Finden der geeigneten Station<br />
* Auswerten der XML-Daten<br />
* Erstellen passender gplot-Dateien<br />
<br />
=== Finden der geeigneten Station ===<br />
Als erstes geht man auf die [http://www.wunderground.com Startseite von Weather Underground] und gibt in das Suchfeld den Namen seines Dörfchens oder der nächsten Stadt ein - für Berlin landet man bspw. auf Seite für "Berlin Alexanderplatz". Es gibt aber manchmal sehr viele Wetterstationen in der direkten Umgebung. Diese findet man indem am auf "Change Station" klickt und sich eine passende Station aussucht. Nähere Infos (zB. zur verwendeten Hard- und Software) zu der gewählten Wetterstation erhält man, wenn man auf den Namen der Station klickt und dann auf "About this PWS". <br />
<br />
Weather Underground stellt die Daten der Wetterstation auch über eine API als XML bereit, die wir auswerten können. Die entsprechende URL findet sich ebenfalls unter "About this PWS" unter "Download current conditions XML". Für Berlin Prenzlauer Berg wäre dies bspw. <br />
<code>http://api.wunderground.com/weatherstation/WXDailyHistory.asp?ID=IBERLIN15&format=XML</code>.<br />
<br />
Entscheidend für die jeweilige Station ist der Teil nach "?=ID", also in diesem Fall "IBERLIN15". Dieser Teil des Links lässt sich leicht durch die ID einer anderen Station ersetzen und die Suche nach dem entsprechenden Link auf der Seite der Station bleibt erspart.<br />
<br />
=== Auswerten der XML-Daten ===<br />
Die Auswertung der XML-Daten erfolgt via [[HTTPMOD]]. Da dies nicht ganz trivial ist, sind im Folgenden zuerst die wesentlichen Konfigurationsschritte exemplarisch beschrieben. Weiter unten findet sich dann die fertige vollständige Konfiguration.<br />
<br />
Es erstes wird das Device HTTPMOD definiert (die 600 am Schluss ist der Aktualisierungszyklus in Sekunden, also alle 10 min):<br />
:<code>define wetter_prenzelberg HTTPMOD http://api.wunderground.com/weatherstation/WXCurrentObXML.asp?ID=IBERLIN15 600 </code><br />
<br />
Dann werden Attribute für alle Readings definiert:<br />
:<code>attr wetter_prenzelberg userattr readingsName_cloudiness readingsName_date ... </code><br />
<br />
Dann wird jedem Attribut ein Name zugewiesen (unter diesem Namen wird der Wert ins Log geschrieben):<br />
:<code>attr wetter_prenzelberg readingsName_cloudiness cloudiness </code><br />
<br />
Zum Schluss wird das Reading selbst definiert:<br />
:<code>attr wetter_prenzelberg readingsRegex_cloudiness cloudiness id="NN" percent="([\d\.]+) </code><br />
<br />
Die gesamte Konfiguration für alle von der API angebotenen Wetterwerte sieht dann wie folgt aus:<br />
<pre><br />
define wetter_prenzelberg HTTPMOD http://api.wunderground.com/weatherstation/WXCurrentObXML.asp?ID=IBERLIN15 600<br />
attr wetter_prenzelberg userattr readingsName_cloudiness readingsName_date readingsName_dewpointTemperature readingsName_fog readingsName_heatindex readingsName_humidity readingsName_pressure readingsName_solarRadiation readingsName_solarUV readingsName_temperature readingsName_time readingsName_windChill readingsName_windDegrees readingsName_windDirection readingsName_windGust readingsName_windSpeed readingsRegex_cloudiness readingsRegex_date readingsRegex_dewpointTemperature readingsRegex_fog readingsRegex_heatindex readingsRegex_humidity readingsRegex_pressure readingsRegex_solarRadiation readingsRegex_solarUV readingsRegex_temperature readingsRegex_time readingsRegex_windChill readingsRegex_windDegrees readingsRegex_windDirection readingsRegex_windGust readingsRegex_windSpeed<br />
attr wetter_prenzelberg readingsName_cloudiness cloudiness<br />
attr wetter_prenzelberg readingsName_date date<br />
attr wetter_prenzelberg readingsName_dewpointTemperature dewpointTemperature<br />
attr wetter_prenzelberg readingsName_fog fog<br />
attr wetter_prenzelberg readingsName_heatindex heatindex<br />
attr wetter_prenzelberg readingsName_humidity humidity<br />
attr wetter_prenzelberg readingsName_pressure pressure<br />
attr wetter_prenzelberg readingsName_solarRadiation solarRadiation<br />
attr wetter_prenzelberg readingsName_solarUV solarUV<br />
attr wetter_prenzelberg readingsName_temperature temperature<br />
attr wetter_prenzelberg readingsName_time time<br />
attr wetter_prenzelberg readingsName_windChill windChill<br />
attr wetter_prenzelberg readingsName_windDegrees windDegrees<br />
attr wetter_prenzelberg readingsName_windDirection windDirection<br />
attr wetter_prenzelberg readingsName_windGust windGust<br />
attr wetter_prenzelberg readingsName_windSpeed windSpeed<br />
attr wetter_prenzelberg readingsRegex_cloudiness cloudiness id="NN" percent="([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_date date date" content="([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_dewpointTemperature <dewpoint_c>(\+|-?[\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_fog fog id="FOG" percent="([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_heatindex <heat_index_c>(\+|-?[\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_humidity <relative_humidity>([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_pressure <pressure_mb>([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_solarRadiation <solar_radiation>([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_solarUV <UV>([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_temperature <temp_c>(\+|-?[\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_time time Zeit([\d\:]+)<br />
attr wetter_prenzelberg readingsRegex_windChill <windchill_c>(\+|-?[\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_windDegrees <wind_degrees>([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_windDirection <wind_dir>([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_windGust <wind_gust_mph>([\d\.]+)<br />
attr wetter_prenzelberg readingsRegex_windSpeed <wind_mph>([\d\.]+)<br />
</pre><br />
Hinweis: Nicht immer werden alle Werte geliefert (wenn keine Sonne, dann kein UV-Wert...). Im System-Log kann das als Fehler auftauchen, ist aber kein Problem.<br />
<br />
=== Erstellen passender gplot-Dateien ===<br />
Um die ausgelesenen Werte als Graphen darstellen zu können müssen eigene gplot-Dateien erstellt werden. Eine grundsätzliche Anleitung dazu findet sich unter [[Creating Plots]]. Deshalb sollen hier nur Beispiele für die eigentlichen gplot-Dateien vorgestellt werden. Beispiele sollten sowohl für [[FileLog]] wie [[DbLog]] funktionieren.<br />
<br />
Temperatur und Luftfeuchte:<br />
<pre><br />
set terminal png transparent size <SIZE> crop<br />
set output '<OUT>.png'<br />
set xdata time<br />
set timefmt "%Y-%m-%d_%H:%M:%S"<br />
set xlabel " "<br />
#set title '<L1>'<br />
set title ''<br />
set ytics <br />
set y2tics <br />
set grid ytics<br />
set ylabel "Temperature in C"<br />
set y2label "Humidity (%)"<br />
<br />
#FileLog 4:temperature\x3a::<br />
#FileLog 4:windChill\x3a::<br />
#FileLog 4:humidity\x3a::<br />
<br />
#DbLog <SPEC1>:temperature::<br />
#DbLog <SPEC1>:windChill::<br />
#DbLog <SPEC1>:humidity::<br />
<br />
plot "<IN>" using 1:2 axes x1y1 title 'Temperatur (C)' ls l0 lw 1.5 with lines,\<br />
"<IN>" using 1:2 axes x1y1 title 'Gefühlte Temperatur (C)' ls l1 lw 1.5 with lines,\<br />
"<IN>" using 1:2 axes x1y2 title 'Luftfeuchtigkeit (%)' ls l2fill lw 0.2 with lines<br />
</pre><br />
<br />
Wind und Windrichtung:<br />
<pre><br />
set terminal png transparent size <SIZE> crop<br />
<br />
set output '<OUT>.png'<br />
set xdata time<br />
set timefmt "%Y-%m-%d_%H:%M:%S"<br />
set xlabel " "<br />
<br />
set ytics<br />
set y2tics ("Nord" 0, "Ost" 80, "S&#252;d" 180, "West" 270, "Nord" 360)<br />
<br />
#set title '<L1>'<br />
set title ''<br />
<br />
set grid xtics ytics<br />
<br />
set yrange [0:20]<br />
set y2range [0:360]<br />
<br />
set ylabel "Wind (mph)"<br />
set y2label "Richtung"<br />
<br />
#FileLog 4:windSpeed:0:<br />
#FileLog 4:windGust:0:<br />
#FileLog 4:windDegrees:0:<br />
<br />
#DbLog <SPEC1>:windSpeed::<br />
#DbLog <SPEC1>:windGust::<br />
#DbLog <SPEC1>:windDegrees::<br />
<br />
plot "<IN>" using 1:2 axes x1y1 title 'Wind (mph)' ls l0 lw 1.5 with lines,\<br />
"<IN>" using 1:2 axes x1y1 title 'Böen (mph)' ls l1 lw 1.5 with lines,\<br />
"<IN>" using 1:2 axes x1y2 title 'Windrichtung (°)' ls l2fill lw 0.2 with points<br />
</pre><br />
<br />
Sonnenintensität und UV-Werte:<br />
<pre><br />
set terminal png transparent size <SIZE> crop<br />
<br />
set output '<OUT>.png'<br />
set xdata time<br />
set timefmt "%Y-%m-%d_%H:%M:%S"<br />
set xlabel " "<br />
<br />
set ytics<br />
set y2tics<br />
<br />
#set title '<L1>'<br />
set title ''<br />
<br />
set grid xtics ytics<br />
<br />
set ylabel "Sonnenstrahlung (W/qm)"<br />
set y2label "UV"<br />
<br />
#FileLog 4:solarRadiation:0:<br />
#FileLog 4:solarUV:0:<br />
<br />
#DbLog <SPEC1>:solarRadiation::<br />
#DbLog <SPEC1>:solarUV::<br />
<br />
plot "<IN>" using 1:2 axes x1y1 title 'Strahlung' ls l0 lw 1.5 with lines,\<br />
"<IN>" using 1:2 axes x1y1 title 'UV' ls l1 lw 1.5 with lines<br />
</pre><br />
<br />
'''Weitere TBD'''<br />
<br />
=== Vergangene Daten abfragen ===<br />
Ein konkretes vergangenes Datum der Wetterstation kann man übrigens auch abrufen - für den 28.11.2014 wäre dies bspw. <br />
<code>http://www.wunderground.com/weatherstation/WXDailyHistory.asp?ID=IBERLIN15&day=28&month=11&year=2014&graphspan=day&format=1</code>.<br />
<br />
=== Eigene Wetterdaten hochladen ===<br />
{{Randnotiz|RNTyp=g|RNText=Unterstützung für das Modul gibt es im dazugehörigen {{Link2Forum|Topic=65587|LinkText=Forumsthread }}.}}<br />
<br />
Wer eigene Wetterdaten hochladen will, kann hierzu das Modul [http://fhem.de/commandref.html#WUup WUup] verwenden. Dazu benötigt man die Zugangsdaten (stationID und Paßwort) für eine eigene Wetterstation. Mit dem Modul können die meisten vom [http://wiki.wunderground.com/index.php/PWS_-_Upload_Protocol PWS Upload Protocol] unterstützten Daten hochgeladen werden:<br />
* Winddir - [0-360 momentane Windrichtung]<br />
* Windspeedmph - [mph momentane Windgeschwindigkeit]<br />
* Windgustmph - [mph aktuellen Böe, mit Software-spezifischem Zeitraum]<br />
* Windgustdir - [0-360 mit Software-spezifischer Zeit]<br />
* Windspdmph_avg2m - [mph durchschnittliche Windgeschwindigkeit innerhalb 2 Minuten]<br />
* Winddir_avg2m - [0-360 durchschnittliche Windrichtung innerhalb 2 Minuten]<br />
* Windgustmph_10m - [mph Böen der vergangenen 10 Minuten]<br />
* Windgustdir_10m - [0-360 Richtung der Böen der letzten 10 Minuten]<br />
* Feuchtigkeit - [% Außenfeuchtigkeit 0-100%]<br />
* Dewptf- [F Taupunkt im Freien]<br />
* Tempf - [F Außentemperatur]<br />
* Rainin - [in Regen in der vergangenen Stunde]<br />
* Dailyrainin - [in Regenmenge bisher heute]<br />
* Baromin - [inHg barometrischer Druck]<br />
* Soiltempf - [F Bodentemperatur]<br />
* Bodenfeuchtigkeit - [%]<br />
* Solarradiation - [W/m²]<br />
* UV - [Index]<br />
<br />
Die Werte werden im Modul für Wunderground ins anglo-amerikanische System umgerechnet. Temperaturen werden also automatisch von °Celsius in Fahrenheit, Windgeschwindigkeiten von km/h in mph, mm in Inch und der barometrische Druck von hPa in inHg umgerechnet.<br />
<br />
== Wetternetzwerk auf wetter.com ==<br />
Ein vollständiges Beispiel zur Nutzung der Informationen über die Regenmenge (Station 1445, Weinheim) von wetter.com ist in {{Link2Forum|Topic=39600|Message=332837|LinkText=diesem Forenbeitrag}} beschrieben.<br />
<br />
== Wetter von netatmo ==<br />
Das FHEM-Modul [[netatmo]] ermöglicht den Datenimport von privaten und öffentlichen netatmo Wetterstationen. Eine Übersicht über die verfügbaren öffentlichen Stationen findet sich auf der Seite [http://www.netatmo.com/de-DE/weathermap Weathermap]. Die meisten öffentlichen Stationen liefern Temperatur, Luftfeuchte und Luftdruck, einige auch Wind, Regen und Daten zur Luftqualität (CO<sub>2</sub>).<br />
<br />
== Links ==<br />
* {{Link2Forum|Topic=33610}} mit Sammlung und Beipielen von Internet-Links für die Anzeige von teilweise animierten Wetterbildern<br />
* [http://bloglich.de/art/rpi/wetterdaten-auf-dem-raspberry-pi-in-fhem/ Beispiel in Blog(de)]<br />
* [[HTTPMOD]]<br />
<br />
[[Kategorie:Code Snippets]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Wetterstationen]] <!-- eigentlich eine "Hardware-Kategorie", passt aber trotzdem --></div>JensBhttp://wiki.fhem.de/w/index.php?title=Arduino_mit_OneWireFirmata&diff=25662Arduino mit OneWireFirmata2018-03-03T19:03:57Z<p>JensB: </p>
<hr />
<div>= Einleitung =<br />
Ein Adruino mit der Firmware ConfigurableFirmata kann als 1-Wire-Busmaster eingesetzt werden. Dafür kommen fast alle Arduino-Boards in Frage. Bei Boards mit wenig Speicher (z.B. MEGA168P) bzw. beim Einbinden großer Programmbibliotheken (z.B. für den ENC28J60) muss man jedoch einige Features von ConfigurableFirmata deaktivieren, um die Firmware installieren zu können.<br />
<br />
Alternativ kann man auch einen DS2482 als 1-Wire-Busmaster an den I2C-Bus eines Arduinos anschließen. Ein ConfigurableFirmata-Sketch mit DS2482-Unterstützung findet sich [https://github.com/ntruchsess/arduino/tree/DS2482/examples/ConfigurableFirmata hier] bzw kann man sich [https://github.com/ntruchsess/arduino/archive/DS2482.zip hier als zip] herunterladen.<br />
<br />
ConfigurableFirmata kann, abhängig von den Möglichkeiten des Boards, mit FHEM wahlweise seriell (z.B. über den USB-Anschluss), über Ethernet (sowohl über Ethernet Shields mit W5100 oder ENC28J60 Chip, letztere unter Verwendung der [https://github.com/ntruchsess/arduino_uip UIPEthernet Library]) oder über WiFi kommunizieren.<br />
<br />
In FHEM ist ein Firmata-Device vom Typ FRM anzulegen, das dann als IODev für ein Device vom Typ OWX oder OWX_ASYNC dient.<br />
<br />
= Allgemeine Funktionsweise =<br />
ConfigurableFirmata führt auf dem Arduino bestimmte 1-Wire-Kommandofolgen selbstständig aus. Der Firmata-Client OWX(_ASYNC) fordert z.B. von Firmata an: 'mache eine 1-Wire-Bussuche'. Die wird auf dem Arduino ausgeführt und der schickt das Ergebniss (alle gefundenen Devices) an den Firmata-Client zurück. Oder es wird angefordert: 'mache einen Bus-Reset, sprich ein bestimmtest Device mit der Adresse XXX an, schicke folgende Bytes dorthin und lese anschließend YY Bytes'. Der Arduino tut das und wenn er fertig ist, schickt er die YY Bytes an den Firmata-Client zurück. Nach dem Abarbeiten einer 1-Wire-Kommandfolge und dem Verschicken des Ergebnisses vergisst er, was er getan hat, weiß also z.B. nicht, welche 1-Wire Devices am Bus gefunden wurden. Solche Funktionen wären bei der Speicherknappheit einiger Arduinos auch nicht realisierbar. Dieser Funktionsumfang ist aber schon deutlich höher als der von anderen Busmasterchips (wie z.B. DS2480 oder DS2482). Denen muss man jedes Kommando in der Abfolge einzeln vorgeben und dabei noch auf das korrekte Timing achten. Bei ConfigurableFirmata bedeutet das Starten einer Bussuche, dass OWX nur 4 Bytes versendet und dann auf das Ergebnis wartet. Das FHEM Modul OWX wartet dabei und blockiert solange FHEM, das Modul OWX_ASYNC wartet dagegen in einem Protothread während FHEM weiter arbeitet und der Arduino parallel dazu über den 1-Wire Bus kommuniziert.<br />
<br />
Wenn man zusätzlich einen DS2482 als Busmaster an den Arduino anschließt, dann ändert sich am oben Gesagtem nichts. Mit dem DS2482 hat der Arduino ein elektrisch etwas besser an 1-Wire angepasstes Interface und muss weniger Timing per Software machen. Dies erlaubt z.T. mehr Devices bei längerem 1-Wire Bus als es ohne zusätzlichen Busmaster möglich ist.<br />
<br />
= Mögliche Funktionserweiterung =<br />
Die Funktion "FirmataScheduler" von ConfigurableFirmata wird zur Zeit von den FHEM-Modulen FRM und OWX nicht unterstützt. Damit könnte man z.B. iButtons über OWID mit einer schnellen, arduinoseitig getriggerten Bussuche versorgen. Der Scheduler ist in der Lage Firmata-Kommandoabfolgen zu speichern und zeitversetzt (auch zyklisch) abzuspielen. Damit könnte man sich auch das Senden der genannten 4 Bytes zum Starten der Bussuche ersparen. Der Arduino würde die Ergebnisse selbstständig im vorgegebenen Interval verschicken. Je nach Arduino kann man wegen des begrenzten Speichers jedoch keine komplexeren Aufgaben im FirmataScheduler unterbringen, insbesondere kann man nicht die Kommandofolgen für mehrere Devices unterbringen (eine DS18B20 Abfrage braucht z.B. ca. 30 Bytes pro Device. Das klingt nach wenig, ist aber eine ganze Menge, wenn nur wenige 100kb verfügbar sind). Ist der Speicher zu Ende stürzt der Arduino einfach ab bzw. resettet sich.<br />
<br />
= Arduino IDE und ConfigurableFirmata =<br />
Die Installation der Arduino-IDE sowie das Auswählen und das prinzipielle Kompilieren von ConfigurableFirmata wird auf der Seite [[Arduino Firmata]] beschrieben.<br />
<br />
Will man den DS2482 als Busmaster einsetzen, verwendet man statt eines der Standardbeispiele von ConfigurableFirmata die oben aufgeführte DS2482-ConfigurableFirmata als Sketch. <br />
<br />
'''Hinweis''': Dieser Sketch basiert auf einer älteren Version von ConfigurableFirmata. Sollte er mit der aktuellen Version von ConfigurableFirmata nicht mehr kompatibel sein, müsste man die relevanten Teile für den DS2482 manuell in die neue Version übertragen.<br />
<br />
= ConfigurableFirmata Features =<br />
Wenn man die Features von ConfigurableFirmata reduzieren möchte (z.B. weil man einen MEGA168P verwenden will und gar keine Servos ansteuern möchte), muss man im ConfigurableFirmata-Sketch die entsprechenden includes mit zwei vorgestellen Schrägstrichen auskommentieren. <br />
<br />
Kommt es nach dem Auskommentiert zu Fehlern bei der ersten Kompilierung, sollte man den Sketch zunächst mit allen Features kompilieren und anschließend schrittweise wieder reduzieren. <br />
<br />
Für 1-Wire muss neben OneWireFirmata auf jeden Fall auch FirmataExt aktiviert werden, denn ohne FirmataExt ist nur Digital- und Analog-I/O möglich.<br />
<br />
Es wird empfohlen nur die erforderlichen Features zu aktivieren. Beispielsweise passen I2C und 1Wire nicht gleichzeitig mit UIPEthernet ins RAM eines ATMega328. Das lässt sich zwar flashen, es stürzt aber mangels ausreichend Heap-Speichers sofort ab.<br />
<br />
Außerdem sollte man eine feste IP-Adresse vergeben statt DHCP zu verwenden. Bei UIPEthernet kann man dann UDP in der uipethernet-conf.h abstellen und das spart ca. 5kb Flash und einige 100 Bytes RAM.<br />
<br />
= Arduino Firmware Flashen =<br />
Ist das Kompilieren erfolgreich, muss man noch unter 'Tools'-&gt;'Programmer' den verwendeten Programmieradapter sowie unter 'Tools'-&gt;'serieller Port' den korrekten Port auswählen und mit dem 'Upload'-Knopf (der mit dem Rechspfeil oben link in der Arduino IDE) den geladenen Sketch auf das Board hochladen. Je nach Arduino Board sind andere Einstellungen als die hier aufgeführten und ggf. auch zusätzliche Aktionen erforderlich (z.B. zu einem bestimmten Zeitpunkt bestimmte Buttons auf dem Board drücken oder bestimmte Pins verbinden).<br />
<br />
Falls man unter Windows Probleme hat, den Arduino über USB zu verbinden, finden sich z.B. hier weitere Informationen: [http://arduino.cc/en/Guide/Windows#toc2 http://arduino.cc/en/Guide/Windows#toc2]<br />
<br />
= Einbinden eines Arduinos mit Firmata in FHEM =<br />
Ein Arduino mit Firmata wird in FHEM über das Modul 10_FRM.pm angesprochen. Dazu sollte mindestens die FRM Modul in der Version 15941 vom 20.01.2018 verwendet werden (ggf. FHEM update durchführen).<br />
<br />
<nowiki># definiere FRM mit USB-Schnittstelle /dev/ttyUSB0, Baudrate 57600 ist Default für StandardFirmata<br />
define FIRMATA FRM /dev/ttyUSB0@57600</nowiki><br />
<br />
<nowiki># definiere FRM mit TCP/IP-Schnittstelle auf Port 3030<br />
define FIRMATA FRM 3030 global</nowiki><br />
FRM macht bei Netzwerkverbindungen FHEM-seitig einen Serverport auf (dieser wird in der define-Zeile angegeben). 'global' muss zusätzlich angegeben werden, damit der Serversocket an alle IP-addressen gebunden wird. (Sonst wird nur 'localhost' verwendet, was nicht funktionieren würde). Der Arduino verbindet sich aktiv zu diesem Port, sonst gilt im Prinzip alles was auch für den über USB angebunden Arduino gilt.<br />
<br />
Siehe dazu auch die {{Link2CmdRef|Anker=FRM}}.<br />
<br />
= Einbinden der 1-Wire Devices in FHEM =<br />
Nachdem das FRM Device angelegt wurde, kann ein danach definiertes OWX Device einen der Arduino-Pins als 1-Wire-Busmaster nutzen. Das funktioniert bei den meisten Boards an allen Pins, die Digital-IO unterstützen. Wenn sich das Firmata Device schon verbunden hat, findet man im laufenden FHEM bei den Internals des FRM Devices den Eintrag: 'onewire-pins'. Dieser listet alle Pins auf, die 1-Wire unterstützen. Damit kann das OWX-Device angelegt werden:<br />
<br />
<nowiki>define &lt;device-name&gt; OWX <Firmata-Device>:&lt;arduino-pin&gt;</nowiki><br />
<br />
Z.B. ist beim Arduino Mini Pro der D9 = Pin 9 gut geeignet.<br />
<br />
<nowiki>define OWio1 OWX Arduino:9</nowiki><br />
<br />
Nach dem Definieren des OWX Devices fängt dieses selbsttätig an über den Arduino-Pin nach 1-Wire Devices zu suchen und im Raum 'OWX' automatisch anzulegen.<br />
<br />
Wenn man die [https://github.com/ntruchsess/arduino/tree/DS2482/examples/ConfigurableFirmata DS2482-ConfigurableFirmata] benutzt, dann findet man beim FRM-Device unter 'onewire-pins' nur die I2C-Pins. Das sind z.B. bei einem Uno bzw. Nano die Pins 18 und 19 (das entspricht den Analogpins 4 und 5). Einen der beiden muss man dann bei der Definition des OWX-Moduls angeben um die DS2482-Unterstützung zu aktivieren:<br />
<nowiki>define &lt;device-name&gt; OWX 18</nowiki><br />
[[Kategorie:1-Wire]]<br />
[[Kategorie:Arduino]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Interfaces]]</div>JensBhttp://wiki.fhem.de/w/index.php?title=Arduino_mit_OneWireFirmata&diff=25661Arduino mit OneWireFirmata2018-03-03T19:03:20Z<p>JensB: WiFi als Schnittstelle ergänzt</p>
<hr />
<div>= Einleitung =<br />
Ein Adruino mit der Firmware ConfigurableFirmata kann als 1-Wire-Busmaster eingesetzt werden. Dafür kommen fast alle Arduino-Boards in Frage. Bei Boards mit wenig Speicher (z.B. MEGA168P) bzw. beim Einbinden großer Programmbibliotheken (z.B. für den ENC28J60) muss man jedoch einige Features von ConfigurableFirmata deaktivieren, um die Firmware installieren zu können.<br />
<br />
Alternativ kann man auch einen DS2482 als 1-Wire-Busmaster an den I2C-Bus eines Arduinos anschließen. Ein ConfigurableFirmata-Sketch mit DS2482-Unterstützung findet sich [https://github.com/ntruchsess/arduino/tree/DS2482/examples/ConfigurableFirmata hier] bzw kann man sich [https://github.com/ntruchsess/arduino/archive/DS2482.zip hier als zip] herunterladen.<br />
<br />
ConfigurableFirmata kann, abhängig von den Möglichkeiten des Board, mit FHEM wahlweise seriell (z.B. über den USB-Anschluss), über Ethernet (sowohl über Ethernet Shields mit W5100 oder ENC28J60 Chip, letztere unter Verwendung der [https://github.com/ntruchsess/arduino_uip UIPEthernet Library]) oder über WiFi kommunizieren.<br />
<br />
In FHEM ist ein Firmata-Device vom Typ FRM anzulegen, das dann als IODev für ein Device vom Typ OWX oder OWX_ASYNC dient.<br />
<br />
= Allgemeine Funktionsweise =<br />
ConfigurableFirmata führt auf dem Arduino bestimmte 1-Wire-Kommandofolgen selbstständig aus. Der Firmata-Client OWX(_ASYNC) fordert z.B. von Firmata an: 'mache eine 1-Wire-Bussuche'. Die wird auf dem Arduino ausgeführt und der schickt das Ergebniss (alle gefundenen Devices) an den Firmata-Client zurück. Oder es wird angefordert: 'mache einen Bus-Reset, sprich ein bestimmtest Device mit der Adresse XXX an, schicke folgende Bytes dorthin und lese anschließend YY Bytes'. Der Arduino tut das und wenn er fertig ist, schickt er die YY Bytes an den Firmata-Client zurück. Nach dem Abarbeiten einer 1-Wire-Kommandfolge und dem Verschicken des Ergebnisses vergisst er, was er getan hat, weiß also z.B. nicht, welche 1-Wire Devices am Bus gefunden wurden. Solche Funktionen wären bei der Speicherknappheit einiger Arduinos auch nicht realisierbar. Dieser Funktionsumfang ist aber schon deutlich höher als der von anderen Busmasterchips (wie z.B. DS2480 oder DS2482). Denen muss man jedes Kommando in der Abfolge einzeln vorgeben und dabei noch auf das korrekte Timing achten. Bei ConfigurableFirmata bedeutet das Starten einer Bussuche, dass OWX nur 4 Bytes versendet und dann auf das Ergebnis wartet. Das FHEM Modul OWX wartet dabei und blockiert solange FHEM, das Modul OWX_ASYNC wartet dagegen in einem Protothread während FHEM weiter arbeitet und der Arduino parallel dazu über den 1-Wire Bus kommuniziert.<br />
<br />
Wenn man zusätzlich einen DS2482 als Busmaster an den Arduino anschließt, dann ändert sich am oben Gesagtem nichts. Mit dem DS2482 hat der Arduino ein elektrisch etwas besser an 1-Wire angepasstes Interface und muss weniger Timing per Software machen. Dies erlaubt z.T. mehr Devices bei längerem 1-Wire Bus als es ohne zusätzlichen Busmaster möglich ist.<br />
<br />
= Mögliche Funktionserweiterung =<br />
Die Funktion "FirmataScheduler" von ConfigurableFirmata wird zur Zeit von den FHEM-Modulen FRM und OWX nicht unterstützt. Damit könnte man z.B. iButtons über OWID mit einer schnellen, arduinoseitig getriggerten Bussuche versorgen. Der Scheduler ist in der Lage Firmata-Kommandoabfolgen zu speichern und zeitversetzt (auch zyklisch) abzuspielen. Damit könnte man sich auch das Senden der genannten 4 Bytes zum Starten der Bussuche ersparen. Der Arduino würde die Ergebnisse selbstständig im vorgegebenen Interval verschicken. Je nach Arduino kann man wegen des begrenzten Speichers jedoch keine komplexeren Aufgaben im FirmataScheduler unterbringen, insbesondere kann man nicht die Kommandofolgen für mehrere Devices unterbringen (eine DS18B20 Abfrage braucht z.B. ca. 30 Bytes pro Device. Das klingt nach wenig, ist aber eine ganze Menge, wenn nur wenige 100kb verfügbar sind). Ist der Speicher zu Ende stürzt der Arduino einfach ab bzw. resettet sich.<br />
<br />
= Arduino IDE und ConfigurableFirmata =<br />
Die Installation der Arduino-IDE sowie das Auswählen und das prinzipielle Kompilieren von ConfigurableFirmata wird auf der Seite [[Arduino Firmata]] beschrieben.<br />
<br />
Will man den DS2482 als Busmaster einsetzen, verwendet man statt eines der Standardbeispiele von ConfigurableFirmata die oben aufgeführte DS2482-ConfigurableFirmata als Sketch. <br />
<br />
'''Hinweis''': Dieser Sketch basiert auf einer älteren Version von ConfigurableFirmata. Sollte er mit der aktuellen Version von ConfigurableFirmata nicht mehr kompatibel sein, müsste man die relevanten Teile für den DS2482 manuell in die neue Version übertragen.<br />
<br />
= ConfigurableFirmata Features =<br />
Wenn man die Features von ConfigurableFirmata reduzieren möchte (z.B. weil man einen MEGA168P verwenden will und gar keine Servos ansteuern möchte), muss man im ConfigurableFirmata-Sketch die entsprechenden includes mit zwei vorgestellen Schrägstrichen auskommentieren. <br />
<br />
Kommt es nach dem Auskommentiert zu Fehlern bei der ersten Kompilierung, sollte man den Sketch zunächst mit allen Features kompilieren und anschließend schrittweise wieder reduzieren. <br />
<br />
Für 1-Wire muss neben OneWireFirmata auf jeden Fall auch FirmataExt aktiviert werden, denn ohne FirmataExt ist nur Digital- und Analog-I/O möglich.<br />
<br />
Es wird empfohlen nur die erforderlichen Features zu aktivieren. Beispielsweise passen I2C und 1Wire nicht gleichzeitig mit UIPEthernet ins RAM eines ATMega328. Das lässt sich zwar flashen, es stürzt aber mangels ausreichend Heap-Speichers sofort ab.<br />
<br />
Außerdem sollte man eine feste IP-Adresse vergeben statt DHCP zu verwenden. Bei UIPEthernet kann man dann UDP in der uipethernet-conf.h abstellen und das spart ca. 5kb Flash und einige 100 Bytes RAM.<br />
<br />
= Arduino Firmware Flashen =<br />
Ist das Kompilieren erfolgreich, muss man noch unter 'Tools'-&gt;'Programmer' den verwendeten Programmieradapter sowie unter 'Tools'-&gt;'serieller Port' den korrekten Port auswählen und mit dem 'Upload'-Knopf (der mit dem Rechspfeil oben link in der Arduino IDE) den geladenen Sketch auf das Board hochladen. Je nach Arduino Board sind andere Einstellungen als die hier aufgeführten und ggf. auch zusätzliche Aktionen erforderlich (z.B. zu einem bestimmten Zeitpunkt bestimmte Buttons auf dem Board drücken oder bestimmte Pins verbinden).<br />
<br />
Falls man unter Windows Probleme hat, den Arduino über USB zu verbinden, finden sich z.B. hier weitere Informationen: [http://arduino.cc/en/Guide/Windows#toc2 http://arduino.cc/en/Guide/Windows#toc2]<br />
<br />
= Einbinden eines Arduinos mit Firmata in FHEM =<br />
Ein Arduino mit Firmata wird in FHEM über das Modul 10_FRM.pm angesprochen. Dazu sollte mindestens die FRM Modul in der Version 15941 vom 20.01.2018 verwendet werden (ggf. FHEM update durchführen).<br />
<br />
<nowiki># definiere FRM mit USB-Schnittstelle /dev/ttyUSB0, Baudrate 57600 ist Default für StandardFirmata<br />
define FIRMATA FRM /dev/ttyUSB0@57600</nowiki><br />
<br />
<nowiki># definiere FRM mit TCP/IP-Schnittstelle auf Port 3030<br />
define FIRMATA FRM 3030 global</nowiki><br />
FRM macht bei Netzwerkverbindungen FHEM-seitig einen Serverport auf (dieser wird in der define-Zeile angegeben). 'global' muss zusätzlich angegeben werden, damit der Serversocket an alle IP-addressen gebunden wird. (Sonst wird nur 'localhost' verwendet, was nicht funktionieren würde). Der Arduino verbindet sich aktiv zu diesem Port, sonst gilt im Prinzip alles was auch für den über USB angebunden Arduino gilt.<br />
<br />
Siehe dazu auch die {{Link2CmdRef|Anker=FRM}}.<br />
<br />
= Einbinden der 1-Wire Devices in FHEM =<br />
Nachdem das FRM Device angelegt wurde, kann ein danach definiertes OWX Device einen der Arduino-Pins als 1-Wire-Busmaster nutzen. Das funktioniert bei den meisten Boards an allen Pins, die Digital-IO unterstützen. Wenn sich das Firmata Device schon verbunden hat, findet man im laufenden FHEM bei den Internals des FRM Devices den Eintrag: 'onewire-pins'. Dieser listet alle Pins auf, die 1-Wire unterstützen. Damit kann das OWX-Device angelegt werden:<br />
<br />
<nowiki>define &lt;device-name&gt; OWX <Firmata-Device>:&lt;arduino-pin&gt;</nowiki><br />
<br />
Z.B. ist beim Arduino Mini Pro der D9 = Pin 9 gut geeignet.<br />
<br />
<nowiki>define OWio1 OWX Arduino:9</nowiki><br />
<br />
Nach dem Definieren des OWX Devices fängt dieses selbsttätig an über den Arduino-Pin nach 1-Wire Devices zu suchen und im Raum 'OWX' automatisch anzulegen.<br />
<br />
Wenn man die [https://github.com/ntruchsess/arduino/tree/DS2482/examples/ConfigurableFirmata DS2482-ConfigurableFirmata] benutzt, dann findet man beim FRM-Device unter 'onewire-pins' nur die I2C-Pins. Das sind z.B. bei einem Uno bzw. Nano die Pins 18 und 19 (das entspricht den Analogpins 4 und 5). Einen der beiden muss man dann bei der Definition des OWX-Moduls angeben um die DS2482-Unterstützung zu aktivieren:<br />
<nowiki>define &lt;device-name&gt; OWX 18</nowiki><br />
[[Kategorie:1-Wire]]<br />
[[Kategorie:Arduino]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Interfaces]]</div>JensBhttp://wiki.fhem.de/w/index.php?title=Arduino_Firmata&diff=25660Arduino Firmata2018-03-03T18:57:01Z<p>JensB: Rechtschreibung</p>
<hr />
<div>== Arduino mit Firmata ==<br />
Für Arduinos (und diverse Arduino kompatible Boards) gibt es eine Standardimplementierung des Kommunikationsprotokolls ''Firmata'' [https://github.com/firmata/protocol]. Mit Hilfe des Perl-Moduls ''Device::Firmata'', auch bekannt als perl-firmata [https://github.com/ntruchsess/perl-firmata], kann das Firmata-Protokoll in Perl genutzt werden und mit dem Modul [[#FRM|FRM]] auch in FHEM.<br />
<br />
Für die Kommunikation zwischen FHEM (Master) und Arduino (Slave) stehen mehrere Schnittstellen zur Auswahl: RS-232, USB, Ethernet und WiFi. Insbesondere Ethernet und WiFi erlauben die Integration dezentraler IO-Periperie mit FHEM.<br />
<br />
Firmata möglich es, mit nur geringen Arduino-Kenntnissen digitale und analoge Signale aus eigenen Schaltungen in FHEM zu verarbeiten. Dabei können Signale sowohl eingelesen als auch ausgegeben werden. Ein Verständnis der Bedienung der Arduino-IDE und elektronische Kenntnisse zum Anschluss von Sensoren und Aktoren sind natürlich erforderlich.<br />
<br />
=== Arduino IDE ===<br />
Zur Installation von Firmware auf den Arduino wird natürlich erst mal die Arduino-IDE (Version 1.8 oder höher) benötigt [https://www.arduino.cc/en/main/software]. Die gibt es für die Betriebssysteme Windows, Mac OS X und Linux.<br />
<br />
Über die Bibliotheksverwaltung der Arduino-IDE (Menü 'Sketch'-&gt;'Bibliothek einbinden'-&gt;'Bibliotheken verwalten...') stehen verschiedene Firmware-Versionen von Firmata zur Auswahl. Im folgenden wird auf die Version "Firmata by Firmata Developers" und "ConfigurableFirmata by Firmata Developers" eingegangen. Diese beiden Versionen unterscheiden sich in den unterstützten Hardware-Funktionen:<br />
<br />
* Firmata: digitale und analoge I/Os, Servos, I2C<br />
* ConfigurableFirmata: zusätzlich 1-Wire und Schrittmotoren<br />
<br />
Bei ConfigurableFirmata ist es auch außerdem einfacher, nicht benötigte Funktionen zu deaktivieren, damit die Arduino-Firmware möglichst wenig Speicher belegt. Wenn man den zusätzlichen Funktionsumfang von ConfigurableFirmata nicht benötigt, kann man mit etwas Geschick durch Auskommentieren von nicht benötigtem Code aus Firmata z.T. ein noch kompakteres Ergebnis erzielen (das ist aber nur etwas für Fortgeschrittene).<br />
<br />
Bei Firmata ist zwischen der Firmata-Protokoll-Version (aktuell 2.6.0) und der Version der jeweiligen Firmware (Firmata: aktuell 2.5.7, ConfigurableFirmata: aktuell 2.10.0) zu unterscheiden, die insbesondere bei ConfigurableFirmata voneinander unabhängig sind.<br />
<br />
Nach Installation der gewünschten Firmata-Firmware wählt man eines der funktionsfertigen Beispiele über das Arduino-IDE Menü 'Datei'-&gt;'Beispiele'-&gt;'Firmata' bzw. 'Datei'-&gt;'Beispiele'-&gt;'ConfigurableFirmata' aus. Je nach ausgewähltem Beispielprojekt sind noch Anpassungen direkt im Sketch oder in einer zusätzlichen Konfigurationsdatei erforderlich (z.B. um für Ethernet- und WiFi-Schnittstellen die Netzwerkparameter einzustellen).<br />
<br />
Über das Arduino-IDE Menü 'Werkzeuge'-&gt;'Bords' wählt man das Board aus, das dem eigenen Arduino entspricht. Fehlt das Board in der Auswahl, kann die erforderliche Unterstützung oft über das Menü 'Werkzeuge'-&gt;'Bords'-&gt;'Boardverwalter...' nachinstalliert werden. Ansonsten hilft ein Blick auf die Hersteller-Webseiten des Boards.<br />
<br />
Ist der Arduino korrekt angeschlossen, drückt man den 'Upload'-Knopf (der mit dem Rechspfeil oben links), um den Arduino-Sketch zu kompilieren und auf das Board hochzuladen. Die Vorgehensweise zum Hochladen ist sehr stark davon abhängig, welches Board man verwendet und mit welcher Technik es angeschlossen ist. Bitte die jeweiligen Angaben des Board-Herstellers beachten.<br />
<br />
Wer zum ersten mal mit der Arduino-IDE arbeitet, sollte statt Firmata zunächst das Standard Arduino Beispielprojekt 'Blink' auswählen und es auf dem Arduino installieren. Sobald das klappt, kann man mit Firmata weiter machen.<br />
<br />
=== Firmata mit Ethernet oder WiFi ===<br />
<br />
Vor dem Kompilieren muss man unbedingt die Netzwerkparameter anpassen, d.h. die IP-Adresse des FHEM-Servers und den Port des FRM-Moduls eintragen (ggf. auch eine neue eindeutige MAC-Adresse), bei WiFi auch die SSID und den PSK. In älteren Firmata-Versionen und bei ConfigurableFirmata geschieht das direkt im Sketch. Aktuelle Firmata-Versionen haben dazu eine getrennte Konfigurationsdatei (ethernetConfig.h bzw. wifiConfig.h), so dass keine Änderungen am Sketch erforderlich sind.<br />
<br />
Falls der Speicherbedarf der kompilierten Arduino-Firmware die Möglichkeiten des Boards übersteigt (insbesondere bei Verwendung eines ENC28J60-Ethernet-Shields [https://github.com/ntruchsess/arduino_uip] in Kombination mit einem "kleinen" Arduiono wie den Uno oder Nano) kann man bei Verwendung von ConfigurableFirmata nicht benötigten Features im Sketch auskommentieren. Wenn der Speicherbedarf nur "knapp" ausreicht, läuft die Firmware u.U. trotzdem nicht zuverlässig.<br />
<br />
Als ersten Funktionstest für die Netzwerkverbindung empfiehlt sich ein Ping von FHEM zum Arduino.<br />
<br />
=== Sonderfälle ===<br />
<br />
Je nach verwendetem Board sind u.U. individuelle Besonderheiten zu berücksichtigen. Hier ein paar Beispiele:<br />
<br />
Ein MEGA256 z.B. benutzt einen anderen Pin als SS (Slave select) zur Kommunikation mit dem Ethernetmodul. Man muss der Firmata im Setup mitteilen, welche Pins zu ignorieren sind, damit es keine Wechselwirkungen zwischen Firmata und Ethernet Library gibt. Das ist im ConfigurableFirmata-Sketch [https://github.com/firmata/arduino/blob/configurable/examples/ConfigurableFirmata/ConfigurableFirmata.ino] vorbereitet und muss (wenn man etwas anderes als ein Standard-Ethernetshield am Uno verwendet) geeignet angepasst werden (Beim Mega muss man z.B. den Pin 10 ignorieren und Pin 53 als hardcodiert auf Output stellen). Das gleiche gilt, wenn man eine andere Hardware (z.B. mit ENC28J60 anstelle des WizNet W5100 des Ethernetshields) benutzen möchte, die einen anderen Pin als CS/SS benutzt.<br />
<br />
== FRM ==<br />
Der Arduino wird in FHEM über das Modul 10_FRM.pm angesprochen. 10_FRM ist für andere FHEM-Module die Schnittstelle (das IODev) zum Arduino. Es lassen sich jeweils so viele Ein/Ausgabe Devices pro Arduino konfigurieren, wie dieser physikalisch besitzt (natürlich muss man darauf achten, dass nicht alle Arduino-Pins alle Ein-/Ausgabemöglichkeiten besitzen). Konfiguriert man einen Pin für einen nicht unterstützen Modus so gibt es mit der aktuellen Firmata-Version direkt einen Fehler - ältere Versionen (vor 2.3) schlucken Fehlkonfigurationen einfach so, der betreffende Pin funktioniert dann aber nicht.<br />
<br />
Hier ein kurzer Ausschnitt aus der fhem.cfg:<br />
<br />
<hr /><br />
<nowiki># definiere FRM mit USB-Schnittstelle /dev/ttyUSB0, Baudrate 57600 ist Default für StandardFirmata<br />
define FIRMATA FRM /dev/ttyUSB0@57600</nowiki><br />
<br />
<nowiki># definiere FRM mit TCP/IP-Schnittstelle auf Port 3030<br />
define FIRMATA FRM 3030 global</nowiki><br />
FRM macht bei Netzwerkverbindungen FHEM-seitig einen Serverport auf (dieser wird in der define-Zeile angegeben). 'global' muss zusätzlich angegeben werden, damit der Serversocket an alle IP-addressen gebunden wird. (Sonst wird nur 'localhost' verwendet, was nicht funktionieren würde). Der Arduino verbindet sich aktiv zu diesem Port, sonst gilt im Prinzip alles was auch für den über USB angebunden Arduino gilt.<br />
<br />
<nowiki># für alle analogen Eingangs-Pins<br />
attr FIRMATA sampling-interval 1000 # [ms] - maximal 16384 setzbar</nowiki><br />
<br />
siehe auch: {{Link2CmdRef|Anker=FRM}} FRM<br />
=== 20_FRM_IN.pm ===<br />
Macht einen Arduino-pin als digitalen Eingang nutzbar.<br />
<nowiki>define Firmata_IN FRM_IN 12 # definiert Arduino Pin 12 als digitalen Eingang</nowiki><br />
siehe auch: {{Link2CmdRef|Anker=FRM_IN}} FRM_IN<br />
=== 20_FRM_OUT.pm ===<br />
Macht einen Arduino-pin als digitalen Ausgang nutzbar.<br />
<nowiki>define Firmata_OUT FRM_OUT 11 # definiert Arduino Pin 11 als digitalen Ausgang</nowiki><br />
siehe auch: {{Link2CmdRef|Anker=FRM_OUT}} FRM_OUT<br />
=== 20_FRM_AD.pm ===<br />
Macht einen Arduino-pin als analogen Eingang nutzbar.<br />
<nowiki>define Firmata_ANALOG FRM_AD 17 # definiert Arduino Pin 17 als analogen Eingang</nowiki><br />
siehe auch: {{Link2CmdRef|Anker=FRM_AD}} FRM_AD<br />
=== 20_FRM_PWM.pm ===<br />
Macht einen Arduino-pin als analogen Ausgang nutzbar. Es wird ein pulsweitenmoduliertes Signal ausgegeben.<br />
<nowiki>define Firmata_ANALOG FRM_PWM 10 # definiert Arduino Pin 10 als analogen Ausgang</nowiki><br />
siehe auch: {{Link2CmdRef|Anker=FRM_PWM}} FRM_PWM<br />
=== 20_FRM_SERVO.pm ===<br />
Erlaubt die Ansteuerung von analogen Modelbauservos (Ansteuerung über PWM) am Arduino.<br />
<nowiki>define Firmata_ANALOG FRM_AD 9 # definiert Arduino Pin 9 als analogen Eingang</nowiki><br />
siehe auch: {{Link2CmdRef|Anker=FRM_SERVO}} FRM_SERVO<br />
=== 20_FRM_I2C.pm ===<br />
<p>Erlaubt das Auslesen von über I2C angeschlossenen ICs</p><br />
siehe auch: {{Link2CmdRef|Anker=FRM_I2C}}FRM_I2C<br />
=== Arduino mit OneWireFirmata ===<br />
<p>die Seite [[Arduino mit OneWireFirmata]] beschreibt, wie es möglich ist, mit einer um OneWire erweiterten Version der Standard Firmata an den Arduino angeschlossene 1-Wire Devices in FHEM einzubinden.</p><br />
siehe auch: {{Link2CmdRef|Anker=OWX}} OWX<br />
<br />
[[Kategorie:Other_Components]]<br />
[[Kategorie:Arduino]]<br />
[[Kategorie:HOWTOS]]</div>JensBhttp://wiki.fhem.de/w/index.php?title=Arduino_mit_OneWireFirmata&diff=25659Arduino mit OneWireFirmata2018-03-03T18:54:55Z<p>JensB: Beschreibungen an die aktuellen Versionen von Arduino-IDE, Firmata und FHEM angepasst.</p>
<hr />
<div>= Einleitung =<br />
Ein Adruino mit der Firmware ConfigurableFirmata kann als 1-Wire-Busmaster eingesetzt werden. Dafür kommen fast alle Arduino-Boards in Frage. Bei Boards mit wenig Speicher (z.B. MEGA168P) bzw. beim Einbinden großer Programmbibliotheken (z.B. für den ENC28J60) muss man jedoch einige Features von ConfigurableFirmata deaktivieren, um die Firmware installieren zu können.<br />
<br />
Alternativ kann man auch einen DS2482 als 1-Wire-Busmaster an den I2C-Bus eines Arduinos anschließen. Ein ConfigurableFirmata-Sketch mit DS2482-Unterstützung findet sich [https://github.com/ntruchsess/arduino/tree/DS2482/examples/ConfigurableFirmata hier] bzw kann man sich [https://github.com/ntruchsess/arduino/archive/DS2482.zip hier als zip] herunterladen.<br />
<br />
ConfigurableFirmata kommuniziert mit FHEM wahlweise über den USB-Anschluss, über Ethernet (sowohl über Ethernet Shields mit W5100 oder ENC28J60 Chip, letztere unter Verwendung der [https://github.com/ntruchsess/arduino_uip UIPEthernet Library]).<br />
<br />
In FHEM ist ein Firmata-Device vom Typ FRM anzulegen, das dann als IODev für ein Device vom Typ OWX oder OWX_ASYNC dient.<br />
<br />
= Allgemeine Funktionsweise =<br />
ConfigurableFirmata führt auf dem Arduino bestimmte 1-Wire-Kommandofolgen selbstständig aus. Der Firmata-Client OWX(_ASYNC) fordert z.B. von Firmata an: 'mache eine 1-Wire-Bussuche'. Die wird auf dem Arduino ausgeführt und der schickt das Ergebniss (alle gefundenen Devices) an den Firmata-Client zurück. Oder es wird angefordert: 'mache einen Bus-Reset, sprich ein bestimmtest Device mit der Adresse XXX an, schicke folgende Bytes dorthin und lese anschließend YY Bytes'. Der Arduino tut das und wenn er fertig ist, schickt er die YY Bytes an den Firmata-Client zurück. Nach dem Abarbeiten einer 1-Wire-Kommandfolge und dem Verschicken des Ergebnisses vergisst er, was er getan hat, weiß also z.B. nicht, welche 1-Wire Devices am Bus gefunden wurden. Solche Funktionen wären bei der Speicherknappheit einiger Arduinos auch nicht realisierbar. Dieser Funktionsumfang ist aber schon deutlich höher als der von anderen Busmasterchips (wie z.B. DS2480 oder DS2482). Denen muss man jedes Kommando in der Abfolge einzeln vorgeben und dabei noch auf das korrekte Timing achten. Bei ConfigurableFirmata bedeutet das Starten einer Bussuche, dass OWX nur 4 Bytes versendet und dann auf das Ergebnis wartet. Das FHEM Modul OWX wartet dabei und blockiert solange FHEM, das Modul OWX_ASYNC wartet dagegen in einem Protothread während FHEM weiter arbeitet und der Arduino parallel dazu über den 1-Wire Bus kommuniziert.<br />
<br />
Wenn man zusätzlich einen DS2482 als Busmaster an den Arduino anschließt, dann ändert sich am oben Gesagtem nichts. Mit dem DS2482 hat der Arduino ein elektrisch etwas besser an 1-Wire angepasstes Interface und muss weniger Timing per Software machen. Dies erlaubt z.T. mehr Devices bei längerem 1-Wire Bus als es ohne zusätzlichen Busmaster möglich ist.<br />
<br />
= Mögliche Funktionserweiterung =<br />
Die Funktion "FirmataScheduler" von ConfigurableFirmata wird zur Zeit von den FHEM-Modulen FRM und OWX nicht unterstützt. Damit könnte man z.B. iButtons über OWID mit einer schnellen, arduinoseitig getriggerten Bussuche versorgen. Der Scheduler ist in der Lage Firmata-Kommandoabfolgen zu speichern und zeitversetzt (auch zyklisch) abzuspielen. Damit könnte man sich auch das Senden der genannten 4 Bytes zum Starten der Bussuche ersparen. Der Arduino würde die Ergebnisse selbstständig im vorgegebenen Interval verschicken. Je nach Arduino kann man wegen des begrenzten Speichers jedoch keine komplexeren Aufgaben im FirmataScheduler unterbringen, insbesondere kann man nicht die Kommandofolgen für mehrere Devices unterbringen (eine DS18B20 Abfrage braucht z.B. ca. 30 Bytes pro Device. Das klingt nach wenig, ist aber eine ganze Menge, wenn nur wenige 100kb verfügbar sind). Ist der Speicher zu Ende stürzt der Arduino einfach ab bzw. resettet sich.<br />
<br />
= Arduino IDE und ConfigurableFirmata =<br />
Die Installation der Arduino-IDE sowie das Auswählen und das prinzipielle Kompilieren von ConfigurableFirmata wird auf der Seite [[Arduino Firmata]] beschrieben.<br />
<br />
Will man den DS2482 als Busmaster einsetzen, verwendet man statt eines der Standardbeispiele von ConfigurableFirmata die oben aufgeführte DS2482-ConfigurableFirmata als Sketch. <br />
<br />
'''Hinweis''': Dieser Sketch basiert auf einer älteren Version von ConfigurableFirmata. Sollte er mit der aktuellen Version von ConfigurableFirmata nicht mehr kompatibel sein, müsste man die relevanten Teile für den DS2482 manuell in die neue Version übertragen.<br />
<br />
= ConfigurableFirmata Features =<br />
Wenn man die Features von ConfigurableFirmata reduzieren möchte (z.B. weil man einen MEGA168P verwenden will und gar keine Servos ansteuern möchte), muss man im ConfigurableFirmata-Sketch die entsprechenden includes mit zwei vorgestellen Schrägstrichen auskommentieren. <br />
<br />
Kommt es nach dem Auskommentiert zu Fehlern bei der ersten Kompilierung, sollte man den Sketch zunächst mit allen Features kompilieren und anschließend schrittweise wieder reduzieren. <br />
<br />
Für 1-Wire muss neben OneWireFirmata auf jeden Fall auch FirmataExt aktiviert werden, denn ohne FirmataExt ist nur Digital- und Analog-I/O möglich.<br />
<br />
Es wird empfohlen nur die erforderlichen Features zu aktivieren. Beispielsweise passen I2C und 1Wire nicht gleichzeitig mit UIPEthernet ins RAM eines ATMega328. Das lässt sich zwar flashen, es stürzt aber mangels ausreichend Heap-Speichers sofort ab.<br />
<br />
Außerdem sollte man eine feste IP-Adresse vergeben statt DHCP zu verwenden. Bei UIPEthernet kann man dann UDP in der uipethernet-conf.h abstellen und das spart ca. 5kb Flash und einige 100 Bytes RAM.<br />
<br />
= Arduino Firmware Flashen =<br />
Ist das Kompilieren erfolgreich, muss man noch unter 'Tools'-&gt;'Programmer' den verwendeten Programmieradapter sowie unter 'Tools'-&gt;'serieller Port' den korrekten Port auswählen und mit dem 'Upload'-Knopf (der mit dem Rechspfeil oben link in der Arduino IDE) den geladenen Sketch auf das Board hochladen. Je nach Arduino Board sind andere Einstellungen als die hier aufgeführten und ggf. auch zusätzliche Aktionen erforderlich (z.B. zu einem bestimmten Zeitpunkt bestimmte Buttons auf dem Board drücken oder bestimmte Pins verbinden).<br />
<br />
Falls man unter Windows Probleme hat, den Arduino über USB zu verbinden, finden sich z.B. hier weitere Informationen: [http://arduino.cc/en/Guide/Windows#toc2 http://arduino.cc/en/Guide/Windows#toc2]<br />
<br />
= Einbinden eines Arduinos mit Firmata in FHEM =<br />
Ein Arduino mit Firmata wird in FHEM über das Modul 10_FRM.pm angesprochen. Dazu sollte mindestens die FRM Modul in der Version 15941 vom 20.01.2018 verwendet werden (ggf. FHEM update durchführen).<br />
<br />
<nowiki># definiere FRM mit USB-Schnittstelle /dev/ttyUSB0, Baudrate 57600 ist Default für StandardFirmata<br />
define FIRMATA FRM /dev/ttyUSB0@57600</nowiki><br />
<br />
<nowiki># definiere FRM mit TCP/IP-Schnittstelle auf Port 3030<br />
define FIRMATA FRM 3030 global</nowiki><br />
FRM macht bei Netzwerkverbindungen FHEM-seitig einen Serverport auf (dieser wird in der define-Zeile angegeben). 'global' muss zusätzlich angegeben werden, damit der Serversocket an alle IP-addressen gebunden wird. (Sonst wird nur 'localhost' verwendet, was nicht funktionieren würde). Der Arduino verbindet sich aktiv zu diesem Port, sonst gilt im Prinzip alles was auch für den über USB angebunden Arduino gilt.<br />
<br />
Siehe dazu auch die {{Link2CmdRef|Anker=FRM}}.<br />
<br />
= Einbinden der 1-Wire Devices in FHEM =<br />
Nachdem das FRM Device angelegt wurde, kann ein danach definiertes OWX Device einen der Arduino-Pins als 1-Wire-Busmaster nutzen. Das funktioniert bei den meisten Boards an allen Pins, die Digital-IO unterstützen. Wenn sich das Firmata Device schon verbunden hat, findet man im laufenden FHEM bei den Internals des FRM Devices den Eintrag: 'onewire-pins'. Dieser listet alle Pins auf, die 1-Wire unterstützen. Damit kann das OWX-Device angelegt werden:<br />
<br />
<nowiki>define &lt;device-name&gt; OWX <Firmata-Device>:&lt;arduino-pin&gt;</nowiki><br />
<br />
Z.B. ist beim Arduino Mini Pro der D9 = Pin 9 gut geeignet.<br />
<br />
<nowiki>define OWio1 OWX Arduino:9</nowiki><br />
<br />
Nach dem Definieren des OWX Devices fängt dieses selbsttätig an über den Arduino-Pin nach 1-Wire Devices zu suchen und im Raum 'OWX' automatisch anzulegen.<br />
<br />
Wenn man die [https://github.com/ntruchsess/arduino/tree/DS2482/examples/ConfigurableFirmata DS2482-ConfigurableFirmata] benutzt, dann findet man beim FRM-Device unter 'onewire-pins' nur die I2C-Pins. Das sind z.B. bei einem Uno bzw. Nano die Pins 18 und 19 (das entspricht den Analogpins 4 und 5). Einen der beiden muss man dann bei der Definition des OWX-Moduls angeben um die DS2482-Unterstützung zu aktivieren:<br />
<nowiki>define &lt;device-name&gt; OWX 18</nowiki><br />
[[Kategorie:1-Wire]]<br />
[[Kategorie:Arduino]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Interfaces]]</div>JensBhttp://wiki.fhem.de/w/index.php?title=Arduino_mit_OneWireFirmata&diff=25198Arduino mit OneWireFirmata2018-02-11T19:31:35Z<p>JensB: Versionshinweis</p>
<hr />
<div>''Hinweis: Dieser Artikel bezieht sich auf ältere Versionen der Arduino-IDE und von FHEM. Mit den aktuellen Version sind die hier beschriebenen versionsspezifischen Anpassungen nicht mehr erforderlich. Eine Überarbeitung dieses Artikels ist geplant.''<br />
<br />
= Einleitung zur OneWireFirmata (ConfigurableFirmata) =<br />
mit dem Modul 10_FRM.pm kann man einen Arduino als OneWire-Busmaster für das Modul 00_OWX.pm benutzen.<br />
Auf dem Arduino muss dazu eine erweiterte Version der Firmata-Firmware geladen werden. Unterstützt werden im prinzip alle Arduino-Versionen. Auf Arduinos mit nur 16kb RAM (MEGA168P) muss man die Zahl der eingebauten Features reduzieren, auf allen Arduinos mit mehr als 16kb Ram (MEGA328P aufwärts) läuft die Firmware unverändert.<br />
<br />
Die aktuelle Arduino-IDE bringt zwar schon eine Version der StandardFirmata mit, diese enthält aber noch keine Unterstützung für OneWire. Diese findet man [https://github.com/firmata/ConfigurableFirmata im eigenen Fork]. Den kompletten Branch kann man sich auch bequem [https://github.com/firmata/ConfigurableFirmata/archive/master.zip als zip-Archiv herunterladen]<br />
<br />
Die ConfigurableFirmata kommuniziert mit FHEM über den USB-anschluss oder Ethernet (sowohl original EthernetShield, 'Arduino Ethernet' als auch ENC28J60 basierte Boards werden unterstützt, letztere unter Verwendung der [https://github.com/ntruchsess/arduino_uip UIPEthernet-library]).<br />
<br />
Alternativ kann man einen DS2482 als 1-Wire-Busmaster an den I2C-Bus des Arduino anschließen. Die nötige ConfigurableFirmata mit DS2482-Unterstützung [https://github.com/ntruchsess/arduino/tree/DS2482/examples/ConfigurableFirmata findet sich hier] bzw kann man sich hier als [https://github.com/ntruchsess/arduino/archive/DS2482.zip zip] herunterladen.<br />
<br />
= Allgemeine Funktionsweise =<br />
Der Arduino ist in der Lage bestimmte 1-Wire-kommandoabfolgen selbstständig auszuführen. Der Firmata-client (OWX(_ASYNC)) fordert vom Arduino/Firmata entweder an: 'mache eine 1-Wire-Bussuche', dann läuft diese auf dem Arduino und schickt das Ergebniss (alle gefundenen Devices) an den Firmata-client zurück. Oder es wird angefordert: 'mache einen Bus-reset, sprich ein bestimmtest Device mit der Addresse XXX an, schicke folgende Bytes dorthin und lese anschließend YY Bytes. Der Arduino tut das und wenn er fertig ist, schickt er die YY Bytes an den Firmata-client zurück. Mehr Intelligenz steckt im OneWire-firmata feature nicht drin. Der Arduino merkt sich dabei nichts. Nach dem Abarbeiten einer 1-Wire-kommandfolge und dem Verschicken des Ergebnisses vergisst er alles, was er getan hat. Mehr Eingenintelligenz wäre bei der Speicherknappheit auch nicht stabil unterzubringen, als Alternaive müsste man die Anzahl der Devices auf dem 1-Wire Bus (stark) einschränken. Das ist aber schon deutlich mehr Eigenintelligenz als die anderen Busmasterchips (DS2480 oder DS2482) mitbringen. Denen muss man jeden Einzelschritt vorgenannter Abfolgen einzeln sagen (und dabei noch auf das korrekte Timing achten). Beim Arduino bedeutet das Starten einer Bussuche, dass OWX gerade einmal 4 Bytes in einem Rutsch abschickt und dann auf das fertige Ergebnis wartet. OWX wartet dabei synchron und blockiert FHEM, OWX_ASYNC wartet in einem Protothread wärend FHEM weiterläuft und der Arduino parallel dazu den 1-Wire-bus durchsucht.<br />
<br />
Der FirmataScheduler wird zur Zeit von den FRM-Modulen noch nicht unterstützt. Geplant ist damit iButtons über OWID mit einer schnellen, arduinoseitig getriggerten Bussuche zu versorgen. Der Scheduler ist in der Lage Firmata-kommando-abfolgen zu speichern und zeitversetzt (auch zyklisch) abzuspielen, damit kann man sich das Senden der genannten 4 Bytes zum Starten der Bussuche sparen. Der Arduino schickt dann die Ergebnisse selbstständig im vorgegebenen Interval. Leider kann man (wg. des begrenzten Speichers) keine komplexeren Aufgaben im FirmataScheduler unterbringen, insbesonders kann man nicht einfach mal alle Device-abfragen da rein programmieren, da wäre schon nach einer Handvoll Devices der Speicher des Arduinos voll. (Eine DS18B20 Abfrage braucht z.B. ca. 30 Bytes pro Device. Das klingt nach wenig, ist aber eine ganze Menge, wenn nur wenige 100kb verfügbar sind). Ist der Speicher zu Ende stürzt der Arduino einfach ab bzw. resettet sich.<br />
<br />
Wenn man einen DS2482 am Arduino hat, dann ändert sich nichts prinzipielles an oben gesagtem. Mit dem DS2482 hat der Arduino ggf. ein physikalisch besser an 1-Wire angepasstes Interface und muss weniger Timing selber in Software machen. Damit sollten mehr Devices bei längerem 1-Wire-bus funktionieren, als mit der reinen Softwarelösung. Alle anderen Einschränkungen und/oder Möglichkeiten sind aber praktisch identisch.<br />
<br />
= Vorbereitungen in der Arduino IDE =<br />
Zur Installation auf den Arduino wird natürlich erst mal die Arduino-IDE benötigt ([http://arduino.cc/en/Guide/Libraries http://arduino.cc/en/Guide/Libraries]))<br />
<br />
Hat man das 'libraries' Verzeichnis seiner Arduino-ide-installation gefunden (unter Ubuntu z.B. unter /usr/share/arduino/libraries/), gibt es dort normalerweise schon ein Verzeichnis 'Firmata'. Falls nicht, muss dieses angelegt werden. Die in dem Verzeichnis befindlichen Dateien 'Firmata.h', 'Firmata.cpp' und 'Boards.h' müssen durch die im arduino-configurable.zip-file enthaltenen Versionen ersetzt werden. Am besten kopiert man einfach den gesamten Inhalt des Ordners 'arduino-configurable' in das 'libraries/Firmata'-Verzeichnis (mitsamt des Unterordners 'examples'). <br />
<br />
Anschließend sollte man noch den Unterordner 'ConfigurableFirmata' aus den soeben kopierten Examples in sein Sketchbook kopieren. Wichtig: der Ordnername darf nicht umbenannt werden ansonsten erkennt die Arduino-IDE das Verzeichnis nicht als korrekten Sketch.<br />
Macht man das so, dann findet man nach einem Neustart der IDE den ConfigurableFirmata-sketch unter 'Datei'-&gt;'Sketchbook'-&gt;'sketches'-&gt;'ConfigurableFirmata'.<br />
<br />
===== Stand 2017-12-29: =====<br />
Laut https://forum.fhem.de/index.php/topic,44525.msg380238.html#msg380238<br />
<br />
verwende einen Git-Client und checke eine Version vor dem 22.11.2015 aus, also z.B. den Commit "55b4e352b5647072805adc5b82798b78788018af". Es gibt leider keine Tags vor 2.8.0.<br />
<br />
= Kompilierung =<br />
Wenn man die in dieser neuen Firmataversion eingebauten Features reduzieren möchte (weil man nur eine MEGA168P verwenden will und z.B. gar keine Servos ansteuern möchte), muss man nur im 'ConfigurableFirmata'-sketch die entsprechenden includes auskommentieren.<br />
<br />
Werden aufgrund der Sketchgröße einige Features auskommentiert und gibt es bei der ersten Kompilierung Fehler, so muss der Sketch erstmalig mit allen Features kompiliert werden. Erst anschließend kann auf das notwendige Maß der Umfang reduziert werden. <br />
<br />
Um 1wire zu nutzen muss neben OneWireFirmata auch FirmataExt aktiviert werden. FirmataExt ist für SysEx-basierte Features (wie 1-Wire) unverzichtbar. Ohne FirmataExt geht nur Digital+Analog-I/O<br />
<br />
Grundsätzlich ist empfohlen nur die wirklich benutzten Features zu aktivieren. Beispielsweise passen I2C und 1Wire nicht gleichzeitig mit UIPEthernet ins RAM eines ATMega328. Kann man zwar noch flashen, stürzt dann aber mangels ausreichend Heap sofort ab. Also erst mal sparsam anfangen und nur die Dinge, die wirklich genutzt werden gleichzeitig aktivieren. <br />
Wenn es geht, dann eine fixe IP verwenden (kein DHCP), dann kann man UDP in der uipethernet-conf.h abstellen - das spart ca. 5kb Flash und ein paar 100 Bytes RAM.<br />
<br />
Naja - hat man es erst mal geschafft, dann muss man nur noch unter 'Tools'-&gt;'Board' den eigenen Arduino, 'Tools'-&gt;'Programmer' den verwendeten Programmieradapter sowie unter 'Tools'-&gt;'serieller Port' den korrekten Port auswählen und mit dem Upload-knopf (der Rechtspfeil im Kreis oben links) den geladenen Sketch compilieren und auf das Board hochladen. <br />
<br />
Falls man unter Windows Probleme hat den Arduino über USB zu connecten findet sich hier weitere Information: [http://arduino.cc/en/Guide/Windows#toc2 http://arduino.cc/en/Guide/Windows#toc2]<br />
<br />
= Einbindung des Arduino in FHEM =<br />
Der Arduino wird in FHEM über das Modul 10_FRM.pm angesprochen (dazu bitte die aktuelle Development-version herunterladen ([http://www.dhs-computertechnik.de/downloads/fhem-cvs.tgz http://www.dhs-computertechnik.de/downloads/fhem-cvs.tgz]) aus dem SVN auschecken oder per updatefhem aktualisieren).<br />
<br />
<nowiki># definiere FRM als IO-Device - Baudrate 57600 ist default in der Standardfirmata<br />
define Arduino FRM /dev/ttyUSB0@57600<br />
<br />
# definiere FRM als IO-Device über Ethernet ('global' bindet an alle IP-Addressen des Servers)<br />
define Arduino FRM <port> global</nowiki><br />
<br />
Siehe dazu auch die {{Link2CmdRef|Anker=FRM}}.<br />
<br />
===== Stand 2017-12-29: =====<br />
<br />
Da die Firmata 2_10 nicht von FHEM erkannt wird (es werden z.B. keine Pins angezeigt) (TODO: WARUM?), muss in der Datei /opt/fhem/FHEM/lib/Device/Firmata/Constants.pm eine Anpassung durchgeführt werden. <br />
Wenn man nur ein einziges Device hat, reicht es, in Zeile 301 den Variablennamen "V_2_06" in "V_2_10" umzubenennen. Anderenfalls ist es sicherer, den gesamten Inhalt zu kopieren und unten drunter als "V_2_10" einzufügen.<br />
<br />
= Einbindung der 1WireDevices in FHEM =<br />
Ein im Anschluss daran definiertes 1-Wire Device kann dann einfach einen der Arduino-Pins als 1-Wire Busmaster nutzen. Das funktioniert an allen Pins, die Digital IO unterstützen. Wenn man das FRM Device schon definiert hat, findet man im laufenden FHEM unter den FRM-Attributen einen Eintrag: 'onewire-pins', dieser listet alle Pins auf, die 1-Wire unterstützen. Damit kann dann das OWX-Device angelegt werden:<br />
<br />
<nowiki>define &lt;device-name&gt; OWX <Firmata-Device>:&lt;arduino-pin&gt;</nowiki><br />
<br />
Zb. ist beim Arduino Mini Pro der D9 = Pin9 gut geeignet.<br />
<br />
<nowiki>define OWio1 OWX Arduino:9</nowiki><br />
<br />
Nach dem Definieren des 1-Wire Devices fängt dieses selbsttätig an über den Arduino-Pin nach 1-Wire Devices zu suchen und im Raum 'OWX' automatisch anzulegen.<br />
<br />
Wenn man die [https://github.com/ntruchsess/arduino/tree/DS2482/examples/ConfigurableFirmata DS2482-Firmata] benutzt, dann findet man beim FRM-Device unter 'onewire-pins' nur die I2C-Pins. Das sind z.B. bei einem Uno/Nano die Pins 18 und 19 (das entspricht den Analogpins 4 und 5). Einen der beiden muss man dann bei der Definition des OWX-Moduls angeben um die DS2482-Unterstützung zu aktivieren:<br />
<nowiki>define &lt;device-name&gt; OWX 18</nowiki><br />
[[Kategorie:1-Wire]]<br />
[[Kategorie:Arduino]]<br />
[[Kategorie:HOWTOS]]<br />
[[Kategorie:Interfaces]]</div>JensBhttp://wiki.fhem.de/w/index.php?title=System%C3%BCbersicht&diff=25197Systemübersicht2018-02-11T19:20:10Z<p>JensB: FRM/Firmata vervollständigt.</p>
<hr />
<div>Ein FHEM '''System''' besteht im Prinzip aus den in der nachfolgenden '''Übersicht''' aufgeführten Bestandteilen.<br />
[[Datei:Systemübersicht.png]]<br />
<br />
<div style="float: right;">__TOC__</div><br />
<br />
== Server ==<br />
Bei der Komponente '''Server''' muss unterschieden werden zwischen dem eigentlichen '''FHEM''' Hausautomations-Server (implementiert in der Perl-Datei fhem.pl) und der Hardware, auf der dieser Server ausgeführt wird.<br />
<br />
Als Server '''Hardware''' sind (z.&nbsp;B.) möglich:<br />
* Windows Rechner<br />
* Linux Rechner<br />
* OS X Rechner<br />
* Router (z.&nbsp;B. [[AVM Fritz!Box|FritzBox]])<br />
* Einplatinencomputer, wie [[:Kategorie:Raspberry Pi|Raspberry Pi]], [[BeagleBone Black]]<br />
* DockStar, PogoPlug, etc.<br />
* diverse NAS Systeme wie Buffalo Linkstation, Synology Diskstation<br />
<br />
(Diese Aufstellung ist nur eine unvollständige Auswahl; Details zu unterstützten Server Systemen finden sich in der Kategorie [[:Kategorie:Server Hardware|Server Hardware]]).<br />
<br />
== Perl ==<br />
Auf dem Server muss Perl installiert sein. Zur erforderlichen Version gibt es widersprüchliche Aussagen, die vor allem daraus resultieren, dass verschiedene FHEM-Module von verschiedenen Entwicklern stammen und daher unterschiedliche Anforderungen stellen. Laut FHEM-Webseite wird mindestens Version 5.6 benötigt, faktisch setzen aber viele Module 5.10 oder sogar 5.12 voraus. Der Betrieb mit Grundfunktionen ist jedoch zumindest ab Version 5.8.8 mit Einschränkungen möglich.<br />
<br />
== Konfiguration ==<br />
Das Hausautomations-System wird definiert über die [[Konfiguration]], die im Regelfall aus der <br />
* reinen Textdatei <code>fhem.cfg</code> (Standard nach der Erstinstallation) oder alternativ einer<br />
* [[configdb|SQL-Datenbank]]<br />
besteht.<br />
<br />
Die Konfiguration enthält Definitionen für die Bestandteile (Geräte) und Funktionen des jeweiligen Hausautomations-Systems. Die verfügbaren Befehle und deren Syntax sind in der Befehlsreferenz ({{Link2CmdRef}}) aufgeführt und beschrieben. Zu einigen Hilfsmodulen gibt es [[:Kategorie:Hilfsmodul|detaillierte Beschreibungen]] mit Beispielen.<br />
<br />
== Benutzeroberfläche ==<br />
Der Zugriff auf FHEM erfolgt mittels Webbrowser oder App über die verfügbaren '''[[:Kategorie:FHEM Frontends|FHEM Benutzeroberflächen]]'''.<br />
<br />
In den FHEM Server integriert ist ein Webserver ([[PGM2]]), der im Prinzip immer zur Verfügung steht. Abhängig vom benutzten Klienten ist PGM2 über <br />
* <code>serverhostnameoderIP:8083/fhem</code> (Desktop-Darstellung = Port 8083),<br />
* <code>serverhostnameoderIP:8084/fhem</code> (Smartphone-Darstellung = Port 8084) oder <br />
* <code>serverhostnameoderIP:8085/fhem</code> (Tablet-Darstellung = Port 8085) <br />
erreichbar.<br />
<br />
Eine Auswahl der Benutzeroberflächen:<br />
* PGM2 - das Standardinterface<br />
* [[FLOORPLAN]]<br />
* [[FHEM Tablet UI]]<br />
* [[SmartVISU]]<br />
* diverse Apps für iOS und Android (Auswahl unter: [[:Kategorie:FHEM Frontends|FHEM Benutzeroberflächen]])<br />
<br />
Beispielhafte Screenshots diverser Benutzeroberflächen: http://fhem.de/fhem.html#Screenshots<br />
<br />
== Module ==<br />
Die Funktionalität von FHEM kann über '''Module''' erweitert werden. Module können die unterschiedlichsten Aufgaben übernehmen vom Anbinden eines Hardwaresystems<br />
über die Bereitstellung eines Frontends bis zur Automatisierung von Aufgaben. Beispiele für Module:<br />
* 00_CUL.pm - Implementierung der Unterstützung für den [[CUL]]<br />
* 11_FHT.pm - Unterstützung der [[:Kategorie:FHT Components|FHT]] Heizungssteuerung<br />
* 95_FLOORPLAN.pm - Grundriss (oder Ähnliches) als Benutzeroberfläche <br />
* uvm.<br />
<br />
Module können unterteilt werden in<br />
* [[:Kategorie:FHEM Befehl|Befehlsmodule]] (FHEM-Befehle sind teilweise eigenständige Module) <br />
* [[:Kategorie:Hilfsmodul|Hilfsmodule]]<br />
* [[:Kategorie:Gerätemodul|Gerätemodule]]<br />
Die offiziell in FHEM enthaltenen Module sind in der {{Link2CmdRef}} beschrieben. Sie werden über den [[Update]]-Befehl von FHEM verteilt und aktualisiert. Voraussetzung für die Aufnahme als offizielles Modul sind Supportwille durch den Entwickler und Dokumentation des Moduls.<br />
<br />
Zusätzlich existiert eine Vielzahl von [[:Kategorie:Modul (Inoffiziell)|inoffiziellen Modulen]], die manuell in FHEM installiert werden können. Auch die Aktualisierung erfolgt nicht über den Update-Befehl, sondern muss durch den Nutzer selbst erfolgen. Inoffizielle Module sind an den verschiedensten Stellen zu finden:<br />
* [[:Kategorie:Modul (Contrib)|Contrib]]-Verzeichnis im offiziellen FHEM-Sourcecode-SVN [http://svn.fhem.de/trac/browser/trunk/fhem/contrib]<br />
* Beiträge im [https://forum.fhem.de/ FHEM-Forum]<br />
* private Homepages<br />
<br />
== Interfaces ==<br />
Die Verbindung zu den angeschlossenen '''Geräten''' der Hausautomation wird im Allgemeinen - geräteabhängig - über [[Interface|Interfaces]] (manchmal auch als '''Gateway''' bezeichnet) hergestellt. Das kann z.&nbsp;B. im Falle von [[HomeMatic]] ein [[HMLAN Konfigurator]] sein, ein mittels LAN mit dem FHEM Server verbundenes Gerät, das die FHEM Steuerbefehle in das HomeMatic Funkprotokoll umsetzt - und auch die Funktelegramme der HomeMatic Komponenten an FHEM zurückgibt. Entsprechende Interfaces gibt es auch für andere Funkprotokolle und für die drahtgebundenen Systeme.<br />
<br />
Eine (unvollständige) Liste solcher Interfaces (siehe auch [[:Kategorie:Interfaces|Kategorie Interfaces]]):<br />
* [[CUL]] - je nach Einstellung für die Kommunikation mit [[:Kategorie:FS20 Components|FS20]], [[:Kategorie:FHT Components|FHT]] und andere [[SlowRF]] Protokolle, [[MAX|MAX!]] Heizungssteuerung oder [[:Kategorie:HomeMatic Components|HomeMatic]] und, mit Einschränkungen, InterTechno (nur senden)<br />
* [[CUNO]], ähnlich CUL, jedoch nicht per USB sondern per IP angebunden (z.Zt. -Stand Januar 2014 - nicht für HomeMatic empfohlen)<br />
* [[HMLAN Konfigurator|HomeMatic LAN Konfigurations-Adapter]] - HomeMatic<br />
* [[MAX#MAXLAN|MAX! Cube LAN-Gateway]]<br />
* Schnittstellen(karten) für [[:Kategorie:1-Wire|1-Wire]]<br />
* TCM(120/310) zur Anbindung von [[:Kategorie:EnOcean Components|EnOcean]]<br />
* [[Arduino]] mit Firmata über USB oder Netzwerk<br />
* [[panStamp]] als Möglichkeit Arduinos mit diversen Sensor- und I/O- Boards per 868MHz Funk über das SWAP protokoll anzubinden<br />
* [[JeeLink]], ein weiteres USB-Stick Interface (ebenfalls arduino basiert) für diverse 433MHz und 868MHz Komponenten<br />
* [[RFXtrx]] für InterTechno, RSL, ELRO etc., Wetter-Sensoren (Oregon-Scientific, Cresta, La Crosse, TFA, UPM) und andere 433&nbsp;Mhz Geräte.<br />
* manche Komponenten ([[:Kategorie:IP Components|IP Komponenten]]) können über TCP/IP (LAN) direkt vom FHEM Server aus angesprochen werden; hier ist dann kein weiteres Interface im eigentlichen Sinne erforderlich. Dies gilt auch für diverse Module die Geräte über WEB Dienste des Herstellers anbinden (z.&nbsp;B. Withings, [[netatmo]]).<br />
<br />
== Protokolle ==<br />
Der Kommunikation zwischen Interfaces und Geräten liegt jeweils ein bestimmtes Protokoll zugrunde. Unterstützte Protokolle mit ihren Eigenschaften sind in der folgenden Tabelle aufgelistet.<br />
<br />
{| class="wikitable sortable"<br />
|+ Übersicht über unterstützte Funkprotokolle<br />
|-<br />
! Name !! rfMode !! Frequenz !! Modulation !! Datenrate !! class="unsortable" | Interfaces !! class="unsortable" | Modul !! class="unsortable" | Geräte (Beispiel) !! class="unsortable" | Bemerkungen<br />
|-<br />
| [[FS20_Allgemein|FS20]] || SlowRF || 868,35MHz || AM || 1kHz || CU*, FHZ || {{Link2CmdRef|Anker=FS20|Label=FS20}} || - || -<br />
|-<br />
| FHT || SlowRF || 868,35MHz || AM || 1kHz || CU*, FHZ || {{Link2CmdRef|Anker=CUL_FHTTK|Label=FHTTK}}, {{Link2CmdRef|Anker=FHT|Label=FHT}} || Heizungsregelung || -<br />
|-<br />
| S300 || SlowRF || 868,35MHz || AM || 1kHz || CU*, FHZ || {{Link2CmdRef|Anker=CUL_WS|Label=CUL_WS}} || Temperatur-/Feuchtesensoren || -<br />
|-<br />
| HMS || SlowRF || 868,35MHz || AM || 1kHz || CU*O, FHZ || - || ?? || -<br />
|-<br />
| EM || SlowRF || 868,35MHz || AM || 1kHz || CU*, FHZ || {{Link2CmdRef|Anker=CUL_EM|Label=CUL_EM}} || Energiemonitore (Strom, Gas) || -<br />
|-<br />
| [[HomeMatic ]]|| HomeMatic || 868,3MHz || FM || 10kHz || CU*, [[HM-CFG-LAN_LAN_Konfigurations-Adapter|HMLan]], [[HM-CFG-USB_USB_Konfigurations-Adapter|HMUsb]] || {{Link2CmdRef|Anker=CUL_HM|Label=CUL_HM}} || [[:Kategorie:HomeMatic_Components|diverse]] || -<br />
|-<br />
| [[MAX|MAX!]] || MAX || 868,3MHz || FM || 20kHz || CU*, [[MAX#MAXLAN|MAXLAN]] || {{Link2CmdRef|Lang=de|Anker=MAX|Label=MAX}} || [[:Kategorie:MAX|Wandthermostat, Heizkörperthermostate, Fensterkontakt, Zwischenstecker]] || -<br />
|-<br />
| IT || - || 433MHz || AM? || 1kHz || CU*433, || - || - || -<br />
|-<br />
| Firmata WiFi || - || 2,4/5 GHz || || || || {{Link2CmdRef|Anker=FRM|Label=FRM}} || Arduino || -<br />
|-<br />
| SWAP || - || 868 (433/915) MHz || GFSK || 38.3835 Kbps || panStamp (+panStick) || {{Link2CmdRef|Anker=SWAP|Label=SWAP}} || RGB LED Driver, diverse Sensoren und Aktoren || -<br />
|-<br />
| [[:Kategorie:EnOcean Components|EnOcean]] || - || 315 / 868 / 902 / 928MHz || ASK || 125 kbit/s || {{Link2CmdRef|Anker=TCM|Label=TCM}} || {{Link2CmdRef|Anker=EnOcean|Label=EnOcean}} || Batterielose Funksensoren, diverse Aktoren || -<br />
|-<br />
| PCA || - || 868,35MHz || ?? || ?? || [[JeeLink]] || {{Link2CmdRef|Anker=PCA301|Label=PCA301}} || [[PCA301 Funkschaltsteckdose mit Energieverbrauchsmessung|PCA301]] || -<br />
|-<br />
| [[La Crosse]] || - || 868,35MHz || ?? || ?? || [[JeeLink]], LGW || {{Link2CmdRef|Anker=Lacrosse|Label=Lacrosse}} || LaCrosse IT+ (Technoline) Sensoren || -<br />
|-<br />
| ZigBee Light Link || - || 2,4 GHz || || || HUE Bridge (RaspBee) || {{Link2CmdRef|Anker=HUEBridge|Label=HUEBridge}} || Philips HUE und LightLink Lampen (auch Osram LIGHTIFY an der HUE-Bridge)|| [http://www.developers.meethue.com/documentation/how-hue-works]<br />
|-<br />
| [[MySensors]] || - || 2,4 GHz || || || MySensors Gateway || [[MYSENSORS]] || [http://www.mysensors.org/build/ Selbstbau-Sensoren] || -<br />
|-<br />
| [[:Kategorie:Z-Wave Components|Z-Wave]] || - || 868MHz || 2-FSK || 9.600 bit/s oder 40 Kbit/s || {{Link2CmdRef|Anker=ZWDongle|Label=ZWDongle}} || {{Link2CmdRef|Anker=ZWave|Label=ZWave}} || - || -<br />
|-<br />
| [[WMBUS]] || WMBus_T, WMBus_S || 868MHz || ?? || 100 kbit/s / 32.768 kbit/s || CU* || {{Link2CmdRef|Anker=WMBUS|Label=WMBUS}} || Wasseruhren, Wärmezähler, Elektrozähler || - <br />
|-<br />
| colspan="9" | ''Tabelle muss noch vervollständigt werden''<br />
|-<br />
| colspan="2" | '''Legende:''' <br />
| colspan="7" | CU* = CUL, CUN, CUNO / <br />
|}<br />
<br />
{| class="wikitable sortable"<br />
|+ Übersicht über drahtgebundene Systeme<br />
|-<br />
! Name !! class="unsortable" | Interfaces (Hardware) !! class="unsortable" | Modul !! class="unsortable" | Geräte (Beispiel) !! class="unsortable" | Bemerkungen<br />
|-<br />
| [[1-Wire]] || [[Interfaces für 1-Wire|diverse]] || {{Link2CmdRef|Anker=OWX|Label=OWX}} || [[:Kategorie:1-Wire|1-Wire]] || -<br />
|-<br />
| [[EIB_/_KNX|EIB/KNX]] || {{Link2CmdRef|Anker=TUL|Label=TUL}} || {{Link2CmdRef|Anker=EIB|Label=EIB}} || [[:Kategorie:EIB/KNX|EIB/KNX]] || -<br />
|-<br />
| Firmata || RS-232, USB, Ethernet || {{Link2CmdRef|Anker=FRM|Label=FRM}} || Arduino || -<br />
|-<br />
| [[HomeMatic Wired]] || [[HomeMatic Wired RS485 LAN Gateway|HM485 LAN Gateway]] || {{Link2CmdRef|Anker=HM485_LAN|Label=HM485_LAN}} || [[:Kategorie:HomeMatic Components|Präfix HMW]] || -<br />
|-<br />
| colspan="5" | ''Tabelle muss noch vervollständigt werden''<br />
|-<br />
| colspan="2" | '''Legende:''' <br />
| colspan="3" | ...<br />
|}<br />
<br />
== Komponenten ==<br />
Der eigentliche Zweck eines Hausautomatisierungs-Projekts sind dann letztendlich die '''Geräte''' (Komponenten / Aktoren / [[:Kategorie:Schalter (Empfänger)|Empfänger]]), die automatisch gesteuert werden sollen, bzw. auch Auslöser für Aktionen ([[:Kategorie:Schalter (Sender)|Sender]]) und Lieferant von Datenmaterial ([[:Kategorie:Hardware Typen|Sensoren]]) sind.<br />
<br />
Diese Geräte sind, sofern es eine detaillierte Beschreibung dazu gibt, in den jeweiligen Unterseiten der [[:Kategorie:Hardware|Hardwareliste]] aufgeführt.<br />
<br />
== Weblinks ==<br />
* [http://www.enocean.com/de/home/ EnOcean] Homepage<br />
* [http://www.elv.de ELV], (Haupt-)Lieferant von FS20, FHT, HomeMatic, MAX!<br />
* [https://github.com/firmata/protocol Firmata] Protokoll<br />
* [http://www.panstamp.com panStamp], panStamp Hersteller<br />
* [http://jeelabs.com/products/jeelink Jeelabs], JeeLink Hersteller<br />
* [http://www.zigbee.org/ Zigbee] Homepage<br />
<br />
[[Kategorie:FHEM]]<br />
[[Kategorie:FHEM-Verwendung]]</div>JensBhttp://wiki.fhem.de/w/index.php?title=Arduino_Firmata&diff=25196Arduino Firmata2018-02-11T18:59:49Z<p>JensB: Beschreibungen an die aktuellen Versionen von Arduino-IDE, Firmata, FHEM und Boards angepasst.</p>
<hr />
<div>== Arduino mit Firmata ==<br />
Für Arduinos (und diverse Arduino kompatible Boards) gibt es eine Standardimplementierung des Kommunikationsprotokolls ''Firmata'' [https://github.com/firmata/protocol]. Mit Hilfe des Perl-Moduls ''Device::Firmata'', auch bekannt als perl-firmata [https://github.com/ntruchsess/perl-firmata], kann das Firmata-Protokoll in Perl genutzt werden und mit dem Modul [[#FRM|FRM]] auch in FHEM.<br />
<br />
Für die Kommunikation zwischen FHEM (Master) und Arduino (Slave) stehen mehrere Schnittstellen zur Auswahl: RS-232, USB, Ethernet und WiFi. Insbesondere Ethernet und WiFi erlauben die Integration dezentraler IO-Periperie mit FHEM.<br />
<br />
Firmata möglich es, mit nur geringen Arduino-Kenntnissen digitale und analoge Signale aus eigenen Schaltungen in FHEM zu verarbeiten. Dabei können Signale sowohl eingelesen als auch ausgegeben werden. Ein Verständnis der Bedienung der Arduino-IDE und elektronische Kenntnisse zum Anschluss von Sensoren und Aktoren sind natürlich erforderlich.<br />
<br />
=== Arduino IDE ===<br />
Zur Installation von Firmware auf den Arduino wird natürlich erst mal die Arduino-IDE (Version 1.8 oder höher) benötigt [https://www.arduino.cc/en/main/software]. Die gibt es für die Betriebssysteme Windows, Mac OS X und Linux.<br />
<br />
Über die Bibliotheksverwaltung der Arduino-IDE (Menü 'Sketch'-&gt;'Bibliothek einbinden'-&gt;'Bibliotheken verwalten...') stehen verschiedene Firmware-Versionen von Firmata zur Auswahl. Im folgenden wird auf die Version "Firmata by Firmata Developers" und "ConfigurableFirmata by Firmata Developers" eingegangen. Diese beiden Versionen unterscheiden sich in den unterstützten Hardware-Funktionen:<br />
<br />
* Firmata: digitale und analoge I/Os, Servos, I2C<br />
* ConfigurableFirmata: zusätzlich 1-Wire und Schrittmotoren<br />
<br />
Bei ConfigurableFirmata ist es auch außerdem einfacher, nicht benötigte Funktionen zu deaktivieren, damit die Arduino-Firmware möglichst wenig Speicher belegt. Wenn man den zusätzlichen Funktionsumfang von ConfigurableFirmata nicht benötigt, kann man mit etwas Geschick durch Auskommentieren von nicht benötigtem Code aus Firmata z.T. ein noch kompakteres Ergebnis erzielen (das ist aber nur etwas für Fortgeschrittene).<br />
<br />
Bei Firmata ist zwischen der Firmata-Protokoll-Version (aktuell 2.6.0) und der Version der jeweiligen Firmware (Firmata: aktuell 2.5.7, ConfigurableFirmata: aktuell 2.10.0) zu unterscheiden, die insbesondere bei ConfigurableFirmata voneinander unabhängig sind.<br />
<br />
Nach Installation der gewünschten Firmata-Firmware wählt man eines der funktionsfertigen Beispiele über das Arduino-IDE Menü 'Datei'-&gt;'Beispiele'-&gt;'Firmata' bzw. 'Datei'-&gt;'Beispiele'-&gt;'ConfigurableFirmata' aus. Je nach ausgewähltem Beispielprojekt sind noch Anpassungen direkt im Sketch oder in einer zusätzlichen Konfigurationsdatei erforderlich (z.B. um für Ethernet- und WiFi-Schnittstellen die Netzwerkparameter einzustellen).<br />
<br />
Über das Arduino-IDE Menü 'Werkzeuge'-&gt;'Bords' wählt man das Board aus, das dem eigenen Arduino entspricht. Fehlt das Board in der Auswahl, kann die erforderliche Unterstützung oft über das Menü 'Werkzeuge'-&gt;'Bords'-&gt;'Boardverwalter...' nachinstalliert werden. Ansonsten hilft ein Blick auf die Hersteller-Webseiten des Boards.<br />
<br />
Ist der Arduino korrekt angeschlossen, drückt man den 'Upload'-Knopf (der mit dem Rechspfeil oben link), um den Arduino-Sketch zu kompilieren und auf das Board hochzuladen. Die Vorgehensweise zum Hochladen ist sehr stark davon abhängig, welches Board man verwendet und mit welcher Technik es angeschlossen ist. Bitte die jeweiligen Angaben des Board-Herstellers beachten.<br />
<br />
Wer zum ersten mal mit der Arduino-IDE arbeitet, sollte statt Firmata zunächst das Standard Arduino Beispielprojekt 'Blink' auswählen und es auf dem Arduino installieren. Sobald das klappt, kann man mit Firmata weiter machen.<br />
<br />
=== Firmata mit Ethernet oder WiFi ===<br />
<br />
Vor dem Kompilieren muss man unbedingt die Netzwerkparameter anpassen, d.h. die IP-Adresse des FHEM-Servers und den Port des FRM-Moduls eintragen (ggf. auch eine neue eindeutige MAC-Adresse), bei WiFi auch die SSID und den PSK. In älteren Firmata-Versionen und bei ConfigurableFirmata geschieht das direkt im Sketch. Aktuelle Firmata-Versionen haben dazu eine getrennte Konfigurationsdatei (ethernetConfig.h bzw. wifiConfig.h), so dass keine Änderungen am Sketch erforderlich sind.<br />
<br />
Falls der Speicherbedarf der kompilierten Arduino-Firmware die Möglichkeiten des Boards übersteigt (insbesondere bei Verwendung eines ENC28J60-Ethernet-Shields [https://github.com/ntruchsess/arduino_uip] in Kombination mit einem "kleinen" Arduiono wie den Uno oder Nano) kann man bei Verwendung von ConfigurableFirmata nicht benötigten Features im Sketch auskommentieren. Wenn der Speicherbedarf nur "knapp" ausreicht, läuft die Firmware u.U. trotzdem nicht zuverlässig.<br />
<br />
Als ersten Funktionstest für die Netzwerkverbindung empfiehlt sich ein Ping von FHEM zum Arduino.<br />
<br />
=== Sonderfälle ===<br />
<br />
Je nach verwendetem Board sind u.U. individuelle Besonderheiten zu berücksichtigen. Hier ein paar Beispiele:<br />
<br />
Ein MEGA256 z.B. benutzt einen anderen Pin als SS (Slave select) zur Kommunikation mit dem Ethernetmodul. Man muss der Firmata im Setup mitteilen, welche Pins zu ignorieren sind, damit es keine Wechselwirkungen zwischen Firmata und Ethernet Library gibt. Das ist im ConfigurableFirmata-Sketch [https://github.com/firmata/arduino/blob/configurable/examples/ConfigurableFirmata/ConfigurableFirmata.ino] vorbereitet und muss (wenn man etwas anderes als ein Standard-Ethernetshield am Uno verwendet) geeignet angepasst werden (Beim Mega muss man z.B. den Pin 10 ignorieren und Pin 53 als hardcodiert auf Output stellen). Das gleiche gilt, wenn man eine andere Hardware (z.B. mit ENC28J60 anstelle des WizNet W5100 des Ethernetshields) benutzen möchte, die einen anderen Pin als CS/SS benutzt.<br />
<br />
== FRM ==<br />
Der Arduino wird in FHEM über das Modul 10_FRM.pm angesprochen. 10_FRM ist für andere FHEM-Module die Schnittstelle (das IODev) zum Arduino. Es lassen sich jeweils so viele Ein/Ausgabe Devices pro Arduino konfigurieren, wie dieser physikalisch besitzt (natürlich muss man darauf achten, dass nicht alle Arduino-Pins alle Ein-/Ausgabemöglichkeiten besitzen). Konfiguriert man einen Pin für einen nicht unterstützen Modus so gibt es mit der aktuellen Firmata-Version direkt einen Fehler - ältere Versionen (vor 2.3) schlucken Fehlkonfigurationen einfach so, der betreffende Pin funktioniert dann aber nicht.<br />
<br />
Hier ein kurzer Ausschnitt aus der fhem.cfg:<br />
<br />
<hr /><br />
<nowiki># definiere FRM mit USB-Schnittstelle /dev/ttyUSB0, Baudrate 57600 ist Default für StandardFirmata<br />
define FIRMATA FRM /dev/ttyUSB0@57600</nowiki><br />
<br />
<nowiki># definiere FRM mit TCP/IP-Schnittstelle auf Port 3030<br />
define FIRMATA FRM 3030 global</nowiki><br />
FRM macht bei Netzwerkverbindungen FHEM-seitig einen Serverport auf (dieser wird in der define-Zeile angegeben). 'global' muss zusätzlich angegeben werden, damit der Serversocket an alle IP-addressen gebunden wird. (Sonst wird nur 'localhost' verwendet, was nicht funktionieren würde). Der Arduino verbindet sich aktiv zu diesem Port, sonst gilt im Prinzip alles was auch für den über USB angebunden Arduino gilt.<br />
<br />
<nowiki># für alle analogen Eingangs-Pins<br />
attr FIRMATA sampling-interval 1000 # [ms] - maximal 16384 setzbar</nowiki><br />
<br />
siehe auch: {{Link2CmdRef|Anker=FRM}} FRM<br />
=== 20_FRM_IN.pm ===<br />
Macht einen Arduino-pin als digitalen Eingang nutzbar.<br />
<nowiki>define Firmata_IN FRM_IN 12 # definiert Arduino Pin 12 als digitalen Eingang</nowiki><br />
siehe auch: {{Link2CmdRef|Anker=FRM_IN}} FRM_IN<br />
=== 20_FRM_OUT.pm ===<br />
Macht einen Arduino-pin als digitalen Ausgang nutzbar.<br />
<nowiki>define Firmata_OUT FRM_OUT 11 # definiert Arduino Pin 11 als digitalen Ausgang</nowiki><br />
siehe auch: {{Link2CmdRef|Anker=FRM_OUT}} FRM_OUT<br />
=== 20_FRM_AD.pm ===<br />
Macht einen Arduino-pin als analogen Eingang nutzbar.<br />
<nowiki>define Firmata_ANALOG FRM_AD 17 # definiert Arduino Pin 17 als analogen Eingang</nowiki><br />
siehe auch: {{Link2CmdRef|Anker=FRM_AD}} FRM_AD<br />
=== 20_FRM_PWM.pm ===<br />
Macht einen Arduino-pin als analogen Ausgang nutzbar. Es wird ein pulsweitenmoduliertes Signal ausgegeben.<br />
<nowiki>define Firmata_ANALOG FRM_PWM 10 # definiert Arduino Pin 10 als analogen Ausgang</nowiki><br />
siehe auch: {{Link2CmdRef|Anker=FRM_PWM}} FRM_PWM<br />
=== 20_FRM_SERVO.pm ===<br />
Erlaubt die Ansteuerung von analogen Modelbauservos (Ansteuerung über PWM) am Arduino.<br />
<nowiki>define Firmata_ANALOG FRM_AD 9 # definiert Arduino Pin 9 als analogen Eingang</nowiki><br />
siehe auch: {{Link2CmdRef|Anker=FRM_SERVO}} FRM_SERVO<br />
=== 20_FRM_I2C.pm ===<br />
<p>Erlaubt das Auslesen von über I2C angeschlossenen ICs</p><br />
siehe auch: {{Link2CmdRef|Anker=FRM_I2C}}FRM_I2C<br />
=== Arduino mit OneWireFirmata ===<br />
<p>die Seite [[Arduino mit OneWireFirmata]] beschreibt, wie es möglich ist, mit einer um OneWire erweiterten Version der Standard Firmata an den Arduino angeschlossene 1-Wire Devices in FHEM einzubinden.</p><br />
siehe auch: {{Link2CmdRef|Anker=OWX}} OWX<br />
<br />
[[Kategorie:Other_Components]]<br />
[[Kategorie:Arduino]]<br />
[[Kategorie:HOWTOS]]</div>JensB