ECMD - Versionsgeschichte

Ph1959de: - Verwendung an diversen Stellen korrigiert

2021-03-16T11:43:44Z

<syntaxhighlight> - Verwendung an diversen Stellen korrigiert

GRZBRZ am 27. Juni 2020 um 13:37 Uhr

2020-06-27T13:37:21Z

← Nächstältere Version		Version vom 27. Juni 2020, 15:37 Uhr
Zeile 1:		Zeile 1:
	ECMD bedeutet "Ethersex Command"<ref>[http://www.ethersex.de/index.php/Main_Page_%28Deutsch%29 Ethersex.de]</ref> und ist laut FHEM-Dokumentation		ECMD bedeutet "Ethersex Command"<ref>[http://www.ethersex.de/index.php/Main_Page_%28Deutsch%29 Ethersex.de]</ref> und ist laut FHEM-Dokumentation
	"Any physical device with request/response-like communication capabilities over a TCP connection"<ref>{{Link2CmdRef\|Anker=ECMD\|Label=FHEM Commandref}}</ref>, das heisst, irgendein physisches Gerät, welches request/response-artige Kommunikationsfähigkeiten aufweist, sei es über eine TCP-Verbindung (Netzwerk) oder eine serielle Schnittstelle.
			"Any physical device with request/response-like communication capabilities over a TCP connection"<ref>{{Link2CmdRef\|Anker=ECMD\|Label=FHEM Commandref}}</ref>,

			das heisst, irgendein physisches Gerät, welches request/response-artige Kommunikationsfähigkeiten aufweist, sei es über eine TCP-Verbindung (Netzwerk) oder eine serielle Schnittstelle.

	In FHEM sind enthalten:		In FHEM sind enthalten:
Zeile 13:		Zeile 16:
	Siehe [[Radioaktivitätsmessung mit DIYGeigerCounter]]		Siehe [[Radioaktivitätsmessung mit DIYGeigerCounter]]

	=== DIY Sensor via HC-12 ===		=== Beispiel DIY Sensor via HC-12 ===
	Ein BME280 Temperatur/Druck/Feuchte-Sensor liefert via eines HC-12 Pärchens seine Daten an der seriellen Schnittstelle eines RasPi ab. Der Sketch im Nano, an dem sowohl der BME280 als auch einer der HC-12 hängen, liefert alle 10 Minuten ein Datagramm ab und schickt seinen Wirt in den Tiefschlaf bis zum nächsten Datagramm, um mit den notwendigen Batterien über ein Jahr aushalten zu können.		Ein BME280 Temperatur/Druck/Feuchte-Sensor liefert via eines HC-12 Pärchens seine Daten an der seriellen Schnittstelle eines RasPi ab. Der Sketch im Nano, an dem sowohl der BME280 als auch einer der HC-12 hängen, liefert alle 10 Minuten ein Datagramm ab und schickt seinen Wirt in den Tiefschlaf bis zum nächsten Datagramm, um mit den notwendigen Batterien über ein Jahr aushalten zu können.

Zeile 22:		Zeile 25:
	Daraus werden die notwendigen Definitionen für eine Klassendefinition abgeleitet. Die z.B. unter '/opt/fhem/BME280.classdef' abgelegte Datei erhält den Inhalt<syntaxhighlight line="1">		Daraus werden die notwendigen Definitionen für eine Klassendefinition abgeleitet. Die z.B. unter '/opt/fhem/BME280.classdef' abgelegte Datei erhält den Inhalt<syntaxhighlight line="1">
	params devId		params devId
	reading temperature match "%devId~~\sT(~~[~~-+.,0-9]+)~~\~~S+\sP([-+.,0-9~~]+~~)\S+\sH([-+.,0-9]+)\S+\r?~~\n"		reading temperature match "%devId[^\n]+\n"
	reading temperature postproc { /%devId~~\sT(~~[~~-+.,0-9~~]+~~)\S+\sP~~([-+.,0-9]+)~~\S+\sH([-+~~.~~,0-9]+)\S+\r?\n~~/; $1 }		reading temperature postproc { /%devId[^T]+T([-+.,0-9]+).*/; $1 }
	reading airpressure match "%devId~~\sT(~~[~~-+.,0-9]+)~~\~~S+\sP([-+.,0-9~~]~~+)\S~~+~~\sH([-+.,0-9]+)\S+\r?~~\n"		reading airpressure match "%devId[^\n]+\n"
	reading airpressure postproc { /%devId~~\sT(~~[~~-+.,0-9~~]+~~)\S+\sP~~([-+.,0-9]+)~~\S+\sH([-+~~.~~,0-9]+)\S+\r?\n~~/; $2 }		reading airpressure postproc { /%devId[^P]+P([-+.,0-9]+).*/; $1 }
	reading humidity match "%devId~~\sT(~~[~~-+.,0-9]+)~~\~~S+\sP([-+.,0-9]+)\S+\sH([-+.,0-9~~]+~~)\S+\r?~~\n"		reading humidity match "%devId[^\n]+\n"
	reading humidity postproc { /%devId~~\sT(~~[~~-+.,0-9~~]+~~)\S+\sP~~([-+.,0-9]+)~~\S+\sH([-+~~.~~,0-9]+)\S+\r?\n~~/; $3 }		reading humidity postproc { /%devId[^H]+H([-+.,0-9]+).*/; $1 }
	state humidity		state humidity
	</syntaxhighlight>Die regex ist in allen Zeilen ~~der Einfachheit zuliebe~~ gleich ~~gehalten, bei den match könnte man freilich die Klammern löschen und bei den postproc auf ein Paar reduzieren und $_ gleichmäßig mit $1 befüllen. Geschmackssache~~. Alle Werte werden durch diese Vorgehensweise gleichzeitig und erst dann gelesen, wenn das gesamte Datagramm eingetroffen ist. Es ließe sich auch auf Teil-Strings abfragen, Konflikte bei mehreren Sensoren sind dann denkbar.		</syntaxhighlight>Die regex für match ist in allen Zeilen gleich gestaltet. Alle Werte werden durch diese Vorgehensweise gleichzeitig und erst dann gelesen, wenn das gesamte Datagramm eingetroffen ist. Es ließe sich auch auf Teil-Strings abfragen, Konflikte bei mehreren Sensoren sind dann denkbar.

	Die letzte Zeile sorgt dafür, dass der state nur dann einen neuen Wert erhält, wenn (in diesem Fall) 'humidity' ein Update erfährt. Bei den gewählten regex trift das hier eigentlich für alle zu, aber da humidity der letzte übertragene Wert ist, ist die Wahl auf ihn gefallen. Außerdem steht nun nur ein Wert im state ohne einleitenden reading Namen, der wäre hier im Beispiel erwartungsgemäß 'humidity', was hier insofern irritiert, weil ja 3 Werte gelesen wurden und man sich unwillkürlich fragt, wo den die anderen geblieben sind. Zum state daher später unter Notify noch weiteres.		Die letzte Zeile sorgt dafür, dass der state nur dann einen neuen Wert erhält, wenn (in diesem Fall) 'humidity' ein Update erfährt. Bei den gewählten regex trift das hier eigentlich für alle zu, aber da humidity der letzte übertragene Wert ist, ist die Wahl auf ihn gefallen. Außerdem steht nun nur ein Wert im state ohne einleitenden reading Namen, der wäre hier im Beispiel erwartungsgemäß 'humidity', was hier insofern irritiert, weil ja 3 Werte gelesen wurden und man sich unwillkürlich fragt, wo den die anderen geblieben sind. Zum state daher später unter Notify noch weiteres.
Zeile 75:		Zeile 78:

	</syntaxhighlight>① 'ECMDDevState' wird immer dann benachrichtigt und ausgeführt, wenn der Device 'BME280_42356' ein reading 'humidity' mit einem beliebigen (.*) Wert hat. ③ Dies wird zunächst im Log vermerkt und ④ als nächstes ein wenig gewartet, damit eine Änderung des state auf jeden Fall nach dem Befüllen des state durch das humidity reading stattfindet und auch der Luftdruck fertig berechnet ist. Dann wird ⑤ der state mit einer Verkettung der gerade gelesenen bzw. berechneten Daten aller Werte ⑥,⑦,⑧ versorgt.		</syntaxhighlight>① 'ECMDDevState' wird immer dann benachrichtigt und ausgeführt, wenn der Device 'BME280_42356' ein reading 'humidity' mit einem beliebigen (.*) Wert hat. ③ Dies wird zunächst im Log vermerkt und ④ als nächstes ein wenig gewartet, damit eine Änderung des state auf jeden Fall nach dem Befüllen des state durch das humidity reading stattfindet und auch der Luftdruck fertig berechnet ist. Dann wird ⑤ der state mit einer Verkettung der gerade gelesenen bzw. berechneten Daten aller Werte ⑥,⑦,⑧ versorgt.

			====== Log HISTORY ======
			Die Werte sammeln sich nun im Log. Dort haben die Werte ebenfalls eine Einheit, in diesem Fall "°C" für reading-Namen, die mit "temperature" beginnen und "%" für reading-Namen, die mit "humidity" beginnen. Andere Einheiten oder andere reading-Namen lassen sich entweder über ein Attribut in der Log-Definition<syntaxhighlight>
			attr myDbLog valueFn {
			if ($DEVICE eq "BME280_42356"){
			if ($READING=~ m(^airpressure)){
			$UNIT = "hPa";
			}
			if ($READING=~ m(^pressure)){
			$UNIT = "Pa";
			}
			}
			}
			</syntaxhighlight>oder direkt im Device ergänzen bzw. beeinflussen.<syntaxhighlight>
			attr BME280_42356 DbLogValueFn {
			if ($READING=~ m(^airpressure)){
			$UNIT = "hPa";
			}
			if ($READING=~ m(^pressure)){
			$UNIT = "Pa";
			}
			}
			</syntaxhighlight>Damit lassen sich freilich auch ungewöhnliche Einheiten festlegen, Blutdruck wird z.B. in "mmHg" gemessen.

	====== Weiterführend ======		====== Weiterführend ======
Zeile 92:		Zeile 118:
	"<IN>" using 1:2 axes x1y2 title 'Luftdruck' ls l1 lw 1 with lines,\		"<IN>" using 1:2 axes x1y2 title 'Luftdruck' ls l1 lw 1 with lines,\
	"<IN>" using 1:2 axes x1y1 title 'Feuchte' ls l2 lw 1 with lines		"<IN>" using 1:2 axes x1y1 title 'Feuchte' ls l2 lw 1 with lines
	</syntaxhighlight>Dabei wird der Luftdruck auf einen plausiblen Bereich eingegrenzt, Drücke außerhalb dieses Bereichs hat es noch nicht gegeben auf diesem Erdball. Der Wert der Feuchte wird dem zu erwartenden Temperaturbereich (-10 bis 40) angeglichen, das ergibt eine schönere Kurve (:$val=$val~~>1100?1100:$val<800?800:$val~~). Eine Y-Achse für die Feuchte wäre die dritte Y-Achse, die haben wir also nicht. Also landet 100% Feuchte bei 40°C und 0% Feuchte bei -10°C ~~(:$val=$val/2-10)~~.		</syntaxhighlight>Dabei wird der Luftdruck auf einen plausiblen Bereich eingegrenzt, Drücke außerhalb dieses Bereichs hat es noch nicht gegeben auf diesem Erdball (:$val=$val>1100?1100:$val<800?800:$val). Der Wert der Feuchte wird dem zu erwartenden Temperaturbereich (-10 bis 40) angeglichen, das ergibt eine schönere Kurve (:$val=$val/2-10). Eine Y-Achse für die Feuchte wäre ja die dritte Y-Achse, die haben wir also nicht. Also landet 100% Feuchte bei 40°C und 0% Feuchte bei -10°C.

	Dann wird der Plot definiert. In diesem Fall mit den Daten aus DbLog, für FileLog muss geringfügig angepaßt werden. Dann fehlten freilich auch die FileLog -Definitionen für 'BME280_42356'.<syntaxhighlight>		Dann wird der Plot definiert. In diesem Fall mit den Daten aus DbLog, für FileLog muss geringfügig angepaßt werden. Dann fehlten freilich auch die FileLog -Definitionen für 'BME280_42356'.<syntaxhighlight>

GRZBRZ am 25. Juni 2020 um 14:47 Uhr

2020-06-25T14:47:37Z

← Nächstältere Version		Version vom 25. Juni 2020, 16:47 Uhr
Zeile 32:		Zeile 32:

	Die letzte Zeile sorgt dafür, dass der state nur dann einen neuen Wert erhält, wenn (in diesem Fall) 'humidity' ein Update erfährt. Bei den gewählten regex trift das hier eigentlich für alle zu, aber da humidity der letzte übertragene Wert ist, ist die Wahl auf ihn gefallen. Außerdem steht nun nur ein Wert im state ohne einleitenden reading Namen, der wäre hier im Beispiel erwartungsgemäß 'humidity', was hier insofern irritiert, weil ja 3 Werte gelesen wurden und man sich unwillkürlich fragt, wo den die anderen geblieben sind. Zum state daher später unter Notify noch weiteres.		Die letzte Zeile sorgt dafür, dass der state nur dann einen neuen Wert erhält, wenn (in diesem Fall) 'humidity' ein Update erfährt. Bei den gewählten regex trift das hier eigentlich für alle zu, aber da humidity der letzte übertragene Wert ist, ist die Wahl auf ihn gefallen. Außerdem steht nun nur ein Wert im state ohne einleitenden reading Namen, der wäre hier im Beispiel erwartungsgemäß 'humidity', was hier insofern irritiert, weil ja 3 Werte gelesen wurden und man sich unwillkürlich fragt, wo den die anderen geblieben sind. Zum state daher später unter Notify noch weiteres.

	''(Nachtrag: Zum Zeitpunkt der Erstellung dieses Artikels gibt es Probleme in dem Fall, dass die bei "partial" übliche Zusammensetzung der Lesung versagt, wenn das abschließende "\n" als einzelnes Zeichen übertragen wird. Beim DISPATCH des gerade gelesenen Fragments durch fhem.pm wird ein einzelnes "\n" verschluckt und es kommt in Folge zu keinem match mit den dokumentierten match-Ausdrücken.)''

	====== Schnittstelle ======		====== Schnittstelle ======

GRZBRZ am 25. Juni 2020 um 14:36 Uhr

2020-06-25T14:36:54Z

← Nächstältere Version		Version vom 25. Juni 2020, 16:36 Uhr
Zeile 31:		Zeile 31:
	</syntaxhighlight>Die regex ist in allen Zeilen der Einfachheit zuliebe gleich gehalten, bei den match könnte man freilich die Klammern löschen und bei den postproc auf ein Paar reduzieren und $_ gleichmäßig mit $1 befüllen. Geschmackssache. Alle Werte werden durch diese Vorgehensweise gleichzeitig und erst dann gelesen, wenn das gesamte Datagramm eingetroffen ist. Es ließe sich auch auf Teil-Strings abfragen, Konflikte bei mehreren Sensoren sind dann denkbar.		</syntaxhighlight>Die regex ist in allen Zeilen der Einfachheit zuliebe gleich gehalten, bei den match könnte man freilich die Klammern löschen und bei den postproc auf ein Paar reduzieren und $_ gleichmäßig mit $1 befüllen. Geschmackssache. Alle Werte werden durch diese Vorgehensweise gleichzeitig und erst dann gelesen, wenn das gesamte Datagramm eingetroffen ist. Es ließe sich auch auf Teil-Strings abfragen, Konflikte bei mehreren Sensoren sind dann denkbar.

	Die letzte Zeile sorgt dafür, dass der state nur dann einen neuen Wert erhält, wenn (in diesem Fall) 'humidity' ein Update erfährt. Bei den gewählten regex trift das hier eigentlich für alle zu, aber da humidity der letzte übertragene Wert ist, ist die Wahl auf ihn gefallen. Außerdem steht nun nur ein Wert im state ohne einleitenden reading Namen, der wäre hier im Beispiel erwartungsgemäß 'humidity', was hier insofern irritiert, weil ja 3 Werte gelesen wurden und man sich unwillkürlich fragt, wo den die anderen geblieben sind. Zum state daher später noch weiteres.		Die letzte Zeile sorgt dafür, dass der state nur dann einen neuen Wert erhält, wenn (in diesem Fall) 'humidity' ein Update erfährt. Bei den gewählten regex trift das hier eigentlich für alle zu, aber da humidity der letzte übertragene Wert ist, ist die Wahl auf ihn gefallen. Außerdem steht nun nur ein Wert im state ohne einleitenden reading Namen, der wäre hier im Beispiel erwartungsgemäß 'humidity', was hier insofern irritiert, weil ja 3 Werte gelesen wurden und man sich unwillkürlich fragt, wo den die anderen geblieben sind. Zum state daher später unter Notify noch weiteres.

			''(Nachtrag: Zum Zeitpunkt der Erstellung dieses Artikels gibt es Probleme in dem Fall, dass die bei "partial" übliche Zusammensetzung der Lesung versagt, wenn das abschließende "\n" als einzelnes Zeichen übertragen wird. Beim DISPATCH des gerade gelesenen Fragments durch fhem.pm wird ein einzelnes "\n" verschluckt und es kommt in Folge zu keinem match mit den dokumentierten match-Ausdrücken.)''

	====== Schnittstelle ======		====== Schnittstelle ======
Zeile 55:		Zeile 57:
	attr BME280_42356 room Grundstück		attr BME280_42356 room Grundstück
	attr BME280_42356 IODev SerDevDef		attr BME280_42356 IODev SerDevDef
	attr BME280_42356 userReadings airpressure_sealevel { sprintf("%.2f", ReadingsVal("BME280_42356","pressure",0)*1.023);; }		attr BME280_42356 userReadings airpressure_sealevel:humidity:.* { sprintf("%.2f", ReadingsVal("BME280_42356","pressure",0)*1.023);; }
	</syntaxhighlight>Der fragliche Sensor beginnt seine Datagramme immer mit '42356', das ist seine DevId, die über den Parameter 'devId' in der Klassendefinition (siehe oben) Eingang in die readings findet. Über 'BME280' wird die Klassendefinition festgelegt, über '42356' die devId. Sinnigerweise wird im Beispiel hier 'BME280_42356' als Devicename festgelegt, Systematik ist Trumpf.		</syntaxhighlight>Der fragliche Sensor beginnt seine Datagramme immer mit '42356', das ist seine DevId, die über den Parameter 'devId' in der Klassendefinition (siehe oben) Eingang in die readings findet. Über 'BME280' wird die Klassendefinition festgelegt, über '42356' die devId. Sinnigerweise wird im Beispiel hier 'BME280_42356' als Devicename festgelegt, Systematik ist Trumpf.

	Die letzte Zeile macht aus dem vom Sensor gemessenen Luftdruck noch den auf NormalNull Bezogenen. Nicht jeder wohnt direkt am Meer und kann auf diesen Schritt verzichten. Ansonsten weichen die Werte des Sensors immer von der Wettervorhersage ab, je höher der Sensor, um so markanter. Das Beispiel hier gilt für ca. ~~160m~~ üNN.		Die letzte Zeile macht aus dem vom Sensor gemessenen Luftdruck noch den auf NormalNull Bezogenen. Nicht jeder wohnt direkt am Meer und kann auf diesen Schritt verzichten. Ansonsten weichen die Werte des Sensors immer von der Wettervorhersage ab, je höher der Sensor, um so markanter. Das Beispiel hier gilt für ca. 180m üNN. Die Erzeugung des Wertes für "airpressure_sealevel" ist übrigens an den Event "humidity geknüpft, sonst hat man im Event-Log in diesem Fall 3 Einträge, nämlich den beim Temperatur-, beim Druck- und beim Feuchte-Event (siehe auch beim folgenden Notify und dem linken Teil des Beispiel-Plots weiter unten).

	====== Notify ======		====== Notify ======

GRZBRZ am 22. Juni 2020 um 18:33 Uhr

2020-06-22T18:33:24Z

← Nächstältere Version		Version vom 22. Juni 2020, 20:33 Uhr
Zeile 97:		Zeile 97:
	defmod SVG_BME280_42356 SVG myDbLog:SVG_BME280_42356:HISTORY		defmod SVG_BME280_42356 SVG myDbLog:SVG_BME280_42356:HISTORY
	</syntaxhighlight>Der Term 'SVG_BME280_42356' liest dabei die Definitionen aus der vorher angelegten Datei 'SVG_BME280_42356.gplot'.		</syntaxhighlight>Der Term 'SVG_BME280_42356' liest dabei die Definitionen aus der vorher angelegten Datei 'SVG_BME280_42356.gplot'.
	[[Datei:GHplotECMD.png~~\|links~~\|rahmenlos\|1197x1197px~~\|Voila~~]]
			[[Datei:GHplotECMD.png\|rahmenlos\|1197x1197px]]

	====== FIN ======		====== FIN ======

GRZBRZ am 22. Juni 2020 um 18:30 Uhr

2020-06-22T18:30:19Z

← Nächstältere Version		Version vom 22. Juni 2020, 20:30 Uhr
Zeile 97:		Zeile 97:
	defmod SVG_BME280_42356 SVG myDbLog:SVG_BME280_42356:HISTORY		defmod SVG_BME280_42356 SVG myDbLog:SVG_BME280_42356:HISTORY
	</syntaxhighlight>Der Term 'SVG_BME280_42356' liest dabei die Definitionen aus der vorher angelegten Datei 'SVG_BME280_42356.gplot'.		</syntaxhighlight>Der Term 'SVG_BME280_42356' liest dabei die Definitionen aus der vorher angelegten Datei 'SVG_BME280_42356.gplot'.
			[[Datei:GHplotECMD.png\|links\|rahmenlos\|1197x1197px\|Voila]]

	====== FIN ======		====== FIN ======

GRZBRZ am 22. Juni 2020 um 18:02 Uhr

2020-06-22T18:02:05Z

← Nächstältere Version		Version vom 22. Juni 2020, 20:02 Uhr
Zeile 7:		Zeile 7:

	==Beispiele & Links==		==Beispiele & Links==

			=== Links ===
	Siehe {{Link2Forum\|Topic= 60753 \|Message=521462\|LinkText=Thread im FHEM-Forum}}		Siehe {{Link2Forum\|Topic= 60753 \|Message=521462\|LinkText=Thread im FHEM-Forum}}

GRZBRZ am 22. Juni 2020 um 17:35 Uhr

2020-06-22T17:35:40Z

← Nächstältere Version		Version vom 22. Juni 2020, 19:35 Uhr
Zeile 16:		Zeile 16:
	Das Datagramm hat die Form		Das Datagramm hat die Form
	DevId T-3.45°C P995.31hPa H63.27%RH\r\n		DevId T-3.45°C P995.31hPa H63.27%RH\r\n

			====== Klassendefinition ======
	Daraus werden die notwendigen Definitionen für eine Klassendefinition abgeleitet. Die z.B. unter '/opt/fhem/BME280.classdef' abgelegte Datei erhält den Inhalt<syntaxhighlight line="1">		Daraus werden die notwendigen Definitionen für eine Klassendefinition abgeleitet. Die z.B. unter '/opt/fhem/BME280.classdef' abgelegte Datei erhält den Inhalt<syntaxhighlight line="1">
	params devId		params devId
Zeile 29:		Zeile 31:
	Die letzte Zeile sorgt dafür, dass der state nur dann einen neuen Wert erhält, wenn (in diesem Fall) 'humidity' ein Update erfährt. Bei den gewählten regex trift das hier eigentlich für alle zu, aber da humidity der letzte übertragene Wert ist, ist die Wahl auf ihn gefallen. Außerdem steht nun nur ein Wert im state ohne einleitenden reading Namen, der wäre hier im Beispiel erwartungsgemäß 'humidity', was hier insofern irritiert, weil ja 3 Werte gelesen wurden und man sich unwillkürlich fragt, wo den die anderen geblieben sind. Zum state daher später noch weiteres.		Die letzte Zeile sorgt dafür, dass der state nur dann einen neuen Wert erhält, wenn (in diesem Fall) 'humidity' ein Update erfährt. Bei den gewählten regex trift das hier eigentlich für alle zu, aber da humidity der letzte übertragene Wert ist, ist die Wahl auf ihn gefallen. Außerdem steht nun nur ein Wert im state ohne einleitenden reading Namen, der wäre hier im Beispiel erwartungsgemäß 'humidity', was hier insofern irritiert, weil ja 3 Werte gelesen wurden und man sich unwillkürlich fragt, wo den die anderen geblieben sind. Zum state daher später noch weiteres.

			====== Schnittstelle ======
	Sollte bereits eine ECMD Schnittstelle bestehen, kann nun die Definition hinzugefügt werden. Z.B. die ECMD Schnittstelle namens 'SerDevDef' erhält eine zusätzliche Klasse 'BME280' mit den Definitionen aus der vorher generierten Datei, Beispiel siehe oben.<syntaxhighlight>		Sollte bereits eine ECMD Schnittstelle bestehen, kann nun die Definition hinzugefügt werden. Z.B. die ECMD Schnittstelle namens 'SerDevDef' erhält eine zusätzliche Klasse 'BME280' mit den Definitionen aus der vorher generierten Datei, Beispiel siehe oben.<syntaxhighlight>
	set SerDevDef classdef BME280 /opt/fhem/BME280.classdef		set SerDevDef classdef BME280 /opt/fhem/BME280.classdef
Zeile 44:		Zeile 47:
	</syntaxhighlight>Rückstelllen dieser Attribute nicht vergessen, so ist's reichlich gesprächig und füllt schnell das Log !!!		</syntaxhighlight>Rückstelllen dieser Attribute nicht vergessen, so ist's reichlich gesprächig und füllt schnell das Log !!!

			====== Device ======
	Damit ist alles vorbereitet den ECMD Device zu erstellen.<syntaxhighlight>		Damit ist alles vorbereitet den ECMD Device zu erstellen.<syntaxhighlight>
	define BME280_42356 ECMDDevice BME280 42356		define BME280_42356 ECMDDevice BME280 42356
Zeile 54:		Zeile 58:
	Die letzte Zeile macht aus dem vom Sensor gemessenen Luftdruck noch den auf NormalNull Bezogenen. Nicht jeder wohnt direkt am Meer und kann auf diesen Schritt verzichten. Ansonsten weichen die Werte des Sensors immer von der Wettervorhersage ab, je höher der Sensor, um so markanter. Das Beispiel hier gilt für ca. 160m üNN.		Die letzte Zeile macht aus dem vom Sensor gemessenen Luftdruck noch den auf NormalNull Bezogenen. Nicht jeder wohnt direkt am Meer und kann auf diesen Schritt verzichten. Ansonsten weichen die Werte des Sensors immer von der Wettervorhersage ab, je höher der Sensor, um so markanter. Das Beispiel hier gilt für ca. 160m üNN.

			====== Notify ======
	Da der state nach einer Übermittlung aufgrund der Festlegungen aus der Klassendefinition nun nur den Wert der Luftfeuchte enthält, ist es hilfreich ein 'notify' für eine gefälligere Darstellung zu definieren.<syntaxhighlight>		Da der state nach einer Übermittlung aufgrund der Festlegungen aus der Klassendefinition nun nur den Wert der Luftfeuchte enthält, ist es hilfreich ein 'notify' für eine gefälligere Darstellung zu definieren.<syntaxhighlight>
	define ECMDDevState notify BME280_42356:humidity:.* { Log 1, "$NAME has new values";;sleep 1;;fhem "setstate BME280_42356"." T:".ReadingsVal("BME280_42356","temperature",0)." P:".ReadingsVal("BME280_42356","airpressure_sealevel",0)." H:".ReadingsVal("BME280_42356","humidity",0) }		define ECMDDevState notify BME280_42356:humidity:.* { Log 1, "$NAME has new values";;sleep 1;;fhem "setstate BME280_42356"." T:".ReadingsVal("BME280_42356","temperature",0)." P:".ReadingsVal("BME280_42356","airpressure_sealevel",0)." H:".ReadingsVal("BME280_42356","humidity",0) }
Zeile 69:		Zeile 74:
	</syntaxhighlight>① 'ECMDDevState' wird immer dann benachrichtigt und ausgeführt, wenn der Device 'BME280_42356' ein reading 'humidity' mit einem beliebigen (.*) Wert hat. ③ Dies wird zunächst im Log vermerkt und ④ als nächstes ein wenig gewartet, damit eine Änderung des state auf jeden Fall nach dem Befüllen des state durch das humidity reading stattfindet und auch der Luftdruck fertig berechnet ist. Dann wird ⑤ der state mit einer Verkettung der gerade gelesenen bzw. berechneten Daten aller Werte ⑥,⑦,⑧ versorgt.		</syntaxhighlight>① 'ECMDDevState' wird immer dann benachrichtigt und ausgeführt, wenn der Device 'BME280_42356' ein reading 'humidity' mit einem beliebigen (.*) Wert hat. ③ Dies wird zunächst im Log vermerkt und ④ als nächstes ein wenig gewartet, damit eine Änderung des state auf jeden Fall nach dem Befüllen des state durch das humidity reading stattfindet und auch der Luftdruck fertig berechnet ist. Dann wird ⑤ der state mit einer Verkettung der gerade gelesenen bzw. berechneten Daten aller Werte ⑥,⑦,⑧ versorgt.

			====== Weiterführend ======
	Abschließend soll noch ein Plot der Messwerte gemacht werden, eine Kurve liest sich leichter. Als Erstes wird eine Datei z.B. '/opt/fhem/www/gplot/SVG_BME280_42356.gplot' mit folgendem Inhalt erstellt, der anzuzeigenden Linien und Beschriftungen des Plots beschreibt.<syntaxhighlight>		Abschließend soll noch ein Plot der Messwerte gemacht werden, eine Kurve liest sich leichter. Als Erstes wird eine Datei z.B. '/opt/fhem/www/gplot/SVG_BME280_42356.gplot' mit folgendem Inhalt erstellt, der anzuzeigenden Linien und Beschriftungen des Plots beschreibt.<syntaxhighlight>
	set terminal png transparent size <SIZE> crop		set terminal png transparent size <SIZE> crop
Zeile 90:		Zeile 96:
	</syntaxhighlight>Der Term 'SVG_BME280_42356' liest dabei die Definitionen aus der vorher angelegten Datei 'SVG_BME280_42356.gplot'.		</syntaxhighlight>Der Term 'SVG_BME280_42356' liest dabei die Definitionen aus der vorher angelegten Datei 'SVG_BME280_42356.gplot'.

			====== FIN ======
	Viel Spaß bei den eigenen Experimenten.		Viel Spaß bei den eigenen Experimenten.

GRZBRZ am 22. Juni 2020 um 17:27 Uhr

2020-06-22T17:27:23Z

← Nächstältere Version		Version vom 22. Juni 2020, 19:27 Uhr
Zeile 69:		Zeile 69:
	</syntaxhighlight>① 'ECMDDevState' wird immer dann benachrichtigt und ausgeführt, wenn der Device 'BME280_42356' ein reading 'humidity' mit einem beliebigen (.*) Wert hat. ③ Dies wird zunächst im Log vermerkt und ④ als nächstes ein wenig gewartet, damit eine Änderung des state auf jeden Fall nach dem Befüllen des state durch das humidity reading stattfindet und auch der Luftdruck fertig berechnet ist. Dann wird ⑤ der state mit einer Verkettung der gerade gelesenen bzw. berechneten Daten aller Werte ⑥,⑦,⑧ versorgt.		</syntaxhighlight>① 'ECMDDevState' wird immer dann benachrichtigt und ausgeführt, wenn der Device 'BME280_42356' ein reading 'humidity' mit einem beliebigen (.*) Wert hat. ③ Dies wird zunächst im Log vermerkt und ④ als nächstes ein wenig gewartet, damit eine Änderung des state auf jeden Fall nach dem Befüllen des state durch das humidity reading stattfindet und auch der Luftdruck fertig berechnet ist. Dann wird ⑤ der state mit einer Verkettung der gerade gelesenen bzw. berechneten Daten aller Werte ⑥,⑦,⑧ versorgt.

	.		Abschließend soll noch ein Plot der Messwerte gemacht werden, eine Kurve liest sich leichter. Als Erstes wird eine Datei z.B. '/opt/fhem/www/gplot/SVG_BME280_42356.gplot' mit folgendem Inhalt erstellt, der anzuzeigenden Linien und Beschriftungen des Plots beschreibt.<syntaxhighlight>

	Abschließend soll noch ein Plot der Messwerte gemacht werden, eine Kurve liest sich leichter. Als Erstes wird eine Datei z.B. '/opt/fhem/www/gplot/SVG_BME280_42356.gplot' mit folgendem Inhalt erstellt, der anzuzeigenden Linien und Beschriftungen des Plots beschreibt, .<syntaxhighlight>
	set terminal png transparent size <SIZE> crop		set terminal png transparent size <SIZE> crop
	set output '<OUT>.png'		set output '<OUT>.png'
Zeile 86:		Zeile 84:
	"<IN>" using 1:2 axes x1y2 title 'Luftdruck' ls l1 lw 1 with lines,\		"<IN>" using 1:2 axes x1y2 title 'Luftdruck' ls l1 lw 1 with lines,\
	"<IN>" using 1:2 axes x1y1 title 'Feuchte' ls l2 lw 1 with lines		"<IN>" using 1:2 axes x1y1 title 'Feuchte' ls l2 lw 1 with lines
	</syntaxhighlight>Dann wird der Plot definiert. In diesem Fall mit den Daten aus DbLog, für FileLog muss geringfügig angepaßt werden. Dann fehlten freilich auch die FileLog -Definitionen für 'BME280_42356'.<syntaxhighlight>		</syntaxhighlight>Dabei wird der Luftdruck auf einen plausiblen Bereich eingegrenzt, Drücke außerhalb dieses Bereichs hat es noch nicht gegeben auf diesem Erdball. Der Wert der Feuchte wird dem zu erwartenden Temperaturbereich (-10 bis 40) angeglichen, das ergibt eine schönere Kurve (:$val=$val>1100?1100:$val<800?800:$val). Eine Y-Achse für die Feuchte wäre die dritte Y-Achse, die haben wir also nicht. Also landet 100% Feuchte bei 40°C und 0% Feuchte bei -10°C (:$val=$val/2-10).

			Dann wird der Plot definiert. In diesem Fall mit den Daten aus DbLog, für FileLog muss geringfügig angepaßt werden. Dann fehlten freilich auch die FileLog -Definitionen für 'BME280_42356'.<syntaxhighlight>
	defmod SVG_BME280_42356 SVG myDbLog:SVG_BME280_42356:HISTORY		defmod SVG_BME280_42356 SVG myDbLog:SVG_BME280_42356:HISTORY
	</syntaxhighlight>Der Term 'SVG_BME280_42356' liest dabei die Definitionen aus der vorher angelegten Datei 'SVG_BME280_42356.gplot'.		</syntaxhighlight>Der Term 'SVG_BME280_42356' liest dabei die Definitionen aus der vorher angelegten Datei 'SVG_BME280_42356.gplot'.

GRZBRZ am 22. Juni 2020 um 16:16 Uhr

2020-06-22T16:16:28Z

← Nächstältere Version		Version vom 22. Juni 2020, 18:16 Uhr
Zeile 68:		Zeile 68:

	</syntaxhighlight>① 'ECMDDevState' wird immer dann benachrichtigt und ausgeführt, wenn der Device 'BME280_42356' ein reading 'humidity' mit einem beliebigen (.*) Wert hat. ③ Dies wird zunächst im Log vermerkt und ④ als nächstes ein wenig gewartet, damit eine Änderung des state auf jeden Fall nach dem Befüllen des state durch das humidity reading stattfindet und auch der Luftdruck fertig berechnet ist. Dann wird ⑤ der state mit einer Verkettung der gerade gelesenen bzw. berechneten Daten aller Werte ⑥,⑦,⑧ versorgt.		</syntaxhighlight>① 'ECMDDevState' wird immer dann benachrichtigt und ausgeführt, wenn der Device 'BME280_42356' ein reading 'humidity' mit einem beliebigen (.*) Wert hat. ③ Dies wird zunächst im Log vermerkt und ④ als nächstes ein wenig gewartet, damit eine Änderung des state auf jeden Fall nach dem Befüllen des state durch das humidity reading stattfindet und auch der Luftdruck fertig berechnet ist. Dann wird ⑤ der state mit einer Verkettung der gerade gelesenen bzw. berechneten Daten aller Werte ⑥,⑦,⑧ versorgt.

			.

	Abschließend soll noch ein Plot der Messwerte gemacht werden, eine Kurve liest sich leichter. Als Erstes wird eine Datei z.B. '/opt/fhem/www/gplot/SVG_BME280_42356.gplot' mit folgendem Inhalt erstellt, der anzuzeigenden Linien und Beschriftungen des Plots beschreibt, .<syntaxhighlight>		Abschließend soll noch ein Plot der Messwerte gemacht werden, eine Kurve liest sich leichter. Als Erstes wird eine Datei z.B. '/opt/fhem/www/gplot/SVG_BME280_42356.gplot' mit folgendem Inhalt erstellt, der anzuzeigenden Linien und Beschriftungen des Plots beschreibt, .<syntaxhighlight>