Homematic-Register von A-Z (Namen, Erklärung)

Aus FHEMWiki
Version vom 29. November 2017, 20:39 Uhr von Pfriemler (Diskussion | Beiträge) (Erste Vorbaustelle, siehe Diskussion!)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)


Clock - Under Construction.svg An dieser Seite wird momentan noch gearbeitet.


Dieser Artikel soll die Namensgebung der Homematic-Register erklären und einen Index aller bekannten Register mit einer kurzen Funktionserklärung liefern. Der Index folgt dabei den Registerklassen, da sich die Namensgebung diesbezüglich ebenfalls unterscheidet.

Zur grundsätzlichen Anwendung von Registerprogrammierung mit einigen Beispielen siehe u.a. den Artikel HomeMatic Register programmieren und HomeMatic HmInfo Templates erstellen.

Einführung

Die Namenskonvention der Homematic-Register ist für den Neuling verwirrend, folgt jedoch fast durchgängig einer einfachen Logik

  • er setzt sich aus einem oder mehreren Bestandteilen zusammen
  • er beginnt immer mit einem Kleinbuchstaben
  • jeder weitere Namensbestandteil beginnt mit einem Großbuchstaben
  • die Bezeichnungen der Bestandteile sind englisch, kurze Begriffe werden ausgeschrieben, längere abgekürzt

Die möglichen Bestandteile werden in den jeweiligen Registergruppen (Listen) erläutert.

Details zu den Wertebereichen sowie eine kurze englische Beschreibung liefert der Befehl reglist in Geräten und Kanälen.

Die Registerklassen (Listen) eines Homematic-Gerätes

Jedes Homematic-Gerät besitzt prinzipiell geräte-, kanal- und verknüpfungsbezogene Register. Bei Geräten, die nur einen sogenannten Kanal besitzen, erscheinen alle drei Register gemeinsam in der Definitionsansicht und den Listings in FHEM, bei Geräten mit mehreren Kanälen findet man die verknüfungs- und kanalbezogenen Register in den jeweiligen Kanälen.

Gerätebezogene Register

Gerätebezogene Register existieren für jedes HomeMatic-Gerät nur einmal und werden in der sogenannten List0 gespeichert (in der FHEM-Oberfläche als Hexbytefolge unter RegL_00. zu finden).

brightness

brightness = Helligkeit. Wertebereich: 0-15. Steuert die Helligkeit der LED-Anzeige. Verwendet in: HM-OU-LED16.

energyOpt

energy option = Energieoptionen. Wertebereich: 0 to 127 (Sekunden), zusätzlich "permanent" (dauerhaft). Einschaltdauer des Displays HM-OU-LED16.



  0: intKeyVisib      |     literal        |          | visibility of internal channel options:visib,invisib 
  0: localResDis      |     literal        |          | local reset disable options:on,off 
  0: pairCentral      |   0 to 16777215    |          | pairing to central 


TEXTBAUSTEINABLAGE (wird entfernt):


Es gibt peerabhängige und gerätespezifische Register. Schreibweise der Register: immer klein beginnend, jeder neue Bestandteil beginnt mit einem Großbuchstaben A: (optional) langer und kurzer Tastendruck: [lg|sh] B: Aktionswunsch (action), Bedingung (condition, ct), Sprungquelle (DimJt bzw. SwJt bei Dimmer/Schaltern) oder Zustand (Off, OnDly, RampOn, On, OffDly, RampOff) C:

Alle peerabhängigen Register liegen jeweils für Long (lg) und Short (sh) vor. Bewegungsmelder, Schalterinterface senden nur shorts (ggf. mit Wert, etwa Helligkeit oder Schaltzustand (0=closed, 100=tilted, 200=open), alle Tastensensoren senden sowohl long als auch short. Bei normalerweise nicht zugänglichen Tastern in Geräten werden intern nur Shorts ausgewertet (Schalter, LED-Dimmer, Batterieaktoren etc) Mögliche Aktionstypen bei Tastendruck: - off: Es erfolgt keine Aktion - downDim: Herunterdimmen bei langem Tastendruck (peer dual) - upDim: Hochdimmen bei langem Tastendruck (peer dual - toogleDim: Herunter.oder Hochdimmen bei langem Tastendruck, wechselt (Eintastenb, peer single) - jmpToTarget: Springe zum definierten Sprungziel - toggleDimToCntInv? - toggleDimToCnt? - toggleToCntInv? - toggleToCnt?