mirror of
https://github.com/fhem/fhem-mirror.git
synced 2025-04-17 11:26:03 +00:00
Proplanta: docu
git-svn-id: https://svn.fhem.de/fhem/trunk@6896 2b470e98-0d58-463d-a4d8-8e2adae1ed80
This commit is contained in:
tpoitzsch
parent
37542f43fc
commit
dc0133130d
@ -570,59 +570,58 @@ sub PROPLANTA_Aborted($)
|
|||||||
<h3>PROPLANTA</h3>
|
<h3>PROPLANTA</h3>
|
||||||
<div style="width:800px">
|
<div style="width:800px">
|
||||||
<ul>
|
<ul>
|
||||||
The module extracts weather data from <a href="http://www.proplanta.de">www.proplanta.de</a>.
|
The module extracts weather data from <a href="http://www.proplanta.de">www.proplanta.de</a>.
|
||||||
<br>
|
<br>
|
||||||
It requires the perl moduls HTTP::Request and LWP::UserAgent.
|
It requires the perl moduls HTTP::Request and LWP::UserAgent.
|
||||||
<br>
|
<br/><br/>
|
||||||
|
<a name="PROPLANTAdefine"></a>
|
||||||
<br>
|
<b>Define</b>
|
||||||
<a name="PROPLANTAdefine"></a>
|
<ul>
|
||||||
<b>Define</b>
|
|
||||||
<ul>
|
|
||||||
<code>define <name> PROPLANTA [City] [CountryCode]</code>
|
|
||||||
<br>
|
|
||||||
Example:
|
|
||||||
<br>
|
|
||||||
<code>define wetter PROPLANTA Bern ch</code>
|
|
||||||
<br>
|
|
||||||
<code>define wetter PROPLANTA Wittingen+(Niedersachsen)</code>
|
|
||||||
<br>
|
|
||||||
<li><code>[City]</code> <i>(optional)</i>
|
|
||||||
<br>
|
<br>
|
||||||
The city must be selectable on <a href="http://www.proplanta.de">www.proplanta.de</a>.
|
<code>define <name> PROPLANTA [City] [CountryCode]</code>
|
||||||
<br>
|
<br>
|
||||||
Please pay attention to the <b>Capital</b> letters in the city names.
|
Example:
|
||||||
Spaces within the name are replaced by a + (plus).
|
|
||||||
</li><br>
|
|
||||||
<li><code>[CountryCode]</code> <i>(optional)</i>
|
|
||||||
<br>
|
<br>
|
||||||
Possible values: de (default), at, ch, fr, it
|
<code>define wetter PROPLANTA Bern ch</code>
|
||||||
</li><br>
|
<br>
|
||||||
</ul>
|
<code>define wetter PROPLANTA Wittingen+(Niedersachsen)</code>
|
||||||
<br>
|
<br>
|
||||||
|
<li><code>[City]</code>
|
||||||
|
<br>
|
||||||
|
Optional. The city must be selectable on <a href="http://www.proplanta.de">www.proplanta.de</a>.
|
||||||
|
<br>
|
||||||
|
Please pay attention to the <b>Capital</b> letters in the city names.
|
||||||
|
Spaces within the name are replaced by a + (plus).
|
||||||
|
</li><br>
|
||||||
|
<li><code>[CountryCode]</code>
|
||||||
|
<br>
|
||||||
|
Optional. Possible values: de (default), at, ch, fr, it
|
||||||
|
</li><br>
|
||||||
|
</ul>
|
||||||
|
<br>
|
||||||
|
|
||||||
<a name="PROPLANTAset"></a>
|
<a name="PROPLANTAset"></a>
|
||||||
<b>Set</b>
|
<b>Set</b>
|
||||||
<br>
|
|
||||||
<ul>
|
<ul>
|
||||||
<li><code>set <name> update</code>
|
|
||||||
<br>
|
<br>
|
||||||
The weather data are immediately polled from the website.
|
<li><code>set <name> update</code>
|
||||||
|
<br>
|
||||||
|
The weather data are immediately polled from the website.
|
||||||
</li><br>
|
</li><br>
|
||||||
</ul>
|
</ul>
|
||||||
<br>
|
<br>
|
||||||
|
|
||||||
<a name="PROPLANTAattr"></a>
|
<a name="PROPLANTAattr"></a>
|
||||||
<b>Attributes</b>
|
<b>Attributes</b>
|
||||||
<br>
|
|
||||||
<ul>
|
<ul>
|
||||||
<li><code>Interval <seconds></code>
|
|
||||||
<br>
|
<br>
|
||||||
Poll interval for weather data in seconds (default 3600 = 1 hour)
|
<li><code>Interval <seconds></code>
|
||||||
|
<br>
|
||||||
|
Poll interval for weather data in seconds (default 3600 = 1 hour)
|
||||||
</li><br>
|
</li><br>
|
||||||
<li><code>URL <internet address></code>
|
<li><code>URL <internet address></code>
|
||||||
<br>
|
<br>
|
||||||
URL to extract information from. Overwrites the values in the 'define' term.
|
URL to extract information from. Overwrites the values in the 'define' term.
|
||||||
</li><br>
|
</li><br>
|
||||||
<li><a href="#readingFnAttributes">readingFnAttributes</a></li>
|
<li><a href="#readingFnAttributes">readingFnAttributes</a></li>
|
||||||
</ul>
|
</ul>
|
||||||
@ -630,10 +629,10 @@ sub PROPLANTA_Aborted($)
|
|||||||
|
|
||||||
<a name="PROPLANTAreading"></a>
|
<a name="PROPLANTAreading"></a>
|
||||||
<b>Forecast readings</b>
|
<b>Forecast readings</b>
|
||||||
<br>
|
|
||||||
<ul>
|
<ul>
|
||||||
|
<br>
|
||||||
<li><b>fc</b><i>0|1|2|3</i><b>_...</b> - forecast values for <i>today|tommorrow|in 2|3 days</i></li>
|
<li><b>fc</b><i>0|1|2|3</i><b>_...</b> - forecast values for <i>today|tommorrow|in 2|3 days</i></li>
|
||||||
<li><b>fc</b><i>0|1|2|3</i><b>_chOfRain</b><i>Day|Night</i> - chance of rain <i>today|tommorrow|in 2|3 days</i> by <i>day|night</i> in %</li>
|
<li><b>fc</b><i>0</i><b>_chOfRain</b><i>Day|Night</i> - chance of rain <i>today</i> by <i>day|night</i> in %</li>
|
||||||
<li><b>fc</b><i>0</i><b>_chOfRain</b><i>15</i> - chance of rain <i>today</i> at <i>15:00</i> in %</li>
|
<li><b>fc</b><i>0</i><b>_chOfRain</b><i>15</i> - chance of rain <i>today</i> at <i>15:00</i> in %</li>
|
||||||
<li><b>fc</b><i>0</i><b>_cloud</b><i>15</i> - cloud coverage <i>today</i> at <i>15:00</i> in %</li>
|
<li><b>fc</b><i>0</i><b>_cloud</b><i>15</i> - cloud coverage <i>today</i> at <i>15:00</i> in %</li>
|
||||||
<li><b>fc</b><i>0</i><b>_dew</b> - dew formation <i>today</i> (0=none, 1=small, 2=medium, 3=strong)</li>
|
<li><b>fc</b><i>0</i><b>_dew</b> - dew formation <i>today</i> (0=none, 1=small, 2=medium, 3=strong)</li>
|
||||||
@ -643,7 +642,7 @@ sub PROPLANTA_Aborted($)
|
|||||||
<li><b>fc</b><i>0</i><b>_rad</b> - global radiation <i>today</i></li>
|
<li><b>fc</b><i>0</i><b>_rad</b> - global radiation <i>today</i></li>
|
||||||
<li><b>fc</b><i>0</i><b>_rain</b><i>15</i> - amount of rainfall <i>today</i> at <i>15:00</i> in mm</li>
|
<li><b>fc</b><i>0</i><b>_rain</b><i>15</i> - amount of rainfall <i>today</i> at <i>15:00</i> in mm</li>
|
||||||
<li><b>fc</b><i>0</i><b>_sun</b> - relative sun shine duration <i>today</i> in % (between sun rise and set)</li>
|
<li><b>fc</b><i>0</i><b>_sun</b> - relative sun shine duration <i>today</i> in % (between sun rise and set)</li>
|
||||||
<li><b>fc</b><i>0</i><b>_temp<i>Min|Max</i>C</b> - <i>minimal|maximal</i> temperature <i>today</i> in °C</li>
|
<li><b>fc</b><i>0</i><b>_temp</b><i>Min|Max</i><b>C</b> - <i>minimal|maximal</i> temperature <i>today</i> in °C</li>
|
||||||
<li><b>fc</b><i>0</i><b>_temp</b><i>15</i><b>C</b> - temperatur <i>today</i> at <i>15:00</i> in °C</li>
|
<li><b>fc</b><i>0</i><b>_temp</b><i>15</i><b>C</b> - temperatur <i>today</i> at <i>15:00</i> in °C</li>
|
||||||
<li><b>fc</b><i>0</i><b>_uv</b> - UV-Index <i>today</i></li>
|
<li><b>fc</b><i>0</i><b>_uv</b> - UV-Index <i>today</i></li>
|
||||||
<li><b>fc</b><i>0</i><b>_weather</b><i>Morning|Day|Evening|Night</i> - weather situation <i>today morning|during day|in the evening|during night</i></li>
|
<li><b>fc</b><i>0</i><b>_weather</b><i>Morning|Day|Evening|Night</i> - weather situation <i>today morning|during day|in the evening|during night</i></li>
|
||||||
@ -663,14 +662,13 @@ sub PROPLANTA_Aborted($)
|
|||||||
<div style="width:800px">
|
<div style="width:800px">
|
||||||
<ul>
|
<ul>
|
||||||
<a name="PROPLANTAdefine"></a>
|
<a name="PROPLANTAdefine"></a>
|
||||||
Das Modul extrahiert Wetterdaten von der website <a href="http://www.proplanta.de">www.proplanta.de</a>.<br/>
|
Das Modul extrahiert Wetterdaten von der website <a href="http://www.proplanta.de">www.proplanta.de</a>.
|
||||||
<br>
|
<br/>
|
||||||
Es benötigt die Perlmodule HTTP::Request und LWP::UserAgent.
|
Es benötigt die Perlmodule HTTP::Request und LWP::UserAgent.
|
||||||
<br>
|
<br/><br/>
|
||||||
|
|
||||||
<br>
|
|
||||||
<b>Define</b>
|
<b>Define</b>
|
||||||
<ul>
|
<ul>
|
||||||
|
<br>
|
||||||
<code>define <Name> PROPLANTA [Stadt] [Ländercode]</code>
|
<code>define <Name> PROPLANTA [Stadt] [Ländercode]</code>
|
||||||
<br>
|
<br>
|
||||||
Beispiel:
|
Beispiel:
|
||||||
@ -679,16 +677,16 @@ sub PROPLANTA_Aborted($)
|
|||||||
<br>
|
<br>
|
||||||
<code>define wetter PROPLANTA Wittingen+(Niedersachsen)</code>
|
<code>define wetter PROPLANTA Wittingen+(Niedersachsen)</code>
|
||||||
<br>
|
<br>
|
||||||
<li><code>[Stadt]</code> <i>(optional)</i>
|
<li><code>[Stadt]</code>
|
||||||
<br>
|
<br>
|
||||||
Die Stadt muss auf <a href="http://www.proplanta.de">www.proplanta.de</a> auswählbar sein.
|
Optional. Die Stadt muss auf <a href="http://www.proplanta.de">www.proplanta.de</a> auswählbar sein.
|
||||||
<br>
|
<br>
|
||||||
Wichtig!! Auf die <b>großen</b> Anfangsbuchstaben achten.
|
Wichtig!! Auf die <b>großen</b> Anfangsbuchstaben achten.
|
||||||
Leerzeichen im Stadtnamen werden durch ein + (Plus) ersetzt.
|
Leerzeichen im Stadtnamen werden durch ein + (Plus) ersetzt.
|
||||||
</li><br>
|
</li><br>
|
||||||
<li><code>[Ländercode]</code> <i>(optional)</i>
|
<li><code>[Ländercode]</code>
|
||||||
<br>
|
<br>
|
||||||
Mögliche Werte: de (Standard), at, ch, fr, it
|
Optional. Mögliche Werte: de (Standard), at, ch, fr, it
|
||||||
</li><br>
|
</li><br>
|
||||||
</ul>
|
</ul>
|
||||||
<br>
|
<br>
|
||||||
@ -696,6 +694,7 @@ sub PROPLANTA_Aborted($)
|
|||||||
<a name="PROPLANTAset"></a>
|
<a name="PROPLANTAset"></a>
|
||||||
<b>Set</b>
|
<b>Set</b>
|
||||||
<ul>
|
<ul>
|
||||||
|
<br>
|
||||||
<li><code>set <name> update</code>
|
<li><code>set <name> update</code>
|
||||||
<br>
|
<br>
|
||||||
Startet sofort ein neues Auslesen der Wetterdaten.
|
Startet sofort ein neues Auslesen der Wetterdaten.
|
||||||
@ -705,6 +704,7 @@ sub PROPLANTA_Aborted($)
|
|||||||
<a name="PROPLANTAattr"></a>
|
<a name="PROPLANTAattr"></a>
|
||||||
<b>Attribute</b>
|
<b>Attribute</b>
|
||||||
<ul>
|
<ul>
|
||||||
|
<br>
|
||||||
<li><code>INTERVAL <Abfrageinterval></code>
|
<li><code>INTERVAL <Abfrageinterval></code>
|
||||||
<br>
|
<br>
|
||||||
Abfrageinterval in Sekunden (Standard 3600 = 1 Stunde)
|
Abfrageinterval in Sekunden (Standard 3600 = 1 Stunde)
|
||||||
@ -721,15 +721,15 @@ sub PROPLANTA_Aborted($)
|
|||||||
<a name="PROPLANTAreading"></a>
|
<a name="PROPLANTAreading"></a>
|
||||||
<b>Vorhersagewerte</b>
|
<b>Vorhersagewerte</b>
|
||||||
<ul>
|
<ul>
|
||||||
<li><b>fc</b><i>0|1|2|3</i><b>_...</b> - Vorhersagewerte für <i>heute|morgen|übermorgen|in 3 Tagen</i></li>
|
<br>
|
||||||
|
<li><b>fc</b><i>0|1|2|3</i><b>_...</b> - Vorhersagewerte für <i>heute|morgen|übermorgen|in 3 Tagen</i></li>
|
||||||
<li><b>fc</b><i>0</i><b>_chOfRain</b><i>Day|Night</i> - Niederschlagsrisiko <i>heute tagsüber|nachts</i> in %</li>
|
<li><b>fc</b><i>0</i><b>_chOfRain</b><i>Day|Night</i> - Niederschlagsrisiko <i>heute tagsüber|nachts</i> in %</li>
|
||||||
<li><b>fc</b><i>1</i><b>_chOfRain</b><i>15</i> - Niederschlagsrisiko <i>morgen</i> um <i>15</i>:00 Uhr in %</li>
|
<li><b>fc</b><i>1</i><b>_chOfRain</b><i>15</i> - Niederschlagsrisiko <i>morgen</i> um <i>15</i>:00 Uhr in %</li>
|
||||||
<li><b>fc</b><i>2</i><b>_cloud</b><i>15</i> - Wolkenbedeckungsgrad <i>übermorgen</i> um <i>15</i>:00 Uhr in %</li>
|
<li><b>fc</b><i>2</i><b>_cloud</b><i>15</i> - Wolkenbedeckungsgrad <i>übermorgen</i> um <i>15</i>:00 Uhr in %</li>
|
||||||
<li><b>fc</b><i>0</i><b>_dew</b> - Taubildung <i>heute</i> (0=keine, 1=leicht, 2=mäßig, 3=stark)</li>
|
<li><b>fc</b><i>0</i><b>_dew</b> - Taubildung <i>heute</i> (0=keine, 1=leicht, 2=mäßig, 3=stark)</li>
|
||||||
<li><b>fc</b><i>0</i><b>_evapor</b> - Verdunstung <i>heute</i> (0=keine, 1=gering, 2=mäßig, 3=stark)</li>
|
<li><b>fc</b><i>0</i><b>_evapor</b> - Verdunstung <i>heute</i> (0=keine, 1=gering, 2=mäßig, 3=stark)</li>
|
||||||
<li><b>fc</b><i>0</i><b>_frost</b> - Bodenfrost <i>heute</i> (0=nein, 1=ja)</li>
|
<li><b>fc</b><i>0</i><b>_frost</b> - Bodenfrost <i>heute</i> (0=nein, 1=ja)</li>
|
||||||
<li><b>fc</b><i>0</i><b>_moonRise</b> - Mondaufgang <i>heute</i></li>
|
<li><b>fc</b><i>1</i><b>_moon</b><i>Rise|Set</p> - Mond<i>auf|unter</i>gang <i>morgen</i></li>
|
||||||
<li><b>fc</b><i>0</i><b>_moonSet</b> - Monduntergang <i>heute</i></li>
|
|
||||||
<li><b>fc</b><i>0</i><b>_rad</b> - Globalstrahlung <i>heute</i></li>
|
<li><b>fc</b><i>0</i><b>_rad</b> - Globalstrahlung <i>heute</i></li>
|
||||||
<li><b>fc</b><i>0</i><b>_rain</b><i>15</i> - Niederschlagsmenge <i>heute</i> um <i>15</i>:00 Uhr in mm</li>
|
<li><b>fc</b><i>0</i><b>_rain</b><i>15</i> - Niederschlagsmenge <i>heute</i> um <i>15</i>:00 Uhr in mm</li>
|
||||||
<li><b>fc</b><i>0</i><b>_sun</b> - relative Sonnenscheindauer <i>heute</i> in % (zwischen Sonnenauf- und -untergang)</li>
|
<li><b>fc</b><i>0</i><b>_sun</b> - relative Sonnenscheindauer <i>heute</i> in % (zwischen Sonnenauf- und -untergang)</li>
|
||||||
|
|||||||
@ -1019,23 +1019,29 @@ statistics_UpdateDevReading($$$$)
|
|||||||
|
|
||||||
<a name="statistics"></a>
|
<a name="statistics"></a>
|
||||||
<h3>statistics</h3>
|
<h3>statistics</h3>
|
||||||
|
<div style="width:800px">
|
||||||
<ul>
|
<ul>
|
||||||
This modul calculates for certain readings of given devices statistical values and adds them to the devices.
|
This modul calculates for certain readings of given devices statistical values and adds them to the devices.
|
||||||
<br>
|
<br>
|
||||||
Until now statistics for the following readings are automatically built:
|
Until now statistics for the following readings are automatically built:
|
||||||
<ul>
|
<ul>
|
||||||
|
<br>
|
||||||
<li><b>Min|Avg|Max</b> Minimum, average and maximum of instantaneous values:
|
<li><b>Min|Avg|Max</b> Minimum, average and maximum of instantaneous values:
|
||||||
<br>
|
<br>
|
||||||
over a period of day, month, year: <i>brightness, current, energy_current, humidity, temperature, voltage</i>
|
over a period of day, month and year: <i>brightness, current, energy_current, humidity, temperature, voltage</i>
|
||||||
<br>
|
<br>
|
||||||
over a period of hour, day, month, year: <i>wind, wind_speed, windSpeed</i></li>
|
over a period of hour, day, month and year: <i>wind, wind_speed, windSpeed</i>
|
||||||
<li><b>Tendency</b> over 1h, 2h, 3h und 6h: <i>pressure</i></li>
|
</li><br>
|
||||||
<li><b>Delta</b> between start and end values over a period of hour, day, month, year:
|
<li><b>Tendency</b> over 1h, 2h, 3h und 6h: <i>pressure</i>
|
||||||
|
</li><br>
|
||||||
|
<li><b>Delta</b> between start and end values over a period of hour, day, month and year:
|
||||||
<br>
|
<br>
|
||||||
<i>count, energy, energy_total, power, total, rain, rain_rate, rain_total</i></li>
|
<i>count, energy, energy_total, power, total, rain, rain_rate, rain_total</i>
|
||||||
<li><b>Duration</b> of the states over a period of day, month, year:
|
</li><br>
|
||||||
|
<li><b>Duration</b> of the states over a period of day, month and year:
|
||||||
<br>
|
<br>
|
||||||
<i>lightsensor, lock, motion, Window, window, state (if no other reading is recognized)</i></li>
|
<i>lightsensor, lock, motion, Window, window, state (if no other reading is recognized)</i>
|
||||||
|
</li><br>
|
||||||
</ul>
|
</ul>
|
||||||
Further readings can be added via the correspondent <a href="#statisticsattr">attribute</a>.
|
Further readings can be added via the correspondent <a href="#statisticsattr">attribute</a>.
|
||||||
<br>
|
<br>
|
||||||
@ -1043,6 +1049,7 @@ statistics_UpdateDevReading($$$$)
|
|||||||
|
|
||||||
<b>Define</b>
|
<b>Define</b>
|
||||||
<ul>
|
<ul>
|
||||||
|
<br>
|
||||||
<code>define <name> statistics <deviceNameRegExp> [Prefix]</code>
|
<code>define <name> statistics <deviceNameRegExp> [Prefix]</code>
|
||||||
<br>
|
<br>
|
||||||
Beispiel: <code>define Statistik statistics Sensor_.*|Wettersensor</code>
|
Beispiel: <code>define Statistik statistics Sensor_.*|Wettersensor</code>
|
||||||
@ -1055,11 +1062,12 @@ statistics_UpdateDevReading($$$$)
|
|||||||
<br>
|
<br>
|
||||||
Optional. Prefix set is place before statistical data. Default is <i>stat</i>
|
Optional. Prefix set is place before statistical data. Default is <i>stat</i>
|
||||||
</li><br>
|
</li><br>
|
||||||
</ul>-
|
</ul>
|
||||||
|
|
||||||
<br>
|
<br>
|
||||||
<b>Set</b>
|
<b>Set</b>
|
||||||
<ul>
|
<ul>
|
||||||
|
<br>
|
||||||
<li><code>resetStatistics <All|DeviceName></code>
|
<li><code>resetStatistics <All|DeviceName></code>
|
||||||
<br>
|
<br>
|
||||||
Resets the statistic values of the selected device.
|
Resets the statistic values of the selected device.
|
||||||
@ -1079,20 +1087,20 @@ statistics_UpdateDevReading($$$$)
|
|||||||
<a name="statisticsattr"></a>
|
<a name="statisticsattr"></a>
|
||||||
<b>Attributes</b>
|
<b>Attributes</b>
|
||||||
<ul>
|
<ul>
|
||||||
<li><code>dayChangeTime <time></code>
|
|
||||||
<br>
|
<br>
|
||||||
Time of day change. Default is 00:00. For weather data the day change is e.g. 06:50.
|
<li><code>dayChangeTime <time></code>
|
||||||
<br>
|
<br>
|
||||||
</li><br>
|
Time of day change. Default is 00:00. For weather data the day change can be set e.g. to 06:50.
|
||||||
<li><code>deltaReadings <readings></code>
|
</li><br>
|
||||||
<br>
|
<li><code>deltaReadings <readings></code>
|
||||||
Comma separated list of reading names for which a delta statistic shall be calculated.
|
<br>
|
||||||
</li><br>
|
Comma separated list of reading names for which a delta statistic shall be calculated.
|
||||||
<li><code>durationReadings <readings></code>
|
</li><br>
|
||||||
<br>
|
<li><code>durationReadings <readings></code>
|
||||||
Comma separated list of reading names for which a duration statistic shall be calculated.
|
<br>
|
||||||
</li><br>
|
Comma separated list of reading names for which a duration statistic shall be calculated.
|
||||||
<li><code>excludedReadings <code><DeviceRegExp:ReadingNameRegExp></code></code>
|
</li><br>
|
||||||
|
<li><code>excludedReadings <code><DeviceRegExp:ReadingNameRegExp></code></code>
|
||||||
<br>
|
<br>
|
||||||
Regular expression of the readings that shall be excluded from the statistics.<br>
|
Regular expression of the readings that shall be excluded from the statistics.<br>
|
||||||
The reading have to be entered in the form <i>deviceName:readingName</i>. E.g. "FritzDect:current|Sensor_.*:humidity"
|
The reading have to be entered in the form <i>deviceName:readingName</i>. E.g. "FritzDect:current|Sensor_.*:humidity"
|
||||||
@ -1104,9 +1112,9 @@ statistics_UpdateDevReading($$$$)
|
|||||||
</li><br>
|
</li><br>
|
||||||
<li><code>periodChangePreset <seconds></code>
|
<li><code>periodChangePreset <seconds></code>
|
||||||
<br>
|
<br>
|
||||||
Start of the calculation of periodical data, default is 5 Sekunden before each full hour,
|
Start of the calculation of periodical data before each full hour. Default is 5 Sekunden.
|
||||||
<br>
|
<br>
|
||||||
Allows the correct timely assignment within plots, can be adapted to the cpu load.
|
Allows the correct timely assignment within plots, can be adapted to CPU load.
|
||||||
<br>
|
<br>
|
||||||
</li><br>
|
</li><br>
|
||||||
<li><code>singularReadings <DeviceRegExp:ReadingRegExp>:statTypes:period</i></code>
|
<li><code>singularReadings <DeviceRegExp:ReadingRegExp>:statTypes:period</i></code>
|
||||||
@ -1117,26 +1125,27 @@ statistics_UpdateDevReading($$$$)
|
|||||||
<br>
|
<br>
|
||||||
Regulare expression of statistic values, which shall not be shown in summary but also in singular readings. Eases the creation of plots.
|
Regulare expression of statistic values, which shall not be shown in summary but also in singular readings. Eases the creation of plots.
|
||||||
<br>
|
<br>
|
||||||
z.B. <code>Wettersensor:rain:Delta:(Hour|Day)|(FritzDect:(current|power):(Avg|Max|Delta):(Hour|Day)</code>
|
E.g. <code>Wettersensor:rain:Delta:(Hour|Day)|(FritzDect:(current|power):(Avg|Max|Delta):(Hour|Day)</code>
|
||||||
<br>
|
<br>
|
||||||
</li><br>
|
</li><br>
|
||||||
<li><code>specialDeltaPeriodHours <hours></code>
|
<li><code>specialDeltaPeriodHours <hours></code>
|
||||||
<br>
|
<br>
|
||||||
Adds for readings of delta statistics a singular reading for the given period of hours (e.g. for the rain of the last 72 hours)
|
Adds, for readings of delta statistics, a singular reading for the given period of hours (e.g. for the rain of the last 72 hours)
|
||||||
</li><br>
|
</li><br>
|
||||||
<li><code>tendencyReadings <readings></code>
|
<li><code>tendencyReadings <readings></code>
|
||||||
<br>
|
<br>
|
||||||
Comma separated list of reading names for which a min/average/max statistic shall be calculated.
|
Comma separated list of reading names for which a tendendy statistic shall be calculated.
|
||||||
</li><br>
|
</li><br>
|
||||||
</ul>
|
</ul>
|
||||||
</ul>
|
</ul>
|
||||||
|
</div>
|
||||||
=end html
|
=end html
|
||||||
|
|
||||||
=begin html_DE
|
=begin html_DE
|
||||||
|
|
||||||
<a name="statistics"></a>
|
<a name="statistics"></a>
|
||||||
<h3>statistics</h3>
|
<h3>statistics</h3>
|
||||||
|
<div style="width:800px">
|
||||||
<ul>
|
<ul>
|
||||||
Dieses Modul wertet von den angegebenen Geräten (als regulärer Ausdruck) bestimmte Werte statistisch aus und fügt das Ergebnis den jeweiligen Geräten als neue Werte hinzu.
|
Dieses Modul wertet von den angegebenen Geräten (als regulärer Ausdruck) bestimmte Werte statistisch aus und fügt das Ergebnis den jeweiligen Geräten als neue Werte hinzu.
|
||||||
<br>
|
<br>
|
||||||
@ -1145,14 +1154,14 @@ statistics_UpdateDevReading($$$$)
|
|||||||
<ul>
|
<ul>
|
||||||
<li><b>Min|Avg|Max</b> Minimum, Durchschnitt und Maximum von Momentanwerten:
|
<li><b>Min|Avg|Max</b> Minimum, Durchschnitt und Maximum von Momentanwerten:
|
||||||
<br>
|
<br>
|
||||||
über den Zeitraum Tag, Monat, Jahr: <i>brightness, current, energy_current, humidity, temperature, voltage</i>
|
über den Zeitraum Tag, Monat und Jahr: <i>brightness, current, energy_current, humidity, temperature, voltage</i>
|
||||||
<br>
|
<br>
|
||||||
über den Zeitraum Stunde, Tag, Monat, Jahr: <i>wind, wind_speed, windSpeed</i></li>
|
über den Zeitraum Stunde, Tag, Monat und Jahr: <i>wind, wind_speed, windSpeed</i></li>
|
||||||
<li><b>Tendency</b> Tendenz über 1h, 2h, 3h und 6h: <i>pressure</i></li>
|
<li><b>Tendency</b> Tendenz über 1h, 2h, 3h und 6h: <i>pressure</i></li>
|
||||||
<li><b>Delta</b> Differenz zwischen Anfangs- und Endwerte innerhalb eines Zeitraums (Stunde, Tag, Monat, Jahr):
|
<li><b>Delta</b> Differenz zwischen Anfangs- und Endwerte innerhalb eines Zeitraums (Stunde, Tag, Monat, Jahr):
|
||||||
<br>
|
<br>
|
||||||
<i>count, energy, energy_total, power, total, rain, rain_rate, rain_total</i></li>
|
<i>count, energy, energy_total, power, total, rain, rain_rate, rain_total</i></li>
|
||||||
<li><b>Duration</b> Dauer der Status innerhalb eines Zeitraums (Tag, Monat, Jahr):
|
<li><b>Duration</b> Dauer der Zustände (on, off, open, closed ...) innerhalb eines Zeitraums (Tag, Monat, Jahr):
|
||||||
<br>
|
<br>
|
||||||
<i>lightsensor, lock, motion, Window, window, state (wenn kein anderer Gerätewert gültig)</i></li>
|
<i>lightsensor, lock, motion, Window, window, state (wenn kein anderer Gerätewert gültig)</i></li>
|
||||||
</ul>
|
</ul>
|
||||||
@ -1162,31 +1171,33 @@ statistics_UpdateDevReading($$$$)
|
|||||||
|
|
||||||
<b>Define</b>
|
<b>Define</b>
|
||||||
<ul>
|
<ul>
|
||||||
<code>define <Name> statistics <GeräteNameRegExp> [Prefix]</code>
|
|
||||||
<br>
|
|
||||||
Beispiel: <code>define Statistik statistics Wettersensor|Badsensor</code>
|
|
||||||
<br>
|
|
||||||
<li><code><GeräteNameRegExp></code>
|
|
||||||
<br>
|
<br>
|
||||||
Regulärer Ausdruck für den Gerätenamen. <b>!!! Nicht die Gerätewerte !!!</b>
|
<code>define <Name> statistics <GeräteNameRegExp> [Prefix]</code>
|
||||||
</li><br>
|
|
||||||
<li><code>[Prefix]</code>
|
|
||||||
<br>
|
<br>
|
||||||
Optional. Der Prefix wird vor den Namen der statistischen Gerätewerte gesetzt. Standardmässig <i>stat</i>
|
Beispiel: <code>define Statistik statistics Wettersensor|Badsensor</code>
|
||||||
</li><br>
|
<br>
|
||||||
</ul>
|
<li><code><GeräteNameRegExp></code>
|
||||||
|
<br>
|
||||||
|
Regulärer Ausdruck für den Gerätenamen. <b>!!! Nicht die Gerätewerte !!!</b>
|
||||||
|
</li><br>
|
||||||
|
<li><code>[Prefix]</code>
|
||||||
|
<br>
|
||||||
|
Optional. Der Prefix wird vor den Namen der statistischen Gerätewerte gesetzt. Standardmässig <i>stat</i>
|
||||||
|
</li><br>
|
||||||
|
</ul>
|
||||||
|
|
||||||
<br>
|
<br>
|
||||||
<b>Set</b>
|
<b>Set</b>
|
||||||
<ul>
|
<ul>
|
||||||
|
<br>
|
||||||
<li><code>resetStatistics <All|Gerätename></code>
|
<li><code>resetStatistics <All|Gerätename></code>
|
||||||
<br>
|
<br>
|
||||||
Setzt die Statistiken der ausgewählten Geräte zurück.
|
Setzt die Statistiken der ausgewählten Geräte zurück.
|
||||||
<br></li>
|
</li><br>
|
||||||
<li><code>doStatistics</code>
|
<li><code>doStatistics</code>
|
||||||
<br>
|
<br>
|
||||||
Berechnet die aktuellen Statistiken aller beobachteten Geräte.
|
Berechnet die aktuellen Statistiken aller beobachteten Geräte.
|
||||||
<br></li>
|
</li><br>
|
||||||
</ul>
|
</ul>
|
||||||
<br>
|
<br>
|
||||||
|
|
||||||
@ -1198,63 +1209,64 @@ statistics_UpdateDevReading($$$$)
|
|||||||
<a name="statisticsattr"></a>
|
<a name="statisticsattr"></a>
|
||||||
<b>Attributes</b>
|
<b>Attributes</b>
|
||||||
<ul>
|
<ul>
|
||||||
<li><code>dayChangeTime <Zeit></code>
|
|
||||||
<br>
|
<br>
|
||||||
Uhrzeit des Tageswechsels. Standardmässig 00:00. Bei Wetterdaten erfolgt der Tageswechsel z.B. 6:50.
|
<li><code>dayChangeTime <Zeit></code>
|
||||||
<br>
|
<br>
|
||||||
</li><br>
|
Uhrzeit des Tageswechsels. Standardmässig 00:00. Bei Wetterdaten kann der Tageswechsel z.B. auf 6:50 gesetzt werden.
|
||||||
<li><code>deltaReadings <Gerätewerte></code>
|
</li><br>
|
||||||
<br>
|
<li><code>deltaReadings <Gerätewerte></code>
|
||||||
Durch Kommas getrennte Liste von weiteren Gerätewerten, für welche die Differenz zwischen den Werten am Anfang und Ende einer Periode (Stunde/Tag/Monat/Jahr) bestimmt wird.
|
<br>
|
||||||
</li><br>
|
Durch Kommas getrennte Liste von weiteren Gerätewerten, für welche die Differenz zwischen den Werten am Anfang und Ende einer Periode (Stunde/Tag/Monat/Jahr) bestimmt wird.
|
||||||
<li><code>durationReadings <Gerätewerte></code>
|
</li><br>
|
||||||
<br>
|
<li><code>durationReadings <Gerätewerte></code>
|
||||||
Durch Kommas getrennte Liste von weiteren Gerätewerten, für welche die Dauer einzelner Gerätewerte innerhalb bestimmte Zeiträume (Stunde/Tag/Monat/Jahr) erfasst wird.
|
<br>
|
||||||
</li><br>
|
Durch Kommas getrennte Liste von weiteren Gerätewerten, für welche die Dauer einzelner Gerätewerte innerhalb bestimmte Zeiträume (Stunde/Tag/Monat/Jahr) erfasst wird.
|
||||||
<li><code>excludedReadings <GerätenameRegExp:GerätewertRegExp></code>
|
</li><br>
|
||||||
<br>
|
<li><code>excludedReadings <GerätenameRegExp:GerätewertRegExp></code>
|
||||||
Regulärer Ausdruck der Gerätewerte die nicht ausgewertet werden sollen.
|
<br>
|
||||||
z.B. "<code>FritzDect:current|Sensor_.*:humidity</code>"
|
Regulärer Ausdruck der Gerätewerte die nicht ausgewertet werden sollen.
|
||||||
<br>
|
z.B. "<code>FritzDect:current|Sensor_.*:humidity</code>"
|
||||||
</li><br>
|
<br>
|
||||||
<li><code>hideAllSummaryReadings <0 | 1></code>
|
</li><br>
|
||||||
<br>
|
<li><code>hideAllSummaryReadings <0 | 1></code>
|
||||||
noch nicht implementiert - Es werden keine gesammelten Statistiken angezeigt, sondern nur die unter "singularReadings" definierten Einzelwerte
|
<br>
|
||||||
</li><br>
|
noch nicht implementiert - Es werden keine gesammelten Statistiken angezeigt, sondern nur die unter "singularReadings" definierten Einzelwerte
|
||||||
<li><code>minAvgMaxReadings <Gerätewerte></code>
|
</li><br>
|
||||||
<br>
|
<li><code>minAvgMaxReadings <Gerätewerte></code>
|
||||||
Durch Kommas getrennte Liste von Gerätewerten, für die in bestimmten Zeiträumen (Tag, Monat, Jahr) Minimum, Mittelwert und Maximum erfasst werden.
|
<br>
|
||||||
</li><br>
|
Durch Kommas getrennte Liste von Gerätewerten, für die in bestimmten Zeiträumen (Tag, Monat, Jahr) Minimum, Mittelwert und Maximum erfasst werden.
|
||||||
<li><code>periodChangePreset <Sekunden></code>
|
</li><br>
|
||||||
<br>
|
<li><code>periodChangePreset <Sekunden></code>
|
||||||
Start der Berechnung der periodischen Daten, standardmässig 5 Sekunden vor der vollen Stunde,
|
<br>
|
||||||
<br>
|
Start der Berechnung der periodischen Daten, standardmässig 5 Sekunden vor der vollen Stunde,
|
||||||
Erlaubt die korrekte zeitliche Zuordnung in Plots, kann je nach Systemauslastung verringert oder vergrößert werden.
|
<br>
|
||||||
<br>
|
Erlaubt die korrekte zeitliche Zuordnung in Plots, kann je nach Systemauslastung verringert oder vergrößert werden.
|
||||||
</li><br>
|
<br>
|
||||||
<li><code>singularReadings <GeräteNameRegExp:GeräteWertRegExp:Statistiktypen:Zeitraum></code>
|
</li><br>
|
||||||
<ul>
|
<li><code>singularReadings <GeräteNameRegExp:GeräteWertRegExp:Statistiktypen:Zeitraum></code>
|
||||||
<li>Statistiktypen: Min|Avg|Max|Delta|Duration|<span style="color:blue;">Tendency</span></li>
|
<ul>
|
||||||
<li>Zeitraum: Hour|Day|Month|Year|<span style="color:blue;">1h|2h|3h|6h</span></li>
|
<li>Statistiktypen: Min|Avg|Max|Delta|Duration|<span style="color:blue;">Tendency</span></li>
|
||||||
</ul>
|
<li>Zeitraum: Hour|Day|Month|Year|<span style="color:blue;">1h|2h|3h|6h</span></li>
|
||||||
Regulärer Ausdruck statistischer Werte, die nicht nur in zusammengefassten sondern auch als einzelne Werte gespeichert werden sollen.
|
</ul>
|
||||||
Erleichtert die Erzeugung von Plots und anderer Auswertungen (notify).
|
Regulärer Ausdruck statistischer Werte, die nicht nur in zusammengefassten sondern auch als einzelne Werte gespeichert werden sollen.
|
||||||
<br>
|
Erleichtert die Erzeugung von Plots und anderer Auswertungen (notify).
|
||||||
z.B. <code>Wettersensor:rain:Delta:(Hour|Day)|FritzDect:power:Delta:Day</code>
|
<br>
|
||||||
</li><br>
|
z.B. <code>Wettersensor:rain:Delta:(Hour|Day)|FritzDect:power:Delta:Day</code>
|
||||||
<li><code>specialDeltaPeriodHours <Stunden></code>
|
</li><br>
|
||||||
<br>
|
<li><code>specialDeltaPeriodHours <Stunden></code>
|
||||||
Fügt den Delta-Statistiken einen singulären Gerätewert für die angegebenen Stunden hinzu (z.b. für den Regen in den letzten 72 Stunden)
|
<br>
|
||||||
</li><br>
|
Fügt den Delta-Statistiken einen singulären Gerätewert für die angegebenen Stunden hinzu (z.b. für den Regen in den letzten 72 Stunden)
|
||||||
<li><code>tendencyReadings <Gerätewerte></code>
|
</li><br>
|
||||||
<br>
|
<li><code>tendencyReadings <Gerätewerte></code>
|
||||||
Durch Kommas getrennte Liste von weiteren Gerätewerten, für die innerhalb bestimmter Zeiträume (1h, 2h, 3h, 6h) die Differenz zwischen Anfangs- und Endwert ermittelt wird.
|
<br>
|
||||||
</li><br>
|
Durch Kommas getrennte Liste von weiteren Gerätewerten, für die innerhalb bestimmter Zeiträume (1h, 2h, 3h, 6h) die Differenz zwischen Anfangs- und Endwert ermittelt wird.
|
||||||
<li><a href="#readingFnAttributes">readingFnAttributes</a>
|
</li><br>
|
||||||
</li><br>
|
<li><a href="#readingFnAttributes">readingFnAttributes</a>
|
||||||
|
</li><br>
|
||||||
</ul>
|
</ul>
|
||||||
</ul>
|
</ul>
|
||||||
|
</div>
|
||||||
|
|
||||||
=end html_DE
|
=end html_DE
|
||||||
|
|
||||||
=cut
|
=cut
|
||||||
Loading…
x
Reference in New Issue
Block a user