06 Homematic Geräte Variablen einbinden
HM Geräte/Variablen in die eigenen Seiten (categories) einbinden.
Geräte werden hier den in der categories.json definierten (Unter-)Kategorien zugeordnet. Ein Block für eine (Unter-)Kategorie beginnt mit deren Namen und wird in eckige Klammern ([ ... ],) gesetzt.
Das Anlegen und die Zuordnung erfolgt in der /homehub/config/custom.json
Hinweis 1: Geräte/Variablen/etc. der CCU werden über ihren Namen und nicht über ihre ID eingebunden. Falls man also Namen in der CCU ändern sollte, kann das auch die Notwendigkeit einer entsprechenden Anpassung in Homehub nach sich ziehen. Doppelte Namensvergabe sollte auch hier nicht erfolgen.
Hinweis 2: zum editieren von HH-Dateien sollte der Editor im UTF-8 Format arbeiten. Sonst gibt es Probleme (leere Seiten, etc.) z.B. beim Verwenden von Sonderzeichen. Siehe auch Kapitel 10 T&T
Hier als Beispiel für die in der categories.json definierten Kategorie "WZ Heizung/Klima"
"WZ Heizung/Klima":[
{
"name":"WZ-Heizgruppe:1",
"icon":"sani_heating.png",
"display_name":"Heizung"
},
{
"name":"CUxD-WZ-Regler:1",
"icon":"temp_dew_point.png",
"display_name":"TRh-Sensor"
},
{
"name":"CO2",
"icon":"temp_dew_point.png",
"display_name":"CO2"
}
],
"WZ Fenster":[
{
"name":"WZ-Jalousie Bedienung",
"icon":"fts_shutter_attention.png",
"display_name":"Jalousie"
},
{
"name":"Lueften Test",
"icon":"fts_window_2w_gn.png",
"display_name":"Lueften ?"
},
{
"name":"Status Fenster",
"icon":"fts_window_2w_gn.png",
"display_name":"Fenster Status ?"
},
{
"name":"WZ-Fenster-links:1",
"icon":"fts_window_2w_open_l.png",
"display_name":"Fenster links"
},
{
"name":"WZ-Fenster-mitte:1",
"icon":"fts_window_2w_open_l.png",
"display_name":"Fenster mitte"
},
{
"name":"WZ-Fenster-rechts:1",
"icon":"fts_window_2w_open_l.png",
"display_name":"Fenster rechts"
}
],
Parameter für config.json
-
Parameter Inhalt/Zustände Anwendung & Hinweise "name" "Name in CCU" EXAKTER Name des Gerätekanals, Variable "icon" "name der png-Datei Siehe Abschnitt 1.2 "display_name" "beliebig" Angezeigter Name "append_divider" "true | false" Schmaler Spacer unter diesem Eintrag "operate" "true | false" Steuern der Bedienbarkeit von CCU Variablen, default=true "indicator" siehe 3.4.2.1 Siehe 3.4.2.1 "color" "HEX-Wert" Farbe des Farbindikatorks links in der Zeile. Experte: in der PHP Datei von dem Gerätetyp den "color" Wert ändern, wirkt global! "Label" "beliebig" Nur für CCU-Programme, ändert Bezeichnung des Buttoms "showtime" "true | false" Nur bestimmte Geräte, siehe 3.4.2.2
Beispiel 1
{
"name":"Anwesenheit",
"icon":"secur_burglary.png",
"display_name":"Anwesenheit",
"indicator": "0,false;1,true;2,warn;3,warn",
"color": "#FF0000",
"showtime":"true"
}
Beispiel 2
{
"name":"Status Fenster",
"icon":"fts_window_2w_gn.png",
"display_name":"Fenster Status ?",
"showtime":"true",
"color":"#EECBAD"
},
Beispiel 3
{
"name":"Waesche Timer",
"icon":"scene_laundry_room_fem.png",
"display_name":"Wäsche Timer",
"indicator": "0,false;4,alarm;10,warn;60,true",
"showtime":"true",
"color":"#30D5C8",
"append_divider":"true"
}
Mit "indicator" kann die Farbe des Status-Indikators beeinflusst werden. Die Farbzuordnung ist: false: Aus (grau) true: Ein (grün) warn: Warnung (gelb) alarm: Alarm (rot)
Verwendung
-
für CCU-Variable des Typs Logik oder Werteliste Beispiel: „indicator“: "1,true;0,warn;3,alarm" – CCU-Werteliste mit maximal 5 Werten. Wert 2 und 5 werden hier automatisch auf false (=grau) gesetzt. Hinweis: der Wert des ersten Textes in einer CCU-Variablen des Typs Logik oder Werteliste ist immer Null (0)
-
Für CCU-Variable des Typs Zahl Beispiel: "indicator": "40,true;60,warn;100,alarm" – Vergleichsoperanden werden nicht gebraucht. Hier wird bei <=40 grün, bei <=60 gelb und <=100 rot angezeigt.
Mit "showtime" kann man für ausgewählte Geräte sowie Systemvariablen und CCU Programme den verkürzten Timestamp der letzten Änderung anzeigen lassen. Z.Z. unterstützt werden:
Einbindung in custom.json
{
"name":"Anwesenheit",
"icon":"secur_burglary.png",
"display_name":"Anwesenheit",
"indicator": "0,false;1,true;2,warn;3,alarm",
"color": "#00CC33",
"showtime":"true"
}
Mit Version 4.1.2 kann man jetzt über den Parameter "label" für bestimmte Taster definiert werden, ob nur der Buttom für den kurzen, den langen, oder beide angezeigt wird/werden. Die Bezeichnung der Buttons können jetzt auch individuell festgelegt werden.
Möglich ist dies für
- CUX2801 (Taster)
- HM-RCV-50
- HMW-RCV-50
- HmIP-RCV-50
Beispiele für einen CUxD-System-Exec-Taster
{
"name":"CUxD.Exec.Taster:15",
"icon":"ccu.png",
"display_name":"CUxD Exec Taster 15 - alt",
"showtime":"true"
},
{
"name":"CUxD.Exec.Taster:15",
"icon":"ccu.png",
"display_name":"CUxD Taster nur kurz",
"label":"SF-k,",
"showtime":"true"
},
{
"name":"CUxD.Exec.Taster:15",
"icon":"ccu.png",
"display_name":"CUxD Taster nur lang",
"label":",SF-l",
"showtime":"true"
},
{
"name":"CUxD.Exec.Taster:15",
"icon":"ccu.png",
"display_name":"CUxD Taster beides",
"label":"SF-k,SF-l",
"showtime":"true"
},
Anders als bei anderen Komponenten, ist es egal, welches Kanal bei "name" angegeben wird. Es werden in der Visualisierung grundsätzlich alle 12 Kanäle der FALMOT angezeigt. Möchte man nur bestimmte Kanäle anzeigen, so kann dies über den zusätzliche Parameter "channels" erfolgen.
{
"name": "FALMOT:1",
"icon": "falmot.png",
"display_name": "Heizkreise Wohnen",
"channels": "1,2,3,4,5"
}
Ref.: https://homematic-forum.de/forum/viewtopic.php?f=41&t=76034
Farbindikatoren für HM-OU-LED16 Als Erweiterung lässt sich das komplette Display wie in real abbilden (siehe Beschreibung in components\hm-ou-led16.php)
Einbinden in der custom.json
{
"name":"ZZ LED 01 RoDG",
"icon":"secur_burglary.png",
"display_name":"TESDT",
"label":"ZZ LED 01 RoDG,ZZ LED 02 RoEG,ZZ LED 03 FeDG,ZZ LED 04 FeWC,ZZ LED 05 FeKü,ZZ LED 06 FeWZ,ZZ LED 07 FeGa,ZZ LED 08 TüGa,ZZ LED 09 AlSt,ZZ LED 10 Alrm,ZZ LED 11 KGLi,ZZ LED 12 AULi,ZZ LED 13 AUSt,ZZ LED 14 GaAl,ZZ LED 15 GaBw,ZZ LED 16 GaTo"
}
Siehe auch https://homematic-forum.de/forum/viewtopic.php?f=41&t=79208&start=310#p798181