HM-Dis-WM55 Funk Statusanzeige

Aus FHEMWiki

HM-Dis-WM55

HomeMatic Funk-Statusanzeige WM55

Features

Technische Daten:

  • Farbiges OLED-Display mit 128 x 128 RGB-Bildpunkten
  • Frei programmierbar über HomeMatic-WebUI
  • Dynamische Zuweisung von Anzeigeplätzen, Texten, Zustand von Systemvariablen, Symbolen
  • In den Anzeigerahmen integrierte Taster für Anmeldung, Seitenfortschaltung und Auslösen von Zentralenprogrammen, z. B. Abfrage von Fensterzuständen bei Verlassen des Hauses
  • Nur 19 mm flach, Schraub- oder Klebmontage, ortsunabhängiger Batteriebetrieb
  • Lieferung mit weißem Rahmen, alternativ integrierbar in 55-mm-Installationsrahmen zahlreicher Installationsserien (Berker, ELSO, GIRA, merten, JUNG)

Allgemeines

Die Funk-Statusanzeige hat 10 Kanäle (HM-Dis-WM55_Dis_01 bis HM-Dis-WM55_Dis_10). Jedem der Kanäle können 2 Texte zugewiesen werden. Kanal 1 und 2 kommt eine Doppelrolle zu. Sie enthalten sowohl Texte, sind aber auch die beiden Tasten. Und so wird auch die Ausgabe der Displayanzeige auf diese beiden Kanäle gegeben.

Das Display hat 6 Zeilen zur Darstellung von bis zu 12 Zeichen und einem von 12 Icons.

Die Zeilen können einzeln befüllt und getauscht werden, dies muss nicht in einem Rutsch passieren.

Probleme

Es gibt hin und wieder Probleme die Register auszulesen. Abhilfe ist msgrepeat auf 3 zu setzten und hartnäckig bleiben.

Betrieb mit FHEM

Das Gerät wird zur Zeit experimentell unterstützt. msgrepeat sollte auf 3 gestellt werden, sonst gibt es öfters Timeouts:

attr HM-Dis-WM55 msgRepeat 3

Die Kanäle 1 und 2 sollten mit FHEM gepeered (zusätzlich zum pairing) werden

set HM-Dis-WM55_Dis_01 peerBulk <hmID>01
set HM-Dis-WM55_Dis_02 peerBulk <hmID>01 

Um einen Kanal mit Text zu befüllen dient der text Befehl auf einen Kanal. Es werden beide Texte in einen Kanal gleichzeitig geschrieben. Will ich einen Text tauschen muss ich den anderen mit neu setzten. Für ein Leerzeichen \_ einsetzten

set HM-Dis-WM55_Dis_01 text Fenster\_auf Fenster\_zu

zum Übernehmen der Konfiguration den Config Taster auf der Rückseite nehmen und über das Menü übernehmen

Nun kann man z.B. mit einem notify die Information an den Schalter senden, wenn ein Fenster offen und oder zu ist:

set HM-Dis-WM55_Dis_01 displayWM short line2 txt01_1 red error

short bedeutet bei einem kurzen Tastendruck (es geht auch long). line bezieht sich auf die Zeile in die es geschrieben wird. Anschließend folgt der Text, die Farbe in der der Text angezeigt werden soll, sowie das Icon.

Mit

set HM-Dis-WM55_Dis_01 displayWM help

kann eine Übersicht der gesetzten Texte angezeigt werden. Sowie der möglichen Farben und Icons.

Folgende Farben gibt es:

color is one white, red, orange, yellow, green, blue

Folgende Icons gibt es:

closed Schloss geschlossen
error Kreuz rot
ic12 Leersymbol
ic13 Leersymbol
info "i" in blauem Kreis
newMsg Briefkasten mit Flag
noIcon nichts
off Glühbirne aus
ok Haken grün
on Glühbirne an
open Schloss geöffnet
serviceMsg Mann mit Schraubenschlüssel
sigGreen Leuchte grün
sigRed Leuchte rot
sigYellow Leuchte gelb

Soll kein Text eingeblendet werden oder dieser nicht geändert werden, kann man einfach nc schreiben Beispiel

set HM-Dis-WM55_Dis_01 displayWM short line2 nc nc error

Dann wird nur das Icon getauscht oder eben nur jenes angezeigt.

dynamische Ausgaben

