HomeMatic Templates - Versionsgeschichte

Pahenning: /* Beispiele und Ideen */

2020-03-23T08:17:21Z

Beispiele und Ideen

← Nächstältere Version		Version vom 23. März 2020, 10:17 Uhr
Zeile 252:		Zeile 252:
	=Beispiele und Ideen=		=Beispiele und Ideen=

	Neben den typischen Templates für Schalter kann (sollte) man auch bspw für RTs einsetzen. Temperaturlisten sind nicht im Angebot. Hier gibt es bereits andere Verfahren die besser passen. Allerdings ~~experimentire~~ ich bei meinen RTs mit den Regelparametern und will diese dann generell setzen. Alle RTs (bei mir) sollen die gleiche Regelung haben. Ich nutze 3 Templates für meine RTs		Neben den typischen Templates für Schalter kann (sollte) man auch bspw für RTs einsetzen. Temperaturlisten sind nicht im Angebot. Hier gibt es bereits andere Verfahren, die besser passen. Allerdings experimentiere ich bei meinen RTs mit den Regelparametern und will diese dann generell setzen. Alle RTs (bei mir) sollen die gleiche Regelung haben. Ich nutze 3 Templates für meine RTs
	* '''HeatDefDev''': Das Device des RT wird auf Standartwerte gesetzt. Hier nutze ich einen Parameter um die Tasten zu sperren. Dies brauche ich nicht bei allen RTs sondern nur bei denen, welche ich mit einem TC gepeert habe. Hier ist eine Lokale Änderung am TC vorzunehmen.		* '''HeatDefDev''': Das Device des RT wird auf Standartwerte gesetzt. Hier nutze ich einen Parameter um die Tasten zu sperren. Dies brauche ich nicht bei allen RTs sondern nur bei denen, welche ich mit einem TC gepeert habe. Hier ist eine Lokale Änderung am TC vorzunehmen.
	* '''HeatDefault''':Die Standart-Regelung. Auch hier habe ich Parameter vorgesehen. Die Devices sind identisch... bis auf die Boostzeit und die maximals Ventilöffnung. Je nach Hk begrenze ich ValveMax - hängt von den baulichen Gegebenheiten ab. Boost nutze ich im Bad zum ~~entfeuchten~~.		* '''HeatDefault''':Die Standart-Regelung. Auch hier habe ich Parameter vorgesehen. Die Devices sind identisch... bis auf die Boostzeit und die maximals Ventilöffnung. Je nach Hk begrenze ich ValveMax - hängt von den baulichen Gegebenheiten ab. Boost nutze ich im Bad zum Entfeuchten.
	* '''HeatRemote''': mein ''guteNacht'' Knopf macht auch vor RTs nicht halt. Ich ~~haben~~ an einer ~~Remote~~ einen Button mit allen Lichtern und RTs im Wohnbereich gekoppelt. Beim Drücken wird das Licht abgeschaltet und ~~dieHeizung~~ gedrosselt - ~~bspw~~ wenn ich als letzter ins Bett gehe. Daher brauche ich einen Parameter ''Temperatur'' um das ~~induviduell~~ je RT einzustellen.		* '''HeatRemote''': mein ''guteNacht'' Knopf macht auch vor RTs nicht halt. Ich habe an einer Fernbedienung einen Button mit allen Lichtern und RTs im Wohnbereich gekoppelt. Beim Drücken wird das Licht abgeschaltet und die Heizung gedrosselt - z.B., wenn ich als letzter ins Bett gehe. Daher brauche ich einen Parameter ''Temperatur'' um das individuell je RT einzustellen.
	set hm templateDef HeatDefDev BtnLock "Default RT Device register" globalBtnLock:off localResDis:off modusBtnLock:off backOnTime:10 cyclicInfoMsg:on lowBatLimitRT:2.1 burstRx:on cyclicInfoMsgDis:0 btnLock:p0		set hm templateDef HeatDefDev BtnLock "Default RT Device register" globalBtnLock:off localResDis:off modusBtnLock:off backOnTime:10 cyclicInfoMsg:on lowBatLimitRT:2.1 burstRx:on cyclicInfoMsgDis:0 btnLock:p0
	set hm templateDef HeatDefault boost:valveMax "myDefault RT settings, enter boostTime and valveMax" regAdaptive:offDeter reguIntI:20 nightTemp:17 tempOffset:0.0K dayTemp:21 reguIntPstart:5 reguExtI:20 showWeekday:off reguExtP:25 reguIntP:25 tempMax:30.5 tempMin:4.5 valveMaxPos:p1 valveOffsetRt:0 modePrioManu:all daylightSaveTime:on boostPos:30 decalcWeekday:Sat showInfo:time decalcTime:11:00 btnNoBckLight:off reguExtPstart:5 noMinMax4Manu:off modePrioParty:all valveErrPos:15 boostPeriod:p0		set hm templateDef HeatDefault boost:valveMax "myDefault RT settings, enter boostTime and valveMax" regAdaptive:offDeter reguIntI:20 nightTemp:17 tempOffset:0.0K dayTemp:21 reguIntPstart:5 reguExtI:20 showWeekday:off reguExtP:25 reguIntP:25 tempMax:30.5 tempMin:4.5 valveMaxPos:p1 valveOffsetRt:0 modePrioManu:all daylightSaveTime:on boostPos:30 decalcWeekday:Sat showInfo:time decalcTime:11:00 btnNoBckLight:off reguExtPstart:5 noMinMax4Manu:off modePrioParty:all valveErrPos:15 boostPeriod:p0

