HomeMatic HMinfo Templates erstellen: Unterschied zwischen den Versionen

Aktuelle Version vom 3. Dezember 2021, 12:13 Uhr

Mit diesem kleinen HowTo soll gezeigt werden, wie ein eigenes Template für die Konfiguration von Aktoren (Type switch) mit Tastern (Type remote) erstellt werden kann.

Grundlegende Informationen finden sich auf der Seite HMinfo.

Kurzerklärung Templates

Templates erleichtern den Umgang mit Register. Wie in HMinfo erläutert muss man den möglichen Umfang eines einzelnen Templates verstehen. Ein Template beinhaltet mindestens ein Register, typisch sicher mehrere. Maximal beschränkt sich ein einzelnes Template auf

eine Entity (einen Kanal)
0-Template: alle Register die NICHT einem Peer zugeordnet sind
peer-Template: Register die einem Peer zugeordnet sind
- short/long-Template: Alle Register eines Peers für short ODER long. Beschrieben wird das short ODER long Verhalten
- both-Template: Alle Register eines Peers - beschrieben wird short UND long Verhalten

Wie feingranular man ein Template erstellt ist Geschmackssache. Man kann einer Entity beliebig viele Templates zuweisen. Wenn sich Inhalte überschneiden kommt es zu Problemen, welche mit configCheck aufgedeckt werden.

Erstellen eines Templates

Ziel ist es die Funktion der Tasten zu ändern/tauschen. Peert man das Tastenpaar 5/6 eines HM-PB-6-WM55 mit dem Channel 1 von einem HM-LC-SW2-FM mittels

 set RC61_5 peerChan 0 SW01_Sw01 dual set both

entsteht der Ausgangszustand: Taste 5 RC61_5 schaltet SW01_Sw01 aus. Taste 6 RC61_6 schaltet SW01_Sw01 ein.

Die regTable dazu sieht so aus:

                        RC61_5                          RC61_6                          
                        lg              sh              lg              sh              
 ActionType             jmpToTarget     jmpToTarget     jmpToTarget     jmpToTarget     
 CtDlyOff               geLo            geLo            geLo            geLo            
 CtDlyOn                geLo            geLo            geLo            geLo            
 CtOff                  geLo            geLo            geLo            geLo            
 CtOn                   geLo            geLo            geLo            geLo            
 CtValHi                100             100             100             100             
 CtValLo                50              50              50              50              
 MultiExec              on              off             on              off             
 OffDly            [s]  0               0               0               0               
 OffTime                unused          unused          unused          unused          
 OffTimeMode            absolut         absolut         absolut         absolut         
 OnDly             [s]  0               0               0               0               
 OnTime                 unused          unused          unused          unused          
 OnTimeMode             absolut         absolut         absolut         absolut         
 SwJtDlyOff             off             off             on              on              
 SwJtDlyOn              off             off             on              on              
 SwJtOff                off             off             dlyOn           dlyOn           
 SwJtOn                 dlyOff          dlyOff          on              on

Damit der gewünschte Effekt entsteht sollen die Register wie folgt geändert werden, es werden nur die Register für sh geändert!

 SwJtDlyOff             off             no              on              no              
 SwJtDlyOn              off             no              on              no              
 SwJtOff                off             on              dlyOn           no           
 SwJtOn                 dlyOff          no              on              off

Jetzt werden zwei Templates definiert

 set hminfo templateDef tmpl_SwOnOnly 0 "Template für nur an" ActionType:jmpToTarget SwJtDlyOff:no SwJtDlyOn:no SwJtOff:on SwJtOn:no
 set hminfo templateDef tmpl_SwOffOnly 0 "Template für nur aus" ActionType:jmpToTarget SwJtDlyOff:no SwJtDlyOn:no SwJtOff:no SwJtOn:off

und entsprechend übertragen

 set hm templateSet SW01_Sw01 tmpl_SwOnOnly RC61_5:short
 set hm templateSet SW01_Sw01 tmpl_SwOffOnly RC61_6:short

Die Konfiguration kann auf unterschiedliche Art gesichert werden, z.B:

 set hm saveConfig config.txt

schreibt alles (Die gesamte Konfiguration die HMinfo aus FHEM ermitteln kann - also nicht aus den Geräten selbst) in eine Datei /opt/fhem/config.txt.

Aus der Datei können im Bedarfsfall einzelne Befehle zum Setzen der Register herausgezogen werden.

Weitere Möglichkeiten bietet das Modul mit archConfig

Templates Repository

Hier werden einige Templates angeboten, welche im System integriert werden können

Generelle Einstellungen