Um das Display wirkungsvoll einzusetzen ist es angebracht Texte dynamisch - abhängig von irgendwelchen Readings und Auswertungen zu erzeugen. Dies ist möglich, bedarf bei strukturierten Einbau einiges an Installation - ist aber am Ende einfacher als es anfänglich scheint. Möglichkeiten, es zu realisieren gibt es einige - hier ein Beispiel über myUtils.

fhemUser.cfg

Da im fhem.cfg kein set kommando vorkommen soll/kann sollte man ein separates File einbinden welches definiert nach Systeminitialisierung ausgeführt wird. Hierzu erzeugt man ein File fhem_user.cfg. Im normalen fhem.cfg baut man eine Zeile ein um es auszuführen:

define userCfg notify global:INITIALIZED include fhem_user.cfg

Wenn das File fhem_user.cfg mit der Oberfläche angelegt wurde (Edit file, Save as), liegt es im Unterverzeichnis ./FHEM und wird so eingebunden:

define userCfg notify global:INITIALIZED include ./FHEM/fhem_user.cfg

Im fhem_user.cfg stellt man nun für die beiden Buttons des display folgende Zeilen ein

set dis_01 displayWM short  line1 e:{myLineA(1,0)}
set dis_01 displayWM short  line2 e:{myLineA(2,0)}
set dis_01 displayWM short  line3 e:{myLineA(3,0)}
set dis_01 displayWM short  line4 e:{myLineA(4,0)}
set dis_01 displayWM short  line5 e:{myLineA(5,0)}
set dis_01 displayWM short  line6 e:{myLineA(6,0)}
                                                
set dis_01 displayWM long   line1 e:{myLineA(1,1)}
set dis_01 displayWM long   line2 e:{myLineA(2,1)}
set dis_01 displayWM long   line3 e:{myLineA(3,1)}
set dis_01 displayWM long   line4 e:{myLineA(4,1)}
set dis_01 displayWM long   line5 e:{myLineA(5,1)}
set dis_01 displayWM long   line6 e:{myLineA(6,1)}
                                                
set dis_02 displayWM short  line1 e:{myLineA(1,2)}
set dis_02 displayWM short  line2 e:{myLineA(2,2)}
set dis_02 displayWM short  line3 e:{myLineA(3,2)}
set dis_02 displayWM short  line4 e:{myLineA(4,2)}
set dis_02 displayWM short  line5 e:{myLineA(5,2)}
set dis_02 displayWM short  line6 e:{myLineA(6,2)}
                                                
set dis_02 displayWM long   line1 e:{myLineA(1,3)}
set dis_02 displayWM long   line2 e:{myLineA(2,3)}
set dis_02 displayWM long   line3 e:{myLineA(3,3)}
set dis_02 displayWM long   line4 e:{myLineA(4,3)}
set dis_02 displayWM long   line5 e:{myLineA(5,3)}
set dis_02 displayWM long   line6 e:{myLineA(6,3)}

Nun wird beim Tastendruck die Funktion myLineA gesucht - diese werden wir in 99_myUtils definieren.

99_myUtils

Hat man evtl. schon - dann kann man es erweitern. Um es auszuführen muss es aufgerufen werden. Daher wird eine Entity in fhem.cfg definiert

define mu myUtils