Pahenning: /* Template Überblick */

2020-03-23T08:15:29Z

Template Überblick

← Nächstältere Version		Version vom 23. März 2020, 10:15 Uhr
Zeile 221:		Zeile 221:
	get hm templateUsgG sortPeer		get hm templateUsgG sortPeer
	get hm templateUsgG all		get hm templateUsgG all
	Sowie eine Liste von ~~Regiserlisten~~, welche noch kein Template nutzen (noch in Bau!!)		Sowie eine Liste von Registerlisten, welche noch kein Template nutzen (noch in Bau!!)
	get hm templateUsgG noTmpl		get hm templateUsgG noTmpl
	Eine Liste der Verfügbaren Templates erhält man mit		Eine Liste der Verfügbaren Templates erhält man mit
Zeile 229:		Zeile 229:
	oder		oder
	set ht select <templateName>		set ht select <templateName>

	==Template prüfen==		==Template prüfen==
	Templates werden auf korrekte Implementierung in der Entity anhand eines Vergleichs der gelesenen Registern mit den gewünschten Regitern geprüft. Es ist also notwendig, dass die Registerwerte in der FHEM Kopie aktuell sind. Dann reicht ein		Templates werden auf korrekte Implementierung in der Entity anhand eines Vergleichs der gelesenen Registern mit den gewünschten Regitern geprüft. Es ist also notwendig, dass die Registerwerte in der FHEM Kopie aktuell sind. Dann reicht ein

Pahenning: /* Architektur */

2020-03-23T08:13:59Z

Architektur

← Nächstältere Version		Version vom 23. März 2020, 10:13 Uhr
Zeile 94:		Zeile 94:
	Für die Verknüpfung von HM Entities muss man 2 Ebenen unterschieden, Architektur und Verhalten.		Für die Verknüpfung von HM Entities muss man 2 Ebenen unterschieden, Architektur und Verhalten.
	==Architektur==		==Architektur==
	Beim Erstellen der Architektur legt man fest, welche Entities untereinander verknüpft werden. Dies geschieht durch peeren. Templates unterstützen nicht die Architektur. Es ist demnach notwendig die Peerings durchzuführen bevor an ein Template darauf anwenden kann.		Beim Erstellen der Architektur legt man fest, welche Entities untereinander verknüpft werden. Dies geschieht durch peeren. Templates unterstützen nicht die Architektur. Es ist demnach notwendig, die Peerings durchzuführen, bevor an ein Template darauf anwenden kann.

	==Verhalten==		==Verhalten==
	Hier kommen die Templates zum Tragen. Mit Templates definiert man die Register der Entities und somit das Verhalten und die Reaktion der Entites bspw auf Trigger von Sensoren.		Hier kommen die Templates zum Tragen. Mit Templates definiert man die Register der Entities und somit das Verhalten und die Reaktion der Entites bspw auf Trigger von Sensoren.