define hm HMinfo
attr hm autoArchive 1
attr hm autoLoadArchive 1_load
attr hm autoUpdate 0:3
attr hm configFilename regConfig.cfg

switch Templates

long-short

Templates zum Setzen der Condition-Table

set hm templateDef SwOnCond level:cond "switch: execute only if condition [geLo|ltLo] level is below limit" CtValLo:p0 CtOn:p1 CtOff:p1 CtDlyOn:p1 CtDlyOff:p1
set hm templateDef SwCondAbove condition "Switch: execute only if condition level is above limit" CtValLo:p0 CtOn:geLo CtOff:geLo CtDlyOn:geLo CtDlyOff:geLo
set hm templateDef SwCondBelow condition "Switch: execute only if condition level is below limit" CtValLo:p0 CtOn:ltLo CtOff:ltLo CtDlyOn:ltLo CtDlyOff:ltLo
set hm templateDef autoOff time "staircase - auto off after -time-, extend time with each trigger" SwJtDlyOn:no ActionType:jmpToTarget SwJtDlyOff:dlyOn OnTime:p0 OffTime:unused SwJtOn:on SwJtOff:dlyOn

Templates zur Definition einer Aktion

set hm templateDef SwIgnore 0 "ignore event" ActionType:off
set hm templateDef SwOff 0 "Switch: off if trigger" SwJtDlyOn:dlyOff ActionType:jmpToTarget SwJtDlyOff:off OnTime:unused OffTime:unused SwJtOn:dlyOff SwJtOff:no
set hm templateDef SwOn 0 "Switch: on if trigger" SwJtDlyOn:on ActionType:jmpToTarget SwJtDlyOff:dlyOn OnTime:unused OffTime:unused SwJtOn:no SwJtOff:dlyOn
set hm templateDef SwToggle 0 "Switch: toggle on trigger" SwJtDlyOn:on ActionType:jmpToTarget SwJtDlyOff:off OnTime:unused OffTime:unused SwJtOn:dlyOff SwJtOff:dlyOn

Beispiel Nutzung: nutze den Trigger "short" des Peers "MeinPeer" wenn der Level größer als 30 ist. Als Aktion ist ein 2. Template zum Einschalten aktiviert. Bei langem Trigger soll ausgeschaltet werden

set hm templateSet <MeinLicht> SwOnCond <MeinPeer:short> 30 gtLo
set hm templateSet <MeinLicht> SwOn <MeinPeer:short> 
set hm templateSet <MeinLicht> SwOff <MeinPeer:long>

both

Both ist ein kompakterer Ansatz - man definiert das komplette Verhalten eines Peers, also short und long in einem.

set hm templateDef SwMdir onTime:minBright "switch action when peered motionDetector" shOnDly:0 shSwJtOn:no shOffDly:p0 lgActionType:off shCtDlyOff:ltHi shOffTimeMode:minimal shCtValLo:p1 lgMultiExec:off shOnTime:0 shCtValHi:255 shOffTime:unused shMultiExec:off shOnTimeMode:minimal shSwJtOff:dlyOff shSwJtDlyOff:dlyOff shCtOff:ltLo shActionType:jmpToTarget shCtOn:ltLo shSwJtDlyOn:no shCtDlyOn:ltLo
set hm templateDef SwSonLoff 0 "Switch: shortOn, long Off" lgSwJtOff:no lgOffTime:unused shOffTime:unused shSwJtOn:no lgSwJtOn:dlyOff lgActionType:jmpToTarget shSwJtOff:dlyOn shSwJtDlyOff:dlyOn shActionType:jmpToTarget lgSwJtDlyOff:off shSwJtDlyOn:on lgSwJtDlyOn:dlyOff lgOnTime:unused shOnTime:unused
set hm templateDef SwSoffLignore 0 "Switch: shortOff, long Ignore" shOffTime:unused shSwJtOn:dlyOff lgActionType:off shSwJtDlyOff:off shSwJtOff:no shActionType:jmpToTarget shSwJtDlyOn:dlyOff shOnTime:unused

Beispiel: Konfiguration eines Aussenlichts mit Motion-Detector. Erzielt werden soll das Einschalten bei Dunkelheit (brght kleiner 70) für 30sec. Per Tastendruck soll das Licht eingeschaltet werden und endlos anbleiben (Ausschalten nicht vergessen). Alternativ einschalten für einige Stunden - das sollte auch reichen - und es geht irgendwann doch aus. Im Beispiel für Button2 4 Stunden.

set hm templateSet <MeinLicht> SwMdir <MotionPeer:both> 30 70
set hm templateSet <MeinLicht> SwSonLoff <ButtonPeer:both>  
set hm templateSet <MeinLicht> autoOff <Button2Peer:short> 14400

