RFID-Reader AT-120 Bedienungsanleitung

RFID-Reader AT-120 Bedienungsanleitung Ausgabe 08.03.2017

1. Allgemein... 1 2. LED-Anzeigen... 3 3. Reset... 3 4. AT-120-Utility... 4 Interface USB-HID-Keyboard...4 Interfaces USB-VCOM und RS-232 (optional)...5 AT-120-Konfigurationsparameter...6 Tag-Type-Character...7 5. Kundenspezifische Anwendungen... 8 Kundenspezifische Host-Anwendung...9 Kundenspezifische App-Programmierung...9 Beispiel-App für Interface USB-VCOM bzw. RS-232...11 Beispiel-App für Interface USB-HID-Keyboard...12 6. Technische Daten... 13 7. Recycling-Verordnungen für Altgeräte... 14

1 Wir liefern Ihnen nicht nur unsere mobilen Terminals mit Standard-Software... sondern entwickeln auch kundenspezifische Applikationen für diese Geräte PC-Applikationen Hardware und beraten Sie bei der Erstellung von Konzepten für die mobile Datenerfassung, Fragen rund um Barcode und RFID, Hardware-Problemen, PC-Problemen. Wenden Sie sich mit Ihren Fragen und Problemen bitte an: aitronic GmbH Balhorner Feld 10 D-33106 Paderborn Telefon: +49 (0) 5251 29816-0 Telefax: +49 (0) 5251 29816-40 Internet: http://www.aitronic.de E-Mail: info@aitronic.de Copyright aitronic GmbH, 2016 Alle Rechte vorbehalten, insbesondere auch auszugsweise die der Übersetzung, des Nachdrucks, Wiedergabe durch Kopieren oder ähnliche Verfahren. Liefermöglichkeiten und technische Änderungen vorbehalten

1 1. Allgemein Der AT-120 ist ein kompaktes Gerät für den kontakt- und berührungslosen Datenaustausch mit allen handelsüblichen Transpondern und eignet sich für eine Vielzahl von Anwendungen in Büro, Verwaltung und Industrie. Der AT-120 kann in folgenden den 3 Grundeinstellungen betrieben werden: Interface USB-HID-Keyboard Interface USB-VCOM Interface RS-232 (optional) Ausliefert wird der AT-120 mit der Grundeinstellung Interface USB-HID-Keyboard und im TWN4-Modul ist die App Simple Protocol ist installiert. Ein gelesener Transponder-Tag wird entsprechend den Einstellungen, die mit der AT-120-Utility gemacht werden können, behandelt. Die USB-Schnittstelle wird im HID-Modus betrieben. D.h. vom AT-120 empfangene Zeichen werden wie Tastatur- Eingaben behandelt. Auf diese Art und Weise können Transponder-Id s in jede beliebige Anwendung, welche manuelle Eingabe erwartet, übernommen werden. Für die Grundeinstellungen Interface USB-HID-Keyboard muss entweder die App Simple Protocol (oder eine kundenspezifische App, welche die Funktionalität von Simple Protocol enthält) installiert sein, da die AT-120-Firmware für die Kommunikation mit der TWN4-Firmware auf diese App angewiesen ist. In dieser App ist folgende Funktionalität implementiert:

2 Empfangen eines Kommandos vom Host, Weitergabe des Kommandos an Firmware des TWN4, Empfangen der Antwort von der Firmware des TWN4 und Weitergabe der Antwort an den Host. Die zur Verfügung stehenden Kommandos sind in TWN4 Simple Protocol DocRev11.pdf dokumentiert. Mit den Grundeinstellungen Interface USB-VCOM bzw. RS-232 (nur wenn vorhanden) kommuniziert der Host über ein virtuelles COM-Port bzw. die RS-232 direkt mit der jeweils installierten App. Das kann z.b. die standardmäßig installierte App Simple Protocol sein. Die Kommandos, die verwendet werden können, sind dem Dokument TWN4 Simple Protocol DocRev11.pdf (enthalten im Download- Package TWN4 Tools und Dokumente.zip ) zu entnehmen. Eine andere Möglichkeit ist die Entwicklung und das Laden einer eigenen kundenspezifischen App, um das Verhalten des AT-120 an besondere Anforderungen anzupassen. Die Programmierung von Apps wird im Kapitel Kundenspezifische App-Programmierung beschrieben.