Pahenning: /* Das eigenen Konzept */

2020-03-23T08:13:36Z

Das eigenen Konzept

← Nächstältere Version		Version vom 23. März 2020, 10:13 Uhr
Zeile 91:		Zeile 91:


	=Das ~~eigenen~~ Konzept=		=Das eigene Konzept=
	Für die Verknüpfung von HM Entities muss man 2 Ebenen unterschieden, Architektur und Verhalten.		Für die Verknüpfung von HM Entities muss man 2 Ebenen unterschieden, Architektur und Verhalten.
	==Architektur==		==Architektur==

Pahenning: /* Was bieten Templates */

2020-03-23T08:12:25Z

Was bieten Templates

← Nächstältere Version		Version vom 23. März 2020, 10:12 Uhr
Zeile 31:		Zeile 31:

	;soll-Register Verwaltung		;soll-Register Verwaltung
	:Da FHEM nur eine Kopie der ~~ist~~-Registerwerte verwaltet lebt man erst grundsätzlich in einer fragilen Welt. Eine Soll-Wert Verwaltung der Register ~~bietet~~ nur in Templates.		:Da FHEM nur eine Kopie der Ist-Registerwerte verwaltet, lebt man erst grundsätzlich in einer fragilen Welt. Eine Soll-Wert Verwaltung der Register erfolgt nur bei Verwendung von Templates.
	;Funktionen für Einsteiger		;Funktionen für Einsteiger
	:Nicht-Experten sollten primär Templates nutzen - um Funktionen zu realisieren. Der Anwender holt sich ein Template und kopiert es in sein System. Nun kann er		:Nicht-Experten sollten primär Templates nutzen - um Funktionen zu realisieren. Der Anwender holt sich ein Template und kopiert es in sein System. Nun kann er

Pahenning: /* Warum Templates */

2020-03-23T08:11:36Z

Warum Templates

← Nächstältere Version		Version vom 23. März 2020, 10:11 Uhr
Zeile 13:		Zeile 13:
	Nun, die Gründe sind vielfältig - und eigentlich unabdingbar für alle, die ein geordnetes System verwalten wollen.		Nun, die Gründe sind vielfältig - und eigentlich unabdingbar für alle, die ein geordnetes System verwalten wollen.
	;Register ohne Template - Schwachstellen		;Register ohne Template - Schwachstellen
	:Register werden, wie bekannt, ~~permanent~~ in den HM-Devices gespeichert. FHEM hat eine Kopie dieser Daten welche über getConfig aufgefrischt werden können. Setzt man nun in einem Device ein Register ist dies erst einmal erledigt. Nun kann sich das Register verändern bzw muss überprüft werden, wenn		:Register werden, wie bekannt, remanent in den HM-Devices gespeichert (also im Flash-Speicher). FHEM hat eine Kopie dieser Daten welche über getConfig aufgefrischt werden können. Setzt man nun in einem Device ein Register ist dies erst einmal erledigt. Nun kann sich das Register verändern bzw muss überprüft werden, wenn
	* das Device ausgetauscht wird		* das Device ausgetauscht wird
	* das Device reseted wird - kommt auch einmal vor		* das Device reseted wird - kommt auch einmal vor

Pahenning: /* Warum Templates */

2020-03-23T08:10:00Z

Warum Templates

