[Firmware] OpenKNX AccessControl - Zutrittskontrolle mittels Fingerprint, NFC oder Code-Tastatur

[mumpf]

Wie im Thread "Reorganisation von Firmware- und Hardware-Threads" angekündigt, ist das hier ein neuer Thread für die AccessControl - Firmware (OAM-AccessControl). Hier werden neue Releases vorgestellt und Fragen zur Software behandelt. Dieser Thread löst den bisherigen Thread ab, dieser wird nach einer kurzen Übergangszeit geschlossen.

Das OAM-AccessControl bündelt mehrere OpenKNX-Module, um die Funktion einer Zutrittskontrolle zu realisieren. Dazu gehören:

• Unser Basismodul (OGM-Common), das Grundfunktionen von OpenKNX-Geräten bereitstellt.
• Konfigurationstransfer (OFM-ConfigTransfer), mit dem man einfach Konfigurationen zwischen OpenKNX-Geräten austauschen kann.
• Das Zutrittskontrolle-Modul (OFM-AccessControl), das alle Hauptaufgaben der Zutrittskontrolle realisiert.
• Schaltaktor-Modul (OFM-SwitchActuator), das - sofern von der Hardware unterstützt - ein direktes öffnen z.B. einer Tür über ein Relais - ermöglicht.
• Logiken (OFM-LogicModule), mit dem man einfache Erweiterungen und Ergänzungen für die Zutrittskontrolle realisieren kann
• Virtuelle Taster (OFM-VirtualButton), mit dem Signale von Binäreingängen zu KNX-gerechten Tasteneingaben wandeln kann
• Binäreingänge (OFM-BinaryInput), mit dem man Signale von Binäreingängen auf den Bus bringen kann (sofern die Hardware Binäreingänge hat).

In diesem Thread werden primär die Funktionen vom AccessCotrol-Modul behandelt (OFM-AccessControl), die anderen in der Firmware enthaltenen Module haben eigene Threads, die die jeweilige Funktionalität adressieren.

AccessControl bietet eine Zugangskontrolle mit 3 verschiedene Arten, sich zu autorisieren:

• Über einen Fingerprint-Leser
• Über einen NFC-Leser
• oder eine Code-Tastatur (im Beta-Test, in der aktuellen Firmware noch nicht verfügbar)

Die aktuelle Applikation bietet folgende Features:

• Einlernen und verwalten von 300 Fingern, 300 NFC-Tags und 300 Tastencodes (Designed für je 1500 Einträge, derzeit noch nicht freigegeben).
• Verwaltung von zugehörigen Benutzerinformationen
• Definition von 200 Aktionen, die von der Autorisierungs-Hardware (Finger, NFC oder Tastencode) ausgeführt werden
• Beliebige Kombination von Autorisierungs-Hardware und Aktion, eine Aktion kann von mehreren NFC, mehreren Fingern und mehreren Tastencodes gerufen werden, ebenso mehrere Aktionen von einem Finger, NFC, Tastencode. Beliebig mischbar.
• Sofort-Modus: eine Autorisierung löst sofort eine Aktion aus, damit kann jeder Finger eine andere Aktion auslösen.
• Autorisierungs-Modus: Man sagt zuerst, wofür man sich autorisieren möchte (z.B. Tür öffnen oder Alarmanlage deaktivieren), dann hat man eine einstellbare Zeit, um sich zu autorisieren. Damit hat man die Möglichkeit, mit einem Finger/Code/NFC sehr viele Autorisierungen vorzunehmen.
• Beide obige Modi sind beliebig kombinierbar
• Der LED-Ring vom Fingerprint kann über den Bus gesteuert werden (Farbe, verschiedene Blink-/Pulsier-Modi, Blinkdauer)
• KO, die Erkennung/Nichterkennung melden.
• KO für externe Steuerung (gedacht für eine HomeAssistant-Integration, noch nicht verfügbar).
• Synchronisation von Autorisierungsdaten (Finger, NFC) zwischen verschiedenen Lesern

Das aktuelle Release findet ihr immer auf Github hier: https://github.com/OpenKNX/OAM-AccessControl/releases.
Das entsprechende Github-Repo ist hier: https://github.com/OpenKNX/OAM-AccessControl
Die Applikationsbeschreibung findet ihr hier: https://github.com/OpenKNX/OFM-Acces...tskontrolle.md

