Übersicht ekey bionyx



Dieser Funktionsbaustein nimmt die Ereignisse eines Fingerscanners der ekey-Reihen xLine, sLine und dLine auf, also der Geräte mit Controller REG und der ekey bionyx App. Jeder Fingerscan erscheint an den Ausgängen mit Benutzer, Fingernummer und Ergebnis, und in einer Tabelle wird festgelegt, welcher Finger welche Aktion auslöst - Tür öffnen, Licht einschalten, Alarmanlage unscharf schalten.

Für die ältere Gerätereihe mit dem Konverter LAN RS-485 ist der Baustein Ekey UDP zuständig. Die beiden Reihen sprechen verschiedene Sprachen: die ältere sendet UDP-Pakete, die neue ruft eine Adresse der Steuerung über HTTP auf. Welcher Baustein passt, entscheidet also das Gerät.

Wie das Gerät sendet. Der Controller baut die Verbindung selbst auf und ruft bei jedem Ereignis eine Adresse im eigenen Netz auf. Die Steuerung fragt nichts ab, es gibt also keine Abfragezeit und keine Verzögerung. Die Steuerung bestätigt den Aufruf sofort; bliebe die Bestätigung aus, würde der Controller das Ereignis wiederholen.

Einrichtung in der ekey bionyx App. Unter Einstellungen → Smart Home wird die Benachrichtigungs-Schnittstelle freigegeben und als Ziel die Steuerung eingetragen, zum Beispiel http://192.168.1.90:8130. Eingetragen werden nur Rechner und Port - den Rest der Adresse ergänzt der Controller selbst. Der Port muss mit dem Parameter Port dieses Bausteins übereinstimmen. Die Freigabe darf nur der Verwalter des Systems vornehmen.

Benutzer und Aktionen. Der Controller sendet keinen Namen, sondern eine Kennung wie tKlLpvUa. Welcher Mensch dahinter steht, weiß nur die ekey bionyx App - deshalb wird die Zuordnung einmal in der Tabelle des Bausteins eingetragen. Jede Zeile der Tabelle ergibt einen Ausgang: passt Kennung und Finger zum Ereignis, wird dieser Ausgang gesetzt. Der Name aus der Tabelle erscheint am Ausgang Benutzer und beschriftet den Aktionsausgang, damit auf der Programmseite zu sehen ist, wer welchen Ausgang schaltet.

Benutzer importieren. Liegt die Benutzerliste der ekey bionyx App als JSON vor, müssen die Kennungen nicht abgetippt werden: Im Dialog der Tabelle übernimmt Benutzer aus ekey importieren Kennung und Name aus der Zwischenablage oder aus einer Datei. Je Benutzer entsteht eine Zeile mit der Aktion Impuls für jeden Finger - Aktion und Finger werden danach eingestellt, nicht benötigte Zeilen gelöscht. Kennungen, die schon in der Tabelle stehen, bleiben unverändert. Hat ein Mensch in der App mehrere Kennungen, ergibt das mehrere Zeilen.

Aktionen lösen nur bei einem Treffer aus, also wenn der Finger erkannt und freigegeben wurde. Ein abgewiesener Finger nennt keinen Benutzer und schaltet deshalb nie eine Aktion - sonst würde eine Zeile ohne Kennung auf jeden Fehlversuch reagieren.

Ein Baustein je Anlage. In der App lässt sich nur ein Ziel eintragen, deshalb genügt ein Baustein je Projekt. Mehrere Bausteine mit demselben Port können nicht gleichzeitig arbeiten.

Sicherheit. Die Übertragung läuft unverschlüsselt im eigenen Netz. Der Port darf nicht aus dem Internet erreichbar sein. Für das Netz gilt dasselbe wie für die Netzwerk API: eine Anmeldung gibt es nicht, der Schutz ist das eigene Netz.

Prüfen ohne Gerät. Ein Ereignis lässt sich von einem Rechner im Netz nachbilden:

curl -X POST http://192.168.1.90:8130/api/notification/finger -H "Content-Type: application/json" -d "{\"type\":10,\"result\":10,\"params\":{\"userId\":\"tKlLpvUa\",\"fingerIndex\":2}}"

Mit dem Parameter Debug steht der empfangene Inhalt im Protokoll der Steuerung - damit ist auch zu sehen, welche Kennung ein Finger tatsächlich liefert.

Tabelle Benutzer und Aktionen

Spalten

Benutzerkennung Kennung des Benutzers aus der ekey bionyx App. Groß- und Kleinschreibung werden unterschieden. Leer bedeutet: jeder erkannte Benutzer - für eine Aktion, die jeder berechtigte Finger auslösen soll.
Name Klartext zur Kennung. Er steht am Ausgang Benutzer und beschriftet den Aktionsausgang. Bleibt er leer, erscheint die Kennung selbst.
Finger links, Finger rechts Je Hand eine Fingernummer von 1 bis 5, "-" bedeutet nicht verwendet. Stehen beide Spalten auf "-", reagiert die Zeile auf jeden Finger. Stehen beide auf einer Nummer, reagiert sie auf beide Finger - etwa auf den Zeigefinger links und rechts. Damit lösen zwei Finger desselben Benutzers zwei verschiedene Aktionen aus: ein Finger öffnet die Tür, ein anderer schaltet zusätzlich das Licht ein.
Der Controller meldet die Nummer vorzeichenbehaftet, die linke Hand negativ - am Ausgang Finger steht sie so, wie sie gekommen ist. Welche Nummer ein Finger liefert, zeigt der Parameter Debug im Protokoll der Steuerung.
Aktion
  • Impuls: der Wert ein wird ausgegeben und nach der Pulszeit wieder der Wert aus.
  • Telegramm 1: der Wert ein wird ausgegeben und bleibt stehen. Auf einer KNX-Gruppenadresse wird dabei jedes Mal ein Telegramm gesendet, auch wenn der Wert schon anliegt.
  • Umschalten: wechselt zwischen dem Wert ein und dem Wert aus. Beim Hochlauf der Steuerung übernimmt der Baustein die Stellung aus der Adresse, die am Aktionsausgang hängt - ist dort beim Start schon etwas bekannt, schaltet auch der erste Scan in die richtige Richtung. Danach zählt der letzte Wert, den der Baustein selbst ausgegeben hat. Wird dieselbe Adresse auch von anderer Seite geschaltet, etwa von einem Taster, weiß der Baustein davon nichts und der nächste Scan schaltet unter Umständen in die gleiche Richtung.
