VALVES: Unterschied zwischen den Versionen

VALVES
Zweck / Funktion
	Durchschnitt mit individueller Gewichtung und Ignore
Allgemein
Typ	Inoffiziell
Details
Dokumentation	Thema
Support (Forum)	Codeschnipsel
Modulname	39_VALVES.pm
Ersteller	epsrw1,cwagner
	Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

Aktuelle Version vom 23. Mai 2023, 16:20 Uhr

VALVES bietet eine einfache Möglichkeit, den nach flexibel konfigurierbaren Regeln gewichteten Durchschnittswert einer Gruppe von Werten zu berechnen.

Features

Diese Wiki-Seite beschreibt den Versionsstand 1.0 des VALVES-Moduls.

Die Namensgebung beruht auf der primären Anwendung des Moduls auf Valve-Position-Readings von Heizungsthermostaten.

Thread im Forum:Beitrag

Beschreibung

Funktionsweise

VALVES bietet als kleines Helferlein die Möglichkeit, einen halbwegs sinnvollen und individuell gewichteten Durchschnittswert der Readings mehrerer verschiedener Devices zu berechnen.

Für jeden Wert einzeln kann ein Offset definiert werden. Es können dynamisch jeweils die höchsten/niedrigsten 0 bis 3 Werte ignoriert werden. Eine weitere Einstellung ermöglicht, bestimmte Werte doppelt zu zählen.

Im Anwendungsbeispiel Raumbedarfsabhängige Heizungssteuerung wird das Modul zum Beispiel verwendet, um den Durchschnittswert der Ventilöffnungen aller Heizkörper zu berechnen. Die individuelle Gewichtung über Attr ermöglicht hierbei einen virtuellen hydraulischen Abgleich.

Die Liste aller auszulesenden Devices wird in einem ATTR eingestellt, der Name des Readings in einem weiteren. Das Modul prüft dann regelmäßig (attr: poll interval) die Daten der FHEM-Devices und berechnet neu, wenn ein Änderung festgestellt wird.

Für die Beeinflussung des Durchschnittes hat man folgende Attribute:

ignoriere niedrigste 0...3 Positionen

ignoriere höchste 0...3 Positionen

ignoriere namentlich genannte Devices

priority-device Liste (zählen doppelt)

valves<Devicename>Gewichtung optionale Einzeleinstellung für jedes Reading, multipliziere mit Attr-Wert (zB:0,95 um 5% abzuziehen). Damit können Unterschiede bekannte gleichbleibende Meßungenauigkeiten kompensiert werden, oder verschieden große Geräte in vergleichbare Rechengrößen konvertiert werden.

Define

define <name> VALVES

Attribute

Alle Attribute sind auch in FHEM durch das Kommando get attrHelp <varname> erklärt, fürs "schnelle Nachschauen zwischendurch".

valvesInitialDelay -> Startverzögerung

valvesPollInterval -> Berechnungsfrequenz

valvesDeviceList -> Pflicht-Attr, Liste Thermostate mit valve-pos Readings

valvesDeviceReading -> Pflicht-Attr, Bezeichnung valve-pos Reading

valvesIgnoreLowest -> Niedrigste N Werte ignorieren

valvesIgnoreHighest -> Höchste N Werte ignorieren

valvesIgnoreDeviceList -> Device(s) die komplett ignoriert werden, z.B. temporärer Eintrag für Gästezimmer

valvesPriorityDeviceList -> Devices, die doppelt gezählt werden

valves<Devicename> Gewichtung -> Faktor für einzelnes Device für individuelle Gewichtung

Settings

reset -> Alle Readings zurücksetzen

Readings

state -> Fehlermeldung oder Mittelwert nach oben beschriebener Berechnung

valve_<Devicename> -> Berechnete virtuelle Ventilstellung pro Gerät

valveDetail_<Devicename> -> Debug-Info mit Details

