Kopp Allgemein

Allgemeine Informationen zur Steuerung von Kopp Aktuatoren via FHEM

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

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)

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 (FHEM Oberfläche -> Commandref -> CUL) nachlesen

Unbedingt beachten: Einem CUL oder CCD Device kann 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)

Folgende Beispiele in die fhem.cfg kopieren, das Ergebnis kann man sich im Raum "Test" anschauen

Dimmer, über einen Taster gesteuert

Für dieses Devide ist ein Tastencode festzulegen.

define Dimmer KOPP_FC 65 FA5E 02
attr Dimmer IODev CCD
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, über drei Taster gesteuert (on, off, dimmen/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 CCD
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, ü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 CCD
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, ü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 CCD
attr 2Switch group Switch
attr 2Switch model Switch_8080_01_2Key
attr 2Switch room Test
attr 2Switch webCmd on:off

Schalter/Switch, über einen Taster gesteuert (on, off)

Jeder Tastendruck toggelt den Zustand.
define Switch KOPP_FC 00 C2AD 03
attr Switch IODev CCD
attr Switch group Switch
attr Switch model Switch_8080_01
attr Switch room Test