Ausgang ein, Ausgang aus Die beiden Werte am Aktionsausgang, Vorgabe 1 und 0. Für eine Szene oder eine Betriebsart lässt sich auch ein anderer Wert eintragen.
Pulszeit Nur bei der Aktion Impuls: Sekunden, die der Wert ein anliegt, Vorgabe 5.

Eingänge

FG Freigabe Optional. 0 sperrt den Baustein: ankommende Ereignisse werden bestätigt, aber nicht ausgewertet - es gibt keinen Puls und keine Aktion, die Ausgänge behalten ihren Wert. Ungleich 0 gibt frei. Nicht verknüpft: der Baustein gilt als freigegeben.

Ausgänge
PL Puls Bei jedem angenommenen Ereignis wird ein Impuls ausgegeben: erst 0, dann 1 und nach drei Sekunden wieder 0. Damit lässt sich eine eigene Logik anstoßen, etwa ein Eintrag in der Meldezentrale. Beim Impuls stehen die übrigen Ausgänge schon auf den Werten des Ereignisses.
BE Benutzer Name aus der Tabelle, sonst die Kennung des Benutzers. Dafür ist eine Adresse vom Typ Zeichenkette (EIS 15) nötig; "Adressen erzeugen" legt sie passend an.
FI Finger Fingernummer, -5 bis 5. Das Vorzeichen unterscheidet die beiden Hände, 0 bedeutet "kein Finger". Welche Nummer zu welchem Finger gehört, zeigt die ekey bionyx App.
TR Treffer 1, wenn der Finger erkannt und freigegeben wurde, sonst 0.
AB Abweisung 1, wenn der Finger abgewiesen wurde - unbekannter Finger, gesperrter Benutzer oder Zeitplan. Das setzt den Parameter Abgewiesene Finger ausgeben voraus, sonst wird ein abgewiesener Finger gar nicht ausgegeben.
GR Grund Grund der Abweisung, so wie ihn der Controller meldet: 10 Benutzer deaktiviert, 20 Zeitplan, 30 keine Regel für diesen Finger, 40 kein Eingang, 50 ungültiger Eingang, 60 Zeitbegrenzung. 0 bei einem erkannten Finger.
SC Scanner Kennung des Gerätes, das den Finger gelesen hat, als Text. Bei mehreren Scannern ist damit zu unterscheiden, an welcher Tür gescannt wurde.
EN Eingang Nummer des digitalen Eingangs des Controllers, wenn das Ereignis von dort kommt. 0 bei einem Fingerscan.
ZE Anzahl Ereignisse Zähler aller angenommenen Ereignisse seit dem Start der Steuerung. Nach einem Neustart beginnt er bei 0.
KF Kommunikationsfehler 1, wenn in der Überwachungszeit kein Ereignis eingetroffen ist. Ohne Überwachungszeit bleibt der Ausgang 0.
A1..An Aktion je Tabellenzeile Ein Ausgang je Zeile der Tabelle, beschriftet mit dem Namen aus der Zeile. "Adressen erzeugen" legt für diese Ausgänge keine Adresse an - sie werden mit der Logik verdrahtet oder direkt auf die Adresse des Aktors gelegt, zum Beispiel des Türöffners.

Parameter
Benutzer und Aktionen Öffnet die Tabelle, siehe oben. Höchstens 32 Zeilen.
Port TCP-Port, auf dem die Steuerung die Ereignisse annimmt, Vorgabe 8130. Derselbe Port wird in der ekey bionyx App eingetragen. Der Port darf nicht von einem anderen Dienst der Steuerung belegt sein, zum Beispiel 10001 (Studio und APP), 80 und 443 (Weboberfläche) oder 502 (Modbus Slave).
Abgewiesene Finger ausgeben Vorgabe aus: nur der erkannte Finger erscheint an den Ausgängen, also das bisherige Verhalten. Eingeschaltet erzeugt auch ein abgewiesener Finger einen Impuls, der Ausgang Abweisung wird 1 und der Grund steht an GR - für eine Meldung "unbekannter Finger an der Haustür". Eine Aktion löst ein abgewiesener Finger trotzdem nie aus.
Überwachungszeit Minuten ohne Ereignis, nach denen der Ausgang Kommunikationsfehler 1 wird. Vorgabe 0, also keine Überwachung. Zu beachten: der Controller sendet nur bei einem Ereignis, nicht in Ruhe - eine kurze Zeit meldet deshalb jede ruhige Nacht.
Debug Schreibt jedes empfangene Ereignis vollständig in das Protokoll der Steuerung. Für die Einrichtung gedacht, im Betrieb wieder ausschalten.

Siehe auch allgemeine Parameter aller Funktionsbausteine.