Der KIT-Card Reader auf Basis des ELATEC Multitech oder Mifare TWN4 kennt zwei Modi:
## KIT-Card Reader
Voraussetzung zur Nutzung dieser Software ist ein [ELATEC Multitech oder Mifare TWN4](https://www.elatec-rfid.com/de-de/produktdetail/twn4-multitech) und das zugehörige [Dev-Kit](https://www.elatec-rfid.com/de-de/twn4-dev-pack). Die Kosten für einen Leser liegen bei ca 100 € zzgl MwSt (Stand Juli 2021).
Das Dev-Kit muss installiert sein, der Leser über USB angeschlossen. Das Dev-Kit ist nur unter Windows nutzbar. Die Programmierung des Leser muss damit immer unter Windows erfolgen, auch dann, wenn die Nutzung des Lesers unter Linux erfolgen soll.
Der KIT-Card Reader kennt zwei Modi:
- reader mode --> USB Tastatur (HUD Device, engl. Tastaturlayout)
- serial mode --> Serial device (über VCOM Treiber)
In beiden Fällen muss der Leser an einen Rechner angeschlossen sein. Ein Stand-Alone Betrieb ist nicht möglich, auch dann nicht, wenn der Leser so programmiert ist, dass er die Funktionen eigenständig ausführt. Die Treiber für beide Varianten werden von Windows und Linux mitgeliefert. Eine Treiber-Installation ist in der Regel nicht erforderlich.
Zur Übersetzung und zum Laden der Firmware gibt zwei `.bat` Dateien: `build_reader.bat` und `build_serial.bat`. Vor der Nutzung müssen die Pfade und Parameter eingestellt werden. Folgende Parameter sind dabei zu beachten:
> DEBUG --> zur Ausgabe von Debug-Informationen<br />
> READER_ACTION --> Standardfunktion, die ausgeführt werden soll, wenn eine Karte aufgelegt wird. Dabei ist zu beachten, dass im reader mode nur Funnktionen angegeben werden können, die nur Daten ausgeben.<br />
> SECURE --> Nur im serial mode verfügbar. Damit werden nur Funktionen im SECURE-Mode freigeschaltet (siehe unten).<br />
> GERMAN_KEYBOARD --> Nur im reader mode verfügbar. Stellt den Reader auf deutsche Tastatur (Standard ist englische Tastatur).
Im serial mode kennt der Leser folgende Befehle, die über die serielle Schnittstelle an den Leser übergeben werden. Die seriellen Parameter sind:
baudrate=9600,
parity=NONE,
stopbits=ONE,
bytesize=EIGHTBITS
Unter Windows wird der Leser mit "comx" angesprochen unter Linux unter "/dev/ttyACMx", wobei x der Nummer der Schnittstelle entspricht.
Alle Befehle werden mit `0x0D`abgeschlossen. Zeichen dahinter werden ignoriert.
Alle Angaben sind als Zeichen zu übermitteln, wenn nichts anderes vermerkt ist.
Im serial mode werden alle Befehle direkt ausgeführt. Sollte zum Zeitpunkt der Ausführung keine Karte aufliegen, so kommt die Meldung "09,no card for action 1". Das heißt die Anwendung muss selbst die Warteschleife implementieren.
Fehlermeldungen haben immer folgenden Aufbau:
`<fehlernummer>,<Erläuterungen zum Fehler>`
|Befehl| App | Return |
|--|--|--|
| 1 | bwCard old (becaad) | bwCard-Nummer |
|10|bwCard old (becaad)|bwCard-Nummer encrypted (Hex)
|11|bwCard old (becaad)|bwCard-Nummer;readerUID (Hex)
|12|bwCard old (becaad)|cardUID (Hex);readerUID (Hex)
|13|bwCard old (becaad)|bwCard-Nummer encrypted (Hex)>;<readerUID (Hex
|20|Success Beep|Kein Returnwert
|20|Success Beep|Kein Returnwert
|20|Success Beep|Kein Returnwert
|21|Special Success Beep|Kein Returnwert
|30|Error Beep|Kein Returnwert
|31|Special Error Beep|Kein Returnwert
|50|read device UID|readerUID (Hex)
|51|Generate Login Data for secure functions|token for secure functions
Die implementierten Befehle im Secure Mode werden auf Nachfrage beschrieben.
Als USB Tastatur (HUD Device, engl. Tastaturlayout) oder als serial device (über VCOM Treiber). In beiden Fällen muss der Leser an einen Rechner angeschlossen sein. Ein Stand-alone Betrieb ist nicht möglich. Die Treiber für beide Varianten werden von Windows und Linux mitgeliefert. Ein Treiber Installation ist in der Regel nicht erforderlich.
