Garagentorsteuerung

Aufgabe:

Es soll ein Garagentor geschaltet werden. Die toreigene Steuerung kennt keinen absoluten Zustand, das Betätigen eines Tasters öffnet das Tor wenn es zu ist und schliesst es, wenn es offen ist. Mit FHEM soll die Möglichkeit geschaffen werden, das Tor in einen definierten Zustand zu bringen. Der Garagentormotor ist so konstruiert, dass eine kurzers Drücken des Tasters ausreicht um den Schliess- Öffenvorgang auszulösen, der Taster muss nicht gehalten werden bis das Tor auf oder zu ist. Das Tor soll über Schaltflächen auf der Weboberfläche von FHEM betätigt werden.

Voraussetzungen:

Ein Tür/Fensterkontakt, der prüft ob das Tor auf oder zu ist.

Im konkreten Fall sei eine FHT80TF eingesetzt.

Dieser ist zu definieren:

define Einfahrt CUL_FHTTK 3b8823
attr Einfahrt room Aussen

Ausserdem muss der Schaltaktor definiert werden, der auf Funkbefehl den Taster des Garagentormotors betätigt. (im konkreten Fall wurde ein FS20 AS1 eingesetzt)

Die folgenden Beispiele gehen davon aus, dass der Aktor "on-for-timer" beherrscht, dies ist bei FS20 und HomeMatic Aktoren der Fall, nicht aber z.b. bei InterTechno Aktoren.

#------EinfahrtsTor---------------
define tor_sw FS20 11114444 23
attr tor_sw follow-on-for-timer 1

Erläuterungen:

define tor_sw FS20 11114444 23

Der Name "tor_sw" ist frei vergeben und könnte auch z.b. "Garagentor_Schalter" heissen. Der Hauscode der Installation ist 11114444, der Schaltaktor hat die Adresse 23. Dies ist der hexadezimale Wert, der der ELV-Notation 1314 entspricht.

attr tor_sw follow-on-for-timer 1

Weiter unten werden wir für den Aktor " tor_sw FS20 11114444 23" einen Timer definieren, also dafür sorgen, das er für nur eine Sekunde auf ON geschaltet wird. Dies soll den Taster simulieren. Die Anzeige auf dem Webinterface zeigt immer den letzten Schaltzustand. Im Falle eines Timers wäre dieser nach Betätigung "on for timer 1", man könnte am Webinterface also nicht erkennen, ob der FS20 Schalter aktuell aus oder an ist.

"follow-on-for-timer 1" sorgt nun dafür, das die Anzeige im Webinterface nach Ende des Timers wieder korrekt auf "off" geht. Die ist für die eigentliche Funktion unerheblich und dient nur einer besseren Visualisierung des Schaltzustandes im Webinterface. Besonders interessant kann dieses Attribut bei Schaltungen ein, die länger als nur eine paar Sekunden dauern.

Zuletzt müssen Aktionen definiert werden, die als Schalter auf der Weboberfläche von FHEM dienen, bzw. mit einer Fernbedienung ausgelöst werden können.

define Einfahrt_ZU FS20 11114444 de
attr Einfahrt_ZU dummy 1
attr Einfahrt_ZU room Aussen

define Einfahrt_AUF FS20 11114444 da attr Einfahrt_AUF dummy 1 attr Einfahrt_AUF room Aussen

Erläuterungen:

define Einfahrt_ZU FS20 11114444 de

Der Name "Einfahrt_ZU" ist frei vergeben und könnte auch z.b. "Garagentor_Schliessen" heissen. Der Hauscode der Installation ist 11114444, die Aktion hat die Adresse da. Diese Adresse ermöglicht es, die Aktion mittels einer auf diese Adresse programmierten Fernbedienung auszulösen. "de" ist der hexadezimale Wert, der der ELV-Notation 4243 entspricht.

attr Einfahrt_AUF room Aussen

Ordnet die Schalter auf der Weboberfläche dem Raum "Aussen" zu, dieser könnte auch beliebig anders heissen, er dient nur der Übersichtlichkeit.

dummy bewirkt, das beim Betätigen des Schalters auf der Weboberfläche keine Funksignal gesendet wird.Dies ist nicht erwünscht, da "Einfahrt_ZU" erst im folgenden die eigentlichen Aktionen auslöst.