raw_average -> Simpler Mittelwert ohne Berücksichtigung der Gewichtungen (ignores werden auch hier ignoriert)

valve_average -> Mittelwert nach oben beschriebener Berechnung

valve_max -> Größte aktuelle Ventilöffnung seit letztem Reset

valve_min -> Kleinste aktuelle Ventilöffnung seit letztem Reset

Weblinks

@@ Zeile 1: / Zeile 1: @@
-{{SEITENTITEL:VALVES }}
 {{Infobox Modul
 |ModPurpose=Durchschnitt mit individueller Gewichtung und Ignore
-<!-- |ModCategory= (noch?) nicht verwendet -->
+|ModType=x
-|ModCmdRef= ---- noch nicht Teil von FHEM ----
+|ModFTopic=131849
+|ModForumArea=Codeschnipsel
 |ModTechName=39_VALVES.pm
 |ModOwner=epsrw1,cwagner}}
-Das [[:Kategorie:Hilfsmodul|Fhem-Hilfsmodul]] [[VALVES]] bietet eine einfache Möglichkeit, einen nach flexibel konfigurierbaren Regeln gewichteten Durchschnittswert einer Gruppe von Werten zu berechnen.
+[[VALVES]] bietet eine einfache Möglichkeit, den nach flexibel konfigurierbaren Regeln gewichteten Durchschnittswert einer Gruppe von Werten zu berechnen.
 == Features ==
 <u>Diese Wiki-Seite beschreibt den Versionsstand 1.0 des VALVES-Moduls.</u>
