FHEMWiki - Benutzerbeiträge [de]

Velux KLF200

2020-11-09T08:47:12Z

Buennerbernd: /* Unterstützte Geräte */

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Anbindung io-homecontrol Aktoren an FHEM
|ModType=x
|ModCmdRef=KLF200
|ModFTopic=92907
|ModTechName=83_KLF200.pm
|ModOwner=buennerbernd ({{Link2FU|21440|Forum}} / [[Benutzer Diskussion:Buennerbernd|Wiki]])
}}

'''KLF200''' ist ein Modul zur Steuerung von '''io-homecontrol''' Aktoren über das Gateway Velux KLF 200.

== Velux KLF 200 ==

Die KLF-200-Box ist über LAN mit FHEM verbunden und steuert die Aktoren über das verschlüsselte Funkprotokoll ''io-homecontrol''.
Die Aktoren geben Rückmeldung über ihren aktuellen Zustand.

Die Box hat 10 elektrische Eingänge mit denen man 5 Geräte oder Gerätegruppen steuern kann.
Damit kann man z.B. mit Doppeltastern an der Wand seine Rollladen oder Fenster steuern.
Über den LAN-Anschluss lassen sich mit FHEM bis zu 200 Geräte mit einer KLF 200 verwalten.

Das Modul erfordert die Firmware-Version 2.0.0.71 und basiert auf der dokumentierten API von Velux. [https://www.velux.com/api/klf200 Download und weitere Informationen]

Das Gateway hat keine Cloud-Integration.

== Unterstützte Geräte ==

Grundsätzlich sollten alle io-homecontrol Aktoren funktionieren. Alleinstehende Sensoren (z.B. Lichtsensor, Windsensor) werden
von der KLF-200-Box nicht unterstützt. Es besteht aber die Möglichkeit, den Status von Sensoren auszuwerten, die in Aktoren integriert sind.

Aktuell werden folgende Geräte erfolgreich mit diesem Modul verwendet:

* Rollladen:
** VELUX SML
** VELUX SSL
** VELUX SMG (Doppelrollladen getrennt steuerbar)
** Somfy Oximo io
** Somfy RS100 io
** Somfy Izymo io
* Sichtschutz innen:
** VELUX FSK
** VELUX DML
** VELUX RSL
* Fensteröffner mit integriertem Regensensor:
** VELUX KMG
** VELUX CVP
** VELUX KSX
** VELUX GPU
* Markisen:
** VELUX MSL
** VELUX MML
** Somfy Sunea io
** Somfy Maestria+ 50 io
* Raffstore
** Somfy (Winkelsteuerung der Lamellen möglich)

== Benutzung in FHEM ==
=== Vorbereitung ===
Bevor die Aktoren in FHEM verwendet werden können, müssen sie in der [[#Registrieren von Geräten an der KLF200-Box|KLF 200 angelernt]] werden.
Das geschieht über das WebUI der KLF 200, das über einen Wifi-Hotspot erreichbar ist. Dieser Vorgang ist im Handbuch beschrieben.
Im WebUI können die angeschlossenen Geräte auch benannt werden. Zusätzlich hat man die Möglichkeit, Programme (Szenen) aufzuzeichnen,
um ein oder mehrere Geräte in eine definierte Position zu bringen. Diese Szenen kann man aus FHEM ebenfalls ansteuern.

Das Modul wird momentan noch nicht über FHEM ausgeliefert.
Es wird wie folgt geladen und aktualisiert:

:<code>update all <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>
:<code>shutdown restart</code>

Mit diesem Befehl wird das Modul so eingerichtet, dass es ebenfalls aktualisiert wird, wenn man FHEM aktualisiert:
:<code>update add <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>

=== Anlegen der Geräte ===
:<code>define <name> KLF200 <host></code>
Beispiel:
:<code>define Velux KLF200 192.168.0.66</code>

Danach Login durch Eingabe des Passwortes:
:<code>set <name> login <password></code>

Hinweis: Das Passwort ist laut Dokumentation das Wifi-Passwort, das auf den Boden der Box gedruckt ist.
Das funktioniert bei einigen Nutzern. Bei vielen Nutzern funktioniert hingegen das Passwort des WebUI.
Scheinbar hängt das davon ab, mit welcher Firmware die Box ausgeliefert wurde und ob schon einmal ein Reset durchgeführt wurde.
Das Passwort wird verschleiert im FHEM-Backend gespeichert. Es muss nach erfolgreichem Login nicht mehr eingegeben werden.

Die angeschlossenen Aktoren werden jetzt durch autocreate als Instanzen von KLF200Node im Raum KLF200Node angelegt.
Die Namen der Geräte folgen dem Muster <name>_<NodeID>.
Wurde im WebUI der KLF200 ein Name für das Gerät vergeben dann wird dieser als Alias übernommen.

Die Geräte sind jetzt einsatzbereit.

== Modul KLF200 ==
=== Verbindungsstatus ===
==== STATE ====
Im STATE des Moduls sieht man den aktuellen Verbindungsstatus. Im Idealfall ist er nach der Initialisierung Logged in.
=== Ausführung von Programmen (Szenen) ===
Obwohl man mit dem Modul KLF200Node jedes Gerät unabhängig und auch gleichzeitig steuern kann, sind Szenen eine nützliche Ergänzung. So kann man mit Szenen wie "Alle zu" oder "Alle auf" viele Geräte gleichzeitig mit einem Befehl bedienen.

Hinweis: Während der Abarbeitung einer Szene werden weitere Befehle gepuffert.
==== scene/sceneID ====
Mit diesen Set-Funktionen kann man eine aufgezeichnete Szene aufrufen.
Im entsprechenden Reading steht die zuletzt aufgerufene Szene.

Die Zuordnung zwischen sceneID und scene sieht man in den Internals unter scenes.

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Bei vielen aktuellen Geräten lässt sich die Ausführungsgeschwindigkeit (Velocity) variieren. So lässt sich die Geschwindigkeit gegenüber der Default-Geschwindigkeit noch erhöhen oder auch deutlich reduzieren. So ist eine besonders leise Bedienung möglich.

==== Argument DEFAULT, FAST, SILENT ====
Die Velocity kann man bei der Ausführung von Szenen als zusätzliches Argument von set scene oder set sceneID setzen.
Unterstützte Werte sind DEFAULT, FAST und SILENT
:<code>set Velux scene "Alle zu" SILENT</code>
==== Attribut velocity ====
Alternativ kann man im Modul KLF200 das Attribut velocity setzen, das bei der Ausführung von Szenen herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

Hinweis: Dieses Attribut hat keine Auswirkungen auf Befehle, die vom Modul KLF200Node abgesetzt werden.

== Modul KLF200Node ==
Dieses Modul wurde dem Homematic-Modul CUL_HM nachempfunden, da es ebenfalls ein breites Spektrum an Geräten unterstützt
und möglichst kompatibel zu vorhandenen Hilfsmodulen sein soll.
=== Aktueller Status ===
Im Folgenden wird der Zusammenhang zwischen den wichtigsten Readings/Set-Funktionen pct, state, execution erklärt.
==== pct ====
Dieses Reading enthält den aktuell bekannten Status des Gerätes in Prozent.

Wird das Gerät über die KLF-200-Box gesteuert, wird das Reading beim Erreichen der Zielposition sofort aktualisiert.

Wird das Gerät über eine Fernbedienung oder einen Sensor gesteuert, kann sich die Aktualisierung wenige Minuten verzögern.

Mit der Set-Funktion kann man das Gerät in diesen Status versetzen.
Per Default entspricht 100 auf der Fernbedienung oben und 0 unten.
==== state ====
Dieses Reading entspricht dem Reading pct, mit der Ausnahme, dass 0 durch '''off''' ersetzt wird und 100 durch '''on'''.

Die Set-Funktion funktioniert analog.
Per Default entspricht on auf der Fernbedienung oben und off unten.

Es werden die '''set extensions''' unterstützt. Damit können mit einem Set ein oder mehrere Befehle zeitgesteuert abgesetzt werden.

Doku: [https://fhem.de/commandref_DE.html#set set extensions in der commandref] und im [[DevelopmentModuleIntro#X_Set]] jeweils etwas weiter unten.

==== execution ====
Dieses Reading gibt den aktuellen Ausführungsstatus wieder. Die meiste Zeit ist der Wert stop.
Wird gerade ein Befehl ausgeführt, ist der Wert up oder down.

Mit der Set-Funktion werden entsprechende Befehle ausgeführt, up entspricht auf der Fernbedienung oben und down unten.
Bei stop wird die aktuelle Ausführung angehalten.

==== Attribut directionOn ====
Wie oben beschrieben, entspricht per Default on = 100 = up.

Das kann bei bestimmten Geräten für manchen Nutzer verwirrend sein.
Wenn man z.B. bei einem Rollladen lieber im geschlossenen Zustand 100 Prozent sehen möchte, dann setzt man das Attribut directionOn, z.B.
:<code>attr Velux_2 directionOn down</code>

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Wie bei Szenen lässt sich auch bei Kommandos auf KLF200Node die Ausführungsgeschwindigkeit beeinflussen, soweit das vom Gerät unterstützt ist.
==== Reading velocity ====
Dieses Reading hat den Wert supported, wenn die Geschwindigkeit bei diesem Gerät geändert werden kann.
Selbst bei Not supported wäre es einen Versuch wert, es zu testen.
==== Argument DEFAULT, FAST, SILENT ====
Alle set-Funktionen, die eine Bewegung auslösen unterstützen das optionale Argument DEFAULT, FAST oder SILENT.
==== Attribut velocity ====
Alternativ kann man im Modul KLF200Node das Attribut velocity setzen, das bei der Ausführung von Kommandos herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

=== Raw-Befehle zum Testen von unbekannten Geräten ===
Die bisher beschriebenen Funktionen des KLF200Node-Moduls bieten einen vereinfachten Zugang zu io-homecontrol-Geräten mit nur einem Motor.

Intern wird bei diesen Funktionen der Main Parameter (MP) für die Steuerung des Motors und der Functional Parameter 1 (FP1) für die Velocity gesetzt.
Theoretisch können Geräte bis zu 16 Functional Parameter (FP1 bis FP16) haben. Der Wertebereich aller Parameter ist 0 - 65535, wobei sich 0 - 100% auf 0 - 51200 abbilden.

'''Für Experten''' bietet die Funktion '''set raw''' die Möglichkeit, mehrere Parameter gleichzeitig zu setzen. Damit lassen sich dann z.B. die Lamellen von Raffstores bewegen.
Zuvor wird empfohlen, in der [https://velcdn.azureedge.net/~/media/com/api/klf200/technical%20specification%20for%20klf%20200%20api-ver3-16.pdf KLF 200 API] die folgenden Kapitel zu lesen:
* 10.1.1 GW_COMMAND_SEND_REQ
* 10.1.1.4 ParameterActive parameter
* 13 Appendix 1: Standard Parameter definition
* 14 Appendix 2: List of actuator types and their use of Main Parameter and Functional Parameters

Beispiel-Aufrufe:

Winkelsteuerung (FP3) eines Somfy Raffstores:
:<code>set Velux_1 raw ParameterActive=3 FP3=0</code>
:<code>set Velux_1 raw ParameterActive=3 FP3=51200</code>
Oberer Rollladen (FP1) eines Velux SMG Doppelrollladen:
:<code>set Velux_2 raw ParameterActive=1 FP1=0 MP=55304 FP2=53504</code>
:<code>set Velux_2 raw ParameterActive=1 FP1=51200 MP=55304 FP2=53504</code>
Unterer Rollladen (FP2) eines Velux SMG Doppelrollladen:
:<code>set Velux_2 raw ParameterActive=2 FP2=0 MP=55304 FP1=53504</code>
:<code>set Velux_2 raw ParameterActive=2 FP2=51200 MP=55304 FP1=53504</code>

Beim Aufruf muss man sich für einen Parameter entscheiden, von dem man Feedback erhalten will. Diesen wählt man mit ParameterActive aus. Default ist ParameterActive=0 für MP. Ein Functional Parameter kann mit 1 - 16 ausgewählt werden.
Die aktuell bekannten Werte stehen in den Readings MP und FP1 bis FP16, wobei nur Readings für tatsächlich genutzte Parameter angelegt werden.

Die Funktion '''set updateCurrentPosition''' aktualisiert die Readings MP und FP1 - FP7, falls vorhanden.

Beispiele für Geräte mit mehreren Motoren:
* Somfy J4 io Protect
* VELUX SMG Doppelrollladen

Wenn sich Nutzer melden sollten, die auf diese Weise Geräte mit mehreren Motoren getestet haben, dann kann entschieden werden, wie dieses Modul auf sinnvolle Weise weiterentwickelt werden kann.

=== Begrenzung des Bewegungsradius / Limitation ===
Die io-homecontrol Geräte haben ein Feature eingebaut, um den Bewegungsradius der Geräte einzuschränken, egal von wo aus sie gesteuert werden. Dieses Limitation-Feature ist in dieses FHEM-Modul ebenfalls integriert.
==== limitationMin und limitationMax ====
Mit den Settern und Readings limitationMin und limitationMax kann man die Limitation setzen und auslesen.
Natürlich kann man auch selbst von der Limitation Gebrauch machen. Man kann z.B. einen Rollladen begrenzen, wenn man weiß, dass das Dachfenster weit offen ist. Dann kann der Rollladen nicht gegen das Fenster stoßen, selbst wenn man ihn mit der Fernbedienung bewegt.
==== limiationClear ====
Mit dem Setter limiationClear kann man alle Limitations (auch von fremden Geräten ausgelöste) löschen.
==== updateLimiation ====
Der Setter updateLimiation aktualisiert die Readings limitationMin und limitationMax auf diesem Gerät, falls die Limitation außerhalb von FHEM gesetzt wurde.

=== Auswerten der Regensensoren ===
Die Regensensoren von Velux Fensteröffnern machen von diesem Limitation-Feature Gebrauch. Wenn es regnet, wird der Bewegungsradius der Fenster eingeschränkt. Zum Beispiel (evtl. Geräte-abhängig):
* limitationMax = 7 bei Regen (0 bei Velux GPU Fenstern),
* limitationMax = 100 wenn es aufhört.
Diese Werte kann man auslesen, ohne dass sich das Fenster dazu bewegt haben muss.

==== limitationUpdateInterval ====
Mit set limitationUpdateInterval kann man festlegen, wie oft diese Werte ausgelesen werden:
* off: Dieser Wert ist für Geräte ohne integrierte Sensoren der Beste, denn zusätzliche Updates sind überflüssig.
* onChange: Hier wird limitationMin und limitationMax aktualisiert, wenn das Gerät bewegt wurde.
* interval in s: Ein Poll-Intervall in Sekunden. Tests mit 120 sind erfolgreich durchgelaufen. Dieser Wert ist vielleicht etwas übertrieben, man denke an das Funkfeuer und den Akku der Geräte. Ein Intervall von 600 ist vielleicht sinnvoller. Beispiele:
:<code>set Velux_1 limitationUpdateInterval off</code>
:<code>set Velux_2 limitationUpdateInterval onChange</code>
:<code>set Velux_3 limitationUpdateInterval 600</code>

==== Extra Reading für den Regensensor ====
Wem die Auswertung vom Reading limitationMax zu indirekt ist, der kann sich ein neues Reading anlegen.
Der folgende Code legt ein Reading namens sensor an, die Werte sind im Beispiel "Regen" oder "trocken".
Es besteht die Annahme, dass bei limitationMax = 7 der Regensensor angeschlagen hat.
:<code>attr Velux_3 userReadings sensor {(ReadingsVal($name,"limitationMax",100) == 7)?"Regen":"trocken"}</code>
Hinweis: Das neue Reading sensor erscheint erst, wenn das Reading limitationMax einmal aktualisiert wurde.

== Vorschläge zur schöneren Darstellung ==
Wie Homematic-Geräte kommt KLF200Node im FHEM-Web sehr schlicht daher. Dieses Kapitel gibt Vorschläge zur Konfiguration einer schöneren Darstellung.

=== Rollladen ===
Dieses Beispiel stellt den Status des Rollladen 10-Prozent genau im Icon dar. Bewegen sich der Rollladen, hat das Icon einen Pfeil nach oben oder unten. Ein Klick auf das Icon setzt den Rollladen in Bewegung oder hält ihn an (toggle).

:<code>attr Velux_2 stateFormat pct execution</code>
:<code>attr Velux_2 devStateIcon .*up:fts_shutter_up:toggle .*down:fts_shutter_down:toggle \d.stop:fts_shutter_100:toggle 1\d.stop:fts_shutter_90:toggle 2\d.stop:fts_shutter_80:toggle 3\d.stop:fts_shutter_70:toggle 4\d.stop:fts_shutter_60:toggle 5\d.stop:fts_shutter_50:toggle 6\d.stop:fts_shutter_40:toggle 7\d.stop:fts_shutter_30:toggle 8\d.stop:fts_shutter_20:toggle 9\d.stop:fts_shutter_10:toggle 100.stop:fts_window_2w:toggle</code>
[[Datei:RollerShutterUpDown.png|300px|Rollladen mit Pfeilen]]

So erhält man einen Slider für die Rollladenposition:

:<code>attr Velux_2 webCmd pct</code>

=== Dachschrägenfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachschrägenfenster in drei Stufen dar:

0% - 9%: geschlossen

10% - 59%: halb geöffnet

60% - 100%: ganz geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_4 limitationUpdateInterval 600</code>
:<code>attr Velux_4 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_4 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7\).*:weather_rain:toggle \d.$.*:fts_window_roof:toggle [1-5]\d.\(.*:fts_window_roof_open_1:toggle [6-9]\d.\(.*:fts_window_roof_open_2:toggle 100.\(.*:fts_window_roof_open_2:toggle</code>

=== Dachkuppelfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachkuppelfenster in zwei Stufen dar:

0% - 9%: geschlossen

10% - 100%: geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_5 limitationUpdateInterval 600</code>
:<code>attr Velux_5 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_5 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7$.*:weather_rain:toggle \d.\(.*:fts_light_dome:toggle [1-9]\d.\(.*:fts_light_dome_open:toggle 100.\(.*:fts_light_dome_open:toggle</code>

== Problembehebung ==
=== Verbindungsabbrüche ===
Sollte es zu Verbindungsabbrüchen zwischen FHEM und der KLF200-Box kommen, dann sind folgende Dinge zu überprüfen:
==== FHEM Update ====
Ist FHEM aktuell? Am 18.12.2018 gab es ein wichtiges FHEM-Update, das die Stabilität von SSL-Verbindungen wesentlich verbessert hat.
==== OpenSSL ====
OpenSLL sollte immer aktuell sein.
==== Perl SSL-Bibliotheken ====
Wenn die Perl SSL-Bibliotheken zu alt sind, ist das oben genannte FHEM-Update wirkungslos.
* IO::Socket::SSL
* Net::SSL
* Net::SSLeay
* Net::SSLeay::Handle
* Crypt::SSLeay
* Net::Server::Proto::SSL

=== Registrieren von Geräten an der KLF200-Box ===

Die [https://velcdn.azureedge.net/~/media/marketing/ch/fachleute/einbauanleitungen/elektro-nachrustung/zubehor/klf-200_bedienungsanleitung_basic%20de.pdf KLF200-Dokumentation] Seite 11 - 19 beschreibt 2 Varianten, um Geräte mit der Box zu koppeln.

==== 1. Registrierung mit einer Zweiweg-Bedienung ====
Dieser Weg funktioniert über die Schlüssel-Taste oder im Web-UI über PRODUKTE KOPIEREN.

Es ist eine Zweiweg-Bedienung erforderlich, die in der Lage ist, die IO-Schlüssel zu exportieren.

Dieser Weg geht z.B. mit dem Control Pad KLR200, Somfy TaHoma, [https://www.somfy.de/hilfe-center/faq/wie-binde-ich-produkte-ein-die-bereits-mit-einem-2-wege-sender-angesteuert-werden Nina io, Telis Composio io, Impresario Chronis io, Easy Sun io und Telis 1 io.].

TaHoma: anmelden, Menü "Sicherheitseinstellungen", Reiter "io-System", "SICHERHEITSSCHLÜSSEL SENDEN"

==== 2. Registrierung mit einer Einweg-Bedienung ====
Dieser Weg funktioniert über die Reset-Taste oder im Web-UI über PRODUKTSUCHE.

Hierzu wird das Gerät über eine Fernbedienung oder direkt am Gerät in einen Anlernzustand versetzt und dann einigen sich KLF200 und das Gerät über einen Schlüssel.

Bei manchen Somfy-Geräten scheint dieser Weg nicht zu funktionieren, z.B. einige Somfy Smoove Produkte. Hier bleibt nur die Möglichkeit, die Schlüssel wie in Variante 1 von einer Somfy Zweiweg-Bedienung zu kopieren.

=== WARNUNG vor Reset der KLF200-Box! ===
Sollten an der KLF200-Box schon Geräte registriert sein, dann ist ein Factory-Reset unbedingt zu vermeiden!
Die Geräte, die mit der KLF200 bereits Schlüssel ausgetauscht haben, lassen sich nicht ohne weiteres noch einmal registrieren.
Um diese Geräte nach einem Reset der KLF200 trotzdem zu registrieren, sind folgende Schritte notwendig:
# Die registrierten Geräte müssen komplett zurückgesetzt werden.
# Die entsprechenden Fernbedienungen müssen neu angelernt werden.
# Die Geräte können an der KLF200-Box registriert werden.

== Links ==
* Support im Forum gibt es unter {{Link2Forum|Topic=92907|LinkText=Velux KLF200 mit Firmware 2.0.0.71 für io-homecontrol}}
* Github: [https://github.com/buennerbernd/fhem/tree/master/KLF200/2.0 FHEM modules KLF200 and KLF200Node]

[[Kategorie:Rollladensteuerung]]
[[Kategorie:io-homecontrol]]
[[Kategorie:Other Components]]

Velux KLF200

2020-08-27T08:13:14Z

Buennerbernd: /* Raw-Befehle zum Testen von unbekannten Geräten */

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Anbindung io-homecontrol Aktoren an FHEM
|ModType=x
|ModCmdRef=KLF200
|ModFTopic=92907
|ModTechName=83_KLF200.pm
|ModOwner=buennerbernd ({{Link2FU|21440|Forum}} / [[Benutzer Diskussion:Buennerbernd|Wiki]])
}}

'''KLF200''' ist ein Modul zur Steuerung von '''io-homecontrol''' Aktoren über das Gateway Velux KLF 200.

== Velux KLF 200 ==

Die KLF-200-Box ist über LAN mit FHEM verbunden und steuert die Aktoren über das verschlüsselte Funkprotokoll ''io-homecontrol''.
Die Aktoren geben Rückmeldung über ihren aktuellen Zustand.

Die Box hat 10 elektrische Eingänge mit denen man 5 Geräte oder Gerätegruppen steuern kann.
Damit kann man z.B. mit Doppeltastern an der Wand seine Rollladen oder Fenster steuern.
Über den LAN-Anschluss lassen sich mit FHEM bis zu 200 Geräte mit einer KLF 200 verwalten.

Das Modul erfordert die Firmware-Version 2.0.0.71 und basiert auf der dokumentierten API von Velux. [https://www.velux.com/api/klf200 Download und weitere Informationen]

Das Gateway hat keine Cloud-Integration.

== Unterstützte Geräte ==

Grundsätzlich sollten alle io-homecontrol Aktoren funktionieren. Alleinstehende Sensoren (z.B. Lichtsensor, Windsensor) werden
von der KLF-200-Box nicht unterstützt. Es besteht aber die Möglichkeit, den Status von Sensoren auszuwerten, die in Aktoren integriert sind.

Aktuell werden folgende Geräte erfolgreich mit diesem Modul verwendet:

* Rollladen:
** VELUX SML
** VELUX SSL
** VELUX SMG (Doppelrollladen getrennt steuerbar)
** Somfy Oximo io
** Somfy RS100 io
** Somfy Izymo io
* Sichtschutz innen:
** VELUX FSK
** VELUX DML
* Fensteröffner mit integriertem Regensensor:
** VELUX KMG
** VELUX CVP
** VELUX KSX
** VELUX GPU
* Markisen:
** VELUX MSL
** VELUX MML
** Somfy Sunea io
** Somfy Maestria+ 50 io
* Raffstore
** Somfy (Winkelsteuerung der Lamellen möglich)

== Benutzung in FHEM ==
=== Vorbereitung ===
Bevor die Aktoren in FHEM verwendet werden können, müssen sie in der [[#Registrieren von Geräten an der KLF200-Box|KLF 200 angelernt]] werden.
Das geschieht über das WebUI der KLF 200, das über einen Wifi-Hotspot erreichbar ist. Dieser Vorgang ist im Handbuch beschrieben.
Im WebUI können die angeschlossenen Geräte auch benannt werden. Zusätzlich hat man die Möglichkeit, Programme (Szenen) aufzuzeichnen,
um ein oder mehrere Geräte in eine definierte Position zu bringen. Diese Szenen kann man aus FHEM ebenfalls ansteuern.

Das Modul wird momentan noch nicht über FHEM ausgeliefert.
Es wird wie folgt geladen und aktualisiert:

:<code>update all <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>
:<code>shutdown restart</code>

Mit diesem Befehl wird das Modul so eingerichtet, dass es ebenfalls aktualisiert wird, wenn man FHEM aktualisiert:
:<code>update add <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>

=== Anlegen der Geräte ===
:<code>define <name> KLF200 <host></code>
Beispiel:
:<code>define Velux KLF200 192.168.0.66</code>

Danach Login durch Eingabe des Passwortes:
:<code>set <name> login <password></code>

Hinweis: Das Passwort ist laut Dokumentation das Wifi-Passwort, das auf den Boden der Box gedruckt ist.
Das funktioniert bei einigen Nutzern. Bei vielen Nutzern funktioniert hingegen das Passwort des WebUI.
Scheinbar hängt das davon ab, mit welcher Firmware die Box ausgeliefert wurde und ob schon einmal ein Reset durchgeführt wurde.
Das Passwort wird verschleiert im FHEM-Backend gespeichert. Es muss nach erfolgreichem Login nicht mehr eingegeben werden.

Die angeschlossenen Aktoren werden jetzt durch autocreate als Instanzen von KLF200Node im Raum KLF200Node angelegt.
Die Namen der Geräte folgen dem Muster <name>_<NodeID>.
Wurde im WebUI der KLF200 ein Name für das Gerät vergeben dann wird dieser als Alias übernommen.

Die Geräte sind jetzt einsatzbereit.

== Modul KLF200 ==
=== Verbindungsstatus ===
==== STATE ====
Im STATE des Moduls sieht man den aktuellen Verbindungsstatus. Im Idealfall ist er nach der Initialisierung Logged in.
=== Ausführung von Programmen (Szenen) ===
Obwohl man mit dem Modul KLF200Node jedes Gerät unabhängig und auch gleichzeitig steuern kann, sind Szenen eine nützliche Ergänzung. So kann man mit Szenen wie "Alle zu" oder "Alle auf" viele Geräte gleichzeitig mit einem Befehl bedienen.

Hinweis: Während der Abarbeitung einer Szene werden weitere Befehle gepuffert.
==== scene/sceneID ====
Mit diesen Set-Funktionen kann man eine aufgezeichnete Szene aufrufen.
Im entsprechenden Reading steht die zuletzt aufgerufene Szene.

Die Zuordnung zwischen sceneID und scene sieht man in den Internals unter scenes.

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Bei vielen aktuellen Geräten lässt sich die Ausführungsgeschwindigkeit (Velocity) variieren. So lässt sich die Geschwindigkeit gegenüber der Default-Geschwindigkeit noch erhöhen oder auch deutlich reduzieren. So ist eine besonders leise Bedienung möglich.

==== Argument DEFAULT, FAST, SILENT ====
Die Velocity kann man bei der Ausführung von Szenen als zusätzliches Argument von set scene oder set sceneID setzen.
Unterstützte Werte sind DEFAULT, FAST und SILENT
:<code>set Velux scene "Alle zu" SILENT</code>
==== Attribut velocity ====
Alternativ kann man im Modul KLF200 das Attribut velocity setzen, das bei der Ausführung von Szenen herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

Hinweis: Dieses Attribut hat keine Auswirkungen auf Befehle, die vom Modul KLF200Node abgesetzt werden.

== Modul KLF200Node ==
Dieses Modul wurde dem Homematic-Modul CUL_HM nachempfunden, da es ebenfalls ein breites Spektrum an Geräten unterstützt
und möglichst kompatibel zu vorhandenen Hilfsmodulen sein soll.
=== Aktueller Status ===
Im Folgenden wird der Zusammenhang zwischen den wichtigsten Readings/Set-Funktionen pct, state, execution erklärt.
==== pct ====
Dieses Reading enthält den aktuell bekannten Status des Gerätes in Prozent.

Wird das Gerät über die KLF-200-Box gesteuert, wird das Reading beim Erreichen der Zielposition sofort aktualisiert.

Wird das Gerät über eine Fernbedienung oder einen Sensor gesteuert, kann sich die Aktualisierung wenige Minuten verzögern.

Mit der Set-Funktion kann man das Gerät in diesen Status versetzen.
Per Default entspricht 100 auf der Fernbedienung oben und 0 unten.
==== state ====
Dieses Reading entspricht dem Reading pct, mit der Ausnahme, dass 0 durch '''off''' ersetzt wird und 100 durch '''on'''.

Die Set-Funktion funktioniert analog.
Per Default entspricht on auf der Fernbedienung oben und off unten.

Es werden die '''set extensions''' unterstützt. Damit können mit einem Set ein oder mehrere Befehle zeitgesteuert abgesetzt werden.

Doku: [https://fhem.de/commandref_DE.html#set set extensions in der commandref] und im [[DevelopmentModuleIntro#X_Set]] jeweils etwas weiter unten.

==== execution ====
Dieses Reading gibt den aktuellen Ausführungsstatus wieder. Die meiste Zeit ist der Wert stop.
Wird gerade ein Befehl ausgeführt, ist der Wert up oder down.

Mit der Set-Funktion werden entsprechende Befehle ausgeführt, up entspricht auf der Fernbedienung oben und down unten.
Bei stop wird die aktuelle Ausführung angehalten.

==== Attribut directionOn ====
Wie oben beschrieben, entspricht per Default on = 100 = up.

Das kann bei bestimmten Geräten für manchen Nutzer verwirrend sein.
Wenn man z.B. bei einem Rollladen lieber im geschlossenen Zustand 100 Prozent sehen möchte, dann setzt man das Attribut directionOn, z.B.
:<code>attr Velux_2 directionOn down</code>

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Wie bei Szenen lässt sich auch bei Kommandos auf KLF200Node die Ausführungsgeschwindigkeit beeinflussen, soweit das vom Gerät unterstützt ist.
==== Reading velocity ====
Dieses Reading hat den Wert supported, wenn die Geschwindigkeit bei diesem Gerät geändert werden kann.
Selbst bei Not supported wäre es einen Versuch wert, es zu testen.
==== Argument DEFAULT, FAST, SILENT ====
Alle set-Funktionen, die eine Bewegung auslösen unterstützen das optionale Argument DEFAULT, FAST oder SILENT.
==== Attribut velocity ====
Alternativ kann man im Modul KLF200Node das Attribut velocity setzen, das bei der Ausführung von Kommandos herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

=== Raw-Befehle zum Testen von unbekannten Geräten ===
Die bisher beschriebenen Funktionen des KLF200Node-Moduls bieten einen vereinfachten Zugang zu io-homecontrol-Geräten mit nur einem Motor.

Intern wird bei diesen Funktionen der Main Parameter (MP) für die Steuerung des Motors und der Functional Parameter 1 (FP1) für die Velocity gesetzt.
Theoretisch können Geräte bis zu 16 Functional Parameter (FP1 bis FP16) haben. Der Wertebereich aller Parameter ist 0 - 65535, wobei sich 0 - 100% auf 0 - 51200 abbilden.

'''Für Experten''' bietet die Funktion '''set raw''' die Möglichkeit, mehrere Parameter gleichzeitig zu setzen. Damit lassen sich dann z.B. die Lamellen von Raffstores bewegen.
Zuvor wird empfohlen, in der [https://velcdn.azureedge.net/~/media/com/api/klf200/technical%20specification%20for%20klf%20200%20api-ver3-16.pdf KLF 200 API] die folgenden Kapitel zu lesen:
* 10.1.1 GW_COMMAND_SEND_REQ
* 10.1.1.4 ParameterActive parameter
* 13 Appendix 1: Standard Parameter definition
* 14 Appendix 2: List of actuator types and their use of Main Parameter and Functional Parameters

Beispiel-Aufrufe:

Winkelsteuerung (FP3) eines Somfy Raffstores:
:<code>set Velux_1 raw ParameterActive=3 FP3=0</code>
:<code>set Velux_1 raw ParameterActive=3 FP3=51200</code>
Oberer Rollladen (FP1) eines Velux SMG Doppelrollladen:
:<code>set Velux_2 raw ParameterActive=1 FP1=0 MP=55304 FP2=53504</code>
:<code>set Velux_2 raw ParameterActive=1 FP1=51200 MP=55304 FP2=53504</code>
Unterer Rollladen (FP2) eines Velux SMG Doppelrollladen:
:<code>set Velux_2 raw ParameterActive=2 FP2=0 MP=55304 FP1=53504</code>
:<code>set Velux_2 raw ParameterActive=2 FP2=51200 MP=55304 FP1=53504</code>

Beim Aufruf muss man sich für einen Parameter entscheiden, von dem man Feedback erhalten will. Diesen wählt man mit ParameterActive aus. Default ist ParameterActive=0 für MP. Ein Functional Parameter kann mit 1 - 16 ausgewählt werden.
Die aktuell bekannten Werte stehen in den Readings MP und FP1 bis FP16, wobei nur Readings für tatsächlich genutzte Parameter angelegt werden.

Die Funktion '''set updateCurrentPosition''' aktualisiert die Readings MP und FP1 - FP7, falls vorhanden.

Beispiele für Geräte mit mehreren Motoren:
* Somfy J4 io Protect
* VELUX SMG Doppelrollladen

Wenn sich Nutzer melden sollten, die auf diese Weise Geräte mit mehreren Motoren getestet haben, dann kann entschieden werden, wie dieses Modul auf sinnvolle Weise weiterentwickelt werden kann.

=== Begrenzung des Bewegungsradius / Limitation ===
Die io-homecontrol Geräte haben ein Feature eingebaut, um den Bewegungsradius der Geräte einzuschränken, egal von wo aus sie gesteuert werden. Dieses Limitation-Feature ist in dieses FHEM-Modul ebenfalls integriert.
==== limitationMin und limitationMax ====
Mit den Settern und Readings limitationMin und limitationMax kann man die Limitation setzen und auslesen.
Natürlich kann man auch selbst von der Limitation Gebrauch machen. Man kann z.B. einen Rollladen begrenzen, wenn man weiß, dass das Dachfenster weit offen ist. Dann kann der Rollladen nicht gegen das Fenster stoßen, selbst wenn man ihn mit der Fernbedienung bewegt.
==== limiationClear ====
Mit dem Setter limiationClear kann man alle Limitations (auch von fremden Geräten ausgelöste) löschen.
==== updateLimiation ====
Der Setter updateLimiation aktualisiert die Readings limitationMin und limitationMax auf diesem Gerät, falls die Limitation außerhalb von FHEM gesetzt wurde.

=== Auswerten der Regensensoren ===
Die Regensensoren von Velux Fensteröffnern machen von diesem Limitation-Feature Gebrauch. Wenn es regnet, wird der Bewegungsradius der Fenster eingeschränkt. Zum Beispiel (evtl. Geräte-abhängig):
* limitationMax = 7 bei Regen (0 bei Velux GPU Fenstern),
* limitationMax = 100 wenn es aufhört.
Diese Werte kann man auslesen, ohne dass sich das Fenster dazu bewegt haben muss.

==== limitationUpdateInterval ====
Mit set limitationUpdateInterval kann man festlegen, wie oft diese Werte ausgelesen werden:
* off: Dieser Wert ist für Geräte ohne integrierte Sensoren der Beste, denn zusätzliche Updates sind überflüssig.
* onChange: Hier wird limitationMin und limitationMax aktualisiert, wenn das Gerät bewegt wurde.
* interval in s: Ein Poll-Intervall in Sekunden. Tests mit 120 sind erfolgreich durchgelaufen. Dieser Wert ist vielleicht etwas übertrieben, man denke an das Funkfeuer und den Akku der Geräte. Ein Intervall von 600 ist vielleicht sinnvoller. Beispiele:
:<code>set Velux_1 limitationUpdateInterval off</code>
:<code>set Velux_2 limitationUpdateInterval onChange</code>
:<code>set Velux_3 limitationUpdateInterval 600</code>

==== Extra Reading für den Regensensor ====
Wem die Auswertung vom Reading limitationMax zu indirekt ist, der kann sich ein neues Reading anlegen.
Der folgende Code legt ein Reading namens sensor an, die Werte sind im Beispiel "Regen" oder "trocken".
Es besteht die Annahme, dass bei limitationMax = 7 der Regensensor angeschlagen hat.
:<code>attr Velux_3 userReadings sensor {(ReadingsVal($name,"limitationMax",100) == 7)?"Regen":"trocken"}</code>
Hinweis: Das neue Reading sensor erscheint erst, wenn das Reading limitationMax einmal aktualisiert wurde.

== Vorschläge zur schöneren Darstellung ==
Wie Homematic-Geräte kommt KLF200Node im FHEM-Web sehr schlicht daher. Dieses Kapitel gibt Vorschläge zur Konfiguration einer schöneren Darstellung.

=== Rollladen ===
Dieses Beispiel stellt den Status des Rollladen 10-Prozent genau im Icon dar. Bewegen sich der Rollladen, hat das Icon einen Pfeil nach oben oder unten. Ein Klick auf das Icon setzt den Rollladen in Bewegung oder hält ihn an (toggle).

:<code>attr Velux_2 stateFormat pct execution</code>
:<code>attr Velux_2 devStateIcon .*up:fts_shutter_up:toggle .*down:fts_shutter_down:toggle \d.stop:fts_shutter_100:toggle 1\d.stop:fts_shutter_90:toggle 2\d.stop:fts_shutter_80:toggle 3\d.stop:fts_shutter_70:toggle 4\d.stop:fts_shutter_60:toggle 5\d.stop:fts_shutter_50:toggle 6\d.stop:fts_shutter_40:toggle 7\d.stop:fts_shutter_30:toggle 8\d.stop:fts_shutter_20:toggle 9\d.stop:fts_shutter_10:toggle 100.stop:fts_window_2w:toggle</code>
[[Datei:RollerShutterUpDown.png|300px|Rollladen mit Pfeilen]]

So erhält man einen Slider für die Rollladenposition:

:<code>attr Velux_2 webCmd pct</code>

=== Dachschrägenfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachschrägenfenster in drei Stufen dar:

0% - 9%: geschlossen

10% - 59%: halb geöffnet

60% - 100%: ganz geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_4 limitationUpdateInterval 600</code>
:<code>attr Velux_4 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_4 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7\).*:weather_rain:toggle \d.$.*:fts_window_roof:toggle [1-5]\d.\(.*:fts_window_roof_open_1:toggle [6-9]\d.\(.*:fts_window_roof_open_2:toggle 100.\(.*:fts_window_roof_open_2:toggle</code>

=== Dachkuppelfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachkuppelfenster in zwei Stufen dar:

0% - 9%: geschlossen

10% - 100%: geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_5 limitationUpdateInterval 600</code>
:<code>attr Velux_5 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_5 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7$.*:weather_rain:toggle \d.\(.*:fts_light_dome:toggle [1-9]\d.\(.*:fts_light_dome_open:toggle 100.\(.*:fts_light_dome_open:toggle</code>

== Problembehebung ==
=== Verbindungsabbrüche ===
Sollte es zu Verbindungsabbrüchen zwischen FHEM und der KLF200-Box kommen, dann sind folgende Dinge zu überprüfen:
==== FHEM Update ====
Ist FHEM aktuell? Am 18.12.2018 gab es ein wichtiges FHEM-Update, das die Stabilität von SSL-Verbindungen wesentlich verbessert hat.
==== OpenSSL ====
OpenSLL sollte immer aktuell sein.
==== Perl SSL-Bibliotheken ====
Wenn die Perl SSL-Bibliotheken zu alt sind, ist das oben genannte FHEM-Update wirkungslos.
* IO::Socket::SSL
* Net::SSL
* Net::SSLeay
* Net::SSLeay::Handle
* Crypt::SSLeay
* Net::Server::Proto::SSL

=== Registrieren von Geräten an der KLF200-Box ===

Die [https://velcdn.azureedge.net/~/media/marketing/ch/fachleute/einbauanleitungen/elektro-nachrustung/zubehor/klf-200_bedienungsanleitung_basic%20de.pdf KLF200-Dokumentation] Seite 11 - 19 beschreibt 2 Varianten, um Geräte mit der Box zu koppeln.

==== 1. Registrierung mit einer Zweiweg-Bedienung ====
Dieser Weg funktioniert über die Schlüssel-Taste oder im Web-UI über PRODUKTE KOPIEREN.

Es ist eine Zweiweg-Bedienung erforderlich, die in der Lage ist, die IO-Schlüssel zu exportieren.

Dieser Weg geht z.B. mit dem Control Pad KLR200, Somfy TaHoma, [https://www.somfy.de/hilfe-center/faq/wie-binde-ich-produkte-ein-die-bereits-mit-einem-2-wege-sender-angesteuert-werden Nina io, Telis Composio io, Impresario Chronis io, Easy Sun io und Telis 1 io.].

TaHoma: anmelden, Menü "Sicherheitseinstellungen", Reiter "io-System", "SICHERHEITSSCHLÜSSEL SENDEN"

==== 2. Registrierung mit einer Einweg-Bedienung ====
Dieser Weg funktioniert über die Reset-Taste oder im Web-UI über PRODUKTSUCHE.

Hierzu wird das Gerät über eine Fernbedienung oder direkt am Gerät in einen Anlernzustand versetzt und dann einigen sich KLF200 und das Gerät über einen Schlüssel.

Bei manchen Somfy-Geräten scheint dieser Weg nicht zu funktionieren, z.B. einige Somfy Smoove Produkte. Hier bleibt nur die Möglichkeit, die Schlüssel wie in Variante 1 von einer Somfy Zweiweg-Bedienung zu kopieren.

=== WARNUNG vor Reset der KLF200-Box! ===
Sollten an der KLF200-Box schon Geräte registriert sein, dann ist ein Factory-Reset unbedingt zu vermeiden!
Die Geräte, die mit der KLF200 bereits Schlüssel ausgetauscht haben, lassen sich nicht ohne weiteres noch einmal registrieren.
Um diese Geräte nach einem Reset der KLF200 trotzdem zu registrieren, sind folgende Schritte notwendig:
# Die registrierten Geräte müssen komplett zurückgesetzt werden.
# Die entsprechenden Fernbedienungen müssen neu angelernt werden.
# Die Geräte können an der KLF200-Box registriert werden.

== Links ==
* Support im Forum gibt es unter {{Link2Forum|Topic=92907|LinkText=Velux KLF200 mit Firmware 2.0.0.71 für io-homecontrol}}
* Github: [https://github.com/buennerbernd/fhem/tree/master/KLF200/2.0 FHEM modules KLF200 and KLF200Node]

[[Kategorie:Rollladensteuerung]]
[[Kategorie:io-homecontrol]]
[[Kategorie:Other Components]]

Velux KLF200

2020-08-27T08:01:30Z

Buennerbernd: /* Unterstützte Geräte */

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Anbindung io-homecontrol Aktoren an FHEM
|ModType=x
|ModCmdRef=KLF200
|ModFTopic=92907
|ModTechName=83_KLF200.pm
|ModOwner=buennerbernd ({{Link2FU|21440|Forum}} / [[Benutzer Diskussion:Buennerbernd|Wiki]])
}}

'''KLF200''' ist ein Modul zur Steuerung von '''io-homecontrol''' Aktoren über das Gateway Velux KLF 200.

== Velux KLF 200 ==

Die KLF-200-Box ist über LAN mit FHEM verbunden und steuert die Aktoren über das verschlüsselte Funkprotokoll ''io-homecontrol''.
Die Aktoren geben Rückmeldung über ihren aktuellen Zustand.

Die Box hat 10 elektrische Eingänge mit denen man 5 Geräte oder Gerätegruppen steuern kann.
Damit kann man z.B. mit Doppeltastern an der Wand seine Rollladen oder Fenster steuern.
Über den LAN-Anschluss lassen sich mit FHEM bis zu 200 Geräte mit einer KLF 200 verwalten.

Das Modul erfordert die Firmware-Version 2.0.0.71 und basiert auf der dokumentierten API von Velux. [https://www.velux.com/api/klf200 Download und weitere Informationen]

Das Gateway hat keine Cloud-Integration.

== Unterstützte Geräte ==

Grundsätzlich sollten alle io-homecontrol Aktoren funktionieren. Alleinstehende Sensoren (z.B. Lichtsensor, Windsensor) werden
von der KLF-200-Box nicht unterstützt. Es besteht aber die Möglichkeit, den Status von Sensoren auszuwerten, die in Aktoren integriert sind.

Aktuell werden folgende Geräte erfolgreich mit diesem Modul verwendet:

* Rollladen:
** VELUX SML
** VELUX SSL
** VELUX SMG (Doppelrollladen getrennt steuerbar)
** Somfy Oximo io
** Somfy RS100 io
** Somfy Izymo io
* Sichtschutz innen:
** VELUX FSK
** VELUX DML
* Fensteröffner mit integriertem Regensensor:
** VELUX KMG
** VELUX CVP
** VELUX KSX
** VELUX GPU
* Markisen:
** VELUX MSL
** VELUX MML
** Somfy Sunea io
** Somfy Maestria+ 50 io
* Raffstore
** Somfy (Winkelsteuerung der Lamellen möglich)

== Benutzung in FHEM ==
=== Vorbereitung ===
Bevor die Aktoren in FHEM verwendet werden können, müssen sie in der [[#Registrieren von Geräten an der KLF200-Box|KLF 200 angelernt]] werden.
Das geschieht über das WebUI der KLF 200, das über einen Wifi-Hotspot erreichbar ist. Dieser Vorgang ist im Handbuch beschrieben.
Im WebUI können die angeschlossenen Geräte auch benannt werden. Zusätzlich hat man die Möglichkeit, Programme (Szenen) aufzuzeichnen,
um ein oder mehrere Geräte in eine definierte Position zu bringen. Diese Szenen kann man aus FHEM ebenfalls ansteuern.

Das Modul wird momentan noch nicht über FHEM ausgeliefert.
Es wird wie folgt geladen und aktualisiert:

:<code>update all <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>
:<code>shutdown restart</code>

Mit diesem Befehl wird das Modul so eingerichtet, dass es ebenfalls aktualisiert wird, wenn man FHEM aktualisiert:
:<code>update add <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>

=== Anlegen der Geräte ===
:<code>define <name> KLF200 <host></code>
Beispiel:
:<code>define Velux KLF200 192.168.0.66</code>

Danach Login durch Eingabe des Passwortes:
:<code>set <name> login <password></code>

Hinweis: Das Passwort ist laut Dokumentation das Wifi-Passwort, das auf den Boden der Box gedruckt ist.
Das funktioniert bei einigen Nutzern. Bei vielen Nutzern funktioniert hingegen das Passwort des WebUI.
Scheinbar hängt das davon ab, mit welcher Firmware die Box ausgeliefert wurde und ob schon einmal ein Reset durchgeführt wurde.
Das Passwort wird verschleiert im FHEM-Backend gespeichert. Es muss nach erfolgreichem Login nicht mehr eingegeben werden.

Die angeschlossenen Aktoren werden jetzt durch autocreate als Instanzen von KLF200Node im Raum KLF200Node angelegt.
Die Namen der Geräte folgen dem Muster <name>_<NodeID>.
Wurde im WebUI der KLF200 ein Name für das Gerät vergeben dann wird dieser als Alias übernommen.

Die Geräte sind jetzt einsatzbereit.

== Modul KLF200 ==
=== Verbindungsstatus ===
==== STATE ====
Im STATE des Moduls sieht man den aktuellen Verbindungsstatus. Im Idealfall ist er nach der Initialisierung Logged in.
=== Ausführung von Programmen (Szenen) ===
Obwohl man mit dem Modul KLF200Node jedes Gerät unabhängig und auch gleichzeitig steuern kann, sind Szenen eine nützliche Ergänzung. So kann man mit Szenen wie "Alle zu" oder "Alle auf" viele Geräte gleichzeitig mit einem Befehl bedienen.

Hinweis: Während der Abarbeitung einer Szene werden weitere Befehle gepuffert.
==== scene/sceneID ====
Mit diesen Set-Funktionen kann man eine aufgezeichnete Szene aufrufen.
Im entsprechenden Reading steht die zuletzt aufgerufene Szene.

Die Zuordnung zwischen sceneID und scene sieht man in den Internals unter scenes.

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Bei vielen aktuellen Geräten lässt sich die Ausführungsgeschwindigkeit (Velocity) variieren. So lässt sich die Geschwindigkeit gegenüber der Default-Geschwindigkeit noch erhöhen oder auch deutlich reduzieren. So ist eine besonders leise Bedienung möglich.

==== Argument DEFAULT, FAST, SILENT ====
Die Velocity kann man bei der Ausführung von Szenen als zusätzliches Argument von set scene oder set sceneID setzen.
Unterstützte Werte sind DEFAULT, FAST und SILENT
:<code>set Velux scene "Alle zu" SILENT</code>
==== Attribut velocity ====
Alternativ kann man im Modul KLF200 das Attribut velocity setzen, das bei der Ausführung von Szenen herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

Hinweis: Dieses Attribut hat keine Auswirkungen auf Befehle, die vom Modul KLF200Node abgesetzt werden.

== Modul KLF200Node ==
Dieses Modul wurde dem Homematic-Modul CUL_HM nachempfunden, da es ebenfalls ein breites Spektrum an Geräten unterstützt
und möglichst kompatibel zu vorhandenen Hilfsmodulen sein soll.
=== Aktueller Status ===
Im Folgenden wird der Zusammenhang zwischen den wichtigsten Readings/Set-Funktionen pct, state, execution erklärt.
==== pct ====
Dieses Reading enthält den aktuell bekannten Status des Gerätes in Prozent.

Wird das Gerät über die KLF-200-Box gesteuert, wird das Reading beim Erreichen der Zielposition sofort aktualisiert.

Wird das Gerät über eine Fernbedienung oder einen Sensor gesteuert, kann sich die Aktualisierung wenige Minuten verzögern.

Mit der Set-Funktion kann man das Gerät in diesen Status versetzen.
Per Default entspricht 100 auf der Fernbedienung oben und 0 unten.
==== state ====
Dieses Reading entspricht dem Reading pct, mit der Ausnahme, dass 0 durch '''off''' ersetzt wird und 100 durch '''on'''.

Die Set-Funktion funktioniert analog.
Per Default entspricht on auf der Fernbedienung oben und off unten.

Es werden die '''set extensions''' unterstützt. Damit können mit einem Set ein oder mehrere Befehle zeitgesteuert abgesetzt werden.

Doku: [https://fhem.de/commandref_DE.html#set set extensions in der commandref] und im [[DevelopmentModuleIntro#X_Set]] jeweils etwas weiter unten.

==== execution ====
Dieses Reading gibt den aktuellen Ausführungsstatus wieder. Die meiste Zeit ist der Wert stop.
Wird gerade ein Befehl ausgeführt, ist der Wert up oder down.

Mit der Set-Funktion werden entsprechende Befehle ausgeführt, up entspricht auf der Fernbedienung oben und down unten.
Bei stop wird die aktuelle Ausführung angehalten.

==== Attribut directionOn ====
Wie oben beschrieben, entspricht per Default on = 100 = up.

Das kann bei bestimmten Geräten für manchen Nutzer verwirrend sein.
Wenn man z.B. bei einem Rollladen lieber im geschlossenen Zustand 100 Prozent sehen möchte, dann setzt man das Attribut directionOn, z.B.
:<code>attr Velux_2 directionOn down</code>

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Wie bei Szenen lässt sich auch bei Kommandos auf KLF200Node die Ausführungsgeschwindigkeit beeinflussen, soweit das vom Gerät unterstützt ist.
==== Reading velocity ====
Dieses Reading hat den Wert supported, wenn die Geschwindigkeit bei diesem Gerät geändert werden kann.
Selbst bei Not supported wäre es einen Versuch wert, es zu testen.
==== Argument DEFAULT, FAST, SILENT ====
Alle set-Funktionen, die eine Bewegung auslösen unterstützen das optionale Argument DEFAULT, FAST oder SILENT.
==== Attribut velocity ====
Alternativ kann man im Modul KLF200Node das Attribut velocity setzen, das bei der Ausführung von Kommandos herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

=== Raw-Befehle zum Testen von unbekannten Geräten ===
Die bisher beschriebenen Funktionen des KLF200Node-Moduls bieten einen vereinfachten Zugang zu io-homecontrol-Geräten mit nur einem Motor.

Intern wird bei diesen Funktionen der Main Parameter (MP) für die Steuerung des Motors und der Functional Parameter 1 (FP1) für die Velocity gesetzt.
Theoretisch können Geräte bis zu 16 Functional Parameter (FP1 bis FP16) haben. Der Wertebereich aller Parameter ist 0 - 65535, wobei sich 0 - 100% auf 0 - 51200 abbilden.

'''Für Experten''' bietet die Funktion '''set raw''' die Möglichkeit, mehrere Parameter gleichzeitig zu setzen. Damit lassen sich dann z.B. die Lamellen von Raffstores bewegen.
Zuvor wird empfohlen, in der [https://velcdn.azureedge.net/~/media/com/api/klf200/technical%20specification%20for%20klf%20200%20api-ver3-16.pdf KLF 200 API] die folgenden Kapitel zu lesen:
* 10.1.1 GW_COMMAND_SEND_REQ
* 10.1.1.4 ParameterActive parameter
* 13 Appendix 1: Standard Parameter definition
* 14 Appendix 2: List of actuator types and their use of Main Parameter and Functional Parameters

Beispiel-Aufrufe:
:<code>set Velux_1 raw MP=51200</code>
:<code>set Velux_2 raw MP=0 FP1=51200</code>
:<code>set Velux_3 raw ParameterActive=3 FP3=25600 FP2=51200</code>
Winkelsteuerung Somfy Raffstore:
:<code>set Velux_4 raw ParameterActive=3 FP3=0</code>
:<code>set Velux_4 raw ParameterActive=3 FP3=51200</code>

Beim Aufruf muss man sich für einen Parameter entscheiden, von dem man Feedback erhalten will. Diesen wählt man mit ParameterActive aus. Default ist ParameterActive=0 für MP. Ein Functional Parameter kann mit 1 - 16 ausgewählt werden.
Die aktuell bekannten Werte stehen in den Readings MP und FP1 bis FP16, wobei nur Readings für tatsächlich genutzte Parameter angelegt werden.

Die Funktion '''set updateCurrentPosition''' aktualisiert die Readings MP und FP1 - FP7, falls vorhanden.

Beispiele für Geräte mit mehreren Motoren:
* Somfy J4 io Protect
* evtl. VELUX SMG Doppelrollladen

Wenn sich Nutzer melden sollten, die auf diese Weise Geräte mit mehreren Motoren getestet haben, dann kann entschieden werden, wie dieses Modul auf sinnvolle Weise weiterentwickelt werden kann.

=== Begrenzung des Bewegungsradius / Limitation ===
Die io-homecontrol Geräte haben ein Feature eingebaut, um den Bewegungsradius der Geräte einzuschränken, egal von wo aus sie gesteuert werden. Dieses Limitation-Feature ist in dieses FHEM-Modul ebenfalls integriert.
==== limitationMin und limitationMax ====
Mit den Settern und Readings limitationMin und limitationMax kann man die Limitation setzen und auslesen.
Natürlich kann man auch selbst von der Limitation Gebrauch machen. Man kann z.B. einen Rollladen begrenzen, wenn man weiß, dass das Dachfenster weit offen ist. Dann kann der Rollladen nicht gegen das Fenster stoßen, selbst wenn man ihn mit der Fernbedienung bewegt.
==== limiationClear ====
Mit dem Setter limiationClear kann man alle Limitations (auch von fremden Geräten ausgelöste) löschen.
==== updateLimiation ====
Der Setter updateLimiation aktualisiert die Readings limitationMin und limitationMax auf diesem Gerät, falls die Limitation außerhalb von FHEM gesetzt wurde.

=== Auswerten der Regensensoren ===
Die Regensensoren von Velux Fensteröffnern machen von diesem Limitation-Feature Gebrauch. Wenn es regnet, wird der Bewegungsradius der Fenster eingeschränkt. Zum Beispiel (evtl. Geräte-abhängig):
* limitationMax = 7 bei Regen (0 bei Velux GPU Fenstern),
* limitationMax = 100 wenn es aufhört.
Diese Werte kann man auslesen, ohne dass sich das Fenster dazu bewegt haben muss.

==== limitationUpdateInterval ====
Mit set limitationUpdateInterval kann man festlegen, wie oft diese Werte ausgelesen werden:
* off: Dieser Wert ist für Geräte ohne integrierte Sensoren der Beste, denn zusätzliche Updates sind überflüssig.
* onChange: Hier wird limitationMin und limitationMax aktualisiert, wenn das Gerät bewegt wurde.
* interval in s: Ein Poll-Intervall in Sekunden. Tests mit 120 sind erfolgreich durchgelaufen. Dieser Wert ist vielleicht etwas übertrieben, man denke an das Funkfeuer und den Akku der Geräte. Ein Intervall von 600 ist vielleicht sinnvoller. Beispiele:
:<code>set Velux_1 limitationUpdateInterval off</code>
:<code>set Velux_2 limitationUpdateInterval onChange</code>
:<code>set Velux_3 limitationUpdateInterval 600</code>

==== Extra Reading für den Regensensor ====
Wem die Auswertung vom Reading limitationMax zu indirekt ist, der kann sich ein neues Reading anlegen.
Der folgende Code legt ein Reading namens sensor an, die Werte sind im Beispiel "Regen" oder "trocken".
Es besteht die Annahme, dass bei limitationMax = 7 der Regensensor angeschlagen hat.
:<code>attr Velux_3 userReadings sensor {(ReadingsVal($name,"limitationMax",100) == 7)?"Regen":"trocken"}</code>
Hinweis: Das neue Reading sensor erscheint erst, wenn das Reading limitationMax einmal aktualisiert wurde.

== Vorschläge zur schöneren Darstellung ==
Wie Homematic-Geräte kommt KLF200Node im FHEM-Web sehr schlicht daher. Dieses Kapitel gibt Vorschläge zur Konfiguration einer schöneren Darstellung.

=== Rollladen ===
Dieses Beispiel stellt den Status des Rollladen 10-Prozent genau im Icon dar. Bewegen sich der Rollladen, hat das Icon einen Pfeil nach oben oder unten. Ein Klick auf das Icon setzt den Rollladen in Bewegung oder hält ihn an (toggle).

:<code>attr Velux_2 stateFormat pct execution</code>
:<code>attr Velux_2 devStateIcon .*up:fts_shutter_up:toggle .*down:fts_shutter_down:toggle \d.stop:fts_shutter_100:toggle 1\d.stop:fts_shutter_90:toggle 2\d.stop:fts_shutter_80:toggle 3\d.stop:fts_shutter_70:toggle 4\d.stop:fts_shutter_60:toggle 5\d.stop:fts_shutter_50:toggle 6\d.stop:fts_shutter_40:toggle 7\d.stop:fts_shutter_30:toggle 8\d.stop:fts_shutter_20:toggle 9\d.stop:fts_shutter_10:toggle 100.stop:fts_window_2w:toggle</code>
[[Datei:RollerShutterUpDown.png|300px|Rollladen mit Pfeilen]]

So erhält man einen Slider für die Rollladenposition:

:<code>attr Velux_2 webCmd pct</code>

=== Dachschrägenfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachschrägenfenster in drei Stufen dar:

0% - 9%: geschlossen

10% - 59%: halb geöffnet

60% - 100%: ganz geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_4 limitationUpdateInterval 600</code>
:<code>attr Velux_4 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_4 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7\).*:weather_rain:toggle \d.$.*:fts_window_roof:toggle [1-5]\d.\(.*:fts_window_roof_open_1:toggle [6-9]\d.\(.*:fts_window_roof_open_2:toggle 100.\(.*:fts_window_roof_open_2:toggle</code>

=== Dachkuppelfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachkuppelfenster in zwei Stufen dar:

0% - 9%: geschlossen

10% - 100%: geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_5 limitationUpdateInterval 600</code>
:<code>attr Velux_5 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_5 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7$.*:weather_rain:toggle \d.\(.*:fts_light_dome:toggle [1-9]\d.\(.*:fts_light_dome_open:toggle 100.\(.*:fts_light_dome_open:toggle</code>

== Problembehebung ==
=== Verbindungsabbrüche ===
Sollte es zu Verbindungsabbrüchen zwischen FHEM und der KLF200-Box kommen, dann sind folgende Dinge zu überprüfen:
==== FHEM Update ====
Ist FHEM aktuell? Am 18.12.2018 gab es ein wichtiges FHEM-Update, das die Stabilität von SSL-Verbindungen wesentlich verbessert hat.
==== OpenSSL ====
OpenSLL sollte immer aktuell sein.
==== Perl SSL-Bibliotheken ====
Wenn die Perl SSL-Bibliotheken zu alt sind, ist das oben genannte FHEM-Update wirkungslos.
* IO::Socket::SSL
* Net::SSL
* Net::SSLeay
* Net::SSLeay::Handle
* Crypt::SSLeay
* Net::Server::Proto::SSL

=== Registrieren von Geräten an der KLF200-Box ===

Die [https://velcdn.azureedge.net/~/media/marketing/ch/fachleute/einbauanleitungen/elektro-nachrustung/zubehor/klf-200_bedienungsanleitung_basic%20de.pdf KLF200-Dokumentation] Seite 11 - 19 beschreibt 2 Varianten, um Geräte mit der Box zu koppeln.

==== 1. Registrierung mit einer Zweiweg-Bedienung ====
Dieser Weg funktioniert über die Schlüssel-Taste oder im Web-UI über PRODUKTE KOPIEREN.

Es ist eine Zweiweg-Bedienung erforderlich, die in der Lage ist, die IO-Schlüssel zu exportieren.

Dieser Weg geht z.B. mit dem Control Pad KLR200, Somfy TaHoma, [https://www.somfy.de/hilfe-center/faq/wie-binde-ich-produkte-ein-die-bereits-mit-einem-2-wege-sender-angesteuert-werden Nina io, Telis Composio io, Impresario Chronis io, Easy Sun io und Telis 1 io.].

TaHoma: anmelden, Menü "Sicherheitseinstellungen", Reiter "io-System", "SICHERHEITSSCHLÜSSEL SENDEN"

==== 2. Registrierung mit einer Einweg-Bedienung ====
Dieser Weg funktioniert über die Reset-Taste oder im Web-UI über PRODUKTSUCHE.

Hierzu wird das Gerät über eine Fernbedienung oder direkt am Gerät in einen Anlernzustand versetzt und dann einigen sich KLF200 und das Gerät über einen Schlüssel.

Bei manchen Somfy-Geräten scheint dieser Weg nicht zu funktionieren, z.B. einige Somfy Smoove Produkte. Hier bleibt nur die Möglichkeit, die Schlüssel wie in Variante 1 von einer Somfy Zweiweg-Bedienung zu kopieren.

=== WARNUNG vor Reset der KLF200-Box! ===
Sollten an der KLF200-Box schon Geräte registriert sein, dann ist ein Factory-Reset unbedingt zu vermeiden!
Die Geräte, die mit der KLF200 bereits Schlüssel ausgetauscht haben, lassen sich nicht ohne weiteres noch einmal registrieren.
Um diese Geräte nach einem Reset der KLF200 trotzdem zu registrieren, sind folgende Schritte notwendig:
# Die registrierten Geräte müssen komplett zurückgesetzt werden.
# Die entsprechenden Fernbedienungen müssen neu angelernt werden.
# Die Geräte können an der KLF200-Box registriert werden.

== Links ==
* Support im Forum gibt es unter {{Link2Forum|Topic=92907|LinkText=Velux KLF200 mit Firmware 2.0.0.71 für io-homecontrol}}
* Github: [https://github.com/buennerbernd/fhem/tree/master/KLF200/2.0 FHEM modules KLF200 and KLF200Node]

[[Kategorie:Rollladensteuerung]]
[[Kategorie:io-homecontrol]]
[[Kategorie:Other Components]]

Velux KLF200

2020-08-26T09:55:29Z

Buennerbernd: /* Auswerten der Regensensoren */

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Anbindung io-homecontrol Aktoren an FHEM
|ModType=x
|ModCmdRef=KLF200
|ModFTopic=92907
|ModTechName=83_KLF200.pm
|ModOwner=buennerbernd ({{Link2FU|21440|Forum}} / [[Benutzer Diskussion:Buennerbernd|Wiki]])
}}

'''KLF200''' ist ein Modul zur Steuerung von '''io-homecontrol''' Aktoren über das Gateway Velux KLF 200.

== Velux KLF 200 ==

Die KLF-200-Box ist über LAN mit FHEM verbunden und steuert die Aktoren über das verschlüsselte Funkprotokoll ''io-homecontrol''.
Die Aktoren geben Rückmeldung über ihren aktuellen Zustand.

Die Box hat 10 elektrische Eingänge mit denen man 5 Geräte oder Gerätegruppen steuern kann.
Damit kann man z.B. mit Doppeltastern an der Wand seine Rollladen oder Fenster steuern.
Über den LAN-Anschluss lassen sich mit FHEM bis zu 200 Geräte mit einer KLF 200 verwalten.

Das Modul erfordert die Firmware-Version 2.0.0.71 und basiert auf der dokumentierten API von Velux. [https://www.velux.com/api/klf200 Download und weitere Informationen]

Das Gateway hat keine Cloud-Integration.

== Unterstützte Geräte ==

Grundsätzlich sollten alle io-homecontrol Aktoren funktionieren. Alleinstehende Sensoren (z.B. Lichtsensor, Windsensor) werden
von der KLF-200-Box nicht unterstützt. Es besteht aber die Möglichkeit, den Status von Sensoren auszuwerten, die in Aktoren integriert sind.

Aktuell werden folgende Geräte erfolgreich mit diesem Modul verwendet:

* Rollladen:
** VELUX SML
** VELUX SSL
** VELUX SMG (Doppelrollladen noch nicht getrennt steuerbar)
** Somfy Oximo io
** Somfy RS100 io
** Somfy Izymo io
* Sichtschutz innen:
** VELUX FSK
** VELUX DML
* Fensteröffner mit integriertem Regensensor:
** VELUX KMG
** VELUX CVP
** VELUX KSX
** VELUX GPU
* Markisen:
** VELUX MSL
** VELUX MML
** Somfy Sunea io
** Somfy Maestria+ 50 io
* Raffstore
** Somfy (Winkelsteuerung der Lamellen möglich)

== Benutzung in FHEM ==
=== Vorbereitung ===
Bevor die Aktoren in FHEM verwendet werden können, müssen sie in der [[#Registrieren von Geräten an der KLF200-Box|KLF 200 angelernt]] werden.
Das geschieht über das WebUI der KLF 200, das über einen Wifi-Hotspot erreichbar ist. Dieser Vorgang ist im Handbuch beschrieben.
Im WebUI können die angeschlossenen Geräte auch benannt werden. Zusätzlich hat man die Möglichkeit, Programme (Szenen) aufzuzeichnen,
um ein oder mehrere Geräte in eine definierte Position zu bringen. Diese Szenen kann man aus FHEM ebenfalls ansteuern.

Das Modul wird momentan noch nicht über FHEM ausgeliefert.
Es wird wie folgt geladen und aktualisiert:

:<code>update all <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>
:<code>shutdown restart</code>

Mit diesem Befehl wird das Modul so eingerichtet, dass es ebenfalls aktualisiert wird, wenn man FHEM aktualisiert:
:<code>update add <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>

=== Anlegen der Geräte ===
:<code>define <name> KLF200 <host></code>
Beispiel:
:<code>define Velux KLF200 192.168.0.66</code>

Danach Login durch Eingabe des Passwortes:
:<code>set <name> login <password></code>

Hinweis: Das Passwort ist laut Dokumentation das Wifi-Passwort, das auf den Boden der Box gedruckt ist.
Das funktioniert bei einigen Nutzern. Bei vielen Nutzern funktioniert hingegen das Passwort des WebUI.
Scheinbar hängt das davon ab, mit welcher Firmware die Box ausgeliefert wurde und ob schon einmal ein Reset durchgeführt wurde.
Das Passwort wird verschleiert im FHEM-Backend gespeichert. Es muss nach erfolgreichem Login nicht mehr eingegeben werden.

Die angeschlossenen Aktoren werden jetzt durch autocreate als Instanzen von KLF200Node im Raum KLF200Node angelegt.
Die Namen der Geräte folgen dem Muster <name>_<NodeID>.
Wurde im WebUI der KLF200 ein Name für das Gerät vergeben dann wird dieser als Alias übernommen.

Die Geräte sind jetzt einsatzbereit.

== Modul KLF200 ==
=== Verbindungsstatus ===
==== STATE ====
Im STATE des Moduls sieht man den aktuellen Verbindungsstatus. Im Idealfall ist er nach der Initialisierung Logged in.
=== Ausführung von Programmen (Szenen) ===
Obwohl man mit dem Modul KLF200Node jedes Gerät unabhängig und auch gleichzeitig steuern kann, sind Szenen eine nützliche Ergänzung. So kann man mit Szenen wie "Alle zu" oder "Alle auf" viele Geräte gleichzeitig mit einem Befehl bedienen.

Hinweis: Während der Abarbeitung einer Szene werden weitere Befehle gepuffert.
==== scene/sceneID ====
Mit diesen Set-Funktionen kann man eine aufgezeichnete Szene aufrufen.
Im entsprechenden Reading steht die zuletzt aufgerufene Szene.

Die Zuordnung zwischen sceneID und scene sieht man in den Internals unter scenes.

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Bei vielen aktuellen Geräten lässt sich die Ausführungsgeschwindigkeit (Velocity) variieren. So lässt sich die Geschwindigkeit gegenüber der Default-Geschwindigkeit noch erhöhen oder auch deutlich reduzieren. So ist eine besonders leise Bedienung möglich.

==== Argument DEFAULT, FAST, SILENT ====
Die Velocity kann man bei der Ausführung von Szenen als zusätzliches Argument von set scene oder set sceneID setzen.
Unterstützte Werte sind DEFAULT, FAST und SILENT
:<code>set Velux scene "Alle zu" SILENT</code>
==== Attribut velocity ====
Alternativ kann man im Modul KLF200 das Attribut velocity setzen, das bei der Ausführung von Szenen herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

Hinweis: Dieses Attribut hat keine Auswirkungen auf Befehle, die vom Modul KLF200Node abgesetzt werden.

== Modul KLF200Node ==
Dieses Modul wurde dem Homematic-Modul CUL_HM nachempfunden, da es ebenfalls ein breites Spektrum an Geräten unterstützt
und möglichst kompatibel zu vorhandenen Hilfsmodulen sein soll.
=== Aktueller Status ===
Im Folgenden wird der Zusammenhang zwischen den wichtigsten Readings/Set-Funktionen pct, state, execution erklärt.
==== pct ====
Dieses Reading enthält den aktuell bekannten Status des Gerätes in Prozent.

Wird das Gerät über die KLF-200-Box gesteuert, wird das Reading beim Erreichen der Zielposition sofort aktualisiert.

Wird das Gerät über eine Fernbedienung oder einen Sensor gesteuert, kann sich die Aktualisierung wenige Minuten verzögern.

Mit der Set-Funktion kann man das Gerät in diesen Status versetzen.
Per Default entspricht 100 auf der Fernbedienung oben und 0 unten.
==== state ====
Dieses Reading entspricht dem Reading pct, mit der Ausnahme, dass 0 durch '''off''' ersetzt wird und 100 durch '''on'''.

Die Set-Funktion funktioniert analog.
Per Default entspricht on auf der Fernbedienung oben und off unten.

Es werden die '''set extensions''' unterstützt. Damit können mit einem Set ein oder mehrere Befehle zeitgesteuert abgesetzt werden.

Doku: [https://fhem.de/commandref_DE.html#set set extensions in der commandref] und im [[DevelopmentModuleIntro#X_Set]] jeweils etwas weiter unten.

==== execution ====
Dieses Reading gibt den aktuellen Ausführungsstatus wieder. Die meiste Zeit ist der Wert stop.
Wird gerade ein Befehl ausgeführt, ist der Wert up oder down.

Mit der Set-Funktion werden entsprechende Befehle ausgeführt, up entspricht auf der Fernbedienung oben und down unten.
Bei stop wird die aktuelle Ausführung angehalten.

==== Attribut directionOn ====
Wie oben beschrieben, entspricht per Default on = 100 = up.

Das kann bei bestimmten Geräten für manchen Nutzer verwirrend sein.
Wenn man z.B. bei einem Rollladen lieber im geschlossenen Zustand 100 Prozent sehen möchte, dann setzt man das Attribut directionOn, z.B.
:<code>attr Velux_2 directionOn down</code>

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Wie bei Szenen lässt sich auch bei Kommandos auf KLF200Node die Ausführungsgeschwindigkeit beeinflussen, soweit das vom Gerät unterstützt ist.
==== Reading velocity ====
Dieses Reading hat den Wert supported, wenn die Geschwindigkeit bei diesem Gerät geändert werden kann.
Selbst bei Not supported wäre es einen Versuch wert, es zu testen.
==== Argument DEFAULT, FAST, SILENT ====
Alle set-Funktionen, die eine Bewegung auslösen unterstützen das optionale Argument DEFAULT, FAST oder SILENT.
==== Attribut velocity ====
Alternativ kann man im Modul KLF200Node das Attribut velocity setzen, das bei der Ausführung von Kommandos herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

=== Raw-Befehle zum Testen von unbekannten Geräten ===
Die bisher beschriebenen Funktionen des KLF200Node-Moduls bieten einen vereinfachten Zugang zu io-homecontrol-Geräten mit nur einem Motor.

Intern wird bei diesen Funktionen der Main Parameter (MP) für die Steuerung des Motors und der Functional Parameter 1 (FP1) für die Velocity gesetzt.
Theoretisch können Geräte bis zu 16 Functional Parameter (FP1 bis FP16) haben. Der Wertebereich aller Parameter ist 0 - 65535, wobei sich 0 - 100% auf 0 - 51200 abbilden.

'''Für Experten''' bietet die Funktion '''set raw''' die Möglichkeit, mehrere Parameter gleichzeitig zu setzen. Damit lassen sich dann z.B. die Lamellen von Raffstores bewegen.
Zuvor wird empfohlen, in der [https://velcdn.azureedge.net/~/media/com/api/klf200/technical%20specification%20for%20klf%20200%20api-ver3-16.pdf KLF 200 API] die folgenden Kapitel zu lesen:
* 10.1.1 GW_COMMAND_SEND_REQ
* 10.1.1.4 ParameterActive parameter
* 13 Appendix 1: Standard Parameter definition
* 14 Appendix 2: List of actuator types and their use of Main Parameter and Functional Parameters

Beispiel-Aufrufe:
:<code>set Velux_1 raw MP=51200</code>
:<code>set Velux_2 raw MP=0 FP1=51200</code>
:<code>set Velux_3 raw ParameterActive=3 FP3=25600 FP2=51200</code>
Winkelsteuerung Somfy Raffstore:
:<code>set Velux_4 raw ParameterActive=3 FP3=0</code>
:<code>set Velux_4 raw ParameterActive=3 FP3=51200</code>

Beim Aufruf muss man sich für einen Parameter entscheiden, von dem man Feedback erhalten will. Diesen wählt man mit ParameterActive aus. Default ist ParameterActive=0 für MP. Ein Functional Parameter kann mit 1 - 16 ausgewählt werden.
Die aktuell bekannten Werte stehen in den Readings MP und FP1 bis FP16, wobei nur Readings für tatsächlich genutzte Parameter angelegt werden.

Die Funktion '''set updateCurrentPosition''' aktualisiert die Readings MP und FP1 - FP7, falls vorhanden.

Beispiele für Geräte mit mehreren Motoren:
* Somfy J4 io Protect
* evtl. VELUX SMG Doppelrollladen

Wenn sich Nutzer melden sollten, die auf diese Weise Geräte mit mehreren Motoren getestet haben, dann kann entschieden werden, wie dieses Modul auf sinnvolle Weise weiterentwickelt werden kann.

=== Begrenzung des Bewegungsradius / Limitation ===
Die io-homecontrol Geräte haben ein Feature eingebaut, um den Bewegungsradius der Geräte einzuschränken, egal von wo aus sie gesteuert werden. Dieses Limitation-Feature ist in dieses FHEM-Modul ebenfalls integriert.
==== limitationMin und limitationMax ====
Mit den Settern und Readings limitationMin und limitationMax kann man die Limitation setzen und auslesen.
Natürlich kann man auch selbst von der Limitation Gebrauch machen. Man kann z.B. einen Rollladen begrenzen, wenn man weiß, dass das Dachfenster weit offen ist. Dann kann der Rollladen nicht gegen das Fenster stoßen, selbst wenn man ihn mit der Fernbedienung bewegt.
==== limiationClear ====
Mit dem Setter limiationClear kann man alle Limitations (auch von fremden Geräten ausgelöste) löschen.
==== updateLimiation ====
Der Setter updateLimiation aktualisiert die Readings limitationMin und limitationMax auf diesem Gerät, falls die Limitation außerhalb von FHEM gesetzt wurde.

=== Auswerten der Regensensoren ===
Die Regensensoren von Velux Fensteröffnern machen von diesem Limitation-Feature Gebrauch. Wenn es regnet, wird der Bewegungsradius der Fenster eingeschränkt. Zum Beispiel (evtl. Geräte-abhängig):
* limitationMax = 7 bei Regen (0 bei Velux GPU Fenstern),
* limitationMax = 100 wenn es aufhört.
Diese Werte kann man auslesen, ohne dass sich das Fenster dazu bewegt haben muss.

==== limitationUpdateInterval ====
Mit set limitationUpdateInterval kann man festlegen, wie oft diese Werte ausgelesen werden:
* off: Dieser Wert ist für Geräte ohne integrierte Sensoren der Beste, denn zusätzliche Updates sind überflüssig.
* onChange: Hier wird limitationMin und limitationMax aktualisiert, wenn das Gerät bewegt wurde.
* interval in s: Ein Poll-Intervall in Sekunden. Tests mit 120 sind erfolgreich durchgelaufen. Dieser Wert ist vielleicht etwas übertrieben, man denke an das Funkfeuer und den Akku der Geräte. Ein Intervall von 600 ist vielleicht sinnvoller. Beispiele:
:<code>set Velux_1 limitationUpdateInterval off</code>
:<code>set Velux_2 limitationUpdateInterval onChange</code>
:<code>set Velux_3 limitationUpdateInterval 600</code>

==== Extra Reading für den Regensensor ====
Wem die Auswertung vom Reading limitationMax zu indirekt ist, der kann sich ein neues Reading anlegen.
Der folgende Code legt ein Reading namens sensor an, die Werte sind im Beispiel "Regen" oder "trocken".
Es besteht die Annahme, dass bei limitationMax = 7 der Regensensor angeschlagen hat.
:<code>attr Velux_3 userReadings sensor {(ReadingsVal($name,"limitationMax",100) == 7)?"Regen":"trocken"}</code>
Hinweis: Das neue Reading sensor erscheint erst, wenn das Reading limitationMax einmal aktualisiert wurde.

== Vorschläge zur schöneren Darstellung ==
Wie Homematic-Geräte kommt KLF200Node im FHEM-Web sehr schlicht daher. Dieses Kapitel gibt Vorschläge zur Konfiguration einer schöneren Darstellung.

=== Rollladen ===
Dieses Beispiel stellt den Status des Rollladen 10-Prozent genau im Icon dar. Bewegen sich der Rollladen, hat das Icon einen Pfeil nach oben oder unten. Ein Klick auf das Icon setzt den Rollladen in Bewegung oder hält ihn an (toggle).

:<code>attr Velux_2 stateFormat pct execution</code>
:<code>attr Velux_2 devStateIcon .*up:fts_shutter_up:toggle .*down:fts_shutter_down:toggle \d.stop:fts_shutter_100:toggle 1\d.stop:fts_shutter_90:toggle 2\d.stop:fts_shutter_80:toggle 3\d.stop:fts_shutter_70:toggle 4\d.stop:fts_shutter_60:toggle 5\d.stop:fts_shutter_50:toggle 6\d.stop:fts_shutter_40:toggle 7\d.stop:fts_shutter_30:toggle 8\d.stop:fts_shutter_20:toggle 9\d.stop:fts_shutter_10:toggle 100.stop:fts_window_2w:toggle</code>
[[Datei:RollerShutterUpDown.png|300px|Rollladen mit Pfeilen]]

So erhält man einen Slider für die Rollladenposition:

:<code>attr Velux_2 webCmd pct</code>

=== Dachschrägenfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachschrägenfenster in drei Stufen dar:

0% - 9%: geschlossen

10% - 59%: halb geöffnet

60% - 100%: ganz geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_4 limitationUpdateInterval 600</code>
:<code>attr Velux_4 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_4 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7\).*:weather_rain:toggle \d.$.*:fts_window_roof:toggle [1-5]\d.\(.*:fts_window_roof_open_1:toggle [6-9]\d.\(.*:fts_window_roof_open_2:toggle 100.\(.*:fts_window_roof_open_2:toggle</code>

=== Dachkuppelfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachkuppelfenster in zwei Stufen dar:

0% - 9%: geschlossen

10% - 100%: geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_5 limitationUpdateInterval 600</code>
:<code>attr Velux_5 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_5 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7$.*:weather_rain:toggle \d.\(.*:fts_light_dome:toggle [1-9]\d.\(.*:fts_light_dome_open:toggle 100.\(.*:fts_light_dome_open:toggle</code>

== Problembehebung ==
=== Verbindungsabbrüche ===
Sollte es zu Verbindungsabbrüchen zwischen FHEM und der KLF200-Box kommen, dann sind folgende Dinge zu überprüfen:
==== FHEM Update ====
Ist FHEM aktuell? Am 18.12.2018 gab es ein wichtiges FHEM-Update, das die Stabilität von SSL-Verbindungen wesentlich verbessert hat.
==== OpenSSL ====
OpenSLL sollte immer aktuell sein.
==== Perl SSL-Bibliotheken ====
Wenn die Perl SSL-Bibliotheken zu alt sind, ist das oben genannte FHEM-Update wirkungslos.
* IO::Socket::SSL
* Net::SSL
* Net::SSLeay
* Net::SSLeay::Handle
* Crypt::SSLeay
* Net::Server::Proto::SSL

=== Registrieren von Geräten an der KLF200-Box ===

Die [https://velcdn.azureedge.net/~/media/marketing/ch/fachleute/einbauanleitungen/elektro-nachrustung/zubehor/klf-200_bedienungsanleitung_basic%20de.pdf KLF200-Dokumentation] Seite 11 - 19 beschreibt 2 Varianten, um Geräte mit der Box zu koppeln.

==== 1. Registrierung mit einer Zweiweg-Bedienung ====
Dieser Weg funktioniert über die Schlüssel-Taste oder im Web-UI über PRODUKTE KOPIEREN.

Es ist eine Zweiweg-Bedienung erforderlich, die in der Lage ist, die IO-Schlüssel zu exportieren.

Dieser Weg geht z.B. mit dem Control Pad KLR200, Somfy TaHoma, [https://www.somfy.de/hilfe-center/faq/wie-binde-ich-produkte-ein-die-bereits-mit-einem-2-wege-sender-angesteuert-werden Nina io, Telis Composio io, Impresario Chronis io, Easy Sun io und Telis 1 io.].

TaHoma: anmelden, Menü "Sicherheitseinstellungen", Reiter "io-System", "SICHERHEITSSCHLÜSSEL SENDEN"

==== 2. Registrierung mit einer Einweg-Bedienung ====
Dieser Weg funktioniert über die Reset-Taste oder im Web-UI über PRODUKTSUCHE.

Hierzu wird das Gerät über eine Fernbedienung oder direkt am Gerät in einen Anlernzustand versetzt und dann einigen sich KLF200 und das Gerät über einen Schlüssel.

Bei manchen Somfy-Geräten scheint dieser Weg nicht zu funktionieren, z.B. einige Somfy Smoove Produkte. Hier bleibt nur die Möglichkeit, die Schlüssel wie in Variante 1 von einer Somfy Zweiweg-Bedienung zu kopieren.

=== WARNUNG vor Reset der KLF200-Box! ===
Sollten an der KLF200-Box schon Geräte registriert sein, dann ist ein Factory-Reset unbedingt zu vermeiden!
Die Geräte, die mit der KLF200 bereits Schlüssel ausgetauscht haben, lassen sich nicht ohne weiteres noch einmal registrieren.
Um diese Geräte nach einem Reset der KLF200 trotzdem zu registrieren, sind folgende Schritte notwendig:
# Die registrierten Geräte müssen komplett zurückgesetzt werden.
# Die entsprechenden Fernbedienungen müssen neu angelernt werden.
# Die Geräte können an der KLF200-Box registriert werden.

== Links ==
* Support im Forum gibt es unter {{Link2Forum|Topic=92907|LinkText=Velux KLF200 mit Firmware 2.0.0.71 für io-homecontrol}}
* Github: [https://github.com/buennerbernd/fhem/tree/master/KLF200/2.0 FHEM modules KLF200 and KLF200Node]

[[Kategorie:Rollladensteuerung]]
[[Kategorie:io-homecontrol]]
[[Kategorie:Other Components]]

Velux KLF200

2020-08-26T09:52:49Z

Buennerbernd: /* Raw-Befehle zum Testen von unbekannten Geräten */

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Anbindung io-homecontrol Aktoren an FHEM
|ModType=x
|ModCmdRef=KLF200
|ModFTopic=92907
|ModTechName=83_KLF200.pm
|ModOwner=buennerbernd ({{Link2FU|21440|Forum}} / [[Benutzer Diskussion:Buennerbernd|Wiki]])
}}

'''KLF200''' ist ein Modul zur Steuerung von '''io-homecontrol''' Aktoren über das Gateway Velux KLF 200.

== Velux KLF 200 ==

Die KLF-200-Box ist über LAN mit FHEM verbunden und steuert die Aktoren über das verschlüsselte Funkprotokoll ''io-homecontrol''.
Die Aktoren geben Rückmeldung über ihren aktuellen Zustand.

Die Box hat 10 elektrische Eingänge mit denen man 5 Geräte oder Gerätegruppen steuern kann.
Damit kann man z.B. mit Doppeltastern an der Wand seine Rollladen oder Fenster steuern.
Über den LAN-Anschluss lassen sich mit FHEM bis zu 200 Geräte mit einer KLF 200 verwalten.

Das Modul erfordert die Firmware-Version 2.0.0.71 und basiert auf der dokumentierten API von Velux. [https://www.velux.com/api/klf200 Download und weitere Informationen]

Das Gateway hat keine Cloud-Integration.

== Unterstützte Geräte ==

Grundsätzlich sollten alle io-homecontrol Aktoren funktionieren. Alleinstehende Sensoren (z.B. Lichtsensor, Windsensor) werden
von der KLF-200-Box nicht unterstützt. Es besteht aber die Möglichkeit, den Status von Sensoren auszuwerten, die in Aktoren integriert sind.

Aktuell werden folgende Geräte erfolgreich mit diesem Modul verwendet:

* Rollladen:
** VELUX SML
** VELUX SSL
** VELUX SMG (Doppelrollladen noch nicht getrennt steuerbar)
** Somfy Oximo io
** Somfy RS100 io
** Somfy Izymo io
* Sichtschutz innen:
** VELUX FSK
** VELUX DML
* Fensteröffner mit integriertem Regensensor:
** VELUX KMG
** VELUX CVP
** VELUX KSX
** VELUX GPU
* Markisen:
** VELUX MSL
** VELUX MML
** Somfy Sunea io
** Somfy Maestria+ 50 io
* Raffstore
** Somfy (Winkelsteuerung der Lamellen möglich)

== Benutzung in FHEM ==
=== Vorbereitung ===
Bevor die Aktoren in FHEM verwendet werden können, müssen sie in der [[#Registrieren von Geräten an der KLF200-Box|KLF 200 angelernt]] werden.
Das geschieht über das WebUI der KLF 200, das über einen Wifi-Hotspot erreichbar ist. Dieser Vorgang ist im Handbuch beschrieben.
Im WebUI können die angeschlossenen Geräte auch benannt werden. Zusätzlich hat man die Möglichkeit, Programme (Szenen) aufzuzeichnen,
um ein oder mehrere Geräte in eine definierte Position zu bringen. Diese Szenen kann man aus FHEM ebenfalls ansteuern.

Das Modul wird momentan noch nicht über FHEM ausgeliefert.
Es wird wie folgt geladen und aktualisiert:

:<code>update all <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>
:<code>shutdown restart</code>

Mit diesem Befehl wird das Modul so eingerichtet, dass es ebenfalls aktualisiert wird, wenn man FHEM aktualisiert:
:<code>update add <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>

=== Anlegen der Geräte ===
:<code>define <name> KLF200 <host></code>
Beispiel:
:<code>define Velux KLF200 192.168.0.66</code>

Danach Login durch Eingabe des Passwortes:
:<code>set <name> login <password></code>

Hinweis: Das Passwort ist laut Dokumentation das Wifi-Passwort, das auf den Boden der Box gedruckt ist.
Das funktioniert bei einigen Nutzern. Bei vielen Nutzern funktioniert hingegen das Passwort des WebUI.
Scheinbar hängt das davon ab, mit welcher Firmware die Box ausgeliefert wurde und ob schon einmal ein Reset durchgeführt wurde.
Das Passwort wird verschleiert im FHEM-Backend gespeichert. Es muss nach erfolgreichem Login nicht mehr eingegeben werden.

Die angeschlossenen Aktoren werden jetzt durch autocreate als Instanzen von KLF200Node im Raum KLF200Node angelegt.
Die Namen der Geräte folgen dem Muster <name>_<NodeID>.
Wurde im WebUI der KLF200 ein Name für das Gerät vergeben dann wird dieser als Alias übernommen.

Die Geräte sind jetzt einsatzbereit.

== Modul KLF200 ==
=== Verbindungsstatus ===
==== STATE ====
Im STATE des Moduls sieht man den aktuellen Verbindungsstatus. Im Idealfall ist er nach der Initialisierung Logged in.
=== Ausführung von Programmen (Szenen) ===
Obwohl man mit dem Modul KLF200Node jedes Gerät unabhängig und auch gleichzeitig steuern kann, sind Szenen eine nützliche Ergänzung. So kann man mit Szenen wie "Alle zu" oder "Alle auf" viele Geräte gleichzeitig mit einem Befehl bedienen.

Hinweis: Während der Abarbeitung einer Szene werden weitere Befehle gepuffert.
==== scene/sceneID ====
Mit diesen Set-Funktionen kann man eine aufgezeichnete Szene aufrufen.
Im entsprechenden Reading steht die zuletzt aufgerufene Szene.

Die Zuordnung zwischen sceneID und scene sieht man in den Internals unter scenes.

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Bei vielen aktuellen Geräten lässt sich die Ausführungsgeschwindigkeit (Velocity) variieren. So lässt sich die Geschwindigkeit gegenüber der Default-Geschwindigkeit noch erhöhen oder auch deutlich reduzieren. So ist eine besonders leise Bedienung möglich.

==== Argument DEFAULT, FAST, SILENT ====
Die Velocity kann man bei der Ausführung von Szenen als zusätzliches Argument von set scene oder set sceneID setzen.
Unterstützte Werte sind DEFAULT, FAST und SILENT
:<code>set Velux scene "Alle zu" SILENT</code>
==== Attribut velocity ====
Alternativ kann man im Modul KLF200 das Attribut velocity setzen, das bei der Ausführung von Szenen herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

Hinweis: Dieses Attribut hat keine Auswirkungen auf Befehle, die vom Modul KLF200Node abgesetzt werden.

== Modul KLF200Node ==
Dieses Modul wurde dem Homematic-Modul CUL_HM nachempfunden, da es ebenfalls ein breites Spektrum an Geräten unterstützt
und möglichst kompatibel zu vorhandenen Hilfsmodulen sein soll.
=== Aktueller Status ===
Im Folgenden wird der Zusammenhang zwischen den wichtigsten Readings/Set-Funktionen pct, state, execution erklärt.
==== pct ====
Dieses Reading enthält den aktuell bekannten Status des Gerätes in Prozent.

Wird das Gerät über die KLF-200-Box gesteuert, wird das Reading beim Erreichen der Zielposition sofort aktualisiert.

Wird das Gerät über eine Fernbedienung oder einen Sensor gesteuert, kann sich die Aktualisierung wenige Minuten verzögern.

Mit der Set-Funktion kann man das Gerät in diesen Status versetzen.
Per Default entspricht 100 auf der Fernbedienung oben und 0 unten.
==== state ====
Dieses Reading entspricht dem Reading pct, mit der Ausnahme, dass 0 durch '''off''' ersetzt wird und 100 durch '''on'''.

Die Set-Funktion funktioniert analog.
Per Default entspricht on auf der Fernbedienung oben und off unten.

Es werden die '''set extensions''' unterstützt. Damit können mit einem Set ein oder mehrere Befehle zeitgesteuert abgesetzt werden.

Doku: [https://fhem.de/commandref_DE.html#set set extensions in der commandref] und im [[DevelopmentModuleIntro#X_Set]] jeweils etwas weiter unten.

==== execution ====
Dieses Reading gibt den aktuellen Ausführungsstatus wieder. Die meiste Zeit ist der Wert stop.
Wird gerade ein Befehl ausgeführt, ist der Wert up oder down.

Mit der Set-Funktion werden entsprechende Befehle ausgeführt, up entspricht auf der Fernbedienung oben und down unten.
Bei stop wird die aktuelle Ausführung angehalten.

==== Attribut directionOn ====
Wie oben beschrieben, entspricht per Default on = 100 = up.

Das kann bei bestimmten Geräten für manchen Nutzer verwirrend sein.
Wenn man z.B. bei einem Rollladen lieber im geschlossenen Zustand 100 Prozent sehen möchte, dann setzt man das Attribut directionOn, z.B.
:<code>attr Velux_2 directionOn down</code>

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Wie bei Szenen lässt sich auch bei Kommandos auf KLF200Node die Ausführungsgeschwindigkeit beeinflussen, soweit das vom Gerät unterstützt ist.
==== Reading velocity ====
Dieses Reading hat den Wert supported, wenn die Geschwindigkeit bei diesem Gerät geändert werden kann.
Selbst bei Not supported wäre es einen Versuch wert, es zu testen.
==== Argument DEFAULT, FAST, SILENT ====
Alle set-Funktionen, die eine Bewegung auslösen unterstützen das optionale Argument DEFAULT, FAST oder SILENT.
==== Attribut velocity ====
Alternativ kann man im Modul KLF200Node das Attribut velocity setzen, das bei der Ausführung von Kommandos herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

=== Raw-Befehle zum Testen von unbekannten Geräten ===
Die bisher beschriebenen Funktionen des KLF200Node-Moduls bieten einen vereinfachten Zugang zu io-homecontrol-Geräten mit nur einem Motor.

Intern wird bei diesen Funktionen der Main Parameter (MP) für die Steuerung des Motors und der Functional Parameter 1 (FP1) für die Velocity gesetzt.
Theoretisch können Geräte bis zu 16 Functional Parameter (FP1 bis FP16) haben. Der Wertebereich aller Parameter ist 0 - 65535, wobei sich 0 - 100% auf 0 - 51200 abbilden.

'''Für Experten''' bietet die Funktion '''set raw''' die Möglichkeit, mehrere Parameter gleichzeitig zu setzen. Damit lassen sich dann z.B. die Lamellen von Raffstores bewegen.
Zuvor wird empfohlen, in der [https://velcdn.azureedge.net/~/media/com/api/klf200/technical%20specification%20for%20klf%20200%20api-ver3-16.pdf KLF 200 API] die folgenden Kapitel zu lesen:
* 10.1.1 GW_COMMAND_SEND_REQ
* 10.1.1.4 ParameterActive parameter
* 13 Appendix 1: Standard Parameter definition
* 14 Appendix 2: List of actuator types and their use of Main Parameter and Functional Parameters

Beispiel-Aufrufe:
:<code>set Velux_1 raw MP=51200</code>
:<code>set Velux_2 raw MP=0 FP1=51200</code>
:<code>set Velux_3 raw ParameterActive=3 FP3=25600 FP2=51200</code>
Winkelsteuerung Somfy Raffstore:
:<code>set Velux_4 raw ParameterActive=3 FP3=0</code>
:<code>set Velux_4 raw ParameterActive=3 FP3=51200</code>

Beim Aufruf muss man sich für einen Parameter entscheiden, von dem man Feedback erhalten will. Diesen wählt man mit ParameterActive aus. Default ist ParameterActive=0 für MP. Ein Functional Parameter kann mit 1 - 16 ausgewählt werden.
Die aktuell bekannten Werte stehen in den Readings MP und FP1 bis FP16, wobei nur Readings für tatsächlich genutzte Parameter angelegt werden.

Die Funktion '''set updateCurrentPosition''' aktualisiert die Readings MP und FP1 - FP7, falls vorhanden.

Beispiele für Geräte mit mehreren Motoren:
* Somfy J4 io Protect
* evtl. VELUX SMG Doppelrollladen

Wenn sich Nutzer melden sollten, die auf diese Weise Geräte mit mehreren Motoren getestet haben, dann kann entschieden werden, wie dieses Modul auf sinnvolle Weise weiterentwickelt werden kann.

=== Begrenzung des Bewegungsradius / Limitation ===
Die io-homecontrol Geräte haben ein Feature eingebaut, um den Bewegungsradius der Geräte einzuschränken, egal von wo aus sie gesteuert werden. Dieses Limitation-Feature ist in dieses FHEM-Modul ebenfalls integriert.
==== limitationMin und limitationMax ====
Mit den Settern und Readings limitationMin und limitationMax kann man die Limitation setzen und auslesen.
Natürlich kann man auch selbst von der Limitation Gebrauch machen. Man kann z.B. einen Rollladen begrenzen, wenn man weiß, dass das Dachfenster weit offen ist. Dann kann der Rollladen nicht gegen das Fenster stoßen, selbst wenn man ihn mit der Fernbedienung bewegt.
==== limiationClear ====
Mit dem Setter limiationClear kann man alle Limitations (auch von fremden Geräten ausgelöste) löschen.
==== updateLimiation ====
Der Setter updateLimiation aktualisiert die Readings limitationMin und limitationMax auf diesem Gerät, falls die Limitation außerhalb von FHEM gesetzt wurde.

=== Auswerten der Regensensoren ===
Die Regensensoren von Velux Fensteröffnern machen von diesem Limitation-Feature Gebrauch. Wenn es regnet, wird der Bewegungsradius der Fenster eingeschränkt. Zum Beispiel (evtl. Geräte-abhängig):
* limitationMax = 7 bei Regen,
* limitationMax = 100 wenn es aufhört.
Diese Werte kann man auslesen, ohne dass sich das Fenster dazu bewegt haben muss.

==== limitationUpdateInterval ====
Mit set limitationUpdateInterval kann man festlegen, wie oft diese Werte ausgelesen werden:
* off: Dieser Wert ist für Geräte ohne integrierte Sensoren der Beste, denn zusätzliche Updates sind überflüssig.
* onChange: Hier wird limitationMin und limitationMax aktualisiert, wenn das Gerät bewegt wurde.
* interval in s: Ein Poll-Intervall in Sekunden. Tests mit 120 sind erfolgreich durchgelaufen. Dieser Wert ist vielleicht etwas übertrieben, man denke an das Funkfeuer und den Akku der Geräte. Ein Intervall von 600 ist vielleicht sinnvoller. Beispiele:
:<code>set Velux_1 limitationUpdateInterval off</code>
:<code>set Velux_2 limitationUpdateInterval onChange</code>
:<code>set Velux_3 limitationUpdateInterval 600</code>

==== Extra Reading für den Regensensor ====
Wem die Auswertung vom Reading limitationMax zu indirekt ist, der kann sich ein neues Reading anlegen.
Der folgende Code legt ein Reading namens sensor an, die Werte sind im Beispiel "Regen" oder "trocken".
Es besteht die Annahme, dass bei limitationMax = 7 der Regensensor angeschlagen hat.
:<code>attr Velux_3 userReadings sensor {(ReadingsVal($name,"limitationMax",100) == 7)?"Regen":"trocken"}</code>
Hinweis: Das neue Reading sensor erscheint erst, wenn das Reading limitationMax einmal aktualisiert wurde.

== Vorschläge zur schöneren Darstellung ==
Wie Homematic-Geräte kommt KLF200Node im FHEM-Web sehr schlicht daher. Dieses Kapitel gibt Vorschläge zur Konfiguration einer schöneren Darstellung.

=== Rollladen ===
Dieses Beispiel stellt den Status des Rollladen 10-Prozent genau im Icon dar. Bewegen sich der Rollladen, hat das Icon einen Pfeil nach oben oder unten. Ein Klick auf das Icon setzt den Rollladen in Bewegung oder hält ihn an (toggle).

:<code>attr Velux_2 stateFormat pct execution</code>
:<code>attr Velux_2 devStateIcon .*up:fts_shutter_up:toggle .*down:fts_shutter_down:toggle \d.stop:fts_shutter_100:toggle 1\d.stop:fts_shutter_90:toggle 2\d.stop:fts_shutter_80:toggle 3\d.stop:fts_shutter_70:toggle 4\d.stop:fts_shutter_60:toggle 5\d.stop:fts_shutter_50:toggle 6\d.stop:fts_shutter_40:toggle 7\d.stop:fts_shutter_30:toggle 8\d.stop:fts_shutter_20:toggle 9\d.stop:fts_shutter_10:toggle 100.stop:fts_window_2w:toggle</code>
[[Datei:RollerShutterUpDown.png|300px|Rollladen mit Pfeilen]]

So erhält man einen Slider für die Rollladenposition:

:<code>attr Velux_2 webCmd pct</code>

=== Dachschrägenfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachschrägenfenster in drei Stufen dar:

0% - 9%: geschlossen

10% - 59%: halb geöffnet

60% - 100%: ganz geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_4 limitationUpdateInterval 600</code>
:<code>attr Velux_4 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_4 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7\).*:weather_rain:toggle \d.$.*:fts_window_roof:toggle [1-5]\d.\(.*:fts_window_roof_open_1:toggle [6-9]\d.\(.*:fts_window_roof_open_2:toggle 100.\(.*:fts_window_roof_open_2:toggle</code>

=== Dachkuppelfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachkuppelfenster in zwei Stufen dar:

0% - 9%: geschlossen

10% - 100%: geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_5 limitationUpdateInterval 600</code>
:<code>attr Velux_5 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_5 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7$.*:weather_rain:toggle \d.\(.*:fts_light_dome:toggle [1-9]\d.\(.*:fts_light_dome_open:toggle 100.\(.*:fts_light_dome_open:toggle</code>

== Problembehebung ==
=== Verbindungsabbrüche ===
Sollte es zu Verbindungsabbrüchen zwischen FHEM und der KLF200-Box kommen, dann sind folgende Dinge zu überprüfen:
==== FHEM Update ====
Ist FHEM aktuell? Am 18.12.2018 gab es ein wichtiges FHEM-Update, das die Stabilität von SSL-Verbindungen wesentlich verbessert hat.
==== OpenSSL ====
OpenSLL sollte immer aktuell sein.
==== Perl SSL-Bibliotheken ====
Wenn die Perl SSL-Bibliotheken zu alt sind, ist das oben genannte FHEM-Update wirkungslos.
* IO::Socket::SSL
* Net::SSL
* Net::SSLeay
* Net::SSLeay::Handle
* Crypt::SSLeay
* Net::Server::Proto::SSL

=== Registrieren von Geräten an der KLF200-Box ===

Die [https://velcdn.azureedge.net/~/media/marketing/ch/fachleute/einbauanleitungen/elektro-nachrustung/zubehor/klf-200_bedienungsanleitung_basic%20de.pdf KLF200-Dokumentation] Seite 11 - 19 beschreibt 2 Varianten, um Geräte mit der Box zu koppeln.

==== 1. Registrierung mit einer Zweiweg-Bedienung ====
Dieser Weg funktioniert über die Schlüssel-Taste oder im Web-UI über PRODUKTE KOPIEREN.

Es ist eine Zweiweg-Bedienung erforderlich, die in der Lage ist, die IO-Schlüssel zu exportieren.

Dieser Weg geht z.B. mit dem Control Pad KLR200, Somfy TaHoma, [https://www.somfy.de/hilfe-center/faq/wie-binde-ich-produkte-ein-die-bereits-mit-einem-2-wege-sender-angesteuert-werden Nina io, Telis Composio io, Impresario Chronis io, Easy Sun io und Telis 1 io.].

TaHoma: anmelden, Menü "Sicherheitseinstellungen", Reiter "io-System", "SICHERHEITSSCHLÜSSEL SENDEN"

==== 2. Registrierung mit einer Einweg-Bedienung ====
Dieser Weg funktioniert über die Reset-Taste oder im Web-UI über PRODUKTSUCHE.

Hierzu wird das Gerät über eine Fernbedienung oder direkt am Gerät in einen Anlernzustand versetzt und dann einigen sich KLF200 und das Gerät über einen Schlüssel.

Bei manchen Somfy-Geräten scheint dieser Weg nicht zu funktionieren, z.B. einige Somfy Smoove Produkte. Hier bleibt nur die Möglichkeit, die Schlüssel wie in Variante 1 von einer Somfy Zweiweg-Bedienung zu kopieren.

=== WARNUNG vor Reset der KLF200-Box! ===
Sollten an der KLF200-Box schon Geräte registriert sein, dann ist ein Factory-Reset unbedingt zu vermeiden!
Die Geräte, die mit der KLF200 bereits Schlüssel ausgetauscht haben, lassen sich nicht ohne weiteres noch einmal registrieren.
Um diese Geräte nach einem Reset der KLF200 trotzdem zu registrieren, sind folgende Schritte notwendig:
# Die registrierten Geräte müssen komplett zurückgesetzt werden.
# Die entsprechenden Fernbedienungen müssen neu angelernt werden.
# Die Geräte können an der KLF200-Box registriert werden.

== Links ==
* Support im Forum gibt es unter {{Link2Forum|Topic=92907|LinkText=Velux KLF200 mit Firmware 2.0.0.71 für io-homecontrol}}
* Github: [https://github.com/buennerbernd/fhem/tree/master/KLF200/2.0 FHEM modules KLF200 and KLF200Node]

[[Kategorie:Rollladensteuerung]]
[[Kategorie:io-homecontrol]]
[[Kategorie:Other Components]]

Velux KLF200

2020-08-26T09:42:19Z

Buennerbernd: /* Unterstützte Geräte */

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Anbindung io-homecontrol Aktoren an FHEM
|ModType=x
|ModCmdRef=KLF200
|ModFTopic=92907
|ModTechName=83_KLF200.pm
|ModOwner=buennerbernd ({{Link2FU|21440|Forum}} / [[Benutzer Diskussion:Buennerbernd|Wiki]])
}}

'''KLF200''' ist ein Modul zur Steuerung von '''io-homecontrol''' Aktoren über das Gateway Velux KLF 200.

== Velux KLF 200 ==

Die KLF-200-Box ist über LAN mit FHEM verbunden und steuert die Aktoren über das verschlüsselte Funkprotokoll ''io-homecontrol''.
Die Aktoren geben Rückmeldung über ihren aktuellen Zustand.

Die Box hat 10 elektrische Eingänge mit denen man 5 Geräte oder Gerätegruppen steuern kann.
Damit kann man z.B. mit Doppeltastern an der Wand seine Rollladen oder Fenster steuern.
Über den LAN-Anschluss lassen sich mit FHEM bis zu 200 Geräte mit einer KLF 200 verwalten.

Das Modul erfordert die Firmware-Version 2.0.0.71 und basiert auf der dokumentierten API von Velux. [https://www.velux.com/api/klf200 Download und weitere Informationen]

Das Gateway hat keine Cloud-Integration.

== Unterstützte Geräte ==

Grundsätzlich sollten alle io-homecontrol Aktoren funktionieren. Alleinstehende Sensoren (z.B. Lichtsensor, Windsensor) werden
von der KLF-200-Box nicht unterstützt. Es besteht aber die Möglichkeit, den Status von Sensoren auszuwerten, die in Aktoren integriert sind.

Aktuell werden folgende Geräte erfolgreich mit diesem Modul verwendet:

* Rollladen:
** VELUX SML
** VELUX SSL
** VELUX SMG (Doppelrollladen noch nicht getrennt steuerbar)
** Somfy Oximo io
** Somfy RS100 io
** Somfy Izymo io
* Sichtschutz innen:
** VELUX FSK
** VELUX DML
* Fensteröffner mit integriertem Regensensor:
** VELUX KMG
** VELUX CVP
** VELUX KSX
** VELUX GPU
* Markisen:
** VELUX MSL
** VELUX MML
** Somfy Sunea io
** Somfy Maestria+ 50 io
* Raffstore
** Somfy (Winkelsteuerung der Lamellen möglich)

== Benutzung in FHEM ==
=== Vorbereitung ===
Bevor die Aktoren in FHEM verwendet werden können, müssen sie in der [[#Registrieren von Geräten an der KLF200-Box|KLF 200 angelernt]] werden.
Das geschieht über das WebUI der KLF 200, das über einen Wifi-Hotspot erreichbar ist. Dieser Vorgang ist im Handbuch beschrieben.
Im WebUI können die angeschlossenen Geräte auch benannt werden. Zusätzlich hat man die Möglichkeit, Programme (Szenen) aufzuzeichnen,
um ein oder mehrere Geräte in eine definierte Position zu bringen. Diese Szenen kann man aus FHEM ebenfalls ansteuern.

Das Modul wird momentan noch nicht über FHEM ausgeliefert.
Es wird wie folgt geladen und aktualisiert:

:<code>update all <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>
:<code>shutdown restart</code>

Mit diesem Befehl wird das Modul so eingerichtet, dass es ebenfalls aktualisiert wird, wenn man FHEM aktualisiert:
:<code>update add <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>

=== Anlegen der Geräte ===
:<code>define <name> KLF200 <host></code>
Beispiel:
:<code>define Velux KLF200 192.168.0.66</code>

Danach Login durch Eingabe des Passwortes:
:<code>set <name> login <password></code>

Hinweis: Das Passwort ist laut Dokumentation das Wifi-Passwort, das auf den Boden der Box gedruckt ist.
Das funktioniert bei einigen Nutzern. Bei vielen Nutzern funktioniert hingegen das Passwort des WebUI.
Scheinbar hängt das davon ab, mit welcher Firmware die Box ausgeliefert wurde und ob schon einmal ein Reset durchgeführt wurde.
Das Passwort wird verschleiert im FHEM-Backend gespeichert. Es muss nach erfolgreichem Login nicht mehr eingegeben werden.

Die angeschlossenen Aktoren werden jetzt durch autocreate als Instanzen von KLF200Node im Raum KLF200Node angelegt.
Die Namen der Geräte folgen dem Muster <name>_<NodeID>.
Wurde im WebUI der KLF200 ein Name für das Gerät vergeben dann wird dieser als Alias übernommen.

Die Geräte sind jetzt einsatzbereit.

== Modul KLF200 ==
=== Verbindungsstatus ===
==== STATE ====
Im STATE des Moduls sieht man den aktuellen Verbindungsstatus. Im Idealfall ist er nach der Initialisierung Logged in.
=== Ausführung von Programmen (Szenen) ===
Obwohl man mit dem Modul KLF200Node jedes Gerät unabhängig und auch gleichzeitig steuern kann, sind Szenen eine nützliche Ergänzung. So kann man mit Szenen wie "Alle zu" oder "Alle auf" viele Geräte gleichzeitig mit einem Befehl bedienen.

Hinweis: Während der Abarbeitung einer Szene werden weitere Befehle gepuffert.
==== scene/sceneID ====
Mit diesen Set-Funktionen kann man eine aufgezeichnete Szene aufrufen.
Im entsprechenden Reading steht die zuletzt aufgerufene Szene.

Die Zuordnung zwischen sceneID und scene sieht man in den Internals unter scenes.

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Bei vielen aktuellen Geräten lässt sich die Ausführungsgeschwindigkeit (Velocity) variieren. So lässt sich die Geschwindigkeit gegenüber der Default-Geschwindigkeit noch erhöhen oder auch deutlich reduzieren. So ist eine besonders leise Bedienung möglich.

==== Argument DEFAULT, FAST, SILENT ====
Die Velocity kann man bei der Ausführung von Szenen als zusätzliches Argument von set scene oder set sceneID setzen.
Unterstützte Werte sind DEFAULT, FAST und SILENT
:<code>set Velux scene "Alle zu" SILENT</code>
==== Attribut velocity ====
Alternativ kann man im Modul KLF200 das Attribut velocity setzen, das bei der Ausführung von Szenen herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

Hinweis: Dieses Attribut hat keine Auswirkungen auf Befehle, die vom Modul KLF200Node abgesetzt werden.

== Modul KLF200Node ==
Dieses Modul wurde dem Homematic-Modul CUL_HM nachempfunden, da es ebenfalls ein breites Spektrum an Geräten unterstützt
und möglichst kompatibel zu vorhandenen Hilfsmodulen sein soll.
=== Aktueller Status ===
Im Folgenden wird der Zusammenhang zwischen den wichtigsten Readings/Set-Funktionen pct, state, execution erklärt.
==== pct ====
Dieses Reading enthält den aktuell bekannten Status des Gerätes in Prozent.

Wird das Gerät über die KLF-200-Box gesteuert, wird das Reading beim Erreichen der Zielposition sofort aktualisiert.

Wird das Gerät über eine Fernbedienung oder einen Sensor gesteuert, kann sich die Aktualisierung wenige Minuten verzögern.

Mit der Set-Funktion kann man das Gerät in diesen Status versetzen.
Per Default entspricht 100 auf der Fernbedienung oben und 0 unten.
==== state ====
Dieses Reading entspricht dem Reading pct, mit der Ausnahme, dass 0 durch '''off''' ersetzt wird und 100 durch '''on'''.

Die Set-Funktion funktioniert analog.
Per Default entspricht on auf der Fernbedienung oben und off unten.

Es werden die '''set extensions''' unterstützt. Damit können mit einem Set ein oder mehrere Befehle zeitgesteuert abgesetzt werden.

Doku: [https://fhem.de/commandref_DE.html#set set extensions in der commandref] und im [[DevelopmentModuleIntro#X_Set]] jeweils etwas weiter unten.

==== execution ====
Dieses Reading gibt den aktuellen Ausführungsstatus wieder. Die meiste Zeit ist der Wert stop.
Wird gerade ein Befehl ausgeführt, ist der Wert up oder down.

Mit der Set-Funktion werden entsprechende Befehle ausgeführt, up entspricht auf der Fernbedienung oben und down unten.
Bei stop wird die aktuelle Ausführung angehalten.

==== Attribut directionOn ====
Wie oben beschrieben, entspricht per Default on = 100 = up.

Das kann bei bestimmten Geräten für manchen Nutzer verwirrend sein.
Wenn man z.B. bei einem Rollladen lieber im geschlossenen Zustand 100 Prozent sehen möchte, dann setzt man das Attribut directionOn, z.B.
:<code>attr Velux_2 directionOn down</code>

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Wie bei Szenen lässt sich auch bei Kommandos auf KLF200Node die Ausführungsgeschwindigkeit beeinflussen, soweit das vom Gerät unterstützt ist.
==== Reading velocity ====
Dieses Reading hat den Wert supported, wenn die Geschwindigkeit bei diesem Gerät geändert werden kann.
Selbst bei Not supported wäre es einen Versuch wert, es zu testen.
==== Argument DEFAULT, FAST, SILENT ====
Alle set-Funktionen, die eine Bewegung auslösen unterstützen das optionale Argument DEFAULT, FAST oder SILENT.
==== Attribut velocity ====
Alternativ kann man im Modul KLF200Node das Attribut velocity setzen, das bei der Ausführung von Kommandos herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

=== Raw-Befehle zum Testen von unbekannten Geräten ===
Die bisher beschriebenen Funktionen des KLF200Node-Moduls bieten einen vereinfachten Zugang zu io-homecontrol-Geräten mit nur einem Motor.

Intern wird bei diesen Funktionen der Main Parameter (MP) für die Steuerung des Motors und der Functional Parameter 1 (FP1) für die Velocity gesetzt.
Theoretisch können Geräte bis zu 16 Functional Parameter (FP1 bis FP16) haben. Der Wertebereich aller Parameter ist 0 - 65535, wobei sich 0 - 100% auf 0 - 51200 abbilden.

'''Für Experten''' bietet die Funktion '''set raw''' die Möglichkeit, mehrere Parameter gleichzeitig zu setzen. Damit lassen sich dann z.B. die Lamellen von Raffstores bewegen.
Zuvor wird empfohlen, in der [https://velcdn.azureedge.net/~/media/com/api/klf200/technical%20specification%20for%20klf%20200%20api-ver3-16.pdf KLF 200 API] die folgenden Kapitel zu lesen:
* 10.1.1 GW_COMMAND_SEND_REQ
* 10.1.1.4 ParameterActive parameter
* 13 Appendix 1: Standard Parameter definition
* 14 Appendix 2: List of actuator types and their use of Main Parameter and Functional Parameters

Beispiel-Aufrufe:
:<code>set Velux_1 raw MP=51200</code>
:<code>set Velux_2 raw MP=0 FP1=51200</code>
:<code>set Velux_3 raw ParameterActive=3 FP3=25600 FP2=51200</code>

Beim Aufruf muss man sich für einen Parameter entscheiden, von dem man Feedback erhalten will. Diesen wählt man mit ParameterActive aus. Default ist ParameterActive=0 für MP. Ein Functional Parameter kann mit 1 - 16 ausgewählt werden.
Die aktuell bekannten Werte stehen in den Readings MP und FP1 bis FP16, wobei nur Readings für tatsächlich genutzte Parameter angelegt werden.

Die Funktion '''set updateCurrentPosition''' aktualisiert die Readings MP und FP1 - FP7, falls vorhanden.

Beispiele für Geräte mit mehreren Motoren:
* Somfy J4 io Protect
* evtl. VELUX SMG Doppelrollladen

Wenn sich Nutzer melden sollten, die auf diese Weise Geräte mit mehreren Motoren getestet haben, dann kann entschieden werden, wie dieses Modul auf sinnvolle Weise weiterentwickelt werden kann.

=== Begrenzung des Bewegungsradius / Limitation ===
Die io-homecontrol Geräte haben ein Feature eingebaut, um den Bewegungsradius der Geräte einzuschränken, egal von wo aus sie gesteuert werden. Dieses Limitation-Feature ist in dieses FHEM-Modul ebenfalls integriert.
==== limitationMin und limitationMax ====
Mit den Settern und Readings limitationMin und limitationMax kann man die Limitation setzen und auslesen.
Natürlich kann man auch selbst von der Limitation Gebrauch machen. Man kann z.B. einen Rollladen begrenzen, wenn man weiß, dass das Dachfenster weit offen ist. Dann kann der Rollladen nicht gegen das Fenster stoßen, selbst wenn man ihn mit der Fernbedienung bewegt.
==== limiationClear ====
Mit dem Setter limiationClear kann man alle Limitations (auch von fremden Geräten ausgelöste) löschen.
==== updateLimiation ====
Der Setter updateLimiation aktualisiert die Readings limitationMin und limitationMax auf diesem Gerät, falls die Limitation außerhalb von FHEM gesetzt wurde.

=== Auswerten der Regensensoren ===
Die Regensensoren von Velux Fensteröffnern machen von diesem Limitation-Feature Gebrauch. Wenn es regnet, wird der Bewegungsradius der Fenster eingeschränkt. Zum Beispiel (evtl. Geräte-abhängig):
* limitationMax = 7 bei Regen,
* limitationMax = 100 wenn es aufhört.
Diese Werte kann man auslesen, ohne dass sich das Fenster dazu bewegt haben muss.

==== limitationUpdateInterval ====
Mit set limitationUpdateInterval kann man festlegen, wie oft diese Werte ausgelesen werden:
* off: Dieser Wert ist für Geräte ohne integrierte Sensoren der Beste, denn zusätzliche Updates sind überflüssig.
* onChange: Hier wird limitationMin und limitationMax aktualisiert, wenn das Gerät bewegt wurde.
* interval in s: Ein Poll-Intervall in Sekunden. Tests mit 120 sind erfolgreich durchgelaufen. Dieser Wert ist vielleicht etwas übertrieben, man denke an das Funkfeuer und den Akku der Geräte. Ein Intervall von 600 ist vielleicht sinnvoller. Beispiele:
:<code>set Velux_1 limitationUpdateInterval off</code>
:<code>set Velux_2 limitationUpdateInterval onChange</code>
:<code>set Velux_3 limitationUpdateInterval 600</code>

==== Extra Reading für den Regensensor ====
Wem die Auswertung vom Reading limitationMax zu indirekt ist, der kann sich ein neues Reading anlegen.
Der folgende Code legt ein Reading namens sensor an, die Werte sind im Beispiel "Regen" oder "trocken".
Es besteht die Annahme, dass bei limitationMax = 7 der Regensensor angeschlagen hat.
:<code>attr Velux_3 userReadings sensor {(ReadingsVal($name,"limitationMax",100) == 7)?"Regen":"trocken"}</code>
Hinweis: Das neue Reading sensor erscheint erst, wenn das Reading limitationMax einmal aktualisiert wurde.

== Vorschläge zur schöneren Darstellung ==
Wie Homematic-Geräte kommt KLF200Node im FHEM-Web sehr schlicht daher. Dieses Kapitel gibt Vorschläge zur Konfiguration einer schöneren Darstellung.

=== Rollladen ===
Dieses Beispiel stellt den Status des Rollladen 10-Prozent genau im Icon dar. Bewegen sich der Rollladen, hat das Icon einen Pfeil nach oben oder unten. Ein Klick auf das Icon setzt den Rollladen in Bewegung oder hält ihn an (toggle).

:<code>attr Velux_2 stateFormat pct execution</code>
:<code>attr Velux_2 devStateIcon .*up:fts_shutter_up:toggle .*down:fts_shutter_down:toggle \d.stop:fts_shutter_100:toggle 1\d.stop:fts_shutter_90:toggle 2\d.stop:fts_shutter_80:toggle 3\d.stop:fts_shutter_70:toggle 4\d.stop:fts_shutter_60:toggle 5\d.stop:fts_shutter_50:toggle 6\d.stop:fts_shutter_40:toggle 7\d.stop:fts_shutter_30:toggle 8\d.stop:fts_shutter_20:toggle 9\d.stop:fts_shutter_10:toggle 100.stop:fts_window_2w:toggle</code>
[[Datei:RollerShutterUpDown.png|300px|Rollladen mit Pfeilen]]

So erhält man einen Slider für die Rollladenposition:

:<code>attr Velux_2 webCmd pct</code>

=== Dachschrägenfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachschrägenfenster in drei Stufen dar:

0% - 9%: geschlossen

10% - 59%: halb geöffnet

60% - 100%: ganz geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_4 limitationUpdateInterval 600</code>
:<code>attr Velux_4 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_4 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7\).*:weather_rain:toggle \d.$.*:fts_window_roof:toggle [1-5]\d.\(.*:fts_window_roof_open_1:toggle [6-9]\d.\(.*:fts_window_roof_open_2:toggle 100.\(.*:fts_window_roof_open_2:toggle</code>

=== Dachkuppelfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachkuppelfenster in zwei Stufen dar:

0% - 9%: geschlossen

10% - 100%: geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_5 limitationUpdateInterval 600</code>
:<code>attr Velux_5 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_5 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7$.*:weather_rain:toggle \d.\(.*:fts_light_dome:toggle [1-9]\d.\(.*:fts_light_dome_open:toggle 100.\(.*:fts_light_dome_open:toggle</code>

== Problembehebung ==
=== Verbindungsabbrüche ===
Sollte es zu Verbindungsabbrüchen zwischen FHEM und der KLF200-Box kommen, dann sind folgende Dinge zu überprüfen:
==== FHEM Update ====
Ist FHEM aktuell? Am 18.12.2018 gab es ein wichtiges FHEM-Update, das die Stabilität von SSL-Verbindungen wesentlich verbessert hat.
==== OpenSSL ====
OpenSLL sollte immer aktuell sein.
==== Perl SSL-Bibliotheken ====
Wenn die Perl SSL-Bibliotheken zu alt sind, ist das oben genannte FHEM-Update wirkungslos.
* IO::Socket::SSL
* Net::SSL
* Net::SSLeay
* Net::SSLeay::Handle
* Crypt::SSLeay
* Net::Server::Proto::SSL

=== Registrieren von Geräten an der KLF200-Box ===

Die [https://velcdn.azureedge.net/~/media/marketing/ch/fachleute/einbauanleitungen/elektro-nachrustung/zubehor/klf-200_bedienungsanleitung_basic%20de.pdf KLF200-Dokumentation] Seite 11 - 19 beschreibt 2 Varianten, um Geräte mit der Box zu koppeln.

==== 1. Registrierung mit einer Zweiweg-Bedienung ====
Dieser Weg funktioniert über die Schlüssel-Taste oder im Web-UI über PRODUKTE KOPIEREN.

Es ist eine Zweiweg-Bedienung erforderlich, die in der Lage ist, die IO-Schlüssel zu exportieren.

Dieser Weg geht z.B. mit dem Control Pad KLR200, Somfy TaHoma, [https://www.somfy.de/hilfe-center/faq/wie-binde-ich-produkte-ein-die-bereits-mit-einem-2-wege-sender-angesteuert-werden Nina io, Telis Composio io, Impresario Chronis io, Easy Sun io und Telis 1 io.].

TaHoma: anmelden, Menü "Sicherheitseinstellungen", Reiter "io-System", "SICHERHEITSSCHLÜSSEL SENDEN"

==== 2. Registrierung mit einer Einweg-Bedienung ====
Dieser Weg funktioniert über die Reset-Taste oder im Web-UI über PRODUKTSUCHE.

Hierzu wird das Gerät über eine Fernbedienung oder direkt am Gerät in einen Anlernzustand versetzt und dann einigen sich KLF200 und das Gerät über einen Schlüssel.

Bei manchen Somfy-Geräten scheint dieser Weg nicht zu funktionieren, z.B. einige Somfy Smoove Produkte. Hier bleibt nur die Möglichkeit, die Schlüssel wie in Variante 1 von einer Somfy Zweiweg-Bedienung zu kopieren.

=== WARNUNG vor Reset der KLF200-Box! ===
Sollten an der KLF200-Box schon Geräte registriert sein, dann ist ein Factory-Reset unbedingt zu vermeiden!
Die Geräte, die mit der KLF200 bereits Schlüssel ausgetauscht haben, lassen sich nicht ohne weiteres noch einmal registrieren.
Um diese Geräte nach einem Reset der KLF200 trotzdem zu registrieren, sind folgende Schritte notwendig:
# Die registrierten Geräte müssen komplett zurückgesetzt werden.
# Die entsprechenden Fernbedienungen müssen neu angelernt werden.
# Die Geräte können an der KLF200-Box registriert werden.

== Links ==
* Support im Forum gibt es unter {{Link2Forum|Topic=92907|LinkText=Velux KLF200 mit Firmware 2.0.0.71 für io-homecontrol}}
* Github: [https://github.com/buennerbernd/fhem/tree/master/KLF200/2.0 FHEM modules KLF200 and KLF200Node]

[[Kategorie:Rollladensteuerung]]
[[Kategorie:io-homecontrol]]
[[Kategorie:Other Components]]

Velux KLF200

2019-12-16T14:26:02Z

Buennerbernd: /* Unterstützte Geräte */

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Anbindung io-homecontrol Aktoren an FHEM
|ModType=x
|ModCmdRef=KLF200
|ModFTopic=92907
|ModTechName=83_KLF200.pm
|ModOwner=buennerbernd ({{Link2FU|21440|Forum}} / [[Benutzer Diskussion:Buennerbernd|Wiki]])
}}

'''KLF200''' ist ein Modul zur Steuerung von '''io-homecontrol''' Aktoren über das Gateway Velux KLF 200.

== Velux KLF 200 ==

Die KLF-200-Box ist über LAN mit FHEM verbunden und steuert die Aktoren über das verschlüsselte Funkprotokoll ''io-homecontrol''.
Die Aktoren geben Rückmeldung über ihren aktuellen Zustand.

Die Box hat 10 elektrische Eingänge mit denen man 5 Geräte oder Gerätegruppen steuern kann.
Damit kann man z.B. mit Doppeltastern an der Wand seine Rollladen oder Fenster steuern.
Über den LAN-Anschluss lassen sich mit FHEM bis zu 200 Geräte mit einer KLF 200 verwalten.

Das Modul erfordert die Firmware-Version 2.0.0.71 und basiert auf der dokumentierten API von Velux. [https://www.velux.com/api/klf200 Download und weitere Informationen]

Das Gateway hat keine Cloud-Integration.

== Unterstützte Geräte ==

Grundsätzlich sollten alle io-homecontrol Aktoren funktionieren. Alleinstehende Sensoren (z.B. Lichtsensor, Windsensor) werden
von der KLF-200-Box nicht unterstützt. Es besteht aber die Möglichkeit, den Status von Sensoren auszuwerten, die in Aktoren integriert sind.

Aktuell werden folgende Geräte erfolgreich mit diesem Modul verwendet:

* Rollladen:
** VELUX SML
** VELUX SSL
** Somfy Oximo io
** Somfy RS100 io
** Somfy Izymo io
* Sichtschutz innen:
** VELUX FSK
** VELUX DML
* Fensteröffner mit integriertem Regensensor:
** VELUX KMG
** VELUX CVP
** VELUX KSX
* Markisen:
** VELUX MSL
** VELUX MML
** Somfy Sunea io
** Somfy Maestria+ 50 io

== Benutzung in FHEM ==
=== Vorbereitung ===
Bevor die Aktoren in FHEM verwendet werden können, müssen sie in der [[#Registrieren von Geräten an der KLF200-Box|KLF 200 angelernt]] werden.
Das geschieht über das WebUI der KLF 200, das über einen Wifi-Hotspot erreichbar ist. Dieser Vorgang ist im Handbuch beschrieben.
Im WebUI können die angeschlossenen Geräte auch benannt werden. Zusätzlich hat man die Möglichkeit, Programme (Szenen) aufzuzeichnen,
um ein oder mehrere Geräte in eine definierte Position zu bringen. Diese Szenen kann man aus FHEM ebenfalls ansteuern.

Das Modul wird momentan noch nicht über FHEM ausgeliefert.
Es wird wie folgt geladen und aktualisiert:

:<code>update all <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>
:<code>shutdown restart</code>

Mit diesem Befehl wird das Modul so eingerichtet, dass es ebenfalls aktualisiert wird, wenn man FHEM aktualisiert:
:<code>update add <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>

=== Anlegen der Geräte ===
:<code>define <name> KLF200 <host></code>
Beispiel:
:<code>define Velux KLF200 192.168.0.66</code>

Danach Login durch Eingabe des Passwortes:
:<code>set <name> login <password></code>

Hinweis: Das Passwort ist laut Dokumentation das Wifi-Passwort, das auf den Boden der Box gedruckt ist.
Das funktioniert bei einigen Nutzern. Bei vielen Nutzern funktioniert hingegen das Passwort des WebUI.
Scheinbar hängt das davon ab, mit welcher Firmware die Box ausgeliefert wurde und ob schon einmal ein Reset durchgeführt wurde.
Das Passwort wird verschleiert im FHEM-Backend gespeichert. Es muss nach erfolgreichem Login nicht mehr eingegeben werden.

Die angeschlossenen Aktoren werden jetzt durch autocreate als Instanzen von KLF200Node im Raum KLF200Node angelegt.
Die Namen der Geräte folgen dem Muster <name>_<NodeID>.
Wurde im WebUI der KLF200 ein Name für das Gerät vergeben dann wird dieser als Alias übernommen.

Die Geräte sind jetzt einsatzbereit.

== Modul KLF200 ==
=== Verbindungsstatus ===
==== STATE ====
Im STATE des Moduls sieht man den aktuellen Verbindungsstatus. Im Idealfall ist er nach der Initialisierung Logged in.
=== Ausführung von Programmen (Szenen) ===
Obwohl man mit dem Modul KLF200Node jedes Gerät unabhängig und auch gleichzeitig steuern kann, sind Szenen eine nützliche Ergänzung. So kann man mit Szenen wie "Alle zu" oder "Alle auf" viele Geräte gleichzeitig mit einem Befehl bedienen.

Hinweis: Während der Abarbeitung einer Szene werden weitere Befehle gepuffert.
==== scene/sceneID ====
Mit diesen Set-Funktionen kann man eine aufgezeichnete Szene aufrufen.
Im entsprechenden Reading steht die zuletzt aufgerufene Szene.

Die Zuordnung zwischen sceneID und scene sieht man in den Internals unter scenes.

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Bei vielen aktuellen Geräten lässt sich die Ausführungsgeschwindigkeit (Velocity) variieren. So lässt sich die Geschwindigkeit gegenüber der Default-Geschwindigkeit noch erhöhen oder auch deutlich reduzieren. So ist eine besonders leise Bedienung möglich.

==== Argument DEFAULT, FAST, SILENT ====
Die Velocity kann man bei der Ausführung von Szenen als zusätzliches Argument von set scene oder set sceneID setzen.
Unterstützte Werte sind DEFAULT, FAST und SILENT
:<code>set Velux scene "Alle zu" SILENT</code>
==== Attribut velocity ====
Alternativ kann man im Modul KLF200 das Attribut velocity setzen, das bei der Ausführung von Szenen herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

Hinweis: Dieses Attribut hat keine Auswirkungen auf Befehle, die vom Modul KLF200Node abgesetzt werden.

== Modul KLF200Node ==
Dieses Modul wurde dem Homematic-Modul CUL_HM nachempfunden, da es ebenfalls ein breites Spektrum an Geräten unterstützt
und möglichst kompatibel zu vorhandenen Hilfsmodulen sein soll.
=== Aktueller Status ===
Im Folgenden wird der Zusammenhang zwischen den wichtigsten Readings/Set-Funktionen pct, state, execution erklärt.
==== pct ====
Dieses Reading enthält den aktuell bekannten Status des Gerätes in Prozent.

Wird das Gerät über die KLF-200-Box gesteuert, wird das Reading beim Erreichen der Zielposition sofort aktualisiert.

Wird das Gerät über eine Fernbedienung oder einen Sensor gesteuert, kann sich die Aktualisierung wenige Minuten verzögern.

Mit der Set-Funktion kann man das Gerät in diesen Status versetzen.
Per Default entspricht 100 auf der Fernbedienung oben und 0 unten.
==== state ====
Dieses Reading entspricht dem Reading pct, mit der Ausnahme, dass 0 durch '''off''' ersetzt wird und 100 durch '''on'''.

Die Set-Funktion funktioniert analog.
Per Default entspricht on auf der Fernbedienung oben und off unten.

Es werden die '''set extensions''' unterstützt. Damit können mit einem Set ein oder mehrere Befehle zeitgesteuert abgesetzt werden.

Doku: [https://fhem.de/commandref_DE.html#set set extensions in der commandref] und im [[DevelopmentModuleIntro#X_Set]] jeweils etwas weiter unten.

==== execution ====
Dieses Reading gibt den aktuellen Ausführungsstatus wieder. Die meiste Zeit ist der Wert stop.
Wird gerade ein Befehl ausgeführt, ist der Wert up oder down.

Mit der Set-Funktion werden entsprechende Befehle ausgeführt, up entspricht auf der Fernbedienung oben und down unten.
Bei stop wird die aktuelle Ausführung angehalten.

==== Attribut directionOn ====
Wie oben beschrieben, entspricht per Default on = 100 = up.

Das kann bei bestimmten Geräten für manchen Nutzer verwirrend sein.
Wenn man z.B. bei einem Rollladen lieber im geschlossenen Zustand 100 Prozent sehen möchte, dann setzt man das Attribut directionOn, z.B.
:<code>attr Velux_2 directionOn down</code>

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Wie bei Szenen lässt sich auch bei Kommandos auf KLF200Node die Ausführungsgeschwindigkeit beeinflussen, soweit das vom Gerät unterstützt ist.
==== Reading velocity ====
Dieses Reading hat den Wert supported, wenn die Geschwindigkeit bei diesem Gerät geändert werden kann.
Selbst bei Not supported wäre es einen Versuch wert, es zu testen.
==== Argument DEFAULT, FAST, SILENT ====
Alle set-Funktionen, die eine Bewegung auslösen unterstützen das optionale Argument DEFAULT, FAST oder SILENT.
==== Attribut velocity ====
Alternativ kann man im Modul KLF200Node das Attribut velocity setzen, das bei der Ausführung von Kommandos herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

=== Raw-Befehle zum Testen von unbekannten Geräten ===
Die bisher beschriebenen Funktionen des KLF200Node-Moduls bieten einen vereinfachten Zugang zu io-homecontrol-Geräten mit nur einem Motor.

Intern wird bei diesen Funktionen der Main Parameter (MP) für die Steuerung des Motors und der Functional Parameter 1 (FP1) für die Velocity gesetzt.
Theoretisch können Geräte bis zu 16 Functional Parameter (FP1 bis FP16) haben. Der Wertebereich aller Parameter ist 0 - 65535, wobei sich 0 - 100% auf 0 - 51200 abbilden.

'''Für Experten''' bietet die Funktion '''set raw''' die Möglichkeit, mehrere Parameter gleichzeitig zu setzen. Damit lassen sich dann z.B. die Lamellen von Raffstores bewegen.
Zuvor wird empfohlen, in der [https://velcdn.azureedge.net/~/media/com/api/klf200/technical%20specification%20for%20klf%20200%20api-ver3-16.pdf KLF 200 API] die folgenden Kapitel zu lesen:
* 10.1.1 GW_COMMAND_SEND_REQ
* 10.1.1.4 ParameterActive parameter
* 13 Appendix 1: Standard Parameter definition
* 14 Appendix 2: List of actuator types and their use of Main Parameter and Functional Parameters

Beispiel-Aufrufe:
:<code>set Velux_1 raw MP=51200</code>
:<code>set Velux_2 raw MP=0 FP1=51200</code>
:<code>set Velux_3 raw ParameterActive=3 FP3=25600 FP2=51200</code>

Beim Aufruf muss man sich für einen Parameter entscheiden, von dem man Feedback erhalten will. Diesen wählt man mit ParameterActive aus. Default ist ParameterActive=0 für MP. Ein Functional Parameter kann mit 1 - 16 ausgewählt werden.
Die aktuell bekannten Werte stehen in den Readings MP und FP1 bis FP16, wobei nur Readings für tatsächlich genutzte Parameter angelegt werden.

Die Funktion '''set updateCurrentPosition''' aktualisiert die Readings MP und FP1 - FP7, falls vorhanden.

Beispiele für Geräte mit mehreren Motoren:
* Somfy J4 io Protect
* evtl. VELUX SMG Doppelrollladen

Wenn sich Nutzer melden sollten, die auf diese Weise Geräte mit mehreren Motoren getestet haben, dann kann entschieden werden, wie dieses Modul auf sinnvolle Weise weiterentwickelt werden kann.

=== Begrenzung des Bewegungsradius / Limitation ===
Die io-homecontrol Geräte haben ein Feature eingebaut, um den Bewegungsradius der Geräte einzuschränken, egal von wo aus sie gesteuert werden. Dieses Limitation-Feature ist in dieses FHEM-Modul ebenfalls integriert.
==== limitationMin und limitationMax ====
Mit den Settern und Readings limitationMin und limitationMax kann man die Limitation setzen und auslesen.
Natürlich kann man auch selbst von der Limitation Gebrauch machen. Man kann z.B. einen Rollladen begrenzen, wenn man weiß, dass das Dachfenster weit offen ist. Dann kann der Rollladen nicht gegen das Fenster stoßen, selbst wenn man ihn mit der Fernbedienung bewegt.
==== limiationClear ====
Mit dem Setter limiationClear kann man alle Limitations (auch von fremden Geräten ausgelöste) löschen.
==== updateLimiation ====
Der Setter updateLimiation aktualisiert die Readings limitationMin und limitationMax auf diesem Gerät, falls die Limitation außerhalb von FHEM gesetzt wurde.

=== Auswerten der Regensensoren ===
Die Regensensoren von Velux Fensteröffnern machen von diesem Limitation-Feature Gebrauch. Wenn es regnet, wird der Bewegungsradius der Fenster eingeschränkt. Zum Beispiel (evtl. Geräte-abhängig):
* limitationMax = 7 bei Regen,
* limitationMax = 100 wenn es aufhört.
Diese Werte kann man auslesen, ohne dass sich das Fenster dazu bewegt haben muss.

==== limitationUpdateInterval ====
Mit set limitationUpdateInterval kann man festlegen, wie oft diese Werte ausgelesen werden:
* off: Dieser Wert ist für Geräte ohne integrierte Sensoren der Beste, denn zusätzliche Updates sind überflüssig.
* onChange: Hier wird limitationMin und limitationMax aktualisiert, wenn das Gerät bewegt wurde.
* interval in s: Ein Poll-Intervall in Sekunden. Tests mit 120 sind erfolgreich durchgelaufen. Dieser Wert ist vielleicht etwas übertrieben, man denke an das Funkfeuer und den Akku der Geräte. Ein Intervall von 600 ist vielleicht sinnvoller. Beispiele:
:<code>set Velux_1 limitationUpdateInterval off</code>
:<code>set Velux_2 limitationUpdateInterval onChange</code>
:<code>set Velux_3 limitationUpdateInterval 600</code>

==== Extra Reading für den Regensensor ====
Wem die Auswertung vom Reading limitationMax zu indirekt ist, der kann sich ein neues Reading anlegen.
Der folgende Code legt ein Reading namens sensor an, die Werte sind im Beispiel "Regen" oder "trocken".
Es besteht die Annahme, dass bei limitationMax = 7 der Regensensor angeschlagen hat.
:<code>attr Velux_3 userReadings sensor {(ReadingsVal($name,"limitationMax",100) == 7)?"Regen":"trocken"}</code>
Hinweis: Das neue Reading sensor erscheint erst, wenn das Reading limitationMax einmal aktualisiert wurde.

== Vorschläge zur schöneren Darstellung ==
Wie Homematic-Geräte kommt KLF200Node im FHEM-Web sehr schlicht daher. Dieses Kapitel gibt Vorschläge zur Konfiguration einer schöneren Darstellung.

=== Rollladen ===
Dieses Beispiel stellt den Status des Rollladen 10-Prozent genau im Icon dar. Bewegen sich der Rollladen, hat das Icon einen Pfeil nach oben oder unten. Ein Klick auf das Icon setzt den Rollladen in Bewegung oder hält ihn an (toggle).

:<code>attr Velux_2 stateFormat pct execution</code>
:<code>attr Velux_2 devStateIcon .*up:fts_shutter_up:toggle .*down:fts_shutter_down:toggle \d.stop:fts_shutter_100:toggle 1\d.stop:fts_shutter_90:toggle 2\d.stop:fts_shutter_80:toggle 3\d.stop:fts_shutter_70:toggle 4\d.stop:fts_shutter_60:toggle 5\d.stop:fts_shutter_50:toggle 6\d.stop:fts_shutter_40:toggle 7\d.stop:fts_shutter_30:toggle 8\d.stop:fts_shutter_20:toggle 9\d.stop:fts_shutter_10:toggle 100.stop:fts_window_2w:toggle</code>
[[Datei:RollerShutterUpDown.png|300px|Rollladen mit Pfeilen]]

So erhält man einen Slider für die Rollladenposition:

:<code>attr Velux_2 webCmd pct</code>

=== Dachschrägenfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachschrägenfenster in drei Stufen dar:

0% - 9%: geschlossen

10% - 59%: halb geöffnet

60% - 100%: ganz geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_4 limitationUpdateInterval 600</code>
:<code>attr Velux_4 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_4 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7\).*:weather_rain:toggle \d.$.*:fts_window_roof:toggle [1-5]\d.\(.*:fts_window_roof_open_1:toggle [6-9]\d.\(.*:fts_window_roof_open_2:toggle 100.\(.*:fts_window_roof_open_2:toggle</code>

=== Dachkuppelfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachkuppelfenster in zwei Stufen dar:

0% - 9%: geschlossen

10% - 100%: geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_5 limitationUpdateInterval 600</code>
:<code>attr Velux_5 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_5 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7$.*:weather_rain:toggle \d.\(.*:fts_light_dome:toggle [1-9]\d.\(.*:fts_light_dome_open:toggle 100.\(.*:fts_light_dome_open:toggle</code>

== Problembehebung ==
=== Verbindungsabbrüche ===
Sollte es zu Verbindungsabbrüchen zwischen FHEM und der KLF200-Box kommen, dann sind folgende Dinge zu überprüfen:
==== FHEM Update ====
Ist FHEM aktuell? Am 18.12.2018 gab es ein wichtiges FHEM-Update, das die Stabilität von SSL-Verbindungen wesentlich verbessert hat.
==== OpenSSL ====
OpenSLL sollte immer aktuell sein.
==== Perl SSL-Bibliotheken ====
Wenn die Perl SSL-Bibliotheken zu alt sind, ist das oben genannte FHEM-Update wirkungslos.
* IO::Socket::SSL
* Net::SSL
* Net::SSLeay
* Net::SSLeay::Handle
* Crypt::SSLeay
* Net::Server::Proto::SSL

=== Registrieren von Geräten an der KLF200-Box ===

Die [https://velcdn.azureedge.net/~/media/marketing/ch/fachleute/einbauanleitungen/elektro-nachrustung/zubehor/klf-200_bedienungsanleitung_basic%20de.pdf KLF200-Dokumentation] Seite 11 - 19 beschreibt 2 Varianten, um Geräte mit der Box zu koppeln.

==== 1. Registrierung mit einer Zweiweg-Bedienung ====
Dieser Weg funktioniert über die Schlüssel-Taste oder im Web-UI über PRODUKTE KOPIEREN.

Es ist eine Zweiweg-Bedienung erforderlich, die in der Lage ist, die IO-Schlüssel zu exportieren.

Dieser Weg geht z.B. mit dem Control Pad KLR200, Somfy TaHoma, [https://www.somfy.de/hilfe-center/faq/wie-binde-ich-produkte-ein-die-bereits-mit-einem-2-wege-sender-angesteuert-werden Nina io, Telis Composio io, Impresario Chronis io, Easy Sun io und Telis 1 io.].

TaHoma: anmelden, Menü "Sicherheitseinstellungen", Reiter "io-System", "SICHERHEITSSCHLÜSSEL SENDEN"

==== 2. Registrierung mit einer Einweg-Bedienung ====
Dieser Weg funktioniert über die Reset-Taste oder im Web-UI über PRODUKTSUCHE.

Hierzu wird das Gerät über eine Fernbedienung oder direkt am Gerät in einen Anlernzustand versetzt und dann einigen sich KLF200 und das Gerät über einen Schlüssel.

Bei manchen Somfy-Geräten scheint dieser Weg nicht zu funktionieren, z.B. einige Somfy Smoove Produkte. Hier bleibt nur die Möglichkeit, die Schlüssel wie in Variante 1 von einer Somfy Zweiweg-Bedienung zu kopieren.

=== WARNUNG vor Reset der KLF200-Box! ===
Sollten an der KLF200-Box schon Geräte registriert sein, dann ist ein Factory-Reset unbedingt zu vermeiden!
Die Geräte, die mit der KLF200 bereits Schlüssel ausgetauscht haben, lassen sich nicht ohne weiteres noch einmal registrieren.
Um diese Geräte nach einem Reset der KLF200 trotzdem zu registrieren, sind folgende Schritte notwendig:
# Die registrierten Geräte müssen komplett zurückgesetzt werden.
# Die entsprechenden Fernbedienungen müssen neu angelernt werden.
# Die Geräte können an der KLF200-Box registriert werden.

== Links ==
* Support im Forum gibt es unter {{Link2Forum|Topic=92907|LinkText=Velux KLF200 mit Firmware 2.0.0.71 für io-homecontrol}}
* Github: [https://github.com/buennerbernd/fhem/tree/master/KLF200/2.0 FHEM modules KLF200 and KLF200Node]

[[Kategorie:Rollladensteuerung]]
[[Kategorie:io-homecontrol]]
[[Kategorie:Other Components]]

Velux KLF200

2019-11-22T19:40:28Z

Buennerbernd: /* Raw-Befehle zum Testen von unbekannten Geräten */

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Anbindung io-homecontrol Aktoren an FHEM
|ModType=x
|ModCmdRef=KLF200
|ModFTopic=92907
|ModTechName=83_KLF200.pm
|ModOwner=buennerbernd ({{Link2FU|21440|Forum}} / [[Benutzer Diskussion:Buennerbernd|Wiki]])
}}

'''KLF200''' ist ein Modul zur Steuerung von '''io-homecontrol''' Aktoren über das Gateway Velux KLF 200.

== Velux KLF 200 ==

Die KLF-200-Box ist über LAN mit FHEM verbunden und steuert die Aktoren über das verschlüsselte Funkprotokoll ''io-homecontrol''.
Die Aktoren geben Rückmeldung über ihren aktuellen Zustand.

Die Box hat 10 elektrische Eingänge mit denen man 5 Geräte oder Gerätegruppen steuern kann.
Damit kann man z.B. mit Doppeltastern an der Wand seine Rollladen oder Fenster steuern.
Über den LAN-Anschluss lassen sich mit FHEM bis zu 200 Geräte mit einer KLF 200 verwalten.

Das Modul erfordert die Firmware-Version 2.0.0.71 und basiert auf der dokumentierten API von Velux. [https://www.velux.com/api/klf200 Download und weitere Informationen]

Das Gateway hat keine Cloud-Integration.

== Unterstützte Geräte ==

Grundsätzlich sollten alle io-homecontrol Aktoren funktionieren. Alleinstehende Sensoren (z.B. Lichtsensor, Windsensor) werden
von der KLF-200-Box nicht unterstützt. Es besteht aber die Möglichkeit, den Status von Sensoren auszuwerten, die in Aktoren integriert sind.

Aktuell werden folgende Geräte erfolgreich mit diesem Modul verwendet:

* Rollladen:
** VELUX SML
** VELUX SSL
** Somfy Oximo io
** Somfy RS100 io
** Somfy Izymo io
* Sichtschutz innen:
** VELUX FSK
** VELUX DML
* Fensteröffner mit integriertem Regensensor:
** VELUX KMG
** VELUX CVP
** VELUX KSX
* Markisen:
** VELUX MSL
** Somfy Sunea io
** Somfy Maestria+ 50 io

== Benutzung in FHEM ==
=== Vorbereitung ===
Bevor die Aktoren in FHEM verwendet werden können, müssen sie in der [[#Registrieren von Geräten an der KLF200-Box|KLF 200 angelernt]] werden.
Das geschieht über das WebUI der KLF 200, das über einen Wifi-Hotspot erreichbar ist. Dieser Vorgang ist im Handbuch beschrieben.
Im WebUI können die angeschlossenen Geräte auch benannt werden. Zusätzlich hat man die Möglichkeit, Programme (Szenen) aufzuzeichnen,
um ein oder mehrere Geräte in eine definierte Position zu bringen. Diese Szenen kann man aus FHEM ebenfalls ansteuern.

Das Modul wird momentan noch nicht über FHEM ausgeliefert.
Es wird wie folgt geladen und aktualisiert:

:<code>update all <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>
:<code>shutdown restart</code>

Mit diesem Befehl wird das Modul so eingerichtet, dass es ebenfalls aktualisiert wird, wenn man FHEM aktualisiert:
:<code>update add <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>

=== Anlegen der Geräte ===
:<code>define <name> KLF200 <host></code>
Beispiel:
:<code>define Velux KLF200 192.168.0.66</code>

Danach Login durch Eingabe des Passwortes:
:<code>set <name> login <password></code>

Hinweis: Das Passwort ist laut Dokumentation das Wifi-Passwort, das auf den Boden der Box gedruckt ist.
Das funktioniert bei einigen Nutzern. Bei vielen Nutzern funktioniert hingegen das Passwort des WebUI.
Scheinbar hängt das davon ab, mit welcher Firmware die Box ausgeliefert wurde und ob schon einmal ein Reset durchgeführt wurde.
Das Passwort wird verschleiert im FHEM-Backend gespeichert. Es muss nach erfolgreichem Login nicht mehr eingegeben werden.

Die angeschlossenen Aktoren werden jetzt durch autocreate als Instanzen von KLF200Node im Raum KLF200Node angelegt.
Die Namen der Geräte folgen dem Muster <name>_<NodeID>.
Wurde im WebUI der KLF200 ein Name für das Gerät vergeben dann wird dieser als Alias übernommen.

Die Geräte sind jetzt einsatzbereit.

== Modul KLF200 ==
=== Verbindungsstatus ===
==== STATE ====
Im STATE des Moduls sieht man den aktuellen Verbindungsstatus. Im Idealfall ist er nach der Initialisierung Logged in.
=== Ausführung von Programmen (Szenen) ===
Obwohl man mit dem Modul KLF200Node jedes Gerät unabhängig und auch gleichzeitig steuern kann, sind Szenen eine nützliche Ergänzung. So kann man mit Szenen wie "Alle zu" oder "Alle auf" viele Geräte gleichzeitig mit einem Befehl bedienen.

Hinweis: Während der Abarbeitung einer Szene werden weitere Befehle gepuffert.
==== scene/sceneID ====
Mit diesen Set-Funktionen kann man eine aufgezeichnete Szene aufrufen.
Im entsprechenden Reading steht die zuletzt aufgerufene Szene.

Die Zuordnung zwischen sceneID und scene sieht man in den Internals unter scenes.

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Bei vielen aktuellen Geräten lässt sich die Ausführungsgeschwindigkeit (Velocity) variieren. So lässt sich die Geschwindigkeit gegenüber der Default-Geschwindigkeit noch erhöhen oder auch deutlich reduzieren. So ist eine besonders leise Bedienung möglich.

==== Argument DEFAULT, FAST, SILENT ====
Die Velocity kann man bei der Ausführung von Szenen als zusätzliches Argument von set scene oder set sceneID setzen.
Unterstützte Werte sind DEFAULT, FAST und SILENT
:<code>set Velux scene "Alle zu" SILENT</code>
==== Attribut velocity ====
Alternativ kann man im Modul KLF200 das Attribut velocity setzen, das bei der Ausführung von Szenen herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

Hinweis: Dieses Attribut hat keine Auswirkungen auf Befehle, die vom Modul KLF200Node abgesetzt werden.

== Modul KLF200Node ==
Dieses Modul wurde dem Homematic-Modul CUL_HM nachempfunden, da es ebenfalls ein breites Spektrum an Geräten unterstützt
und möglichst kompatibel zu vorhandenen Hilfsmodulen sein soll.
=== Aktueller Status ===
Im Folgenden wird der Zusammenhang zwischen den wichtigsten Readings/Set-Funktionen pct, state, execution erklärt.
==== pct ====
Dieses Reading enthält den aktuell bekannten Status des Gerätes in Prozent.

Wird das Gerät über die KLF-200-Box gesteuert, wird das Reading beim Erreichen der Zielposition sofort aktualisiert.

Wird das Gerät über eine Fernbedienung oder einen Sensor gesteuert, kann sich die Aktualisierung wenige Minuten verzögern.

Mit der Set-Funktion kann man das Gerät in diesen Status versetzen.
Per Default entspricht 100 auf der Fernbedienung oben und 0 unten.
==== state ====
Dieses Reading entspricht dem Reading pct, mit der Ausnahme, dass 0 durch '''off''' ersetzt wird und 100 durch '''on'''.

Die Set-Funktion funktioniert analog.
Per Default entspricht on auf der Fernbedienung oben und off unten.

Es werden die '''set extensions''' unterstützt. Damit können mit einem Set ein oder mehrere Befehle zeitgesteuert abgesetzt werden.

Doku: [https://fhem.de/commandref_DE.html#set set extensions in der commandref] und im [[DevelopmentModuleIntro#X_Set]] jeweils etwas weiter unten.

==== execution ====
Dieses Reading gibt den aktuellen Ausführungsstatus wieder. Die meiste Zeit ist der Wert stop.
Wird gerade ein Befehl ausgeführt, ist der Wert up oder down.

Mit der Set-Funktion werden entsprechende Befehle ausgeführt, up entspricht auf der Fernbedienung oben und down unten.
Bei stop wird die aktuelle Ausführung angehalten.

==== Attribut directionOn ====
Wie oben beschrieben, entspricht per Default on = 100 = up.

Das kann bei bestimmten Geräten für manchen Nutzer verwirrend sein.
Wenn man z.B. bei einem Rollladen lieber im geschlossenen Zustand 100 Prozent sehen möchte, dann setzt man das Attribut directionOn, z.B.
:<code>attr Velux_2 directionOn down</code>

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Wie bei Szenen lässt sich auch bei Kommandos auf KLF200Node die Ausführungsgeschwindigkeit beeinflussen, soweit das vom Gerät unterstützt ist.
==== Reading velocity ====
Dieses Reading hat den Wert supported, wenn die Geschwindigkeit bei diesem Gerät geändert werden kann.
Selbst bei Not supported wäre es einen Versuch wert, es zu testen.
==== Argument DEFAULT, FAST, SILENT ====
Alle set-Funktionen, die eine Bewegung auslösen unterstützen das optionale Argument DEFAULT, FAST oder SILENT.
==== Attribut velocity ====
Alternativ kann man im Modul KLF200Node das Attribut velocity setzen, das bei der Ausführung von Kommandos herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

=== Raw-Befehle zum Testen von unbekannten Geräten ===
Die bisher beschriebenen Funktionen des KLF200Node-Moduls bieten einen vereinfachten Zugang zu io-homecontrol-Geräten mit nur einem Motor.

Intern wird bei diesen Funktionen der Main Parameter (MP) für die Steuerung des Motors und der Functional Parameter 1 (FP1) für die Velocity gesetzt.
Theoretisch können Geräte bis zu 16 Functional Parameter (FP1 bis FP16) haben. Der Wertebereich aller Parameter ist 0 - 65535, wobei sich 0 - 100% auf 0 - 51200 abbilden.

'''Für Experten''' bietet die Funktion '''set raw''' die Möglichkeit, mehrere Parameter gleichzeitig zu setzen. Damit lassen sich dann z.B. die Lamellen von Raffstores bewegen.
Zuvor wird empfohlen, in der [https://velcdn.azureedge.net/~/media/com/api/klf200/technical%20specification%20for%20klf%20200%20api-ver3-16.pdf KLF 200 API] die folgenden Kapitel zu lesen:
* 10.1.1 GW_COMMAND_SEND_REQ
* 10.1.1.4 ParameterActive parameter
* 13 Appendix 1: Standard Parameter definition
* 14 Appendix 2: List of actuator types and their use of Main Parameter and Functional Parameters

Beispiel-Aufrufe:
:<code>set Velux_1 raw MP=51200</code>
:<code>set Velux_2 raw MP=0 FP1=51200</code>
:<code>set Velux_3 raw ParameterActive=3 FP3=25600 FP2=51200</code>

Beim Aufruf muss man sich für einen Parameter entscheiden, von dem man Feedback erhalten will. Diesen wählt man mit ParameterActive aus. Default ist ParameterActive=0 für MP. Ein Functional Parameter kann mit 1 - 16 ausgewählt werden.
Die aktuell bekannten Werte stehen in den Readings MP und FP1 bis FP16, wobei nur Readings für tatsächlich genutzte Parameter angelegt werden.

Die Funktion '''set updateCurrentPosition''' aktualisiert die Readings MP und FP1 - FP7, falls vorhanden.

Beispiele für Geräte mit mehreren Motoren:
* Somfy J4 io Protect
* evtl. VELUX SMG Doppelrollladen

Wenn sich Nutzer melden sollten, die auf diese Weise Geräte mit mehreren Motoren getestet haben, dann kann entschieden werden, wie dieses Modul auf sinnvolle Weise weiterentwickelt werden kann.

=== Begrenzung des Bewegungsradius / Limitation ===
Die io-homecontrol Geräte haben ein Feature eingebaut, um den Bewegungsradius der Geräte einzuschränken, egal von wo aus sie gesteuert werden. Dieses Limitation-Feature ist in dieses FHEM-Modul ebenfalls integriert.
==== limitationMin und limitationMax ====
Mit den Settern und Readings limitationMin und limitationMax kann man die Limitation setzen und auslesen.
Natürlich kann man auch selbst von der Limitation Gebrauch machen. Man kann z.B. einen Rollladen begrenzen, wenn man weiß, dass das Dachfenster weit offen ist. Dann kann der Rollladen nicht gegen das Fenster stoßen, selbst wenn man ihn mit der Fernbedienung bewegt.
==== limiationClear ====
Mit dem Setter limiationClear kann man alle Limitations (auch von fremden Geräten ausgelöste) löschen.
==== updateLimiation ====
Der Setter updateLimiation aktualisiert die Readings limitationMin und limitationMax auf diesem Gerät, falls die Limitation außerhalb von FHEM gesetzt wurde.

=== Auswerten der Regensensoren ===
Die Regensensoren von Velux Fensteröffnern machen von diesem Limitation-Feature Gebrauch. Wenn es regnet, wird der Bewegungsradius der Fenster eingeschränkt. Zum Beispiel (evtl. Geräte-abhängig):
* limitationMax = 7 bei Regen,
* limitationMax = 100 wenn es aufhört.
Diese Werte kann man auslesen, ohne dass sich das Fenster dazu bewegt haben muss.

==== limitationUpdateInterval ====
Mit set limitationUpdateInterval kann man festlegen, wie oft diese Werte ausgelesen werden:
* off: Dieser Wert ist für Geräte ohne integrierte Sensoren der Beste, denn zusätzliche Updates sind überflüssig.
* onChange: Hier wird limitationMin und limitationMax aktualisiert, wenn das Gerät bewegt wurde.
* interval in s: Ein Poll-Intervall in Sekunden. Tests mit 120 sind erfolgreich durchgelaufen. Dieser Wert ist vielleicht etwas übertrieben, man denke an das Funkfeuer und den Akku der Geräte. Ein Intervall von 600 ist vielleicht sinnvoller. Beispiele:
:<code>set Velux_1 limitationUpdateInterval off</code>
:<code>set Velux_2 limitationUpdateInterval onChange</code>
:<code>set Velux_3 limitationUpdateInterval 600</code>

==== Extra Reading für den Regensensor ====
Wem die Auswertung vom Reading limitationMax zu indirekt ist, der kann sich ein neues Reading anlegen.
Der folgende Code legt ein Reading namens sensor an, die Werte sind im Beispiel "Regen" oder "trocken".
Es besteht die Annahme, dass bei limitationMax = 7 der Regensensor angeschlagen hat.
:<code>attr Velux_3 userReadings sensor {(ReadingsVal($name,"limitationMax",100) == 7)?"Regen":"trocken"}</code>
Hinweis: Das neue Reading sensor erscheint erst, wenn das Reading limitationMax einmal aktualisiert wurde.

== Vorschläge zur schöneren Darstellung ==
Wie Homematic-Geräte kommt KLF200Node im FHEM-Web sehr schlicht daher. Dieses Kapitel gibt Vorschläge zur Konfiguration einer schöneren Darstellung.

=== Rollladen ===
Dieses Beispiel stellt den Status des Rollladen 10-Prozent genau im Icon dar. Bewegen sich der Rollladen, hat das Icon einen Pfeil nach oben oder unten. Ein Klick auf das Icon setzt den Rollladen in Bewegung oder hält ihn an (toggle).

:<code>attr Velux_2 stateFormat pct execution</code>
:<code>attr Velux_2 devStateIcon .*up:fts_shutter_up:toggle .*down:fts_shutter_down:toggle \d.stop:fts_shutter_100:toggle 1\d.stop:fts_shutter_90:toggle 2\d.stop:fts_shutter_80:toggle 3\d.stop:fts_shutter_70:toggle 4\d.stop:fts_shutter_60:toggle 5\d.stop:fts_shutter_50:toggle 6\d.stop:fts_shutter_40:toggle 7\d.stop:fts_shutter_30:toggle 8\d.stop:fts_shutter_20:toggle 9\d.stop:fts_shutter_10:toggle 100.stop:fts_window_2w:toggle</code>
[[Datei:RollerShutterUpDown.png|300px|Rollladen mit Pfeilen]]

So erhält man einen Slider für die Rollladenposition:

:<code>attr Velux_2 webCmd pct</code>

=== Dachschrägenfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachschrägenfenster in drei Stufen dar:

0% - 9%: geschlossen

10% - 59%: halb geöffnet

60% - 100%: ganz geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_4 limitationUpdateInterval 600</code>
:<code>attr Velux_4 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_4 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7\).*:weather_rain:toggle \d.$.*:fts_window_roof:toggle [1-5]\d.\(.*:fts_window_roof_open_1:toggle [6-9]\d.\(.*:fts_window_roof_open_2:toggle 100.\(.*:fts_window_roof_open_2:toggle</code>

=== Dachkuppelfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachkuppelfenster in zwei Stufen dar:

0% - 9%: geschlossen

10% - 100%: geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_5 limitationUpdateInterval 600</code>
:<code>attr Velux_5 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_5 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7$.*:weather_rain:toggle \d.\(.*:fts_light_dome:toggle [1-9]\d.\(.*:fts_light_dome_open:toggle 100.\(.*:fts_light_dome_open:toggle</code>

== Problembehebung ==
=== Verbindungsabbrüche ===
Sollte es zu Verbindungsabbrüchen zwischen FHEM und der KLF200-Box kommen, dann sind folgende Dinge zu überprüfen:
==== FHEM Update ====
Ist FHEM aktuell? Am 18.12.2018 gab es ein wichtiges FHEM-Update, das die Stabilität von SSL-Verbindungen wesentlich verbessert hat.
==== OpenSSL ====
OpenSLL sollte immer aktuell sein.
==== Perl SSL-Bibliotheken ====
Wenn die Perl SSL-Bibliotheken zu alt sind, ist das oben genannte FHEM-Update wirkungslos.
* IO::Socket::SSL
* Net::SSL
* Net::SSLeay
* Net::SSLeay::Handle
* Crypt::SSLeay
* Net::Server::Proto::SSL

=== Registrieren von Geräten an der KLF200-Box ===

Die [https://velcdn.azureedge.net/~/media/marketing/ch/fachleute/einbauanleitungen/elektro-nachrustung/zubehor/klf-200_bedienungsanleitung_basic%20de.pdf KLF200-Dokumentation] Seite 11 - 19 beschreibt 2 Varianten, um Geräte mit der Box zu koppeln.

==== 1. Registrierung mit einer Zweiweg-Bedienung ====
Dieser Weg funktioniert über die Schlüssel-Taste oder im Web-UI über PRODUKTE KOPIEREN.

Es ist eine Zweiweg-Bedienung erforderlich, die in der Lage ist, die IO-Schlüssel zu exportieren.

Dieser Weg geht z.B. mit dem Control Pad KLR200, Somfy TaHoma, [https://www.somfy.de/hilfe-center/faq/wie-binde-ich-produkte-ein-die-bereits-mit-einem-2-wege-sender-angesteuert-werden Nina io, Telis Composio io, Impresario Chronis io, Easy Sun io und Telis 1 io.].

TaHoma: anmelden, Menü "Sicherheitseinstellungen", Reiter "io-System", "SICHERHEITSSCHLÜSSEL SENDEN"

==== 2. Registrierung mit einer Einweg-Bedienung ====
Dieser Weg funktioniert über die Reset-Taste oder im Web-UI über PRODUKTSUCHE.

Hierzu wird das Gerät über eine Fernbedienung oder direkt am Gerät in einen Anlernzustand versetzt und dann einigen sich KLF200 und das Gerät über einen Schlüssel.

Bei manchen Somfy-Geräten scheint dieser Weg nicht zu funktionieren, z.B. einige Somfy Smoove Produkte. Hier bleibt nur die Möglichkeit, die Schlüssel wie in Variante 1 von einer Somfy Zweiweg-Bedienung zu kopieren.

=== WARNUNG vor Reset der KLF200-Box! ===
Sollten an der KLF200-Box schon Geräte registriert sein, dann ist ein Factory-Reset unbedingt zu vermeiden!
Die Geräte, die mit der KLF200 bereits Schlüssel ausgetauscht haben, lassen sich nicht ohne weiteres noch einmal registrieren.
Um diese Geräte nach einem Reset der KLF200 trotzdem zu registrieren, sind folgende Schritte notwendig:
# Die registrierten Geräte müssen komplett zurückgesetzt werden.
# Die entsprechenden Fernbedienungen müssen neu angelernt werden.
# Die Geräte können an der KLF200-Box registriert werden.

== Links ==
* Support im Forum gibt es unter {{Link2Forum|Topic=92907|LinkText=Velux KLF200 mit Firmware 2.0.0.71 für io-homecontrol}}
* Github: [https://github.com/buennerbernd/fhem/tree/master/KLF200/2.0 FHEM modules KLF200 and KLF200Node]

[[Kategorie:Rollladensteuerung]]
[[Kategorie:io-homecontrol]]
[[Kategorie:Other Components]]

Velux KLF200

2019-11-22T19:39:01Z

Buennerbernd: /* Raw-Befehle zum Testen von unbekannten Geräten */

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Anbindung io-homecontrol Aktoren an FHEM
|ModType=x
|ModCmdRef=KLF200
|ModFTopic=92907
|ModTechName=83_KLF200.pm
|ModOwner=buennerbernd ({{Link2FU|21440|Forum}} / [[Benutzer Diskussion:Buennerbernd|Wiki]])
}}

'''KLF200''' ist ein Modul zur Steuerung von '''io-homecontrol''' Aktoren über das Gateway Velux KLF 200.

== Velux KLF 200 ==

Die KLF-200-Box ist über LAN mit FHEM verbunden und steuert die Aktoren über das verschlüsselte Funkprotokoll ''io-homecontrol''.
Die Aktoren geben Rückmeldung über ihren aktuellen Zustand.

Die Box hat 10 elektrische Eingänge mit denen man 5 Geräte oder Gerätegruppen steuern kann.
Damit kann man z.B. mit Doppeltastern an der Wand seine Rollladen oder Fenster steuern.
Über den LAN-Anschluss lassen sich mit FHEM bis zu 200 Geräte mit einer KLF 200 verwalten.

Das Modul erfordert die Firmware-Version 2.0.0.71 und basiert auf der dokumentierten API von Velux. [https://www.velux.com/api/klf200 Download und weitere Informationen]

Das Gateway hat keine Cloud-Integration.

== Unterstützte Geräte ==

Grundsätzlich sollten alle io-homecontrol Aktoren funktionieren. Alleinstehende Sensoren (z.B. Lichtsensor, Windsensor) werden
von der KLF-200-Box nicht unterstützt. Es besteht aber die Möglichkeit, den Status von Sensoren auszuwerten, die in Aktoren integriert sind.

Aktuell werden folgende Geräte erfolgreich mit diesem Modul verwendet:

* Rollladen:
** VELUX SML
** VELUX SSL
** Somfy Oximo io
** Somfy RS100 io
** Somfy Izymo io
* Sichtschutz innen:
** VELUX FSK
** VELUX DML
* Fensteröffner mit integriertem Regensensor:
** VELUX KMG
** VELUX CVP
** VELUX KSX
* Markisen:
** VELUX MSL
** Somfy Sunea io
** Somfy Maestria+ 50 io

== Benutzung in FHEM ==
=== Vorbereitung ===
Bevor die Aktoren in FHEM verwendet werden können, müssen sie in der [[#Registrieren von Geräten an der KLF200-Box|KLF 200 angelernt]] werden.
Das geschieht über das WebUI der KLF 200, das über einen Wifi-Hotspot erreichbar ist. Dieser Vorgang ist im Handbuch beschrieben.
Im WebUI können die angeschlossenen Geräte auch benannt werden. Zusätzlich hat man die Möglichkeit, Programme (Szenen) aufzuzeichnen,
um ein oder mehrere Geräte in eine definierte Position zu bringen. Diese Szenen kann man aus FHEM ebenfalls ansteuern.

Das Modul wird momentan noch nicht über FHEM ausgeliefert.
Es wird wie folgt geladen und aktualisiert:

:<code>update all <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>
:<code>shutdown restart</code>

Mit diesem Befehl wird das Modul so eingerichtet, dass es ebenfalls aktualisiert wird, wenn man FHEM aktualisiert:
:<code>update add <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>

=== Anlegen der Geräte ===
:<code>define <name> KLF200 <host></code>
Beispiel:
:<code>define Velux KLF200 192.168.0.66</code>

Danach Login durch Eingabe des Passwortes:
:<code>set <name> login <password></code>

Hinweis: Das Passwort ist laut Dokumentation das Wifi-Passwort, das auf den Boden der Box gedruckt ist.
Das funktioniert bei einigen Nutzern. Bei vielen Nutzern funktioniert hingegen das Passwort des WebUI.
Scheinbar hängt das davon ab, mit welcher Firmware die Box ausgeliefert wurde und ob schon einmal ein Reset durchgeführt wurde.
Das Passwort wird verschleiert im FHEM-Backend gespeichert. Es muss nach erfolgreichem Login nicht mehr eingegeben werden.

Die angeschlossenen Aktoren werden jetzt durch autocreate als Instanzen von KLF200Node im Raum KLF200Node angelegt.
Die Namen der Geräte folgen dem Muster <name>_<NodeID>.
Wurde im WebUI der KLF200 ein Name für das Gerät vergeben dann wird dieser als Alias übernommen.

Die Geräte sind jetzt einsatzbereit.

== Modul KLF200 ==
=== Verbindungsstatus ===
==== STATE ====
Im STATE des Moduls sieht man den aktuellen Verbindungsstatus. Im Idealfall ist er nach der Initialisierung Logged in.
=== Ausführung von Programmen (Szenen) ===
Obwohl man mit dem Modul KLF200Node jedes Gerät unabhängig und auch gleichzeitig steuern kann, sind Szenen eine nützliche Ergänzung. So kann man mit Szenen wie "Alle zu" oder "Alle auf" viele Geräte gleichzeitig mit einem Befehl bedienen.

Hinweis: Während der Abarbeitung einer Szene werden weitere Befehle gepuffert.
==== scene/sceneID ====
Mit diesen Set-Funktionen kann man eine aufgezeichnete Szene aufrufen.
Im entsprechenden Reading steht die zuletzt aufgerufene Szene.

Die Zuordnung zwischen sceneID und scene sieht man in den Internals unter scenes.

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Bei vielen aktuellen Geräten lässt sich die Ausführungsgeschwindigkeit (Velocity) variieren. So lässt sich die Geschwindigkeit gegenüber der Default-Geschwindigkeit noch erhöhen oder auch deutlich reduzieren. So ist eine besonders leise Bedienung möglich.

==== Argument DEFAULT, FAST, SILENT ====
Die Velocity kann man bei der Ausführung von Szenen als zusätzliches Argument von set scene oder set sceneID setzen.
Unterstützte Werte sind DEFAULT, FAST und SILENT
:<code>set Velux scene "Alle zu" SILENT</code>
==== Attribut velocity ====
Alternativ kann man im Modul KLF200 das Attribut velocity setzen, das bei der Ausführung von Szenen herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

Hinweis: Dieses Attribut hat keine Auswirkungen auf Befehle, die vom Modul KLF200Node abgesetzt werden.

== Modul KLF200Node ==
Dieses Modul wurde dem Homematic-Modul CUL_HM nachempfunden, da es ebenfalls ein breites Spektrum an Geräten unterstützt
und möglichst kompatibel zu vorhandenen Hilfsmodulen sein soll.
=== Aktueller Status ===
Im Folgenden wird der Zusammenhang zwischen den wichtigsten Readings/Set-Funktionen pct, state, execution erklärt.
==== pct ====
Dieses Reading enthält den aktuell bekannten Status des Gerätes in Prozent.

Wird das Gerät über die KLF-200-Box gesteuert, wird das Reading beim Erreichen der Zielposition sofort aktualisiert.

Wird das Gerät über eine Fernbedienung oder einen Sensor gesteuert, kann sich die Aktualisierung wenige Minuten verzögern.

Mit der Set-Funktion kann man das Gerät in diesen Status versetzen.
Per Default entspricht 100 auf der Fernbedienung oben und 0 unten.
==== state ====
Dieses Reading entspricht dem Reading pct, mit der Ausnahme, dass 0 durch '''off''' ersetzt wird und 100 durch '''on'''.

Die Set-Funktion funktioniert analog.
Per Default entspricht on auf der Fernbedienung oben und off unten.

Es werden die '''set extensions''' unterstützt. Damit können mit einem Set ein oder mehrere Befehle zeitgesteuert abgesetzt werden.

Doku: [https://fhem.de/commandref_DE.html#set set extensions in der commandref] und im [[DevelopmentModuleIntro#X_Set]] jeweils etwas weiter unten.

==== execution ====
Dieses Reading gibt den aktuellen Ausführungsstatus wieder. Die meiste Zeit ist der Wert stop.
Wird gerade ein Befehl ausgeführt, ist der Wert up oder down.

Mit der Set-Funktion werden entsprechende Befehle ausgeführt, up entspricht auf der Fernbedienung oben und down unten.
Bei stop wird die aktuelle Ausführung angehalten.

==== Attribut directionOn ====
Wie oben beschrieben, entspricht per Default on = 100 = up.

Das kann bei bestimmten Geräten für manchen Nutzer verwirrend sein.
Wenn man z.B. bei einem Rollladen lieber im geschlossenen Zustand 100 Prozent sehen möchte, dann setzt man das Attribut directionOn, z.B.
:<code>attr Velux_2 directionOn down</code>

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Wie bei Szenen lässt sich auch bei Kommandos auf KLF200Node die Ausführungsgeschwindigkeit beeinflussen, soweit das vom Gerät unterstützt ist.
==== Reading velocity ====
Dieses Reading hat den Wert supported, wenn die Geschwindigkeit bei diesem Gerät geändert werden kann.
Selbst bei Not supported wäre es einen Versuch wert, es zu testen.
==== Argument DEFAULT, FAST, SILENT ====
Alle set-Funktionen, die eine Bewegung auslösen unterstützen das optionale Argument DEFAULT, FAST oder SILENT.
==== Attribut velocity ====
Alternativ kann man im Modul KLF200Node das Attribut velocity setzen, das bei der Ausführung von Kommandos herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

=== Raw-Befehle zum Testen von unbekannten Geräten ===
Die bisher beschriebenen Funktionen des KLF200Node-Moduls bieten einen vereinfachten Zugang zu io-homecontrol-Geräten mit nur einem Motor.

Intern wird bei diesen Funktionen der MainParameter (MP) für die Steuerung des Motors und der Functional Parameter 1 (FP1) für die Velocity gesetzt.
Theoretisch können Geräte bis zu 16 Functional Parameter (FP1 bis FP16) haben. Der Wertebereich aller Parameter ist 0 - 65535, wobei sich 0 - 100% auf 0 - 51200 abbilden.

'''Für Experten''' bietet die Funktion '''set raw''' die Möglichkeit, mehrere Parameter gleichzeitig zu setzen. Damit lassen sich dann z.B. die Lamellen von Raffstores bewegen.
Zuvor wird empfohlen, in der [https://velcdn.azureedge.net/~/media/com/api/klf200/technical%20specification%20for%20klf%20200%20api-ver3-16.pdf KLF 200 API] die folgenden Kapitel zu lesen:
* 10.1.1 GW_COMMAND_SEND_REQ
* 10.1.1.4 ParameterActive parameter
* 13 Appendix 1: Standard Parameter definition
* 14 Appendix 2: List of actuator types and their use of Main Parameter and Functional Parameters

Beispiel-Aufrufe:
:<code>set Velux_1 raw MP=51200</code>
:<code>set Velux_2 raw MP=0 FP1=51200</code>
:<code>set Velux_3 raw ParameterActive=3 FP3=25600 FP2=51200</code>

Beim Aufruf muss man sich für einen Parameter entscheiden, von dem man Feedback erhalten will. Diesen wählt man mit ParameterActive aus. Default ist ParameterActive=0 für MP. Ein Functional Parameter kann mit 1 - 16 ausgewählt werden.
Die aktuell bekannten Werte stehen in den Readings MP und FP1 bis FP16, wobei nur Readings für tatsächlich genutzte Parameter angelegt werden.

Die Funktion '''set updateCurrentPosition''' aktualisiert die Readings MP und FP1 - FP7, falls vorhanden.

Beispiele für Geräte mit mehreren Motoren:
* Somfy J4 io Protect
* evtl. VELUX SMG Doppelrollladen

Wenn sich Nutzer melden sollten, die auf diese Weise Geräte mit mehreren Motoren getestet haben, dann kann entschieden werden, wie dieses Modul auf sinnvolle Weise weiterentwickelt werden kann.

=== Begrenzung des Bewegungsradius / Limitation ===
Die io-homecontrol Geräte haben ein Feature eingebaut, um den Bewegungsradius der Geräte einzuschränken, egal von wo aus sie gesteuert werden. Dieses Limitation-Feature ist in dieses FHEM-Modul ebenfalls integriert.
==== limitationMin und limitationMax ====
Mit den Settern und Readings limitationMin und limitationMax kann man die Limitation setzen und auslesen.
Natürlich kann man auch selbst von der Limitation Gebrauch machen. Man kann z.B. einen Rollladen begrenzen, wenn man weiß, dass das Dachfenster weit offen ist. Dann kann der Rollladen nicht gegen das Fenster stoßen, selbst wenn man ihn mit der Fernbedienung bewegt.
==== limiationClear ====
Mit dem Setter limiationClear kann man alle Limitations (auch von fremden Geräten ausgelöste) löschen.
==== updateLimiation ====
Der Setter updateLimiation aktualisiert die Readings limitationMin und limitationMax auf diesem Gerät, falls die Limitation außerhalb von FHEM gesetzt wurde.

=== Auswerten der Regensensoren ===
Die Regensensoren von Velux Fensteröffnern machen von diesem Limitation-Feature Gebrauch. Wenn es regnet, wird der Bewegungsradius der Fenster eingeschränkt. Zum Beispiel (evtl. Geräte-abhängig):
* limitationMax = 7 bei Regen,
* limitationMax = 100 wenn es aufhört.
Diese Werte kann man auslesen, ohne dass sich das Fenster dazu bewegt haben muss.

==== limitationUpdateInterval ====
Mit set limitationUpdateInterval kann man festlegen, wie oft diese Werte ausgelesen werden:
* off: Dieser Wert ist für Geräte ohne integrierte Sensoren der Beste, denn zusätzliche Updates sind überflüssig.
* onChange: Hier wird limitationMin und limitationMax aktualisiert, wenn das Gerät bewegt wurde.
* interval in s: Ein Poll-Intervall in Sekunden. Tests mit 120 sind erfolgreich durchgelaufen. Dieser Wert ist vielleicht etwas übertrieben, man denke an das Funkfeuer und den Akku der Geräte. Ein Intervall von 600 ist vielleicht sinnvoller. Beispiele:
:<code>set Velux_1 limitationUpdateInterval off</code>
:<code>set Velux_2 limitationUpdateInterval onChange</code>
:<code>set Velux_3 limitationUpdateInterval 600</code>

==== Extra Reading für den Regensensor ====
Wem die Auswertung vom Reading limitationMax zu indirekt ist, der kann sich ein neues Reading anlegen.
Der folgende Code legt ein Reading namens sensor an, die Werte sind im Beispiel "Regen" oder "trocken".
Es besteht die Annahme, dass bei limitationMax = 7 der Regensensor angeschlagen hat.
:<code>attr Velux_3 userReadings sensor {(ReadingsVal($name,"limitationMax",100) == 7)?"Regen":"trocken"}</code>
Hinweis: Das neue Reading sensor erscheint erst, wenn das Reading limitationMax einmal aktualisiert wurde.

== Vorschläge zur schöneren Darstellung ==
Wie Homematic-Geräte kommt KLF200Node im FHEM-Web sehr schlicht daher. Dieses Kapitel gibt Vorschläge zur Konfiguration einer schöneren Darstellung.

=== Rollladen ===
Dieses Beispiel stellt den Status des Rollladen 10-Prozent genau im Icon dar. Bewegen sich der Rollladen, hat das Icon einen Pfeil nach oben oder unten. Ein Klick auf das Icon setzt den Rollladen in Bewegung oder hält ihn an (toggle).

:<code>attr Velux_2 stateFormat pct execution</code>
:<code>attr Velux_2 devStateIcon .*up:fts_shutter_up:toggle .*down:fts_shutter_down:toggle \d.stop:fts_shutter_100:toggle 1\d.stop:fts_shutter_90:toggle 2\d.stop:fts_shutter_80:toggle 3\d.stop:fts_shutter_70:toggle 4\d.stop:fts_shutter_60:toggle 5\d.stop:fts_shutter_50:toggle 6\d.stop:fts_shutter_40:toggle 7\d.stop:fts_shutter_30:toggle 8\d.stop:fts_shutter_20:toggle 9\d.stop:fts_shutter_10:toggle 100.stop:fts_window_2w:toggle</code>
[[Datei:RollerShutterUpDown.png|300px|Rollladen mit Pfeilen]]

So erhält man einen Slider für die Rollladenposition:

:<code>attr Velux_2 webCmd pct</code>

=== Dachschrägenfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachschrägenfenster in drei Stufen dar:

0% - 9%: geschlossen

10% - 59%: halb geöffnet

60% - 100%: ganz geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_4 limitationUpdateInterval 600</code>
:<code>attr Velux_4 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_4 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7\).*:weather_rain:toggle \d.$.*:fts_window_roof:toggle [1-5]\d.\(.*:fts_window_roof_open_1:toggle [6-9]\d.\(.*:fts_window_roof_open_2:toggle 100.\(.*:fts_window_roof_open_2:toggle</code>

=== Dachkuppelfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachkuppelfenster in zwei Stufen dar:

0% - 9%: geschlossen

10% - 100%: geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_5 limitationUpdateInterval 600</code>
:<code>attr Velux_5 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_5 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7$.*:weather_rain:toggle \d.\(.*:fts_light_dome:toggle [1-9]\d.\(.*:fts_light_dome_open:toggle 100.\(.*:fts_light_dome_open:toggle</code>

== Problembehebung ==
=== Verbindungsabbrüche ===
Sollte es zu Verbindungsabbrüchen zwischen FHEM und der KLF200-Box kommen, dann sind folgende Dinge zu überprüfen:
==== FHEM Update ====
Ist FHEM aktuell? Am 18.12.2018 gab es ein wichtiges FHEM-Update, das die Stabilität von SSL-Verbindungen wesentlich verbessert hat.
==== OpenSSL ====
OpenSLL sollte immer aktuell sein.
==== Perl SSL-Bibliotheken ====
Wenn die Perl SSL-Bibliotheken zu alt sind, ist das oben genannte FHEM-Update wirkungslos.
* IO::Socket::SSL
* Net::SSL
* Net::SSLeay
* Net::SSLeay::Handle
* Crypt::SSLeay
* Net::Server::Proto::SSL

=== Registrieren von Geräten an der KLF200-Box ===

Die [https://velcdn.azureedge.net/~/media/marketing/ch/fachleute/einbauanleitungen/elektro-nachrustung/zubehor/klf-200_bedienungsanleitung_basic%20de.pdf KLF200-Dokumentation] Seite 11 - 19 beschreibt 2 Varianten, um Geräte mit der Box zu koppeln.

==== 1. Registrierung mit einer Zweiweg-Bedienung ====
Dieser Weg funktioniert über die Schlüssel-Taste oder im Web-UI über PRODUKTE KOPIEREN.

Es ist eine Zweiweg-Bedienung erforderlich, die in der Lage ist, die IO-Schlüssel zu exportieren.

Dieser Weg geht z.B. mit dem Control Pad KLR200, Somfy TaHoma, [https://www.somfy.de/hilfe-center/faq/wie-binde-ich-produkte-ein-die-bereits-mit-einem-2-wege-sender-angesteuert-werden Nina io, Telis Composio io, Impresario Chronis io, Easy Sun io und Telis 1 io.].

TaHoma: anmelden, Menü "Sicherheitseinstellungen", Reiter "io-System", "SICHERHEITSSCHLÜSSEL SENDEN"

==== 2. Registrierung mit einer Einweg-Bedienung ====
Dieser Weg funktioniert über die Reset-Taste oder im Web-UI über PRODUKTSUCHE.

Hierzu wird das Gerät über eine Fernbedienung oder direkt am Gerät in einen Anlernzustand versetzt und dann einigen sich KLF200 und das Gerät über einen Schlüssel.

Bei manchen Somfy-Geräten scheint dieser Weg nicht zu funktionieren, z.B. einige Somfy Smoove Produkte. Hier bleibt nur die Möglichkeit, die Schlüssel wie in Variante 1 von einer Somfy Zweiweg-Bedienung zu kopieren.

=== WARNUNG vor Reset der KLF200-Box! ===
Sollten an der KLF200-Box schon Geräte registriert sein, dann ist ein Factory-Reset unbedingt zu vermeiden!
Die Geräte, die mit der KLF200 bereits Schlüssel ausgetauscht haben, lassen sich nicht ohne weiteres noch einmal registrieren.
Um diese Geräte nach einem Reset der KLF200 trotzdem zu registrieren, sind folgende Schritte notwendig:
# Die registrierten Geräte müssen komplett zurückgesetzt werden.
# Die entsprechenden Fernbedienungen müssen neu angelernt werden.
# Die Geräte können an der KLF200-Box registriert werden.

== Links ==
* Support im Forum gibt es unter {{Link2Forum|Topic=92907|LinkText=Velux KLF200 mit Firmware 2.0.0.71 für io-homecontrol}}
* Github: [https://github.com/buennerbernd/fhem/tree/master/KLF200/2.0 FHEM modules KLF200 and KLF200Node]

[[Kategorie:Rollladensteuerung]]
[[Kategorie:io-homecontrol]]
[[Kategorie:Other Components]]

Velux KLF200

2019-11-22T16:02:18Z

Buennerbernd:

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Anbindung io-homecontrol Aktoren an FHEM
|ModType=x
|ModCmdRef=KLF200
|ModFTopic=92907
|ModTechName=83_KLF200.pm
|ModOwner=buennerbernd ({{Link2FU|21440|Forum}} / [[Benutzer Diskussion:Buennerbernd|Wiki]])
}}

'''KLF200''' ist ein Modul zur Steuerung von '''io-homecontrol''' Aktoren über das Gateway Velux KLF 200.

== Velux KLF 200 ==

Die KLF-200-Box ist über LAN mit FHEM verbunden und steuert die Aktoren über das verschlüsselte Funkprotokoll ''io-homecontrol''.
Die Aktoren geben Rückmeldung über ihren aktuellen Zustand.

Die Box hat 10 elektrische Eingänge mit denen man 5 Geräte oder Gerätegruppen steuern kann.
Damit kann man z.B. mit Doppeltastern an der Wand seine Rollladen oder Fenster steuern.
Über den LAN-Anschluss lassen sich mit FHEM bis zu 200 Geräte mit einer KLF 200 verwalten.

Das Modul erfordert die Firmware-Version 2.0.0.71 und basiert auf der dokumentierten API von Velux. [https://www.velux.com/api/klf200 Download und weitere Informationen]

Das Gateway hat keine Cloud-Integration.

== Unterstützte Geräte ==

Grundsätzlich sollten alle io-homecontrol Aktoren funktionieren. Alleinstehende Sensoren (z.B. Lichtsensor, Windsensor) werden
von der KLF-200-Box nicht unterstützt. Es besteht aber die Möglichkeit, den Status von Sensoren auszuwerten, die in Aktoren integriert sind.

Aktuell werden folgende Geräte erfolgreich mit diesem Modul verwendet:

* Rollladen:
** VELUX SML
** VELUX SSL
** Somfy Oximo io
** Somfy RS100 io
** Somfy Izymo io
* Sichtschutz innen:
** VELUX FSK
** VELUX DML
* Fensteröffner mit integriertem Regensensor:
** VELUX KMG
** VELUX CVP
** VELUX KSX
* Markisen:
** VELUX MSL
** Somfy Sunea io
** Somfy Maestria+ 50 io

== Benutzung in FHEM ==
=== Vorbereitung ===
Bevor die Aktoren in FHEM verwendet werden können, müssen sie in der [[#Registrieren von Geräten an der KLF200-Box|KLF 200 angelernt]] werden.
Das geschieht über das WebUI der KLF 200, das über einen Wifi-Hotspot erreichbar ist. Dieser Vorgang ist im Handbuch beschrieben.
Im WebUI können die angeschlossenen Geräte auch benannt werden. Zusätzlich hat man die Möglichkeit, Programme (Szenen) aufzuzeichnen,
um ein oder mehrere Geräte in eine definierte Position zu bringen. Diese Szenen kann man aus FHEM ebenfalls ansteuern.

Das Modul wird momentan noch nicht über FHEM ausgeliefert.
Es wird wie folgt geladen und aktualisiert:

:<code>update all <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>
:<code>shutdown restart</code>

Mit diesem Befehl wird das Modul so eingerichtet, dass es ebenfalls aktualisiert wird, wenn man FHEM aktualisiert:
:<code>update add <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>

=== Anlegen der Geräte ===
:<code>define <name> KLF200 <host></code>
Beispiel:
:<code>define Velux KLF200 192.168.0.66</code>

Danach Login durch Eingabe des Passwortes:
:<code>set <name> login <password></code>

Hinweis: Das Passwort ist laut Dokumentation das Wifi-Passwort, das auf den Boden der Box gedruckt ist.
Das funktioniert bei einigen Nutzern. Bei vielen Nutzern funktioniert hingegen das Passwort des WebUI.
Scheinbar hängt das davon ab, mit welcher Firmware die Box ausgeliefert wurde und ob schon einmal ein Reset durchgeführt wurde.
Das Passwort wird verschleiert im FHEM-Backend gespeichert. Es muss nach erfolgreichem Login nicht mehr eingegeben werden.

Die angeschlossenen Aktoren werden jetzt durch autocreate als Instanzen von KLF200Node im Raum KLF200Node angelegt.
Die Namen der Geräte folgen dem Muster <name>_<NodeID>.
Wurde im WebUI der KLF200 ein Name für das Gerät vergeben dann wird dieser als Alias übernommen.

Die Geräte sind jetzt einsatzbereit.

== Modul KLF200 ==
=== Verbindungsstatus ===
==== STATE ====
Im STATE des Moduls sieht man den aktuellen Verbindungsstatus. Im Idealfall ist er nach der Initialisierung Logged in.
=== Ausführung von Programmen (Szenen) ===
Obwohl man mit dem Modul KLF200Node jedes Gerät unabhängig und auch gleichzeitig steuern kann, sind Szenen eine nützliche Ergänzung. So kann man mit Szenen wie "Alle zu" oder "Alle auf" viele Geräte gleichzeitig mit einem Befehl bedienen.

Hinweis: Während der Abarbeitung einer Szene werden weitere Befehle gepuffert.
==== scene/sceneID ====
Mit diesen Set-Funktionen kann man eine aufgezeichnete Szene aufrufen.
Im entsprechenden Reading steht die zuletzt aufgerufene Szene.

Die Zuordnung zwischen sceneID und scene sieht man in den Internals unter scenes.

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Bei vielen aktuellen Geräten lässt sich die Ausführungsgeschwindigkeit (Velocity) variieren. So lässt sich die Geschwindigkeit gegenüber der Default-Geschwindigkeit noch erhöhen oder auch deutlich reduzieren. So ist eine besonders leise Bedienung möglich.

==== Argument DEFAULT, FAST, SILENT ====
Die Velocity kann man bei der Ausführung von Szenen als zusätzliches Argument von set scene oder set sceneID setzen.
Unterstützte Werte sind DEFAULT, FAST und SILENT
:<code>set Velux scene "Alle zu" SILENT</code>
==== Attribut velocity ====
Alternativ kann man im Modul KLF200 das Attribut velocity setzen, das bei der Ausführung von Szenen herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

Hinweis: Dieses Attribut hat keine Auswirkungen auf Befehle, die vom Modul KLF200Node abgesetzt werden.

== Modul KLF200Node ==
Dieses Modul wurde dem Homematic-Modul CUL_HM nachempfunden, da es ebenfalls ein breites Spektrum an Geräten unterstützt
und möglichst kompatibel zu vorhandenen Hilfsmodulen sein soll.
=== Aktueller Status ===
Im Folgenden wird der Zusammenhang zwischen den wichtigsten Readings/Set-Funktionen pct, state, execution erklärt.
==== pct ====
Dieses Reading enthält den aktuell bekannten Status des Gerätes in Prozent.

Wird das Gerät über die KLF-200-Box gesteuert, wird das Reading beim Erreichen der Zielposition sofort aktualisiert.

Wird das Gerät über eine Fernbedienung oder einen Sensor gesteuert, kann sich die Aktualisierung wenige Minuten verzögern.

Mit der Set-Funktion kann man das Gerät in diesen Status versetzen.
Per Default entspricht 100 auf der Fernbedienung oben und 0 unten.
==== state ====
Dieses Reading entspricht dem Reading pct, mit der Ausnahme, dass 0 durch '''off''' ersetzt wird und 100 durch '''on'''.

Die Set-Funktion funktioniert analog.
Per Default entspricht on auf der Fernbedienung oben und off unten.

Es werden die '''set extensions''' unterstützt. Damit können mit einem Set ein oder mehrere Befehle zeitgesteuert abgesetzt werden.

Doku: [https://fhem.de/commandref_DE.html#set set extensions in der commandref] und im [[DevelopmentModuleIntro#X_Set]] jeweils etwas weiter unten.

==== execution ====
Dieses Reading gibt den aktuellen Ausführungsstatus wieder. Die meiste Zeit ist der Wert stop.
Wird gerade ein Befehl ausgeführt, ist der Wert up oder down.

Mit der Set-Funktion werden entsprechende Befehle ausgeführt, up entspricht auf der Fernbedienung oben und down unten.
Bei stop wird die aktuelle Ausführung angehalten.

==== Attribut directionOn ====
Wie oben beschrieben, entspricht per Default on = 100 = up.

Das kann bei bestimmten Geräten für manchen Nutzer verwirrend sein.
Wenn man z.B. bei einem Rollladen lieber im geschlossenen Zustand 100 Prozent sehen möchte, dann setzt man das Attribut directionOn, z.B.
:<code>attr Velux_2 directionOn down</code>

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Wie bei Szenen lässt sich auch bei Kommandos auf KLF200Node die Ausführungsgeschwindigkeit beeinflussen, soweit das vom Gerät unterstützt ist.
==== Reading velocity ====
Dieses Reading hat den Wert supported, wenn die Geschwindigkeit bei diesem Gerät geändert werden kann.
Selbst bei Not supported wäre es einen Versuch wert, es zu testen.
==== Argument DEFAULT, FAST, SILENT ====
Alle set-Funktionen, die eine Bewegung auslösen unterstützen das optionale Argument DEFAULT, FAST oder SILENT.
==== Attribut velocity ====
Alternativ kann man im Modul KLF200Node das Attribut velocity setzen, das bei der Ausführung von Kommandos herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

=== Raw-Befehle zum Testen von unbekannten Geräten ===
Die bisher beschriebenen Funktionen des KLF200Node-Moduls bieten einen vereinfachten Zugang zu io-homecontrol-Geräten mit nur einem Motor.

Intern wird bei diesen Funktionen der MainParameter (MP) für die Steuerung des Motors und der Functional Parameter 1 (FP1) für die Velocity gesetzt.
Theoretisch können Geräte bis zu 16 Functional Parameter (FP1 bis FP16) haben. Der Wertebereich aller Parameter ist 0 - 65535, wobei sich 0 - 100% auf 0 - 51200 abbilden.

'''Für Experten''' bietet die Funktion '''set raw''' die Möglichkeit, mehrere Parameter gleichzeitig zu setzen. Damit lassen sich dann z.B. die Lamellen von Raffstores bewegen.
Zuvor wird empfohlen, in der [https://velcdn.azureedge.net/~/media/com/api/klf200/technical%20specification%20for%20klf%20200%20api-ver3-16.pdf KLF 200 API] die folgenden Kapitel zu lesen:
* 10.1.1 GW_COMMAND_SEND_REQ
* 10.1.1.4 ParameterActive parameter
* 13 Appendix 1: Standard Parameter definition
* 14 Appendix 2: List of actuator types and their use of Main Parameter and Functional Parameters

Beispiel-Aufrufe:
:<code>set Velux_1 raw MP=51200</code>
:<code>set Velux_2 raw MP=0 FP1=51200</code>
:<code>set Velux_3 raw ParameterActive=3 FP3=25600 FP2=51200</code>

Beim Aufruf muss man sich für einen Parameter entscheiden, von dem man Feedback erhalten will. Diesen wählt man mit ParameterActive aus. Default ist ParameterActive=0 für MP. Ein Functional Parameter kann mit 1 - 16 ausgewählt werden.
Die aktuell bekannten Werte stehen in den Readings MP und FP1 bis FP16, wobei nur Readings für tatsächlich genutzte Parameter angelegt werden.

Die Funktion '''set updateCurrentPosition''' aktualisiert die Readings MP und FP1 - FP7, falls vorhanden.

Wenn sich Nutzer melden sollten, die auf diese Weise Geräte mit mehreren Motoren getestet haben, dann kann entschieden werden, wie dieses Modul auf sinnvolle Weise weiterentwickelt werden kann.

=== Begrenzung des Bewegungsradius / Limitation ===
Die io-homecontrol Geräte haben ein Feature eingebaut, um den Bewegungsradius der Geräte einzuschränken, egal von wo aus sie gesteuert werden. Dieses Limitation-Feature ist in dieses FHEM-Modul ebenfalls integriert.
==== limitationMin und limitationMax ====
Mit den Settern und Readings limitationMin und limitationMax kann man die Limitation setzen und auslesen.
Natürlich kann man auch selbst von der Limitation Gebrauch machen. Man kann z.B. einen Rollladen begrenzen, wenn man weiß, dass das Dachfenster weit offen ist. Dann kann der Rollladen nicht gegen das Fenster stoßen, selbst wenn man ihn mit der Fernbedienung bewegt.
==== limiationClear ====
Mit dem Setter limiationClear kann man alle Limitations (auch von fremden Geräten ausgelöste) löschen.
==== updateLimiation ====
Der Setter updateLimiation aktualisiert die Readings limitationMin und limitationMax auf diesem Gerät, falls die Limitation außerhalb von FHEM gesetzt wurde.

=== Auswerten der Regensensoren ===
Die Regensensoren von Velux Fensteröffnern machen von diesem Limitation-Feature Gebrauch. Wenn es regnet, wird der Bewegungsradius der Fenster eingeschränkt. Zum Beispiel (evtl. Geräte-abhängig):
* limitationMax = 7 bei Regen,
* limitationMax = 100 wenn es aufhört.
Diese Werte kann man auslesen, ohne dass sich das Fenster dazu bewegt haben muss.

==== limitationUpdateInterval ====
Mit set limitationUpdateInterval kann man festlegen, wie oft diese Werte ausgelesen werden:
* off: Dieser Wert ist für Geräte ohne integrierte Sensoren der Beste, denn zusätzliche Updates sind überflüssig.
* onChange: Hier wird limitationMin und limitationMax aktualisiert, wenn das Gerät bewegt wurde.
* interval in s: Ein Poll-Intervall in Sekunden. Tests mit 120 sind erfolgreich durchgelaufen. Dieser Wert ist vielleicht etwas übertrieben, man denke an das Funkfeuer und den Akku der Geräte. Ein Intervall von 600 ist vielleicht sinnvoller. Beispiele:
:<code>set Velux_1 limitationUpdateInterval off</code>
:<code>set Velux_2 limitationUpdateInterval onChange</code>
:<code>set Velux_3 limitationUpdateInterval 600</code>

==== Extra Reading für den Regensensor ====
Wem die Auswertung vom Reading limitationMax zu indirekt ist, der kann sich ein neues Reading anlegen.
Der folgende Code legt ein Reading namens sensor an, die Werte sind im Beispiel "Regen" oder "trocken".
Es besteht die Annahme, dass bei limitationMax = 7 der Regensensor angeschlagen hat.
:<code>attr Velux_3 userReadings sensor {(ReadingsVal($name,"limitationMax",100) == 7)?"Regen":"trocken"}</code>
Hinweis: Das neue Reading sensor erscheint erst, wenn das Reading limitationMax einmal aktualisiert wurde.

== Vorschläge zur schöneren Darstellung ==
Wie Homematic-Geräte kommt KLF200Node im FHEM-Web sehr schlicht daher. Dieses Kapitel gibt Vorschläge zur Konfiguration einer schöneren Darstellung.

=== Rollladen ===
Dieses Beispiel stellt den Status des Rollladen 10-Prozent genau im Icon dar. Bewegen sich der Rollladen, hat das Icon einen Pfeil nach oben oder unten. Ein Klick auf das Icon setzt den Rollladen in Bewegung oder hält ihn an (toggle).

:<code>attr Velux_2 stateFormat pct execution</code>
:<code>attr Velux_2 devStateIcon .*up:fts_shutter_up:toggle .*down:fts_shutter_down:toggle \d.stop:fts_shutter_100:toggle 1\d.stop:fts_shutter_90:toggle 2\d.stop:fts_shutter_80:toggle 3\d.stop:fts_shutter_70:toggle 4\d.stop:fts_shutter_60:toggle 5\d.stop:fts_shutter_50:toggle 6\d.stop:fts_shutter_40:toggle 7\d.stop:fts_shutter_30:toggle 8\d.stop:fts_shutter_20:toggle 9\d.stop:fts_shutter_10:toggle 100.stop:fts_window_2w:toggle</code>
[[Datei:RollerShutterUpDown.png|300px|Rollladen mit Pfeilen]]

So erhält man einen Slider für die Rollladenposition:

:<code>attr Velux_2 webCmd pct</code>

=== Dachschrägenfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachschrägenfenster in drei Stufen dar:

0% - 9%: geschlossen

10% - 59%: halb geöffnet

60% - 100%: ganz geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_4 limitationUpdateInterval 600</code>
:<code>attr Velux_4 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_4 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7\).*:weather_rain:toggle \d.$.*:fts_window_roof:toggle [1-5]\d.\(.*:fts_window_roof_open_1:toggle [6-9]\d.\(.*:fts_window_roof_open_2:toggle 100.\(.*:fts_window_roof_open_2:toggle</code>

=== Dachkuppelfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachkuppelfenster in zwei Stufen dar:

0% - 9%: geschlossen

10% - 100%: geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_5 limitationUpdateInterval 600</code>
:<code>attr Velux_5 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_5 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7$.*:weather_rain:toggle \d.\(.*:fts_light_dome:toggle [1-9]\d.\(.*:fts_light_dome_open:toggle 100.\(.*:fts_light_dome_open:toggle</code>

== Problembehebung ==
=== Verbindungsabbrüche ===
Sollte es zu Verbindungsabbrüchen zwischen FHEM und der KLF200-Box kommen, dann sind folgende Dinge zu überprüfen:
==== FHEM Update ====
Ist FHEM aktuell? Am 18.12.2018 gab es ein wichtiges FHEM-Update, das die Stabilität von SSL-Verbindungen wesentlich verbessert hat.
==== OpenSSL ====
OpenSLL sollte immer aktuell sein.
==== Perl SSL-Bibliotheken ====
Wenn die Perl SSL-Bibliotheken zu alt sind, ist das oben genannte FHEM-Update wirkungslos.
* IO::Socket::SSL
* Net::SSL
* Net::SSLeay
* Net::SSLeay::Handle
* Crypt::SSLeay
* Net::Server::Proto::SSL

=== Registrieren von Geräten an der KLF200-Box ===

Die [https://velcdn.azureedge.net/~/media/marketing/ch/fachleute/einbauanleitungen/elektro-nachrustung/zubehor/klf-200_bedienungsanleitung_basic%20de.pdf KLF200-Dokumentation] Seite 11 - 19 beschreibt 2 Varianten, um Geräte mit der Box zu koppeln.

==== 1. Registrierung mit einer Zweiweg-Bedienung ====
Dieser Weg funktioniert über die Schlüssel-Taste oder im Web-UI über PRODUKTE KOPIEREN.

Es ist eine Zweiweg-Bedienung erforderlich, die in der Lage ist, die IO-Schlüssel zu exportieren.

Dieser Weg geht z.B. mit dem Control Pad KLR200, Somfy TaHoma, [https://www.somfy.de/hilfe-center/faq/wie-binde-ich-produkte-ein-die-bereits-mit-einem-2-wege-sender-angesteuert-werden Nina io, Telis Composio io, Impresario Chronis io, Easy Sun io und Telis 1 io.].

TaHoma: anmelden, Menü "Sicherheitseinstellungen", Reiter "io-System", "SICHERHEITSSCHLÜSSEL SENDEN"

==== 2. Registrierung mit einer Einweg-Bedienung ====
Dieser Weg funktioniert über die Reset-Taste oder im Web-UI über PRODUKTSUCHE.

Hierzu wird das Gerät über eine Fernbedienung oder direkt am Gerät in einen Anlernzustand versetzt und dann einigen sich KLF200 und das Gerät über einen Schlüssel.

Bei manchen Somfy-Geräten scheint dieser Weg nicht zu funktionieren, z.B. einige Somfy Smoove Produkte. Hier bleibt nur die Möglichkeit, die Schlüssel wie in Variante 1 von einer Somfy Zweiweg-Bedienung zu kopieren.

=== WARNUNG vor Reset der KLF200-Box! ===
Sollten an der KLF200-Box schon Geräte registriert sein, dann ist ein Factory-Reset unbedingt zu vermeiden!
Die Geräte, die mit der KLF200 bereits Schlüssel ausgetauscht haben, lassen sich nicht ohne weiteres noch einmal registrieren.
Um diese Geräte nach einem Reset der KLF200 trotzdem zu registrieren, sind folgende Schritte notwendig:
# Die registrierten Geräte müssen komplett zurückgesetzt werden.
# Die entsprechenden Fernbedienungen müssen neu angelernt werden.
# Die Geräte können an der KLF200-Box registriert werden.

== Links ==
* Support im Forum gibt es unter {{Link2Forum|Topic=92907|LinkText=Velux KLF200 mit Firmware 2.0.0.71 für io-homecontrol}}
* Github: [https://github.com/buennerbernd/fhem/tree/master/KLF200/2.0 FHEM modules KLF200 and KLF200Node]

[[Kategorie:Rollladensteuerung]]
[[Kategorie:io-homecontrol]]
[[Kategorie:Other Components]]

Velux KLF200

2019-10-23T10:56:50Z

Buennerbernd: /* Unterstützte Geräte */

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Anbindung io-homecontrol Aktoren an FHEM
|ModType=x
|ModCmdRef=KLF200
|ModFTopic=92907
|ModTechName=83_KLF200.pm
|ModOwner=buennerbernd ({{Link2FU|21440|Forum}} / [[Benutzer Diskussion:Buennerbernd|Wiki]])
}}

'''KLF200''' ist ein Modul zur Steuerung von '''io-homecontrol''' Aktoren über das Gateway Velux KLF 200.

== Velux KLF 200 ==

Die KLF-200-Box ist über LAN mit FHEM verbunden und steuert die Aktoren über das verschlüsselte Funkprotokoll ''io-homecontrol''.
Die Aktoren geben Rückmeldung über ihren aktuellen Zustand.

Die Box hat 10 elektrische Eingänge mit denen man 5 Geräte oder Gerätegruppen steuern kann.
Damit kann man z.B. mit Doppeltastern an der Wand seine Rollladen oder Fenster steuern.
Über den LAN-Anschluss lassen sich mit FHEM bis zu 200 Geräte mit einer KLF 200 verwalten.

Das Modul erfordert die Firmware-Version 2.0.0.71 und basiert auf der dokumentierten API von Velux. [https://www.velux.com/api/klf200 Download und weitere Informationen]

Das Gateway hat keine Cloud-Integration.

== Unterstützte Geräte ==

Grundsätzlich sollten alle io-homecontrol Aktoren funktionieren. Alleinstehende Sensoren (z.B. Lichtsensor, Windsensor) werden
von der KLF-200-Box nicht unterstützt. Es besteht aber die Möglichkeit, den Status von Sensoren auszuwerten, die in Aktoren integriert sind.

Aktuell werden folgende Geräte erfolgreich mit diesem Modul verwendet:

* Rollladen:
** VELUX SML
** VELUX SSL
** Somfy Oximo io
** Somfy RS100 io
** Somfy Izymo io
* Sichtschutz innen:
** VELUX FSK
** VELUX DML
* Fensteröffner mit integriertem Regensensor:
** VELUX KMG
** VELUX CVP
** VELUX KSX
* Markisen:
** VELUX MSL
** Somfy Sunea io
** Somfy Maestria+ 50 io

== Benutzung in FHEM ==
=== Vorbereitung ===
Bevor die Aktoren in FHEM verwendet werden können, müssen sie in der [[#Registrieren von Geräten an der KLF200-Box|KLF 200 angelernt]] werden.
Das geschieht über das WebUI der KLF 200, das über einen Wifi-Hotspot erreichbar ist. Dieser Vorgang ist im Handbuch beschrieben.
Im WebUI können die angeschlossenen Geräte auch benannt werden. Zusätzlich hat man die Möglichkeit, Programme (Szenen) aufzuzeichnen,
um ein oder mehrere Geräte in eine definierte Position zu bringen. Diese Szenen kann man aus FHEM ebenfalls ansteuern.

Das Modul wird momentan noch nicht über FHEM ausgeliefert.
Es wird wie folgt geladen und aktualisiert:

:<code>update all <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>
:<code>shutdown restart</code>

Mit diesem Befehl wird das Modul so eingerichtet, dass es ebenfalls aktualisiert wird, wenn man FHEM aktualisiert:
:<code>update add <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>

=== Anlegen der Geräte ===
:<code>define <name> KLF200 <host></code>
Beispiel:
:<code>define Velux KLF200 192.168.0.66</code>

Danach Login durch Eingabe des Passwortes:
:<code>set <name> login <password></code>

Hinweis: Das Passwort ist laut Dokumentation das Wifi-Passwort, das auf den Boden der Box gedruckt ist.
Das funktioniert bei einigen Nutzern. Bei vielen Nutzern funktioniert hingegen das Passwort des WebUI.
Scheinbar hängt das davon ab, mit welcher Firmware die Box ausgeliefert wurde und ob schon einmal ein Reset durchgeführt wurde.
Das Passwort wird verschleiert im FHEM-Backend gespeichert. Es muss nach erfolgreichem Login nicht mehr eingegeben werden.

Die angeschlossenen Aktoren werden jetzt durch autocreate als Instanzen von KLF200Node im Raum KLF200Node angelegt.
Die Namen der Geräte folgen dem Muster <name>_<NodeID>.
Wurde im WebUI der KLF200 ein Name für das Gerät vergeben dann wird dieser als Alias übernommen.

Die Geräte sind jetzt einsatzbereit.

== Modul KLF200 ==
=== Verbindungsstatus ===
==== STATE ====
Im STATE des Moduls sieht man den aktuellen Verbindungsstatus. Im Idealfall ist er nach der Initialisierung Logged in.
=== Ausführung von Programmen (Szenen) ===
Obwohl man mit dem Modul KLF200Node jedes Gerät unabhängig und auch gleichzeitig steuern kann, sind Szenen eine nützliche Ergänzung. So kann man mit Szenen wie "Alle zu" oder "Alle auf" viele Geräte gleichzeitig mit einem Befehl bedienen.

Hinweis: Während der Abarbeitung einer Szene werden weitere Befehle gepuffert.
==== scene/sceneID ====
Mit diesen Set-Funktionen kann man eine aufgezeichnete Szene aufrufen.
Im entsprechenden Reading steht die zuletzt aufgerufene Szene.

Die Zuordnung zwischen sceneID und scene sieht man in den Internals unter scenes.

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Bei vielen aktuellen Geräten lässt sich die Ausführungsgeschwindigkeit (Velocity) variieren. So lässt sich die Geschwindigkeit gegenüber der Default-Geschwindigkeit noch erhöhen oder auch deutlich reduzieren. So ist eine besonders leise Bedienung möglich.

==== Argument DEFAULT, FAST, SILENT ====
Die Velocity kann man bei der Ausführung von Szenen als zusätzliches Argument von set scene oder set sceneID setzen.
Unterstützte Werte sind DEFAULT, FAST und SILENT
:<code>set Velux scene "Alle zu" SILENT</code>
==== Attribut velocity ====
Alternativ kann man im Modul KLF200 das Attribut velocity setzen, das bei der Ausführung von Szenen herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

Hinweis: Dieses Attribut hat keine Auswirkungen auf Befehle, die vom Modul KLF200Node abgesetzt werden.

== Modul KLF200Node ==
Dieses Modul wurde dem Homematic-Modul CUL_HM nachempfunden, da es ebenfalls ein breites Spektrum an Geräten unterstützt
und möglichst kompatibel zu vorhandenen Hilfsmodulen sein soll.
=== Aktueller Status ===
Im Folgenden wird der Zusammenhang zwischen den wichtigsten Readings/Set-Funktionen pct, state, execution erklärt.
==== pct ====
Dieses Reading enthält den aktuell bekannten Status des Gerätes in Prozent.

Wird das Gerät über die KLF-200-Box gesteuert, wird das Reading beim Erreichen der Zielposition sofort aktualisiert.

Wird das Gerät über eine Fernbedienung oder einen Sensor gesteuert, kann sich die Aktualisierung wenige Minuten verzögern.

Mit der Set-Funktion kann man das Gerät in diesen Status versetzen.
Per Default entspricht 100 auf der Fernbedienung oben und 0 unten.
==== state ====
Dieses Reading entspricht dem Reading pct, mit der Ausnahme, dass 0 durch '''off''' ersetzt wird und 100 durch '''on'''.

Die Set-Funktion funktioniert analog.
Per Default entspricht on auf der Fernbedienung oben und off unten.

Es werden die '''set extensions''' unterstützt. Damit können mit einem Set ein oder mehrere Befehle zeitgesteuert abgesetzt werden.

Doku: [https://fhem.de/commandref_DE.html#set set extensions in der commandref] und im [[DevelopmentModuleIntro#X_Set]] jeweils etwas weiter unten.

==== execution ====
Dieses Reading gibt den aktuellen Ausführungsstatus wieder. Die meiste Zeit ist der Wert stop.
Wird gerade ein Befehl ausgeführt, ist der Wert up oder down.

Mit der Set-Funktion werden entsprechende Befehle ausgeführt, up entspricht auf der Fernbedienung oben und down unten.
Bei stop wird die aktuelle Ausführung angehalten.

==== Attribut directionOn ====
Wie oben beschrieben, entspricht per Default on = 100 = up.

Das kann bei bestimmten Geräten für manchen Nutzer verwirrend sein.
Wenn man z.B. bei einem Rollladen lieber im geschlossenen Zustand 100 Prozent sehen möchte, dann setzt man das Attribut directionOn, z.B.
:<code>attr Velux_2 directionOn down</code>

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Wie bei Szenen lässt sich auch bei Kommandos auf KLF200Node die Ausführungsgeschwindigkeit beeinflussen, soweit das vom Gerät unterstützt ist.
==== Reading velocity ====
Dieses Reading hat den Wert supported, wenn die Geschwindigkeit bei diesem Gerät geändert werden kann.
Selbst bei Not supported wäre es einen Versuch wert, es zu testen.
==== Argument DEFAULT, FAST, SILENT ====
Alle set-Funktionen, die eine Bewegung auslösen unterstützen das optionale Argument DEFAULT, FAST oder SILENT.
==== Attribut velocity ====
Alternativ kann man im Modul KLF200Node das Attribut velocity setzen, das bei der Ausführung von Kommandos herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

=== Begrenzung des Bewegungsradius / Limitation ===
Die io-homecontrol Geräte haben ein Feature eingebaut, um den Bewegungsradius der Geräte einzuschränken, egal von wo aus sie gesteuert werden. Dieses Limitation-Feature ist in dieses FHEM-Modul ebenfalls integriert.
==== limitationMin und limitationMax ====
Mit den Settern und Readings limitationMin und limitationMax kann man die Limitation setzen und auslesen.
Natürlich kann man auch selbst von der Limitation Gebrauch machen. Man kann z.B. einen Rollladen begrenzen, wenn man weiß, dass das Dachfenster weit offen ist. Dann kann der Rollladen nicht gegen das Fenster stoßen, selbst wenn man ihn mit der Fernbedienung bewegt.
==== limiationClear ====
Mit dem Setter limiationClear kann man alle Limitations (auch von fremden Geräten ausgelöste) löschen.
==== updateLimiation ====
Der Setter updateLimiation aktualisiert die Readings limitationMin und limitationMax auf diesem Gerät, falls die Limitation außerhalb von FHEM gesetzt wurde.

=== Auswerten der Regensensoren ===
Die Regensensoren von Velux Fensteröffnern machen von diesem Limitation-Feature Gebrauch. Wenn es regnet, wird der Bewegungsradius der Fenster eingeschränkt. Zum Beispiel (evtl. Geräte-abhängig):
* limitationMax = 7 bei Regen,
* limitationMax = 100 wenn es aufhört.
Diese Werte kann man auslesen, ohne dass sich das Fenster dazu bewegt haben muss.

==== limitationUpdateInterval ====
Mit set limitationUpdateInterval kann man festlegen, wie oft diese Werte ausgelesen werden:
* off: Dieser Wert ist für Geräte ohne integrierte Sensoren der Beste, denn zusätzliche Updates sind überflüssig.
* onChange: Hier wird limitationMin und limitationMax aktualisiert, wenn das Gerät bewegt wurde.
* interval in s: Ein Poll-Intervall in Sekunden. Tests mit 120 sind erfolgreich durchgelaufen. Dieser Wert ist vielleicht etwas übertrieben, man denke an das Funkfeuer und den Akku der Geräte. Ein Intervall von 600 ist vielleicht sinnvoller. Beispiele:
:<code>set Velux_1 limitationUpdateInterval off</code>
:<code>set Velux_2 limitationUpdateInterval onChange</code>
:<code>set Velux_3 limitationUpdateInterval 600</code>

==== Extra Reading für den Regensensor ====
Wem die Auswertung vom Reading limitationMax zu indirekt ist, der kann sich ein neues Reading anlegen.
Der folgende Code legt ein Reading namens sensor an, die Werte sind im Beispiel "Regen" oder "trocken".
Es besteht die Annahme, dass bei limitationMax = 7 der Regensensor angeschlagen hat.
:<code>attr Velux_3 userReadings sensor {(ReadingsVal($name,"limitationMax",100) == 7)?"Regen":"trocken"}</code>
Hinweis: Das neue Reading sensor erscheint erst, wenn das Reading limitationMax einmal aktualisiert wurde.

== Vorschläge zur schöneren Darstellung ==
Wie Homematic-Geräte kommt KLF200Node im FHEM-Web sehr schlicht daher. Dieses Kapitel gibt Vorschläge zur Konfiguration einer schöneren Darstellung.

=== Rollladen ===
Dieses Beispiel stellt den Status des Rollladen 10-Prozent genau im Icon dar. Bewegen sich der Rollladen, hat das Icon einen Pfeil nach oben oder unten. Ein Klick auf das Icon setzt den Rollladen in Bewegung oder hält ihn an (toggle).

:<code>attr Velux_2 stateFormat pct execution</code>
:<code>attr Velux_2 devStateIcon .*up:fts_shutter_up:toggle .*down:fts_shutter_down:toggle \d.stop:fts_shutter_100:toggle 1\d.stop:fts_shutter_90:toggle 2\d.stop:fts_shutter_80:toggle 3\d.stop:fts_shutter_70:toggle 4\d.stop:fts_shutter_60:toggle 5\d.stop:fts_shutter_50:toggle 6\d.stop:fts_shutter_40:toggle 7\d.stop:fts_shutter_30:toggle 8\d.stop:fts_shutter_20:toggle 9\d.stop:fts_shutter_10:toggle 100.stop:fts_window_2w:toggle</code>
[[Datei:RollerShutterUpDown.png|300px|Rollladen mit Pfeilen]]

So erhält man einen Slider für die Rollladenposition:

:<code>attr Velux_2 webCmd pct</code>

=== Dachschrägenfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachschrägenfenster in drei Stufen dar:

0% - 9%: geschlossen

10% - 59%: halb geöffnet

60% - 100%: ganz geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_4 limitationUpdateInterval 600</code>
:<code>attr Velux_4 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_4 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7\).*:weather_rain:toggle \d.$.*:fts_window_roof:toggle [1-5]\d.\(.*:fts_window_roof_open_1:toggle [6-9]\d.\(.*:fts_window_roof_open_2:toggle 100.\(.*:fts_window_roof_open_2:toggle</code>

=== Dachkuppelfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachkuppelfenster in zwei Stufen dar:

0% - 9%: geschlossen

10% - 100%: geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_5 limitationUpdateInterval 600</code>
:<code>attr Velux_5 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_5 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7$.*:weather_rain:toggle \d.\(.*:fts_light_dome:toggle [1-9]\d.\(.*:fts_light_dome_open:toggle 100.\(.*:fts_light_dome_open:toggle</code>

== Problembehebung ==
=== Verbindungsabbrüche ===
Sollte es zu Verbindungsabbrüchen zwischen FHEM und der KLF200-Box kommen, dann sind folgende Dinge zu überprüfen:
==== FHEM Update ====
Ist FHEM aktuell? Am 18.12.2018 gab es ein wichtiges FHEM-Update, das die Stabilität von SSL-Verbindungen wesentlich verbessert hat.
==== OpenSSL ====
OpenSLL sollte immer aktuell sein.
==== Perl SSL-Bibliotheken ====
Wenn die Perl SSL-Bibliotheken zu alt sind, ist das oben genannte FHEM-Update wirkungslos.
* IO::Socket::SSL
* Net::SSL
* Net::SSLeay
* Net::SSLeay::Handle
* Crypt::SSLeay
* Net::Server::Proto::SSL

=== Registrieren von Geräten an der KLF200-Box ===

Die [https://velcdn.azureedge.net/~/media/marketing/ch/fachleute/einbauanleitungen/elektro-nachrustung/zubehor/klf-200_bedienungsanleitung_basic%20de.pdf KLF200-Dokumentation] Seite 11 - 19 beschreibt 2 Varianten, um Geräte mit der Box zu koppeln.

==== 1. Registrierung mit einer Zweiweg-Bedienung ====
Dieser Weg funktioniert über die Schlüssel-Taste oder im Web-UI über PRODUKTE KOPIEREN.

Es ist eine Zweiweg-Bedienung erforderlich, die in der Lage ist, die IO-Schlüssel zu exportieren.

Dieser Weg geht z.B. mit dem Control Pad KLR200, Somfy TaHoma, [https://www.somfy.de/hilfe-center/faq/wie-binde-ich-produkte-ein-die-bereits-mit-einem-2-wege-sender-angesteuert-werden Nina io, Telis Composio io, Impresario Chronis io, Easy Sun io und Telis 1 io.].

TaHoma: anmelden, Menü "Sicherheitseinstellungen", Reiter "io-System", "SICHERHEITSSCHLÜSSEL SENDEN"

==== 2. Registrierung mit einer Einweg-Bedienung ====
Dieser Weg funktioniert über die Reset-Taste oder im Web-UI über PRODUKTSUCHE.

Hierzu wird das Gerät über eine Fernbedienung oder direkt am Gerät in einen Anlernzustand versetzt und dann einigen sich KLF200 und das Gerät über einen Schlüssel.

Bei manchen Somfy-Geräten scheint dieser Weg nicht zu funktionieren, z.B. einige Somfy Smoove Produkte. Hier bleibt nur die Möglichkeit, die Schlüssel wie in Variante 1 von einer Somfy Zweiweg-Bedienung zu kopieren.

=== WARNUNG vor Reset der KLF200-Box! ===
Sollten an der KLF200-Box schon Geräte registriert sein, dann ist ein Factory-Reset unbedingt zu vermeiden!
Die Geräte, die mit der KLF200 bereits Schlüssel ausgetauscht haben, lassen sich nicht ohne weiteres noch einmal registrieren.
Um diese Geräte nach einem Reset der KLF200 trotzdem zu registrieren, sind folgende Schritte notwendig:
# Die registrierten Geräte müssen komplett zurückgesetzt werden.
# Die entsprechenden Fernbedienungen müssen neu angelernt werden.
# Die Geräte können an der KLF200-Box registriert werden.

== Links ==
* Support im Forum gibt es unter {{Link2Forum|Topic=92907|LinkText=Velux KLF200 mit Firmware 2.0.0.71 für io-homecontrol}}
* Github: [https://github.com/buennerbernd/fhem/tree/master/KLF200/2.0 FHEM modules KLF200 and KLF200Node]

[[Kategorie:Rollladensteuerung]]
[[Kategorie:io-homecontrol]]
[[Kategorie:Other Components]]

Velux KLF200

2019-10-22T13:34:41Z

Buennerbernd: /* Unterstützte Geräte */

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Anbindung io-homecontrol Aktoren an FHEM
|ModType=x
|ModCmdRef=KLF200
|ModFTopic=92907
|ModTechName=83_KLF200.pm
|ModOwner=buennerbernd ({{Link2FU|21440|Forum}} / [[Benutzer Diskussion:Buennerbernd|Wiki]])
}}

'''KLF200''' ist ein Modul zur Steuerung von '''io-homecontrol''' Aktoren über das Gateway Velux KLF 200.

== Velux KLF 200 ==

Die KLF-200-Box ist über LAN mit FHEM verbunden und steuert die Aktoren über das verschlüsselte Funkprotokoll ''io-homecontrol''.
Die Aktoren geben Rückmeldung über ihren aktuellen Zustand.

Die Box hat 10 elektrische Eingänge mit denen man 5 Geräte oder Gerätegruppen steuern kann.
Damit kann man z.B. mit Doppeltastern an der Wand seine Rollladen oder Fenster steuern.
Über den LAN-Anschluss lassen sich mit FHEM bis zu 200 Geräte mit einer KLF 200 verwalten.

Das Modul erfordert die Firmware-Version 2.0.0.71 und basiert auf der dokumentierten API von Velux. [https://www.velux.com/api/klf200 Download und weitere Informationen]

Das Gateway hat keine Cloud-Integration.

== Unterstützte Geräte ==

Grundsätzlich sollten alle io-homecontrol Aktoren funktionieren. Alleinstehende Sensoren (z.B. Lichtsensor, Windsensor) werden
von der KLF-200-Box nicht unterstützt. Es besteht aber die Möglichkeit, den Status von Sensoren auszuwerten, die in Aktoren integriert sind.

Aktuell werden folgende Geräte erfolgreich mit diesem Modul verwendet:

* Rollladen:
** VELUX SML
** VELUX SSL
** Somfy Oximo io
** Somfy RS100 io
** Somfy Izymo io
* Sichtschutz innen:
** VELUX FSK
** VELUX DML
* Fensteröffner mit integriertem Regensensor:
** VELUX KMG
** VELUX CVP
** VELUX KSX
* Markisen:
** VELUX MSL
** Somfy Sunea io

== Benutzung in FHEM ==
=== Vorbereitung ===
Bevor die Aktoren in FHEM verwendet werden können, müssen sie in der [[#Registrieren von Geräten an der KLF200-Box|KLF 200 angelernt]] werden.
Das geschieht über das WebUI der KLF 200, das über einen Wifi-Hotspot erreichbar ist. Dieser Vorgang ist im Handbuch beschrieben.
Im WebUI können die angeschlossenen Geräte auch benannt werden. Zusätzlich hat man die Möglichkeit, Programme (Szenen) aufzuzeichnen,
um ein oder mehrere Geräte in eine definierte Position zu bringen. Diese Szenen kann man aus FHEM ebenfalls ansteuern.

Das Modul wird momentan noch nicht über FHEM ausgeliefert.
Es wird wie folgt geladen und aktualisiert:

:<code>update all <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>
:<code>shutdown restart</code>

Mit diesem Befehl wird das Modul so eingerichtet, dass es ebenfalls aktualisiert wird, wenn man FHEM aktualisiert:
:<code>update add <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>

=== Anlegen der Geräte ===
:<code>define <name> KLF200 <host></code>
Beispiel:
:<code>define Velux KLF200 192.168.0.66</code>

Danach Login durch Eingabe des Passwortes:
:<code>set <name> login <password></code>

Hinweis: Das Passwort ist laut Dokumentation das Wifi-Passwort, das auf den Boden der Box gedruckt ist.
Das funktioniert bei einigen Nutzern. Bei vielen Nutzern funktioniert hingegen das Passwort des WebUI.
Scheinbar hängt das davon ab, mit welcher Firmware die Box ausgeliefert wurde und ob schon einmal ein Reset durchgeführt wurde.
Das Passwort wird verschleiert im FHEM-Backend gespeichert. Es muss nach erfolgreichem Login nicht mehr eingegeben werden.

Die angeschlossenen Aktoren werden jetzt durch autocreate als Instanzen von KLF200Node im Raum KLF200Node angelegt.
Die Namen der Geräte folgen dem Muster <name>_<NodeID>.
Wurde im WebUI der KLF200 ein Name für das Gerät vergeben dann wird dieser als Alias übernommen.

Die Geräte sind jetzt einsatzbereit.

== Modul KLF200 ==
=== Verbindungsstatus ===
==== STATE ====
Im STATE des Moduls sieht man den aktuellen Verbindungsstatus. Im Idealfall ist er nach der Initialisierung Logged in.
=== Ausführung von Programmen (Szenen) ===
Obwohl man mit dem Modul KLF200Node jedes Gerät unabhängig und auch gleichzeitig steuern kann, sind Szenen eine nützliche Ergänzung. So kann man mit Szenen wie "Alle zu" oder "Alle auf" viele Geräte gleichzeitig mit einem Befehl bedienen.

Hinweis: Während der Abarbeitung einer Szene werden weitere Befehle gepuffert.
==== scene/sceneID ====
Mit diesen Set-Funktionen kann man eine aufgezeichnete Szene aufrufen.
Im entsprechenden Reading steht die zuletzt aufgerufene Szene.

Die Zuordnung zwischen sceneID und scene sieht man in den Internals unter scenes.

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Bei vielen aktuellen Geräten lässt sich die Ausführungsgeschwindigkeit (Velocity) variieren. So lässt sich die Geschwindigkeit gegenüber der Default-Geschwindigkeit noch erhöhen oder auch deutlich reduzieren. So ist eine besonders leise Bedienung möglich.

==== Argument DEFAULT, FAST, SILENT ====
Die Velocity kann man bei der Ausführung von Szenen als zusätzliches Argument von set scene oder set sceneID setzen.
Unterstützte Werte sind DEFAULT, FAST und SILENT
:<code>set Velux scene "Alle zu" SILENT</code>
==== Attribut velocity ====
Alternativ kann man im Modul KLF200 das Attribut velocity setzen, das bei der Ausführung von Szenen herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

Hinweis: Dieses Attribut hat keine Auswirkungen auf Befehle, die vom Modul KLF200Node abgesetzt werden.

== Modul KLF200Node ==
Dieses Modul wurde dem Homematic-Modul CUL_HM nachempfunden, da es ebenfalls ein breites Spektrum an Geräten unterstützt
und möglichst kompatibel zu vorhandenen Hilfsmodulen sein soll.
=== Aktueller Status ===
Im Folgenden wird der Zusammenhang zwischen den wichtigsten Readings/Set-Funktionen pct, state, execution erklärt.
==== pct ====
Dieses Reading enthält den aktuell bekannten Status des Gerätes in Prozent.

Wird das Gerät über die KLF-200-Box gesteuert, wird das Reading beim Erreichen der Zielposition sofort aktualisiert.

Wird das Gerät über eine Fernbedienung oder einen Sensor gesteuert, kann sich die Aktualisierung wenige Minuten verzögern.

Mit der Set-Funktion kann man das Gerät in diesen Status versetzen.
Per Default entspricht 100 auf der Fernbedienung oben und 0 unten.
==== state ====
Dieses Reading entspricht dem Reading pct, mit der Ausnahme, dass 0 durch '''off''' ersetzt wird und 100 durch '''on'''.

Die Set-Funktion funktioniert analog.
Per Default entspricht on auf der Fernbedienung oben und off unten.

Es werden die '''set extensions''' unterstützt. Damit können mit einem Set ein oder mehrere Befehle zeitgesteuert abgesetzt werden.

Doku: [https://fhem.de/commandref_DE.html#set set extensions in der commandref] und im [[DevelopmentModuleIntro#X_Set]] jeweils etwas weiter unten.

==== execution ====
Dieses Reading gibt den aktuellen Ausführungsstatus wieder. Die meiste Zeit ist der Wert stop.
Wird gerade ein Befehl ausgeführt, ist der Wert up oder down.

Mit der Set-Funktion werden entsprechende Befehle ausgeführt, up entspricht auf der Fernbedienung oben und down unten.
Bei stop wird die aktuelle Ausführung angehalten.

==== Attribut directionOn ====
Wie oben beschrieben, entspricht per Default on = 100 = up.

Das kann bei bestimmten Geräten für manchen Nutzer verwirrend sein.
Wenn man z.B. bei einem Rollladen lieber im geschlossenen Zustand 100 Prozent sehen möchte, dann setzt man das Attribut directionOn, z.B.
:<code>attr Velux_2 directionOn down</code>

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Wie bei Szenen lässt sich auch bei Kommandos auf KLF200Node die Ausführungsgeschwindigkeit beeinflussen, soweit das vom Gerät unterstützt ist.
==== Reading velocity ====
Dieses Reading hat den Wert supported, wenn die Geschwindigkeit bei diesem Gerät geändert werden kann.
Selbst bei Not supported wäre es einen Versuch wert, es zu testen.
==== Argument DEFAULT, FAST, SILENT ====
Alle set-Funktionen, die eine Bewegung auslösen unterstützen das optionale Argument DEFAULT, FAST oder SILENT.
==== Attribut velocity ====
Alternativ kann man im Modul KLF200Node das Attribut velocity setzen, das bei der Ausführung von Kommandos herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

=== Begrenzung des Bewegungsradius / Limitation ===
Die io-homecontrol Geräte haben ein Feature eingebaut, um den Bewegungsradius der Geräte einzuschränken, egal von wo aus sie gesteuert werden. Dieses Limitation-Feature ist in dieses FHEM-Modul ebenfalls integriert.
==== limitationMin und limitationMax ====
Mit den Settern und Readings limitationMin und limitationMax kann man die Limitation setzen und auslesen.
Natürlich kann man auch selbst von der Limitation Gebrauch machen. Man kann z.B. einen Rollladen begrenzen, wenn man weiß, dass das Dachfenster weit offen ist. Dann kann der Rollladen nicht gegen das Fenster stoßen, selbst wenn man ihn mit der Fernbedienung bewegt.
==== limiationClear ====
Mit dem Setter limiationClear kann man alle Limitations (auch von fremden Geräten ausgelöste) löschen.
==== updateLimiation ====
Der Setter updateLimiation aktualisiert die Readings limitationMin und limitationMax auf diesem Gerät, falls die Limitation außerhalb von FHEM gesetzt wurde.

=== Auswerten der Regensensoren ===
Die Regensensoren von Velux Fensteröffnern machen von diesem Limitation-Feature Gebrauch. Wenn es regnet, wird der Bewegungsradius der Fenster eingeschränkt. Zum Beispiel (evtl. Geräte-abhängig):
* limitationMax = 7 bei Regen,
* limitationMax = 100 wenn es aufhört.
Diese Werte kann man auslesen, ohne dass sich das Fenster dazu bewegt haben muss.

==== limitationUpdateInterval ====
Mit set limitationUpdateInterval kann man festlegen, wie oft diese Werte ausgelesen werden:
* off: Dieser Wert ist für Geräte ohne integrierte Sensoren der Beste, denn zusätzliche Updates sind überflüssig.
* onChange: Hier wird limitationMin und limitationMax aktualisiert, wenn das Gerät bewegt wurde.
* interval in s: Ein Poll-Intervall in Sekunden. Tests mit 120 sind erfolgreich durchgelaufen. Dieser Wert ist vielleicht etwas übertrieben, man denke an das Funkfeuer und den Akku der Geräte. Ein Intervall von 600 ist vielleicht sinnvoller. Beispiele:
:<code>set Velux_1 limitationUpdateInterval off</code>
:<code>set Velux_2 limitationUpdateInterval onChange</code>
:<code>set Velux_3 limitationUpdateInterval 600</code>

==== Extra Reading für den Regensensor ====
Wem die Auswertung vom Reading limitationMax zu indirekt ist, der kann sich ein neues Reading anlegen.
Der folgende Code legt ein Reading namens sensor an, die Werte sind im Beispiel "Regen" oder "trocken".
Es besteht die Annahme, dass bei limitationMax = 7 der Regensensor angeschlagen hat.
:<code>attr Velux_3 userReadings sensor {(ReadingsVal($name,"limitationMax",100) == 7)?"Regen":"trocken"}</code>
Hinweis: Das neue Reading sensor erscheint erst, wenn das Reading limitationMax einmal aktualisiert wurde.

== Vorschläge zur schöneren Darstellung ==
Wie Homematic-Geräte kommt KLF200Node im FHEM-Web sehr schlicht daher. Dieses Kapitel gibt Vorschläge zur Konfiguration einer schöneren Darstellung.

=== Rollladen ===
Dieses Beispiel stellt den Status des Rollladen 10-Prozent genau im Icon dar. Bewegen sich der Rollladen, hat das Icon einen Pfeil nach oben oder unten. Ein Klick auf das Icon setzt den Rollladen in Bewegung oder hält ihn an (toggle).

:<code>attr Velux_2 stateFormat pct execution</code>
:<code>attr Velux_2 devStateIcon .*up:fts_shutter_up:toggle .*down:fts_shutter_down:toggle \d.stop:fts_shutter_100:toggle 1\d.stop:fts_shutter_90:toggle 2\d.stop:fts_shutter_80:toggle 3\d.stop:fts_shutter_70:toggle 4\d.stop:fts_shutter_60:toggle 5\d.stop:fts_shutter_50:toggle 6\d.stop:fts_shutter_40:toggle 7\d.stop:fts_shutter_30:toggle 8\d.stop:fts_shutter_20:toggle 9\d.stop:fts_shutter_10:toggle 100.stop:fts_window_2w:toggle</code>
[[Datei:RollerShutterUpDown.png|300px|Rollladen mit Pfeilen]]

So erhält man einen Slider für die Rollladenposition:

:<code>attr Velux_2 webCmd pct</code>

=== Dachschrägenfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachschrägenfenster in drei Stufen dar:

0% - 9%: geschlossen

10% - 59%: halb geöffnet

60% - 100%: ganz geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_4 limitationUpdateInterval 600</code>
:<code>attr Velux_4 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_4 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7\).*:weather_rain:toggle \d.$.*:fts_window_roof:toggle [1-5]\d.\(.*:fts_window_roof_open_1:toggle [6-9]\d.\(.*:fts_window_roof_open_2:toggle 100.\(.*:fts_window_roof_open_2:toggle</code>

=== Dachkuppelfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachkuppelfenster in zwei Stufen dar:

0% - 9%: geschlossen

10% - 100%: geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_5 limitationUpdateInterval 600</code>
:<code>attr Velux_5 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_5 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7$.*:weather_rain:toggle \d.\(.*:fts_light_dome:toggle [1-9]\d.\(.*:fts_light_dome_open:toggle 100.\(.*:fts_light_dome_open:toggle</code>

== Problembehebung ==
=== Verbindungsabbrüche ===
Sollte es zu Verbindungsabbrüchen zwischen FHEM und der KLF200-Box kommen, dann sind folgende Dinge zu überprüfen:
==== FHEM Update ====
Ist FHEM aktuell? Am 18.12.2018 gab es ein wichtiges FHEM-Update, das die Stabilität von SSL-Verbindungen wesentlich verbessert hat.
==== OpenSSL ====
OpenSLL sollte immer aktuell sein.
==== Perl SSL-Bibliotheken ====
Wenn die Perl SSL-Bibliotheken zu alt sind, ist das oben genannte FHEM-Update wirkungslos.
* IO::Socket::SSL
* Net::SSL
* Net::SSLeay
* Net::SSLeay::Handle
* Crypt::SSLeay
* Net::Server::Proto::SSL

=== Registrieren von Geräten an der KLF200-Box ===

Die [https://velcdn.azureedge.net/~/media/marketing/ch/fachleute/einbauanleitungen/elektro-nachrustung/zubehor/klf-200_bedienungsanleitung_basic%20de.pdf KLF200-Dokumentation] Seite 11 - 19 beschreibt 2 Varianten, um Geräte mit der Box zu koppeln.

==== 1. Registrierung mit einer Zweiweg-Bedienung ====
Dieser Weg funktioniert über die Schlüssel-Taste oder im Web-UI über PRODUKTE KOPIEREN.

Es ist eine Zweiweg-Bedienung erforderlich, die in der Lage ist, die IO-Schlüssel zu exportieren.

Dieser Weg geht z.B. mit dem Control Pad KLR200, Somfy TaHoma, [https://www.somfy.de/hilfe-center/faq/wie-binde-ich-produkte-ein-die-bereits-mit-einem-2-wege-sender-angesteuert-werden Nina io, Telis Composio io, Impresario Chronis io, Easy Sun io und Telis 1 io.].

TaHoma: anmelden, Menü "Sicherheitseinstellungen", Reiter "io-System", "SICHERHEITSSCHLÜSSEL SENDEN"

==== 2. Registrierung mit einer Einweg-Bedienung ====
Dieser Weg funktioniert über die Reset-Taste oder im Web-UI über PRODUKTSUCHE.

Hierzu wird das Gerät über eine Fernbedienung oder direkt am Gerät in einen Anlernzustand versetzt und dann einigen sich KLF200 und das Gerät über einen Schlüssel.

Bei manchen Somfy-Geräten scheint dieser Weg nicht zu funktionieren, z.B. einige Somfy Smoove Produkte. Hier bleibt nur die Möglichkeit, die Schlüssel wie in Variante 1 von einer Somfy Zweiweg-Bedienung zu kopieren.

=== WARNUNG vor Reset der KLF200-Box! ===
Sollten an der KLF200-Box schon Geräte registriert sein, dann ist ein Factory-Reset unbedingt zu vermeiden!
Die Geräte, die mit der KLF200 bereits Schlüssel ausgetauscht haben, lassen sich nicht ohne weiteres noch einmal registrieren.
Um diese Geräte nach einem Reset der KLF200 trotzdem zu registrieren, sind folgende Schritte notwendig:
# Die registrierten Geräte müssen komplett zurückgesetzt werden.
# Die entsprechenden Fernbedienungen müssen neu angelernt werden.
# Die Geräte können an der KLF200-Box registriert werden.

== Links ==
* Support im Forum gibt es unter {{Link2Forum|Topic=92907|LinkText=Velux KLF200 mit Firmware 2.0.0.71 für io-homecontrol}}
* Github: [https://github.com/buennerbernd/fhem/tree/master/KLF200/2.0 FHEM modules KLF200 and KLF200Node]

[[Kategorie:Rollladensteuerung]]
[[Kategorie:io-homecontrol]]
[[Kategorie:Other Components]]

Kategorie:Io-homecontrol

2019-10-01T20:02:24Z

Buennerbernd:

io-homecontrol® ist eine verschlüsselte Zweiwege-Funktechnologie für Wohngebäude. Es werden Funkfrequenzen zwischen 868 MHz und 870 MHz genutzt. Das Funkprotokoll wird von diversen Haustechnik-Anbietern unterstützt. Die wichtigsten Anbieter sind Somfy und Velux. Die häufigsten Anwendungsfälle sind Rollladen, Dachfensteröffner und Markisen. Das Protokoll ist aber auch für weitere Gerätekategorien geeignet.

Da das Protokoll und die Verschlüsselung nicht öffentlich bekannt sind ist für die Kommunikation von FHEM mit io-homecontrol-Aktoren und Sensoren eine Bridge erforderlich, z.B.

* [[Velux KLF200]] (Nur Aktoren, lokales Netzwerk)
* Somfy TaHoma (Cloud)
* Somfy Connexoon Box (Cloud)

[[Kategorie:Hardware]]

Velux KLF200

2019-07-24T14:42:43Z

Buennerbernd: /* Problembehebung */

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Anbindung io-homecontrol Aktoren an FHEM
|ModType=x
|ModCmdRef=KLF200
|ModFTopic=92907
|ModTechName=83_KLF200.pm
|ModOwner=buennerbernd ({{Link2FU|21440|Forum}} / [[Benutzer Diskussion:Buennerbernd|Wiki]])
}}

[[KLF200]] ist ein Modul zur Steuerung von io-homecontrol Aktoren über das Gateway Velux KLF 200.

== Velux KLF 200 ==

Die KLF-200-Box ist über LAN mit FHEM verbunden und steuert die Aktoren über das verschlüsselte Funkprotokoll io-homecontrol.
Die Aktoren geben Rückmeldung über ihren aktuellen Zustand.

Die Box hat 10 elektrische Eingänge mit denen man 5 Geräte oder Gerätegruppen steuern kann.
Damit kann man z.B. mit Doppeltastern an der Wand seine Rollladen oder Fenster steuern.
Über den LAN-Anschluss lassen sich mit FHEM bis zu 200 Geräte mit einer KLF 200 verwalten.

Das Modul erfordert die Firmware-Version 2.0.0.71 und basiert auf der dokumentierten API von Velux. [https://www.velux.com/api/klf200 Download und weitere Informationen]

Das Gateway hat keine Cloud-Integration.

== Unterstützte Geräte ==

Grundsätzlich sollten alle io-homecontrol Aktoren funktionieren. Alleinstehende Sensoren (z.B. Lichtsensor, Windsensor) werden
von der KLF-200-Box nicht unterstützt. Es besteht aber die Möglichkeit, den Status von Sensoren auszuwerten, die in Aktoren integriert sind.

Aktuell werden folgende Geräte erfolgreich mit diesem Modul verwendet:

* Rollladen:
** VELUX SML
** VELUX SSL
** Somfy Oximo io
** Somfy Izymo io
* Sichtschutz innen:
** VELUX FSK
** VELUX DML
* Fensteröffner mit integriertem Regensensor:
** VELUX KMG
** VELUX CVP
** VELUX KSX
* Markisen:
** VELUX MSL
** Somfy Sunea io

== Benutzung in FHEM ==
=== Vorbereitung ===
Bevor die Aktoren in FHEM verwendet werden können, müssen sie in der [[#Registrieren von Geräten an der KLF200-Box|KLF 200 angelernt]] werden.
Das geschieht über das WebUI der KLF 200, das über einen Wifi-Hotspot erreichbar ist. Dieser Vorgang ist im Handbuch beschrieben.
Im WebUI können die angeschlossenen Geräte auch benannt werden. Zusätzlich hat man die Möglichkeit, Programme (Szenen) aufzuzeichnen,
um ein oder mehrere Geräte in eine definierte Position zu bringen. Diese Szenen kann man aus FHEM ebenfalls ansteuern.

Das Modul wird momentan noch nicht über FHEM ausgeliefert.
Es wird wie folgt geladen und aktualisiert:

:<code>update all <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>
:<code>shutdown restart</code>

Mit diesem Befehl wird das Modul so eingerichtet, dass es ebenfalls aktualisiert wird, wenn man FHEM aktualisiert:
:<code>update add <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>

=== Anlegen der Geräte ===
:<code>define <name> KLF200 <host></code>
Beispiel:
:<code>define Velux KLF200 192.168.0.66</code>

Danach Login durch Eingabe des Passwortes:
:<code>set <name> login <password></code>

Hinweis: Das Passwort ist laut Dokumentation das Wifi-Passwort, das auf den Boden der Box gedruckt ist.
Das funktioniert bei einigen Nutzern. Bei vielen Nutzern funktioniert hingegen das Passwort des WebUI.
Scheinbar hängt das davon ab, mit welcher Firmware die Box ausgeliefert wurde und ob schon einmal ein Reset durchgeführt wurde.
Das Passwort wird verschleiert im FHEM-Backend gespeichert. Es muss nach erfolgreichem Login nicht mehr eingegeben werden.

Die angeschlossenen Aktoren werden jetzt durch autocreate als Instanzen von KLF200Node im Raum KLF200Node angelegt.
Die Namen der Geräte folgen dem Muster <name>_<NodeID>.
Wurde im WebUI der KLF200 ein Name für das Gerät vergeben dann wird dieser als Alias übernommen.

Die Geräte sind jetzt einsatzbereit.

== Modul KLF200 ==
=== Verbindungsstatus ===
==== STATE ====
Im STATE des Moduls sieht man den aktuellen Verbindungsstatus. Im Idealfall ist er nach der Initialisierung Logged in.
=== Ausführung von Programmen (Szenen) ===
Obwohl man mit dem Modul KLF200Node jedes Gerät unabhängig und auch gleichzeitig steuern kann, sind Szenen eine nützliche Ergänzung. So kann man mit Szenen wie "Alle zu" oder "Alle auf" viele Geräte gleichzeitig mit einem Befehl bedienen.

Hinweis: Während der Abarbeitung einer Szene werden weitere Befehle gepuffert.
==== scene/sceneID ====
Mit diesen Set-Funktionen kann man eine aufgezeichnete Szene aufrufen.
Im entsprechenden Reading steht die zuletzt aufgerufene Szene.

Die Zuordnung zwischen sceneID und scene sieht man in den Internals unter scenes.

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Bei vielen aktuellen Geräten lässt sich die Ausführungsgeschwindigkeit (Velocity) variieren. So lässt sich die Geschwindigkeit gegenüber der Default-Geschwindigkeit noch erhöhen oder auch deutlich reduzieren. So ist eine besonders leise Bedienung möglich.

==== Argument DEFAULT, FAST, SILENT ====
Die Velocity kann man bei der Ausführung von Szenen als zusätzliches Argument von set scene oder set sceneID setzen.
Unterstützte Werte sind DEFAULT, FAST und SILENT
:<code>set Velux scene "Alle zu" SILENT</code>
==== Attribut velocity ====
Alternativ kann man im Modul KLF200 das Attribut velocity setzen, das bei der Ausführung von Szenen herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

Hinweis: Dieses Attribut hat keine Auswirkungen auf Befehle, die vom Modul KLF200Node abgesetzt werden.

== Modul KLF200Node ==
Dieses Modul wurde dem Homematic-Modul CUL_HM nachempfunden, da es ebenfalls ein breites Spektrum an Geräten unterstützt
und möglichst kompatibel zu vorhandenen Hilfsmodulen sein soll.
=== Aktueller Status ===
Im Folgenden wird der Zusammenhang zwischen den wichtigsten Readings/Set-Funktionen pct, state, execution erklärt.
==== pct ====
Dieses Reading enthält den aktuell bekannten Status des Gerätes in Prozent.

Wird das Gerät über die KLF-200-Box gesteuert, wird das Reading beim Erreichen der Zielposition sofort aktualisiert.

Wird das Gerät über eine Fernbedienung oder einen Sensor gesteuert, kann sich die Aktualisierung wenige Minuten verzögern.

Mit der Set-Funktion kann man das Gerät in diesen Status versetzen.
Per Default entspricht 100 auf der Fernbedienung oben und 0 unten.
==== state ====
Dieses Reading entspricht dem Reading pct, mit der Ausnahme, dass 0 durch '''off''' ersetzt wird und 100 durch '''on'''.

Die Set-Funktion funktioniert analog.
Per Default entspricht on auf der Fernbedienung oben und off unten.

Es werden die '''set extensions''' unterstützt. Damit können mit einem Set ein oder mehrere Befehle zeitgesteuert abgesetzt werden.

Doku: [https://fhem.de/commandref_DE.html#set set extensions in der commandref] und im [[DevelopmentModuleIntro#X_Set]] jeweils etwas weiter unten.

==== execution ====
Dieses Reading gibt den aktuellen Ausführungsstatus wieder. Die meiste Zeit ist der Wert stop.
Wird gerade ein Befehl ausgeführt, ist der Wert up oder down.

Mit der Set-Funktion werden entsprechende Befehle ausgeführt, up entspricht auf der Fernbedienung oben und down unten.
Bei stop wird die aktuelle Ausführung angehalten.

==== Attribut directionOn ====
Wie oben beschrieben, entspricht per Default on = 100 = up.

Das kann bei bestimmten Geräten für manchen Nutzer verwirrend sein.
Wenn man z.B. bei einem Rollladen lieber im geschlossenen Zustand 100 Prozent sehen möchte, dann setzt man das Attribut directionOn, z.B.
:<code>attr Velux_2 directionOn down</code>

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Wie bei Szenen lässt sich auch bei Kommandos auf KLF200Node die Ausführungsgeschwindigkeit beeinflussen, soweit das vom Gerät unterstützt ist.
==== Reading velocity ====
Dieses Reading hat den Wert supported, wenn die Geschwindigkeit bei diesem Gerät geändert werden kann.
Selbst bei Not supported wäre es einen Versuch wert, es zu testen.
==== Argument DEFAULT, FAST, SILENT ====
Alle set-Funktionen, die eine Bewegung auslösen unterstützen das optionale Argument DEFAULT, FAST oder SILENT.
==== Attribut velocity ====
Alternativ kann man im Modul KLF200Node das Attribut velocity setzen, das bei der Ausführung von Kommandos herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

=== Begrenzung des Bewegungsradius / Limitation ===
Die io-homecontrol Geräte haben ein Feature eingebaut, um den Bewegungsradius der Geräte einzuschränken, egal von wo aus sie gesteuert werden. Dieses Limitation-Feature ist in dieses FHEM-Modul ebenfalls integriert.
==== limitationMin und limitationMax ====
Mit den Settern und Readings limitationMin und limitationMax kann man die Limitation setzen und auslesen.
Natürlich kann man auch selbst von der Limitation Gebrauch machen. Man kann z.B. einen Rollladen begrenzen, wenn man weiß, dass das Dachfenster weit offen ist. Dann kann der Rollladen nicht gegen das Fenster stoßen, selbst wenn man ihn mit der Fernbedienung bewegt.
==== limiationClear ====
Mit dem Setter limiationClear kann man alle Limitations (auch von fremden Geräten ausgelöste) löschen.
==== updateLimiation ====
Der Setter updateLimiation aktualisiert die Readings limitationMin und limitationMax auf diesem Gerät, falls die Limitation außerhalb von FHEM gesetzt wurde.

=== Auswerten der Regensensoren ===
Die Regensensoren von Velux Fensteröffnern machen von diesem Limitation-Feature Gebrauch. Wenn es regnet, wird der Bewegungsradius der Fenster eingeschränkt. Zum Beispiel (evtl. Geräte-abhängig):
* limitationMax = 7 bei Regen,
* limitationMax = 100 wenn es aufhört.
Diese Werte kann man auslesen, ohne dass sich das Fenster dazu bewegt haben muss.

==== limitationUpdateInterval ====
Mit set limitationUpdateInterval kann man festlegen, wie oft diese Werte ausgelesen werden:
* off: Dieser Wert ist für Geräte ohne integrierte Sensoren der Beste, denn zusätzliche Updates sind überflüssig.
* onChange: Hier wird limitationMin und limitationMax aktualisiert, wenn das Gerät bewegt wurde.
* interval in s: Ein Poll-Intervall in Sekunden. Tests mit 120 sind erfolgreich durchgelaufen. Dieser Wert ist vielleicht etwas übertrieben, man denke an das Funkfeuer und den Akku der Geräte. Ein Intervall von 600 ist vielleicht sinnvoller. Beispiele:
:<code>set Velux_1 limitationUpdateInterval off</code>
:<code>set Velux_2 limitationUpdateInterval onChange</code>
:<code>set Velux_3 limitationUpdateInterval 600</code>

==== Extra Reading für den Regensensor ====
Wem die Auswertung vom Reading limitationMax zu indirekt ist, der kann sich ein neues Reading anlegen.
Der folgende Code legt ein Reading namens sensor an, die Werte sind im Beispiel "Regen" oder "trocken".
Es besteht die Annahme, dass bei limitationMax = 7 der Regensensor angeschlagen hat.
:<code>attr Velux_3 userReadings sensor {(ReadingsVal($name,"limitationMax",100) == 7)?"Regen":"trocken"}</code>
Hinweis: Das neue Reading sensor erscheint erst, wenn das Reading limitationMax einmal aktualisiert wurde.

== Vorschläge zur schöneren Darstellung ==
Wie Homematic-Geräte kommt KLF200Node im FHEM-Web sehr schlicht daher. Dieses Kapitel gibt Vorschläge zur Konfiguration einer schöneren Darstellung.

=== Rollladen ===
Dieses Beispiel stellt den Status des Rollladen 10-Prozent genau im Icon dar. Bewegen sich der Rollladen, hat das Icon einen Pfeil nach oben oder unten. Ein Klick auf das Icon setzt den Rollladen in Bewegung oder hält ihn an (toggle).

:<code>attr Velux_2 stateFormat pct execution</code>
:<code>attr Velux_2 devStateIcon .*up:fts_shutter_up:toggle .*down:fts_shutter_down:toggle \d.stop:fts_shutter_100:toggle 1\d.stop:fts_shutter_90:toggle 2\d.stop:fts_shutter_80:toggle 3\d.stop:fts_shutter_70:toggle 4\d.stop:fts_shutter_60:toggle 5\d.stop:fts_shutter_50:toggle 6\d.stop:fts_shutter_40:toggle 7\d.stop:fts_shutter_30:toggle 8\d.stop:fts_shutter_20:toggle 9\d.stop:fts_shutter_10:toggle 100.stop:fts_window_2w:toggle</code>
[[Datei:RollerShutterUpDown.png|300px|Rollladen mit Pfeilen]]

So erhält man einen Slider für die Rollladenposition:

:<code>attr Velux_2 webCmd pct</code>

=== Dachschrägenfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachschrägenfenster in drei Stufen dar:

0% - 9%: geschlossen

10% - 59%: halb geöffnet

60% - 100%: ganz geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_4 limitationUpdateInterval 600</code>
:<code>attr Velux_4 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_4 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7\).*:weather_rain:toggle \d.$.*:fts_window_roof:toggle [1-5]\d.\(.*:fts_window_roof_open_1:toggle [6-9]\d.\(.*:fts_window_roof_open_2:toggle 100.\(.*:fts_window_roof_open_2:toggle</code>

=== Dachkuppelfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachkuppelfenster in zwei Stufen dar:

0% - 9%: geschlossen

10% - 100%: geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_5 limitationUpdateInterval 600</code>
:<code>attr Velux_5 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_5 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7$.*:weather_rain:toggle \d.\(.*:fts_light_dome:toggle [1-9]\d.\(.*:fts_light_dome_open:toggle 100.\(.*:fts_light_dome_open:toggle</code>

== Problembehebung ==
=== Verbindungsabbrüche ===
Sollte es zu Verbindungsabbrüchen zwischen FHEM und der KLF200-Box kommen, dann sind folgende Dinge zu überprüfen:
==== FHEM Update ====
Ist FHEM aktuell? Am 18.12.2018 gab es ein wichtiges FHEM-Update, das die Stabilität von SSL-Verbindungen wesentlich verbessert hat.
==== OpenSSL ====
OpenSLL sollte immer aktuell sein.
==== Perl SSL-Bibliotheken ====
Wenn die Perl SSL-Bibliotheken zu alt sind, ist das oben genannte FHEM-Update wirkungslos.
* IO::Socket::SSL
* Net::SSL
* Net::SSLeay
* Net::SSLeay::Handle
* Crypt::SSLeay
* Net::Server::Proto::SSL

=== Registrieren von Geräten an der KLF200-Box ===

Die [https://velcdn.azureedge.net/~/media/marketing/ch/fachleute/einbauanleitungen/elektro-nachrustung/zubehor/klf-200_bedienungsanleitung_basic%20de.pdf KLF200-Dokumentation] Seite 11 - 19 beschreibt 2 Varianten, um Geräte mit der Box zu koppeln.

==== 1. Registrierung mit einer Zweiweg-Bedienung ====
Dieser Weg funktioniert über die Schlüssel-Taste oder im Web-UI über PRODUKTE KOPIEREN.

Es ist eine Zweiweg-Bedienung erforderlich, die in der Lage ist, die IO-Schlüssel zu exportieren.

Dieser Weg geht z.B. mit dem Control Pad KLR200, Somfy TaHoma, [https://www.somfy.de/hilfe-center/faq/wie-binde-ich-produkte-ein-die-bereits-mit-einem-2-wege-sender-angesteuert-werden Nina io, Telis Composio io, Impresario Chronis io, Easy Sun io und Telis 1 io.].

TaHoma: anmelden, Menü "Sicherheitseinstellungen", Reiter "io-System", "SICHERHEITSSCHLÜSSEL SENDEN"

==== 2. Registrierung mit einer Einweg-Bedienung ====
Dieser Weg funktioniert über die Reset-Taste oder im Web-UI über PRODUKTSUCHE.

Hierzu wird das Gerät über eine Fernbedienung oder direkt am Gerät in einen Anlernzustand versetzt und dann einigen sich KLF200 und das Gerät über einen Schlüssel.

Bei manchen Somfy-Geräten scheint dieser Weg nicht zu funktionieren, z.B. einige Somfy Smoove Produkte. Hier bleibt nur die Möglichkeit, die Schlüssel wie in Variante 1 von einer Somfy Zweiweg-Bedienung zu kopieren.

=== WARNUNG vor Reset der KLF200-Box! ===
Sollten an der KLF200-Box schon Geräte registriert sein, dann ist ein Factory-Reset unbedingt zu vermeiden!
Die Geräte, die mit der KLF200 bereits Schlüssel ausgetauscht haben, lassen sich nicht ohne weiteres noch einmal registrieren.
Um diese Geräte nach einem Reset der KLF200 trotzdem zu registrieren, sind folgende Schritte notwendig:
# Die registrierten Geräte müssen komplett zurückgesetzt werden.
# Die entsprechenden Fernbedienungen müssen neu angelernt werden.
# Die Geräte können an der KLF200-Box registriert werden.

== Links ==
* Support im Forum gibt es unter {{Link2Forum|Topic=92907|LinkText=Velux KLF200 mit Firmware 2.0.0.71 für io-homecontrol}}
* Github: [https://github.com/buennerbernd/fhem/tree/master/KLF200/2.0 FHEM modules KLF200 and KLF200Node]

[[Kategorie:Rollladensteuerung]]
[[Kategorie:Other Components]]

Velux KLF200

2019-07-19T15:03:32Z

Buennerbernd: /* 2. Registrierung mit einer Einweg-Bedienung */

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Anbindung io-homecontrol Aktoren an FHEM
|ModType=x
|ModCmdRef=KLF200
|ModFTopic=92907
|ModTechName=83_KLF200.pm
|ModOwner=buennerbernd ({{Link2FU|21440|Forum}} / [[Benutzer Diskussion:Buennerbernd|Wiki]])
}}

[[KLF200]] ist ein Modul zur Steuerung von io-homecontrol Aktoren über das Gateway Velux KLF 200.

== Velux KLF 200 ==

Die KLF-200-Box ist über LAN mit FHEM verbunden und steuert die Aktoren über das verschlüsselte Funkprotokoll io-homecontrol.
Die Aktoren geben Rückmeldung über ihren aktuellen Zustand.

Die Box hat 10 elektrische Eingänge mit denen man 5 Geräte oder Gerätegruppen steuern kann.
Damit kann man z.B. mit Doppeltastern an der Wand seine Rollladen oder Fenster steuern.
Über den LAN-Anschluss lassen sich mit FHEM bis zu 200 Geräte mit einer KLF 200 verwalten.

Das Modul erfordert die Firmware-Version 2.0.0.71 und basiert auf der dokumentierten API von Velux. [https://www.velux.com/api/klf200 Download und weitere Informationen]

Das Gateway hat keine Cloud-Integration.

== Unterstützte Geräte ==

Grundsätzlich sollten alle io-homecontrol Aktoren funktionieren. Alleinstehende Sensoren (z.B. Lichtsensor, Windsensor) werden
von der KLF-200-Box nicht unterstützt. Es besteht aber die Möglichkeit, den Status von Sensoren auszuwerten, die in Aktoren integriert sind.

Aktuell werden folgende Geräte erfolgreich mit diesem Modul verwendet:

* Rollladen:
** VELUX SML
** VELUX SSL
** Somfy Oximo io
** Somfy Izymo io
* Sichtschutz innen:
** VELUX FSK
** VELUX DML
* Fensteröffner mit integriertem Regensensor:
** VELUX KMG
** VELUX CVP
** VELUX KSX
* Markisen:
** VELUX MSL
** Somfy Sunea io

== Benutzung in FHEM ==
=== Vorbereitung ===
Bevor die Aktoren in FHEM verwendet werden können, müssen sie in der [[#Registrieren von Geräten an der KLF200-Box|KLF 200 angelernt]] werden.
Das geschieht über das WebUI der KLF 200, das über einen Wifi-Hotspot erreichbar ist. Dieser Vorgang ist im Handbuch beschrieben.
Im WebUI können die angeschlossenen Geräte auch benannt werden. Zusätzlich hat man die Möglichkeit, Programme (Szenen) aufzuzeichnen,
um ein oder mehrere Geräte in eine definierte Position zu bringen. Diese Szenen kann man aus FHEM ebenfalls ansteuern.

Das Modul wird momentan noch nicht über FHEM ausgeliefert.
Es wird wie folgt geladen und aktualisiert:

:<code>update all <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>
:<code>shutdown restart</code>

Mit diesem Befehl wird das Modul so eingerichtet, dass es ebenfalls aktualisiert wird, wenn man FHEM aktualisiert:
:<code>update add <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>

=== Anlegen der Geräte ===
:<code>define <name> KLF200 <host></code>
Beispiel:
:<code>define Velux KLF200 192.168.0.66</code>

Danach Login durch Eingabe des Passwortes:
:<code>set <name> login <password></code>

Hinweis: Das Passwort ist laut Dokumentation das Wifi-Passwort, das auf den Boden der Box gedruckt ist.
Das funktioniert bei einigen Nutzern. Bei vielen Nutzern funktioniert hingegen das Passwort des WebUI.
Scheinbar hängt das davon ab, mit welcher Firmware die Box ausgeliefert wurde und ob schon einmal ein Reset durchgeführt wurde.
Das Passwort wird verschleiert im FHEM-Backend gespeichert. Es muss nach erfolgreichem Login nicht mehr eingegeben werden.

Die angeschlossenen Aktoren werden jetzt durch autocreate als Instanzen von KLF200Node im Raum KLF200Node angelegt.
Die Namen der Geräte folgen dem Muster <name>_<NodeID>.
Wurde im WebUI der KLF200 ein Name für das Gerät vergeben dann wird dieser als Alias übernommen.

Die Geräte sind jetzt einsatzbereit.

== Modul KLF200 ==
=== Verbindungsstatus ===
==== STATE ====
Im STATE des Moduls sieht man den aktuellen Verbindungsstatus. Im Idealfall ist er nach der Initialisierung Logged in.
=== Ausführung von Programmen (Szenen) ===
Obwohl man mit dem Modul KLF200Node jedes Gerät unabhängig und auch gleichzeitig steuern kann, sind Szenen eine nützliche Ergänzung. So kann man mit Szenen wie "Alle zu" oder "Alle auf" viele Geräte gleichzeitig mit einem Befehl bedienen.

Hinweis: Während der Abarbeitung einer Szene werden weitere Befehle gepuffert.
==== scene/sceneID ====
Mit diesen Set-Funktionen kann man eine aufgezeichnete Szene aufrufen.
Im entsprechenden Reading steht die zuletzt aufgerufene Szene.

Die Zuordnung zwischen sceneID und scene sieht man in den Internals unter scenes.

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Bei vielen aktuellen Geräten lässt sich die Ausführungsgeschwindigkeit (Velocity) variieren. So lässt sich die Geschwindigkeit gegenüber der Default-Geschwindigkeit noch erhöhen oder auch deutlich reduzieren. So ist eine besonders leise Bedienung möglich.

==== Argument DEFAULT, FAST, SILENT ====
Die Velocity kann man bei der Ausführung von Szenen als zusätzliches Argument von set scene oder set sceneID setzen.
Unterstützte Werte sind DEFAULT, FAST und SILENT
:<code>set Velux scene "Alle zu" SILENT</code>
==== Attribut velocity ====
Alternativ kann man im Modul KLF200 das Attribut velocity setzen, das bei der Ausführung von Szenen herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

Hinweis: Dieses Attribut hat keine Auswirkungen auf Befehle, die vom Modul KLF200Node abgesetzt werden.

== Modul KLF200Node ==
Dieses Modul wurde dem Homematic-Modul CUL_HM nachempfunden, da es ebenfalls ein breites Spektrum an Geräten unterstützt
und möglichst kompatibel zu vorhandenen Hilfsmodulen sein soll.
=== Aktueller Status ===
Im Folgenden wird der Zusammenhang zwischen den wichtigsten Readings/Set-Funktionen pct, state, execution erklärt.
==== pct ====
Dieses Reading enthält den aktuell bekannten Status des Gerätes in Prozent.

Wird das Gerät über die KLF-200-Box gesteuert, wird das Reading beim Erreichen der Zielposition sofort aktualisiert.

Wird das Gerät über eine Fernbedienung oder einen Sensor gesteuert, kann sich die Aktualisierung wenige Minuten verzögern.

Mit der Set-Funktion kann man das Gerät in diesen Status versetzen.
Per Default entspricht 100 auf der Fernbedienung oben und 0 unten.
==== state ====
Dieses Reading entspricht dem Reading pct, mit der Ausnahme, dass 0 durch '''off''' ersetzt wird und 100 durch '''on'''.

Die Set-Funktion funktioniert analog.
Per Default entspricht on auf der Fernbedienung oben und off unten.

Es werden die '''set extensions''' unterstützt. Damit können mit einem Set ein oder mehrere Befehle zeitgesteuert abgesetzt werden.

Doku: [https://fhem.de/commandref_DE.html#set set extensions in der commandref] und im [[DevelopmentModuleIntro#X_Set]] jeweils etwas weiter unten.

==== execution ====
Dieses Reading gibt den aktuellen Ausführungsstatus wieder. Die meiste Zeit ist der Wert stop.
Wird gerade ein Befehl ausgeführt, ist der Wert up oder down.

Mit der Set-Funktion werden entsprechende Befehle ausgeführt, up entspricht auf der Fernbedienung oben und down unten.
Bei stop wird die aktuelle Ausführung angehalten.

==== Attribut directionOn ====
Wie oben beschrieben, entspricht per Default on = 100 = up.

Das kann bei bestimmten Geräten für manchen Nutzer verwirrend sein.
Wenn man z.B. bei einem Rollladen lieber im geschlossenen Zustand 100 Prozent sehen möchte, dann setzt man das Attribut directionOn, z.B.
:<code>attr Velux_2 directionOn down</code>

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Wie bei Szenen lässt sich auch bei Kommandos auf KLF200Node die Ausführungsgeschwindigkeit beeinflussen, soweit das vom Gerät unterstützt ist.
==== Reading velocity ====
Dieses Reading hat den Wert supported, wenn die Geschwindigkeit bei diesem Gerät geändert werden kann.
Selbst bei Not supported wäre es einen Versuch wert, es zu testen.
==== Argument DEFAULT, FAST, SILENT ====
Alle set-Funktionen, die eine Bewegung auslösen unterstützen das optionale Argument DEFAULT, FAST oder SILENT.
==== Attribut velocity ====
Alternativ kann man im Modul KLF200Node das Attribut velocity setzen, das bei der Ausführung von Kommandos herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

=== Begrenzung des Bewegungsradius / Limitation ===
Die io-homecontrol Geräte haben ein Feature eingebaut, um den Bewegungsradius der Geräte einzuschränken, egal von wo aus sie gesteuert werden. Dieses Limitation-Feature ist in dieses FHEM-Modul ebenfalls integriert.
==== limitationMin und limitationMax ====
Mit den Settern und Readings limitationMin und limitationMax kann man die Limitation setzen und auslesen.
Natürlich kann man auch selbst von der Limitation Gebrauch machen. Man kann z.B. einen Rollladen begrenzen, wenn man weiß, dass das Dachfenster weit offen ist. Dann kann der Rollladen nicht gegen das Fenster stoßen, selbst wenn man ihn mit der Fernbedienung bewegt.
==== limiationClear ====
Mit dem Setter limiationClear kann man alle Limitations (auch von fremden Geräten ausgelöste) löschen.
==== updateLimiation ====
Der Setter updateLimiation aktualisiert die Readings limitationMin und limitationMax auf diesem Gerät, falls die Limitation außerhalb von FHEM gesetzt wurde.

=== Auswerten der Regensensoren ===
Die Regensensoren von Velux Fensteröffnern machen von diesem Limitation-Feature Gebrauch. Wenn es regnet, wird der Bewegungsradius der Fenster eingeschränkt. Zum Beispiel (evtl. Geräte-abhängig):
* limitationMax = 7 bei Regen,
* limitationMax = 100 wenn es aufhört.
Diese Werte kann man auslesen, ohne dass sich das Fenster dazu bewegt haben muss.

==== limitationUpdateInterval ====
Mit set limitationUpdateInterval kann man festlegen, wie oft diese Werte ausgelesen werden:
* off: Dieser Wert ist für Geräte ohne integrierte Sensoren der Beste, denn zusätzliche Updates sind überflüssig.
* onChange: Hier wird limitationMin und limitationMax aktualisiert, wenn das Gerät bewegt wurde.
* interval in s: Ein Poll-Intervall in Sekunden. Tests mit 120 sind erfolgreich durchgelaufen. Dieser Wert ist vielleicht etwas übertrieben, man denke an das Funkfeuer und den Akku der Geräte. Ein Intervall von 600 ist vielleicht sinnvoller. Beispiele:
:<code>set Velux_1 limitationUpdateInterval off</code>
:<code>set Velux_2 limitationUpdateInterval onChange</code>
:<code>set Velux_3 limitationUpdateInterval 600</code>

==== Extra Reading für den Regensensor ====
Wem die Auswertung vom Reading limitationMax zu indirekt ist, der kann sich ein neues Reading anlegen.
Der folgende Code legt ein Reading namens sensor an, die Werte sind im Beispiel "Regen" oder "trocken".
Es besteht die Annahme, dass bei limitationMax = 7 der Regensensor angeschlagen hat.
:<code>attr Velux_3 userReadings sensor {(ReadingsVal($name,"limitationMax",100) == 7)?"Regen":"trocken"}</code>
Hinweis: Das neue Reading sensor erscheint erst, wenn das Reading limitationMax einmal aktualisiert wurde.

== Vorschläge zur schöneren Darstellung ==
Wie Homematic-Geräte kommt KLF200Node im FHEM-Web sehr schlicht daher. Dieses Kapitel gibt Vorschläge zur Konfiguration einer schöneren Darstellung.

=== Rollladen ===
Dieses Beispiel stellt den Status des Rollladen 10-Prozent genau im Icon dar. Bewegen sich der Rollladen, hat das Icon einen Pfeil nach oben oder unten. Ein Klick auf das Icon setzt den Rollladen in Bewegung oder hält ihn an (toggle).

:<code>attr Velux_2 stateFormat pct execution</code>
:<code>attr Velux_2 devStateIcon .*up:fts_shutter_up:toggle .*down:fts_shutter_down:toggle \d.stop:fts_shutter_100:toggle 1\d.stop:fts_shutter_90:toggle 2\d.stop:fts_shutter_80:toggle 3\d.stop:fts_shutter_70:toggle 4\d.stop:fts_shutter_60:toggle 5\d.stop:fts_shutter_50:toggle 6\d.stop:fts_shutter_40:toggle 7\d.stop:fts_shutter_30:toggle 8\d.stop:fts_shutter_20:toggle 9\d.stop:fts_shutter_10:toggle 100.stop:fts_window_2w:toggle</code>
[[Datei:RollerShutterUpDown.png|300px|Rollladen mit Pfeilen]]

So erhält man einen Slider für die Rollladenposition:

:<code>attr Velux_2 webCmd pct</code>

=== Dachschrägenfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachschrägenfenster in drei Stufen dar:

0% - 9%: geschlossen

10% - 59%: halb geöffnet

60% - 100%: ganz geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_4 limitationUpdateInterval 600</code>
:<code>attr Velux_4 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_4 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7\).*:weather_rain:toggle \d.$.*:fts_window_roof:toggle [1-5]\d.\(.*:fts_window_roof_open_1:toggle [6-9]\d.\(.*:fts_window_roof_open_2:toggle 100.\(.*:fts_window_roof_open_2:toggle</code>

=== Dachkuppelfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachkuppelfenster in zwei Stufen dar:

0% - 9%: geschlossen

10% - 100%: geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_5 limitationUpdateInterval 600</code>
:<code>attr Velux_5 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_5 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7$.*:weather_rain:toggle \d.\(.*:fts_light_dome:toggle [1-9]\d.\(.*:fts_light_dome_open:toggle 100.\(.*:fts_light_dome_open:toggle</code>

== Problembehebung ==
=== Verbindungsabbrüche ===
Sollte es zu Verbindungsabbrüchen zwischen FHEM und der KLF200-Box kommen, dann sind folgende Dinge zu überprüfen:
==== FHEM Update ====
Ist FHEM aktuell? Am 18.12.2018 gab es ein wichtiges FHEM-Update, das die Stabilität von SSL-Verbindungen wesentlich verbessert hat.
==== OpenSSL ====
OpenSLL sollte immer aktuell sein.
==== Perl SSL-Bibliotheken ====
Wenn die Perl SSL-Bibliotheken zu alt sind, ist das oben genannte FHEM-Update wirkungslos.
* IO::Socket::SSL
* Net::SSL
* Net::SSLeay
* Net::SSLeay::Handle
* Crypt::SSLeay
* Net::Server::Proto::SSL

=== Registrieren von Geräten an der KLF200-Box ===

Die [https://velcdn.azureedge.net/~/media/marketing/ch/fachleute/einbauanleitungen/elektro-nachrustung/zubehor/klf-200_bedienungsanleitung_basic%20de.pdf KLF200-Dokumentation] Seite 11 - 19 beschreibt 2 Varianten, um Geräte mit der Box zu koppeln.

==== 1. Registrierung mit einer Zweiweg-Bedienung ====
Dieser Weg funktioniert über die Schlüssel-Taste oder im Web-UI über PRODUKTE KOPIEREN.

Es ist eine Zweiweg-Bedienung erforderlich, die in der Lage ist, die IO-Schlüssel zu exportieren.

Dieser Weg geht z.B. mit dem Control Pad KLR200, Somfy TaHoma, [https://www.somfy.de/hilfe-center/faq/wie-binde-ich-produkte-ein-die-bereits-mit-einem-2-wege-sender-angesteuert-werden Nina io, Telis Composio io, Impresario Chronis io, Easy Sun io und Telis 1 io.].

TaHoma: anmelden, Menü "Sicherheitseinstellungen", Reiter "io-System", "SICHERHEITSSCHLÜSSEL SENDEN"

==== 2. Registrierung mit einer Einweg-Bedienung ====
Dieser Weg funktioniert über die Reset-Taste oder im Web-UI über PRODUKTSUCHE.

Hierzu wird das Gerät über eine Fernbedienung oder direkt am Gerät in einen Anlernzustand versetzt und dann einigen sich KLF200 und das Gerät über einen Schlüssel.

Bei manchen Somfy-Geräten scheint dieser Weg nicht zu funktionieren, z.B. einige Somfy Smoove Produkte. Hier bleibt nur die Möglichkeit, die Schlüssel wie in Variante 1 von einer Somfy Zweiweg-Bedienung zu kopieren.

== Links ==
* Support im Forum gibt es unter {{Link2Forum|Topic=92907|LinkText=Velux KLF200 mit Firmware 2.0.0.71 für io-homecontrol}}
* Github: [https://github.com/buennerbernd/fhem/tree/master/KLF200/2.0 FHEM modules KLF200 and KLF200Node]

[[Kategorie:Rollladensteuerung]]
[[Kategorie:Other Components]]

Velux KLF200

2019-07-19T15:00:08Z

Buennerbernd: /* 1. Registrierung mit einer Zweiweg-Bedienung */

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Anbindung io-homecontrol Aktoren an FHEM
|ModType=x
|ModCmdRef=KLF200
|ModFTopic=92907
|ModTechName=83_KLF200.pm
|ModOwner=buennerbernd ({{Link2FU|21440|Forum}} / [[Benutzer Diskussion:Buennerbernd|Wiki]])
}}

[[KLF200]] ist ein Modul zur Steuerung von io-homecontrol Aktoren über das Gateway Velux KLF 200.

== Velux KLF 200 ==

Die KLF-200-Box ist über LAN mit FHEM verbunden und steuert die Aktoren über das verschlüsselte Funkprotokoll io-homecontrol.
Die Aktoren geben Rückmeldung über ihren aktuellen Zustand.

Die Box hat 10 elektrische Eingänge mit denen man 5 Geräte oder Gerätegruppen steuern kann.
Damit kann man z.B. mit Doppeltastern an der Wand seine Rollladen oder Fenster steuern.
Über den LAN-Anschluss lassen sich mit FHEM bis zu 200 Geräte mit einer KLF 200 verwalten.

Das Modul erfordert die Firmware-Version 2.0.0.71 und basiert auf der dokumentierten API von Velux. [https://www.velux.com/api/klf200 Download und weitere Informationen]

Das Gateway hat keine Cloud-Integration.

== Unterstützte Geräte ==

Grundsätzlich sollten alle io-homecontrol Aktoren funktionieren. Alleinstehende Sensoren (z.B. Lichtsensor, Windsensor) werden
von der KLF-200-Box nicht unterstützt. Es besteht aber die Möglichkeit, den Status von Sensoren auszuwerten, die in Aktoren integriert sind.

Aktuell werden folgende Geräte erfolgreich mit diesem Modul verwendet:

* Rollladen:
** VELUX SML
** VELUX SSL
** Somfy Oximo io
** Somfy Izymo io
* Sichtschutz innen:
** VELUX FSK
** VELUX DML
* Fensteröffner mit integriertem Regensensor:
** VELUX KMG
** VELUX CVP
** VELUX KSX
* Markisen:
** VELUX MSL
** Somfy Sunea io

== Benutzung in FHEM ==
=== Vorbereitung ===
Bevor die Aktoren in FHEM verwendet werden können, müssen sie in der [[#Registrieren von Geräten an der KLF200-Box|KLF 200 angelernt]] werden.
Das geschieht über das WebUI der KLF 200, das über einen Wifi-Hotspot erreichbar ist. Dieser Vorgang ist im Handbuch beschrieben.
Im WebUI können die angeschlossenen Geräte auch benannt werden. Zusätzlich hat man die Möglichkeit, Programme (Szenen) aufzuzeichnen,
um ein oder mehrere Geräte in eine definierte Position zu bringen. Diese Szenen kann man aus FHEM ebenfalls ansteuern.

Das Modul wird momentan noch nicht über FHEM ausgeliefert.
Es wird wie folgt geladen und aktualisiert:

:<code>update all <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>
:<code>shutdown restart</code>

Mit diesem Befehl wird das Modul so eingerichtet, dass es ebenfalls aktualisiert wird, wenn man FHEM aktualisiert:
:<code>update add <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>

=== Anlegen der Geräte ===
:<code>define <name> KLF200 <host></code>
Beispiel:
:<code>define Velux KLF200 192.168.0.66</code>

Danach Login durch Eingabe des Passwortes:
:<code>set <name> login <password></code>

Hinweis: Das Passwort ist laut Dokumentation das Wifi-Passwort, das auf den Boden der Box gedruckt ist.
Das funktioniert bei einigen Nutzern. Bei vielen Nutzern funktioniert hingegen das Passwort des WebUI.
Scheinbar hängt das davon ab, mit welcher Firmware die Box ausgeliefert wurde und ob schon einmal ein Reset durchgeführt wurde.
Das Passwort wird verschleiert im FHEM-Backend gespeichert. Es muss nach erfolgreichem Login nicht mehr eingegeben werden.

Die angeschlossenen Aktoren werden jetzt durch autocreate als Instanzen von KLF200Node im Raum KLF200Node angelegt.
Die Namen der Geräte folgen dem Muster <name>_<NodeID>.
Wurde im WebUI der KLF200 ein Name für das Gerät vergeben dann wird dieser als Alias übernommen.

Die Geräte sind jetzt einsatzbereit.

== Modul KLF200 ==
=== Verbindungsstatus ===
==== STATE ====
Im STATE des Moduls sieht man den aktuellen Verbindungsstatus. Im Idealfall ist er nach der Initialisierung Logged in.
=== Ausführung von Programmen (Szenen) ===
Obwohl man mit dem Modul KLF200Node jedes Gerät unabhängig und auch gleichzeitig steuern kann, sind Szenen eine nützliche Ergänzung. So kann man mit Szenen wie "Alle zu" oder "Alle auf" viele Geräte gleichzeitig mit einem Befehl bedienen.

Hinweis: Während der Abarbeitung einer Szene werden weitere Befehle gepuffert.
==== scene/sceneID ====
Mit diesen Set-Funktionen kann man eine aufgezeichnete Szene aufrufen.
Im entsprechenden Reading steht die zuletzt aufgerufene Szene.

Die Zuordnung zwischen sceneID und scene sieht man in den Internals unter scenes.

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Bei vielen aktuellen Geräten lässt sich die Ausführungsgeschwindigkeit (Velocity) variieren. So lässt sich die Geschwindigkeit gegenüber der Default-Geschwindigkeit noch erhöhen oder auch deutlich reduzieren. So ist eine besonders leise Bedienung möglich.

==== Argument DEFAULT, FAST, SILENT ====
Die Velocity kann man bei der Ausführung von Szenen als zusätzliches Argument von set scene oder set sceneID setzen.
Unterstützte Werte sind DEFAULT, FAST und SILENT
:<code>set Velux scene "Alle zu" SILENT</code>
==== Attribut velocity ====
Alternativ kann man im Modul KLF200 das Attribut velocity setzen, das bei der Ausführung von Szenen herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

Hinweis: Dieses Attribut hat keine Auswirkungen auf Befehle, die vom Modul KLF200Node abgesetzt werden.

== Modul KLF200Node ==
Dieses Modul wurde dem Homematic-Modul CUL_HM nachempfunden, da es ebenfalls ein breites Spektrum an Geräten unterstützt
und möglichst kompatibel zu vorhandenen Hilfsmodulen sein soll.
=== Aktueller Status ===
Im Folgenden wird der Zusammenhang zwischen den wichtigsten Readings/Set-Funktionen pct, state, execution erklärt.
==== pct ====
Dieses Reading enthält den aktuell bekannten Status des Gerätes in Prozent.

Wird das Gerät über die KLF-200-Box gesteuert, wird das Reading beim Erreichen der Zielposition sofort aktualisiert.

Wird das Gerät über eine Fernbedienung oder einen Sensor gesteuert, kann sich die Aktualisierung wenige Minuten verzögern.

Mit der Set-Funktion kann man das Gerät in diesen Status versetzen.
Per Default entspricht 100 auf der Fernbedienung oben und 0 unten.
==== state ====
Dieses Reading entspricht dem Reading pct, mit der Ausnahme, dass 0 durch '''off''' ersetzt wird und 100 durch '''on'''.

Die Set-Funktion funktioniert analog.
Per Default entspricht on auf der Fernbedienung oben und off unten.

Es werden die '''set extensions''' unterstützt. Damit können mit einem Set ein oder mehrere Befehle zeitgesteuert abgesetzt werden.

Doku: [https://fhem.de/commandref_DE.html#set set extensions in der commandref] und im [[DevelopmentModuleIntro#X_Set]] jeweils etwas weiter unten.

==== execution ====
Dieses Reading gibt den aktuellen Ausführungsstatus wieder. Die meiste Zeit ist der Wert stop.
Wird gerade ein Befehl ausgeführt, ist der Wert up oder down.

Mit der Set-Funktion werden entsprechende Befehle ausgeführt, up entspricht auf der Fernbedienung oben und down unten.
Bei stop wird die aktuelle Ausführung angehalten.

==== Attribut directionOn ====
Wie oben beschrieben, entspricht per Default on = 100 = up.

Das kann bei bestimmten Geräten für manchen Nutzer verwirrend sein.
Wenn man z.B. bei einem Rollladen lieber im geschlossenen Zustand 100 Prozent sehen möchte, dann setzt man das Attribut directionOn, z.B.
:<code>attr Velux_2 directionOn down</code>

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Wie bei Szenen lässt sich auch bei Kommandos auf KLF200Node die Ausführungsgeschwindigkeit beeinflussen, soweit das vom Gerät unterstützt ist.
==== Reading velocity ====
Dieses Reading hat den Wert supported, wenn die Geschwindigkeit bei diesem Gerät geändert werden kann.
Selbst bei Not supported wäre es einen Versuch wert, es zu testen.
==== Argument DEFAULT, FAST, SILENT ====
Alle set-Funktionen, die eine Bewegung auslösen unterstützen das optionale Argument DEFAULT, FAST oder SILENT.
==== Attribut velocity ====
Alternativ kann man im Modul KLF200Node das Attribut velocity setzen, das bei der Ausführung von Kommandos herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

=== Begrenzung des Bewegungsradius / Limitation ===
Die io-homecontrol Geräte haben ein Feature eingebaut, um den Bewegungsradius der Geräte einzuschränken, egal von wo aus sie gesteuert werden. Dieses Limitation-Feature ist in dieses FHEM-Modul ebenfalls integriert.
==== limitationMin und limitationMax ====
Mit den Settern und Readings limitationMin und limitationMax kann man die Limitation setzen und auslesen.
Natürlich kann man auch selbst von der Limitation Gebrauch machen. Man kann z.B. einen Rollladen begrenzen, wenn man weiß, dass das Dachfenster weit offen ist. Dann kann der Rollladen nicht gegen das Fenster stoßen, selbst wenn man ihn mit der Fernbedienung bewegt.
==== limiationClear ====
Mit dem Setter limiationClear kann man alle Limitations (auch von fremden Geräten ausgelöste) löschen.
==== updateLimiation ====
Der Setter updateLimiation aktualisiert die Readings limitationMin und limitationMax auf diesem Gerät, falls die Limitation außerhalb von FHEM gesetzt wurde.

=== Auswerten der Regensensoren ===
Die Regensensoren von Velux Fensteröffnern machen von diesem Limitation-Feature Gebrauch. Wenn es regnet, wird der Bewegungsradius der Fenster eingeschränkt. Zum Beispiel (evtl. Geräte-abhängig):
* limitationMax = 7 bei Regen,
* limitationMax = 100 wenn es aufhört.
Diese Werte kann man auslesen, ohne dass sich das Fenster dazu bewegt haben muss.

==== limitationUpdateInterval ====
Mit set limitationUpdateInterval kann man festlegen, wie oft diese Werte ausgelesen werden:
* off: Dieser Wert ist für Geräte ohne integrierte Sensoren der Beste, denn zusätzliche Updates sind überflüssig.
* onChange: Hier wird limitationMin und limitationMax aktualisiert, wenn das Gerät bewegt wurde.
* interval in s: Ein Poll-Intervall in Sekunden. Tests mit 120 sind erfolgreich durchgelaufen. Dieser Wert ist vielleicht etwas übertrieben, man denke an das Funkfeuer und den Akku der Geräte. Ein Intervall von 600 ist vielleicht sinnvoller. Beispiele:
:<code>set Velux_1 limitationUpdateInterval off</code>
:<code>set Velux_2 limitationUpdateInterval onChange</code>
:<code>set Velux_3 limitationUpdateInterval 600</code>

==== Extra Reading für den Regensensor ====
Wem die Auswertung vom Reading limitationMax zu indirekt ist, der kann sich ein neues Reading anlegen.
Der folgende Code legt ein Reading namens sensor an, die Werte sind im Beispiel "Regen" oder "trocken".
Es besteht die Annahme, dass bei limitationMax = 7 der Regensensor angeschlagen hat.
:<code>attr Velux_3 userReadings sensor {(ReadingsVal($name,"limitationMax",100) == 7)?"Regen":"trocken"}</code>
Hinweis: Das neue Reading sensor erscheint erst, wenn das Reading limitationMax einmal aktualisiert wurde.

== Vorschläge zur schöneren Darstellung ==
Wie Homematic-Geräte kommt KLF200Node im FHEM-Web sehr schlicht daher. Dieses Kapitel gibt Vorschläge zur Konfiguration einer schöneren Darstellung.

=== Rollladen ===
Dieses Beispiel stellt den Status des Rollladen 10-Prozent genau im Icon dar. Bewegen sich der Rollladen, hat das Icon einen Pfeil nach oben oder unten. Ein Klick auf das Icon setzt den Rollladen in Bewegung oder hält ihn an (toggle).

:<code>attr Velux_2 stateFormat pct execution</code>
:<code>attr Velux_2 devStateIcon .*up:fts_shutter_up:toggle .*down:fts_shutter_down:toggle \d.stop:fts_shutter_100:toggle 1\d.stop:fts_shutter_90:toggle 2\d.stop:fts_shutter_80:toggle 3\d.stop:fts_shutter_70:toggle 4\d.stop:fts_shutter_60:toggle 5\d.stop:fts_shutter_50:toggle 6\d.stop:fts_shutter_40:toggle 7\d.stop:fts_shutter_30:toggle 8\d.stop:fts_shutter_20:toggle 9\d.stop:fts_shutter_10:toggle 100.stop:fts_window_2w:toggle</code>
[[Datei:RollerShutterUpDown.png|300px|Rollladen mit Pfeilen]]

So erhält man einen Slider für die Rollladenposition:

:<code>attr Velux_2 webCmd pct</code>

=== Dachschrägenfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachschrägenfenster in drei Stufen dar:

0% - 9%: geschlossen

10% - 59%: halb geöffnet

60% - 100%: ganz geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_4 limitationUpdateInterval 600</code>
:<code>attr Velux_4 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_4 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7\).*:weather_rain:toggle \d.$.*:fts_window_roof:toggle [1-5]\d.\(.*:fts_window_roof_open_1:toggle [6-9]\d.\(.*:fts_window_roof_open_2:toggle 100.\(.*:fts_window_roof_open_2:toggle</code>

=== Dachkuppelfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachkuppelfenster in zwei Stufen dar:

0% - 9%: geschlossen

10% - 100%: geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_5 limitationUpdateInterval 600</code>
:<code>attr Velux_5 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_5 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7$.*:weather_rain:toggle \d.\(.*:fts_light_dome:toggle [1-9]\d.\(.*:fts_light_dome_open:toggle 100.\(.*:fts_light_dome_open:toggle</code>

== Problembehebung ==
=== Verbindungsabbrüche ===
Sollte es zu Verbindungsabbrüchen zwischen FHEM und der KLF200-Box kommen, dann sind folgende Dinge zu überprüfen:
==== FHEM Update ====
Ist FHEM aktuell? Am 18.12.2018 gab es ein wichtiges FHEM-Update, das die Stabilität von SSL-Verbindungen wesentlich verbessert hat.
==== OpenSSL ====
OpenSLL sollte immer aktuell sein.
==== Perl SSL-Bibliotheken ====
Wenn die Perl SSL-Bibliotheken zu alt sind, ist das oben genannte FHEM-Update wirkungslos.
* IO::Socket::SSL
* Net::SSL
* Net::SSLeay
* Net::SSLeay::Handle
* Crypt::SSLeay
* Net::Server::Proto::SSL

=== Registrieren von Geräten an der KLF200-Box ===

Die [https://velcdn.azureedge.net/~/media/marketing/ch/fachleute/einbauanleitungen/elektro-nachrustung/zubehor/klf-200_bedienungsanleitung_basic%20de.pdf KLF200-Dokumentation] Seite 11 - 19 beschreibt 2 Varianten, um Geräte mit der Box zu koppeln.

==== 1. Registrierung mit einer Zweiweg-Bedienung ====
Dieser Weg funktioniert über die Schlüssel-Taste oder im Web-UI über PRODUKTE KOPIEREN.

Es ist eine Zweiweg-Bedienung erforderlich, die in der Lage ist, die IO-Schlüssel zu exportieren.

Dieser Weg geht z.B. mit dem Control Pad KLR200, Somfy TaHoma, [https://www.somfy.de/hilfe-center/faq/wie-binde-ich-produkte-ein-die-bereits-mit-einem-2-wege-sender-angesteuert-werden Nina io, Telis Composio io, Impresario Chronis io, Easy Sun io und Telis 1 io.].

TaHoma: anmelden, Menü "Sicherheitseinstellungen", Reiter "io-System", "SICHERHEITSSCHLÜSSEL SENDEN"

==== 2. Registrierung mit einer Einweg-Bedienung ====
Dieser Weg funktioniert über die Reset-Taste oder im Web-UI über PRODUKTSUCHE.

Hierzu wird das Gerät über eine Fernbedienung oder direkt am Gerät in einen Anlernzustand versetzt und dann einigen sich KLF200 und das Gerät über einen Schlüssel.

Bei manchen Somfy-Geräten scheint dieser Weg nicht zu funktionieren, z.B. einige Somfy Smoove Produkte. Hier bleibt nur die Möglichkeit, die Schlüssel wie in Variante 1 von einer Somfy Zweiweg-Bedienung wie z.B. TaHoma zu kopieren.

== Links ==
* Support im Forum gibt es unter {{Link2Forum|Topic=92907|LinkText=Velux KLF200 mit Firmware 2.0.0.71 für io-homecontrol}}
* Github: [https://github.com/buennerbernd/fhem/tree/master/KLF200/2.0 FHEM modules KLF200 and KLF200Node]

[[Kategorie:Rollladensteuerung]]
[[Kategorie:Other Components]]

Velux KLF200

2019-07-19T14:43:09Z

Buennerbernd:

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Anbindung io-homecontrol Aktoren an FHEM
|ModType=x
|ModCmdRef=KLF200
|ModFTopic=92907
|ModTechName=83_KLF200.pm
|ModOwner=buennerbernd ({{Link2FU|21440|Forum}} / [[Benutzer Diskussion:Buennerbernd|Wiki]])
}}

[[KLF200]] ist ein Modul zur Steuerung von io-homecontrol Aktoren über das Gateway Velux KLF 200.

== Velux KLF 200 ==

Die KLF-200-Box ist über LAN mit FHEM verbunden und steuert die Aktoren über das verschlüsselte Funkprotokoll io-homecontrol.
Die Aktoren geben Rückmeldung über ihren aktuellen Zustand.

Die Box hat 10 elektrische Eingänge mit denen man 5 Geräte oder Gerätegruppen steuern kann.
Damit kann man z.B. mit Doppeltastern an der Wand seine Rollladen oder Fenster steuern.
Über den LAN-Anschluss lassen sich mit FHEM bis zu 200 Geräte mit einer KLF 200 verwalten.

Das Modul erfordert die Firmware-Version 2.0.0.71 und basiert auf der dokumentierten API von Velux. [https://www.velux.com/api/klf200 Download und weitere Informationen]

Das Gateway hat keine Cloud-Integration.

== Unterstützte Geräte ==

Grundsätzlich sollten alle io-homecontrol Aktoren funktionieren. Alleinstehende Sensoren (z.B. Lichtsensor, Windsensor) werden
von der KLF-200-Box nicht unterstützt. Es besteht aber die Möglichkeit, den Status von Sensoren auszuwerten, die in Aktoren integriert sind.

Aktuell werden folgende Geräte erfolgreich mit diesem Modul verwendet:

* Rollladen:
** VELUX SML
** VELUX SSL
** Somfy Oximo io
** Somfy Izymo io
* Sichtschutz innen:
** VELUX FSK
** VELUX DML
* Fensteröffner mit integriertem Regensensor:
** VELUX KMG
** VELUX CVP
** VELUX KSX
* Markisen:
** VELUX MSL
** Somfy Sunea io

== Benutzung in FHEM ==
=== Vorbereitung ===
Bevor die Aktoren in FHEM verwendet werden können, müssen sie in der [[#Registrieren von Geräten an der KLF200-Box|KLF 200 angelernt]] werden.
Das geschieht über das WebUI der KLF 200, das über einen Wifi-Hotspot erreichbar ist. Dieser Vorgang ist im Handbuch beschrieben.
Im WebUI können die angeschlossenen Geräte auch benannt werden. Zusätzlich hat man die Möglichkeit, Programme (Szenen) aufzuzeichnen,
um ein oder mehrere Geräte in eine definierte Position zu bringen. Diese Szenen kann man aus FHEM ebenfalls ansteuern.

Das Modul wird momentan noch nicht über FHEM ausgeliefert.
Es wird wie folgt geladen und aktualisiert:

:<code>update all <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>
:<code>shutdown restart</code>

Mit diesem Befehl wird das Modul so eingerichtet, dass es ebenfalls aktualisiert wird, wenn man FHEM aktualisiert:
:<code>update add <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>

=== Anlegen der Geräte ===
:<code>define <name> KLF200 <host></code>
Beispiel:
:<code>define Velux KLF200 192.168.0.66</code>

Danach Login durch Eingabe des Passwortes:
:<code>set <name> login <password></code>

Hinweis: Das Passwort ist laut Dokumentation das Wifi-Passwort, das auf den Boden der Box gedruckt ist.
Das funktioniert bei einigen Nutzern. Bei vielen Nutzern funktioniert hingegen das Passwort des WebUI.
Scheinbar hängt das davon ab, mit welcher Firmware die Box ausgeliefert wurde und ob schon einmal ein Reset durchgeführt wurde.
Das Passwort wird verschleiert im FHEM-Backend gespeichert. Es muss nach erfolgreichem Login nicht mehr eingegeben werden.

Die angeschlossenen Aktoren werden jetzt durch autocreate als Instanzen von KLF200Node im Raum KLF200Node angelegt.
Die Namen der Geräte folgen dem Muster <name>_<NodeID>.
Wurde im WebUI der KLF200 ein Name für das Gerät vergeben dann wird dieser als Alias übernommen.

Die Geräte sind jetzt einsatzbereit.

== Modul KLF200 ==
=== Verbindungsstatus ===
==== STATE ====
Im STATE des Moduls sieht man den aktuellen Verbindungsstatus. Im Idealfall ist er nach der Initialisierung Logged in.
=== Ausführung von Programmen (Szenen) ===
Obwohl man mit dem Modul KLF200Node jedes Gerät unabhängig und auch gleichzeitig steuern kann, sind Szenen eine nützliche Ergänzung. So kann man mit Szenen wie "Alle zu" oder "Alle auf" viele Geräte gleichzeitig mit einem Befehl bedienen.

Hinweis: Während der Abarbeitung einer Szene werden weitere Befehle gepuffert.
==== scene/sceneID ====
Mit diesen Set-Funktionen kann man eine aufgezeichnete Szene aufrufen.
Im entsprechenden Reading steht die zuletzt aufgerufene Szene.

Die Zuordnung zwischen sceneID und scene sieht man in den Internals unter scenes.

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Bei vielen aktuellen Geräten lässt sich die Ausführungsgeschwindigkeit (Velocity) variieren. So lässt sich die Geschwindigkeit gegenüber der Default-Geschwindigkeit noch erhöhen oder auch deutlich reduzieren. So ist eine besonders leise Bedienung möglich.

==== Argument DEFAULT, FAST, SILENT ====
Die Velocity kann man bei der Ausführung von Szenen als zusätzliches Argument von set scene oder set sceneID setzen.
Unterstützte Werte sind DEFAULT, FAST und SILENT
:<code>set Velux scene "Alle zu" SILENT</code>
==== Attribut velocity ====
Alternativ kann man im Modul KLF200 das Attribut velocity setzen, das bei der Ausführung von Szenen herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

Hinweis: Dieses Attribut hat keine Auswirkungen auf Befehle, die vom Modul KLF200Node abgesetzt werden.

== Modul KLF200Node ==
Dieses Modul wurde dem Homematic-Modul CUL_HM nachempfunden, da es ebenfalls ein breites Spektrum an Geräten unterstützt
und möglichst kompatibel zu vorhandenen Hilfsmodulen sein soll.
=== Aktueller Status ===
Im Folgenden wird der Zusammenhang zwischen den wichtigsten Readings/Set-Funktionen pct, state, execution erklärt.
==== pct ====
Dieses Reading enthält den aktuell bekannten Status des Gerätes in Prozent.

Wird das Gerät über die KLF-200-Box gesteuert, wird das Reading beim Erreichen der Zielposition sofort aktualisiert.

Wird das Gerät über eine Fernbedienung oder einen Sensor gesteuert, kann sich die Aktualisierung wenige Minuten verzögern.

Mit der Set-Funktion kann man das Gerät in diesen Status versetzen.
Per Default entspricht 100 auf der Fernbedienung oben und 0 unten.
==== state ====
Dieses Reading entspricht dem Reading pct, mit der Ausnahme, dass 0 durch '''off''' ersetzt wird und 100 durch '''on'''.

Die Set-Funktion funktioniert analog.
Per Default entspricht on auf der Fernbedienung oben und off unten.

Es werden die '''set extensions''' unterstützt. Damit können mit einem Set ein oder mehrere Befehle zeitgesteuert abgesetzt werden.

Doku: [https://fhem.de/commandref_DE.html#set set extensions in der commandref] und im [[DevelopmentModuleIntro#X_Set]] jeweils etwas weiter unten.

==== execution ====
Dieses Reading gibt den aktuellen Ausführungsstatus wieder. Die meiste Zeit ist der Wert stop.
Wird gerade ein Befehl ausgeführt, ist der Wert up oder down.

Mit der Set-Funktion werden entsprechende Befehle ausgeführt, up entspricht auf der Fernbedienung oben und down unten.
Bei stop wird die aktuelle Ausführung angehalten.

==== Attribut directionOn ====
Wie oben beschrieben, entspricht per Default on = 100 = up.

Das kann bei bestimmten Geräten für manchen Nutzer verwirrend sein.
Wenn man z.B. bei einem Rollladen lieber im geschlossenen Zustand 100 Prozent sehen möchte, dann setzt man das Attribut directionOn, z.B.
:<code>attr Velux_2 directionOn down</code>

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Wie bei Szenen lässt sich auch bei Kommandos auf KLF200Node die Ausführungsgeschwindigkeit beeinflussen, soweit das vom Gerät unterstützt ist.
==== Reading velocity ====
Dieses Reading hat den Wert supported, wenn die Geschwindigkeit bei diesem Gerät geändert werden kann.
Selbst bei Not supported wäre es einen Versuch wert, es zu testen.
==== Argument DEFAULT, FAST, SILENT ====
Alle set-Funktionen, die eine Bewegung auslösen unterstützen das optionale Argument DEFAULT, FAST oder SILENT.
==== Attribut velocity ====
Alternativ kann man im Modul KLF200Node das Attribut velocity setzen, das bei der Ausführung von Kommandos herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

=== Begrenzung des Bewegungsradius / Limitation ===
Die io-homecontrol Geräte haben ein Feature eingebaut, um den Bewegungsradius der Geräte einzuschränken, egal von wo aus sie gesteuert werden. Dieses Limitation-Feature ist in dieses FHEM-Modul ebenfalls integriert.
==== limitationMin und limitationMax ====
Mit den Settern und Readings limitationMin und limitationMax kann man die Limitation setzen und auslesen.
Natürlich kann man auch selbst von der Limitation Gebrauch machen. Man kann z.B. einen Rollladen begrenzen, wenn man weiß, dass das Dachfenster weit offen ist. Dann kann der Rollladen nicht gegen das Fenster stoßen, selbst wenn man ihn mit der Fernbedienung bewegt.
==== limiationClear ====
Mit dem Setter limiationClear kann man alle Limitations (auch von fremden Geräten ausgelöste) löschen.
==== updateLimiation ====
Der Setter updateLimiation aktualisiert die Readings limitationMin und limitationMax auf diesem Gerät, falls die Limitation außerhalb von FHEM gesetzt wurde.

=== Auswerten der Regensensoren ===
Die Regensensoren von Velux Fensteröffnern machen von diesem Limitation-Feature Gebrauch. Wenn es regnet, wird der Bewegungsradius der Fenster eingeschränkt. Zum Beispiel (evtl. Geräte-abhängig):
* limitationMax = 7 bei Regen,
* limitationMax = 100 wenn es aufhört.
Diese Werte kann man auslesen, ohne dass sich das Fenster dazu bewegt haben muss.

==== limitationUpdateInterval ====
Mit set limitationUpdateInterval kann man festlegen, wie oft diese Werte ausgelesen werden:
* off: Dieser Wert ist für Geräte ohne integrierte Sensoren der Beste, denn zusätzliche Updates sind überflüssig.
* onChange: Hier wird limitationMin und limitationMax aktualisiert, wenn das Gerät bewegt wurde.
* interval in s: Ein Poll-Intervall in Sekunden. Tests mit 120 sind erfolgreich durchgelaufen. Dieser Wert ist vielleicht etwas übertrieben, man denke an das Funkfeuer und den Akku der Geräte. Ein Intervall von 600 ist vielleicht sinnvoller. Beispiele:
:<code>set Velux_1 limitationUpdateInterval off</code>
:<code>set Velux_2 limitationUpdateInterval onChange</code>
:<code>set Velux_3 limitationUpdateInterval 600</code>

==== Extra Reading für den Regensensor ====
Wem die Auswertung vom Reading limitationMax zu indirekt ist, der kann sich ein neues Reading anlegen.
Der folgende Code legt ein Reading namens sensor an, die Werte sind im Beispiel "Regen" oder "trocken".
Es besteht die Annahme, dass bei limitationMax = 7 der Regensensor angeschlagen hat.
:<code>attr Velux_3 userReadings sensor {(ReadingsVal($name,"limitationMax",100) == 7)?"Regen":"trocken"}</code>
Hinweis: Das neue Reading sensor erscheint erst, wenn das Reading limitationMax einmal aktualisiert wurde.

== Vorschläge zur schöneren Darstellung ==
Wie Homematic-Geräte kommt KLF200Node im FHEM-Web sehr schlicht daher. Dieses Kapitel gibt Vorschläge zur Konfiguration einer schöneren Darstellung.

=== Rollladen ===
Dieses Beispiel stellt den Status des Rollladen 10-Prozent genau im Icon dar. Bewegen sich der Rollladen, hat das Icon einen Pfeil nach oben oder unten. Ein Klick auf das Icon setzt den Rollladen in Bewegung oder hält ihn an (toggle).

:<code>attr Velux_2 stateFormat pct execution</code>
:<code>attr Velux_2 devStateIcon .*up:fts_shutter_up:toggle .*down:fts_shutter_down:toggle \d.stop:fts_shutter_100:toggle 1\d.stop:fts_shutter_90:toggle 2\d.stop:fts_shutter_80:toggle 3\d.stop:fts_shutter_70:toggle 4\d.stop:fts_shutter_60:toggle 5\d.stop:fts_shutter_50:toggle 6\d.stop:fts_shutter_40:toggle 7\d.stop:fts_shutter_30:toggle 8\d.stop:fts_shutter_20:toggle 9\d.stop:fts_shutter_10:toggle 100.stop:fts_window_2w:toggle</code>
[[Datei:RollerShutterUpDown.png|300px|Rollladen mit Pfeilen]]

So erhält man einen Slider für die Rollladenposition:

:<code>attr Velux_2 webCmd pct</code>

=== Dachschrägenfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachschrägenfenster in drei Stufen dar:

0% - 9%: geschlossen

10% - 59%: halb geöffnet

60% - 100%: ganz geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_4 limitationUpdateInterval 600</code>
:<code>attr Velux_4 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_4 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7\).*:weather_rain:toggle \d.$.*:fts_window_roof:toggle [1-5]\d.\(.*:fts_window_roof_open_1:toggle [6-9]\d.\(.*:fts_window_roof_open_2:toggle 100.\(.*:fts_window_roof_open_2:toggle</code>

=== Dachkuppelfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachkuppelfenster in zwei Stufen dar:

0% - 9%: geschlossen

10% - 100%: geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_5 limitationUpdateInterval 600</code>
:<code>attr Velux_5 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_5 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7$.*:weather_rain:toggle \d.\(.*:fts_light_dome:toggle [1-9]\d.\(.*:fts_light_dome_open:toggle 100.\(.*:fts_light_dome_open:toggle</code>

== Problembehebung ==
=== Verbindungsabbrüche ===
Sollte es zu Verbindungsabbrüchen zwischen FHEM und der KLF200-Box kommen, dann sind folgende Dinge zu überprüfen:
==== FHEM Update ====
Ist FHEM aktuell? Am 18.12.2018 gab es ein wichtiges FHEM-Update, das die Stabilität von SSL-Verbindungen wesentlich verbessert hat.
==== OpenSSL ====
OpenSLL sollte immer aktuell sein.
==== Perl SSL-Bibliotheken ====
Wenn die Perl SSL-Bibliotheken zu alt sind, ist das oben genannte FHEM-Update wirkungslos.
* IO::Socket::SSL
* Net::SSL
* Net::SSLeay
* Net::SSLeay::Handle
* Crypt::SSLeay
* Net::Server::Proto::SSL

=== Registrieren von Geräten an der KLF200-Box ===

Die [https://velcdn.azureedge.net/~/media/marketing/ch/fachleute/einbauanleitungen/elektro-nachrustung/zubehor/klf-200_bedienungsanleitung_basic%20de.pdf KLF200-Dokumentation] Seite 11 - 19 beschreibt 2 Varianten, um Geräte mit der Box zu koppeln.

==== 1. Registrierung mit einer Zweiweg-Bedienung ====
Dieser Weg funktioniert über die Schlüssel-Taste oder im Web-UI über PRODUKTE KOPIEREN.

Es ist eine Zweiweg-Bedienung erforderlich, die in der Lage ist, die IO-Schlüssel zu exportieren.

Dieser Weg geht z.B. mit dem Control Pad KLR200 und Somfy TaHoma.

TaHoma: anmelden, Menü "Sicherheitseinstellungen", Reiter "io-System", "SICHERHEITSSCHLÜSSEL SENDEN"

==== 2. Registrierung mit einer Einweg-Bedienung ====
Dieser Weg funktioniert über die Reset-Taste oder im Web-UI über PRODUKTSUCHE.

Hierzu wird das Gerät über eine Fernbedienung oder direkt am Gerät in einen Anlernzustand versetzt und dann einigen sich KLF200 und das Gerät über einen Schlüssel.

Bei manchen Somfy-Geräten scheint dieser Weg nicht zu funktionieren, z.B. einige Somfy Smoove Produkte. Hier bleibt nur die Möglichkeit, die Schlüssel wie in Variante 1 von einer Somfy Zweiweg-Bedienung wie z.B. TaHoma zu kopieren.

== Links ==
* Support im Forum gibt es unter {{Link2Forum|Topic=92907|LinkText=Velux KLF200 mit Firmware 2.0.0.71 für io-homecontrol}}
* Github: [https://github.com/buennerbernd/fhem/tree/master/KLF200/2.0 FHEM modules KLF200 and KLF200Node]

[[Kategorie:Rollladensteuerung]]
[[Kategorie:Other Components]]

Velux KLF200

2019-07-19T07:53:35Z

Buennerbernd: /* Unterstützte Geräte */

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Anbindung io-homecontrol Aktoren an FHEM
|ModType=x
|ModCmdRef=KLF200
|ModFTopic=92907
|ModTechName=83_KLF200.pm
|ModOwner=buennerbernd ({{Link2FU|21440|Forum}} / [[Benutzer Diskussion:Buennerbernd|Wiki]])
}}

[[KLF200]] ist ein Modul zur Steuerung von io-homecontrol Aktoren über das Gateway Velux KLF 200.

== Velux KLF 200 ==

Die KLF-200-Box ist über LAN mit FHEM verbunden und steuert die Aktoren über das verschlüsselte Funkprotokoll io-homecontrol.
Die Aktoren geben Rückmeldung über ihren aktuellen Zustand.

Die Box hat 10 elektrische Eingänge mit denen man 5 Geräte oder Gerätegruppen steuern kann.
Damit kann man z.B. mit Doppeltastern an der Wand seine Rollladen oder Fenster steuern.
Über den LAN-Anschluss lassen sich mit FHEM bis zu 200 Geräte mit einer KLF 200 verwalten.

Das Modul erfordert die Firmware-Version 2.0.0.71 und basiert auf der dokumentierten API von Velux. [https://www.velux.com/api/klf200 Download und weitere Informationen]

Das Gateway hat keine Cloud-Integration.

== Unterstützte Geräte ==

Grundsätzlich sollten alle io-homecontrol Aktoren funktionieren. Alleinstehende Sensoren (z.B. Lichtsensor, Windsensor) werden
von der KLF-200-Box nicht unterstützt. Es besteht aber die Möglichkeit, den Status von Sensoren auszuwerten, die in Aktoren integriert sind.

Aktuell werden folgende Geräte erfolgreich mit diesem Modul verwendet:

* Rollladen:
** VELUX SML
** VELUX SSL
** Somfy Oximo io
** Somfy Izymo io
* Sichtschutz innen:
** VELUX FSK
** VELUX DML
* Fensteröffner mit integriertem Regensensor:
** VELUX KMG
** VELUX CVP
** VELUX KSX
* Markisen:
** VELUX MSL
** Somfy Sunea io

== Benutzung in FHEM ==
=== Vorbereitung ===
Bevor die Aktoren in FHEM verwendet werden können, müssen sie in der KLF 200 angelernt werden.
Das geschieht über das WebUI der KLF 200, das über einen Wifi-Hotspot erreichbar ist. Dieser Vorgang ist im Handbuch beschrieben.
Im WebUI können die angeschlossenen Geräte auch benannt werden. Zusätzlich hat man die Möglichkeit, Programme (Szenen) aufzuzeichnen,
um ein oder mehrere Geräte in eine definierte Position zu bringen. Diese Szenen kann man aus FHEM ebenfalls ansteuern.

Das Modul wird momentan noch nicht über FHEM ausgeliefert.
Es wird wie folgt geladen und aktualisiert:

:<code>update all <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>
:<code>shutdown restart</code>

Mit diesem Befehl wird das Modul so eingerichtet, dass es ebenfalls aktualisiert wird, wenn man FHEM aktualisiert:
:<code>update add <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>

=== Anlegen der Geräte ===
:<code>define <name> KLF200 <host></code>
Beispiel:
:<code>define Velux KLF200 192.168.0.66</code>

Danach Login durch Eingabe des Passwortes:
:<code>set <name> login <password></code>

Hinweis: Das Passwort ist laut Dokumentation das Wifi-Passwort, das auf den Boden der Box gedruckt ist.
Das funktioniert bei einigen Nutzern. Bei vielen Nutzern funktioniert hingegen das Passwort des WebUI.
Scheinbar hängt das davon ab, mit welcher Firmware die Box ausgeliefert wurde und ob schon einmal ein Reset durchgeführt wurde.
Das Passwort wird verschleiert im FHEM-Backend gespeichert. Es muss nach erfolgreichem Login nicht mehr eingegeben werden.

Die angeschlossenen Aktoren werden jetzt durch autocreate als Instanzen von KLF200Node im Raum KLF200Node angelegt.
Die Namen der Geräte folgen dem Muster <name>_<NodeID>.
Wurde im WebUI der KLF200 ein Name für das Gerät vergeben dann wird dieser als Alias übernommen.

Die Geräte sind jetzt einsatzbereit.

== Modul KLF200 ==
=== Verbindungsstatus ===
==== STATE ====
Im STATE des Moduls sieht man den aktuellen Verbindungsstatus. Im Idealfall ist er nach der Initialisierung Logged in.
=== Ausführung von Programmen (Szenen) ===
Obwohl man mit dem Modul KLF200Node jedes Gerät unabhängig und auch gleichzeitig steuern kann, sind Szenen eine nützliche Ergänzung. So kann man mit Szenen wie "Alle zu" oder "Alle auf" viele Geräte gleichzeitig mit einem Befehl bedienen.

Hinweis: Während der Abarbeitung einer Szene werden weitere Befehle gepuffert.
==== scene/sceneID ====
Mit diesen Set-Funktionen kann man eine aufgezeichnete Szene aufrufen.
Im entsprechenden Reading steht die zuletzt aufgerufene Szene.

Die Zuordnung zwischen sceneID und scene sieht man in den Internals unter scenes.

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Bei vielen aktuellen Geräten lässt sich die Ausführungsgeschwindigkeit (Velocity) variieren. So lässt sich die Geschwindigkeit gegenüber der Default-Geschwindigkeit noch erhöhen oder auch deutlich reduzieren. So ist eine besonders leise Bedienung möglich.

==== Argument DEFAULT, FAST, SILENT ====
Die Velocity kann man bei der Ausführung von Szenen als zusätzliches Argument von set scene oder set sceneID setzen.
Unterstützte Werte sind DEFAULT, FAST und SILENT
:<code>set Velux scene "Alle zu" SILENT</code>
==== Attribut velocity ====
Alternativ kann man im Modul KLF200 das Attribut velocity setzen, das bei der Ausführung von Szenen herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

Hinweis: Dieses Attribut hat keine Auswirkungen auf Befehle, die vom Modul KLF200Node abgesetzt werden.

== Modul KLF200Node ==
Dieses Modul wurde dem Homematic-Modul CUL_HM nachempfunden, da es ebenfalls ein breites Spektrum an Geräten unterstützt
und möglichst kompatibel zu vorhandenen Hilfsmodulen sein soll.
=== Aktueller Status ===
Im Folgenden wird der Zusammenhang zwischen den wichtigsten Readings/Set-Funktionen pct, state, execution erklärt.
==== pct ====
Dieses Reading enthält den aktuell bekannten Status des Gerätes in Prozent.

Wird das Gerät über die KLF-200-Box gesteuert, wird das Reading beim Erreichen der Zielposition sofort aktualisiert.

Wird das Gerät über eine Fernbedienung oder einen Sensor gesteuert, kann sich die Aktualisierung wenige Minuten verzögern.

Mit der Set-Funktion kann man das Gerät in diesen Status versetzen.
Per Default entspricht 100 auf der Fernbedienung oben und 0 unten.
==== state ====
Dieses Reading entspricht dem Reading pct, mit der Ausnahme, dass 0 durch '''off''' ersetzt wird und 100 durch '''on'''.

Die Set-Funktion funktioniert analog.
Per Default entspricht on auf der Fernbedienung oben und off unten.

Es werden die '''set extensions''' unterstützt. Damit können mit einem Set ein oder mehrere Befehle zeitgesteuert abgesetzt werden.

Doku: [https://fhem.de/commandref_DE.html#set set extensions in der commandref] und im [[DevelopmentModuleIntro#X_Set]] jeweils etwas weiter unten.

==== execution ====
Dieses Reading gibt den aktuellen Ausführungsstatus wieder. Die meiste Zeit ist der Wert stop.
Wird gerade ein Befehl ausgeführt, ist der Wert up oder down.

Mit der Set-Funktion werden entsprechende Befehle ausgeführt, up entspricht auf der Fernbedienung oben und down unten.
Bei stop wird die aktuelle Ausführung angehalten.

==== Attribut directionOn ====
Wie oben beschrieben, entspricht per Default on = 100 = up.

Das kann bei bestimmten Geräten für manchen Nutzer verwirrend sein.
Wenn man z.B. bei einem Rollladen lieber im geschlossenen Zustand 100 Prozent sehen möchte, dann setzt man das Attribut directionOn, z.B.
:<code>attr Velux_2 directionOn down</code>

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Wie bei Szenen lässt sich auch bei Kommandos auf KLF200Node die Ausführungsgeschwindigkeit beeinflussen, soweit das vom Gerät unterstützt ist.
==== Reading velocity ====
Dieses Reading hat den Wert supported, wenn die Geschwindigkeit bei diesem Gerät geändert werden kann.
Selbst bei Not supported wäre es einen Versuch wert, es zu testen.
==== Argument DEFAULT, FAST, SILENT ====
Alle set-Funktionen, die eine Bewegung auslösen unterstützen das optionale Argument DEFAULT, FAST oder SILENT.
==== Attribut velocity ====
Alternativ kann man im Modul KLF200Node das Attribut velocity setzen, das bei der Ausführung von Kommandos herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

=== Begrenzung des Bewegungsradius / Limitation ===
Die io-homecontrol Geräte haben ein Feature eingebaut, um den Bewegungsradius der Geräte einzuschränken, egal von wo aus sie gesteuert werden. Dieses Limitation-Feature ist in dieses FHEM-Modul ebenfalls integriert.
==== limitationMin und limitationMax ====
Mit den Settern und Readings limitationMin und limitationMax kann man die Limitation setzen und auslesen.
Natürlich kann man auch selbst von der Limitation Gebrauch machen. Man kann z.B. einen Rollladen begrenzen, wenn man weiß, dass das Dachfenster weit offen ist. Dann kann der Rollladen nicht gegen das Fenster stoßen, selbst wenn man ihn mit der Fernbedienung bewegt.
==== limiationClear ====
Mit dem Setter limiationClear kann man alle Limitations (auch von fremden Geräten ausgelöste) löschen.
==== updateLimiation ====
Der Setter updateLimiation aktualisiert die Readings limitationMin und limitationMax auf diesem Gerät, falls die Limitation außerhalb von FHEM gesetzt wurde.

=== Auswerten der Regensensoren ===
Die Regensensoren von Velux Fensteröffnern machen von diesem Limitation-Feature Gebrauch. Wenn es regnet, wird der Bewegungsradius der Fenster eingeschränkt. Zum Beispiel (evtl. Geräte-abhängig):
* limitationMax = 7 bei Regen,
* limitationMax = 100 wenn es aufhört.
Diese Werte kann man auslesen, ohne dass sich das Fenster dazu bewegt haben muss.

==== limitationUpdateInterval ====
Mit set limitationUpdateInterval kann man festlegen, wie oft diese Werte ausgelesen werden:
* off: Dieser Wert ist für Geräte ohne integrierte Sensoren der Beste, denn zusätzliche Updates sind überflüssig.
* onChange: Hier wird limitationMin und limitationMax aktualisiert, wenn das Gerät bewegt wurde.
* interval in s: Ein Poll-Intervall in Sekunden. Tests mit 120 sind erfolgreich durchgelaufen. Dieser Wert ist vielleicht etwas übertrieben, man denke an das Funkfeuer und den Akku der Geräte. Ein Intervall von 600 ist vielleicht sinnvoller. Beispiele:
:<code>set Velux_1 limitationUpdateInterval off</code>
:<code>set Velux_2 limitationUpdateInterval onChange</code>
:<code>set Velux_3 limitationUpdateInterval 600</code>

==== Extra Reading für den Regensensor ====
Wem die Auswertung vom Reading limitationMax zu indirekt ist, der kann sich ein neues Reading anlegen.
Der folgende Code legt ein Reading namens sensor an, die Werte sind im Beispiel "Regen" oder "trocken".
Es besteht die Annahme, dass bei limitationMax = 7 der Regensensor angeschlagen hat.
:<code>attr Velux_3 userReadings sensor {(ReadingsVal($name,"limitationMax",100) == 7)?"Regen":"trocken"}</code>
Hinweis: Das neue Reading sensor erscheint erst, wenn das Reading limitationMax einmal aktualisiert wurde.

== Vorschläge zur schöneren Darstellung ==
Wie Homematic-Geräte kommt KLF200Node im FHEM-Web sehr schlicht daher. Dieses Kapitel gibt Vorschläge zur Konfiguration einer schöneren Darstellung.

=== Rollladen ===
Dieses Beispiel stellt den Status des Rollladen 10-Prozent genau im Icon dar. Bewegen sich der Rollladen, hat das Icon einen Pfeil nach oben oder unten. Ein Klick auf das Icon setzt den Rollladen in Bewegung oder hält ihn an (toggle).

:<code>attr Velux_2 stateFormat pct execution</code>
:<code>attr Velux_2 devStateIcon .*up:fts_shutter_up:toggle .*down:fts_shutter_down:toggle \d.stop:fts_shutter_100:toggle 1\d.stop:fts_shutter_90:toggle 2\d.stop:fts_shutter_80:toggle 3\d.stop:fts_shutter_70:toggle 4\d.stop:fts_shutter_60:toggle 5\d.stop:fts_shutter_50:toggle 6\d.stop:fts_shutter_40:toggle 7\d.stop:fts_shutter_30:toggle 8\d.stop:fts_shutter_20:toggle 9\d.stop:fts_shutter_10:toggle 100.stop:fts_window_2w:toggle</code>
[[Datei:RollerShutterUpDown.png|300px|Rollladen mit Pfeilen]]

So erhält man einen Slider für die Rollladenposition:

:<code>attr Velux_2 webCmd pct</code>

=== Dachschrägenfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachschrägenfenster in drei Stufen dar:

0% - 9%: geschlossen

10% - 59%: halb geöffnet

60% - 100%: ganz geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_4 limitationUpdateInterval 600</code>
:<code>attr Velux_4 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_4 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7\).*:weather_rain:toggle \d.$.*:fts_window_roof:toggle [1-5]\d.\(.*:fts_window_roof_open_1:toggle [6-9]\d.\(.*:fts_window_roof_open_2:toggle 100.\(.*:fts_window_roof_open_2:toggle</code>

=== Dachkuppelfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachkuppelfenster in zwei Stufen dar:

0% - 9%: geschlossen

10% - 100%: geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_5 limitationUpdateInterval 600</code>
:<code>attr Velux_5 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_5 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7$.*:weather_rain:toggle \d.\(.*:fts_light_dome:toggle [1-9]\d.\(.*:fts_light_dome_open:toggle 100.\(.*:fts_light_dome_open:toggle</code>

== Problembehebung ==
Sollte es zu Verbindungsabbrüchen zwischen FHEM und der KLF200-Box kommen, dann sind folgende Dinge zu überprüfen:
=== FHEM Update ===
Ist FHEM aktuell? Am 18.12.2018 gab es ein wichtiges FHEM-Update, das die Stabilität von SSL-Verbindungen wesentlich verbessert hat.
=== OpenSSL ===
OpenSLL sollte immer aktuell sein.
=== Perl SSL-Bibliotheken ===
Wenn die Perl SSL-Bibliotheken zu alt sind, ist das oben genannte FHEM-Update wirkungslos.
* IO::Socket::SSL
* Net::SSL
* Net::SSLeay
* Net::SSLeay::Handle
* Crypt::SSLeay
* Net::Server::Proto::SSL
== Links ==
* Support im Forum gibt es unter {{Link2Forum|Topic=92907|LinkText=Velux KLF200 mit Firmware 2.0.0.71 für io-homecontrol}}
* Github: [https://github.com/buennerbernd/fhem/tree/master/KLF200/2.0 FHEM modules KLF200 and KLF200Node]

[[Kategorie:Rollladensteuerung]]
[[Kategorie:Other Components]]

Velux KLF200

2019-05-27T08:09:45Z

Buennerbernd:

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Anbindung io-homecontrol Aktoren an FHEM
|ModType=x
|ModCmdRef=KLF200
|ModFTopic=92907
|ModTechName=83_KLF200.pm
|ModOwner=buennerbernd ({{Link2FU|21440|Forum}} / [[Benutzer Diskussion:Buennerbernd|Wiki]])
}}

[[KLF200]] ist ein Modul zur Steuerung von io-homecontrol Aktoren über das Gateway Velux KLF 200.

== Velux KLF 200 ==

Die KLF-200-Box ist über LAN mit FHEM verbunden und steuert die Aktoren über das verschlüsselte Funkprotokoll io-homecontrol.
Die Aktoren geben Rückmeldung über ihren aktuellen Zustand.

Die Box hat 10 elektrische Eingänge mit denen man 5 Geräte oder Gerätegruppen steuern kann.
Damit kann man z.B. mit Doppeltastern an der Wand seine Rollladen oder Fenster steuern.
Über den LAN-Anschluss lassen sich mit FHEM bis zu 200 Geräte mit einer KLF 200 verwalten.

Das Modul erfordert die Firmware-Version 2.0.0.71 und basiert auf der dokumentierten API von Velux. [https://www.velux.com/api/klf200 Download und weitere Informationen]

Das Gateway hat keine Cloud-Integration.

== Unterstützte Geräte ==

Grundsätzlich sollten alle io-homecontrol Aktoren funktionieren. Alleinstehende Sensoren (z.B. Lichtsensor, Windsensor) werden
von der KLF-200-Box nicht unterstützt. Es besteht aber die Möglichkeit, den Status von Sensoren auszuwerten, die in Aktoren integriert sind.

Aktuell werden folgende Geräte erfolgreich mit diesem Modul verwendet:

* Rollladen:
** VELUX SML
** VELUX SSL
** Somfy Oximo io
* Sichtschutz innen:
** VELUX FSK
** VELUX DML
* Fensteröffner mit integriertem Regensensor:
** VELUX KMG
** VELUX CVP
** VELUX KSX
* Markisen:
** VELUX MSL
** Somfy Sunea io

== Benutzung in FHEM ==
=== Vorbereitung ===
Bevor die Aktoren in FHEM verwendet werden können, müssen sie in der KLF 200 angelernt werden.
Das geschieht über das WebUI der KLF 200, das über einen Wifi-Hotspot erreichbar ist. Dieser Vorgang ist im Handbuch beschrieben.
Im WebUI können die angeschlossenen Geräte auch benannt werden. Zusätzlich hat man die Möglichkeit, Programme (Szenen) aufzuzeichnen,
um ein oder mehrere Geräte in eine definierte Position zu bringen. Diese Szenen kann man aus FHEM ebenfalls ansteuern.

Das Modul wird momentan noch nicht über FHEM ausgeliefert.
Es wird wie folgt geladen und aktualisiert:

:<code>update all <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>
:<code>shutdown restart</code>

Mit diesem Befehl wird das Modul so eingerichtet, dass es ebenfalls aktualisiert wird, wenn man FHEM aktualisiert:
:<code>update add <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>

=== Anlegen der Geräte ===
:<code>define <name> KLF200 <host></code>
Beispiel:
:<code>define Velux KLF200 192.168.0.66</code>

Danach Login durch Eingabe des Passwortes:
:<code>set <name> login <password></code>

Hinweis: Das Passwort ist laut Dokumentation das Wifi-Passwort, das auf den Boden der Box gedruckt ist.
Das funktioniert bei einigen Nutzern. Bei vielen Nutzern funktioniert hingegen das Passwort des WebUI.
Scheinbar hängt das davon ab, mit welcher Firmware die Box ausgeliefert wurde und ob schon einmal ein Reset durchgeführt wurde.
Das Passwort wird verschleiert im FHEM-Backend gespeichert. Es muss nach erfolgreichem Login nicht mehr eingegeben werden.

Die angeschlossenen Aktoren werden jetzt durch autocreate als Instanzen von KLF200Node im Raum KLF200Node angelegt.
Die Namen der Geräte folgen dem Muster <name>_<NodeID>.
Wurde im WebUI der KLF200 ein Name für das Gerät vergeben dann wird dieser als Alias übernommen.

Die Geräte sind jetzt einsatzbereit.

== Modul KLF200 ==
=== Verbindungsstatus ===
==== STATE ====
Im STATE des Moduls sieht man den aktuellen Verbindungsstatus. Im Idealfall ist er nach der Initialisierung Logged in.
=== Ausführung von Programmen (Szenen) ===
Obwohl man mit dem Modul KLF200Node jedes Gerät unabhängig und auch gleichzeitig steuern kann, sind Szenen eine nützliche Ergänzung. So kann man mit Szenen wie "Alle zu" oder "Alle auf" viele Geräte gleichzeitig mit einem Befehl bedienen.

Hinweis: Während der Abarbeitung einer Szene werden weitere Befehle gepuffert.
==== scene/sceneID ====
Mit diesen Set-Funktionen kann man eine aufgezeichnete Szene aufrufen.
Im entsprechenden Reading steht die zuletzt aufgerufene Szene.

Die Zuordnung zwischen sceneID und scene sieht man in den Internals unter scenes.

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Bei vielen aktuellen Geräten lässt sich die Ausführungsgeschwindigkeit (Velocity) variieren. So lässt sich die Geschwindigkeit gegenüber der Default-Geschwindigkeit noch erhöhen oder auch deutlich reduzieren. So ist eine besonders leise Bedienung möglich.

==== Argument DEFAULT, FAST, SILENT ====
Die Velocity kann man bei der Ausführung von Szenen als zusätzliches Argument von set scene oder set sceneID setzen.
Unterstützte Werte sind DEFAULT, FAST und SILENT
:<code>set Velux scene "Alle zu" SILENT</code>
==== Attribut velocity ====
Alternativ kann man im Modul KLF200 das Attribut velocity setzen, das bei der Ausführung von Szenen herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

Hinweis: Dieses Attribut hat keine Auswirkungen auf Befehle, die vom Modul KLF200Node abgesetzt werden.

== Modul KLF200Node ==
Dieses Modul wurde dem Homematic-Modul CUL_HM nachempfunden, da es ebenfalls ein breites Spektrum an Geräten unterstützt
und möglichst kompatibel zu vorhandenen Hilfsmodulen sein soll.
=== Aktueller Status ===
Im Folgenden wird der Zusammenhang zwischen den wichtigsten Readings/Set-Funktionen pct, state, execution erklärt.
==== pct ====
Dieses Reading enthält den aktuell bekannten Status des Gerätes in Prozent.

Wird das Gerät über die KLF-200-Box gesteuert, wird das Reading beim Erreichen der Zielposition sofort aktualisiert.

Wird das Gerät über eine Fernbedienung oder einen Sensor gesteuert, kann sich die Aktualisierung wenige Minuten verzögern.

Mit der Set-Funktion kann man das Gerät in diesen Status versetzen.
Per Default entspricht 100 auf der Fernbedienung oben und 0 unten.
==== state ====
Dieses Reading entspricht dem Reading pct, mit der Ausnahme, dass 0 durch '''off''' ersetzt wird und 100 durch '''on'''.

Die Set-Funktion funktioniert analog.
Per Default entspricht on auf der Fernbedienung oben und off unten.

Es werden die '''set extensions''' unterstützt. Damit können mit einem Set ein oder mehrere Befehle zeitgesteuert abgesetzt werden.

Doku: [https://fhem.de/commandref_DE.html#set set extensions in der commandref] und im [[DevelopmentModuleIntro#X_Set]] jeweils etwas weiter unten.

==== execution ====
Dieses Reading gibt den aktuellen Ausführungsstatus wieder. Die meiste Zeit ist der Wert stop.
Wird gerade ein Befehl ausgeführt, ist der Wert up oder down.

Mit der Set-Funktion werden entsprechende Befehle ausgeführt, up entspricht auf der Fernbedienung oben und down unten.
Bei stop wird die aktuelle Ausführung angehalten.

==== Attribut directionOn ====
Wie oben beschrieben, entspricht per Default on = 100 = up.

Das kann bei bestimmten Geräten für manchen Nutzer verwirrend sein.
Wenn man z.B. bei einem Rollladen lieber im geschlossenen Zustand 100 Prozent sehen möchte, dann setzt man das Attribut directionOn, z.B.
:<code>attr Velux_2 directionOn down</code>

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Wie bei Szenen lässt sich auch bei Kommandos auf KLF200Node die Ausführungsgeschwindigkeit beeinflussen, soweit das vom Gerät unterstützt ist.
==== Reading velocity ====
Dieses Reading hat den Wert supported, wenn die Geschwindigkeit bei diesem Gerät geändert werden kann.
Selbst bei Not supported wäre es einen Versuch wert, es zu testen.
==== Argument DEFAULT, FAST, SILENT ====
Alle set-Funktionen, die eine Bewegung auslösen unterstützen das optionale Argument DEFAULT, FAST oder SILENT.
==== Attribut velocity ====
Alternativ kann man im Modul KLF200Node das Attribut velocity setzen, das bei der Ausführung von Kommandos herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

=== Begrenzung des Bewegungsradius / Limitation ===
Die io-homecontrol Geräte haben ein Feature eingebaut, um den Bewegungsradius der Geräte einzuschränken, egal von wo aus sie gesteuert werden. Dieses Limitation-Feature ist in dieses FHEM-Modul ebenfalls integriert.
==== limitationMin und limitationMax ====
Mit den Settern und Readings limitationMin und limitationMax kann man die Limitation setzen und auslesen.
Natürlich kann man auch selbst von der Limitation Gebrauch machen. Man kann z.B. einen Rollladen begrenzen, wenn man weiß, dass das Dachfenster weit offen ist. Dann kann der Rollladen nicht gegen das Fenster stoßen, selbst wenn man ihn mit der Fernbedienung bewegt.
==== limiationClear ====
Mit dem Setter limiationClear kann man alle Limitations (auch von fremden Geräten ausgelöste) löschen.
==== updateLimiation ====
Der Setter updateLimiation aktualisiert die Readings limitationMin und limitationMax auf diesem Gerät, falls die Limitation außerhalb von FHEM gesetzt wurde.

=== Auswerten der Regensensoren ===
Die Regensensoren von Velux Fensteröffnern machen von diesem Limitation-Feature Gebrauch. Wenn es regnet, wird der Bewegungsradius der Fenster eingeschränkt. Zum Beispiel (evtl. Geräte-abhängig):
* limitationMax = 7 bei Regen,
* limitationMax = 100 wenn es aufhört.
Diese Werte kann man auslesen, ohne dass sich das Fenster dazu bewegt haben muss.

==== limitationUpdateInterval ====
Mit set limitationUpdateInterval kann man festlegen, wie oft diese Werte ausgelesen werden:
* off: Dieser Wert ist für Geräte ohne integrierte Sensoren der Beste, denn zusätzliche Updates sind überflüssig.
* onChange: Hier wird limitationMin und limitationMax aktualisiert, wenn das Gerät bewegt wurde.
* interval in s: Ein Poll-Intervall in Sekunden. Tests mit 120 sind erfolgreich durchgelaufen. Dieser Wert ist vielleicht etwas übertrieben, man denke an das Funkfeuer und den Akku der Geräte. Ein Intervall von 600 ist vielleicht sinnvoller. Beispiele:
:<code>set Velux_1 limitationUpdateInterval off</code>
:<code>set Velux_2 limitationUpdateInterval onChange</code>
:<code>set Velux_3 limitationUpdateInterval 600</code>

==== Extra Reading für den Regensensor ====
Wem die Auswertung vom Reading limitationMax zu indirekt ist, der kann sich ein neues Reading anlegen.
Der folgende Code legt ein Reading namens sensor an, die Werte sind im Beispiel "Regen" oder "trocken".
Es besteht die Annahme, dass bei limitationMax = 7 der Regensensor angeschlagen hat.
:<code>attr Velux_3 userReadings sensor {(ReadingsVal($name,"limitationMax",100) == 7)?"Regen":"trocken"}</code>
Hinweis: Das neue Reading sensor erscheint erst, wenn das Reading limitationMax einmal aktualisiert wurde.

== Vorschläge zur schöneren Darstellung ==
Wie Homematic-Geräte kommt KLF200Node im FHEM-Web sehr schlicht daher. Dieses Kapitel gibt Vorschläge zur Konfiguration einer schöneren Darstellung.

=== Rollladen ===
Dieses Beispiel stellt den Status des Rollladen 10-Prozent genau im Icon dar. Bewegen sich der Rollladen, hat das Icon einen Pfeil nach oben oder unten. Ein Klick auf das Icon setzt den Rollladen in Bewegung oder hält ihn an (toggle).

:<code>attr Velux_2 stateFormat pct execution</code>
:<code>attr Velux_2 devStateIcon .*up:fts_shutter_up:toggle .*down:fts_shutter_down:toggle \d.stop:fts_shutter_100:toggle 1\d.stop:fts_shutter_90:toggle 2\d.stop:fts_shutter_80:toggle 3\d.stop:fts_shutter_70:toggle 4\d.stop:fts_shutter_60:toggle 5\d.stop:fts_shutter_50:toggle 6\d.stop:fts_shutter_40:toggle 7\d.stop:fts_shutter_30:toggle 8\d.stop:fts_shutter_20:toggle 9\d.stop:fts_shutter_10:toggle 100.stop:fts_window_2w:toggle</code>
[[Datei:RollerShutterUpDown.png|300px|Rollladen mit Pfeilen]]

So erhält man einen Slider für die Rollladenposition:

:<code>attr Velux_2 webCmd pct</code>

=== Dachschrägenfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachschrägenfenster in drei Stufen dar:

0% - 9%: geschlossen

10% - 59%: halb geöffnet

60% - 100%: ganz geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_4 limitationUpdateInterval 600</code>
:<code>attr Velux_4 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_4 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7\).*:weather_rain:toggle \d.$.*:fts_window_roof:toggle [1-5]\d.\(.*:fts_window_roof_open_1:toggle [6-9]\d.\(.*:fts_window_roof_open_2:toggle 100.\(.*:fts_window_roof_open_2:toggle</code>

=== Dachkuppelfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachkuppelfenster in zwei Stufen dar:

0% - 9%: geschlossen

10% - 100%: geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_5 limitationUpdateInterval 600</code>
:<code>attr Velux_5 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_5 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7$.*:weather_rain:toggle \d.\(.*:fts_light_dome:toggle [1-9]\d.\(.*:fts_light_dome_open:toggle 100.\(.*:fts_light_dome_open:toggle</code>

== Problembehebung ==
Sollte es zu Verbindungsabbrüchen zwischen FHEM und der KLF200-Box kommen, dann sind folgende Dinge zu überprüfen:
=== FHEM Update ===
Ist FHEM aktuell? Am 18.12.2018 gab es ein wichtiges FHEM-Update, das die Stabilität von SSL-Verbindungen wesentlich verbessert hat.
=== OpenSSL ===
OpenSLL sollte immer aktuell sein.
=== Perl SSL-Bibliotheken ===
Wenn die Perl SSL-Bibliotheken zu alt sind, ist das oben genannte FHEM-Update wirkungslos.
* IO::Socket::SSL
* Net::SSL
* Net::SSLeay
* Net::SSLeay::Handle
* Crypt::SSLeay
* Net::Server::Proto::SSL
== Links ==
* Support im Forum gibt es unter {{Link2Forum|Topic=92907|LinkText=Velux KLF200 mit Firmware 2.0.0.71 für io-homecontrol}}
* Github: [https://github.com/buennerbernd/fhem/tree/master/KLF200/2.0 FHEM modules KLF200 and KLF200Node]

[[Kategorie:Rollladensteuerung]]
[[Kategorie:Other Components]]

Velux KLF200

2019-05-11T15:26:52Z

Buennerbernd: /* Unterstützte Geräte */

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Anbindung io-homecontrol Aktoren an FHEM
|ModType=x
|ModCmdRef=KLF200
|ModFTopic=92907
|ModTechName=83_KLF200.pm
|ModOwner=buennerbernd ({{Link2FU|21440|Forum}} / [[Benutzer Diskussion:Buennerbernd|Wiki]])
}}

[[KLF200]] ist ein Modul zur Steuerung von io-homecontrol Aktoren über das Gateway Velux KLF 200.

== Velux KLF 200 ==

Die KLF-200-Box ist über LAN mit FHEM verbunden und steuert die Aktoren über das verschlüsselte Funkprotokoll io-homecontrol.
Die Aktoren geben Rückmeldung über ihren aktuellen Zustand.

Die Box hat 10 elektrische Eingänge mit denen man 5 Geräte oder Gerätegruppen steuern kann.
Damit kann man z.B. mit Doppeltastern an der Wand seine Rollladen oder Fenster steuern.
Über den LAN-Anschluss lassen sich mit FHEM bis zu 200 Geräte mit einer KLF 200 verwalten.

Das Modul erfordert die Firmware-Version 2.0.0.71 und basiert auf der dokumentierten API von Velux. [https://www.velux.com/api/klf200 Download und weitere Informationen]

Das Gateway hat keine Cloud-Integration.

== Unterstützte Geräte ==

Grundsätzlich sollten alle io-homecontrol Aktoren funktionieren. Alleinstehende Sensoren (z.B. Lichtsensor, Windsensor) werden
von der KLF-200-Box nicht unterstützt. Es besteht aber die Möglichkeit, den Status von Sensoren auszuwerten, die in Aktoren integriert sind.

Aktuell werden folgende Geräte erfolgreich mit diesem Modul verwendet:

* Rollladen:
** VELUX SML
** VELUX SSL
** Somfy Oximo io
* Sichtschutz innen:
** VELUX FSK
* Fensteröffner mit integriertem Regensensor:
** VELUX KMG
** VELUX CVP
** VELUX KSX
* Markisen:
** VELUX MSL
** Somfy Sunea io

== Benutzung in FHEM ==
=== Vorbereitung ===
Bevor die Aktoren in FHEM verwendet werden können, müssen sie in der KLF 200 angelernt werden.
Das geschieht über das WebUI der KLF 200, das über einen Wifi-Hotspot erreichbar ist. Dieser Vorgang ist im Handbuch beschrieben.
Im WebUI können die angeschlossenen Geräte auch benannt werden. Zusätzlich hat man die Möglichkeit, Programme (Szenen) aufzuzeichnen,
um ein oder mehrere Geräte in eine definierte Position zu bringen. Diese Szenen kann man aus FHEM ebenfalls ansteuern.

Das Modul wird momentan noch nicht über FHEM ausgeliefert.
Es wird wie folgt geladen und aktualisiert:

:<code>update all <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>
:<code>shutdown restart</code>

Mit diesem Befehl wird das Modul so eingerichtet, dass es ebenfalls aktualisiert wird, wenn man FHEM aktualisiert:
:<code>update add <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>

=== Anlegen der Geräte ===
:<code>define <name> KLF200 <host></code>
Beispiel:
:<code>define Velux KLF200 192.168.0.66</code>

Danach Login durch Eingabe des Passwortes:
:<code>set <name> login <password></code>

Hinweis: Das Passwort ist laut Dokumentation das Wifi-Passwort, das auf den Boden der Box gedruckt ist.
Das funktioniert bei einigen Nutzern. Bei vielen Nutzern funktioniert hingegen das Passwort des WebUI.
Scheinbar hängt das davon ab, mit welcher Firmware die Box ausgeliefert wurde und ob schon einmal ein Reset durchgeführt wurde.
Das Passwort wird verschleiert im FHEM-Backend gespeichert. Es muss nach erfolgreichem Login nicht mehr eingegeben werden.

Die angeschlossenen Aktoren werden jetzt durch autocreate als Instanzen von KLF200Node im Raum KLF200Node angelegt.
Die Namen der Geräte folgen dem Muster <name>_<NodeID>.
Wurde im WebUI der KLF200 ein Name für das Gerät vergeben dann wird dieser als Alias übernommen.

Die Geräte sind jetzt einsatzbereit.

== Modul KLF200 ==
=== Verbindungsstatus ===
==== STATE ====
Im STATE des Moduls sieht man den aktuellen Verbindungsstatus. Im Idealfall ist er nach der Initialisierung Logged in.
=== Ausführung von Programmen (Szenen) ===
Obwohl man mit dem Modul KLF200Node jedes Gerät unabhängig und auch gleichzeitig steuern kann, sind Szenen eine nützliche Ergänzung. So kann man mit Szenen wie "Alle zu" oder "Alle auf" viele Geräte gleichzeitig mit einem Befehl bedienen.

Hinweis: Während der Abarbeitung einer Szene werden weitere Befehle gepuffert.
==== scene/sceneID ====
Mit diesen Set-Funktionen kann man eine aufgezeichnete Szene aufrufen.
Im entsprechenden Reading steht die zuletzt aufgerufene Szene.

Die Zuordnung zwischen sceneID und scene sieht man in den Internals unter scenes.

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Bei vielen aktuellen Geräten lässt sich die Ausführungsgeschwindigkeit (Velocity) variieren. So lässt sich die Geschwindigkeit gegenüber der Default-Geschwindigkeit noch erhöhen oder auch deutlich reduzieren. So ist eine besonders leise Bedienung möglich.

==== Argument DEFAULT, FAST, SILENT ====
Die Velocity kann man bei der Ausführung von Szenen als zusätzliches Argument von set scene oder set sceneID setzen.
Unterstützte Werte sind DEFAULT, FAST und SILENT
:<code>set Velux scene "Alle zu" SILENT</code>
==== Attribut velocity ====
Alternativ kann man im Modul KLF200 das Attribut velocity setzen, das bei der Ausführung von Szenen herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

Hinweis: Dieses Attribut hat keine Auswirkungen auf Befehle, die vom Modul KLF200Node abgesetzt werden.

== Modul KLF200Node ==
Dieses Modul wurde dem Homematic-Modul CUL_HM nachempfunden, da es ebenfalls ein breites Spektrum an Geräten unterstützt
und möglichst kompatibel zu vorhandenen Hilfsmodulen sein soll.
=== Aktueller Status ===
Im Folgenden wird der Zusammenhang zwischen den wichtigsten Readings/Set-Funktionen pct, state, execution erklärt.
==== pct ====
Dieses Reading enthält den aktuell bekannten Status des Gerätes in Prozent.

Wird das Gerät über die KLF-200-Box gesteuert, wird das Reading beim Erreichen der Zielposition sofort aktualisiert.

Wird das Gerät über eine Fernbedienung oder einen Sensor gesteuert, kann sich die Aktualisierung wenige Minuten verzögern.

Mit der Set-Funktion kann man das Gerät in diesen Status versetzen.
Per Default entspricht 100 auf der Fernbedienung oben und 0 unten.
==== state ====
Dieses Reading entspricht dem Reading pct, mit der Ausnahme, dass 0 durch '''off''' ersetzt wird und 100 durch '''on'''.

Die Set-Funktion funktioniert analog.
Per Default entspricht on auf der Fernbedienung oben und off unten.

Es werden die '''set extensions''' unterstützt. Damit können mit einem Set ein oder mehrere Befehle zeitgesteuert abgesetzt werden.

Doku: [https://fhem.de/commandref_DE.html#set set extensions in der commandref] und im [[DevelopmentModuleIntro#X_Set]] jeweils etwas weiter unten.

==== execution ====
Dieses Reading gibt den aktuellen Ausführungsstatus wieder. Die meiste Zeit ist der Wert stop.
Wird gerade ein Befehl ausgeführt, ist der Wert up oder down.

Mit der Set-Funktion werden entsprechende Befehle ausgeführt, up entspricht auf der Fernbedienung oben und down unten.
Bei stop wird die aktuelle Ausführung angehalten.

==== Attribut directionOn ====
Wie oben beschrieben, entspricht per Default on = 100 = up.

Das kann bei bestimmten Geräten für manchen Nutzer verwirrend sein.
Wenn man z.B. bei einem Rollladen lieber im geschlossenen Zustand 100 Prozent sehen möchte, dann setzt man das Attribut directionOn, z.B.
:<code>attr Velux_2 directionOn down</code>

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Wie bei Szenen lässt sich auch bei Kommandos auf KLF200Node die Ausführungsgeschwindigkeit beeinflussen, soweit das vom Gerät unterstützt ist.
==== Reading velocity ====
Dieses Reading hat den Wert supported, wenn die Geschwindigkeit bei diesem Gerät geändert werden kann.
Selbst bei Not supported wäre es einen Versuch wert, es zu testen.
==== Argument DEFAULT, FAST, SILENT ====
Alle set-Funktionen, die eine Bewegung auslösen unterstützen das optionale Argument DEFAULT, FAST oder SILENT.
==== Attribut velocity ====
Alternativ kann man im Modul KLF200Node das Attribut velocity setzen, das bei der Ausführung von Kommandos herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

=== Begrenzung des Bewegungsradius / Limitation ===
Die io-homecontrol Geräte haben ein Feature eingebaut, um den Bewegungsradius der Geräte einzuschränken, egal von wo aus sie gesteuert werden. Dieses Limitation-Feature ist in dieses FHEM-Modul ebenfalls integriert.
==== limitationMin und limitationMax ====
Mit den Settern und Readings limitationMin und limitationMax kann man die Limitation setzen und auslesen.
Natürlich kann man auch selbst von der Limitation Gebrauch machen. Man kann z.B. einen Rollladen begrenzen, wenn man weiß, dass das Dachfenster weit offen ist. Dann kann der Rollladen nicht gegen das Fenster stoßen, selbst wenn man ihn mit der Fernbedienung bewegt.
==== limiationClear ====
Mit dem Setter limiationClear kann man alle Limitations (auch von fremden Geräten ausgelöste) löschen.
==== updateLimiation ====
Der Setter updateLimiation aktualisiert die Readings limitationMin und limitationMax auf diesem Gerät, falls die Limitation außerhalb von FHEM gesetzt wurde.

=== Auswerten der Regensensoren ===
Die Regensensoren von Velux Fensteröffnern machen von diesem Limitation-Feature Gebrauch. Wenn es regnet, wird der Bewegungsradius der Fenster eingeschränkt. Zum Beispiel (evtl. Geräte-abhängig):
* limitationMax = 7 bei Regen,
* limitationMax = 100 wenn es aufhört.
Diese Werte kann man auslesen, ohne dass sich das Fenster dazu bewegt haben muss.

==== limitationUpdateInterval ====
Mit set limitationUpdateInterval kann man festlegen, wie oft diese Werte ausgelesen werden:
* off: Dieser Wert ist für Geräte ohne integrierte Sensoren der Beste, denn zusätzliche Updates sind überflüssig.
* onChange: Hier wird limitationMin und limitationMax aktualisiert, wenn das Gerät bewegt wurde.
* interval in s: Ein Poll-Intervall in Sekunden. Tests mit 120 sind erfolgreich durchgelaufen. Dieser Wert ist vielleicht etwas übertrieben, man denke an das Funkfeuer und den Akku der Geräte. Ein Intervall von 600 ist vielleicht sinnvoller. Beispiele:
:<code>set Velux_1 limitationUpdateInterval off</code>
:<code>set Velux_2 limitationUpdateInterval onChange</code>
:<code>set Velux_3 limitationUpdateInterval 600</code>

==== Extra Reading für den Regensensor ====
Wem die Auswertung vom Reading limitationMax zu indirekt ist, der kann sich ein neues Reading anlegen.
Der folgende Code legt ein Reading namens sensor an, die Werte sind im Beispiel "Regen" oder "trocken".
Es besteht die Annahme, dass bei limitationMax = 7 der Regensensor angeschlagen hat.
:<code>attr Velux_3 userReadings sensor {(ReadingsVal($name,"limitationMax",100) == 7)?"Regen":"trocken"}</code>
Hinweis: Das neue Reading sensor erscheint erst, wenn das Reading limitationMax einmal aktualisiert wurde.

== Vorschläge zur schöneren Darstellung ==
Wie Homematic-Geräte kommt KLF200Node im FHEM-Web sehr schlicht daher. Dieses Kapitel gibt Vorschläge zur Konfiguration einer schöneren Darstellung.

=== Rollladen ===
Dieses Beispiel stellt den Status des Rollladen 10-Prozent genau im Icon dar. Bewegen sich der Rollladen, hat das Icon einen Pfeil nach oben oder unten. Ein Klick auf das Icon setzt den Rollladen in Bewegung oder hält ihn an (toggle).

:<code>attr Velux_2 stateFormat pct execution</code>
:<code>attr Velux_2 devStateIcon .*up:fts_shutter_up:toggle .*down:fts_shutter_down:toggle \d.stop:fts_shutter_100:toggle 1\d.stop:fts_shutter_90:toggle 2\d.stop:fts_shutter_80:toggle 3\d.stop:fts_shutter_70:toggle 4\d.stop:fts_shutter_60:toggle 5\d.stop:fts_shutter_50:toggle 6\d.stop:fts_shutter_40:toggle 7\d.stop:fts_shutter_30:toggle 8\d.stop:fts_shutter_20:toggle 9\d.stop:fts_shutter_10:toggle 100.stop:fts_window_2w:toggle</code>
[[Datei:RollerShutterUpDown.png|300px|Rollladen mit Pfeilen]]

So erhält man einen Slider für die Rollladenposition:

:<code>attr Velux_2 webCmd pct</code>

=== Dachschrägenfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachschrägenfenster in drei Stufen dar:

0% - 9%: geschlossen

10% - 59%: halb geöffnet

60% - 100%: ganz geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_4 limitationUpdateInterval 600</code>
:<code>attr Velux_4 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_4 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7\).*:weather_rain:toggle \d.$.*:fts_window_roof:toggle [1-5]\d.\(.*:fts_window_roof_open_1:toggle [6-9]\d.\(.*:fts_window_roof_open_2:toggle 100.\(.*:fts_window_roof_open_2:toggle</code>

=== Dachkuppelfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachkuppelfenster in zwei Stufen dar:

0% - 9%: geschlossen

10% - 100%: geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_5 limitationUpdateInterval 600</code>
:<code>attr Velux_5 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_5 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7$.*:weather_rain:toggle \d.\(.*:fts_light_dome:toggle [1-9]\d.\(.*:fts_light_dome_open:toggle 100.\(.*:fts_light_dome_open:toggle</code>

== Problembehebung ==
Sollte es zu Verbindungsabbrüchen zwischen FHEM und der KLF200-Box kommen, dann sind folgende Dinge zu überprüfen:
=== FHEM Update ===
Ist FHEM aktuell? Am 18.12.2018 gab es ein wichtiges FHEM-Update, das die Stabilität von SSL-Verbindungen wesentlich verbessert hat.
=== OpenSSL ===
OpenSLL sollte immer aktuell sein.
=== Perl SSL-Bibliotheken ===
Wenn die Perl SSL-Bibliotheken zu alt sind, ist das oben genannte FHEM-Update wirkungslos.
* IO::Socket::SSL
* Net::SSL
* Net::SSLeay
* Net::SSLeay::Handle
* Crypt::SSLeay
* Net::Server::Proto::SSL
== Links ==
* Support im Forum gibt es unter {{Link2Forum|Topic=92907|LinkText=Velux KLF200 mit Firmware 2.0.0.71 für io-homecontrol}}
* Github: [https://github.com/buennerbernd/fhem/tree/master/KLF200/2.0 FHEM modules KLF200 and KLF200Node]

[[Kategorie:Rollladensteuerung]]
[[Kategorie:Other Components]]

Velux KLF200

2019-05-11T15:24:26Z

Buennerbernd: /* Unterstützte Geräte */

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Anbindung io-homecontrol Aktoren an FHEM
|ModType=x
|ModCmdRef=KLF200
|ModFTopic=92907
|ModTechName=83_KLF200.pm
|ModOwner=buennerbernd ({{Link2FU|21440|Forum}} / [[Benutzer Diskussion:Buennerbernd|Wiki]])
}}

[[KLF200]] ist ein Modul zur Steuerung von io-homecontrol Aktoren über das Gateway Velux KLF 200.

== Velux KLF 200 ==

Die KLF-200-Box ist über LAN mit FHEM verbunden und steuert die Aktoren über das verschlüsselte Funkprotokoll io-homecontrol.
Die Aktoren geben Rückmeldung über ihren aktuellen Zustand.

Die Box hat 10 elektrische Eingänge mit denen man 5 Geräte oder Gerätegruppen steuern kann.
Damit kann man z.B. mit Doppeltastern an der Wand seine Rollladen oder Fenster steuern.
Über den LAN-Anschluss lassen sich mit FHEM bis zu 200 Geräte mit einer KLF 200 verwalten.

Das Modul erfordert die Firmware-Version 2.0.0.71 und basiert auf der dokumentierten API von Velux. [https://www.velux.com/api/klf200 Download und weitere Informationen]

Das Gateway hat keine Cloud-Integration.

== Unterstützte Geräte ==

Grundsätzlich sollten alle io-homecontrol Aktoren funktionieren. Alleinstehende Sensoren (z.B. Lichtsensor, Windsensor) werden
von der KLF-200-Box nicht unterstützt. Es besteht aber die Möglichkeit, den Status von Sensoren auszuwerten, die in Aktoren integriert sind.

Aktuell werden folgende Geräte erfolgreich mit diesem Modul verwendet:

* Rollladen:
** VELUX SML
** VELUX SSL
** Somfy Oximo io
* Sichtschutz innen:
** VELUX FSK
* Fensteröffner mit integriertem Regensensor:
** VELUX KMG
** VELUX CVP
** VELUX KSX
* Markisen:
** Velux MSL
** Somfy Sunea io

== Benutzung in FHEM ==
=== Vorbereitung ===
Bevor die Aktoren in FHEM verwendet werden können, müssen sie in der KLF 200 angelernt werden.
Das geschieht über das WebUI der KLF 200, das über einen Wifi-Hotspot erreichbar ist. Dieser Vorgang ist im Handbuch beschrieben.
Im WebUI können die angeschlossenen Geräte auch benannt werden. Zusätzlich hat man die Möglichkeit, Programme (Szenen) aufzuzeichnen,
um ein oder mehrere Geräte in eine definierte Position zu bringen. Diese Szenen kann man aus FHEM ebenfalls ansteuern.

Das Modul wird momentan noch nicht über FHEM ausgeliefert.
Es wird wie folgt geladen und aktualisiert:

:<code>update all <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>
:<code>shutdown restart</code>

Mit diesem Befehl wird das Modul so eingerichtet, dass es ebenfalls aktualisiert wird, wenn man FHEM aktualisiert:
:<code>update add <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>

=== Anlegen der Geräte ===
:<code>define <name> KLF200 <host></code>
Beispiel:
:<code>define Velux KLF200 192.168.0.66</code>

Danach Login durch Eingabe des Passwortes:
:<code>set <name> login <password></code>

Hinweis: Das Passwort ist laut Dokumentation das Wifi-Passwort, das auf den Boden der Box gedruckt ist.
Das funktioniert bei einigen Nutzern. Bei vielen Nutzern funktioniert hingegen das Passwort des WebUI.
Scheinbar hängt das davon ab, mit welcher Firmware die Box ausgeliefert wurde und ob schon einmal ein Reset durchgeführt wurde.
Das Passwort wird verschleiert im FHEM-Backend gespeichert. Es muss nach erfolgreichem Login nicht mehr eingegeben werden.

Die angeschlossenen Aktoren werden jetzt durch autocreate als Instanzen von KLF200Node im Raum KLF200Node angelegt.
Die Namen der Geräte folgen dem Muster <name>_<NodeID>.
Wurde im WebUI der KLF200 ein Name für das Gerät vergeben dann wird dieser als Alias übernommen.

Die Geräte sind jetzt einsatzbereit.

== Modul KLF200 ==
=== Verbindungsstatus ===
==== STATE ====
Im STATE des Moduls sieht man den aktuellen Verbindungsstatus. Im Idealfall ist er nach der Initialisierung Logged in.
=== Ausführung von Programmen (Szenen) ===
Obwohl man mit dem Modul KLF200Node jedes Gerät unabhängig und auch gleichzeitig steuern kann, sind Szenen eine nützliche Ergänzung. So kann man mit Szenen wie "Alle zu" oder "Alle auf" viele Geräte gleichzeitig mit einem Befehl bedienen.

Hinweis: Während der Abarbeitung einer Szene werden weitere Befehle gepuffert.
==== scene/sceneID ====
Mit diesen Set-Funktionen kann man eine aufgezeichnete Szene aufrufen.
Im entsprechenden Reading steht die zuletzt aufgerufene Szene.

Die Zuordnung zwischen sceneID und scene sieht man in den Internals unter scenes.

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Bei vielen aktuellen Geräten lässt sich die Ausführungsgeschwindigkeit (Velocity) variieren. So lässt sich die Geschwindigkeit gegenüber der Default-Geschwindigkeit noch erhöhen oder auch deutlich reduzieren. So ist eine besonders leise Bedienung möglich.

==== Argument DEFAULT, FAST, SILENT ====
Die Velocity kann man bei der Ausführung von Szenen als zusätzliches Argument von set scene oder set sceneID setzen.
Unterstützte Werte sind DEFAULT, FAST und SILENT
:<code>set Velux scene "Alle zu" SILENT</code>
==== Attribut velocity ====
Alternativ kann man im Modul KLF200 das Attribut velocity setzen, das bei der Ausführung von Szenen herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

Hinweis: Dieses Attribut hat keine Auswirkungen auf Befehle, die vom Modul KLF200Node abgesetzt werden.

== Modul KLF200Node ==
Dieses Modul wurde dem Homematic-Modul CUL_HM nachempfunden, da es ebenfalls ein breites Spektrum an Geräten unterstützt
und möglichst kompatibel zu vorhandenen Hilfsmodulen sein soll.
=== Aktueller Status ===
Im Folgenden wird der Zusammenhang zwischen den wichtigsten Readings/Set-Funktionen pct, state, execution erklärt.
==== pct ====
Dieses Reading enthält den aktuell bekannten Status des Gerätes in Prozent.

Wird das Gerät über die KLF-200-Box gesteuert, wird das Reading beim Erreichen der Zielposition sofort aktualisiert.

Wird das Gerät über eine Fernbedienung oder einen Sensor gesteuert, kann sich die Aktualisierung wenige Minuten verzögern.

Mit der Set-Funktion kann man das Gerät in diesen Status versetzen.
Per Default entspricht 100 auf der Fernbedienung oben und 0 unten.
==== state ====
Dieses Reading entspricht dem Reading pct, mit der Ausnahme, dass 0 durch '''off''' ersetzt wird und 100 durch '''on'''.

Die Set-Funktion funktioniert analog.
Per Default entspricht on auf der Fernbedienung oben und off unten.

Es werden die '''set extensions''' unterstützt. Damit können mit einem Set ein oder mehrere Befehle zeitgesteuert abgesetzt werden.

Doku: [https://fhem.de/commandref_DE.html#set set extensions in der commandref] und im [[DevelopmentModuleIntro#X_Set]] jeweils etwas weiter unten.

==== execution ====
Dieses Reading gibt den aktuellen Ausführungsstatus wieder. Die meiste Zeit ist der Wert stop.
Wird gerade ein Befehl ausgeführt, ist der Wert up oder down.

Mit der Set-Funktion werden entsprechende Befehle ausgeführt, up entspricht auf der Fernbedienung oben und down unten.
Bei stop wird die aktuelle Ausführung angehalten.

==== Attribut directionOn ====
Wie oben beschrieben, entspricht per Default on = 100 = up.

Das kann bei bestimmten Geräten für manchen Nutzer verwirrend sein.
Wenn man z.B. bei einem Rollladen lieber im geschlossenen Zustand 100 Prozent sehen möchte, dann setzt man das Attribut directionOn, z.B.
:<code>attr Velux_2 directionOn down</code>

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Wie bei Szenen lässt sich auch bei Kommandos auf KLF200Node die Ausführungsgeschwindigkeit beeinflussen, soweit das vom Gerät unterstützt ist.
==== Reading velocity ====
Dieses Reading hat den Wert supported, wenn die Geschwindigkeit bei diesem Gerät geändert werden kann.
Selbst bei Not supported wäre es einen Versuch wert, es zu testen.
==== Argument DEFAULT, FAST, SILENT ====
Alle set-Funktionen, die eine Bewegung auslösen unterstützen das optionale Argument DEFAULT, FAST oder SILENT.
==== Attribut velocity ====
Alternativ kann man im Modul KLF200Node das Attribut velocity setzen, das bei der Ausführung von Kommandos herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

=== Begrenzung des Bewegungsradius / Limitation ===
Die io-homecontrol Geräte haben ein Feature eingebaut, um den Bewegungsradius der Geräte einzuschränken, egal von wo aus sie gesteuert werden. Dieses Limitation-Feature ist in dieses FHEM-Modul ebenfalls integriert.
==== limitationMin und limitationMax ====
Mit den Settern und Readings limitationMin und limitationMax kann man die Limitation setzen und auslesen.
Natürlich kann man auch selbst von der Limitation Gebrauch machen. Man kann z.B. einen Rollladen begrenzen, wenn man weiß, dass das Dachfenster weit offen ist. Dann kann der Rollladen nicht gegen das Fenster stoßen, selbst wenn man ihn mit der Fernbedienung bewegt.
==== limiationClear ====
Mit dem Setter limiationClear kann man alle Limitations (auch von fremden Geräten ausgelöste) löschen.
==== updateLimiation ====
Der Setter updateLimiation aktualisiert die Readings limitationMin und limitationMax auf diesem Gerät, falls die Limitation außerhalb von FHEM gesetzt wurde.

=== Auswerten der Regensensoren ===
Die Regensensoren von Velux Fensteröffnern machen von diesem Limitation-Feature Gebrauch. Wenn es regnet, wird der Bewegungsradius der Fenster eingeschränkt. Zum Beispiel (evtl. Geräte-abhängig):
* limitationMax = 7 bei Regen,
* limitationMax = 100 wenn es aufhört.
Diese Werte kann man auslesen, ohne dass sich das Fenster dazu bewegt haben muss.

==== limitationUpdateInterval ====
Mit set limitationUpdateInterval kann man festlegen, wie oft diese Werte ausgelesen werden:
* off: Dieser Wert ist für Geräte ohne integrierte Sensoren der Beste, denn zusätzliche Updates sind überflüssig.
* onChange: Hier wird limitationMin und limitationMax aktualisiert, wenn das Gerät bewegt wurde.
* interval in s: Ein Poll-Intervall in Sekunden. Tests mit 120 sind erfolgreich durchgelaufen. Dieser Wert ist vielleicht etwas übertrieben, man denke an das Funkfeuer und den Akku der Geräte. Ein Intervall von 600 ist vielleicht sinnvoller. Beispiele:
:<code>set Velux_1 limitationUpdateInterval off</code>
:<code>set Velux_2 limitationUpdateInterval onChange</code>
:<code>set Velux_3 limitationUpdateInterval 600</code>

==== Extra Reading für den Regensensor ====
Wem die Auswertung vom Reading limitationMax zu indirekt ist, der kann sich ein neues Reading anlegen.
Der folgende Code legt ein Reading namens sensor an, die Werte sind im Beispiel "Regen" oder "trocken".
Es besteht die Annahme, dass bei limitationMax = 7 der Regensensor angeschlagen hat.
:<code>attr Velux_3 userReadings sensor {(ReadingsVal($name,"limitationMax",100) == 7)?"Regen":"trocken"}</code>
Hinweis: Das neue Reading sensor erscheint erst, wenn das Reading limitationMax einmal aktualisiert wurde.

== Vorschläge zur schöneren Darstellung ==
Wie Homematic-Geräte kommt KLF200Node im FHEM-Web sehr schlicht daher. Dieses Kapitel gibt Vorschläge zur Konfiguration einer schöneren Darstellung.

=== Rollladen ===
Dieses Beispiel stellt den Status des Rollladen 10-Prozent genau im Icon dar. Bewegen sich der Rollladen, hat das Icon einen Pfeil nach oben oder unten. Ein Klick auf das Icon setzt den Rollladen in Bewegung oder hält ihn an (toggle).

:<code>attr Velux_2 stateFormat pct execution</code>
:<code>attr Velux_2 devStateIcon .*up:fts_shutter_up:toggle .*down:fts_shutter_down:toggle \d.stop:fts_shutter_100:toggle 1\d.stop:fts_shutter_90:toggle 2\d.stop:fts_shutter_80:toggle 3\d.stop:fts_shutter_70:toggle 4\d.stop:fts_shutter_60:toggle 5\d.stop:fts_shutter_50:toggle 6\d.stop:fts_shutter_40:toggle 7\d.stop:fts_shutter_30:toggle 8\d.stop:fts_shutter_20:toggle 9\d.stop:fts_shutter_10:toggle 100.stop:fts_window_2w:toggle</code>
[[Datei:RollerShutterUpDown.png|300px|Rollladen mit Pfeilen]]

So erhält man einen Slider für die Rollladenposition:

:<code>attr Velux_2 webCmd pct</code>

=== Dachschrägenfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachschrägenfenster in drei Stufen dar:

0% - 9%: geschlossen

10% - 59%: halb geöffnet

60% - 100%: ganz geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_4 limitationUpdateInterval 600</code>
:<code>attr Velux_4 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_4 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7\).*:weather_rain:toggle \d.$.*:fts_window_roof:toggle [1-5]\d.\(.*:fts_window_roof_open_1:toggle [6-9]\d.\(.*:fts_window_roof_open_2:toggle 100.\(.*:fts_window_roof_open_2:toggle</code>

=== Dachkuppelfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachkuppelfenster in zwei Stufen dar:

0% - 9%: geschlossen

10% - 100%: geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_5 limitationUpdateInterval 600</code>
:<code>attr Velux_5 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_5 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7$.*:weather_rain:toggle \d.\(.*:fts_light_dome:toggle [1-9]\d.\(.*:fts_light_dome_open:toggle 100.\(.*:fts_light_dome_open:toggle</code>

== Problembehebung ==
Sollte es zu Verbindungsabbrüchen zwischen FHEM und der KLF200-Box kommen, dann sind folgende Dinge zu überprüfen:
=== FHEM Update ===
Ist FHEM aktuell? Am 18.12.2018 gab es ein wichtiges FHEM-Update, das die Stabilität von SSL-Verbindungen wesentlich verbessert hat.
=== OpenSSL ===
OpenSLL sollte immer aktuell sein.
=== Perl SSL-Bibliotheken ===
Wenn die Perl SSL-Bibliotheken zu alt sind, ist das oben genannte FHEM-Update wirkungslos.
* IO::Socket::SSL
* Net::SSL
* Net::SSLeay
* Net::SSLeay::Handle
* Crypt::SSLeay
* Net::Server::Proto::SSL
== Links ==
* Support im Forum gibt es unter {{Link2Forum|Topic=92907|LinkText=Velux KLF200 mit Firmware 2.0.0.71 für io-homecontrol}}
* Github: [https://github.com/buennerbernd/fhem/tree/master/KLF200/2.0 FHEM modules KLF200 and KLF200Node]

[[Kategorie:Rollladensteuerung]]
[[Kategorie:Other Components]]

Velux KLF200

2019-05-07T14:41:59Z

Buennerbernd: /* Extra Reading für den Regensensor */

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Anbindung io-homecontrol Aktoren an FHEM
|ModType=x
|ModCmdRef=KLF200
|ModFTopic=92907
|ModTechName=83_KLF200.pm
|ModOwner=buennerbernd ({{Link2FU|21440|Forum}} / [[Benutzer Diskussion:Buennerbernd|Wiki]])
}}

[[KLF200]] ist ein Modul zur Steuerung von io-homecontrol Aktoren über das Gateway Velux KLF 200.

== Velux KLF 200 ==

Die KLF-200-Box ist über LAN mit FHEM verbunden und steuert die Aktoren über das verschlüsselte Funkprotokoll io-homecontrol.
Die Aktoren geben Rückmeldung über ihren aktuellen Zustand.

Die Box hat 10 elektrische Eingänge mit denen man 5 Geräte oder Gerätegruppen steuern kann.
Damit kann man z.B. mit Doppeltastern an der Wand seine Rollladen oder Fenster steuern.
Über den LAN-Anschluss lassen sich mit FHEM bis zu 200 Geräte mit einer KLF 200 verwalten.

Das Modul erfordert die Firmware-Version 2.0.0.71 und basiert auf der dokumentierten API von Velux. [https://www.velux.com/api/klf200 Download und weitere Informationen]

Das Gateway hat keine Cloud-Integration.

== Unterstützte Geräte ==

Grundsätzlich sollten alle io-homecontrol Aktoren funktionieren. Alleinstehende Sensoren (z.B. Lichtsensor, Windsensor) werden
von der KLF-200-Box nicht unterstützt. Es besteht aber die Möglichkeit, den Status von Sensoren auszuwerten, die in Aktoren integriert sind.

Aktuell werden folgende Geräte erfolgreich mit diesem Modul verwendet:

* Rollladen:
** VELUX SML
** VELUX SSL
** Somfy Oximo io
* Sichtschutz innen:
** VELUX FSK
* Fensteröffner mit integriertem Regensensor:
** VELUX KMG
** VELUX CVP
** VELUX KSX
* Markisen:
** Somfy Sunea io

== Benutzung in FHEM ==
=== Vorbereitung ===
Bevor die Aktoren in FHEM verwendet werden können, müssen sie in der KLF 200 angelernt werden.
Das geschieht über das WebUI der KLF 200, das über einen Wifi-Hotspot erreichbar ist. Dieser Vorgang ist im Handbuch beschrieben.
Im WebUI können die angeschlossenen Geräte auch benannt werden. Zusätzlich hat man die Möglichkeit, Programme (Szenen) aufzuzeichnen,
um ein oder mehrere Geräte in eine definierte Position zu bringen. Diese Szenen kann man aus FHEM ebenfalls ansteuern.

Das Modul wird momentan noch nicht über FHEM ausgeliefert.
Es wird wie folgt geladen und aktualisiert:

:<code>update all <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>
:<code>shutdown restart</code>

Mit diesem Befehl wird das Modul so eingerichtet, dass es ebenfalls aktualisiert wird, wenn man FHEM aktualisiert:
:<code>update add <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>

=== Anlegen der Geräte ===
:<code>define <name> KLF200 <host></code>
Beispiel:
:<code>define Velux KLF200 192.168.0.66</code>

Danach Login durch Eingabe des Passwortes:
:<code>set <name> login <password></code>

Hinweis: Das Passwort ist laut Dokumentation das Wifi-Passwort, das auf den Boden der Box gedruckt ist.
Das funktioniert bei einigen Nutzern. Bei vielen Nutzern funktioniert hingegen das Passwort des WebUI.
Scheinbar hängt das davon ab, mit welcher Firmware die Box ausgeliefert wurde und ob schon einmal ein Reset durchgeführt wurde.
Das Passwort wird verschleiert im FHEM-Backend gespeichert. Es muss nach erfolgreichem Login nicht mehr eingegeben werden.

Die angeschlossenen Aktoren werden jetzt durch autocreate als Instanzen von KLF200Node im Raum KLF200Node angelegt.
Die Namen der Geräte folgen dem Muster <name>_<NodeID>.
Wurde im WebUI der KLF200 ein Name für das Gerät vergeben dann wird dieser als Alias übernommen.

Die Geräte sind jetzt einsatzbereit.

== Modul KLF200 ==
=== Verbindungsstatus ===
==== STATE ====
Im STATE des Moduls sieht man den aktuellen Verbindungsstatus. Im Idealfall ist er nach der Initialisierung Logged in.
=== Ausführung von Programmen (Szenen) ===
Obwohl man mit dem Modul KLF200Node jedes Gerät unabhängig und auch gleichzeitig steuern kann, sind Szenen eine nützliche Ergänzung. So kann man mit Szenen wie "Alle zu" oder "Alle auf" viele Geräte gleichzeitig mit einem Befehl bedienen.

Hinweis: Während der Abarbeitung einer Szene werden weitere Befehle gepuffert.
==== scene/sceneID ====
Mit diesen Set-Funktionen kann man eine aufgezeichnete Szene aufrufen.
Im entsprechenden Reading steht die zuletzt aufgerufene Szene.

Die Zuordnung zwischen sceneID und scene sieht man in den Internals unter scenes.

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Bei vielen aktuellen Geräten lässt sich die Ausführungsgeschwindigkeit (Velocity) variieren. So lässt sich die Geschwindigkeit gegenüber der Default-Geschwindigkeit noch erhöhen oder auch deutlich reduzieren. So ist eine besonders leise Bedienung möglich.

==== Argument DEFAULT, FAST, SILENT ====
Die Velocity kann man bei der Ausführung von Szenen als zusätzliches Argument von set scene oder set sceneID setzen.
Unterstützte Werte sind DEFAULT, FAST und SILENT
:<code>set Velux scene "Alle zu" SILENT</code>
==== Attribut velocity ====
Alternativ kann man im Modul KLF200 das Attribut velocity setzen, das bei der Ausführung von Szenen herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

Hinweis: Dieses Attribut hat keine Auswirkungen auf Befehle, die vom Modul KLF200Node abgesetzt werden.

== Modul KLF200Node ==
Dieses Modul wurde dem Homematic-Modul CUL_HM nachempfunden, da es ebenfalls ein breites Spektrum an Geräten unterstützt
und möglichst kompatibel zu vorhandenen Hilfsmodulen sein soll.
=== Aktueller Status ===
Im Folgenden wird der Zusammenhang zwischen den wichtigsten Readings/Set-Funktionen pct, state, execution erklärt.
==== pct ====
Dieses Reading enthält den aktuell bekannten Status des Gerätes in Prozent.

Wird das Gerät über die KLF-200-Box gesteuert, wird das Reading beim Erreichen der Zielposition sofort aktualisiert.

Wird das Gerät über eine Fernbedienung oder einen Sensor gesteuert, kann sich die Aktualisierung wenige Minuten verzögern.

Mit der Set-Funktion kann man das Gerät in diesen Status versetzen.
Per Default entspricht 100 auf der Fernbedienung oben und 0 unten.
==== state ====
Dieses Reading entspricht dem Reading pct, mit der Ausnahme, dass 0 durch '''off''' ersetzt wird und 100 durch '''on'''.

Die Set-Funktion funktioniert analog.
Per Default entspricht on auf der Fernbedienung oben und off unten.

Es werden die '''set extensions''' unterstützt. Damit können mit einem Set ein oder mehrere Befehle zeitgesteuert abgesetzt werden.

Doku: [https://fhem.de/commandref_DE.html#set set extensions in der commandref] und im [[DevelopmentModuleIntro#X_Set]] jeweils etwas weiter unten.

==== execution ====
Dieses Reading gibt den aktuellen Ausführungsstatus wieder. Die meiste Zeit ist der Wert stop.
Wird gerade ein Befehl ausgeführt, ist der Wert up oder down.

Mit der Set-Funktion werden entsprechende Befehle ausgeführt, up entspricht auf der Fernbedienung oben und down unten.
Bei stop wird die aktuelle Ausführung angehalten.

==== Attribut directionOn ====
Wie oben beschrieben, entspricht per Default on = 100 = up.

Das kann bei bestimmten Geräten für manchen Nutzer verwirrend sein.
Wenn man z.B. bei einem Rollladen lieber im geschlossenen Zustand 100 Prozent sehen möchte, dann setzt man das Attribut directionOn, z.B.
:<code>attr Velux_2 directionOn down</code>

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Wie bei Szenen lässt sich auch bei Kommandos auf KLF200Node die Ausführungsgeschwindigkeit beeinflussen, soweit das vom Gerät unterstützt ist.
==== Reading velocity ====
Dieses Reading hat den Wert supported, wenn die Geschwindigkeit bei diesem Gerät geändert werden kann.
Selbst bei Not supported wäre es einen Versuch wert, es zu testen.
==== Argument DEFAULT, FAST, SILENT ====
Alle set-Funktionen, die eine Bewegung auslösen unterstützen das optionale Argument DEFAULT, FAST oder SILENT.
==== Attribut velocity ====
Alternativ kann man im Modul KLF200Node das Attribut velocity setzen, das bei der Ausführung von Kommandos herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

=== Begrenzung des Bewegungsradius / Limitation ===
Die io-homecontrol Geräte haben ein Feature eingebaut, um den Bewegungsradius der Geräte einzuschränken, egal von wo aus sie gesteuert werden. Dieses Limitation-Feature ist in dieses FHEM-Modul ebenfalls integriert.
==== limitationMin und limitationMax ====
Mit den Settern und Readings limitationMin und limitationMax kann man die Limitation setzen und auslesen.
Natürlich kann man auch selbst von der Limitation Gebrauch machen. Man kann z.B. einen Rollladen begrenzen, wenn man weiß, dass das Dachfenster weit offen ist. Dann kann der Rollladen nicht gegen das Fenster stoßen, selbst wenn man ihn mit der Fernbedienung bewegt.
==== limiationClear ====
Mit dem Setter limiationClear kann man alle Limitations (auch von fremden Geräten ausgelöste) löschen.
==== updateLimiation ====
Der Setter updateLimiation aktualisiert die Readings limitationMin und limitationMax auf diesem Gerät, falls die Limitation außerhalb von FHEM gesetzt wurde.

=== Auswerten der Regensensoren ===
Die Regensensoren von Velux Fensteröffnern machen von diesem Limitation-Feature Gebrauch. Wenn es regnet, wird der Bewegungsradius der Fenster eingeschränkt. Zum Beispiel (evtl. Geräte-abhängig):
* limitationMax = 7 bei Regen,
* limitationMax = 100 wenn es aufhört.
Diese Werte kann man auslesen, ohne dass sich das Fenster dazu bewegt haben muss.

==== limitationUpdateInterval ====
Mit set limitationUpdateInterval kann man festlegen, wie oft diese Werte ausgelesen werden:
* off: Dieser Wert ist für Geräte ohne integrierte Sensoren der Beste, denn zusätzliche Updates sind überflüssig.
* onChange: Hier wird limitationMin und limitationMax aktualisiert, wenn das Gerät bewegt wurde.
* interval in s: Ein Poll-Intervall in Sekunden. Tests mit 120 sind erfolgreich durchgelaufen. Dieser Wert ist vielleicht etwas übertrieben, man denke an das Funkfeuer und den Akku der Geräte. Ein Intervall von 600 ist vielleicht sinnvoller. Beispiele:
:<code>set Velux_1 limitationUpdateInterval off</code>
:<code>set Velux_2 limitationUpdateInterval onChange</code>
:<code>set Velux_3 limitationUpdateInterval 600</code>

==== Extra Reading für den Regensensor ====
Wem die Auswertung vom Reading limitationMax zu indirekt ist, der kann sich ein neues Reading anlegen.
Der folgende Code legt ein Reading namens sensor an, die Werte sind im Beispiel "Regen" oder "trocken".
Es besteht die Annahme, dass bei limitationMax = 7 der Regensensor angeschlagen hat.
:<code>attr Velux_3 userReadings sensor {(ReadingsVal($name,"limitationMax",100) == 7)?"Regen":"trocken"}</code>
Hinweis: Das neue Reading sensor erscheint erst, wenn das Reading limitationMax einmal aktualisiert wurde.

== Vorschläge zur schöneren Darstellung ==
Wie Homematic-Geräte kommt KLF200Node im FHEM-Web sehr schlicht daher. Dieses Kapitel gibt Vorschläge zur Konfiguration einer schöneren Darstellung.

=== Rollladen ===
Dieses Beispiel stellt den Status des Rollladen 10-Prozent genau im Icon dar. Bewegen sich der Rollladen, hat das Icon einen Pfeil nach oben oder unten. Ein Klick auf das Icon setzt den Rollladen in Bewegung oder hält ihn an (toggle).

:<code>attr Velux_2 stateFormat pct execution</code>
:<code>attr Velux_2 devStateIcon .*up:fts_shutter_up:toggle .*down:fts_shutter_down:toggle \d.stop:fts_shutter_100:toggle 1\d.stop:fts_shutter_90:toggle 2\d.stop:fts_shutter_80:toggle 3\d.stop:fts_shutter_70:toggle 4\d.stop:fts_shutter_60:toggle 5\d.stop:fts_shutter_50:toggle 6\d.stop:fts_shutter_40:toggle 7\d.stop:fts_shutter_30:toggle 8\d.stop:fts_shutter_20:toggle 9\d.stop:fts_shutter_10:toggle 100.stop:fts_window_2w:toggle</code>
[[Datei:RollerShutterUpDown.png|300px|Rollladen mit Pfeilen]]

So erhält man einen Slider für die Rollladenposition:

:<code>attr Velux_2 webCmd pct</code>

=== Dachschrägenfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachschrägenfenster in drei Stufen dar:

0% - 9%: geschlossen

10% - 59%: halb geöffnet

60% - 100%: ganz geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_4 limitationUpdateInterval 600</code>
:<code>attr Velux_4 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_4 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7\).*:weather_rain:toggle \d.$.*:fts_window_roof:toggle [1-5]\d.\(.*:fts_window_roof_open_1:toggle [6-9]\d.\(.*:fts_window_roof_open_2:toggle 100.\(.*:fts_window_roof_open_2:toggle</code>

=== Dachkuppelfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachkuppelfenster in zwei Stufen dar:

0% - 9%: geschlossen

10% - 100%: geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_5 limitationUpdateInterval 600</code>
:<code>attr Velux_5 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_5 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7$.*:weather_rain:toggle \d.\(.*:fts_light_dome:toggle [1-9]\d.\(.*:fts_light_dome_open:toggle 100.\(.*:fts_light_dome_open:toggle</code>

== Problembehebung ==
Sollte es zu Verbindungsabbrüchen zwischen FHEM und der KLF200-Box kommen, dann sind folgende Dinge zu überprüfen:
=== FHEM Update ===
Ist FHEM aktuell? Am 18.12.2018 gab es ein wichtiges FHEM-Update, das die Stabilität von SSL-Verbindungen wesentlich verbessert hat.
=== OpenSSL ===
OpenSLL sollte immer aktuell sein.
=== Perl SSL-Bibliotheken ===
Wenn die Perl SSL-Bibliotheken zu alt sind, ist das oben genannte FHEM-Update wirkungslos.
* IO::Socket::SSL
* Net::SSL
* Net::SSLeay
* Net::SSLeay::Handle
* Crypt::SSLeay
* Net::Server::Proto::SSL
== Links ==
* Support im Forum gibt es unter {{Link2Forum|Topic=92907|LinkText=Velux KLF200 mit Firmware 2.0.0.71 für io-homecontrol}}
* Github: [https://github.com/buennerbernd/fhem/tree/master/KLF200/2.0 FHEM modules KLF200 and KLF200Node]

[[Kategorie:Rollladensteuerung]]
[[Kategorie:Other Components]]

Velux KLF200

2019-04-25T20:50:25Z

Buennerbernd: /* Verbereitung */

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Anbindung io-homecontrol Aktoren an FHEM
|ModType=x
|ModCmdRef=KLF200
|ModFTopic=92907
|ModTechName=83_KLF200.pm
|ModOwner=buennerbernd ({{Link2FU|21440|Forum}} / [[Benutzer Diskussion:Buennerbernd|Wiki]])
}}

[[KLF200]] ist ein Modul zur Steuerung von io-homecontrol Aktoren über das Gateway Velux KLF 200.

== Velux KLF 200 ==

Die KLF-200-Box ist über LAN mit FHEM verbunden und steuert die Aktoren über das verschlüsselte Funkprotokoll io-homecontrol.
Die Aktoren geben Rückmeldung über ihren aktuellen Zustand.

Die Box hat 10 elektrische Eingänge mit denen man 5 Geräte oder Gerätegruppen steuern kann.
Damit kann man z.B. mit Doppeltastern an der Wand seine Rollladen oder Fenster steuern.
Über den LAN-Anschluss lassen sich mit FHEM bis zu 200 Geräte mit einer KLF 200 verwalten.

Das Modul erfordert die Firmware-Version 2.0.0.71 und basiert auf der dokumentierten API von Velux. [https://www.velux.com/api/klf200 Download und weitere Informationen]

Das Gateway hat keine Cloud-Integration.

== Unterstützte Geräte ==

Grundsätzlich sollten alle io-homecontrol Aktoren funktionieren. Alleinstehende Sensoren (z.B. Lichtsensor, Windsensor) werden
von der KLF-200-Box nicht unterstützt. Es besteht aber die Möglichkeit, den Status von Sensoren auszuwerten, die in Aktoren integriert sind.

Aktuell werden folgende Geräte erfolgreich mit diesem Modul verwendet:

* Rollladen:
** VELUX SML
** VELUX SSL
** Somfy Oximo io
* Sichtschutz innen:
** VELUX FSK
* Fensteröffner mit integriertem Regensensor:
** VELUX KMG
** VELUX CVP
** VELUX KSX
* Markisen:
** Somfy Sunea io

== Benutzung in FHEM ==
=== Vorbereitung ===
Bevor die Aktoren in FHEM verwendet werden können, müssen sie in der KLF 200 angelernt werden.
Das geschieht über das WebUI der KLF 200, das über einen Wifi-Hotspot erreichbar ist. Dieser Vorgang ist im Handbuch beschrieben.
Im WebUI können die angeschlossenen Geräte auch benannt werden. Zusätzlich hat man die Möglichkeit, Programme (Szenen) aufzuzeichnen,
um ein oder mehrere Geräte in eine definierte Position zu bringen. Diese Szenen kann man aus FHEM ebenfalls ansteuern.

Das Modul wird momentan noch nicht über FHEM ausgeliefert.
Es wird wie folgt geladen und aktualisiert:

:<code>update all <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>
:<code>shutdown restart</code>

Mit diesem Befehl wird das Modul so eingerichtet, dass es ebenfalls aktualisiert wird, wenn man FHEM aktualisiert:
:<code>update add <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>

=== Anlegen der Geräte ===
:<code>define <name> KLF200 <host></code>
Beispiel:
:<code>define Velux KLF200 192.168.0.66</code>

Danach Login durch Eingabe des Passwortes:
:<code>set <name> login <password></code>

Hinweis: Das Passwort ist laut Dokumentation das Wifi-Passwort, das auf den Boden der Box gedruckt ist.
Das funktioniert bei einigen Nutzern. Bei vielen Nutzern funktioniert hingegen das Passwort des WebUI.
Scheinbar hängt das davon ab, mit welcher Firmware die Box ausgeliefert wurde und ob schon einmal ein Reset durchgeführt wurde.
Das Passwort wird verschleiert im FHEM-Backend gespeichert. Es muss nach erfolgreichem Login nicht mehr eingegeben werden.

Die angeschlossenen Aktoren werden jetzt durch autocreate als Instanzen von KLF200Node im Raum KLF200Node angelegt.
Die Namen der Geräte folgen dem Muster <name>_<NodeID>.
Wurde im WebUI der KLF200 ein Name für das Gerät vergeben dann wird dieser als Alias übernommen.

Die Geräte sind jetzt einsatzbereit.

== Modul KLF200 ==
=== Verbindungsstatus ===
==== STATE ====
Im STATE des Moduls sieht man den aktuellen Verbindungsstatus. Im Idealfall ist er nach der Initialisierung Logged in.
=== Ausführung von Programmen (Szenen) ===
Obwohl man mit dem Modul KLF200Node jedes Gerät unabhängig und auch gleichzeitig steuern kann, sind Szenen eine nützliche Ergänzung. So kann man mit Szenen wie "Alle zu" oder "Alle auf" viele Geräte gleichzeitig mit einem Befehl bedienen.

Hinweis: Während der Abarbeitung einer Szene werden weitere Befehle gepuffert.
==== scene/sceneID ====
Mit diesen Set-Funktionen kann man eine aufgezeichnete Szene aufrufen.
Im entsprechenden Reading steht die zuletzt aufgerufene Szene.

Die Zuordnung zwischen sceneID und scene sieht man in den Internals unter scenes.

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Bei vielen aktuellen Geräten lässt sich die Ausführungsgeschwindigkeit (Velocity) variieren. So lässt sich die Geschwindigkeit gegenüber der Default-Geschwindigkeit noch erhöhen oder auch deutlich reduzieren. So ist eine besonders leise Bedienung möglich.

==== Argument DEFAULT, FAST, SILENT ====
Die Velocity kann man bei der Ausführung von Szenen als zusätzliches Argument von set scene oder set sceneID setzen.
Unterstützte Werte sind DEFAULT, FAST und SILENT
:<code>set Velux scene "Alle zu" SILENT</code>
==== Attribut velocity ====
Alternativ kann man im Modul KLF200 das Attribut velocity setzen, das bei der Ausführung von Szenen herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

Hinweis: Dieses Attribut hat keine Auswirkungen auf Befehle, die vom Modul KLF200Node abgesetzt werden.

== Modul KLF200Node ==
Dieses Modul wurde dem Homematic-Modul CUL_HM nachempfunden, da es ebenfalls ein breites Spektrum an Geräten unterstützt
und möglichst kompatibel zu vorhandenen Hilfsmodulen sein soll.
=== Aktueller Status ===
Im Folgenden wird der Zusammenhang zwischen den wichtigsten Readings/Set-Funktionen pct, state, execution erklärt.
==== pct ====
Dieses Reading enthält den aktuell bekannten Status des Gerätes in Prozent.

Wird das Gerät über die KLF-200-Box gesteuert, wird das Reading beim Erreichen der Zielposition sofort aktualisiert.

Wird das Gerät über eine Fernbedienung oder einen Sensor gesteuert, kann sich die Aktualisierung wenige Minuten verzögern.

Mit der Set-Funktion kann man das Gerät in diesen Status versetzen.
Per Default entspricht 100 auf der Fernbedienung oben und 0 unten.
==== state ====
Dieses Reading entspricht dem Reading pct, mit der Ausnahme, dass 0 durch '''off''' ersetzt wird und 100 durch '''on'''.

Die Set-Funktion funktioniert analog.
Per Default entspricht on auf der Fernbedienung oben und off unten.

Es werden die '''set extensions''' unterstützt. Damit können mit einem Set ein oder mehrere Befehle zeitgesteuert abgesetzt werden.

Doku: [https://fhem.de/commandref_DE.html#set set extensions in der commandref] und im [[DevelopmentModuleIntro#X_Set]] jeweils etwas weiter unten.

==== execution ====
Dieses Reading gibt den aktuellen Ausführungsstatus wieder. Die meiste Zeit ist der Wert stop.
Wird gerade ein Befehl ausgeführt, ist der Wert up oder down.

Mit der Set-Funktion werden entsprechende Befehle ausgeführt, up entspricht auf der Fernbedienung oben und down unten.
Bei stop wird die aktuelle Ausführung angehalten.

==== Attribut directionOn ====
Wie oben beschrieben, entspricht per Default on = 100 = up.

Das kann bei bestimmten Geräten für manchen Nutzer verwirrend sein.
Wenn man z.B. bei einem Rollladen lieber im geschlossenen Zustand 100 Prozent sehen möchte, dann setzt man das Attribut directionOn, z.B.
:<code>attr Velux_2 directionOn down</code>

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Wie bei Szenen lässt sich auch bei Kommandos auf KLF200Node die Ausführungsgeschwindigkeit beeinflussen, soweit das vom Gerät unterstützt ist.
==== Reading velocity ====
Dieses Reading hat den Wert supported, wenn die Geschwindigkeit bei diesem Gerät geändert werden kann.
Selbst bei Not supported wäre es einen Versuch wert, es zu testen.
==== Argument DEFAULT, FAST, SILENT ====
Alle set-Funktionen, die eine Bewegung auslösen unterstützen das optionale Argument DEFAULT, FAST oder SILENT.
==== Attribut velocity ====
Alternativ kann man im Modul KLF200Node das Attribut velocity setzen, das bei der Ausführung von Kommandos herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

=== Begrenzung des Bewegungsradius / Limitation ===
Die io-homecontrol Geräte haben ein Feature eingebaut, um den Bewegungsradius der Geräte einzuschränken, egal von wo aus sie gesteuert werden. Dieses Limitation-Feature ist in dieses FHEM-Modul ebenfalls integriert.
==== limitationMin und limitationMax ====
Mit den Settern und Readings limitationMin und limitationMax kann man die Limitation setzen und auslesen.
Natürlich kann man auch selbst von der Limitation Gebrauch machen. Man kann z.B. einen Rollladen begrenzen, wenn man weiß, dass das Dachfenster weit offen ist. Dann kann der Rollladen nicht gegen das Fenster stoßen, selbst wenn man ihn mit der Fernbedienung bewegt.
==== limiationClear ====
Mit dem Setter limiationClear kann man alle Limitations (auch von fremden Geräten ausgelöste) löschen.
==== updateLimiation ====
Der Setter updateLimiation aktualisiert die Readings limitationMin und limitationMax auf diesem Gerät, falls die Limitation außerhalb von FHEM gesetzt wurde.

=== Auswerten der Regensensoren ===
Die Regensensoren von Velux Fensteröffnern machen von diesem Limitation-Feature Gebrauch. Wenn es regnet, wird der Bewegungsradius der Fenster eingeschränkt. Zum Beispiel (evtl. Geräte-abhängig):
* limitationMax = 7 bei Regen,
* limitationMax = 100 wenn es aufhört.
Diese Werte kann man auslesen, ohne dass sich das Fenster dazu bewegt haben muss.

==== limitationUpdateInterval ====
Mit set limitationUpdateInterval kann man festlegen, wie oft diese Werte ausgelesen werden:
* off: Dieser Wert ist für Geräte ohne integrierte Sensoren der Beste, denn zusätzliche Updates sind überflüssig.
* onChange: Hier wird limitationMin und limitationMax aktualisiert, wenn das Gerät bewegt wurde.
* interval in s: Ein Poll-Intervall in Sekunden. Tests mit 120 sind erfolgreich durchgelaufen. Dieser Wert ist vielleicht etwas übertrieben, man denke an das Funkfeuer und den Akku der Geräte. Ein Intervall von 600 ist vielleicht sinnvoller. Beispiele:
:<code>set Velux_1 limitationUpdateInterval off</code>
:<code>set Velux_2 limitationUpdateInterval onChange</code>
:<code>set Velux_3 limitationUpdateInterval 600</code>

==== Extra Reading für den Regensensor ====
Wem die Auswertung vom Reading limitationMax zu indirekt ist, der kann sich ein neues Reading anlegen.
Der folgende Code legt ein Reading namens sensor an, die Werte sind im Beipiel "Regen" oder "trocken".
Es besteht die Annahme, dass bei limitationMax = 7 der Regensensor angeschlagen hat.
:<code>attr Velux_3 userReadings sensor {(ReadingsVal($name,"limitationMax",100) == 7)?"Regen":"trocken"}</code>
Hinweis: Das neue Reading sensor erscheint erst, wenn das Reading limitationMax einmal aktualisiert wurde.

== Vorschläge zur schöneren Darstellung ==
Wie Homematic-Geräte kommt KLF200Node im FHEM-Web sehr schlicht daher. Dieses Kapitel gibt Vorschläge zur Konfiguration einer schöneren Darstellung.

=== Rollladen ===
Dieses Beispiel stellt den Status des Rollladen 10-Prozent genau im Icon dar. Bewegen sich der Rollladen, hat das Icon einen Pfeil nach oben oder unten. Ein Klick auf das Icon setzt den Rollladen in Bewegung oder hält ihn an (toggle).

:<code>attr Velux_2 stateFormat pct execution</code>
:<code>attr Velux_2 devStateIcon .*up:fts_shutter_up:toggle .*down:fts_shutter_down:toggle \d.stop:fts_shutter_100:toggle 1\d.stop:fts_shutter_90:toggle 2\d.stop:fts_shutter_80:toggle 3\d.stop:fts_shutter_70:toggle 4\d.stop:fts_shutter_60:toggle 5\d.stop:fts_shutter_50:toggle 6\d.stop:fts_shutter_40:toggle 7\d.stop:fts_shutter_30:toggle 8\d.stop:fts_shutter_20:toggle 9\d.stop:fts_shutter_10:toggle 100.stop:fts_window_2w:toggle</code>
[[Datei:RollerShutterUpDown.png|300px|Rollladen mit Pfeilen]]

So erhält man einen Slider für die Rollladenposition:

:<code>attr Velux_2 webCmd pct</code>

=== Dachschrägenfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachschrägenfenster in drei Stufen dar:

0% - 9%: geschlossen

10% - 59%: halb geöffnet

60% - 100%: ganz geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_4 limitationUpdateInterval 600</code>
:<code>attr Velux_4 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_4 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7\).*:weather_rain:toggle \d.$.*:fts_window_roof:toggle [1-5]\d.\(.*:fts_window_roof_open_1:toggle [6-9]\d.\(.*:fts_window_roof_open_2:toggle 100.\(.*:fts_window_roof_open_2:toggle</code>

=== Dachkuppelfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachkuppelfenster in zwei Stufen dar:

0% - 9%: geschlossen

10% - 100%: geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_5 limitationUpdateInterval 600</code>
:<code>attr Velux_5 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_5 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7$.*:weather_rain:toggle \d.\(.*:fts_light_dome:toggle [1-9]\d.\(.*:fts_light_dome_open:toggle 100.\(.*:fts_light_dome_open:toggle</code>

== Problembehebung ==
Sollte es zu Verbindungsabbrüchen zwischen FHEM und der KLF200-Box kommen, dann sind folgende Dinge zu überprüfen:
=== FHEM Update ===
Ist FHEM aktuell? Am 18.12.2018 gab es ein wichtiges FHEM-Update, das die Stabilität von SSL-Verbindungen wesentlich verbessert hat.
=== OpenSSL ===
OpenSLL sollte immer aktuell sein.
=== Perl SSL-Bibliotheken ===
Wenn die Perl SSL-Bibliotheken zu alt sind, ist das oben genannte FHEM-Update wirkungslos.
* IO::Socket::SSL
* Net::SSL
* Net::SSLeay
* Net::SSLeay::Handle
* Crypt::SSLeay
* Net::Server::Proto::SSL
== Links ==
* Support im Forum gibt es unter {{Link2Forum|Topic=92907|LinkText=Velux KLF200 mit Firmware 2.0.0.71 für io-homecontrol}}
* Github: [https://github.com/buennerbernd/fhem/tree/master/KLF200/2.0 FHEM modules KLF200 and KLF200Node]

[[Kategorie:Rollladensteuerung]]
[[Kategorie:Other Components]]

Velux KLF200

2019-04-23T08:12:10Z

Buennerbernd: /* Unterstützte Geräte */

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Anbindung io-homecontrol Aktoren an FHEM
|ModType=x
|ModCmdRef=KLF200
|ModFTopic=92907
|ModTechName=83_KLF200.pm
|ModOwner=buennerbernd ({{Link2FU|21440|Forum}} / [[Benutzer Diskussion:Buennerbernd|Wiki]])
}}

[[KLF200]] ist ein Modul zur Steuerung von io-homecontrol Aktoren über das Gateway Velux KLF 200.

== Velux KLF 200 ==

Die KLF-200-Box ist über LAN mit FHEM verbunden und steuert die Aktoren über das verschlüsselte Funkprotokoll io-homecontrol.
Die Aktoren geben Rückmeldung über ihren aktuellen Zustand.

Die Box hat 10 elektrische Eingänge mit denen man 5 Geräte oder Gerätegruppen steuern kann.
Damit kann man z.B. mit Doppeltastern an der Wand seine Rollladen oder Fenster steuern.
Über den LAN-Anschluss lassen sich mit FHEM bis zu 200 Geräte mit einer KLF 200 verwalten.

Das Modul erfordert die Firmware-Version 2.0.0.71 und basiert auf der dokumentierten API von Velux. [https://www.velux.com/api/klf200 Download und weitere Informationen]

Das Gateway hat keine Cloud-Integration.

== Unterstützte Geräte ==

Grundsätzlich sollten alle io-homecontrol Aktoren funktionieren. Alleinstehende Sensoren (z.B. Lichtsensor, Windsensor) werden
von der KLF-200-Box nicht unterstützt. Es besteht aber die Möglichkeit, den Status von Sensoren auszuwerten, die in Aktoren integriert sind.

Aktuell werden folgende Geräte erfolgreich mit diesem Modul verwendet:

* Rollladen:
** VELUX SML
** VELUX SSL
** Somfy Oximo io
* Sichtschutz innen:
** VELUX FSK
* Fensteröffner mit integriertem Regensensor:
** VELUX KMG
** VELUX CVP
** VELUX KSX
* Markisen:
** Somfy Sunea io

== Benutzung in FHEM ==
=== Verbereitung ===
Bevor die Aktoren in FHEM verwendet werden können, müssen sie in der KLF 200 angelernt werden.
Das geschieht über das WebUI der KLF 200, das über einen Wifi-Hotspot erreichbar ist. Dieser Vorgang ist im Handbuch beschrieben.
Im WebUI können die angeschlossenen Geräte auch benannt werden. Zusätzlich hat man die Möglichkeit, Programme (Szenen) aufzuzeichnen,
um ein oder mehrere Geräte in eine definierte Position zu bringen. Diese Szenen kann man aus FHEM ebenfalls ansteuern.

Das Modul wird momentan noch nicht über FHEM ausgeliefert.
Es wird wie folgt geladen und aktualisiert:

:<code>update all <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>
:<code>shutdown restart</code>

Mit diesem Befehl wird das Modul so eingerichtet, dass es ebenfalls aktualisiert wird, wenn man FHEM aktualisiert:
:<code>update add <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>

=== Anlegen der Geräte ===
:<code>define <name> KLF200 <host></code>
Beispiel:
:<code>define Velux KLF200 192.168.0.66</code>

Danach Login durch Eingabe des Passwortes:
:<code>set <name> login <password></code>

Hinweis: Das Passwort ist laut Dokumentation das Wifi-Passwort, das auf den Boden der Box gedruckt ist.
Das funktioniert bei einigen Nutzern. Bei vielen Nutzern funktioniert hingegen das Passwort des WebUI.
Scheinbar hängt das davon ab, mit welcher Firmware die Box ausgeliefert wurde und ob schon einmal ein Reset durchgeführt wurde.
Das Passwort wird verschleiert im FHEM-Backend gespeichert. Es muss nach erfolgreichem Login nicht mehr eingegeben werden.

Die angeschlossenen Aktoren werden jetzt durch autocreate als Instanzen von KLF200Node im Raum KLF200Node angelegt.
Die Namen der Geräte folgen dem Muster <name>_<NodeID>.
Wurde im WebUI der KLF200 ein Name für das Gerät vergeben dann wird dieser als Alias übernommen.

Die Geräte sind jetzt einsatzbereit.

== Modul KLF200 ==
=== Verbindungsstatus ===
==== STATE ====
Im STATE des Moduls sieht man den aktuellen Verbindungsstatus. Im Idealfall ist er nach der Initialisierung Logged in.
=== Ausführung von Programmen (Szenen) ===
Obwohl man mit dem Modul KLF200Node jedes Gerät unabhängig und auch gleichzeitig steuern kann, sind Szenen eine nützliche Ergänzung. So kann man mit Szenen wie "Alle zu" oder "Alle auf" viele Geräte gleichzeitig mit einem Befehl bedienen.

Hinweis: Während der Abarbeitung einer Szene werden weitere Befehle gepuffert.
==== scene/sceneID ====
Mit diesen Set-Funktionen kann man eine aufgezeichnete Szene aufrufen.
Im entsprechenden Reading steht die zuletzt aufgerufene Szene.

Die Zuordnung zwischen sceneID und scene sieht man in den Internals unter scenes.

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Bei vielen aktuellen Geräten lässt sich die Ausführungsgeschwindigkeit (Velocity) variieren. So lässt sich die Geschwindigkeit gegenüber der Default-Geschwindigkeit noch erhöhen oder auch deutlich reduzieren. So ist eine besonders leise Bedienung möglich.

==== Argument DEFAULT, FAST, SILENT ====
Die Velocity kann man bei der Ausführung von Szenen als zusätzliches Argument von set scene oder set sceneID setzen.
Unterstützte Werte sind DEFAULT, FAST und SILENT
:<code>set Velux scene "Alle zu" SILENT</code>
==== Attribut velocity ====
Alternativ kann man im Modul KLF200 das Attribut velocity setzen, das bei der Ausführung von Szenen herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

Hinweis: Dieses Attribut hat keine Auswirkungen auf Befehle, die vom Modul KLF200Node abgesetzt werden.

== Modul KLF200Node ==
Dieses Modul wurde dem Homematic-Modul CUL_HM nachempfunden, da es ebenfalls ein breites Spektrum an Geräten unterstützt
und möglichst kompatibel zu vorhandenen Hilfsmodulen sein soll.
=== Aktueller Status ===
Im Folgenden wird der Zusammenhang zwischen den wichtigsten Readings/Set-Funktionen pct, state, execution erklärt.
==== pct ====
Dieses Reading enthält den aktuell bekannten Status des Gerätes in Prozent.

Wird das Gerät über die KLF-200-Box gesteuert, wird das Reading beim Erreichen der Zielposition sofort aktualisiert.

Wird das Gerät über eine Fernbedienung oder einen Sensor gesteuert, kann sich die Aktualisierung wenige Minuten verzögern.

Mit der Set-Funktion kann man das Gerät in diesen Status versetzen.
Per Default entspricht 100 auf der Fernbedienung oben und 0 unten.
==== state ====
Dieses Reading entspricht dem Reading pct, mit der Ausnahme, dass 0 durch '''off''' ersetzt wird und 100 durch '''on'''.

Die Set-Funktion funktioniert analog.
Per Default entspricht on auf der Fernbedienung oben und off unten.

Es werden die '''set extensions''' unterstützt. Damit können mit einem Set ein oder mehrere Befehle zeitgesteuert abgesetzt werden.

Doku: [https://fhem.de/commandref_DE.html#set set extensions in der commandref] und im [[DevelopmentModuleIntro#X_Set]] jeweils etwas weiter unten.

==== execution ====
Dieses Reading gibt den aktuellen Ausführungsstatus wieder. Die meiste Zeit ist der Wert stop.
Wird gerade ein Befehl ausgeführt, ist der Wert up oder down.

Mit der Set-Funktion werden entsprechende Befehle ausgeführt, up entspricht auf der Fernbedienung oben und down unten.
Bei stop wird die aktuelle Ausführung angehalten.

==== Attribut directionOn ====
Wie oben beschrieben, entspricht per Default on = 100 = up.

Das kann bei bestimmten Geräten für manchen Nutzer verwirrend sein.
Wenn man z.B. bei einem Rollladen lieber im geschlossenen Zustand 100 Prozent sehen möchte, dann setzt man das Attribut directionOn, z.B.
:<code>attr Velux_2 directionOn down</code>

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Wie bei Szenen lässt sich auch bei Kommandos auf KLF200Node die Ausführungsgeschwindigkeit beeinflussen, soweit das vom Gerät unterstützt ist.
==== Reading velocity ====
Dieses Reading hat den Wert supported, wenn die Geschwindigkeit bei diesem Gerät geändert werden kann.
Selbst bei Not supported wäre es einen Versuch wert, es zu testen.
==== Argument DEFAULT, FAST, SILENT ====
Alle set-Funktionen, die eine Bewegung auslösen unterstützen das optionale Argument DEFAULT, FAST oder SILENT.
==== Attribut velocity ====
Alternativ kann man im Modul KLF200Node das Attribut velocity setzen, das bei der Ausführung von Kommandos herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

=== Begrenzung des Bewegungsradius / Limitation ===
Die io-homecontrol Geräte haben ein Feature eingebaut, um den Bewegungsradius der Geräte einzuschränken, egal von wo aus sie gesteuert werden. Dieses Limitation-Feature ist in dieses FHEM-Modul ebenfalls integriert.
==== limitationMin und limitationMax ====
Mit den Settern und Readings limitationMin und limitationMax kann man die Limitation setzen und auslesen.
Natürlich kann man auch selbst von der Limitation Gebrauch machen. Man kann z.B. einen Rollladen begrenzen, wenn man weiß, dass das Dachfenster weit offen ist. Dann kann der Rollladen nicht gegen das Fenster stoßen, selbst wenn man ihn mit der Fernbedienung bewegt.
==== limiationClear ====
Mit dem Setter limiationClear kann man alle Limitations (auch von fremden Geräten ausgelöste) löschen.
==== updateLimiation ====
Der Setter updateLimiation aktualisiert die Readings limitationMin und limitationMax auf diesem Gerät, falls die Limitation außerhalb von FHEM gesetzt wurde.

=== Auswerten der Regensensoren ===
Die Regensensoren von Velux Fensteröffnern machen von diesem Limitation-Feature Gebrauch. Wenn es regnet, wird der Bewegungsradius der Fenster eingeschränkt. Zum Beispiel (evtl. Geräte-abhängig):
* limitationMax = 7 bei Regen,
* limitationMax = 100 wenn es aufhört.
Diese Werte kann man auslesen, ohne dass sich das Fenster dazu bewegt haben muss.

==== limitationUpdateInterval ====
Mit set limitationUpdateInterval kann man festlegen, wie oft diese Werte ausgelesen werden:
* off: Dieser Wert ist für Geräte ohne integrierte Sensoren der Beste, denn zusätzliche Updates sind überflüssig.
* onChange: Hier wird limitationMin und limitationMax aktualisiert, wenn das Gerät bewegt wurde.
* interval in s: Ein Poll-Intervall in Sekunden. Tests mit 120 sind erfolgreich durchgelaufen. Dieser Wert ist vielleicht etwas übertrieben, man denke an das Funkfeuer und den Akku der Geräte. Ein Intervall von 600 ist vielleicht sinnvoller. Beispiele:
:<code>set Velux_1 limitationUpdateInterval off</code>
:<code>set Velux_2 limitationUpdateInterval onChange</code>
:<code>set Velux_3 limitationUpdateInterval 600</code>

==== Extra Reading für den Regensensor ====
Wem die Auswertung vom Reading limitationMax zu indirekt ist, der kann sich ein neues Reading anlegen.
Der folgende Code legt ein Reading namens sensor an, die Werte sind im Beipiel "Regen" oder "trocken".
Es besteht die Annahme, dass bei limitationMax = 7 der Regensensor angeschlagen hat.
:<code>attr Velux_3 userReadings sensor {(ReadingsVal($name,"limitationMax",100) == 7)?"Regen":"trocken"}</code>
Hinweis: Das neue Reading sensor erscheint erst, wenn das Reading limitationMax einmal aktualisiert wurde.

== Vorschläge zur schöneren Darstellung ==
Wie Homematic-Geräte kommt KLF200Node im FHEM-Web sehr schlicht daher. Dieses Kapitel gibt Vorschläge zur Konfiguration einer schöneren Darstellung.

=== Rollladen ===
Dieses Beispiel stellt den Status des Rollladen 10-Prozent genau im Icon dar. Bewegen sich der Rollladen, hat das Icon einen Pfeil nach oben oder unten. Ein Klick auf das Icon setzt den Rollladen in Bewegung oder hält ihn an (toggle).

:<code>attr Velux_2 stateFormat pct execution</code>
:<code>attr Velux_2 devStateIcon .*up:fts_shutter_up:toggle .*down:fts_shutter_down:toggle \d.stop:fts_shutter_100:toggle 1\d.stop:fts_shutter_90:toggle 2\d.stop:fts_shutter_80:toggle 3\d.stop:fts_shutter_70:toggle 4\d.stop:fts_shutter_60:toggle 5\d.stop:fts_shutter_50:toggle 6\d.stop:fts_shutter_40:toggle 7\d.stop:fts_shutter_30:toggle 8\d.stop:fts_shutter_20:toggle 9\d.stop:fts_shutter_10:toggle 100.stop:fts_window_2w:toggle</code>
[[Datei:RollerShutterUpDown.png|300px|Rollladen mit Pfeilen]]

So erhält man einen Slider für die Rollladenposition:

:<code>attr Velux_2 webCmd pct</code>

=== Dachschrägenfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachschrägenfenster in drei Stufen dar:

0% - 9%: geschlossen

10% - 59%: halb geöffnet

60% - 100%: ganz geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_4 limitationUpdateInterval 600</code>
:<code>attr Velux_4 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_4 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7\).*:weather_rain:toggle \d.$.*:fts_window_roof:toggle [1-5]\d.\(.*:fts_window_roof_open_1:toggle [6-9]\d.\(.*:fts_window_roof_open_2:toggle 100.\(.*:fts_window_roof_open_2:toggle</code>

=== Dachkuppelfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachkuppelfenster in zwei Stufen dar:

0% - 9%: geschlossen

10% - 100%: geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_5 limitationUpdateInterval 600</code>
:<code>attr Velux_5 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_5 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7$.*:weather_rain:toggle \d.\(.*:fts_light_dome:toggle [1-9]\d.\(.*:fts_light_dome_open:toggle 100.\(.*:fts_light_dome_open:toggle</code>

== Problembehebung ==
Sollte es zu Verbindungsabbrüchen zwischen FHEM und der KLF200-Box kommen, dann sind folgende Dinge zu überprüfen:
=== FHEM Update ===
Ist FHEM aktuell? Am 18.12.2018 gab es ein wichtiges FHEM-Update, das die Stabilität von SSL-Verbindungen wesentlich verbessert hat.
=== OpenSSL ===
OpenSLL sollte immer aktuell sein.
=== Perl SSL-Bibliotheken ===
Wenn die Perl SSL-Bibliotheken zu alt sind, ist das oben genannte FHEM-Update wirkungslos.
* IO::Socket::SSL
* Net::SSL
* Net::SSLeay
* Net::SSLeay::Handle
* Crypt::SSLeay
* Net::Server::Proto::SSL
== Links ==
* Support im Forum gibt es unter {{Link2Forum|Topic=92907|LinkText=Velux KLF200 mit Firmware 2.0.0.71 für io-homecontrol}}
* Github: [https://github.com/buennerbernd/fhem/tree/master/KLF200/2.0 FHEM modules KLF200 and KLF200Node]

[[Kategorie:Rollladensteuerung]]
[[Kategorie:Other Components]]

Velux KLF200

2019-04-23T08:11:41Z

Buennerbernd: /* Unterstützte Geräte */

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Anbindung io-homecontrol Aktoren an FHEM
|ModType=x
|ModCmdRef=KLF200
|ModFTopic=92907
|ModTechName=83_KLF200.pm
|ModOwner=buennerbernd ({{Link2FU|21440|Forum}} / [[Benutzer Diskussion:Buennerbernd|Wiki]])
}}

[[KLF200]] ist ein Modul zur Steuerung von io-homecontrol Aktoren über das Gateway Velux KLF 200.

== Velux KLF 200 ==

Die KLF-200-Box ist über LAN mit FHEM verbunden und steuert die Aktoren über das verschlüsselte Funkprotokoll io-homecontrol.
Die Aktoren geben Rückmeldung über ihren aktuellen Zustand.

Die Box hat 10 elektrische Eingänge mit denen man 5 Geräte oder Gerätegruppen steuern kann.
Damit kann man z.B. mit Doppeltastern an der Wand seine Rollladen oder Fenster steuern.
Über den LAN-Anschluss lassen sich mit FHEM bis zu 200 Geräte mit einer KLF 200 verwalten.

Das Modul erfordert die Firmware-Version 2.0.0.71 und basiert auf der dokumentierten API von Velux. [https://www.velux.com/api/klf200 Download und weitere Informationen]

Das Gateway hat keine Cloud-Integration.

== Unterstützte Geräte ==

Grundsätzlich sollten alle io-homecontrol Aktoren funktionieren. Alleinstehende Sensoren (z.B. Lichtsensor, Windsensor) werden
von der KLF-200-Box nicht unterstützt. Es besteht aber die Möglichkeit, den Status von Sensoren auszuwerten, die in Aktoren integriert sind.

Aktuell werden folgende Geräte erfolgreich mit diesem Modul verwendet:

* Rollladen:
** VELUX SML
** VELUX SSL
** Somfy Oximo io
* Sichtschutz innen:
** VELUX FSK
* Fensteröffner mit integriertem Regensensor:
** VELUX KMG
** VELUX CVP
** VELUX KSX
* Markisen
** Somfy Sunea io

== Benutzung in FHEM ==
=== Verbereitung ===
Bevor die Aktoren in FHEM verwendet werden können, müssen sie in der KLF 200 angelernt werden.
Das geschieht über das WebUI der KLF 200, das über einen Wifi-Hotspot erreichbar ist. Dieser Vorgang ist im Handbuch beschrieben.
Im WebUI können die angeschlossenen Geräte auch benannt werden. Zusätzlich hat man die Möglichkeit, Programme (Szenen) aufzuzeichnen,
um ein oder mehrere Geräte in eine definierte Position zu bringen. Diese Szenen kann man aus FHEM ebenfalls ansteuern.

Das Modul wird momentan noch nicht über FHEM ausgeliefert.
Es wird wie folgt geladen und aktualisiert:

:<code>update all <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>
:<code>shutdown restart</code>

Mit diesem Befehl wird das Modul so eingerichtet, dass es ebenfalls aktualisiert wird, wenn man FHEM aktualisiert:
:<code>update add <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>

=== Anlegen der Geräte ===
:<code>define <name> KLF200 <host></code>
Beispiel:
:<code>define Velux KLF200 192.168.0.66</code>

Danach Login durch Eingabe des Passwortes:
:<code>set <name> login <password></code>

Hinweis: Das Passwort ist laut Dokumentation das Wifi-Passwort, das auf den Boden der Box gedruckt ist.
Das funktioniert bei einigen Nutzern. Bei vielen Nutzern funktioniert hingegen das Passwort des WebUI.
Scheinbar hängt das davon ab, mit welcher Firmware die Box ausgeliefert wurde und ob schon einmal ein Reset durchgeführt wurde.
Das Passwort wird verschleiert im FHEM-Backend gespeichert. Es muss nach erfolgreichem Login nicht mehr eingegeben werden.

Die angeschlossenen Aktoren werden jetzt durch autocreate als Instanzen von KLF200Node im Raum KLF200Node angelegt.
Die Namen der Geräte folgen dem Muster <name>_<NodeID>.
Wurde im WebUI der KLF200 ein Name für das Gerät vergeben dann wird dieser als Alias übernommen.

Die Geräte sind jetzt einsatzbereit.

== Modul KLF200 ==
=== Verbindungsstatus ===
==== STATE ====
Im STATE des Moduls sieht man den aktuellen Verbindungsstatus. Im Idealfall ist er nach der Initialisierung Logged in.
=== Ausführung von Programmen (Szenen) ===
Obwohl man mit dem Modul KLF200Node jedes Gerät unabhängig und auch gleichzeitig steuern kann, sind Szenen eine nützliche Ergänzung. So kann man mit Szenen wie "Alle zu" oder "Alle auf" viele Geräte gleichzeitig mit einem Befehl bedienen.

Hinweis: Während der Abarbeitung einer Szene werden weitere Befehle gepuffert.
==== scene/sceneID ====
Mit diesen Set-Funktionen kann man eine aufgezeichnete Szene aufrufen.
Im entsprechenden Reading steht die zuletzt aufgerufene Szene.

Die Zuordnung zwischen sceneID und scene sieht man in den Internals unter scenes.

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Bei vielen aktuellen Geräten lässt sich die Ausführungsgeschwindigkeit (Velocity) variieren. So lässt sich die Geschwindigkeit gegenüber der Default-Geschwindigkeit noch erhöhen oder auch deutlich reduzieren. So ist eine besonders leise Bedienung möglich.

==== Argument DEFAULT, FAST, SILENT ====
Die Velocity kann man bei der Ausführung von Szenen als zusätzliches Argument von set scene oder set sceneID setzen.
Unterstützte Werte sind DEFAULT, FAST und SILENT
:<code>set Velux scene "Alle zu" SILENT</code>
==== Attribut velocity ====
Alternativ kann man im Modul KLF200 das Attribut velocity setzen, das bei der Ausführung von Szenen herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

Hinweis: Dieses Attribut hat keine Auswirkungen auf Befehle, die vom Modul KLF200Node abgesetzt werden.

== Modul KLF200Node ==
Dieses Modul wurde dem Homematic-Modul CUL_HM nachempfunden, da es ebenfalls ein breites Spektrum an Geräten unterstützt
und möglichst kompatibel zu vorhandenen Hilfsmodulen sein soll.
=== Aktueller Status ===
Im Folgenden wird der Zusammenhang zwischen den wichtigsten Readings/Set-Funktionen pct, state, execution erklärt.
==== pct ====
Dieses Reading enthält den aktuell bekannten Status des Gerätes in Prozent.

Wird das Gerät über die KLF-200-Box gesteuert, wird das Reading beim Erreichen der Zielposition sofort aktualisiert.

Wird das Gerät über eine Fernbedienung oder einen Sensor gesteuert, kann sich die Aktualisierung wenige Minuten verzögern.

Mit der Set-Funktion kann man das Gerät in diesen Status versetzen.
Per Default entspricht 100 auf der Fernbedienung oben und 0 unten.
==== state ====
Dieses Reading entspricht dem Reading pct, mit der Ausnahme, dass 0 durch '''off''' ersetzt wird und 100 durch '''on'''.

Die Set-Funktion funktioniert analog.
Per Default entspricht on auf der Fernbedienung oben und off unten.

Es werden die '''set extensions''' unterstützt. Damit können mit einem Set ein oder mehrere Befehle zeitgesteuert abgesetzt werden.

Doku: [https://fhem.de/commandref_DE.html#set set extensions in der commandref] und im [[DevelopmentModuleIntro#X_Set]] jeweils etwas weiter unten.

==== execution ====
Dieses Reading gibt den aktuellen Ausführungsstatus wieder. Die meiste Zeit ist der Wert stop.
Wird gerade ein Befehl ausgeführt, ist der Wert up oder down.

Mit der Set-Funktion werden entsprechende Befehle ausgeführt, up entspricht auf der Fernbedienung oben und down unten.
Bei stop wird die aktuelle Ausführung angehalten.

==== Attribut directionOn ====
Wie oben beschrieben, entspricht per Default on = 100 = up.

Das kann bei bestimmten Geräten für manchen Nutzer verwirrend sein.
Wenn man z.B. bei einem Rollladen lieber im geschlossenen Zustand 100 Prozent sehen möchte, dann setzt man das Attribut directionOn, z.B.
:<code>attr Velux_2 directionOn down</code>

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Wie bei Szenen lässt sich auch bei Kommandos auf KLF200Node die Ausführungsgeschwindigkeit beeinflussen, soweit das vom Gerät unterstützt ist.
==== Reading velocity ====
Dieses Reading hat den Wert supported, wenn die Geschwindigkeit bei diesem Gerät geändert werden kann.
Selbst bei Not supported wäre es einen Versuch wert, es zu testen.
==== Argument DEFAULT, FAST, SILENT ====
Alle set-Funktionen, die eine Bewegung auslösen unterstützen das optionale Argument DEFAULT, FAST oder SILENT.
==== Attribut velocity ====
Alternativ kann man im Modul KLF200Node das Attribut velocity setzen, das bei der Ausführung von Kommandos herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

=== Begrenzung des Bewegungsradius / Limitation ===
Die io-homecontrol Geräte haben ein Feature eingebaut, um den Bewegungsradius der Geräte einzuschränken, egal von wo aus sie gesteuert werden. Dieses Limitation-Feature ist in dieses FHEM-Modul ebenfalls integriert.
==== limitationMin und limitationMax ====
Mit den Settern und Readings limitationMin und limitationMax kann man die Limitation setzen und auslesen.
Natürlich kann man auch selbst von der Limitation Gebrauch machen. Man kann z.B. einen Rollladen begrenzen, wenn man weiß, dass das Dachfenster weit offen ist. Dann kann der Rollladen nicht gegen das Fenster stoßen, selbst wenn man ihn mit der Fernbedienung bewegt.
==== limiationClear ====
Mit dem Setter limiationClear kann man alle Limitations (auch von fremden Geräten ausgelöste) löschen.
==== updateLimiation ====
Der Setter updateLimiation aktualisiert die Readings limitationMin und limitationMax auf diesem Gerät, falls die Limitation außerhalb von FHEM gesetzt wurde.

=== Auswerten der Regensensoren ===
Die Regensensoren von Velux Fensteröffnern machen von diesem Limitation-Feature Gebrauch. Wenn es regnet, wird der Bewegungsradius der Fenster eingeschränkt. Zum Beispiel (evtl. Geräte-abhängig):
* limitationMax = 7 bei Regen,
* limitationMax = 100 wenn es aufhört.
Diese Werte kann man auslesen, ohne dass sich das Fenster dazu bewegt haben muss.

==== limitationUpdateInterval ====
Mit set limitationUpdateInterval kann man festlegen, wie oft diese Werte ausgelesen werden:
* off: Dieser Wert ist für Geräte ohne integrierte Sensoren der Beste, denn zusätzliche Updates sind überflüssig.
* onChange: Hier wird limitationMin und limitationMax aktualisiert, wenn das Gerät bewegt wurde.
* interval in s: Ein Poll-Intervall in Sekunden. Tests mit 120 sind erfolgreich durchgelaufen. Dieser Wert ist vielleicht etwas übertrieben, man denke an das Funkfeuer und den Akku der Geräte. Ein Intervall von 600 ist vielleicht sinnvoller. Beispiele:
:<code>set Velux_1 limitationUpdateInterval off</code>
:<code>set Velux_2 limitationUpdateInterval onChange</code>
:<code>set Velux_3 limitationUpdateInterval 600</code>

==== Extra Reading für den Regensensor ====
Wem die Auswertung vom Reading limitationMax zu indirekt ist, der kann sich ein neues Reading anlegen.
Der folgende Code legt ein Reading namens sensor an, die Werte sind im Beipiel "Regen" oder "trocken".
Es besteht die Annahme, dass bei limitationMax = 7 der Regensensor angeschlagen hat.
:<code>attr Velux_3 userReadings sensor {(ReadingsVal($name,"limitationMax",100) == 7)?"Regen":"trocken"}</code>
Hinweis: Das neue Reading sensor erscheint erst, wenn das Reading limitationMax einmal aktualisiert wurde.

== Vorschläge zur schöneren Darstellung ==
Wie Homematic-Geräte kommt KLF200Node im FHEM-Web sehr schlicht daher. Dieses Kapitel gibt Vorschläge zur Konfiguration einer schöneren Darstellung.

=== Rollladen ===
Dieses Beispiel stellt den Status des Rollladen 10-Prozent genau im Icon dar. Bewegen sich der Rollladen, hat das Icon einen Pfeil nach oben oder unten. Ein Klick auf das Icon setzt den Rollladen in Bewegung oder hält ihn an (toggle).

:<code>attr Velux_2 stateFormat pct execution</code>
:<code>attr Velux_2 devStateIcon .*up:fts_shutter_up:toggle .*down:fts_shutter_down:toggle \d.stop:fts_shutter_100:toggle 1\d.stop:fts_shutter_90:toggle 2\d.stop:fts_shutter_80:toggle 3\d.stop:fts_shutter_70:toggle 4\d.stop:fts_shutter_60:toggle 5\d.stop:fts_shutter_50:toggle 6\d.stop:fts_shutter_40:toggle 7\d.stop:fts_shutter_30:toggle 8\d.stop:fts_shutter_20:toggle 9\d.stop:fts_shutter_10:toggle 100.stop:fts_window_2w:toggle</code>
[[Datei:RollerShutterUpDown.png|300px|Rollladen mit Pfeilen]]

So erhält man einen Slider für die Rollladenposition:

:<code>attr Velux_2 webCmd pct</code>

=== Dachschrägenfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachschrägenfenster in drei Stufen dar:

0% - 9%: geschlossen

10% - 59%: halb geöffnet

60% - 100%: ganz geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_4 limitationUpdateInterval 600</code>
:<code>attr Velux_4 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_4 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7\).*:weather_rain:toggle \d.$.*:fts_window_roof:toggle [1-5]\d.\(.*:fts_window_roof_open_1:toggle [6-9]\d.\(.*:fts_window_roof_open_2:toggle 100.\(.*:fts_window_roof_open_2:toggle</code>

=== Dachkuppelfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachkuppelfenster in zwei Stufen dar:

0% - 9%: geschlossen

10% - 100%: geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_5 limitationUpdateInterval 600</code>
:<code>attr Velux_5 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_5 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7$.*:weather_rain:toggle \d.\(.*:fts_light_dome:toggle [1-9]\d.\(.*:fts_light_dome_open:toggle 100.\(.*:fts_light_dome_open:toggle</code>

== Problembehebung ==
Sollte es zu Verbindungsabbrüchen zwischen FHEM und der KLF200-Box kommen, dann sind folgende Dinge zu überprüfen:
=== FHEM Update ===
Ist FHEM aktuell? Am 18.12.2018 gab es ein wichtiges FHEM-Update, das die Stabilität von SSL-Verbindungen wesentlich verbessert hat.
=== OpenSSL ===
OpenSLL sollte immer aktuell sein.
=== Perl SSL-Bibliotheken ===
Wenn die Perl SSL-Bibliotheken zu alt sind, ist das oben genannte FHEM-Update wirkungslos.
* IO::Socket::SSL
* Net::SSL
* Net::SSLeay
* Net::SSLeay::Handle
* Crypt::SSLeay
* Net::Server::Proto::SSL
== Links ==
* Support im Forum gibt es unter {{Link2Forum|Topic=92907|LinkText=Velux KLF200 mit Firmware 2.0.0.71 für io-homecontrol}}
* Github: [https://github.com/buennerbernd/fhem/tree/master/KLF200/2.0 FHEM modules KLF200 and KLF200Node]

[[Kategorie:Rollladensteuerung]]
[[Kategorie:Other Components]]

Velux KLF200

2019-04-01T14:33:47Z

Buennerbernd: /* state */

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Anbindung io-homecontrol Aktoren an FHEM
|ModType=x
|ModCmdRef=KLF200
|ModFTopic=92907
|ModTechName=83_KLF200.pm
|ModOwner=buennerbernd ({{Link2FU|21440|Forum}} / [[Benutzer Diskussion:Buennerbernd|Wiki]])
}}

[[KLF200]] ist ein Modul zur Steuerung von io-homecontrol Aktoren über das Gateway Velux KLF 200.

== Velux KLF 200 ==

Die KLF-200-Box ist über LAN mit FHEM verbunden und steuert die Aktoren über das verschlüsselte Funkprotokoll io-homecontrol.
Die Aktoren geben Rückmeldung über ihren aktuellen Zustand.

Die Box hat 10 elektrische Eingänge mit denen man 5 Geräte oder Gerätegruppen steuern kann.
Damit kann man z.B. mit Doppeltastern an der Wand seine Rollladen oder Fenster steuern.
Über den LAN-Anschluss lassen sich mit FHEM bis zu 200 Geräte mit einer KLF 200 verwalten.

Das Modul erfordert die Firmware-Version 2.0.0.71 und basiert auf der dokumentierten API von Velux. [https://www.velux.com/api/klf200 Download und weitere Informationen]

Das Gateway hat keine Cloud-Integration.

== Unterstützte Geräte ==

Grundsätzlich sollten alle io-homecontrol Aktoren funktionieren. Alleinstehende Sensoren (z.B. Lichtsensor, Windsensor) werden
von der KLF-200-Box nicht unterstützt. Es besteht aber die Möglichkeit, den Status von Sensoren auszuwerten, die in Aktoren integriert sind.

Aktuell werden folgende Geräte erfolgreich mit diesem Modul verwendet:

* Rollladen:
** VELUX SML
** VELUX SSL
** Somfy Oximo io
* Sichtschutz innen:
** VELUX FSK
* Fensteröffner mit integriertem Regensensor:
** VELUX KMG
** VELUX CVP
** VELUX KSX

== Benutzung in FHEM ==
=== Verbereitung ===
Bevor die Aktoren in FHEM verwendet werden können, müssen sie in der KLF 200 angelernt werden.
Das geschieht über das WebUI der KLF 200, das über einen Wifi-Hotspot erreichbar ist. Dieser Vorgang ist im Handbuch beschrieben.
Im WebUI können die angeschlossenen Geräte auch benannt werden. Zusätzlich hat man die Möglichkeit, Programme (Szenen) aufzuzeichnen,
um ein oder mehrere Geräte in eine definierte Position zu bringen. Diese Szenen kann man aus FHEM ebenfalls ansteuern.

Das Modul wird momentan noch nicht über FHEM ausgeliefert.
Es wird wie folgt geladen und aktualisiert:

:<code>update all <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>
:<code>shutdown restart</code>

Mit diesem Befehl wird das Modul so eingerichtet, dass es ebenfalls aktualisiert wird, wenn man FHEM aktualisiert:
:<code>update add <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>

=== Anlegen der Geräte ===
:<code>define <name> KLF200 <host></code>
Beispiel:
:<code>define Velux KLF200 192.168.0.66</code>

Danach Login durch Eingabe des Passwortes:
:<code>set <name> login <password></code>

Hinweis: Das Passwort ist laut Dokumentation das Wifi-Passwort, das auf den Boden der Box gedruckt ist.
Das funktioniert bei einigen Nutzern. Bei vielen Nutzern funktioniert hingegen das Passwort des WebUI.
Scheinbar hängt das davon ab, mit welcher Firmware die Box ausgeliefert wurde und ob schon einmal ein Reset durchgeführt wurde.
Das Passwort wird verschleiert im FHEM-Backend gespeichert. Es muss nach erfolgreichem Login nicht mehr eingegeben werden.

Die angeschlossenen Aktoren werden jetzt durch autocreate als Instanzen von KLF200Node im Raum KLF200Node angelegt.
Die Namen der Geräte folgen dem Muster <name>_<NodeID>.
Wurde im WebUI der KLF200 ein Name für das Gerät vergeben dann wird dieser als Alias übernommen.

Die Geräte sind jetzt einsatzbereit.

== Modul KLF200 ==
=== Verbindungsstatus ===
==== STATE ====
Im STATE des Moduls sieht man den aktuellen Verbindungsstatus. Im Idealfall ist er nach der Initialisierung Logged in.
=== Ausführung von Programmen (Szenen) ===
Obwohl man mit dem Modul KLF200Node jedes Gerät unabhängig und auch gleichzeitig steuern kann, sind Szenen eine nützliche Ergänzung. So kann man mit Szenen wie "Alle zu" oder "Alle auf" viele Geräte gleichzeitig mit einem Befehl bedienen.

Hinweis: Während der Abarbeitung einer Szene werden weitere Befehle gepuffert.
==== scene/sceneID ====
Mit diesen Set-Funktionen kann man eine aufgezeichnete Szene aufrufen.
Im entsprechenden Reading steht die zuletzt aufgerufene Szene.

Die Zuordnung zwischen sceneID und scene sieht man in den Internals unter scenes.

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Bei vielen aktuellen Geräten lässt sich die Ausführungsgeschwindigkeit (Velocity) variieren. So lässt sich die Geschwindigkeit gegenüber der Default-Geschwindigkeit noch erhöhen oder auch deutlich reduzieren. So ist eine besonders leise Bedienung möglich.

==== Argument DEFAULT, FAST, SILENT ====
Die Velocity kann man bei der Ausführung von Szenen als zusätzliches Argument von set scene oder set sceneID setzen.
Unterstützte Werte sind DEFAULT, FAST und SILENT
:<code>set Velux scene "Alle zu" SILENT</code>
==== Attribut velocity ====
Alternativ kann man im Modul KLF200 das Attribut velocity setzen, das bei der Ausführung von Szenen herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

Hinweis: Dieses Attribut hat keine Auswirkungen auf Befehle, die vom Modul KLF200Node abgesetzt werden.

== Modul KLF200Node ==
Dieses Modul wurde dem Homematic-Modul CUL_HM nachempfunden, da es ebenfalls ein breites Spektrum an Geräten unterstützt
und möglichst kompatibel zu vorhandenen Hilfsmodulen sein soll.
=== Aktueller Status ===
Im Folgenden wird der Zusammenhang zwischen den wichtigsten Readings/Set-Funktionen pct, state, execution erklärt.
==== pct ====
Dieses Reading enthält den aktuell bekannten Status des Gerätes in Prozent.

Wird das Gerät über die KLF-200-Box gesteuert, wird das Reading beim Erreichen der Zielposition sofort aktualisiert.

Wird das Gerät über eine Fernbedienung oder einen Sensor gesteuert, kann sich die Aktualisierung wenige Minuten verzögern.

Mit der Set-Funktion kann man das Gerät in diesen Status versetzen.
Per Default entspricht 100 auf der Fernbedienung oben und 0 unten.
==== state ====
Dieses Reading entspricht dem Reading pct, mit der Ausnahme, dass 0 durch '''off''' ersetzt wird und 100 durch '''on'''.

Die Set-Funktion funktioniert analog.
Per Default entspricht on auf der Fernbedienung oben und off unten.

Es werden die '''set extensions''' unterstützt. Damit können mit einem Set ein oder mehrere Befehle zeitgesteuert abgesetzt werden.

Doku: [https://fhem.de/commandref_DE.html#set set extensions in der commandref] und im [[DevelopmentModuleIntro#X_Set]] jeweils etwas weiter unten.

==== execution ====
Dieses Reading gibt den aktuellen Ausführungsstatus wieder. Die meiste Zeit ist der Wert stop.
Wird gerade ein Befehl ausgeführt, ist der Wert up oder down.

Mit der Set-Funktion werden entsprechende Befehle ausgeführt, up entspricht auf der Fernbedienung oben und down unten.
Bei stop wird die aktuelle Ausführung angehalten.

==== Attribut directionOn ====
Wie oben beschrieben, entspricht per Default on = 100 = up.

Das kann bei bestimmten Geräten für manchen Nutzer verwirrend sein.
Wenn man z.B. bei einem Rollladen lieber im geschlossenen Zustand 100 Prozent sehen möchte, dann setzt man das Attribut directionOn, z.B.
:<code>attr Velux_2 directionOn down</code>

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Wie bei Szenen lässt sich auch bei Kommandos auf KLF200Node die Ausführungsgeschwindigkeit beeinflussen, soweit das vom Gerät unterstützt ist.
==== Reading velocity ====
Dieses Reading hat den Wert supported, wenn die Geschwindigkeit bei diesem Gerät geändert werden kann.
Selbst bei Not supported wäre es einen Versuch wert, es zu testen.
==== Argument DEFAULT, FAST, SILENT ====
Alle set-Funktionen, die eine Bewegung auslösen unterstützen das optionale Argument DEFAULT, FAST oder SILENT.
==== Attribut velocity ====
Alternativ kann man im Modul KLF200Node das Attribut velocity setzen, das bei der Ausführung von Kommandos herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

=== Begrenzung des Bewegungsradius / Limitation ===
Die io-homecontrol Geräte haben ein Feature eingebaut, um den Bewegungsradius der Geräte einzuschränken, egal von wo aus sie gesteuert werden. Dieses Limitation-Feature ist in dieses FHEM-Modul ebenfalls integriert.
==== limitationMin und limitationMax ====
Mit den Settern und Readings limitationMin und limitationMax kann man die Limitation setzen und auslesen.
Natürlich kann man auch selbst von der Limitation Gebrauch machen. Man kann z.B. einen Rollladen begrenzen, wenn man weiß, dass das Dachfenster weit offen ist. Dann kann der Rollladen nicht gegen das Fenster stoßen, selbst wenn man ihn mit der Fernbedienung bewegt.
==== limiationClear ====
Mit dem Setter limiationClear kann man alle Limitations (auch von fremden Geräten ausgelöste) löschen.
==== updateLimiation ====
Der Setter updateLimiation aktualisiert die Readings limitationMin und limitationMax auf diesem Gerät, falls die Limitation außerhalb von FHEM gesetzt wurde.

=== Auswerten der Regensensoren ===
Die Regensensoren von Velux Fensteröffnern machen von diesem Limitation-Feature Gebrauch. Wenn es regnet, wird der Bewegungsradius der Fenster eingeschränkt. Zum Beispiel (evtl. Geräte-abhängig):
* limitationMax = 7 bei Regen,
* limitationMax = 100 wenn es aufhört.
Diese Werte kann man auslesen, ohne dass sich das Fenster dazu bewegt haben muss.

==== limitationUpdateInterval ====
Mit set limitationUpdateInterval kann man festlegen, wie oft diese Werte ausgelesen werden:
* off: Dieser Wert ist für Geräte ohne integrierte Sensoren der Beste, denn zusätzliche Updates sind überflüssig.
* onChange: Hier wird limitationMin und limitationMax aktualisiert, wenn das Gerät bewegt wurde.
* interval in s: Ein Poll-Intervall in Sekunden. Tests mit 120 sind erfolgreich durchgelaufen. Dieser Wert ist vielleicht etwas übertrieben, man denke an das Funkfeuer und den Akku der Geräte. Ein Intervall von 600 ist vielleicht sinnvoller. Beispiele:
:<code>set Velux_1 limitationUpdateInterval off</code>
:<code>set Velux_2 limitationUpdateInterval onChange</code>
:<code>set Velux_3 limitationUpdateInterval 600</code>

==== Extra Reading für den Regensensor ====
Wem die Auswertung vom Reading limitationMax zu indirekt ist, der kann sich ein neues Reading anlegen.
Der folgende Code legt ein Reading namens sensor an, die Werte sind im Beipiel "Regen" oder "trocken".
Es besteht die Annahme, dass bei limitationMax = 7 der Regensensor angeschlagen hat.
:<code>attr Velux_3 userReadings sensor {(ReadingsVal($name,"limitationMax",100) == 7)?"Regen":"trocken"}</code>
Hinweis: Das neue Reading sensor erscheint erst, wenn das Reading limitationMax einmal aktualisiert wurde.

== Vorschläge zur schöneren Darstellung ==
Wie Homematic-Geräte kommt KLF200Node im FHEM-Web sehr schlicht daher. Dieses Kapitel gibt Vorschläge zur Konfiguration einer schöneren Darstellung.

=== Rollladen ===
Dieses Beispiel stellt den Status des Rollladen 10-Prozent genau im Icon dar. Bewegen sich der Rollladen, hat das Icon einen Pfeil nach oben oder unten. Ein Klick auf das Icon setzt den Rollladen in Bewegung oder hält ihn an (toggle).

:<code>attr Velux_2 stateFormat pct execution</code>
:<code>attr Velux_2 devStateIcon .*up:fts_shutter_up:toggle .*down:fts_shutter_down:toggle \d.stop:fts_shutter_100:toggle 1\d.stop:fts_shutter_90:toggle 2\d.stop:fts_shutter_80:toggle 3\d.stop:fts_shutter_70:toggle 4\d.stop:fts_shutter_60:toggle 5\d.stop:fts_shutter_50:toggle 6\d.stop:fts_shutter_40:toggle 7\d.stop:fts_shutter_30:toggle 8\d.stop:fts_shutter_20:toggle 9\d.stop:fts_shutter_10:toggle 100.stop:fts_window_2w:toggle</code>
[[Datei:RollerShutterUpDown.png|300px|Rollladen mit Pfeilen]]

So erhält man einen Slider für die Rollladenposition:

:<code>attr Velux_2 webCmd pct</code>

=== Dachschrägenfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachschrägenfenster in drei Stufen dar:

0% - 9%: geschlossen

10% - 59%: halb geöffnet

60% - 100%: ganz geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_4 limitationUpdateInterval 600</code>
:<code>attr Velux_4 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_4 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7\).*:weather_rain:toggle \d.$.*:fts_window_roof:toggle [1-5]\d.\(.*:fts_window_roof_open_1:toggle [6-9]\d.\(.*:fts_window_roof_open_2:toggle 100.\(.*:fts_window_roof_open_2:toggle</code>

=== Dachkuppelfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachkuppelfenster in zwei Stufen dar:

0% - 9%: geschlossen

10% - 100%: geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_5 limitationUpdateInterval 600</code>
:<code>attr Velux_5 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_5 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7$.*:weather_rain:toggle \d.\(.*:fts_light_dome:toggle [1-9]\d.\(.*:fts_light_dome_open:toggle 100.\(.*:fts_light_dome_open:toggle</code>

== Problembehebung ==
Sollte es zu Verbindungsabbrüchen zwischen FHEM und der KLF200-Box kommen, dann sind folgende Dinge zu überprüfen:
=== FHEM Update ===
Ist FHEM aktuell? Am 18.12.2018 gab es ein wichtiges FHEM-Update, das die Stabilität von SSL-Verbindungen wesentlich verbessert hat.
=== OpenSSL ===
OpenSLL sollte immer aktuell sein.
=== Perl SSL-Bibliotheken ===
Wenn die Perl SSL-Bibliotheken zu alt sind, ist das oben genannte FHEM-Update wirkungslos.
* IO::Socket::SSL
* Net::SSL
* Net::SSLeay
* Net::SSLeay::Handle
* Crypt::SSLeay
* Net::Server::Proto::SSL
== Links ==
* Support im Forum gibt es unter {{Link2Forum|Topic=92907|LinkText=Velux KLF200 mit Firmware 2.0.0.71 für io-homecontrol}}
* Github: [https://github.com/buennerbernd/fhem/tree/master/KLF200/2.0 FHEM modules KLF200 and KLF200Node]

[[Kategorie:Rollladensteuerung]]
[[Kategorie:Other Components]]

Velux KLF200

2019-03-15T09:23:23Z

Buennerbernd:

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Anbindung io-homecontrol Aktoren an FHEM
|ModType=x
|ModCmdRef=KLF200
|ModFTopic=92907
|ModTechName=83_KLF200.pm
|ModOwner=buennerbernd ({{Link2FU|21440|Forum}} / [[Benutzer Diskussion:Buennerbernd|Wiki]])
}}

[[KLF200]] ist ein Modul zur Steuerung von io-homecontrol Aktoren über das Gateway Velux KLF 200.

== Velux KLF 200 ==

Die KLF-200-Box ist über LAN mit FHEM verbunden und steuert die Aktoren über das verschlüsselte Funkprotokoll io-homecontrol.
Die Aktoren geben Rückmeldung über ihren aktuellen Zustand.

Die Box hat 10 elektrische Eingänge mit denen man 5 Geräte oder Gerätegruppen steuern kann.
Damit kann man z.B. mit Doppeltastern an der Wand seine Rollladen oder Fenster steuern.
Über den LAN-Anschluss lassen sich mit FHEM bis zu 200 Geräte mit einer KLF 200 verwalten.

Das Modul erfordert die Firmware-Version 2.0.0.71 und basiert auf der dokumentierten API von Velux. [https://www.velux.com/api/klf200 Download und weitere Informationen]

Das Gateway hat keine Cloud-Integration.

== Unterstützte Geräte ==

Grundsätzlich sollten alle io-homecontrol Aktoren funktionieren. Alleinstehende Sensoren (z.B. Lichtsensor, Windsensor) werden
von der KLF-200-Box nicht unterstützt. Es besteht aber die Möglichkeit, den Status von Sensoren auszuwerten, die in Aktoren integriert sind.

Aktuell werden folgende Geräte erfolgreich mit diesem Modul verwendet:

* Rollladen:
** VELUX SML
** VELUX SSL
** Somfy Oximo io
* Sichtschutz innen:
** VELUX FSK
* Fensteröffner mit integriertem Regensensor:
** VELUX KMG
** VELUX CVP
** VELUX KSX

== Benutzung in FHEM ==
=== Verbereitung ===
Bevor die Aktoren in FHEM verwendet werden können, müssen sie in der KLF 200 angelernt werden.
Das geschieht über das WebUI der KLF 200, das über einen Wifi-Hotspot erreichbar ist. Dieser Vorgang ist im Handbuch beschrieben.
Im WebUI können die angeschlossenen Geräte auch benannt werden. Zusätzlich hat man die Möglichkeit, Programme (Szenen) aufzuzeichnen,
um ein oder mehrere Geräte in eine definierte Position zu bringen. Diese Szenen kann man aus FHEM ebenfalls ansteuern.

Das Modul wird momentan noch nicht über FHEM ausgeliefert.
Es wird wie folgt geladen und aktualisiert:

:<code>update all <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>
:<code>shutdown restart</code>

Mit diesem Befehl wird das Modul so eingerichtet, dass es ebenfalls aktualisiert wird, wenn man FHEM aktualisiert:
:<code>update add <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>

=== Anlegen der Geräte ===
:<code>define <name> KLF200 <host></code>
Beispiel:
:<code>define Velux KLF200 192.168.0.66</code>

Danach Login durch Eingabe des Passwortes:
:<code>set <name> login <password></code>

Hinweis: Das Passwort ist laut Dokumentation das Wifi-Passwort, das auf den Boden der Box gedruckt ist.
Das funktioniert bei einigen Nutzern. Bei vielen Nutzern funktioniert hingegen das Passwort des WebUI.
Scheinbar hängt das davon ab, mit welcher Firmware die Box ausgeliefert wurde und ob schon einmal ein Reset durchgeführt wurde.
Das Passwort wird verschleiert im FHEM-Backend gespeichert. Es muss nach erfolgreichem Login nicht mehr eingegeben werden.

Die angeschlossenen Aktoren werden jetzt durch autocreate als Instanzen von KLF200Node im Raum KLF200Node angelegt.
Die Namen der Geräte folgen dem Muster <name>_<NodeID>.
Wurde im WebUI der KLF200 ein Name für das Gerät vergeben dann wird dieser als Alias übernommen.

Die Geräte sind jetzt einsatzbereit.

== Modul KLF200 ==
=== Verbindungsstatus ===
==== STATE ====
Im STATE des Moduls sieht man den aktuellen Verbindungsstatus. Im Idealfall ist er nach der Initialisierung Logged in.
=== Ausführung von Programmen (Szenen) ===
Obwohl man mit dem Modul KLF200Node jedes Gerät unabhängig und auch gleichzeitig steuern kann, sind Szenen eine nützliche Ergänzung. So kann man mit Szenen wie "Alle zu" oder "Alle auf" viele Geräte gleichzeitig mit einem Befehl bedienen.

Hinweis: Während der Abarbeitung einer Szene werden weitere Befehle gepuffert.
==== scene/sceneID ====
Mit diesen Set-Funktionen kann man eine aufgezeichnete Szene aufrufen.
Im entsprechenden Reading steht die zuletzt aufgerufene Szene.

Die Zuordnung zwischen sceneID und scene sieht man in den Internals unter scenes.

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Bei vielen aktuellen Geräten lässt sich die Ausführungsgeschwindigkeit (Velocity) variieren. So lässt sich die Geschwindigkeit gegenüber der Default-Geschwindigkeit noch erhöhen oder auch deutlich reduzieren. So ist eine besonders leise Bedienung möglich.

==== Argument DEFAULT, FAST, SILENT ====
Die Velocity kann man bei der Ausführung von Szenen als zusätzliches Argument von set scene oder set sceneID setzen.
Unterstützte Werte sind DEFAULT, FAST und SILENT
:<code>set Velux scene "Alle zu" SILENT</code>
==== Attribut velocity ====
Alternativ kann man im Modul KLF200 das Attribut velocity setzen, das bei der Ausführung von Szenen herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

Hinweis: Dieses Attribut hat keine Auswirkungen auf Befehle, die vom Modul KLF200Node abgesetzt werden.

== Modul KLF200Node ==
Dieses Modul wurde dem Homematic-Modul CUL_HM nachempfunden, da es ebenfalls ein breites Spektrum an Geräten unterstützt
und möglichst kompatibel zu vorhandenen Hilfsmodulen sein soll.
=== Aktueller Status ===
Im Folgenden wird der Zusammenhang zwischen den wichtigsten Readings/Set-Funktionen pct, state, execution erklärt.
==== pct ====
Dieses Reading enthält den aktuell bekannten Status des Gerätes in Prozent.

Wird das Gerät über die KLF-200-Box gesteuert, wird das Reading beim Erreichen der Zielposition sofort aktualisiert.

Wird das Gerät über eine Fernbedienung oder einen Sensor gesteuert, kann sich die Aktualisierung wenige Minuten verzögern.

Mit der Set-Funktion kann man das Gerät in diesen Status versetzen.
Per Default entspricht 100 auf der Fernbedienung oben und 0 unten.
==== state ====
Dieses Reading entspricht dem Reading pct, mit der Ausnahme, dass 0 durch off ersetzt wird und 100 durch on.

Die Set-Funktion funktioniert analog.
Per Default entspricht on auf der Fernbedienung oben und off unten.
==== execution ====
Dieses Reading gibt den aktuellen Ausführungsstatus wieder. Die meiste Zeit ist der Wert stop.
Wird gerade ein Befehl ausgeführt, ist der Wert up oder down.

Mit der Set-Funktion werden entsprechende Befehle ausgeführt, up entspricht auf der Fernbedienung oben und down unten.
Bei stop wird die aktuelle Ausführung angehalten.

==== Attribut directionOn ====
Wie oben beschrieben, entspricht per Default on = 100 = up.

Das kann bei bestimmten Geräten für manchen Nutzer verwirrend sein.
Wenn man z.B. bei einem Rollladen lieber im geschlossenen Zustand 100 Prozent sehen möchte, dann setzt man das Attribut directionOn, z.B.
:<code>attr Velux_2 directionOn down</code>

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Wie bei Szenen lässt sich auch bei Kommandos auf KLF200Node die Ausführungsgeschwindigkeit beeinflussen, soweit das vom Gerät unterstützt ist.
==== Reading velocity ====
Dieses Reading hat den Wert supported, wenn die Geschwindigkeit bei diesem Gerät geändert werden kann.
Selbst bei Not supported wäre es einen Versuch wert, es zu testen.
==== Argument DEFAULT, FAST, SILENT ====
Alle set-Funktionen, die eine Bewegung auslösen unterstützen das optionale Argument DEFAULT, FAST oder SILENT.
==== Attribut velocity ====
Alternativ kann man im Modul KLF200Node das Attribut velocity setzen, das bei der Ausführung von Kommandos herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

=== Begrenzung des Bewegungsradius / Limitation ===
Die io-homecontrol Geräte haben ein Feature eingebaut, um den Bewegungsradius der Geräte einzuschränken, egal von wo aus sie gesteuert werden. Dieses Limitation-Feature ist in dieses FHEM-Modul ebenfalls integriert.
==== limitationMin und limitationMax ====
Mit den Settern und Readings limitationMin und limitationMax kann man die Limitation setzen und auslesen.
Natürlich kann man auch selbst von der Limitation Gebrauch machen. Man kann z.B. einen Rollladen begrenzen, wenn man weiß, dass das Dachfenster weit offen ist. Dann kann der Rollladen nicht gegen das Fenster stoßen, selbst wenn man ihn mit der Fernbedienung bewegt.
==== limiationClear ====
Mit dem Setter limiationClear kann man alle Limitations (auch von fremden Geräten ausgelöste) löschen.
==== updateLimiation ====
Der Setter updateLimiation aktualisiert die Readings limitationMin und limitationMax auf diesem Gerät, falls die Limitation außerhalb von FHEM gesetzt wurde.

=== Auswerten der Regensensoren ===
Die Regensensoren von Velux Fensteröffnern machen von diesem Limitation-Feature Gebrauch. Wenn es regnet, wird der Bewegungsradius der Fenster eingeschränkt. Zum Beispiel (evtl. Geräte-abhängig):
* limitationMax = 7 bei Regen,
* limitationMax = 100 wenn es aufhört.
Diese Werte kann man auslesen, ohne dass sich das Fenster dazu bewegt haben muss.

==== limitationUpdateInterval ====
Mit set limitationUpdateInterval kann man festlegen, wie oft diese Werte ausgelesen werden:
* off: Dieser Wert ist für Geräte ohne integrierte Sensoren der Beste, denn zusätzliche Updates sind überflüssig.
* onChange: Hier wird limitationMin und limitationMax aktualisiert, wenn das Gerät bewegt wurde.
* interval in s: Ein Poll-Intervall in Sekunden. Tests mit 120 sind erfolgreich durchgelaufen. Dieser Wert ist vielleicht etwas übertrieben, man denke an das Funkfeuer und den Akku der Geräte. Ein Intervall von 600 ist vielleicht sinnvoller. Beispiele:
:<code>set Velux_1 limitationUpdateInterval off</code>
:<code>set Velux_2 limitationUpdateInterval onChange</code>
:<code>set Velux_3 limitationUpdateInterval 600</code>

==== Extra Reading für den Regensensor ====
Wem die Auswertung vom Reading limitationMax zu indirekt ist, der kann sich ein neues Reading anlegen.
Der folgende Code legt ein Reading namens sensor an, die Werte sind im Beipiel "Regen" oder "trocken".
Es besteht die Annahme, dass bei limitationMax = 7 der Regensensor angeschlagen hat.
:<code>attr Velux_3 userReadings sensor {(ReadingsVal($name,"limitationMax",100) == 7)?"Regen":"trocken"}</code>
Hinweis: Das neue Reading sensor erscheint erst, wenn das Reading limitationMax einmal aktualisiert wurde.

== Vorschläge zur schöneren Darstellung ==
Wie Homematic-Geräte kommt KLF200Node im FHEM-Web sehr schlicht daher. Dieses Kapitel gibt Vorschläge zur Konfiguration einer schöneren Darstellung.

=== Rollladen ===
Dieses Beispiel stellt den Status des Rollladen 10-Prozent genau im Icon dar. Bewegen sich der Rollladen, hat das Icon einen Pfeil nach oben oder unten. Ein Klick auf das Icon setzt den Rollladen in Bewegung oder hält ihn an (toggle).

:<code>attr Velux_2 stateFormat pct execution</code>
:<code>attr Velux_2 devStateIcon .*up:fts_shutter_up:toggle .*down:fts_shutter_down:toggle \d.stop:fts_shutter_100:toggle 1\d.stop:fts_shutter_90:toggle 2\d.stop:fts_shutter_80:toggle 3\d.stop:fts_shutter_70:toggle 4\d.stop:fts_shutter_60:toggle 5\d.stop:fts_shutter_50:toggle 6\d.stop:fts_shutter_40:toggle 7\d.stop:fts_shutter_30:toggle 8\d.stop:fts_shutter_20:toggle 9\d.stop:fts_shutter_10:toggle 100.stop:fts_window_2w:toggle</code>
[[Datei:RollerShutterUpDown.png|300px|Rollladen mit Pfeilen]]

So erhält man einen Slider für die Rollladenposition:

:<code>attr Velux_2 webCmd pct</code>

=== Dachschrägenfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachschrägenfenster in drei Stufen dar:

0% - 9%: geschlossen

10% - 59%: halb geöffnet

60% - 100%: ganz geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_4 limitationUpdateInterval 600</code>
:<code>attr Velux_4 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_4 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7\).*:weather_rain:toggle \d.$.*:fts_window_roof:toggle [1-5]\d.\(.*:fts_window_roof_open_1:toggle [6-9]\d.\(.*:fts_window_roof_open_2:toggle 100.\(.*:fts_window_roof_open_2:toggle</code>

=== Dachkuppelfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachkuppelfenster in zwei Stufen dar:

0% - 9%: geschlossen

10% - 100%: geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_5 limitationUpdateInterval 600</code>
:<code>attr Velux_5 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_5 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7$.*:weather_rain:toggle \d.\(.*:fts_light_dome:toggle [1-9]\d.\(.*:fts_light_dome_open:toggle 100.\(.*:fts_light_dome_open:toggle</code>

== Problembehebung ==
Sollte es zu Verbindungsabbrüchen zwischen FHEM und der KLF200-Box kommen, dann sind folgende Dinge zu überprüfen:
=== FHEM Update ===
Ist FHEM aktuell? Am 18.12.2018 gab es ein wichtiges FHEM-Update, das die Stabilität von SSL-Verbindungen wesentlich verbessert hat.
=== OpenSSL ===
OpenSLL sollte immer aktuell sein.
=== Perl SSL-Bibliotheken ===
Wenn die Perl SSL-Bibliotheken zu alt sind, ist das oben genannte FHEM-Update wirkungslos.
* IO::Socket::SSL
* Net::SSL
* Net::SSLeay
* Net::SSLeay::Handle
* Crypt::SSLeay
* Net::Server::Proto::SSL
== Links ==
* Support im Forum gibt es unter {{Link2Forum|Topic=92907|LinkText=Velux KLF200 mit Firmware 2.0.0.71 für io-homecontrol}}
* Github: [https://github.com/buennerbernd/fhem/tree/master/KLF200/2.0 FHEM modules KLF200 and KLF200Node]

[[Kategorie:Rollladensteuerung]]
[[Kategorie:Other Components]]

Velux KLF200

2019-03-15T09:07:25Z

Buennerbernd: /* Vorschläge zur schöneren Darstellung */

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Anbindung io-homecontrol Aktoren an FHEM
|ModType=x
|ModCmdRef=KLF200
|ModFTopic=92907
|ModTechName=83_KLF200.pm
|ModOwner=buennerbernd ({{Link2FU|21440|Forum}} / [[Benutzer Diskussion:Buennerbernd|Wiki]])
}}

[[KLF200]] ist ein Modul zur Steuerung von io-homecontrol Aktoren über das Gateway Velux KLF 200.

== Velux KLF 200 ==

Die KLF-200-Box ist über LAN mit FHEM verbunden und steuert die Aktoren über das verschlüsselte Funkprotokoll io-homecontrol.
Die Aktoren geben Rückmeldung über ihren aktuellen Zustand.

Die Box hat 10 elektrische Eingänge mit denen man 5 Geräte oder Gerätegruppen steuern kann.
Damit kann man z.B. mit Doppeltastern an der Wand seine Rollladen oder Fenster steuern.
Über den LAN-Anschluss lassen sich mit FHEM bis zu 200 Geräte mit einer KLF 200 verwalten.

Das Modul erfordert die Firmware-Version 2.0.0.71 und basiert auf der dokumentierten API von Velux. [https://www.velux.com/api/klf200 Download und weitere Informationen]

Das Gateway hat keine Cloud-Integration.

== Unterstützte Geräte ==

Grundsätzlich sollten alle io-homecontrol Aktoren funktionieren. Alleinstehende Sensoren (z.B. Lichtsensor, Windsensor) werden
von der KLF-200-Box nicht unterstützt. Es besteht aber die Möglichkeit, den Status von Sensoren auszuwerten, die in Aktoren integriert sind.

Aktuell werden folgende Geräte erfolgreich mit diesem Modul verwendet:

* Rollladen:
** VELUX SML
** VELUX SSL
** Somfy Oximo io
* Sichtschutz innen:
** VELUX FSK
* Fensteröffner mit integriertem Regensensor:
** VELUX KMG
** VELUX CVP
** VELUX KSX

== Benutzung in FHEM ==
=== Verbereitung ===
Bevor die Aktoren in FHEM verwendet werden können, müssen sie in der KLF 200 angelernt werden.
Das geschieht über das WebUI der KLF 200, das über einen Wifi-Hotspot erreichbar ist. Dieser Vorgang ist im Handbuch beschrieben.
Im WebUI können die angeschlossenen Geräte auch benannt werden. Zusätzlich hat man die Möglichkeit, Programme (Szenen) aufzuzeichnen,
um ein oder mehrere Geräte in eine definierte Position zu bringen. Diese Szenen kann man aus FHEM ebenfalls ansteuern.

Das Modul wird momentan noch nicht über FHEM ausgeliefert.
Es wird wie folgt geladen und aktualisiert:

:<code>update all <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>
:<code>shutdown restart</code>

Mit diesem Befehl wird das Modul so eingerichtet, dass es ebenfalls aktualisiert wird, wenn man FHEM aktualisiert:
:<code>update add <nowiki>https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt</nowiki></code>

=== Anlegen der Geräte ===
:<code>define <name> KLF200 <host></code>
Beispiel:
:<code>define Velux KLF200 192.168.0.66</code>

Danach Login durch Eingabe des Passwortes:
:<code>set <name> login <password></code>

Hinweis: Das Passwort ist laut Dokumentation das Wifi-Passwort, das auf den Boden der Box gedruckt ist.
Das funktioniert bei einigen Nutzern. Bei vielen Nutzern funktioniert hingegen das Passwort des WebUI.
Scheinbar hängt das davon ab, mit welcher Firmware die Box ausgeliefert wurde und ob schon einmal ein Reset durchgeführt wurde.
Das Passwort wird verschleiert im FHEM-Backend gespeichert. Es muss nach erfolgreichem Login nicht mehr eingegeben werden.

Die angeschlossenen Aktoren werden jetzt durch autocreate als Instanzen von KLF200Node im Raum KLF200Node angelegt.
Die Namen der Geräte folgen dem Muster <name>_<NodeID>.
Wurde im WebUI der KLF200 ein Name für das Gerät vergeben dann wird dieser als Alias übernommen.

Die Geräte sind jetzt einsatzbereit.

== Modul KLF200 ==
=== Verbindungsstatus ===
==== STATE ====
Im STATE des Moduls sieht man den aktuellen Verbindungsstatus. Im Idealfall ist er nach der Initialisierung Logged in.
=== Ausführung von Programmen (Szenen) ===
Obwohl man mit dem Modul KLF200Node jedes Gerät unabhängig und auch gleichzeitig steuern kann, sind Szenen eine nützliche Ergänzung. So kann man mit Szenen wie "Alle zu" oder "Alle auf" viele Geräte gleichzeitig mit einem Befehl bedienen.

Hinweis: Während der Abarbeitung einer Szene werden weitere Befehle gepuffert.
==== scene/sceneID ====
Mit diesen Set-Funktionen kann man eine aufgezeichnete Szene aufrufen.
Im entsprechenden Reading steht die zuletzt aufgerufene Szene.

Die Zuordnung zwischen sceneID und scene sieht man in den Internals unter scenes.

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Bei vielen aktuellen Geräten lässt sich die Ausführungsgeschwindigkeit (Velocity) variieren. So lässt sich die Geschwindigkeit gegenüber der Default-Geschwindigkeit noch erhöhen oder auch deutlich reduzieren. So ist eine besonders leise Bedienung möglich.

==== Argument DEFAULT, FAST, SILENT ====
Die Velocity kann man bei der Ausführung von Szenen als zusätzliches Argument von set scene oder set sceneID setzen.
Unterstützte Werte sind DEFAULT, FAST und SILENT
:<code>set Velux scene "Alle zu" SILENT</code>
==== Attribut velocity ====
Alternativ kann man im Modul KLF200 das Attribut velocity setzen, das bei der Ausführung von Szenen herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

Hinweis: Dieses Attribut hat keine Auswirkungen auf Befehle, die vom Modul KLF200Node abgesetzt werden.

== Modul KLF200Node ==
Dieses Modul wurde dem Homematic-Modul CUL_HM nachempfunden, da es ebenfalls ein breites Spektrum an Geräten unterstützt
und möglichst kompatibel zu vorhandenen Hilfsmodulen sein soll.
=== Aktueller Status ===
Im Folgenden wird der Zusammenhang zwischen den wichtigsten Readings/Set-Funktionen pct, state, execution erklärt.
==== pct ====
Dieses Reading enthält den aktuell bekannten Status des Gerätes in Prozent.

Wird das Gerät über die KLF-200-Box gesteuert, wird das Reading beim Erreichen der Zielposition sofort aktualisiert.

Wird das Gerät über eine Fernbedienung oder einen Sensor gesteuert, kann sich die Aktualisierung wenige Minuten verzögern.

Mit der Set-Funktion kann man das Gerät in diesen Status versetzen.
Per Default entspricht 100 auf der Fernbedienung oben und 0 unten.
==== state ====
Dieses Reading entspricht dem Reading pct, mit der Ausnahme, dass 0 durch off ersetzt wird und 100 durch on.

Die Set-Funktion funktioniert analog.
Per Default entspricht on auf der Fernbedienung oben und off unten.
==== execution ====
Dieses Reading gibt den aktuellen Ausführungsstatus wieder. Die meiste Zeit ist der Wert stop.
Wird gerade ein Befehl ausgeführt, ist der Wert up oder down.

Mit der Set-Funktion werden entsprechende Befehle ausgeführt, up entspricht auf der Fernbedienung oben und down unten.
Bei stop wird die aktuelle Ausführung angehalten.

==== Attribut directionOn ====
Wie oben beschrieben, entspricht per Default on = 100 = up.

Das kann bei bestimmten Geräten für manchen Nutzer verwirrend sein.
Wenn man z.B. bei einem Rollladen lieber im geschlossenen Zustand 100 Prozent sehen möchte, dann setzt man das Attribut directionOn, z.B.
:<code>attr Velux_2 directionOn down</code>

=== Ausführungsgeschwindigkeit: Schnell, Flüstermodus ===
Wie bei Szenen lässt sich auch bei Kommandos auf KLF200Node die Ausführungsgeschwindigkeit beeinflussen, soweit das vom Gerät unterstützt ist.
==== Reading velocity ====
Dieses Reading hat den Wert supported, wenn die Geschwindigkeit bei diesem Gerät geändert werden kann.
Selbst bei Not supported wäre es einen Versuch wert, es zu testen.
==== Argument DEFAULT, FAST, SILENT ====
Alle set-Funktionen, die eine Bewegung auslösen unterstützen das optionale Argument DEFAULT, FAST oder SILENT.
==== Attribut velocity ====
Alternativ kann man im Modul KLF200Node das Attribut velocity setzen, das bei der Ausführung von Kommandos herangezogen wird, wenn das oben genannte Argument nicht gesetzt ist.

=== Begrenzung des Bewegungsradius / Limitation ===
Die io-homecontrol Geräte haben ein Feature eingebaut, um den Bewegungsradius der Geräte einzuschränken, egal von wo aus sie gesteuert werden. Dieses Limitation-Feature ist in dieses FHEM-Modul ebenfalls integriert.
==== limitationMin und limitationMax ====
Mit den Settern und Readings limitationMin und limitationMax kann man die Limitation setzen und auslesen.
Natürlich kann man auch selbst von der Limitation Gebrauch machen. Man kann z.B. einen Rollladen begrenzen, wenn man weiß, dass das Dachfenster weit offen ist. Dann kann der Rollladen nicht gegen das Fenster stoßen, selbst wenn man ihn mit der Fernbedienung bewegt.
==== limiationClear ====
Mit dem Setter limiationClear kann man alle Limitations (auch von fremden Geräten ausgelöste) löschen.
==== updateLimiation ====
Der Setter updateLimiation aktualisiert die Readings limitationMin und limitationMax auf diesem Gerät, falls die Limitation außerhalb von FHEM gesetzt wurde.

=== Auswerten der Regensensoren ===
Die Regensensoren von Velux Fensteröffnern machen von diesem Limitation-Feature Gebrauch. Wenn es regnet, wird der Bewegungsradius der Fenster eingeschränkt. Zum Beispiel (evtl. Geräte-abhängig):
* limitationMax = 7 bei Regen,
* limitationMax = 100 wenn es aufhört.
Diese Werte kann man auslesen, ohne dass sich das Fenster dazu bewegt haben muss.

==== limitationUpdateInterval ====
Mit set limitationUpdateInterval kann man festlegen, wie oft diese Werte ausgelesen werden:
* off: Dieser Wert ist für Geräte ohne integrierte Sensoren der Beste, denn zusätzliche Updates sind überflüssig.
* onChange: Hier wird limitationMin und limitationMax aktualisiert, wenn das Gerät bewegt wurde.
* interval in s: Ein Poll-Intervall in Sekunden. Tests mit 120 sind erfolgreich durchgelaufen. Dieser Wert ist vielleicht etwas übertrieben, man denke an das Funkfeuer und den Akku der Geräte. Ein Intervall von 600 ist vielleicht sinnvoller. Beispiele:
:<code>set Velux_1 limitationUpdateInterval off</code>
:<code>set Velux_2 limitationUpdateInterval onChange</code>
:<code>set Velux_3 limitationUpdateInterval 600</code>

==== Extra Reading für den Regensensor ====
Wem die Auswertung vom Reading limitationMax zu indirekt ist, der kann sich ein neues Reading anlegen.
Der folgende Code legt ein Reading namens sensor an, die Werte sind im Beipiel "Regen" oder "trocken".
Es besteht die Annahme, dass bei limitationMax = 7 der Regensensor angeschlagen hat.
:<code>attr Velux_3 userReadings sensor {(ReadingsVal($name,"limitationMax",100) == 7)?"Regen":"trocken"}</code>
Hinweis: Das neue Reading sensor erscheint erst, wenn das Reading limitationMax einmal aktualisiert wurde.

== Vorschläge zur schöneren Darstellung ==
Wie Homematic-Geräte kommt KLF200Node im FHEM-Web sehr schlicht daher. Dieses Kapitel gibt Vorschläge zur Konfiguration einer schöneren Darstellung.

=== Rollladen ===
Dieses Beispiel stellt den Status des Rollladen 10-Prozent genau im Icon dar. Bewegen sich der Rollladen, hat das Icon einen Pfeil nach oben oder unten. Ein Klick auf das Icon setzt den Rollladen in Bewegung oder hält ihn an (toggle).

:<code>attr Velux_2 stateFormat pct execution</code>
:<code>attr Velux_2 devStateIcon .*up:fts_shutter_up:toggle .*down:fts_shutter_down:toggle \d.stop:fts_shutter_100:toggle 1\d.stop:fts_shutter_90:toggle 2\d.stop:fts_shutter_80:toggle 3\d.stop:fts_shutter_70:toggle 4\d.stop:fts_shutter_60:toggle 5\d.stop:fts_shutter_50:toggle 6\d.stop:fts_shutter_40:toggle 7\d.stop:fts_shutter_30:toggle 8\d.stop:fts_shutter_20:toggle 9\d.stop:fts_shutter_10:toggle 100.stop:fts_window_2w:toggle</code>
[[Datei:RollerShutterUpDown.png|300px|Rollladen mit Pfeilen]]

So erhält man einen Slider für die Rollladenposition:

:<code>attr Velux_2 webCmd pct</code>

=== Dachschrägenfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachschrägenfenster in drei Stufen dar:

0% - 9%: geschlossen

10% - 59%: halb geöffnet

60% - 100%: ganz geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_4 limitationUpdateInterval 600</code>
:<code>attr Velux_4 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_4 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7\).*:weather_rain:toggle \d.$.*:fts_window_roof:toggle [1-5]\d.\(.*:fts_window_roof_open_1:toggle [6-9]\d.\(.*:fts_window_roof_open_2:toggle 100.\(.*:fts_window_roof_open_2:toggle</code>

=== Dachkuppelfenster mit Regensensor ===
Dieses Beispiel stellt ein Dachkuppelfenster in zwei Stufen dar:

0% - 9%: geschlossen

10% - 100%: geöffnet

Bei Bewegung erscheint ein Pfeil nach oben bzw. nach unten.

Wenn es regnet, erscheint eine Regenwolke. (limitationMax = 7)

Ein Klick auf das Icon setzt das Fenster in Bewegung oder hält es an (toggle).
:<code>set Velux_5 limitationUpdateInterval 600</code>
:<code>attr Velux_5 stateFormat pct (limitationMin - limitationMax) execution</code>
:<code>attr Velux_5 devStateIcon .*up:control_arrow_up:toggle .*down:control_arrow_down:toggle .*-.7$.*:weather_rain:toggle \d.\(.*:fts_light_dome:toggle [1-9]\d.\(.*:fts_light_dome_open:toggle 100.\(.*:fts_light_dome_open:toggle</code>

== Links ==
* Support im Forum gibt es unter {{Link2Forum|Topic=92907|LinkText=Velux KLF200 mit Firmware 2.0.0.71 für io-homecontrol}}
* Github: [https://github.com/buennerbernd/fhem/tree/master/KLF200/2.0 FHEM modules KLF200 and KLF200Node]

[[Kategorie:Rollladensteuerung]]
[[Kategorie:Other Components]]

Velux KLF200

2019-03-13T16:06:01Z

Buennerbernd:

Datei:RollerShutterUpDown.png

2019-03-13T15:58:16Z

Buennerbernd: devStateIcon für Rollladen mit Pfeilen bei aktueller Bewegung.

== Beschreibung ==
devStateIcon für Rollladen mit Pfeilen bei aktueller Bewegung.

Velux KLF200

2019-03-11T13:54:50Z

Buennerbernd:

Velux KLF200

2019-03-08T13:40:09Z

Buennerbernd: /* Modul KLF200 */

Velux KLF200

2019-03-04T20:44:23Z

Buennerbernd:

Velux KLF200

2019-03-03T20:52:48Z

Buennerbernd:

Velux KLF200

2019-03-03T20:28:51Z

Buennerbernd:

Velux KLF200

2019-03-01T08:53:02Z

Buennerbernd:

Velux KLF200

2019-02-28T21:42:41Z

Buennerbernd:

{{Baustelle}}
{{Infobox Modul
|ModPurpose=Anbindung io-homecontrol Aktoren an FHEM
|ModType=d
|ModCmdRef=KLF200
|ModForumArea=
|ModTechName=83_KLF200.pm
|ModOwner=buennerbernd ([https://forum.fhem.de/index.php?action=profile;u=21440 Forum] / [[Benutzer Diskussion:Buennerbernd|Wiki]])
}}

[[KLF200]] ist ein Modul zur Steuerung von io-homecontrol Aktoren über das Gateway Velux KLF 200.

== Velux KLF 200 ==

Die KLF-200-Box ist über LAN mit FHEM verbunden und steuert die Aktoren über das verschlüsselte Funkprotokoll io-homecontrol.
Die Aktoren geben Rückmeldung über ihren aktuellen Zustand.

Die Box hat 10 elektrische Eingänge mit denen man 5 Geräte oder Gerätegruppen steuern kann.
Damit kann man z.B. mit Doppeltastern an der Wand seine Rollladen oder Fenster steuern.
Über den LAN-Anschluss lassen sich mit FHEM bis zu 200 Geräte mit einer KLF 200 verwalten.

Das Modul erfordert die Firmware-Version 2.0.0.71 und basiert auf der dokumentierten API von Velux. [https://www.velux.com/api/klf200 Download und weitere Informationen]

Das Gateway hat keine Cloud-Integration.

== Unterstützte Geräte ==

Grundsätzlich sollten alle io-homecontrol Aktorenfunktionieren. Alleinstehende Sensoren (z.B. Lichtsensor, Windsensor) werden
von der KLF-200-Box nicht unterstützt. Es besteht aber die Möglichkeit, den Status von Sensoren auszuwerten, die in Aktoren integriert sind.

Aktuell werden folgende Geräte erfolgreich mit diesem Modul verwendet:

* Rollladen:
** VELUX SML
** VELUX SSL
** Somfy Oximo io
* Sichtschutz innen:
** VELUX FSK
* Fensteröffner mit integriertem Regensensor:
** VELUX KMG
** VELUX CVP
** VELUX KSX

== Benutzung in FHEM ==
=== Verbereitung ===
Bevor die Aktoren in FHEM verwendet werden können, müssen sie in der KLF 200 angelernt werden.
Das geschieht über das WebUI der KLF 200, das über einen Wifi-Hotspot erreichbar ist. Dieser Vorgang ist im Handbuch beschrieben.
Im WebUI können die angeschlossenen Geräte auch benannt werden. Zusätzlich hat man die Möglichkeit, Programme (Szenen) aufzuzeichnen,
um ein oder mehrere Geräte in eine definierte Position zu bringen. Diese Szenen kann man aus FHEM ebenfalls ansteuern.

Das Modul wird momentan noch nicht über FHEM ausgeliefert.
Es wird wie folgt geladen und aktualisiert:

<pre>
update all https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt
shutdown restart
</pre>

Mit diesem Befehl wird das Modul so eingerichtet, dass es ebenfalls aktualisiert wird, wenn man FHEM aktualisiert:
<pre>
update add https://raw.githubusercontent.com/buennerbernd/fhem/master/KLF200/2.0/controls_KLF200.txt
</pre>

=== Anlegen der Geräte ===
<pre>
define <name> KLF200 <host>
</pre>
Beispiel:
<pre>
define Velux KLF200 192.168.0.66
</pre>

Danach Login durch Eingabe des Passwortes:
<pre>
set <name> login <password>
</pre>

Hinweis: Das Passwort ist laut Dokumentation das Wifi-Passwort, das auf den Boden der Box gedruckt ist.
Das funktioniert bei einigen Nutzern. Bei vielen Nutzern funktioniert hingegen das Passwort des WebUI.
Scheinbar hängt das davon ab, mit welcher Firmware die Box ausgeliefert wurde und ob schon einmal ein Reset durchgeführt wurde.
Das Passwort wird verschleiert im FHEM-Backend gespeichert. Es muss nach erfolgreichem Login nicht mehr eingegeben werden.

Die angeschlossenen Aktoren werden jetzt durch autocreate als Instanzen von KLF200Node im Raum KLF200Node angelegt.
Die Namen der Geräte folgen dem Muster <name>_<NodeID>.
Wurde im WebUI der KLF200 ein Name für das Gerät vergeben dann wird dieser als Alias übernommen.

Die Geräte sind jetzt einsatzbereit.

== Modul KLF200 ==
=== STATE ===
Im STATE des Moduls sieht man den aktuellen Verbindungsstatus. Im Idealfall ist er nach der Initialisierung Logged in.
=== scene/sceneID ===
Mit diesen Set-Funktionen kann man eine aufgezeichnete Szene aufrufen.
Im entsprechenden Reading steht die zuletzt aufgerufene Szene.

== Modul KLF200Node ==
Dieses Modul wurde dem Homematic-Modul CUL_HM nachempfunden, da es ebenfalls ein breites Spektrum an Geräten unterstützt
und möglichst kompatibel zu vorhandenen Hilfsmodulen sein soll.
Im Folgenden wird der Zusammenhang zwischen den wichtigsten Readings/Set-Funktionen pct, state, execution erklärt.
=== pct ===
Dieses Reading enthält den aktuell bekannten Status des Gerätes in Prozent.

Mit der Set-Funktion kann man das Gerät in diesen Status versetzen.
Per Default entspricht 100 auf der Fernbedienung oben und 0 unten.
=== state ===
Dieses Reading entspricht dem Reading pct, mit der Ausnahme, dass 0 durch off ersetzt wird und 100 durch on.

Die Set-Funktion funktioniert analog.
Per Default entspricht on auf der Fernbedienung oben und off unten.
=== execution ===
Dieses Reading gibt den aktuellen Ausführungsstatus wieder. Die meiste Zeit ist der Wert stop.
Wird gerade ein Befehl ausgeführt, ist der Wert up oder down.

Mit der Set-Funktion werden entsprechende Befehle ausgeführt, up entspricht auf der Fernbedienung oben und down unten.
Bei stop wird die aktuelle Ausführung angehalten.

== Links ==
Support im Forum gibt es unter [https://forum.fhem.de/index.php/topic,92907.0.html Velux KLF200 mit Firmware 2.0.0.71 für io-homecontrol]

Github: [https://github.com/buennerbernd/fhem/tree/master/KLF200/2.0 FHEM modules KLF200 and KLF200Node]

[[Kategorie:Rollladensteuerung]]
[[Kategorie:Other Components]]

Velux KLF200

2019-02-28T20:11:28Z

Buennerbernd:

Velux KLF200

2019-02-28T11:59:25Z

Buennerbernd:

Velux KLF200

2019-02-27T21:51:18Z

Buennerbernd:

Velux KLF200

2019-02-27T21:28:08Z

Buennerbernd: Die Seite wurde neu angelegt: „{{Baustelle}} {{Infobox Modul |ModPurpose=Anbindung io-homecontrol Aktoren an FHEM |ModType=d |ModCmdRef=KLF200 |ModForumArea= |ModTechName=83_KLF200.pm |ModO…“

Velux KUX 100

2019-02-27T21:26:53Z

Buennerbernd:

==Vorwort==
Wird ein VELUX Rolladen neu eingebaut und man hat die Absicht diesen mit FHEM zu steuern so sollte zwingend darauf geachtet werden KEINE Steuerbox (zb. KLF-100) anzuschließen. Auch nicht mal zu testen. Hat der Rollen einmal solche Steuerbox erkannt, schaltet er intern auf diesen SteuerboxModus um und ist nicht mehr per Polumschaltung steuerbar!

Wenn der Rolladen im SteuerboxModus ist, muss hier weitergelesen werden.

==Wenn VELUX io-homecontrol bereits genutzt wird==
Einbindung von Velux io-homecontrol Rollos (Velux KUX 100) lässt sich ohne Weiteres nicht mit FHEM erreichen.

-> Velux hat den [[KLF200]] als "Schnittstelle für VELUX INTEGRA® Produkte (Verfügbar ab Dezember 2016)" angekündigt. Eine einfache Lösung naht also.
Bei mir habe ich folgende Lösung in der Umsetzung:
Die originalen Handsender der KUX100 werden zerlegt. Die 3 Kontakte für Auf - Stop - Ab werden mit 3 Relais verbunden.
Die Relais wiederum werden von einem FS20 SM8 Modul geschaltet.

Die notwendigen Auslöseschritte für das Auf - Ab Schalten der Relais werden dann in einem neuen FS20 Dummy Device zusammengefasst.

Anbei der Code aus meiner Fhem.cfg für 1 Rollo.

Update 04-Mai-2012:
Die 50% Auf und Ab Lösung mit Verwendung der Sleep Funktion bereitete einige Probleme, daher hier eine angepasste Version mit "Notify at" anstatt Sleep, um die Rollo Auf/Ab Bewegung nach einer definierten Zeit zu stoppen.

Der Aufruf mehrerer verketteter Rollo Auf Aufrufe funktioniert dann auch wieder (war mit Sleep schwierig).

<nowiki># ---------- START Definition Schlafzimmer_Oben_Nord ROLLLADEN -------------
# Definition Schalter AUF Adresse vom FS20 SM8 - Kanal1 / Über Relais den "Auf" Schalter der OriginalFernbedienung schalten
define RS_SZO_N_Auf FS20 ab01 00
attr RS_SZO_N_Auf IODev CUNO_O
attr RS_SZO_N_Auf model fs20
attr RS_SZO_N_Auf room 5_SYSTEM
# Definition Schalter AB Adresse vom FS20 SM8 - Kanal2 / Über Relais den "Ab" Schalter der OriginalFernbedienung schalten
define RS_SZO_N_Ab FS20 ab02 00
attr RS_SZO_N_Ab IODev CUNO_O
attr RS_SZO_N_Ab model fs20
attr RS_SZO_N_Ab room 5_SYSTEM
# Definition Schalter STOP Adresse vom FS20 SM8 - Kanal3 / Über Relais den "Stop" Schalter der OriginalFernbedienung schalten
define RS_SZO_N_Stop FS20 ab03 00
attr RS_SZO_N_Stop IODev CUNO_O
attr RS_SZO_N_Stop model fs20
attr RS_SZO_N_Stop room 5_SYSTEM
# Definition eines Dummy FS20 der im entsprechenden Raum (OG) angezeigt wird, und die Schaltvorgänge triggert
#define Rollo_SchlafZ_O_N FS20 f1f1 00
define Rollo_SchlafZ_O_N dummy
attr Rollo_SchlafZ_O_N eventMap /on:Ab/off:Auf/dim06%:Ab50/dim93%:Auf50/
attr Rollo_SchlafZ_O_N room 2_ROLLLADEN
attr Rollo_SchlafZ_O_N webCmd Ab:Auf:Ab50:Auf50
#Rollo AB 100% - AB Taste 1 Sekunde auslösen
define RSZO_N_Ab notify Rollo_SchlafZ_O_N.on set RS_SZO_N_Ab on-for-timer 1
attr RSZO_N_Ab room 5_SYSTEM
#Rollo AUF 100% - AUF Taste 1 Sekunde auslösen
define RSZO_N_Auf notify Rollo_SchlafZ_O_N.off set RS_SZO_N_Auf on-for-timer 1
attr RSZO_N_Auf room 5_SYSTEM
#Rollo AB50% - 15 Sekunden Rolladen Abwärts - ggf. die Sleep Zeit anpassen
define RSZO_N_Ab50 notify Rollo_SchlafZ_O_N.dim06% {\
fhem "set RS_SZO_N_Ab on-for-timer 1";;\
fhem "define Rollo_SZO_N_Stop at +*{1}00:00:41 set RS_SZO_N_Stop on-for-timer 1";;\
fhem "attr Rollo_SZO_N_Stop room 5_SYSTEM";;\
}
attr RSZO_N_Ab50 room 5_SYSTEM
#Rollo AUF50% - 15 Sekunden Rolladen Aufwärts - ggf. die Sleep Zeit anpassen
define RSZO_N_Auf50 notify Rollo_SchlafZ_O_N.dim93% {\
fhem "set RS_SZO_N_Auf on-for-timer 1";;\
fhem "define Rollo_SZO_N_Stop at +*{1}00:00:30 set RS_SZO_N_Stop on-for-timer 1";;\
fhem "attr Rollo_SZO_N_Stop room 5_SYSTEM";;\
}
attr RSZO_N_Auf50 room 5_SYSTEM
# ---------- ENDE Definition Schlafzimmer_Oben_Nord ROLLLADEN -------------
# ---------- Routine um mehrere Rollos zeitversetzt nach Sunrise / Sunset Notify zu steuern (um SM8 Befehle zeitlich zu entspannen).
define Rollladen_OG_Morgens_Auf at *{sunrise(-210,'05:30','08:00')} {\
fhem "set Rollo_ArbeitsZ Auf50%";;\
fhem "define Rollladen_OG_Morgens_Timer_N at +*{1}00:00:30 set Rollo_SchlafZ_O_N Auf50";;\
fhem "attr Rollladen_OG_Morgens_Timer_N room 5_SYSTEM";;\
fhem "define Rollladen_OG_Morgens_Timer_SL at +*{1}00:01:00 set Rollo_SchlafZ_O_SL Auf50";;\
fhem "attr Rollladen_OG_Morgens_Timer_SL room 5_SYSTEM";;\
fhem "define Rollladen_OG_Morgens_Timer_SR at +*{1}00:01:30 set Rollo_SchlafZ_O_SR Auf50";;\
fhem "attr Rollladen_OG_Morgens_Timer_SR room 5_SYSTEM";;\
}
attr Rollladen_OG_Morgens_Auf room 2_ROLLLADEN
define Rollladen_OG_Abends_Ab at *{sunset(330,'19:00','22:00')} {\
fhem "set Rollo_ArbeitsZ Ab";;\
fhem "define Rollladen_OG_Morgens_Timer_N at +*{1}00:00:30 set Rollo_SchlafZ_O_N Ab";;\
fhem "attr Rollladen_OG_Morgens_Timer_N room 5_SYSTEM";;\
fhem "define Rollladen_OG_Morgens_Timer_SL at +*{1}00:01:00 set Rollo_SchlafZ_O_SL Ab";;\
fhem "attr Rollladen_OG_Morgens_TimerSL room 5_SYSTEM";;\
fhem "define Rollladen_OG_Morgens_Timer_SR at +*{1}00:01:30 set Rollo_SchlafZ_O_SR Ab";;\
fhem "attr Rollladen_OG_Morgens_Timer_SR room 5_SYSTEM";;\
}
attr Rollladen_OG_Abends_Ab room 2_ROLLLADEN</nowiki>

[[Kategorie:Code Snippets]]
[[Kategorie:Rollladensteuerung]]
[[Kategorie:Other Components]]