Hardware wird nicht in diesem Thread behandelt. In den folgenden Threads werden Hardware und Hardware-Fragen behandelt, die das OAM-AccessControl unterstützen:

OpenKNX-Unterputz-Sensormodul UP1-SEN-8x von Ing-Dom: https://knx-user-forum.de/forum/proj...tdrucksensoren

Fingerprint-Leser von abtools: (Hardwarethread folgt noch, wird hier referenziert).

Gruß, Waldemar

[klayman]

Hallo zusammen,

eine Frage zur Synchronisation der Fingerprints: Ich habe aktuell einen "alten" Fingerprint mit HW Revision 1.4 und der Firmware/Applikation 0.6. Darauf sind einige Finger gespeichert, die ich gerne behalten würde. Parallel dazu baue ich gerade einen weiteren Fingerprint (auch HW 1.4) mit NFC Zusatzplatine auf, dieser hat die Firmware/Applikation 0.8. Ich möchte jetzt gerne die Fingerprints vom alten Gerät auf das neue übertragen und anschließend auch beim alten das Update machen.
Dazu sind beide Scanner mit einer gemeinsamen GA auf den KO 66 (alt) bzw. 23 (neu) verbunden. Applikationen neu programmiert und neu gestartet. Synchronisation ist aktiviert und 100ms Pause zwischen den Telegrammen eingestellt. Ich kann jetzt auf dem alten Gerät die manuelle Synchronisation triggern und sehe dann auch knapp 100 Telegramme im Gruppenmonitor. Wenn die Telegramme durch sind, leuchtet das neue Gerät kurz rot auf.

Habt Ihr eine Idee wo der Fehler liegen könnte?

Danke,
Klayman

[mumpf]

Release-Info:

• Aktuelles Release 0.10.2, verfügbar hier: https://github.com/OpenKNX/OAM-AccessControl/releases

[mumpf]

Info:

Zum Erstellzeitpunkt dieses Threads gibt es noch kein neues Release, aber bald...

[CosmiF]

abtools

Hallo,

ich habe mir die Doku sowie den Source-Code vom OFM-AccessControl angesehen und soweit ich es verstanden habe, ist das Löschen von Finger-/NFC-Slots aktuell nicht über normale KNX-Kommunikationsobjekte möglich.

Das Anlernen und die Synchronisation funktionieren über Gruppenadressen bzw. normale KNX-Telegramme.
Das Löschen dagegen scheint ausschließlich über Function Property Commands zu laufen (Object 160 / Property 3).

Dadurch entsteht aktuell folgendes Problem:

Home Assistant bzw. die normale knx.send-Funktion unterstützt nur GroupValueWrite-Telegramme, aber keine KNX Function Property Commands. Dadurch können externe Systeme oder Add-ons Finger-/NFC-Slots momentan nicht sauber löschen, ohne:

• eigene KNX-Tunnel aufzubauen
• direkt knxtool zu verwenden
• oder eigene xknx-Instanzen parallel zu Home Assistant zu betreiben

Gerade für Home-Assistant-Integrationen wäre es sehr hilfreich, wenn zusätzlich optionale Kommunikationsobjekte für das Löschen verfügbar wären.

Vorschlag:

• Delete Finger Slot
• Delete NFC Slot

Idee:
Eine Slot-ID wird auf das KO geschrieben → das Gerät löscht den Slot lokal und stößt anschließend die bestehende Synchronisationslogik an.

Das würde die Integration in externe Systeme deutlich vereinfachen und denselben Ansatz nutzen wie bereits beim Enrollment oder Sync über KNX-Kommunikationsobjekte.

Oder übersehe ich aktuell eine bestehende Möglichkeit, Finger-/NFC-Slots direkt über normale KNX-Gruppenadressen zu löschen?

edit:
Beitrag vom Hardware-Thread in den neuen Firmware-Thread verschoben.

[martinhoefling]

Mit meinem V1.3 Fingerprint Reader habe ich folgenes Problem: Es scheint so, als ob der R503 nicht mehr erkannt wird.