Dimmer Templates

long-short

set hm templateDef DimDown rampTime "ramp down to 0, ramp valiable" DimJtRampOff:off OnTime:unused DimJtOn:dlyOff OffTime:unused OffDlyStep:5 DimJtOff:rampOff OffTimeMode:absolut OffDlyBlink:on OnDlyMode:setToOff DimJtRampOn:dlyOff OffDlyOldTime:0.4 RampOnTime:p0 DimMaxLvl:100 OnTimeMode:absolut RampSstep:5 OnLvlPrio:high DimMinLvl:0 DimStep:5 DimJtDlyOff:rampOff OffLevel:0 OnMinLevel:10 ActionTypeDim:jmpToTarget OnDly:0 OffDly:0 OffDlyNewTime:0.4 RampOffTime:p0 OnLevel:100 DimJtDlyOn:dlyOff
set hm templateDef DimOff 0 "Dimmer: off if trigger" DimJtDlyOff:off DimJtRampOff:dlyOff DimJtOn:dlyOff OnTime:unused ActionTypeDim:jmpToTarget DimJtOff:no OffTime:unused DimJtRampOn:dlyOff DimJtDlyOn:dlyOff
set hm templateDef DimOn 0 "Dimmer: on if trigger" DimJtDlyOff:dlyOn DimJtRampOff:dlyOn DimJtOn:no OnTime:unused ActionTypeDim:jmpToTarget DimJtOff:dlyOn OffTime:unused DimJtRampOn:dlyOn DimJtDlyOn:on
set hm templateDef DimUp onLevel:rampTime:onTime "ramp up soft" DimJtRampOff:dlyOn OnTime:p2 DimJtOn:rampOn OffTime:unused OffDlyStep:5 DimJtOff:dlyOn OffTimeMode:absolut OffDlyBlink:on OnDlyMode:setToOff DimJtRampOn:on OffDlyOldTime:0.4 RampOnTime:p1 DimMaxLvl:p0 OnTimeMode:absolut RampSstep:5 OnLvlPrio:high DimMinLvl:0 DimStep:5 DimJtDlyOff:dlyOn OffLevel:0 OnMinLevel:10 ActionTypeDim:jmpToTarget OnDly:0 OffDly:0 OffDlyNewTime:0.4 RampOffTime:p1 OnLevel:p0 DimJtDlyOn:rampOn

both

Blind (Rollo) Templates

devicelevel

set hm templateDef BlSetDrive up:down:turn "drive times up, down and turn plus gen defaults" statusInfoRandom:0 localResDis:off refRunCounter:0 statusInfoMinDly:3 driveUp:p0 driveDown:p1 transmitTryMax:6 driveTurn:p2 intKeyVisib:visib confBtnTime:permanent sign:off
set hm templateSet Blind BlSetDrive 100 105 0.5 # Setze Fahrzeiten auf 100s, runter 105s, turn 0.5s

long-short

set hm templateDef BlStopDnLg 0 "Blind: stop drive on any key - for long drive down" BlJtOn:dlyOff BlJtDlyOff:refOff BlJtDlyOn:dlyOff ActionType:jmpToTarget BlJtOff:dlyOff BlJtRampOff:rampOff BlJtRampOn:on BlJtRefOn:on BlJtRefOff:rampOff
set hm templateDef BlStopDnSh 0 "Blind: stop drive on any key - for short drive down" BlJtOn:dlyOff BlJtDlyOff:refOff BlJtDlyOn:dlyOff ActionType:jmpToTarget BlJtOff:dlyOff BlJtRampOff:off BlJtRampOn:on BlJtRefOn:on BlJtRefOff:rampOff
set hm templateDef BlStopUpLg 0 "Blind: stop drive on any key - for long drive up" BlJtOn:dlyOn BlJtDlyOff:dlyOn BlJtDlyOn:refOn ActionType:jmpToTarget BlJtOff:dlyOn BlJtRampOff:off BlJtRampOn:rampOn BlJtRefOn:rampOn BlJtRefOff:off
set hm templateDef BlStopUpSh 0 "Blind: stop drive on" BlJtOn:dlyOn BlJtDlyOff:dlyOn BlJtDlyOn:refOn ActionType:jmpToTarget BlJtOff:dlyOn BlJtRampOff:off BlJtRampOn:on BlJtRefOn:rampOn BlJtRefOff:off
set hm templateDef BlToggle 0 "toggle mein Rollo" BlJtDlyOff:no BlJtOn:dlyOff ActionType:jmpToTarget BlJtDlyOn:no BlJtOff:dlyOn BlJtRampOff:dlyOn BlJtRampOn:dlyOff BlJtRefOn:dlyOff BlJtRefOff:dlyOn

