DOIF/Templates - Versionsgeschichte

Damian-s am 25. Oktober 2020 um 15:42 Uhr

2020-10-25T15:42:11Z

← Nächstältere Version		Version vom 25. Oktober 2020, 17:42 Uhr
Zeile 108:		Zeile 108:
	</syntaxhighlight>		</syntaxhighlight>
	Beim zweiten Beispiel sind die variablen Vorgaben der Zeiten, als auch der Temperaturen von der Steuerungslogik getrennt worden. Die Definition fällt kürzer aus. Die Szenarien lassen sich kompakter darstellen und leichter pflegen. Das Einfügen einer weiteren Zeile generiert ein neues Szenario für einen weiteren Zeitpunkt.		Beim zweiten Beispiel sind die variablen Vorgaben der Zeiten, als auch der Temperaturen von der Steuerungslogik getrennt worden. Die Definition fällt kürzer aus. Die Szenarien lassen sich kompakter darstellen und leichter pflegen. Das Einfügen einer weiteren Zeile generiert ein neues Szenario für einen weiteren Zeitpunkt.
			==Weitere Anwendungsbeispiele mit Templates==
			Weitere Anwendungsbeispiele mit Templates findet man u. a. [https://wiki.fhem.de/wiki/DOIF/Automatisierung DOIF-Automatisierung]

Damian-s: /* Definition mit Templates */

2020-08-30T20:37:41Z

Definition mit Templates

← Nächstältere Version		Version vom 30. August 2020, 22:37 Uhr
Zeile 45:		Zeile 45:
	</syntaxhighlight>		</syntaxhighlight>

	Hier wurde die Steuerung mit Hilfe von Platzhaltern $1, $2 usw. verallgemeinert. Die eigentliche Definition der Steuerung hat durch den Aufruf des Templates TPL_ZS stattgefunden. Die übergebenen Zeiten und Geräte wurden anstatt der Platzhalter im Template eingesetzt. Nun arbeiten zwei unabhängige Zeitschaltuhren mit unterschiedlichen Zeitpunkten und unterschiedlichen Geräten innerhalb eines DOIF-Moduls. Wird die Steuerungsdefinition innerhalb des Templates geändert, so wirkt sich die Änderung ~~für~~ alle Template-Aufrufe, also ~~für~~ alle definierten Zeitschaltuhren. Dabei muss die Anzahl und die Reihenfolge der Parameter zu den Platzhaltern passen.		Hier wurde die Steuerung mit Hilfe von Platzhaltern $1, $2 usw. verallgemeinert. Die eigentliche Definition der Steuerung hat durch den Aufruf des Templates TPL_ZS stattgefunden. Die übergebenen Zeiten und Geräte wurden anstatt der Platzhalter im Template eingesetzt. Nun arbeiten zwei unabhängige Zeitschaltuhren mit unterschiedlichen Zeitpunkten und unterschiedlichen Geräten innerhalb eines DOIF-Moduls. Wird die Steuerungsdefinition innerhalb des Templates geändert, so wirkt sich die Änderung auf alle Template-Aufrufe, also auf alle definierten Zeitschaltuhren aus. Dabei muss die Anzahl und die Reihenfolge der Parameter zu den Platzhaltern passen.

	Der Vorteil der Nutzung von Templates macht sich besonders dann bemerkbar, wenn die Steuerung komplex ist und viele Szenarien zu erstellen sind.		Der Vorteil der Nutzung von Templates macht sich besonders dann bemerkbar, wenn die Steuerung komplex ist und viele Szenarien zu erstellen sind.

Damian-s: /* Definition ohne Templates */

2020-08-30T19:57:23Z

Definition ohne Templates

← Nächstältere Version		Version vom 30. August 2020, 21:57 Uhr
Zeile 20:		Zeile 20:
	</syntaxhighlight>		</syntaxhighlight>

	Das Problem fällt allerdings spätestens dann auf, wenn man an der Steuerung etwas ändern möchte, z. B. einen weiteren Zeitpunkt oder eine andere Bedingung zum Ein- oder Ausschalten hinzufügen möchte, die nicht nur ein Szenario betrifft, sondern alle. Dazu müsste man alle Kopien ~~entsprechen~~ abändern.		Das Problem fällt allerdings spätestens dann auf, wenn man an der Steuerung etwas ändern möchte, z. B. einen weiteren Zeitpunkt oder eine andere Bedingung zum Ein- oder Ausschalten hinzufügen möchte, die nicht nur ein Szenario betrifft, sondern alle. Dazu müsste man alle Kopien entsprechend abändern.

	==Definition mit Templates==		==Definition mit Templates==

Damian-s: /* Perl-Modus mit Templates */

2020-07-27T20:14:03Z

Perl-Modus mit Templates

← Nächstältere Version		Version vom 27. Juli 2020, 22:14 Uhr
Zeile 107:		Zeile 107:
	TPL_set_temp ([20:00], 21,20,20,20,20,20)		TPL_set_temp ([20:00], 21,20,20,20,20,20)
	</syntaxhighlight>		</syntaxhighlight>
	Beim zweiten Beispiel sind die variablen Vorgaben der Zeiten, als auch der Temperaturen von der Steuerungslogik getrennt worden. Die Definition fällt kürzer aus. Die Szenarien lassen sich kompakter darstellen und ~~besser~~ pflegen. Das Einfügen einer weiteren Zeile generiert ein neues Szenario für einen weiteren Zeitpunkt.		Beim zweiten Beispiel sind die variablen Vorgaben der Zeiten, als auch der Temperaturen von der Steuerungslogik getrennt worden. Die Definition fällt kürzer aus. Die Szenarien lassen sich kompakter darstellen und leichter pflegen. Das Einfügen einer weiteren Zeile generiert ein neues Szenario für einen weiteren Zeitpunkt.

Damian-s: /* FHEM-Modus vs. Perl-Modus mit Templates */

2020-07-27T20:13:07Z

FHEM-Modus vs. Perl-Modus mit Templates

← Nächstältere Version		Version vom 27. Juli 2020, 22:13 Uhr
Zeile 107:		Zeile 107:
	TPL_set_temp ([20:00], 21,20,20,20,20,20)		TPL_set_temp ([20:00], 21,20,20,20,20,20)
	</syntaxhighlight>		</syntaxhighlight>
	Beim zweiten Beispiel sind die variablen Vorgaben der Zeiten, als auch der Temperaturen von der Steuerungslogik getrennt worden. ~~Dadurch~~ lassen sich ~~die Szenarien besser~~ darstellen~~, ändern~~ und ~~um weitere Zeitpunkte erweitern. Gleichzeitig fällt die Definition kürzer aus~~. Das Einfügen einer weiteren Zeile generiert ein neues Szenario für einen weiteren Zeitpunkt.		Beim zweiten Beispiel sind die variablen Vorgaben der Zeiten, als auch der Temperaturen von der Steuerungslogik getrennt worden. Die Definition fällt kürzer aus. Die Szenarien lassen sich kompakter darstellen und besser pflegen. Das Einfügen einer weiteren Zeile generiert ein neues Szenario für einen weiteren Zeitpunkt.

Damian-s: /* Perl-Modus mit Templates */

2020-07-27T19:51:40Z

Perl-Modus mit Templates

← Nächstältere Version		Version vom 27. Juli 2020, 21:51 Uhr
Zeile 107:		Zeile 107:
	TPL_set_temp ([20:00], 21,20,20,20,20,20)		TPL_set_temp ([20:00], 21,20,20,20,20,20)
	</syntaxhighlight>		</syntaxhighlight>
	Beim zweiten Beispiel sind die variablen Vorgaben der Zeiten, als auch der Temperaturen von der Steuerungslogik getrennt worden. Dadurch lassen sich die Szenarien besser darstellen, ändern und um weitere Zeitpunkte erweitern. Gleichzeitig fällt die Definition kürzer aus. Das Einfügen einer weiteren Zeile generiert ein neues Szenario.		Beim zweiten Beispiel sind die variablen Vorgaben der Zeiten, als auch der Temperaturen von der Steuerungslogik getrennt worden. Dadurch lassen sich die Szenarien besser darstellen, ändern und um weitere Zeitpunkte erweitern. Gleichzeitig fällt die Definition kürzer aus. Das Einfügen einer weiteren Zeile generiert ein neues Szenario für einen weiteren Zeitpunkt.

Damian-s: /* Perl-Modus mit Templates */

2020-07-27T19:49:32Z

Perl-Modus mit Templates

← Nächstältere Version		Version vom 27. Juli 2020, 21:49 Uhr
Zeile 107:		Zeile 107:
	TPL_set_temp ([20:00], 21,20,20,20,20,20)		TPL_set_temp ([20:00], 21,20,20,20,20,20)
	</syntaxhighlight>		</syntaxhighlight>
	Beim zweiten Beispiel sind die variablen Vorgaben der Zeiten, als auch der Temperaturen von der Steuerungslogik getrennt worden. Dadurch lassen ~~sie~~ sich besser darstellen, ändern und erweitern.		Beim zweiten Beispiel sind die variablen Vorgaben der Zeiten, als auch der Temperaturen von der Steuerungslogik getrennt worden. Dadurch lassen sich die Szenarien besser darstellen, ändern und um weitere Zeitpunkte erweitern. Gleichzeitig fällt die Definition kürzer aus. Das Einfügen einer weiteren Zeile generiert ein neues Szenario.

Damian-s: /* FHEM-Modus vs. Perl-Modus mit Templates */

2020-07-27T19:45:16Z

FHEM-Modus vs. Perl-Modus mit Templates

← Nächstältere Version		Version vom 27. Juli 2020, 21:45 Uhr
Zeile 56:		Zeile 56:

	===FHEM-Modus===		===FHEM-Modus===
			In diesem Beispiel werden mehrere Zweige mit Zeittriggern definiert. Mit dem set-Befehl wird die Solltemperatur im Wandthermostat des Zimmers gesetzt.
	<syntaxhighlight lang="perl">		<syntaxhighlight lang="perl">
	defmod di_Heizung DOIF ([05:00\|8] or [05:30\|7])\		defmod di_Heizung DOIF ([05:00\|8] or [05:30\|7])\
Zeile 88:		Zeile 88:
	</syntaxhighlight>		</syntaxhighlight>
	===Perl-Modus mit Templates===		===Perl-Modus mit Templates===
			Dieses Beispiel erledigt die gleiche Aufgabe, wie das vorherige. Hier kommt allerdings im Perl-Modus ein Template zum Einsatz.
	<syntaxhighlight lang="perl">		<syntaxhighlight lang="perl">
	defmod di_heizung3 DOIF DEF TPL_set_temp ( ## Template zum Setzen der Zimmertemperaturen\		defmod di_heizung3 DOIF DEF TPL_set_temp ( ## Template zum Setzen der Zimmertemperaturen\

Damian-s am 27. Juli 2020 um 16:45 Uhr

2020-07-27T16:45:46Z

← Nächstältere Version		Version vom 27. Juli 2020, 18:45 Uhr
Zeile 13:		Zeile 13:
	</syntaxhighlight>		</syntaxhighlight>

	Hier wurden sowohl Zeiten, als auch das Gerät festgelegt. Möchte man nun eine weitere Zeitschaltuhr definieren, so kann man die Definition kopieren, die festen Angaben der Zeitpunkte und das zu schaltende Gerät abändern. Auf diese Weise lassen sich beliebig viele DOIF-Blöcke anfertigen, die für sich eigenständig funktionieren:		Hier wurden sowohl Zeiten, als auch das Gerät festgelegt. Möchte man nun eine weitere Zeitschaltuhr definieren, so kann man die Definition samt Steuerung kopieren, die festen Angaben der Zeitpunkte und das zu schaltende Gerät abändern. Auf diese Weise lassen sich beliebig viele DOIF-Blöcke anfertigen, die für sich eigenständig funktionieren:
	<syntaxhighlight lang="perl">		<syntaxhighlight lang="perl">
	defmod di_zeitschaltuhr DOIF \		defmod di_zeitschaltuhr DOIF \

Damian-s am 27. Juli 2020 um 16:44 Uhr

2020-07-27T16:44:23Z

← Nächstältere Version		Version vom 27. Juli 2020, 18:44 Uhr
Zeile 1:		Zeile 1:
	An dieser Stelle wird die Nutzung von Templates im DOIF-Modul erklärt. Mit Hilfe von Templates können Lösungen nicht nur für eine Problemstellung, im Folgenden '''Szenario''' genannt, sondern gleich generisch (allgemeingültig) für mehrere Szenarien erstellt werden.		An dieser Stelle wird die Nutzung von Templates im DOIF-Modul erklärt. Mit Hilfe von Templates können Lösungen nicht nur für eine Problemstellung, im Folgenden '''Szenario''' genannt, sondern gleich generisch (allgemeingültig) für mehrere Szenarien erstellt werden.

			==Definition ohne Templates==

	Die Vorgehensweise dazu wird am Beispiel einer Zeitschaltuhr aufgezeigt.		Die Vorgehensweise dazu wird am Beispiel einer Zeitschaltuhr aufgezeigt.

	Ausgangspunkt soll eine einfache Zeitschaltuhr mit jeweils drei Einschalt- und drei Ausschalt-Zeitpunkten sein.		Ausgangspunkt soll eine einfache Zeitschaltuhr mit jeweils drei Einschalt- und drei Ausschalt-Zeitpunkten sein.

	~~==Definition ohne Templates==~~

	Dazu wird folgende Definition vorgenommen:		Dazu wird folgende Definition vorgenommen: