RFID-Reader AT-120 Bedienungsanleitung

Transkript

1 RFID-Reader AT-120 Bedienungsanleitung Ausgabe

2 RFID-Reader AT-120 Bedienungsanleitung Ausgabe

3 1. Allgemein LED-Anzeigen Reset AT-120-Utility... 5 Interface USB-HID-Keyboard...5 Interfaces USB-VCOM und RS-232 (optional)...6 AT-120-Konfigurationsparameter...7 Tag-Type-Character Kundenspezifische Anwendungen... 9 Kundenspezifische Host-Anwendung...10 Kundenspezifische App-Programmierung...11 Beispiel-App für Interface USB-VCOM bzw. RS Beispiel-App für Interface USB-HID-Keyboard Firmware-Updates AT-120-Firmware-Update...15 TWN4-App/Firmware-Update Technische Daten Recycling-Verordnungen für Altgeräte... 17

4 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 Paderborn Telefon: +49 (0) Telefax: +49 (0) Internet: Copyright aitronic GmbH, 2017 Alle Rechte vorbehalten, insbesondere auch auszugsweise die der Übersetzung, des Nachdrucks, Wiedergabe durch Kopieren oder ähnliche Verfahren. Liefermöglichkeiten und technische Änderungen vorbehalten

5 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:

6 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

7 3 Kundenspezifische App-Programmierung beschrieben.

8 4 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 <CR> <CR> <CR> <CR> <CR> <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.

9 5 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 das Interface 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.

10 6 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.

11 7 AT-120-Konfigurationsparameter Parameter LF-Tags HF-Tags Legic Read Data Segment Offset Count Version Type Suffix: None Enter Tab Prefix: Add Tag Type Use Alt-Key Byte Mirror Bit Mirror Use User Cmd (-1=off) Char Delay (ms) Double Timeout (sec) Apply Beschreibung Aktivierung der verschiedenen Tag-Typen. Nur die UIDs der ausgewählten Tag-Types werden ausgegeben. Für eine möglichst gute Lese- Performance, sollten nur die Tag-Typen aktiviert werden, die wirklich benötigt werden! Bei aktiviertem Parameter werden anstatt der UID Daten aus dem Tag gelesen. Mit den folgenden 3 Parametern muss angegeben werden, welche Daten ausgelesen werden sollen. Auszulesendes Segment Offset in Bytes relativ zum Segment-Anfang Anzahl auszulesender Bytes AT-120-Firmware-Version Transponder-Reader-Type Bei aktiviertem Parameter wird dem ausgegebenen String kein Suffix angehängt. Bei aktiviertem Parameter wird der ausgegebene String mit ENTER abgeschlossen. Bei aktiviertem Parameter wird der ausgegebene String mit TAB abgeschlossen. 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. Für die Ausgabe werden ALT-Keycodes verwendet. Bei aktiviertem Parameter werden die Bytes des ausgegebenen Strings gespiegelt. Bei aktiviertem Parameter werden die Bits der ausgegebenen Bytes gespiegelt. Wurde die Standard-App Simple Protocol durch eine kundenspezifische App ersetzt, in welcher ein oder mehrere kundenspezifische Kommandos (999x) implementiert sind, kann hier mit x (0 9) angegeben werden, welches Kommando ausgeführt werden soll. Mit -1 ist dieser Parameter deaktivert. Zeitverzögerung zwischen den einzelnen ausgegebenen Zeichen (in Millisekunden). Zeitfenster zur Verhinderung von Doppelerfassungen (in Sekunden). Die angezeigten Einstellungen werden in den Transponder-Reader geschrieben.

12 8 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 EM HITAGU 48 EM 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 ISO LEGIC 84 HID iclass 85 FeliCa 86 SRX 86 NFC Peer-to-Peer

13 9 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. Die kundenspezifische Host-Anwendung kommuniziert dabei direkt mit dem RFID-Reader-Modul. Zum Testen dieser Funktionalität kann die Utility Director verwendet werden. Kundenspezifische App-Programmierung Eine kundenspezifische App (als Erweiterung der Standard-App Simple Protocol ) 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.

14 10 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 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.