both

set hm templateDef BlSmartStopDn 0 "from Master BlSmartStopDn > FB_09:both" shBlJtOff:dlyOff lgCtDlyOff:geLo lgDriveMode:direct lgOffLevel:0 lgActionType:jmpToTarget shBlJtDlyOn:dlyOff shOffLevel:0 lgCtValLo:50 lgCtRefOn:geLo lgBlJtOff:dlyOff shCtDlyOff:geLo shOffTimeMode:absolut lgOnLevel:100 lgBlJtDlyOn:dlyOff lgBlJtDlyOff:refOff shBlJtDlyOff:refOff lgMultiExec:on lgOffDly:0 lgBlJtRefOff:rampOff shCtValHi:100 lgMaxTimeF:0.5 shBlJtRefOn:on lgCtValHi:100 shBlJtRampOff:off shCtRefOff:geLo shCtRampOn:geLo shMaxTimeF:unused shOnTimeMode:absolut shBlJtRefOff:rampOff lgOnTime:unused lgCtRefOff:geLo lgOnTimeMode:absolut lgCtRampOff:geLo shOnDly:0 lgCtRampOn:geLo lgOffTime:unused lgBlJtRefOn:on shOffDly:0 shCtRefOn:geLo lgCtOff:geLo lgCtOn:geLo shCtValLo:50 lgBlJtOn:dlyOff lgOnDly:0 lgOffTimeMode:absolut shBlJtRampOn:on shBlJtOn:dlyOff shOnTime:unused shDriveMode:direct shOffTime:unused lgCtDlyOn:geLo shOnLevel:100 lgBlJtRampOn:on shCtRampOff:geLo shMultiExec:off shCtOff:geLo shActionType:jmpToTarget shCtOn:geLo shCtDlyOn:geLo lgBlJtRampOff:rampOff
set hm templateDef BlSmartStopUp 0 "from Master BlSmartStopUp > FB_10:both" shBlJtOff:dlyOn lgCtDlyOff:geLo lgDriveMode:direct lgOffLevel:0 lgActionType:jmpToTarget shBlJtDlyOn:refOn shOffLevel:0 lgCtValLo:50 lgCtRefOn:geLo lgBlJtOff:dlyOn shCtDlyOff:geLo lgOnLevel:100 shOffTimeMode:absolut lgBlJtDlyOff:dlyOn lgBlJtDlyOn:refOn shBlJtDlyOff:dlyOn lgMultiExec:on lgOffDly:0 lgBlJtRefOff:off shCtValHi:100 lgMaxTimeF:0.5 shBlJtRefOn:rampOn lgCtValHi:100 shCtRefOff:geLo shCtRampOn:geLo shBlJtRampOff:off shMaxTimeF:unused shBlJtRefOff:off shOnTimeMode:absolut lgCtRefOff:geLo lgOnTime:unused lgOnTimeMode:absolut lgCtRampOff:geLo lgCtRampOn:geLo shOnDly:0 lgOffTime:unused lgBlJtRefOn:rampOn shOffDly:0 shCtRefOn:geLo lgCtOff:geLo lgCtOn:geLo shCtValLo:50 lgBlJtOn:dlyOn lgOnDly:0 lgOffTimeMode:absolut shBlJtRampOn:on shBlJtOn:dlyOn shOnTime:unused shDriveMode:direct shOffTime:unused lgCtDlyOn:geLo shOnLevel:100 lgBlJtRampOn:rampOn shCtRampOff:geLo shMultiExec:off shCtOff:geLo shActionType:jmpToTarget shCtOn:geLo shCtDlyOn:geLo lgBlJtRampOff:off

Heizung RT Templates

Man muss hier die einzelnen Kanäle unterscheiden. Da sich die Register unterscheiden sind für jeden Kanal eigene Templates erstellt worden. Achtung: Die Templates sind in diesem Fall Beispiele. Evtl sind andere Einstellungen gewünscht.

RT-device

Selektierbar ist, ob Buttonlock ein oder ausgeschaltet sein soll. Mit Beispielnutzung

set hm templateDef HeatDefDev BtnLock "Default RT Device register" globalBtnLock:off modusBtnLock:off localResDis:off cyclicInfoMsg:on backOnTime:10 lowBatLimitRT:2.1 burstRx:on cyclicInfoMsgDis:0 btnLock:p0

set hm templateSet rtDevice HeatDefDev 0 on # buttonLock ist eingeschaltet

