\n
- \n";
+ $html .= "Aktuelle Wetterkarte: Wetterlage
\n"; + $html .= "Aktuelle Wetterkarte: Vorhersage
\n"; + $html .= "Aktuelle Wetterkarte: Warnungen
\n"; + $html .= "Aktuelle Wetterkarte: Radarkarte
\n"; + $html.= "
GDS
+-
+
+ Prerequesits
+
- alerts: Delete all a_* readings +
- all: Delete all a_*, c_*, g_* and fc_* readings +
- condition readings generated by SET use prefix "c_" +
- forecast readings generated by SET use prefix "fcd_" and a postfix of "hh"
+ with d=relative day (0=today) and hh=last hour of forecast (exclusive)
+ - readings generated by SET will be updated automatically every 20 minutes + +
- capstations: Retrieve list showing all defined warning regions. + You can find your WARNCELLID with this list. +
- data: List current conditions for all available stations in one single table +
- stations: List all available stations that provide conditions data +
- report type VHDL30 = regular report, issued daily +
- report type VHDL31 = regular report, issued before weekend or national holiday +
- report type VHDL32 = preliminary report, issued on special conditions +
- report type VHDL33 = cancel report, issued if necessary to cancel VHDL32 +
- do_not_notify +
- readingFnAttributes +
- disable - if set, gds will not try to connect to internet +
- gdsAll - defines filter for "all data" from alert message +
- gdsDebug - defines filter for debug informations +
- gdsSetCond - defines conditions area to be used after system restart +
- gdsSetForecast - defines forecasts region/station to be used after system restart +
- gdsLong - show long text fields "description" and "instruction" from alert message in readings +
- gdsPolygon - show polygon data from alert message in a reading +
- gdsHideFiles - if set to 1, the "GDS Files" menu in the left navigation bar will not be shown +
- gdsPassiveFtp - set to 1 to use passive FTP transfer +
- gdsFwName - define firewall hostname in format <hostname>:<port> +
- gdsFwType - define firewall type in a value 0..7 please refer to + cpan documentation + for further informations regarding firewall settings. +
- _<readingName> - debug informations +
- a_X_<readingName> - weather data from CAP alert messages. Readings will NOT be updated automatically
+ a_ readings contain a set of alert inforamtions, X represents a numeric set identifier starting with 0
+ that will be increased for every valid alert message in selected area
+ - a_count - number of currently valid alert messages, can be used for own loop iterations on alert messages +
- a_valid - returns 1 if at least one of decoded alert messages is valid +
- c_<readingName> - weather data from SET weather conditions. + Readings will be updated every 20 minutes. +
- fc?_<readingName>?? - weather data from SET weather forecasts,
+ prefix by relative day and postfixed by last hour. Readings will be updated every 20 minutes.
+-
+
- 0_weather06 and ?_weather12 (with ? greater 0) is the weather in the morning +
- 0_weather12 is the weather at noon +
- 0_weather18 and ?_weather24 (with ? greater 0) is the weather in the afternoon +
- 0_weather24 is the weather at midnight +
- 0_windGust06 and ?_windGust12 (with ? greater 0) is the wind in the morning +
- 0_windGust12 is the wind at noon +
- 0_windGust18 and ?_windGust24 (with ? greater 0) is the wind in the afternoon +
- 0_windGust24 is the wind at midnight +
- ?_tMinAir is minimum temperature in the morning +
- 0_tAvgAir12 is the average temperature at noon +
- ?_tMaxAir is the maximum temperature in the afternoon +
- 0_tAvgAir24 is the average temperature at midnight +
+ - g_<readingName> - weather data from GET weather conditions. + Readings will NOT be updated automatically +
- Module uses following additional Perl modules:
+Net::FTP, XML::Simple
+ If not already installed in your environment, please install them using appropriate commands from your environment.
+ - Have fun!
-
+
+
+ Module uses following additional Perl modules:
+
Net::FTP, XML::Simple+ If not already installed in your environment, + please install them using appropriate commands from your environment. + +
+ + + Define +
-
+
+
+
define <name> GDS <username> <password> [<host>]+
+ This module provides connection to GDS service + generated by DWD
+
+ Optional paramater host is used to overwrite default host "ftp-outgoing2.dwd.de".
+
+
+ + + Set-Commands
+
-
+
+
+
set <name> clear alerts|conditions|forecasts|all
+ +
-
+
+ +
set <name> conditions <stationName>
+ +
- Retrieve current conditions at selected station. Data will be updated periodically.
+ +
set <name> forecasts <region>/<stationName>
+ +
- Retrieve forecasts for today and the following 3 days for selected station.
+ Data will be updated periodically.
+ +
set <name> help
+ +
- Show a help text with available commands
+ +
set <name> update
+ +
- Update conditions and forecasts readings at selected station and restart update-timer
+ +
+ + + Get-Commands
+
-
+
+
+
get <name> alerts <region>
+ +
- Retrieve alert message for selected region from previously read alert file (see rereadcfg)
+ +
get <name> conditions <stationName>
+ +
- Retrieve current conditions at selected station
+ +
get <name> forecasts <region>
+ +
- Retrieve forecasts for today and the following 3 days for selected region as text
+ +
get <name> conditionsmap <region>
+ +
- Retrieve map (imagefile) showing current conditions at selected station
+ +
get <name> forecastsmap <stationName>
+ +
- Retrieve map (imagefile) showing forecasts for selected region
+ +
get <name> headlines
+ +
- Returns a string, containing all alert headlines separated by |
+ +
get <name> help
+ +
- Show a help text with available commands
+ +
get <name> list capstations|data|stations
+ +
-
+
+ +
get <name> radarmap <region>
+ +
- Retrieve map (imagefile) containig radar view from selected region
+ +
get <name> rereadcfg
+ +
- Reread all required data from DWD Server manually: station list and CAP data
+ +
get <name> warnings <region>
+ +
- Retrieve current warnings report for selected region
+
-
+
+
+ +
get <name> warningssmap <region>
+ +
- Retrieve map (imagefile) containig current warnings for selected region marked with symbols
+ All downloaded mapfiles can be found inside "GDS Files" area in left navigation bar. + +
+ + + Attributes
+
-
+
+
+
+ + Generated Readings/Events: +
+
-
+
+ + Author's notes
+
-
+
+
+
+ +
GDS
+-
+Sorry, keine deutsche Dokumentation vorhanden.
+Die englische Doku gibt es hier: GDS
+
" + if(!$defs{$d} || $defs{$d}{TYPE} ne "GDS"); + + my $width = int(ICONSCALE*ICONWIDTH); + + my $ret = sprintf('
| %s | Aktuell: %s %s°C Wind %s km/h %s |
| %s | %s: %s min %s°C %s |
| %s | %s: %s %s°C %s |
| %s | %s: %s max %s°C %s |
" + if(!$defs{$d} || $defs{$d}{TYPE} ne "GDS"); + + my $width = 110; + + my $ret = '
| Aktuell | '); + for(my $i=0; $i<$items; $i++) { + my $day = int(($i + 1)/2); + my $timeLabel = $i == 0? ($hour < 17? '18' : '24') : ($i - 1)%2 == 0? '12' : '24'; + my $weekday = $i == 0? ($hour < 17? 'Spät' : 'Nachts') : ($i - 1)%2 == 0? ReadingsVal($d, "fc".$day."_weekday", "").' früh' : ReadingsVal($d, "fc".$day."_weekday", "").' spät'; + $ret .= sprintf('%s | ', $weekday); + } + $ret .= '||
| %s | ', $width, GDSIconIMGTag(ReadingsVal($d, "c_weather", "na"), time_str2num(ReadingsTimestamp($d, "c_weather", TimeNow())))); + for(my $i=0; $i<$items; $i++) { + my $day = int(($i + 1)/2); + my $timeLabel = $i == 0? ($hour < 17? '18' : '24') : ($i - 1)%2 == 0? '12' : '24'; + $ret .= sprintf('%s | ', $width, GDSIconIMGTag(ReadingsVal($d, "fc".$day."_weather".$timeLabel, "na"), $i==0 && $hour >= 17? 1 : undef)); + } + $ret .= '||
| %s | ', ReadingsVal($d, "c_weather", "?")); + for(my $i=0; $i<$items; $i++) { + my $day = int(($i + 1)/2); + my $timeLabel = $i == 0? ($hour < 17? '18' : '24') : ($i - 1)%2 == 0? '12' : '24'; + $ret .= sprintf('%s | ', ReadingsVal($d, "fc".$day."_weather".$timeLabel, "?")); + } + $ret .= '||
| %s°C | ', ReadingsVal($d, "c_temperature", "?")); + for(my $i=0; $i<$items; $i++) { + my $day = int(($i + 1)/2); + my $timeLabel = $i == 0? ($hour < 17? '18' : '24') : ($i - 1)%2 == 0? '12' : '24'; + if (($i - 1)%2 == 0) { + $ret .= sprintf('min %s°C | ', ReadingsVal($d, "fc".$day."_tMinAir", "?")); + } else { + if ($i == 0 && $hour >= 17) { + $ret .= sprintf('%s°C | ', ReadingsVal($d, "fc".$day."_tAvgAir".$timeLabel, "?")); + } else { + $ret .= sprintf('max %s°C | ', ReadingsVal($d, "fc".$day."_tMaxAir", "?")); + } + } + } + $ret .= '
| %s km/h %s | ', ReadingsVal($d, "c_windSpeed", "?"), ReadingsVal($d, "c_windDir", "?")); + for(my $i=0; $i<$items; $i++) { + my $day = int(($i + 1)/2); + my $timeLabel = $i == 0? ($hour < 17? '18' : '24') : ($i - 1)%2 == 0? '12' : '24'; + $ret .= sprintf('%s | ', ReadingsVal($d, "fc".$day."_windGust".$timeLabel, "")); + } + $ret .= "
gdsUtils
+-
+
- This module provides three additional functions:
+GDSAsHtmlV,GDSAsHtmlHandGDSAsHtmlD.
+ The first function returns the HTML code for a vertically arranged weather forecast.
+ The second function returns the HTML code for a horizontally arranged weather forecast.
+ The third function dynamically picks the orientation depending on whether a
+ smallscreen style is set (vertical layout) or not (horizontal layout).
+ The attributes gdsSetCond and gdsSetForecast must be configured for the functions to work.
+ Each of these functions accepts an additional parameter to limit the number of icons to display (1...8).
+ If the attribute gdsSetForecast is not configured this parameter should be set to 1.
+
+ Example:define MyForecastWeblink weblink htmlCode { GDSAsHtml("MyWeather") }
+ where "MyWeather" is the name of your GDS device.
+
+