Script

Es gibt zwei veschiedene Aktionen. Ziel ist es, dass das Einschalten von "Einfahrt_AUF" den Taster des Tores nur betätigt, wenn es zu ist - aber nichts tut, wenn das Tor schon offen ist (respektive "Einfahrt_ZU" entsprechend umgekehrt).

Dazu dienen die folgenden Teile der Konfiguration, die die Aktionen unter bestimmten Bedingungen mit dem definierten Aktor "tor_sw FS20 11114444 23" verbinden:

#------Einfahrtstor ZU, wenn es noch auf ist--------
define act_on_Einfahrt_ZU notify Einfahrt_ZU { if (Value("Einfahrt") eq "Open" && "%" ne "off") { fhem("set tor_sw off ;; set tor_sw on-for-timer 1 ;; setstate Einfahrt_AUF off") } }

#------Einfahrtor auf, wenn es noch zu ist--------
define act_on_Einfahrt_AUF notify Einfahrt_AUF { if (Value("Einfahrt") eq "Closed" && "%" ne "off") { fhem("set tor_sw off ;; set tor_sw on-for-timer 1 ;; setstate Einfahrt_ZU off") } }

Erläuterungen (exemplarisch Einfahrt_ZU, Einfahrt_AUF funktioniert analog):

act_on_Einfahrt_ZU

Ist nur der Name der anschliessend definierten Aktion. Er könnte auch "MyName77" oder "Blubber" heissen. Es ist aber sicher sinnvoll einen selbsterklärenden Namen zu wählen.

notify Einfahrt_ZU

Es passiert erst etwas, wenn "Einfahrt_ZU" betätigt wird, also auf Weboberfläche oder Fernbedienung mit passender Adresse eine Taste gedrückt wird. (zur Beachtung: Auch ein Drücken der OFF Taste von "Einfahrt_ZU" auf der Weboberfläche oder entsprechend der linken Taste des Tastenpaares einer Fernbedienung ist eine Betätigung!)

{

Alles was jetzt folgt ist eine PERL Expression (PERL Expressions werden in geschweifte Klammern eingefasst.)

if (Value("Einfahrt") eq "Open" && "%" ne "off")

Falls der Wert von "Einfahrt" (mithin der Zustand des am Anfang definierten Türkontakts FHT80TF) gleich ("eg" = equal) "Open" ist (der FHT80TF kennt die beiden Werte Open und Closed) und zugleich die gedrückte Taste von "Einfahrt_ZU" nicht gleich ("ne" = Not equal) "off" (also "on") ist, dann mache folgendes... Dieser Teil dient dazu, zwei Dinge abzufragen:

1. Ist das Tor überhaupt offen? Durch Abfrage des durch den Türkontakt gemeldeten Zustandes wird dies festgestellt.

2. Wurde die "on" Taste auf dem Webinterface (entsprechend der rechten Taste auf der zugeordneten Fernbedienung) betätigt? Dies wurde durch Abfragen der Variablen "%" erledigt. Diese enthält den Wert der zuletzt betätigten Taste der definierten Aktion. Diese Bedingung ist für die Funktion nicht zwingend. Sie soll nur verhindern, das die Aktion auch dann gestartet wird, wenn die OFF Taste gedrückt wurde, was vielleicht nicht den Erwartungen des Benutzers entspricht.

Die Form "not equal off" klingt zunächst wie ein etwas komplizierter Weg von "equal on". Diese beiden Abfragen sind aber nicht identisch, da FS20 Dim-Befehle kennt. Wenn man die Taste einer Fernbedienung versehentlich länger als 0,4 Sekunden betätigt, wir anstatt einem ON Befehl eine Dim-Befehl gesendet. Wird nun auf Tastendruck "on" geprüft, wird in diesem Falle die Aktion nicht ausgeführt, obwohl der Nutzer die richtige Taste drückte. Der Dim-Befehl hat für eine Garagentorsteuerung keine Bedeutung, wenn er gesendet wird kann das eigentlich nur heissen, das der Nutzer versehentlich zu lange gedrückt hat. Das die Aktion nicht ausgeführt wird, weil der Nutzer die richtige Taste (nur) zu lange gedrückt gehalten hat, entspricht aber nicht den Erwartungen des normalen Nutzers. Es ist daher besser darauf zu testen, dass der Nutzer nicht die falsche Taste gedrückt hat.

Nur wenn beide Bedingungen zutreffen, also das Garagentor offen ist, und die richtige Taste (in beliebieger Länge) gedrückt wurde, werden die nachfolgenden Aktionen ausgeführt:

{ fhem("set tor_sw off ;; set tor_sw on-for-timer 1 ;; setstate Einfahrt_AUF off") } }