15 11 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 Regeln sind bei der Programmierung einer kundenspezifischen App strikt einzuhalten: 1. Die Baudrate von 9600 Bd darf nicht verstellt werden. 2. Die Funktionalität der Standard-App Simple Protocol muss erhalten bleiben. D.h. die kundenspezifische App muss auf dem Quellcode der Standard-App Simple Protocol basieren und darf nur eine Erweiterung dieser App darstellen. 3. Das 1. Byte von kundenspezifischen Kommandos muss 99 sein, das 2. Byte darf nur im Bereich definiert werden. Wird der AT-120 mit der der Einstellung Interface USB-HID-Keyboard betrieben, können Erweiterungen in einer kundenspezifischen App entweder durch Abfangen des Scan-Befehls eingebunden oder von der AT-120-Firmware bei aktiviertem Parameter Use User Cmd durch Aufrufen des entsprechenden User-Kommandos aufgerufen werden. Folgende Schritte sind für die Programmierung einer App notwendig: 1. Falls nicht bereits ausgeführt: Laden Sie die AT-120-Setup-Utility von der AT-120-Produktseite runter und installieren Sie diese. 2. Falls nicht bereits ausgeführt: Laden Sie das Package TWN4 Tools and Documents 300b.zip von der AT-120-Produktseite 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. 3. Konfigurieren Sie den AT-120 mit Hilfe der AT-120-Utility für Interface USB- VCOM bzw. RS-232 (optional). 4. Öffnen Sie den Quellcode der betreffenden App im Unterverzeichnis Apps mit einem beliebigen Editor (vorzuziehen ist ein für die Programmierung

16 12 geeigneter Editor, z.b. Notepad++). Die Programmierung erfolgt in der Programmiersprache C). 5. Starten Sie im Hauptverzeichnis den AppBlaster. 6. Klicken Sie auf Source Code Project. 7. 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. 8. Klicken Sie im linken Feld Source Code Module, klicken Sie auf Select Source und wählen Sie die Source-Code-Datei der betreffenden App. 9. Editieren Sie nun den Source-Code (die API ist in TWN4 API Reference DocRev13.pdf dokumentiert) und speichern Sie die Änderungen. 10. Durch Klicken auf Create Image wird der Source-Code compiliert und ein ladbares Image wird erstellt. 11. Klicken Sie auf Settings und wählen Sie den COM-Port, an dem der AT-120 angeschlossen ist. 12. Klicken Sie auf Program Image um das Image der App in das TWN4-Modul zu laden. 13. 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.

17 13 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

18 14 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.

19 15 6. Firmware-Updates AT-120-Firmware-Update Folgende Schritte sind für den AT-120-Firmware-Update notwendig: 1. Falls nicht bereits ausgeführt: Laden Sie die AT-120-Setup-Utility von der AT-120-Produktseite runter und installieren Sie diese. 2. Starten Sie die AT-120-Utility und führen Sie einen Reset am AT-120 aus. 3. Führen Sie die Menüfunktion File Update Firmware aus, wählen Sie das betreffende AT-120-Firmware-Image (Extension hex ) aus und warten Sie bis das Update abgeschlossen ist. TWN4-App/Firmware-Update Folgende Schritte sind für den TWN4-App/Firmware-Update notwendig: 1. Falls nicht bereits ausgeführt: Laden Sie die AT-120-Setup-Utility von der AT-120-Produktseite runter und installieren Sie diese. 2. Falls nicht bereits ausgeführt: Laden Sie das Package TWN4 Tools and Documents 300b.zip von der AT-120-Produktseite runter und entpacken Sie es in ein beliebiges Verzeichnis. 3. Konfigurieren Sie den AT-120 mit Hilfe der AT-120-Utility für Interface USB- VCOM bzw. RS-232 (optional). 4. Starten Sie den AppBlaster. 5. Klicken Sie auf Settings und wählen Sie den COM-Port, an dem der AT-120 angeschlossen ist. 6. Klicken Sie auf Select Image und wählen Sie das betreffende Firmware- Image (Extension bix ) aus. 7. Klicken Sie auf Program Firmware Image und warten Sie ab, bis das Firmware-Image programmiert ist. 8. Beenden Sie den AppBlaster 9. Stellen Sie im AT-120 mit Hilfe der AT-120-Utility unter Interface die ursprüngliche Einstellung wieder her (z.b. wenn vor dem Firmware-Update USB-HID-Keyboard eingestellt war).

20 16 7. 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 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

21 17 8. Recycling-Verordnungen für Altgeräte Über die Regelungen der EU-Verordnung 2002/95/EC hinaus (Elektronikhersteller sind ab dem 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 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 [email protected]