- Anlernen der Finger: Keine LED leuchtet auf.
- Alle Finger löschen: Parameterskript fehlgeschlagen Fingerprint: Es ist ein unbekannter Fehler aufgetreten!
- Passwort setzen etc. funktioniert auch nicht.

Version ist 0.10

image.png

Was geht? Relais, Binäreingänge funktionieren wie erwartet.

Was ging mal? Der ganze reader wurde vor einiger Zeit in einem anderen Projekt (demo Board) schonmal erfolgreich getestet. Da liessen sich auch Finger anlernen und auslösen (v0.6). Passwort wurde soweit ich mich erinnern kann und im alten ETS projekt ersichtlich keines gesetzt.

Gibt es noch Ideen was ich probieren kann, bevor ich mir einen neuen R503 kaufe?

[traxanos]

Du hast aber keine Passwort auf dem Reader vergeben?

[martinhoefling]

Du hast aber keine Passwort auf dem Reader vergeben?

Wie geschrieben - nicht dass ich mich daran erinnern kann und im alten Projekt konnte ich auch nichts finden. Passwort ändern schlägt allerdings fehl mit "Eingegebenes altes Passwort falsch". Also liegt es vermutlich daran?

[Weihnachtsmann]

ich habe leider noch Probleme beim Anlernen von NFC Tags.

- ETS 6.4.1
- Access Control Hardware 1.12 / Firmware v0.10.2
- ich nutze den externen NFC Reader v1.3 und habe das auch in der ETS entsprechend konfiguriert. Kein Fingerprint.
- meine Platine habe ich noch nicht zerschnitten (siehe ein paar Nachrichten früher). Erstmal wollte ich alles in Original testen.
- ich habe verschiedene NFC Tags getestet, darunter NTAG213, NTAG215, NTAG216 (die geben alle laut einer Smartphone App "NFC Tools" eine 7 Byte ID zurück) und Mifare Classic (4 Byte ID), Mifare Plus (4 Byte ID)

Folgende Beobachtung bei den NTAG21x):
- wenn ich einen NFC-Tag auf die Antenne auflege, leuchtet eine rote LED am Antennenmodul.
- Die geht nach ca. 2 Sekunden wieder aus
- wenn ich das Parameterskript zum Anlernen ausführe, blinkt die LED ein paar mal grün, dann bricht der Vorgang jedoch ab mit der Fehlermeldung: "NFC: Tag ID 5 anlernen fehlgeschlagen"

Beobachtung bei Mifare Plus:
- wenn ich einen NFC-Tag auf die Antenne auflege, leuchtet eine rote LED am Antennenmodul dauerhaft.
- das Parameterskript Anlernen läuft durch und ich bekomme in der ETS auch eine UID angezeigt.
- Die scheinen aber eine Art rollenden Code zu haben. Weil bei jedem Versuch erhalte ich eine andere UID
- Auch die Aktionen werden nicht ausgeführt.

Ich bin vor Allem bei den NTAG21x verwundert, dass es nicht funktioniert. Da die doch passend sein sollten laut Beschreibung (und ich habe wirklich ein paar Modelle getestet). Die Mifare Plus sind mir mehr oder weniger egal. Die habe ich nur getestet um zu beweisen, dass der Anlernvorgang prinzipiell funktioniert.

Ansonsten ist mir noch aufgefallen, dass, wenn ich eine Touch Taste drücke, Trigger ich eine 0. Hätte ich intuitiv andersrum erwartet. Ist mir auch unwichtig, wollte das aber erwähnen, falls das beweist, dass ich etwas falsch angeschlossen habe.

Freue mich auf eure Ratschläge


edit Ing-Dom:
Beitrag verschoben (HW->SW).

[henfri]

Hallo,

gibt es eigentlich die Möglichkeit, eine GA zu senden, sobald der Fingerprint berührt wird?
Mein Smartlock braucht leider 2-3s von Disconnected bis Motor bewegt sich. Da wäre es schön, wenn man den Connect früher triggern könnte.

Gruß,
Hendrik

[mumpf]

Ja, es gibt das Touch Event, das kommt auf einer GA. Allerdings nur, wenn man nicht den continuous mode nutzt.

Gruss, Waldemar

[henfri]

Ah, danke. Ich nutze continous, das erklärt, warum ich nichts finden konnte.