3 2. LED-Anzeigen Grün Grün/Rot blinkend Orange Betriebsbereit Konfigurationsmode Quittung für gelesenen Transponder-Tag in Grundeinstellung Interface USB-HID-Keyboard In den Grundeinstellungen Interface USB-VCOM und RS-232 (nur wenn vorhanden) kann die LED wie folgt durch die Anwendung gesteuert werden: LED-Funktion GPIO Output Rote LED GPIO Output Grüne LED Rote LED ein Rote LED aus Grüne LED ein Grüne LED aus Kommando 0400010101<CR> 0400020101<CR> 040201<CR> 040301<CR> 040202<CR> 040302<CR> 3. Reset Der Reset-Taster befindet sich hinter dem kleinen Loch neben der USB-Buchse und kann mit einer Büroklammer o.ä. betätigt werden. Nach einem Reset werden die 3 Zeichen 00<CR> (Hex-Code: 0x30, 0x30, 0x0D) auf der Schnittstelle ausgegeben.

4 4. AT-120-Utility Diese zum Lieferumfang gehörende Utility dient zur Konfiguration des AT-120. Nach dem Starten der Utility wird angezeigt. Nach Anschließen des AT-120 und Auslösen eines Resets wird in Abhängigkeit vom eingestellten Interface der Screen für den Interace USB-HID- Keyboard, USB-VCOM oder RS-232 angezeigt. Interface USB-HID-Keyboard Ist Interface USB-HID-Keyboard angewählt, werden die UIDs von gelesen Transponder-Tags auf der USB-Schnittstelle im HID-Keyboard-Modus (d.h. die Daten erscheinen wie von der Tastatur kommend) an die Host-Applikation ausgegeben.

5 Interfaces USB-VCOM und RS-232 (optional) Ist Interface USB-VCOM angewählt, kommuniziert die Host-Applikation direkt mit dem RFID-Modul über die dem USB-Anschluss zugewiesene virtuelle COM- Schnittstelle. Ist Interface RS-232 angewählt, kommuniziert die Host-Applikation direkt mit dem RFID-Modul über die RS-232-Schnittstelle. Die Kommandos, die in diesem Mode von der Host-Applikation verwendet werden können, ist dem Dokument TWN4 Simple Protocol DocRev11.pdf zu entnehmen.

6 AT-120-Konfigurationsparameter Parameter Beschreibung Modul Baud Baudrate für virtuelles COM-Port (default: 9600 Bd). ACHTUNG: Bevor die Baudrate des AT-120 verändert wird, muss zuvor die Baudrate des integrierten RFID- Moduls auf den gleichen Wert eingestellt werden! Char delay Zeitverzögerung zwischen den einzelnen ausgegebenen Zeichen (in Millisekunden). Double timeout Zeitfenster zur Verhinderung von Doppelerfassungen (in Sekunden). max. Length Anzahl der max. auszugebenden Zeichen Version AT-120-Firmware-Version. Type Transponder-Reader-Type Use Alt-Key Für die Ausgabe werden ALT-Keycodes verwendet. Suffix None Bei aktiviertem Parameter wird dem ausgegebenen String kein Suffix angehängt. Enter Bei aktiviertem Parameter wird der ausgegebene String mit ENTER abgeschlossen. Tab Bei aktiviertem Parameter wird der ausgegebene String mit TAB abgeschlossen. Byte Mirror Bei aktiviertem Parameter werden die Bytes des ausgegebenen Strings gespiegelt. Bit Mirror Bei aktiviertem Parameter werden die Bits der ausgegebenen Bytes gespiegelt. Add Tag Type Wenn der Parameter in der Grundeinstellung Interface USB-HID-Keyboard aktiviert ist, wird die UID durch 2 Zeichen angeführt, die den Tag-Typ repräsentieren. LF-Tags Aktivierung der verschiedenen Tag-Typen. Nur die UIDs der ausgewählten Tag-Types werden ausgegeben. Für HF-Tags eine möglichst gute Lese-Performance, sollten nur die Tag-Typen aktiviert werden, die wirklich benötigt werden! Apply Die angezeigten Einstellungen werden in den Transponder-Reader geschrieben.

