Kopp Allgemein
Allgemeine Informationen zur Steuerung von Kopp Aktuatoren via FHEM. Das vom Hersteller Kopp unter dem Namen Free-control angebotene Funk-System unterstützt verschiedene Aktoren und Schalter zur Steuerung in Haus und Wohnung.
Allgemeine Hinweise
Derzeit unterstützte Funkmodule
CCD CUL Version 3 nanoCUL
Unterstützte Aktuatoren
Folgende Kopp Aktuatoren werden zur Zeit unterstützt:
8011.00 = Dimmer 8080.01 = Schalter 8080.02 = Rolladenschalter 8080.04 = Timer/Schalter (bisher nur im RAW Mode)
Hinweis:
Manche Aktoren konnen in verschiedenen Modi betrieben werden
a) Einzel Taste (jeder Tastendruck toggelt den Zustand)
b) Zwei Tasten Mode (Bsp.: Taste 1 schaltet ein, Taste 2 schaltet aus).
Im Zwei Tastenmode müssen beide Tasten in einem Anlernzyklus angelernt werden (Anlernvorgang: siehe Kopp Handbuch)
Bitte beachten:
Unterstützt werden nur Module der Version 2.
Die älteren Version 1 Module werden derzeit nicht unterstützt.
Eine Unterscheidung ist anhand des aufgedruckten Symboles möglich.
Kopp Sender auswerten
Um erste FHEM Erfahrungen mit Kopp Sender und Aktuatoren zu machen ist es sinnvoll innerhalb von FHEM ein Device anzulegen, das die selben Kommando versendet wie ein vorhandener Kopp Sender. Nachdem z.B. einem CUL USB Stick das Kopp Protokoll zugeswiesen wurde können in der FHEM Oberfläche über den Link "CUL_0" (mein Beispiel) vom Kopp Sender übermittelte Telegramme ausgewertet werden. Drückt man danach eine Taste des Senders und aktualisiert das Browser Fensert, ist dort ein Eintrag ähnlich:
RAWMSG kr07C2AD1A30CC0F0328
zu sehen. Dabei handelt es sich um die vom Sender gesendeten Roh-Daten, die wir teilweise innerhalb von FHEM wiederverwenden.
Aufbau der Rohdaten:
kr07C2AD1A30CC0F0328 || |||| || ++-------- Transmitter Code 2 || |||| ++-------------- Keycode || ++++------------------ Transmitter Code 1 ++------------------------ kr wird von der culfw bei Empfang einer Kopp Botschaft als Kennung gesendet
Keycode und Tranmitter Code 1/2 werden zur Definition eines Kopp Devices in FHEM benötig.
Erste Schritte
Kopp Protokoll aktivieren / einem Funk Device zuordnen
Damit FHEM in der Lage ist mit Kopp Devices zu kommunizieren, muss als erster Schritt das Kopp Protokoll aktiviert werden. Dies erfolgt indem die Funk Hardware definiert wird (z.B. CUL Version3, CCD) das Attribut "rfmode KOPP_FC" zugewiesen wird.
Bsp.:
define CUL_0 CUL /dev/ttyACM0@38400 1234
attr CUL_0 rfmode KOPP_FC
Details zur Definition einen CUL Devices kann man in der commandref/CUL (FHEM Oberfläche -> Commandref -> CUL) nachlesen
Unbedingt beachten:
Einem CUL oder CCD Device darf nebem dem Kopp Protokoll kein weiteres Protokoll zugewiesen werden
Beispiele zur Festlegung von Schaltern, Dimmer und anderen Aktuatoren
Syntax:
define DimmerDevice_OnOff KOPP_FC 65 FA5E 02 55 75 |||||||||||||||||| ||||||| || |||| || || ++- Keycode 3 (Taster 3, optional) |||||||||||||||||| ||||||| || |||| || ++---- Keycode 2 (Taster 2, optional) |||||||||||||||||| ||||||| || |||| ++------- Transmittercode 2 (fix) |||||||||||||||||| ||||||| || ++++---------- Transmittercode 1 (fix) |||||||||||||||||| ||||||| ++--------------- Keycode 1 (Taster 1) |||||||||||||||||| +++++++------------------ Zu nutzendes Funkprotokoll=KOPP_FC ++++++++++++++++++-------------------------- Name des neu definierten Devices (frei wählbar)
Die Tastencodes und Transmittercodes müssen jeweils den Codes eines Kopp Senders entsprechen oder dem entsprechenden Aktuator angelernt werden.
(siehe Kopp Handbuch)
Darstellung in der FHEM Oberflache
Folgende Beispiele in die fhem.cfg kopieren, das Ergebnis ist im Raum "Test" zu finden (siehe Bild)
Dimmer (8011.00), über einen Taster gesteuert (on/off, dimm, stop)
Für dieses Devide ist ein Tastencode festzulegen.
define Dimmer KOPP_FC 65 FA5E 02
attr Dimmer IODev CUL_0
attr Dimmer devStateIcon OnOff:toggle:dimm dimm:dim50%:stop stop:on:dimm off:toggle:dimm
attr Dimmer eventMap on:OnOff dimm:dimm stop:stop
attr Dimmer group Dimmer_1KeyMode
attr Dimmer model Dimm_8011_00
attr Dimmer room Test
attr Dimmer webCmd OnOff:dimm:stop
Dimmer (8011.00), über drei Taster gesteuert (on, off, dimm, stop)
Achtung: hier müssen zwingend 3 Tastencodes definiert werden.
Die Software macht hier noch keine Fehlerprüfung, fehlenden Tastencodes könnte unerwartetes Verhalten der Devices zur Folge haben.
define DimmerDevice_OnOff KOPP_FC 65 FA5E 02 55 75
attr DimmerDevice_OnOff IODev CUL_0
attr DimmerDevice_OnOff devStateIcon dimm:dim50%:stop stop:on:off on:on:off off:off:on
attr DimmerDevice_OnOff group Dimmer_Via_KOPP_FC_3TastenMode
attr DimmerDevice_OnOff model Dimm_8011_00_3Key
attr DimmerDevice_OnOff room Test
define DimmerDevice_Dimm dummy
attr DimmerDevice_Dimm devStateIcon dimm:dim50%:stop stop:off:dimm
attr DimmerDevice_Dimm group Dimmer_Via_KOPP_FC_3TastenMode
attr DimmerDevice_Dimm room Test
attr DimmerDevice_Dimm webCmd dimm:stop
define DimmerDevice_DimmInAction notify DimmerDevice_Dimm set DimmerDevice_OnOff $EVENT
Rolladen (8080.02), über zwei Taster gesteuert (top, up, stop, down, bottom)
Achtung: hier müssen zwingend 2 Tastencodes definiert werden.
define TasteUp KOPP_FC 10 C2AD 03 00
attr TasteUp IODev CUL_0
attr TasteUp devStateIcon up:fts_shutter_up down:fts_shutter_down stop:fts_shutter_updown top:fts_shutter_10 bottom:fts_shutter_90
attr TasteUp eventMap up:up down:down stop:stop top:top bottom:bottom
attr TasteUp group Rolladen
attr TasteUp model Blind_8080_02
attr TasteUp room Test
attr TasteUp webCmd top:up:stop:down:bottom
Schalter/Switch (8080.01), über zwei Taster gesteuert (on, off)
Achtung: hier müssen zwingend 2 Tastencodes definiert werden.
define 2Switch KOPP_FC 30 C2AD 03 20
attr 2Switch IODev CUL_0
attr 2Switch group Switch
attr 2Switch model Switch_8080_01_2Key
attr 2Switch room Test
attr 2Switch webCmd on:off
Schalter/Switch (8080.01), über einen Taster gesteuert (on, off)
Jeder Tastendruck toggelt den Zustand.
define Switch KOPP_FC 00 C2AD 03
attr Switch IODev CUL_0
attr Switch group Switch
attr Switch model Switch_8080_01
attr Switch room Test