← Nächstältere Version		Version vom 23. März 2020, 10:10 Uhr
Zeile 13:		Zeile 13:
	Nun, die Gründe sind vielfältig - und eigentlich unabdingbar für alle, die ein geordnetes System verwalten wollen.		Nun, die Gründe sind vielfältig - und eigentlich unabdingbar für alle, die ein geordnetes System verwalten wollen.
	;Register ohne Template - Schwachstellen		;Register ohne Template - Schwachstellen
	:Register werden, wie bekannt, ~~remanent~~ in den HM-Devices gespeichert. FHEM hat eine Kopie dieser Daten welche über getConfig aufgefrischt werden können. Setzt man nun in einem Device ein Register ist dies erst einmal erledigt. Nun kann sich das Register verändern bzw muss überprüft werden, wenn		:Register werden, wie bekannt, permanent in den HM-Devices gespeichert. FHEM hat eine Kopie dieser Daten welche über getConfig aufgefrischt werden können. Setzt man nun in einem Device ein Register ist dies erst einmal erledigt. Nun kann sich das Register verändern bzw muss überprüft werden, wenn
	* das Device ausgetauscht wird		* das Device ausgetauscht wird
	* das Device reseted wird - kommt auch einmal vor		* das Device reseted wird - kommt auch einmal vor
Zeile 25:		Zeile 25:
	Anzumerken ist, dass die Nutzung von Templates das Bedienen der Register nicht abschaltet oder übersteuert sondern nur ergänzt.		Anzumerken ist, dass die Nutzung von Templates das Bedienen der Register nicht abschaltet oder übersteuert sondern nur ergänzt.

	Templates heben das Bedienen der Register von der Assembler ~~ebene~~ auf eine Hochsprachen-Ebene. Nicht ohne Grund ~~ist~~ die erste Bedienung der Register in der eq3-CCU ~~quasi per Template~~. Register werden nur im Expert mode sichtbar.		Templates heben das Bedienen der Register von der Assembler-Ebene auf eine Hochsprachen-Ebene. Nicht ohne Grund erfolgt die erste Bedienung der Register in der eq3-CCU über einen ähnlichen Mechanismus. Register werden nur im Expert mode sichtbar.

	= Was bieten Templates =		= Was bieten Templates =

Martinp876: /* Template aus Device */

2019-12-01T13:22:00Z

Template aus Device

← Nächstältere Version		Version vom 1. Dezember 2019, 15:22 Uhr
Zeile 133:		Zeile 133:
	==Template erstellen und bearbeiten==		==Template erstellen und bearbeiten==
	Templates kann man erstellen, in dem man die Register einer Entity nimmt und bearbeitet. Auch das Kopieren und Bearbeiten eines vorhandenen Templates ist möglich. Und man kann Templates exportieren/importieren.		Templates kann man erstellen, in dem man die Register einer Entity nimmt und bearbeitet. Auch das Kopieren und Bearbeiten eines vorhandenen Templates ist möglich. Und man kann Templates exportieren/importieren.
	===Template aus ~~Device~~===		===Template aus vorhandener Programmierung erstellen===
	Aufgabe ist es, aus einem existierenden Device ein Template zu erstellen. Wir haben		Aufgabe ist es, aus einem existierenden, programmierten Device ein Template zu erstellen. Wir haben
	device ''myDev''		*device ''myDev''
	Channel ''myChan''		*Channel ''myChan''
	Channel gepeert mit ''myChanPeer''~~.<br>~~		*Channel gepeert mit ''myChanPeer''
	Der Kanal ist ein Schalter und wir wollen einen Parameter im Template nutzen~~: Die~~ Anschaltzeit ~~soll bei der Nutzung des Templates~~ variabel ~~eingesetzt werden~~. Wir werden also den Parameter ''timeOn'' nutzen. Das Template soll ''my1stTmpl'' genannt werden. Weiter soll das gesamte Verhalten des ''myChanPeer'' definiert werden, also short UND long.		Der Kanal ist ein Schalter und wir wollen einen Parameter im Template nutzen um die Anschaltzeit variabel zu steuern. Wir werden also den Parameter ''timeOn'' nutzen. Das Template soll ''my1stTmpl'' genannt werden. Weiter soll das gesamte Verhalten des ''myChanPeer'' definiert werden, also short UND long.
	set ht define my1stTmpl		set ht define my1stTmpl
	attr ht tpl_param timeOn # name des Parameters - hier nur einer		attr ht tpl_param timeOn # name des Parameters - hier nur einer