-Die Namensgebung beruht auf der primären Anwendung des Moduls, Valve-Position-Readings von Heizungsthermostaten.
+Die Namensgebung beruht auf der primären Anwendung des Moduls auf Valve-Position-Readings von Heizungsthermostaten.
-Thread im Forum:[http://forum.fhem.de/index.php/topic,24658.msg177528.html#msg177528]
-----
+Thread im Forum:{{Link2Forum|Topic=24658|Message=177528}}
 == Beschreibung ==
 [[Datei:dok39_VALVES.jpg|mini|Funktionsweise]]
@@ Zeile 27: / Zeile 22: @@
 Für jeden Wert einzeln kann ein Offset definiert werden. Es können dynamisch jeweils die höchsten/niedrigsten 0 bis 3 Werte ignoriert werden. Eine weitere Einstellung ermöglicht, bestimmte Werte doppelt zu zählen.
-''Im Anwendungsbeispiel [[Raumbedarfsabhängige_Heizungssteuerung]] wird das Modul zum Beispiel verwendet, um den Durchschnittswert der Ventilöffnungen aller Heizkörper zu berechnen. Die individuelle Gewichtung über Attr ermöglicht hierbei einen virtuellen hydraulischen Abgleich.
+''Im Anwendungsbeispiel [[Raumbedarfsabhängige Heizungssteuerung]] wird das Modul zum Beispiel verwendet, um den Durchschnittswert der Ventilöffnungen aller Heizkörper zu berechnen. Die individuelle Gewichtung über Attr ermöglicht hierbei einen virtuellen hydraulischen Abgleich.''
-''
-Die Liste aller auszulesenden Devices wird in einem attr eingestellt, der Name des Readings in einem weiteren. Das Modul prüft dann regelmäßig (attr: poll interval) die Daten der Fhem-Devices und berechnet neu, wenn ein Änderung festgestellt wird.
+Die Liste aller auszulesenden Devices wird in einem ATTR eingestellt, der Name des Readings in einem weiteren. Das Modul prüft dann regelmäßig (attr: poll interval) die Daten der FHEM-Devices und berechnet neu, wenn ein Änderung festgestellt wird.
 Für die Beeinflussung des Durchschnittes hat man folgende Attribute:
@@ Zeile 43: / Zeile 37: @@
 * valves<Devicename>Gewichtung optionale Einzeleinstellung für jedes Reading, multipliziere mit Attr-Wert (zB:0,95 um 5% abzuziehen). Damit können Unterschiede bekannte gleichbleibende Meßungenauigkeiten kompensiert werden, oder verschieden große Geräte in vergleichbare Rechengrößen konvertiert werden.
 == Define ==
-<code>
+:<code>define <name> VALVES </code>
-  define <name> VALVES
-</code>
-----
 == Attribute ==
+Alle Attribute sind auch in FHEM durch das Kommando get attrHelp <varname> erklärt, fürs "schnelle Nachschauen zwischendurch".
+valvesInitialDelay -> Startverzögerung
-Alle Attributes sind auch in fhem durch das kommando get attrHelp <varname> erklärt, für's "schnelle Nachschauen zwischendurch".
+valvesPollInterval -> Berechnungsfrequenz
+valvesDeviceList -> '''Pflicht-Attr''', Liste Thermostate mit valve-pos Readings
-valvesInitialDelay ->Startverzögerung
+valvesDeviceReading -> '''Pflicht-Attr''', Bezeichnung valve-pos Reading
-valvesPollInterval ->Berechnungsfrequenz
+valvesIgnoreLowest -> Niedrigste N Werte ignorieren
-valvesDeviceList ->'''Pflicht-Attr''', liste thermostate mit valve-pos readings
+valvesIgnoreHighest -> Höchste N Werte ignorieren
-valvesDeviceReading ->'''Pflicht-Attr''', bezeichnung valve-pos reading
+valvesIgnoreDeviceList -> Device(s) die komplett ignoriert werden, z.B. temporärer Eintrag für Gästezimmer
-valvesIgnoreLowest ->niedrigste N werte ignorieren
-valvesIgnoreHighest ->höchste N werte ignorieren
-valvesIgnoreDeviceList ->device(s) die komplett ignoriert werden, zB. temporärer eintrag für gästezimmer
-valvesPriorityDeviceList ->devices, die doppelt gezählt werden
-valves<Devicename>Gewichtung ->faktor für einzelnes device für individuelle gewichtung
+valvesPriorityDeviceList -> Devices, die doppelt gezählt werden
+valves<Devicename> Gewichtung -> Faktor für einzelnes Device für individuelle Gewichtung
 == Settings ==
-reset ->alle readings zurücksetzen
+reset -> Alle Readings zurücksetzen
 == Readings ==
 state -> Fehlermeldung oder Mittelwert nach oben beschriebener Berechnung
-valve_<Devicename> -> berechnete virtuelle Ventilstellung pro Gerät
+valve_<Devicename> -> Berechnete virtuelle Ventilstellung pro Gerät
 valveDetail_<Devicename> -> Debug-Info mit Details
-raw_average -> simpler Mittelwert ohne Berücksichtigung der Gewichtungen (ignores werden auch hier ignoriert)
+raw_average -> Simpler Mittelwert ohne Berücksichtigung der Gewichtungen (ignores werden auch hier ignoriert)
 valve_average -> Mittelwert nach oben beschriebener Berechnung
-valve_max -> größte aktuelle Ventilöffnung seit letztem Reset
+valve_max -> Größte aktuelle Ventilöffnung seit letztem Reset
-valve_min -> kleinste aktuelle Ventilöffnung seit letzutem Reset
+valve_min -> Kleinste aktuelle Ventilöffnung seit letztem Reset
 == Weblinks ==
-* [http://forum.fhem.de/index.php/topic,24658.msg177528.html#msg177528] Thread im Forum, in dem dieses Modul vorgestellt wurde
+* {{Link2Forum|Topic=24658|LinkText=Thread im Forum, in dem dieses Modul vorgestellt wurde}}
-* to be continued
+* {{Link2Forum|Topic=131849|LinkText=Support-Thread}}
 [[Kategorie:Regelungstechnik]]
-[[Kategorie:Hilfsmodul]]
 [[Kategorie:Heizungssteuerung]]