nun das File 99_myUtils.pm. Die instruktionen sind in den Kommentaren. Da es flexibel ist ist es auch keine strikte Anleitung.

 ##############################################
 #
 package main;
 
 use strict;
 use warnings;
 use POSIX;
 sub myLineA ($$);
 
 
 # define counter and counterlimit per press-type
 # presstype are 0: btn1 short
 # presstype are 1: btn1 long
 # presstype are 2: btn2 short
 # presstype are 3: btn2 long
 
 
 my @cnt   ; #init one counter per press
 my @cntMax; #number of entries per press
 # structure per button/itteration/press
 # insert the function to be executes to fill the line with test, color and icon
 # Number of itterations can be extended as desired. At least one should be present.
 # obey the end of the line (is open) and the number of parameters you send to the funktion
 my %lineArr = (0 =>{#============Btn Type 0: Btn1 short
                     0 =>{#-------itteration 0
                           1=>'{myTh("wz:","h_s_s2",'    #  line 1
                          ,2=>'{myTh("os:","h_s_s1",'    
                          ,3=>'{myTh("op:","h_s_aussen",'
                          ,4=>'{myPr("p:" ,"h_s_aussen",'
                          ,5=>'{myTx("","","",'             
                          ,6=>'{myTx("","","",'      
                         }
                    ,1 =>{#-------itteration 1
                           1=>'{myTh("wz:","h_s_s2",'    #  line 1
                          ,2=>'{myTh("os:","h_s_s1",'    
                          ,3=>'{myTh("op:","h_s_aussen",'
                          ,4=>'{myPr("p:" ,"h_s_aussen",'
                          ,5=>'{myTx("","","",'             
                          ,6=>'{myTx("","","",'      
                         }
                    }
               ,1 =>{#============Btn Type 0: Btn1 Long
                     0 =>{#-------itteration 0
                           1=>'{myTx("Info","green"        ,"info" ,'    #  line 1
                          ,2=>'{myHm("act:","I_actTotal"   ,"green",'
                          ,3=>'{myHm("bat:","I_sum_battery","green",'
                          ,4=>'{myHm("fl:" ,"I_fail"       ,"green",'      
                          ,5=>'{myTx(""    ,""             ,""     ,'  
                          ,6=>'{myTx(""    ,""             ,""     ,'  
                         }                                                        
                    ,1 =>{#-------itteration 0
                           1=>'{myTx(        "Error"        ,"red","error",'    #  line 1
                          ,2=>'{myHm("prt:" ,"ERR__protocol","red"   ,'            
                          ,3=>'{myHm("bat:" ,"ERR_battery"  ,"yellow",'
                          ,4=>'{myHm("prt:" ,"W__protocol"  ,"yellow",'            
                          ,5=>'{myTx(""     ,""             ,"",'  
                          ,6=>'{myTx(""     ,""             ,"",'  
                         }                                                        
                    }
               ,2 =>{#============Btn Type 2: Btn2 short
                     0 =>{#-------itteration 0
                           1=>'{myRT("ca:","h.caro.Clima",'#  line 1
                          ,2=>'{myRT("lg:","h.lnge.Clima",'
                          ,3=>'{myRT("fh:","h.fsth.Clima",'
                          ,4=>'{myRT("du:","h.dact.Clima",'
                          ,5=>'{myRT("bs:","h.bad.Clima",' 
                          ,6=>'{myTx(""   ,""           ,"",'  
                         }
                    }
               ,3 =>{#============Btn Type 3: Btn2 Long
                     0 =>{#-------itteration 0
                           1=>'{myLi("Fl:","LichtF"         ,' 
                          ,2=>'{myLi("Fh:","LichtFH"        ,' 
                          ,3=>'{myLi("L1:","LichtL"         ,' 
                          ,4=>'{myLi("Sl:","sw_Sw"          ,' 
                          ,5=>'{myLi("L2:","LichtL_Sw1_V_01",' 
                          ,6=>'{myLi("L3:","LichtL_Sw1_V_02",' 
                         }                                                        
                    ,1 =>{#-------itteration 1
                           1=>'{myTx("off"   ,"","off"   ,'
                          ,2=>'{myTx("on"    ,"","on"    ,'
                          ,3=>'{myTx("open"  ,"","open"  ,'
                          ,4=>'{myTx("closed","","closed",'
                          ,5=>'{myTx("error" ,"","error" ,'
                          ,6=>'{myTx("ok"    ,"","ok"    ,'
                         }                                                        
                    ,2 =>{#-------itteration 2
                           1=>'{myTx("info"      ,"white" ,"info"      ,'
                          ,2=>'{myTx("newMsg"    ,"red"   ,"newMsg"    ,'
                          ,3=>'{myTx("serviceMsg","orange","serviceMsg",'
                          ,4=>'{myTx("sigGreen"  ,"yellow","sigGreen"  ,'
                          ,5=>'{myTx("sigYellow" ,"green" ,"sigYellow" ,'
                          ,6=>'{myTx("sigRed"    ,"blue"  ,"sigRed"    ,'
                         }                                                        
                    }
    );
 
 
 sub myUtils_Initialize($$) {
   my ($hash) = @_;
 
 # Normal devices
   $hash->{DefFn}   = "myUtil_Define";
   $hash->{UndefFn} = "myUtil_Undef";
   $hash->{AttrList}= $readingFnAttributes;
   
   @cntMax = (scalar keys %{$lineArr{0}}
             ,scalar keys %{$lineArr{1}}
             ,scalar keys %{$lineArr{2}}
             ,scalar keys %{$lineArr{3}});
   push @cnt,"0" foreach (keys %lineArr);
 }
 sub myUtil_Define($$) {########################################################
   my ($hash, $def) = @_;
   return ;
 }
 sub myUtil_Undef($$) {#########################################################
   my ($hash, $arg) = @_;
   return undef;
 }
 
 sub myLineA($$){# main entry - do not change!!!
   my ($line,$type) = @_;
   $cnt[$type] = ($cnt[$type] +1)%$cntMax[$type] if ($line == 1); # rotate counter per type
 
   return (eval $lineArr{$type}{$cnt[$type]}{$line}.'"t")}'
          ,eval $lineArr{$type}{$cnt[$type]}{$line}.'"c")}'
          ,eval $lineArr{$type}{$cnt[$type]}{$line}.'"i")}'
          );
 }
 sub myRT($$$){ # function to return information of an RT. 
   # line 't' calculates the text
   # line 'c' calculates the color
   # line 'i' calculates the icon
   my ($p,$e,$t) = @_;
   if($t eq "t"){return $p.ReadingsVal($e,"desired-temp","no")."-".ReadingsVal($e,"measured-temp","no");  }
   if($t eq "c"){return    ReadingsVal($e,"measured-temp",0)>20 ? "red" : "blue" }
   if($t eq "i"){return    ReadingsVal($e,"ValvePosition",0)    ? "on"  : "off"  }
   return "nix";
 }
 sub myTh($$$){#temp sensor 
   my ($p,$e,$t) = @_;
   if($t eq "t"){return $p.ReadingsVal($e,"temperature","no")."-".ReadingsVal($e,"humidity","");  }
   if($t eq "c"){return    ReadingsVal($e,"temperature",0)>20 ? "red" : "blue" }
   if($t eq "i"){return    ReadingsVal($e,"battery",0)    ? "ok"  : "no"  }
   return "nix";
 }
 sub myPr($$$){#Sensor Pressure
   my ($p,$e,$t) = @_;
   if($t eq "t"){return $p.ReadingsVal($e,"pressure","no")."-".ReadingsVal($e,"luminosity","-");  }
   if($t eq "c"){return    ReadingsVal($e,"luminosity",0)>1000 ? "green" : "red" }
   if($t eq "i"){return    ReadingsVal($e,"battery",0)         ? "ok"    : "error"  }
   return "nix";
 }
 sub myLi($$$){#Light
   my ($p,$e,$t) = @_;
   if($t eq "t"){return $p.ReadingsVal($e,"state","xx");  }
   if($t eq "c"){return    ReadingsVal($e,"timedOn",0) eq "off" ? "green" : "red" }
   if($t eq "i"){return    ReadingsVal($e,"phyLevel",ReadingsVal($e,"level","1")) ? "on"  : "off"  }
   return "nix";
 }
 sub myTx($$$$){#text only
   my ($p,$c,$icon,$t) = @_;
   if($t eq "t"){return $p;  }
   if($t eq "c"){return ($c?$c:"white");}
   if($t eq "i"){return ($icon?$icon:"noIcon");}
   return $p;
 }
 sub myHm($$$$){#HMInfo readings
   my ($p,$e,$c,$t) = @_;
   if($t eq "t"){return $p.join(",", grep !/:0/
                                   , map{s/^(.).*?:/$1:/;;$_;;} 
                                     split ","
                                   , ReadingsVal("hm",$e,"-"))
                }
   if($t eq "c"){return ($c?$c:"white");}
   if($t eq "i"){return "noIcon";}
   return $p;
 }
 
 1;

Die Definition, was angezeigt werden soll wird nun in der Struktur %lineArr festgelegt. Die Typen der Ausgaben - z.B. Darstellung eines Werts eines RT - wird in der jeweiligen Funktion "myTh" festgelegt. Hier kann man so viele - nach den gleichen Regeln wie die Erste - definieren und in der Struktur nutzen. In der Struktur werden die Namen der auszuwertenden Entities eingetragen. Mit den Einträgen zur Itteration kann man erreichen dass beim Tastendruck der Text alterniert. Beim ersten Druck eine Seite, beim 2. eine weitere, nach der Letzten wieder die Erste.

Links