Statistics
| statistics | |
|---|---|
| Zweck / Funktion | |
| Erzeugung von Verbrauchs-, und Wetterstatistiken | |
| Allgemein | |
| Typ | Hilfsmodul |
| Details | |
| Dokumentation | EN / DE |
| Support (Forum) | Unterstützende Dienste |
| Modulname | 98_statistics.pm |
| Ersteller | tupol (Forum ) |
| Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref! | |
Das Modul statistics ist zur Erzeugung von diversen Statistiken gedacht. Es muss nur einmal definiert werden und kann mithilfe von Regexp auf beliebig viele Devices angewendet werden. Die Ergebnisse dieser Statistiken werden nicht im Modul selbst dargestellt, sondern den jeweiligen Devices als zusätzliches Reading hinzugefügt.
define
Bei der Definition werden die gewünschten Geräte angegeben, von denen das Modul Statistiken bilden soll.
define myStatDevice statistics Wetterstation|Stromzaehler|Thermometer_.*
Optional ist noch die Angabe eines Prefixes möglich, wenn man nicht möchte, dass die Reading stat<ReadingName> heissen.
Attribute
Die Attribute sind soweit gut in der Commandref dokumentiert.
singularReadings
Bei Verwendung von singularReadings ist darauf zu achten, dass für das entsprechende Device die entsprechende Statistik entweder durch die standardmäßig vorgegebenen Gerätewerte oder durch durationReadings,deltaReadings,minAvgMaxReadings oder tendencyReadings definiert ist. Anderenfalls werden die singularReadings weder angelegt, noch mit Daten gefüllt. Um vom Reading Stromzaehler:total_energy singularReadings anzulegen, muss folgendes definiert werden. Dabei ist darauf zu achten, dass bei singularReadings an keiner Stelle ein Leerzeichen steht:
attr myStatDevice deltaReadings total_energy attr myStatDevice singularReadings Stromzaehler:total_energy:Delta:Hour|Stromzaehler:total_energy:Delta:Day|Stromzaehler:total_energy:Delta:Month|Stromzaehler:total_energy:Delta:Year
ignoreDefaultAssignments
Mit diesem Attribut kann die Erkennung und Verwendung der standardmäßig eingebauten Readings unterdrückt werden. Zur Funktion ist es in diesem Fall notwendig, selbst Readings zu definieren.
FAQ
Durch das Modul erzeugte Readings können durch den FHEM-Befehl
deleteReading <device> <reading>
wieder entfernt werden.
monitoredDevicesUnsupported zeigt die Devices, in denen die bei statistics vordefinierten Readings nicht auftauchen. In diesem Fall müssen die entsprechenden Readings per durationReadings,deltaReadings oder minAvgMaxReadings angelegt werden.
Das Modul löst beim Schreiben der Last-Readings und der singularReadings jeweils ein Update-Event aus. Wenn für die Geräte dann die event-on-Attribute nicht gesetzt sind, kann dies zu unerwünschten Nebenwirkungen führen. z.B. bei den userreadings