7 Tag-Type-Character In der Grundeinstellung USB-HID-Keyboard wird bei aktivierter Option Output Tag Type der Tag-Type durch 2 Hex-Zeichen der UID vorangestellt. Führende Zeichen Tag-Bezeichnung LF (125/134 khz) 40 EM4x02/CASI-RUSCO 41 HITAG 1/HITAG S 42 HITAG 2 43 EM4x50 44 T55x7 45 ISO FDX-B 46 EM4026 47 HITAGU 48 EM4305 49 HID Prox 4A ISO HDX/TIRIS 4B Cotag 4C ioprox 4D Indala 4E NexWatch 4F AWID HF (13,56 MHz) 80 ISO14443A/MIFARE 81 ISO14443B 82 ISO15693 83 LEGIC 84 HID iclass 85 FeliCa 86 SRX 86 NFC Peer-to-Peer

8 5. Kundenspezifische Anwendungen Für Anwendungen, die lediglich das Scannen der Transponder-Id erfordern, kann der AT-120 mit der Einstellung Interface USB-HID-Keyboard betrieben werden. Auf Host-Seite ist dabei keinerlei Programmierung nötig. Die Transponder-Id erscheint für jede beliebige Host-Anwendung wie eine Tastatur-Eingabe. Für komplexere Anwendungen, für die das alleinige Scannen der Transponder-Id nicht genügt (wenn z.b. zusätzliche Daten aus dem Transponder-Tag gelesen bzw. in den Transponder-Tag programmiert werden sollen) ist die Entwicklung einer kundenspezifischen Anwendung erforderlich. Grundsätzlich gibt es die folgenden beiden Möglichkeiten (oder eine Kombination aus beiden) für die Entwicklung von kundenspezifischen Anwendungen: Kundenspezifische Host-Anwendung Eine kundenspezifische Host-Anwendung eröffnet die Nutzung sämtlicher Funktionen, die das im AT-120 integrierte RFID-Reader-Modul bietet, setzt aber voraus, dass der AT-120 mit der Einstellung Interface USB-VCOM bzw. RS-232 (nur wenn vorhanden) betrieben werden muss. Kundenspezifische App-Programmierung Eine kundenspezifischen App wird in den AT-120 geladen und ersetzt dort die Standard-App Simple Protocol. Die Entwicklung einer kundenspezifischen App bietet den Vorteil, dass der AT-120 auch mit der Einstellung Interface USB-HID-Keyboard betrieben werden kann. Vorraussetzung dafür ist allerdings, dass die betreffende kundenspezifische App die Funktionalität der Standard-App Simple Protocol enthält. Diese wird als Quellcode zur Verfügung gestellt und dient als Basis für die Entwicklung einer kundenspezifischen App.

9 Kundenspezifische Host-Anwendung Soll eine kundenspezifische Host-Anwendung für die Kommunikation mit dem AT-120 eingesetzt werden, muss der AT-120 mit Hilfe der AT-120-Utility für Interface USB-VCOM bzw. RS-232 (nur wenn vorhanden) konfiguriert werden. Als Beispiel für die serielle Kommunikation mit dem im AT-120 integrierten RFID- Reader-Modul dient das Skript AT-120 Sample.ttl, welches mit Tera Term ausgeführt werden kann. Tera Term ist ein Open-Source-Terminal-Emulator und kann unter https://www.heise.de/download/product/tera-term-51776/download runtergeladen und installiert werden. Das Skript AT-120 Sample.ttl führt die folgenden Funktionen in einer Loop aus: - LED/grün einschalten - Transponder-Tag scannen - Transponder-UID ausgeben - LED/grün ausschalten - LED/rot einschalten - Beeper ausgeben - 2 Sekunden Pause - LED/rot ausschalten Die API des RFID-Reader-Moduls ist in TWN4 API Reference DocRev13.pdf dokumentiert. Falls Sie den Skript AT-120 Sample.ttl ändern oder weiterentwickeln möchten, finden Sie die notwendigen Infos in der Tera-Term-Hilfe. Kundenspezifische App-Programmierung Das im AT-120 integrierte RFID-Reader-Modul TWN4 bietet die Möglichkeit das Verhalten durch das Laden einer kundenspezifischen App zu verändern. Folgende Schritte sind für die Programmierung einer App notwendig: 1. Laden Sie das Package AT-120 Tools and Documents 300b.zip von www.aitronic.de runter und entpacken Sie es in ein beliebiges Verzeichnis. Dieses Package enthält alle Tools und Dokumente, die zur Programmierung von Apps benötigt werden. Im Unterverzeichnis Docs befinden sich die folgenden Dokumente: - TWN4 System Overview DocRev13.pdf, - TWN4 Simple Protocol DocRev11.pdf, - TWN4 API Reference DocRev13.pdf, - TWN4 Director User Guide DocRev7.pdf, - TWN4 AppBlaster User Guide DocRev4.pdf, welche alle notwendigen Informationen zu den Tools und der Programmierung von Apps enthalten.

