userReadings
Über das Attribut userReadings können bei einem Device benutzerdefinierte readings einschließlich der Anweisungen zum Befüllen derselben festgelegt werden. Das können zum Einen Formatänderungen ("sprintf"), oder aber auch durch die Modifier
- difference
- differential
- integral
- offset
- monotonic
gesteuerte Berechnungen sein.
Syntax
Im April 2016 hat sich die Verarbeitung des Triggers dahingehend geändert, dass die Trigger-Spezifikation jetzt als Regulärer Ausdruck interpretiert wird, damit also z.B. ein avgTemp:temperature
geändert werden muss in avgTemp:temperature.*
.
Siehe commandref/readingFnAttributes.
- Bei Eingabe im Editor-Feld müssen mehrere Befehle mit einem ";" getrennt werden, bei Änderung in der Eingabezeile sind zwei ";" notwendig.
- Die Variable, dessen Wert man im Reading haben möchte, kann man einfach ans Ende stellen[1]
- mehrere UserReadings werden durch Komma getrennt.
myreading {my $v = ReadingsVal($name,"actuation","error")+62; fhem("set PID desired $v"); $v},
myreading2 {my $v = ReadingsVal($name,"actuation","error")+62; fhem("set PID2 desired $v"); $v}
Beispiele
attr ElbePegelSchoena userReadings Pegel:value.* { ReadingsVal("ElbePegelSchoena","value",0) }
Ein Reading soll einen anderen Namen bekommen
Das vorhandene Reading "value" des Devices "ElbePegelSchoena" soll künftig in "Pegel" umbenannt werden. Das geht nicht. Man kann aber ein neues Reading "Pegel" mit genau gleichem Wert erzeugen:
attr ElbePegelSchoena userReadings Pegel { ReadingsVal("ElbePegelSchoena","value",0) }
Ausgabe eines Homematic 3-State Fenstersensor als Zahl für Visualisierung mit Icons
attr HM_XXXXXX userReadings Statenum {if(ReadingsVal("HM_XXXXXX","state","") eq "closed") {return 0} elsif (ReadingsVal("HM_XXXXXX","state","") eq "tilted") {return 1} elsif (ReadingsVal("HM_XXXXXX","state","") eq "open") {return 2} else {return -1}}
Ausgabe als Moving Average und Formatierung mit sprintf
attr HZ_EINSTRAHLUNG_RAW userReadings Einstr_Mean.av {sprintf("%.1f",movingAverage("HZ_EINSTRAHLUNG_RAW","reading",1200))}
Umrechnung der Temperatur (durch 10 geteilt) und Einheit [°C] angehängt
attr HZ_EINSTRAHLUNG_T userReadings SolarTemp {ReadingsVal("HZ_EINSTRAHLUNG_T","reading",0)/10 ." °C"}
Batterieüberwachung durch Erweiterung mit notify und userReading
... ist im Detail auf der Seite Batterieüberwachung beschrieben.
Integralfunktion - integral
Die Verwendung der Integralfunktion bei userReadings ist ausführlich im Forenbeitrag Integralfunktion bei UserReadings erklärt.
Trigger
Die Trigger-Regex muss ein Event matchen inklusive Wert. Hier soll countTotalSum um den Wert im Reading count erhöht werden, natürlich nur wenn ein Event für das Reading count eintrifft, damit der Wert nur einmal hinzu addiert wird. (Alle anderen Events werden ignoriert.) Hier ist auf das Wortende zu achten "\b" in der Regex, damit z.B. Events für count1, count2, ... keinen Trigger auslösen.
attr GasPulseCounter userReadings countTotalSum:count\b.* {my $val=ReadingsVal($name,"countTotalSum",0)+ReadingsVal($name,"count",0);;$val}
Hier werden einfach die Anzahl der Events für count gezählt. Events für Readingnamen, welche ledichglich mit count beginnen werden ignoriert, wegen "\b".
attr GasPulseCounter userReadings inc:count\b.* {my $val=ReadingsVal($name,"inc",0)+1;;$val}
Links
- commandref/userReadings - userReadings