FHEM soll nacheinander ausführen:

set tor_sw off

tor_sw auschalten. Dies ist streng genommen nicht erforderlich, da tor_sw nach Ende der Aktion immer auf OFF stehen sollte. Sollte allerdings aus irgendeinem Grunde tor_sw doch auf ON stehen, hat das nachfolgende kurze Einschalten zur Simulation eines Tastendrucks am Garagentor keine Wirkung. Das vorherige Ausschalten erhöht also die Zuverlässigkeit der Aktion und fängt fehlerhafte oder unklare Zustände und Störungen ab.

set tor_sw on-for-timer 1

der Aktor tor_sw soll er für eine Sekunde einschalten und dann wieder auschalten. Dies simuliert einen kurzen Tastendruck.

setstate Einfahrt_AUF off

Im ganzen "Einfahrt_ZU" Skript wird "Einfahrt_ZU" zwar unter bestimten Bedingungen eingeschaltet (und damit die oben beschriebnen Aktionen ausgeführt) aber nie AUSgeschaltet. Das Script steht also im Webinterface auch nach Ausführung der Aktionen auf ON. Dies hat den Sinn, dass man am Webinterface am Schaltzustand des Scriptes den Zustand des Garagentors erkennen kann. Die Zustandsanzeige von "Einfahrt_ZU" (dargestellt durch eine kleine Glühbirne) leuchtet, wenn das Skript abgelaufen und das Tor somit zu ist. Analog leuchtet die Anzeige des Scripts "Einfahrt_AUF" wenn das Tor zuletzt geöffnet wurde. Damit nicht nach jeweils einer Betätigung beide Scripte im Webinterface beide Glühbirnen leuchten, schalten die Scripte sich gegenseitig aus. "setstate Einfahrt_AUF off" dient also dazu, nachdem das Tor geschlossen wurde, die Anzeige von "Einfahrt_AUF" auszuschalten. Dies ist eine rein optische Massnahme: Der Schaltzustand von "Einfahrt_AUF" und "Einfahrt_ZU" gibt nur die letzte Betätigung wieder, nicht den tatsächlichen Zustand des Tores. In der Praxis stimmt dies aber überein. Wenn jedoch z.b. jemand das Tor manuell öffnet, stimmt die Anzeige nicht mehr. Um einen tatsächliche Ausführung der Scripte zu vermeiden, wird das Kommando "setstate" verwendet, das nur den Status ändert, aber nicht eine tatsächliches "set" auslöst.

Vorteile der besprochenen Konfiguration:

das Tor kann mit Weboberfläche und Fernbedienung eindeutig auf oder zu gemacht werden, obwohl der Torantrieb selber nur toggelt.
der Zustand des Tores muss nicht bekannt sein. Wenn man das Tor öffnen will, genügt es, auf Einfahrt_AUF zu drücken. Wenn das Tor schon auf ist passiert nichts, ansonsten wird es geöffnet.
Manuelle Eingriffe am Garagentor selbst behindern die Schaltung nicht.
der Zustand des Tores lässt sich in der Regel am Schaltzustand der Aktionen im Webinterface feststellen. Dadurch ist es nicht zwingend, den Türkontakt dem selben Raum zuzuordnen (obwohl es in diesem Beispiel so gemacht wurde)
Fehlbedienungen an der Fernbedienung (falsche Taste, zu lange gedrückt) werden abgefangen (dies ist insbesondere ein Vorteil gegenüber der Lösung, mit einer Fernbedienung den FS20 Aktor direkt anzusprechen, in dem ein Timer programmiert wurde. Das Auslösen des Dim-Befehles deaktiviert nämlich FS20 Timer.)

Nachteile der besprochenen Konfiguration:

der Einsatz des FHT80TF.
belegt zwei Adressen und damit zwei Tastenpaare auf einer Fernbedienung. Ein Umschreiben auf ein Tastenpaar wäre aber möglich.