10 2. Konfigurieren Sie den AT-120 mit Hilfe der AT-120-Utility für Interface USB- VCOM bzw. RS-232 (optional). 3. Öffnen Sie den Quellcode der betreffenden App im Unterverzeichnis Apps mit einem beliebigen Editor (vorzuziehen ist ein für die Programmierung geeigneter Editor, z.b. Notepad++). Die Programmierung erfolgt in der Programmiersprache C). 4. Starten Sie im Hauptverzeichnis den AppBlaster. 5. Klicken Sie auf Source Code Project. 6. Klicken Sie im linken Feld auf Type of USB ( Template ), wählen Sie im rechten Feld Firmware Nano Module CDC V3.00 App Standard V2.00 und klicken Sie auf Select Template. 7. Klicken Sie im linken Feld Source Code Module, klicken Sie auf Select Source und wählen Sie die Source-Code-Datei der betreffenden App. 8. Editieren Sie nun den Source-Code (die API ist in TWN4 API Reference DocRev13.pdf dokumentiert) und speichern Sie die Änderungen. 9. Durch Klicken auf Create Image wird der Source-Code compiliert und ein ladbares Image wird erstellt. 10. Klicken Sie auf Settings und wählen Sie den COM-Port, an dem der AT-120 angeschlossen ist. 11. Klicken Sie auf Program Image um das Image der App in das TWN4-Modul zu laden. 12. Klicken Sie auf Settings und trennen Sie das betreffende COM-Port vom AT-120. Fahren Sie nun fort mit einer der beiden folgenden Beispiel-Apps auf der nächsten Seite.

11 Beispiel-App für Interface USB-VCOM bzw. RS-232 Als Beispiel wird die App App_SBC100_Status_Byte_Change.c aus dem Unterverzeichnis Apps verwendet. In dieser App werden folgende Funktionen in einer Endlosschleife ausgeführt: Lesen und Anzeigen der ID eines ISO15693-Transponder-Tags, Lesen des ersten Datenblocks (4 Byte) und Anzeigen des ersten Bytes, als "Status-Byte gelesen" im Hex-Code, Eingabe eines neuen Statusbytes im Hex-Code, Schreiben des neuen Status-Bytes in den Transponder-Tag. Nach Ausführung der im Abschnitt Kundenspezifische App-Programmierung beschriebenen Schritte 1. bis 12. sind folgende Schritte für das Testen der App auszuführen: 1. Stellen Sie mit einem beliebigen Terminal-Programm (z.b. TeraTerm, 9600 Bd, 8 Bit, 1 Stopbit, no Parity, no FlowControl) eine Verbindung mit dem AT-120 her. Das Terminal dient zur Kommunikation mit der jeweils installierten App. 2. Um weiteres Editieren, Compilieren und Laden der App auszuführen, trennen Sie das Terminal von der betreffenden Schnittstelle und fahren Sie fort mit Punkt 8 unter Abschnitt Kundenspezifische App-Programmierung