Eine Alternative - wenn man auch den Batterielevel selektiv einstellen will. Da es bei allen meinen RTs identisch ist stelle ich es im Define ein, nicht im Set. Aber dennoch hier das Beispiel

set hm templateDef HeatDefDev BtnLock:BatLevel "Default RT Device register" globalBtnLock:off modusBtnLock:off localResDis:off cyclicInfoMsg:on backOnTime:10 lowBatLimitRT:p1 burstRx:on cyclicInfoMsgDis:0 btnLock:p0

set hm templateSet rtDevice HeatDefDev 0 2.3 on # buttonLock ist eingeschaltet, BatMinLevel ist 2.3V

RT-Clima

set hm templateDef HeatDefault boost "myDefault RT settings, enter boostTime" reguIntI:20 regAdaptive:offDeter nightTemp:17 tempOffset:0.0K dayTemp:21 reguIntPstart:5 reguExtI:20 reguIntP:25 reguExtP:25 showWeekday:off tempMin:4.5 tempMax:30.5 valveMaxPos:15 valveOffsetRt:0 modePrioManu:all daylightSaveTime:on boostPos:30 showInfo:time decalcWeekday:Sat btnNoBckLight:off decalcTime:11:00 noMinMax4Manu:off reguExtPstart:5 valveErrPos:15 modePrioParty:all boostPeriod:p0
set hm templateSet RT1_Clima HeatDefault 20 on # Clima-defaults - Boost fpr RT1 ist auf 20 min eingestellt
set hm templateSet RT2_Clima HeatDefault 5 on # Clima-defaults - Boost fpr RT1 ist auf 5 min eingestellt

RT-Remote

Um mit einem Button "gute Nacht" zu sagen und alle Lichter auszuschalten kann man den Button auch mit den RTs koppeln und auf Nachttemp zu schalten. Man muss hier - wie beim Switch - long/short und both unterscheiden. Im Beispiel ist ein long/short template genutzt.

set hm templateDef HeatRemote temp "heatRemote set temperature CtrlRc:autoAndTemp" TempRC:p0

set hm templateSet RT1_Remote HeatRemote <Button1:long> 18 # schalte bei trigger long auf 18 Grad(Nacht)
set hm templateSet RT1_Remote HeatRemote <Button1:short> 23 # schalte bei trigger short auf 23 Grad(Tag)
set hm templateSet RT1_Remote HeatRemote <Button2:long> 15 # schalte bei trigger long auf 15 Grad
set hm templateSet RT1_Remote HeatRemote <Button2:short> 28 # schalte bei trigger short auf 28 Grad

SmokeDetector SD2

Entschieden, ob der Repeater eingeschaltet werden soll oder nicht.

set hm templateDef  sd2Rep repeat "SD2 setup as repeater (1) or not (0)" devRepeatCntMax:p0

Links

commandref/HMinfo
hmInfo Wiki: HMinfo

@@ Zeile 1: / Zeile 1: @@
 Mit diesem kleinen HowTo soll gezeigt werden, wie ein eigenes Template für die Konfiguration von Aktoren (Type switch) mit Tastern (Type remote) erstellt werden kann.
-Grundlegende Infos findet man hier: [[HomeMatic_HMInfo]]
+Grundlegende Informationen finden sich auf der Seite [[HMinfo]].
 == Kurzerklärung Templates==
 Templates erleichtern den Umgang mit Register. Wie in HMinfo erläutert muss man den möglichen Umfang eines einzelnen Templates verstehen. Ein Template beinhaltet mindestens ein Register, typisch sicher mehrere. Maximal beschränkt sich ein einzelnes Template auf
@@ Zeile 61: / Zeile 62: @@
 Die Konfiguration kann auf unterschiedliche Art gesichert werden, z.B:
    set hm saveConfig config.txt
-schreibt alles (Die gesamte Konfiguration die hmInfo aus FHEM ermitteln kann - also nicht aus den Geräten selbst) in eine Datei /opt/fhem/config.txt.
+schreibt alles (Die gesamte Konfiguration die HMinfo aus FHEM ermitteln kann - also nicht aus den Geräten selbst) in eine Datei /opt/fhem/config.txt.
 Aus der Datei können im Bedarfsfall einzelne Befehle zum Setzen der Register herausgezogen werden.
@@ Zeile 166: / Zeile 167: @@
 == Links ==
 * {{Link2CmdRef|Lang=de|Anker=HMinfo}}
-* hmInfo Wiki: [[HomeMatic_HMInfo]]
+* hmInfo Wiki: [[HMinfo]]
 [[Kategorie:HomeMatic supportDevice]]
 [[Kategorie:HOWTOS]]