Quelltext der Seite HM-RC-4-2 Funkfernbedienung 4 Tasten

HomeMatic Fernbedienung mit 4 Tasten in Form eines Schlüsselanhängers
==Features==
HomeMatic Fernbedienung mit 4 Tasten in Form eines Schlüsselanhängers, mit Status-LED, die in den Farben Grün, Rot und Orange leuchten bzw. blinken kann.
Robuster Aufbau, Batterie ist eine normale Microzelle (AAA), Nachkauf daher günstiger als bei Sendern mit Knopfzellen, allerdings bedingt die Microzelle auch ein grösseres Gehäuse.

==Hinweise zum Betrieb mit FHEM==

=== Anbindung der Fernbedienung an FHEM ===
Wie alle HomeMatic-Komponenten wird die Fernbedienung durch das Modul CUL_HM angebunden. Die Funkverbindung ist mittels eines [[HomeMatic]] IO oder eines CUL/CUNx/COC etc. im HM-Mode möglich.
Obwohl kein SEC im Name auftaucht, ist bei dieser Fernbedienung im Auslieferungszustand AES aktiv. Das Anlernen an HM IO's funktioniert ohne Probleme, für alle CUL Derivate muss unbedingt der Hinweis im Artikel [[AES Encryption]] im Abschnitt I/O-Device <-> Gerät beachtet werden. '''Die dort beschrieben Installation muss durchgeführt werden!'''

=== Anlernen der Fernbedienung an fhem ===
wie unter [[HomeMatic_Devices_pairen]] beschrieben.

Nach erfolgreichem Pairen sollte in etwa folgendes in der cfg stehen:

 define CUL_HM_HM_RC_4_2_227C77 CUL_HM 227C77
 attr CUL_HM_HM_RC_4_2_227C23 .devInfo 040000
 attr CUL_HM_HM_RC_4_2_227C77 .stc 40
 attr CUL_HM_HM_RC_4_2_227C77 firmware 1.1
 attr CUL_HM_HM_RC_4_2_227C77 model HM-RC-4-2
 attr CUL_HM_HM_RC_4_2_227C77 room CUL_HM
 attr CUL_HM_HM_RC_4_2_227C77 serialNr KEQ0456756
 attr CUL_HM_HM_RC_4_2_227C77 subType remote
 define CUL_HM_HM_RC_4_2_227C77_Btn_01 CUL_HM 227C7701
 attr CUL_HM_HM_RC_4_2_227C77_Btn_01 model HM-RC-4-2
 attr CUL_HM_HM_RC_4_2_227C77_Btn_01 peerIDs 
 attr CUL_HM_HM_RC_4_2_227C77_Btn_01 room CUL_HM
 define CUL_HM_HM_RC_4_2_227C77_Btn_02 CUL_HM 227C7702
 attr CUL_HM_HM_RC_4_2_227C77_Btn_02 model HM-RC-4-2
 attr CUL_HM_HM_RC_4_2_227C77_Btn_02 room CUL_HM
 define CUL_HM_HM_RC_4_2_227C77_Btn_03 CUL_HM 227C7703
 attr CUL_HM_HM_RC_4_2_227C77_Btn_03 model HM-RC-4-2
 attr CUL_HM_HM_RC_4_2_227C77_Btn_03 room CUL_HM
 define CUL_HM_HM_RC_4_2_227C77_Btn_04 CUL_HM 227C7704
 attr CUL_HM_HM_RC_4_2_227C77_Btn_04 model HM-RC-4-2
 attr CUL_HM_HM_RC_4_2_227C77_Btn_04 room CUL_HM

=== Auswertung ===
Das Betätigen des Senders löst in der Regel zwei Events aus, da auch der Batteriestatus bei jeder Tastenbetätigung mit übermittelt wird.

Eine unspezifische Abfrage der Art:

 define act_on_Taste4 notify CUL_HM_HM_RC_4_2_227C77_Btn_04 set Aktor1 on

wird also den Befehl "set Aktor1 on" 2x senden. Es ist daher in der Regel sinnvoll, das Button-Event explizit abzufragen, z.b. so:

 define act_on_Taste4 notify CUL_HM_HM_RC_4_2_227C77_Btn_04:Short.* set Aktor1 on

(Fängt kurze Tastendrücke ab, die Events der Form Short_100 generieren. 100 hiesse, dass die Taste 100 ms gedrückt wurde.)


=== LED / Rückantwort ===
Ohne weitere Maßnahmen wird der Empfang eines Befehls nicht an die Fernbedienung zurück gemeldet, d.h. die LED der Fernbedienung leuchtet nach Tastendruck Orange auf um zu zeigen, dass der Befehl abgesetzt wurde. Die Rückmeldung, ob der Befehl empfangen wurde, wird aber von einem gepeerten Aktor veranlasst. Der Einstaz der Fernbedienung ist im Zusammenhang mit FHEM auch ohne peering Möglich. '''Pairing mit FHEM allein''' reicht nicht aus. Will man die Fernbedienung mit keinem Aktor direkt peeren (im Zusammenhang mit FHEM vermutlich der Regelfall), wird daher keine Enttät den Empfang des Tastendrucks bestätigen. Um dieses Problem zu umgehen bieten sich diverse Varianten an. Im folgenden seien zwei beschrieben:

==== Einrichten einer virtuellen HM Instanz ====
Es lässt sich eine virtuelle HM Instanz einrichten, deren einziger Zweck es ist peerbare Channel zu erzeugen. Zum einen können diese Channels dazu genutzt werden virtuelle Buttons zu erzeugen, die man auf der WebGUI platzieren kann, und die bei Betätigung direkt gepeerte HM-Aktoren bedienen, vor allem aber kann man Fernbedienung (oder sonstige Sensoren) mit den virtuellen Channels peeren, um eine Rpckantwort (ACK) zu erhalten. Die Funktion der Virtuellen Instanz ist dann nur zu bestätigen, das sie den Tastendruck empfangen hat.

Hierzu zunächst eine Virtuelle HM Instanz anlegen, diese benötigt eine eigne HMID:

 define <Virtual_Irgendeinname> CUL_HM 654321

Anschliessend die Anzahl der Cannels festelegen (es sind maximal 50 möglich, weniger ist besser):
 set <Virtual_Irgendeinname> virtual 5

Abschliessend einen Button der Fernbedienung mit einem Channel peeren. Zuerst die kleine Taste auf der Rückseite der HM-RC-4-2 Funkfernbedienung drücken, wenn die LED Grün leuchtet den Befehl

set <HM-RC-4-2>_Btn_01 peerChan 0 <Virtual_Irgendeinname>_Btn1 single
absetzen, dann die zu peerende taste (hier Button 1) drücken.

Wenn das Peering erfolgreich ar, sollte die LED an der HM-RC-4-2 mehrmals schnell blinken.

Anschliessend wird jeder Tastendruck bei Empfang mit grün bestätigt (ACK) oder bei Fehlerhaftem Empfang mit roter LED quittiert (NACK). 

Dies sagt nichts über die tatsächliche Aktion aus, die FHEM ausführt, dies hängt davon ab, welche Abfragen und Aktionen definiert sind. Es wird durch den virtuellen cannel rein der Empfang der Nachricht quittiert. Es ist daher bei grenzwertiger Funklage auch denkbar, das die grüne LED nicht leuchtet oder gar ein NACK gemeldet wird, FHEM die konfigurierte Aktion aber trotzdem ausführt.

==== Nutzung einer VCCU ====

Alternativ zum obigen Vorgehen können auch die virtuell Channels eine VCCU genutzt werden. Dazu zuerst die Anzahl der virtuellen Channels setzen:

 set <VCCU> virtual 5

(es sind maximal 50 möglich, weniger ist besser)

Abschliessend einen Button der Fernbedienung mit einem Channel peeren. Zuerst die kleine Taste auf der Rückseite der HM-RC-4-2 Funkfernbedienung drücken, wenn die LED Grün leuchtet den Befehl

 set <HM-RC-4-2>_Btn_01 peerChan 0 <VCCU>_Btn1 single

absetzen, dann die zu peerende Taste (hier Button 1) drücken.

Wenn das Peering erfolgreich war, sollte die LED an der HM-RC-4-2 mehrmals schnell blinken.

Anschliessend wird jeder Tastendruck bei Empfang mit grün bestätigt (ACK) oder bei Fehlerhaftem Empfang mit roter LED quittiert (NACK). 

Dies sagt nichts über die tatsächliche Aktion aus, die FHEM ausführt, dies hängt davon ab, welche Abfragen und Aktionen definiert sind. Es wird durch den virtuellen cannel rein der Empfang der Nachricht quittiert. Es ist daher bei grenzwertiger Funklage auch denkbar, das die grüne LED nicht leuchtet oder gar ein NACK gemeldet wird, FHEM die konfigurierte Aktion aber trotzdem ausführt.

== Hinweis zum Anlegen der Channels bei der baugleichen ROTO_ZEL-STG-RM-HS-4 ==
Bei der baugleichen ROTO_ZEL-STG-RM-HS-4 wird mit Stand Januar 2016 von autocreate zwar das device selbst automatisch angelegt, jedoch nicht die 4 Kanäle für die 4 Tasten.
Die Kanäle müssen manuell angelegt werden. Startpunkt ist die HMID des device, z.B.
 1907C9
Die Kanäle werden dann angelegt mit der HMID, an die die Kanalnummer 01...04 angehängt werden, also
 1907C901
 1907C902
 1907C903
 1907C904

Verwendet wird der reguläre define-Befehl, also
 define <Kanalname> CUL_HM 1907C901
usw.
Die Channels werden danach regulär unter dem device angezeigt und können bei Bedarf regulär [[Peering (HomeMatic)|gepeert]] werden.


[[Kategorie:HomeMatic Components]]
[[Kategorie:Schalter (Sender)]]