12 Beispiel-App für Interface USB-HID-Keyboard Als Beispiel wird die App App_PRS104_Simple_Protocol_ext_2Byte_dec.c aus dem Unterverzeichnis Apps verwendet. Diese App beinhaltet die Funktionalität der Standard-App Simple Protocol und ist um folgende Funktion erweitert: Von einer gelesenen Transponder-Id werden die letzten 2 Byte (4 Hex-Zeichen) im Dezimal-Format ausgegeben. Nach Ausführung der im Abschnitt Kundenspezifische App-Programmierung beschriebenen Schritte 1. bis 12. sind folgende Schritte für das Testen der App auszuführen: 1. Konfigurieren Sie den AT-120 mit Hilfe der AT-120-Utility für Interface USB- HID-Keyboard. 2. Verwenden Sie zum Testen eine beliebige Anwendung, die Tastatureingaben entgegen nimmt (Editor, Textverarbeitung, o.ä). Die letzten beiden Byte einer gescannten Transponder-Id sollten jetzt im Dezimalformat als Tastatureingaben ausgegeben werden. 3. Sollte wider Erwarten keine USB-HID-Ausgabe erfolgen, liegt der Verdacht nahe, dass das Ausgabe-Format nicht dem Protokoll entspricht, welches von der AT-120-Firmware geprüft wird. In diesem Fall empfiehlt es sich die Fehlersuche mit der Einstellung USB-VCOM bzw. RS-232 (wie im vorangehenden Beispiel) durchzuführen. 4. Um weiteres Editieren, Compilieren und Laden der App auszuführen, trennen Sie das Terminal von der betreffenden Schnittstelle und fahren Sie fort mit Punkt 8 unter Abschnitt Kundenspezifische App-Programmierung.

13 6. Technische Daten Anschluss Stromversorgung Optische und akustische Anzeigen LF-Tags HF-Tags Lesedistanz Abmessungen Gewicht Umgebungsbedingungen Betriebssysteme USB-HID (Tastatur), USB-Seriell (Virtual COM Port) über USB 2-farbige LED (grün: betriebsbereit, orange: Transponder gelesen ), akustisches Signal für Transponder gelesen 4100, 4102, 4200, 4050, 4150, 4450, 4550, AWID, CASI-RUSCO, HITAG 1, HITAG 2, HITAG S, Keri, Miro, Pyramid, TIRIS/HDX, UNIQUE, FDX-B, Q5, TITAN, T55x7, ZODIAC ISO14443A: MIFARE Classic 1k & 4k EV1, Mini, DESFire EV1, Plus S&X, Pro X, SmartMX, Ultralight, Ultralight EV1, Ultralight C, SLE44R35, SLE66Rxx (my-d move), LEGIC Advant, PayPass, NTAG2XX ISO14443B: Calypso incl. Innovatron radio protocol 14443-B, CEPAS, HID iclass, Moneo, PicoPass, SRI512, SRT512, SRI4K, SRIX4K ISO15693: EM4x33, EM4x35, HID iclass, ICODE SLI, LEGIC Advant, M24LR16/64, Tag-it, SRF55Vxx (my-d vicinity), PicoPass ISO18092 / NFC: NFCIP-1: Active and passive communication mode, Peer-to-Peer, NFC Forum Tag Type 1-4, Sony FeliCa bis ca. 2 cm 80 x 76 x 25 mm 76 g -20º C bis +50º C, relative Luftfeuchtigkeit 95 % (nicht kondensierend) Windows und Linux

14 7. Recycling-Verordnungen für Altgeräte Über die Regelungen der EU-Verordnung 2002/95/EC hinaus (Elektronikhersteller sind ab dem 13.08.2005 verpflichtet, Altgeräte auf eigene Kosten zu entsorgen), nehmen wir sämtliche von der aitronic GmbH in Verkehr gebrachte bzw. vertriebene elektronische Geräte und Zubehörteile zurück. Dabei ist es für uns unerheblich, wann das Gerät in den Verkehr gebracht wurde. Die Kosten für die Entsorgung werden von unserer Seite übernommen. Gemäß 9 Abs. 1 ElektroG bedarf es einer vom unsortierten Siedlungsabfall getrennten Entsorgung von elektronischen Altgeräten. Aus diesem Grund bitten wir Sie, Ihre Altgeräte auf keinen Fall über den normen Hausmüll, den Gelben Sack oder andere Entsorgungsformen und -systeme zu entsorgen. Schicken Sie uns Ihre Altgeräte und elektronischen Zubehörteile einfach zu. aitronic GmbH Altgeräterücknahme Balhorner Feld 10 33106 Paderborn Vermerken Sie dabei bitte im Begleitschreiben, dass es sich bei der Sendung um Altgeräte handelt, die Sie über uns entsorgen möchten. Bei Fragen stehen wir Ihnen gerne zur Verfügung. Tel. +49 5251 29816-0 E-Mail: info@aitronic.de