Zeile 150:		Zeile 150:
	attr ht Reg_shOnTime timeOn # setzen des parameters		attr ht Reg_shOnTime timeOn # setzen des parameters

	~~nun~~ können weitere Register verändert werde.		bei Bedarf können weitere Register verändert werde. <br>
	~~Sinnvoll~~ ist es, unnötige Register aus dem Template zu entfernen. Dies sind in diesem Fall bspw. alle Ct register. Das Attribut des Registers wird einfach gelöscht.		Nun sind wir fertig. Möglich, aber nicht notwendig ist es, unnötige Register aus dem Template zu entfernen. Dies sind in diesem Fall bspw. alle Ct register. Das Attribut des Registers wird einfach gelöscht.
	set ht save		set ht save
	set ht dismiss		set ht dismiss

	===Template Varianten speichern===		===Template Varianten speichern===
	Ist man beim Erstellen von Templates kann man mti saveAs das Template als neues unter einem anderen Namen sichern.		Ist man beim Erstellen von Templates kann man mti saveAs das Template als neues unter einem anderen Namen sichern.

Martinp876: /* Was bieten Templates */

2019-12-01T13:14:17Z

Was bieten Templates

← Nächstältere Version		Version vom 1. Dezember 2019, 15:14 Uhr
Zeile 52:		Zeile 52:
	:Was programmiert ist kann man in HmInfo ermitteln über		:Was programmiert ist kann man in HmInfo ermitteln über
	*get hm peerUsg		*get hm peerUsg
			:Wie das erstellt wird, wird weiter unten erklärt

	= Grundsätzliches zum Template =		= Grundsätzliches zum Template =

Martinp876: /* Was bieten Templates */

2019-12-01T13:13:35Z

Was bieten Templates

← Nächstältere Version		Version vom 1. Dezember 2019, 15:13 Uhr
Zeile 46:		Zeile 46:
	:Der Anwender hat typisch den Wunsch, eine Funktion zu relaisieren, aber einen Parameter will er bei jeder Anwendung anpassen. So will ich typischerweise, dass nach einem ON-Trigger immer eine automatische Abschaltung eingestellt wird, was das Vergessen des Ausschaltes verhindern soll. Die Anschaltzeit ist aber im Wohnzimmer eher 6h, im Treppenhaus aber 2h und bei einem Bewegungsmelder 10min.		:Der Anwender hat typisch den Wunsch, eine Funktion zu relaisieren, aber einen Parameter will er bei jeder Anwendung anpassen. So will ich typischerweise, dass nach einem ON-Trigger immer eine automatische Abschaltung eingestellt wird, was das Vergessen des Ausschaltes verhindern soll. Die Anschaltzeit ist aber im Wohnzimmer eher 6h, im Treppenhaus aber 2h und bei einem Bewegungsmelder 10min.
	:Hier kann man nun immer das gleiche Template nutzen. Die Abschaltzeit wird separat eingestellt und ist per Kommando modifizierbar. Weiter ist sie in den Readings sichtbar.		:Hier kann man nun immer das gleiche Template nutzen. Die Abschaltzeit wird separat eingestellt und ist per Kommando modifizierbar. Weiter ist sie in den Readings sichtbar.
			;Anwendungsbeispiel Lichtschalter
			:Grundsätzlich sind Lichtschalter erst einmal einfach: An/Aus Was kann man schon "templaten"?
			:Ich habe diverse Lichter und einige zugehörige Schalter. Da meine Fernbedienungen nur eine endliche Anzahl Knöpfe haben muss ich mir ein Konzept überlegen. Nutzen kann ich bei einem Wippschalter 2 Buttons (Knöpfe) und unterscheide bei jedem langer oder kurzer Druck. Bei Schaltern benötige ich demnach Templates für On, Off, Toggle. Nun kann ich jeder Paarung Aktor/Sensor und hier Long/Short eine Funktion zuweisen.
			:Nun nutze ich Buttons um bei pressLong das Licht 1 zu toggeln, bei PressShort toggelt es Licht 2.
			:Was programmiert ist kann man in HmInfo ermitteln über
			*get hm peerUsg

	= Grundsätzliches zum Template =		= Grundsätzliches zum Template =