RFID-Reader AT-120 Bedienungsanleitung - Aitronic · 2018-11-22 · Use User Cmd ( -1=off) Wurde...

29
RFID-Reader AT-120 Bedienungsanleitung ab Firmware v2.05 und AT-120-Utility v1.30 Ausgabe 22.11.2018

Transcript of RFID-Reader AT-120 Bedienungsanleitung - Aitronic · 2018-11-22 · Use User Cmd ( -1=off) Wurde...

Page 1: RFID-Reader AT-120 Bedienungsanleitung - Aitronic · 2018-11-22 · Use User Cmd ( -1=off) Wurde die StandardApp „Simple Protocol“ durch eine kundenspezifische App ersetzt, in

RFID-Reader AT-120 Bedienungsanleitung ab Firmware v2.05 und AT-120-Utility v1.30 Ausgabe 22.11.2018

Page 2: RFID-Reader AT-120 Bedienungsanleitung - Aitronic · 2018-11-22 · Use User Cmd ( -1=off) Wurde die StandardApp „Simple Protocol“ durch eine kundenspezifische App ersetzt, in

RFID-Reader AT-120 Bedienungsanleitung ab Firmware v2.05 und AT-120-Utility v1.30 Ausgabe 22.11.2018

Page 3: RFID-Reader AT-120 Bedienungsanleitung - Aitronic · 2018-11-22 · Use User Cmd ( -1=off) Wurde die StandardApp „Simple Protocol“ durch eine kundenspezifische App ersetzt, in

1. Allgemein .......................................................................... 1

2. LED-Anzeigen ................................................................... 5

3. Config-Taster .................................................................... 5

4. AT-120-Utility .................................................................... 6

Interface USB-HID-Keyboard .............................................................................7

Interface USB-VCOM/RS-232 .............................................................................8

Interfaces USB-VCOM und RS-232 (optional) ..................................................9

Auslesen von RFID-Tag-Daten ........................................................................10

AT-120-Konfigurationsparameter ....................................................................11

Tag-Type-Character ..........................................................................................13

5. Kundenspezifische Anwendungen ............................... 14

Kundenspezifische Host-Anwendung ............................................................15

Kundenspezifische App-Programmierung .....................................................16 Beispiel-App für Interface USB-VCOM bzw. RS-232 .......................................18 Beispiel-App für Interface USB-HID-Keyboard .................................................19

Laden einer kundenspezifischen App (.bix) ...................................................20

6. Firmware-Updates .......................................................... 21

AT-120-Firmware-Update .................................................................................21

TWN4-App/Firmware-Update ...........................................................................21

7. Technische Daten .......................................................... 22

8. Recycling-Verordnungen für Altgeräte ........................ 25

Page 4: RFID-Reader AT-120 Bedienungsanleitung - Aitronic · 2018-11-22 · Use User Cmd ( -1=off) Wurde die StandardApp „Simple Protocol“ durch eine kundenspezifische App ersetzt, in

RFID-Reader AT-120 Bedienungsanleitung_____________________________________

Ausgabe 22.11.2018 ___________________________________________________ aitronic

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: [email protected] ___________________________________________________________

Copyright aitronic GmbH, 2018 Alle Rechte vorbehalten, insbesondere auch auszugsweise die der Übersetzung, des Nachdrucks, Wiedergabe durch Kopieren oder ähnliche Verfahren. Liefermöglichkeiten und technische Änderungen vorbehalten

Page 5: RFID-Reader AT-120 Bedienungsanleitung - Aitronic · 2018-11-22 · Use User Cmd ( -1=off) Wurde die StandardApp „Simple Protocol“ durch eine kundenspezifische App ersetzt, in

RFID-Reader AT-120 Bedienungsanleitung_____________________________________

Ausgabe 22.11.2018 ___________________________________________________ aitronic

1

1. Allgemein

Der AT-120 ist ein kompaktes Gerät für den kontakt- und berührungslosen Datenaustausch mit allen handelsüblichen Transponder-Tags und eignet sich für eine Vielzahl von Anwendungen in Büro, Verwaltung und Industrie. Der AT-120 unterstützt die Schnittstellen USB und RS-232, wobei die USB-Schnittstelle das HID- und VCOM-Profile unterstützt. Folgende Tabelle gibt eine Übersicht, welche Funktionen mit welcher Schnittstelle bzw. Modus möglich sind. Der „direct mode“ bedeutet, dass das im AT-120 integrierte RFID-Modul über eine serielle Schnittstelle (RS-232 oder VCOM) gesteuert wird. „automatisch lesen“ bedeutet, dass für das Lesen von UID bzw. Transponder-Tag-Daten lediglich das Heranführen eines Transponder-Tags an den AT-120 erforderlich ist.

Interface, Mode

UID

automatisch

lesen

Daten

automatisch

lesen

UID und

Daten

lesen

Daten

schreiben

USB-HID-Keyboard ja ja 1 - -

USB-VCOM kein „direct mode“

ja ja 1 - -

RS-232 2

kein „direct mode“ ja ja 1 - -

USB-VCOM „direct mode“

- - ja ja

RS-232 2 „direct mode“

- - ja ja

1 nur für HITAG1, HITAG2, ISO15693 und LEGIC (optional). 2 RS-232-Anschluss optional.

Page 6: RFID-Reader AT-120 Bedienungsanleitung - Aitronic · 2018-11-22 · Use User Cmd ( -1=off) Wurde die StandardApp „Simple Protocol“ durch eine kundenspezifische App ersetzt, in

RFID-Reader AT-120 Bedienungsanleitung_____________________________________

Ausgabe 22.11.2018 ___________________________________________________ aitronic

2

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:

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.

Page 7: RFID-Reader AT-120 Bedienungsanleitung - Aitronic · 2018-11-22 · Use User Cmd ( -1=off) Wurde die StandardApp „Simple Protocol“ durch eine kundenspezifische App ersetzt, in

RFID-Reader AT-120 Bedienungsanleitung_____________________________________

Ausgabe 22.11.2018 ___________________________________________________ aitronic

3

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

Page 8: RFID-Reader AT-120 Bedienungsanleitung - Aitronic · 2018-11-22 · Use User Cmd ( -1=off) Wurde die StandardApp „Simple Protocol“ durch eine kundenspezifische App ersetzt, in

RFID-Reader AT-120 Bedienungsanleitung_____________________________________

Ausgabe 22.11.2018 ___________________________________________________ aitronic

4

Kundenspezifische App-Programmierung beschrieben.

Page 9: RFID-Reader AT-120 Bedienungsanleitung - Aitronic · 2018-11-22 · Use User Cmd ( -1=off) Wurde die StandardApp „Simple Protocol“ durch eine kundenspezifische App ersetzt, in

RFID-Reader AT-120 Bedienungsanleitung_____________________________________

Ausgabe 22.11.2018 ___________________________________________________ aitronic

5

2. LED-Anzeigen

Grün Betriebsbereit

Grün/Rot blinkend Konfigurationsmode

Orange Quittung für gelesenen Transponder-Tag in Grundein-

stellung 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 Kommando

GPIO Output Rote LED 0400010101<CR>

GPIO Output Grüne LED 0400020101<CR>

Rote LED ein 040201<CR>

Rote LED aus 040301<CR>

Grüne LED ein 040202<CR>

Grüne LED aus 040302<CR>

3. Config-Taster

Der Config-Taster befindet sich hinter dem kleinen Loch neben der USB-Buchse und kann mit einer Büroklammer o.ä. betätigt werden. Nach Drücken des Config-Tasters werden die 3 Zeichen 00<CR> (Hex-Code: 0x30, 0x30, 0x0D) auf der

Schnittstelle ausgegeben.

Page 10: RFID-Reader AT-120 Bedienungsanleitung - Aitronic · 2018-11-22 · Use User Cmd ( -1=off) Wurde die StandardApp „Simple Protocol“ durch eine kundenspezifische App ersetzt, in

RFID-Reader AT-120 Bedienungsanleitung_____________________________________

Ausgabe 22.11.2018 ___________________________________________________ aitronic

6

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 Drücken des Config-Tasters wird in

Abhängigkeit vom eingestellten Interface der Screen für das Interface USB-HID-

Keyboard, USB-VCOM/RS-232, USB-VCOM oder RS-232 angezeigt. Es sind nur die Parameter-Felder aktiv, die für den jeweils eingestellten Mode eine Auswirkung haben.

Page 11: RFID-Reader AT-120 Bedienungsanleitung - Aitronic · 2018-11-22 · Use User Cmd ( -1=off) Wurde die StandardApp „Simple Protocol“ durch eine kundenspezifische App ersetzt, in

RFID-Reader AT-120 Bedienungsanleitung_____________________________________

Ausgabe 22.11.2018 ___________________________________________________ aitronic

7

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. Wird ein mit Datenspeicher ausgestatteter Tag-Typ (mit * markiert) unter gleichzeitigem Festhalten der Shift-Taste angewählt, wird der Button „Read Data“ eingeblendet. Nach Anklicken von „Read Data“ können die Einstellungen für das

Auslesen des Datenspeichers vorgenommen werden (siehe Abschnitt Auslesen

von RFID-Tag-Daten).

Page 12: RFID-Reader AT-120 Bedienungsanleitung - Aitronic · 2018-11-22 · Use User Cmd ( -1=off) Wurde die StandardApp „Simple Protocol“ durch eine kundenspezifische App ersetzt, in

RFID-Reader AT-120 Bedienungsanleitung_____________________________________

Ausgabe 22.11.2018 ___________________________________________________ aitronic

8

Interface USB-VCOM/RS-232

Ist Interface USB-VCOM/RS-232 angewählt, werden die UIDs von gelesen Transponder-Tags auf der USB-Schnittstelle im VCOM-Modus an die Host-Applikation ausgegeben. Wird ein mit Datenspeicher ausgestatteter Tag-Typ (mit * markiert) unter gleichzeitigem Festhalten der Shift-Taste angewählt, wird der Button „Read Data“ eingeblendet. Nach Anklicken von „Read Data“ können die Einstellungen für das

Auslesen des Datenspeichers vorgenommen werden (siehe Abschnitt Auslesen

von RFID-Tag-Daten).

Page 13: RFID-Reader AT-120 Bedienungsanleitung - Aitronic · 2018-11-22 · Use User Cmd ( -1=off) Wurde die StandardApp „Simple Protocol“ durch eine kundenspezifische App ersetzt, in

RFID-Reader AT-120 Bedienungsanleitung_____________________________________

Ausgabe 22.11.2018 ___________________________________________________ aitronic

9

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.

Page 14: RFID-Reader AT-120 Bedienungsanleitung - Aitronic · 2018-11-22 · Use User Cmd ( -1=off) Wurde die StandardApp „Simple Protocol“ durch eine kundenspezifische App ersetzt, in

RFID-Reader AT-120 Bedienungsanleitung_____________________________________

Ausgabe 22.11.2018 ___________________________________________________ aitronic

10

Wird ein mit Datenspeicher ausgestatteter Tag-Typ (mit * markiert) unter gleichzeitigem Festhalten der Shift-Taste angewählt, wird der Button „Read Data“ eingeblendet. Nach Anklicken von „Read Data“ können die Einstellungen für das

Auslesen des Datenspeichers vorgenommen werden (siehe Abschnitt Auslesen

von RFID-Tag-Daten). Die Kommandos, die in diesem Mode von der Host-Applikation verwendet werden können, ist dem Dokument „TWN4 Simple Protocol DocRev11.pdf“ zu entnehmen.

Auslesen von RFID-Tag-Daten

Block Nummer des auszulesenden Blockes.

Offset Offset zum Blockanfang.

Count Anzahl auszulesender Bytes.

Flags ISO 15693 Flags. Der Wert ist im Hex-Code anzugeben.

Page 15: RFID-Reader AT-120 Bedienungsanleitung - Aitronic · 2018-11-22 · Use User Cmd ( -1=off) Wurde die StandardApp „Simple Protocol“ durch eine kundenspezifische App ersetzt, in

RFID-Reader AT-120 Bedienungsanleitung_____________________________________

Ausgabe 22.11.2018 ___________________________________________________ aitronic

11

AT-120-Konfigurationsparameter

Allgemeine Parameter

Type Transponder-Reader-Typ

Version AT-120-Firmware-Version

HW Hardware-Version

BIX Version der im RFID-Modul gespeicherten Basis-App

UBIX Version der vom User vorgenommenen Erweiterung der Basis-App

Baud Baudrate der seriellen Schnittstelle

Tag-Typen und Datenspeicher

LF-Tags

Aktivierung der verschiedenen Tag-Typen. Nur die UIDs bzw. Daten der ausgewählten Tag-Typen werden ausgegeben. Tag-Typen, die mit * markiert sind, enthalten einen Datenspeicher. Für diese Typen, können anstatt der UID auch Daten ausgegeben werden, indem der Tag-Typ bei gleichzeitigem Drücken der SHIFT-Taste aktiviert (Tag-Typ wird gelb markiert) und nach Klicken auf „Read Data“ der gewünschte Datenbereich

angegeben wird. Für eine möglichst gute Lese-

Performance, sollten nur die Tag-Typen aktiviert

werden, die wirklich benötigt werden!

HF-Tags

Read

Data

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.

Block Auszulesender Block

Offset Offset in Bytes relativ zum Segment-Anfang

Count Anzahl auszulesender Bytes

Output-Optionen

Suffix für USB-HID-Keyboard

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.

Semicolon Bei aktiviertem Parameter wird der ausgegebene

String mit Semikolon abgeschlossen.

Page 16: RFID-Reader AT-120 Bedienungsanleitung - Aitronic · 2018-11-22 · Use User Cmd ( -1=off) Wurde die StandardApp „Simple Protocol“ durch eine kundenspezifische App ersetzt, in

RFID-Reader AT-120 Bedienungsanleitung_____________________________________

Ausgabe 22.11.2018 ___________________________________________________ aitronic

12

Suffix für USB-VCOM-RS-232

None Bei aktiviertem Parameter wird dem ausgegebenen String kein Suffix angehängt.

CR Bei aktiviertem Parameter wird der ausgegebene

String mit CR abgeschlossen.

LF Bei aktiviertem Parameter wird der ausgegebene

String mit LF abgeschlossen.

CR/LF Bei aktiviertem Parameter wird der ausgegebene

String mit CR/LF abgeschlossen.

Prefix: Add Tag Type für USB-HID-Keyboard und USB-VCOM-RS-232

Wenn dieser Parameter aktiviert ist, wird die UID durch 2 Zeichen angeführt, die den Tag-Typ repräsentieren.

Byte Mirror Bei aktiviertem Parameter werden die Bytes des ausgegebenen Strings gespiegelt.

Bit Mirror Bei aktiviertem Parameter werden die Bits der ausgegebenen Bytes gespiegelt.

Use User Cmd (-1=off) 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.

Double Timeout (sec) Zeitfenster zur Verhinderung von Doppelerfassungen (in Sekunden).

HID-Keyboard-Optionen

Use Alt-Key Für die Ausgabe werden ALT-Keycodes verwendet.

Char Delay (ms) Zeitverzögerung zwischen den einzelnen ausgegebenen Zeichen (in Millisekunden).

Parameter speichern

Apply Die angezeigten Einstellungen werden in den Transponder-Reader geschrieben.

Page 17: RFID-Reader AT-120 Bedienungsanleitung - Aitronic · 2018-11-22 · Use User Cmd ( -1=off) Wurde die StandardApp „Simple Protocol“ durch eine kundenspezifische App ersetzt, in

RFID-Reader AT-120 Bedienungsanleitung_____________________________________

Ausgabe 22.11.2018 ___________________________________________________ aitronic

13

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

Page 18: RFID-Reader AT-120 Bedienungsanleitung - Aitronic · 2018-11-22 · Use User Cmd ( -1=off) Wurde die StandardApp „Simple Protocol“ durch eine kundenspezifische App ersetzt, in

RFID-Reader AT-120 Bedienungsanleitung_____________________________________

Ausgabe 22.11.2018 ___________________________________________________ aitronic

14

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.

Page 19: RFID-Reader AT-120 Bedienungsanleitung - Aitronic · 2018-11-22 · Use User Cmd ( -1=off) Wurde die StandardApp „Simple Protocol“ durch eine kundenspezifische App ersetzt, in

RFID-Reader AT-120 Bedienungsanleitung_____________________________________

Ausgabe 22.11.2018 ___________________________________________________ aitronic

15

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 weiter-entwickeln möchten, finden Sie die notwendigen Infos in der Tera-Term-Hilfe.

Page 20: RFID-Reader AT-120 Bedienungsanleitung - Aitronic · 2018-11-22 · Use User Cmd ( -1=off) Wurde die StandardApp „Simple Protocol“ durch eine kundenspezifische App ersetzt, in

RFID-Reader AT-120 Bedienungsanleitung_____________________________________

Ausgabe 22.11.2018 ___________________________________________________ aitronic

16

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 „90“… „99“ definiert werden. Wird der AT-120 mit der Einstellung „Interface USB-HID-Keyboard“ betrieben, können Erweiterungen in einer kundenspezifischen App entweder durch „Abfangen“ des Scan-Befehls eingebunden werden. 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 https://www.aitronic.de/de/rfid-radio-frequency-identification/rfid-lesegeraet-at-120 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 https://www.aitronic.de/de/rfid-radio-frequency-identification/rfid-lesegeraet-at-120 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 (direct mode) 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 geeigneter Editor, z.B. Notepad++). Die Programmierung erfolgt in der Programmiersprache C).

Page 21: RFID-Reader AT-120 Bedienungsanleitung - Aitronic · 2018-11-22 · Use User Cmd ( -1=off) Wurde die StandardApp „Simple Protocol“ durch eine kundenspezifische App ersetzt, in

RFID-Reader AT-120 Bedienungsanleitung_____________________________________

Ausgabe 22.11.2018 ___________________________________________________ aitronic

17

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.

Page 22: RFID-Reader AT-120 Bedienungsanleitung - Aitronic · 2018-11-22 · Use User Cmd ( -1=off) Wurde die StandardApp „Simple Protocol“ durch eine kundenspezifische App ersetzt, in

RFID-Reader AT-120 Bedienungsanleitung_____________________________________

Ausgabe 22.11.2018 ___________________________________________________ aitronic

18

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

Page 23: RFID-Reader AT-120 Bedienungsanleitung - Aitronic · 2018-11-22 · Use User Cmd ( -1=off) Wurde die StandardApp „Simple Protocol“ durch eine kundenspezifische App ersetzt, in

RFID-Reader AT-120 Bedienungsanleitung_____________________________________

Ausgabe 22.11.2018 ___________________________________________________ aitronic

19

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 Tastatur-eingaben 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.

Page 24: RFID-Reader AT-120 Bedienungsanleitung - Aitronic · 2018-11-22 · Use User Cmd ( -1=off) Wurde die StandardApp „Simple Protocol“ durch eine kundenspezifische App ersetzt, in

RFID-Reader AT-120 Bedienungsanleitung_____________________________________

Ausgabe 22.11.2018 ___________________________________________________ aitronic

20

Laden einer kundenspezifischen App (.bix) 1. Falls nicht bereits ausgeführt: Laden Sie die AT-120-Setup-Utility von der

AT-120-Produktseite https://www.aitronic.de/de/rfid-radio-frequency-identification/rfid-lesegeraet-at-120 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 https://www.aitronic.de/de/rfid-radio-frequency-identification/rfid-lesegeraet-at-120 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.

3. Konfigurieren Sie den AT-120 mit Hilfe der AT-120-Utility für Interface USB-

VCOM (direct mode) bzw. RS-232 (optional). 4. Starten Sie AppBlaster.exe aus dem Verzeichnis „TWN4 Tools and

Documents“. 5. Klicken Sie auf „Program Firmware Image“. 6. Klicken Sie auf „Settings“, um für die Verbindung zum RFID-Modul den

betreffenden seriellen Port auszuwählen. 7. Klicken Sie auf „Select Image“ um das Image der betreffenden App (Extension

.bix) auszuwählen. 8. Klicken Sie auf „Program Image“ und warten Sie bis die Programmierung

abgeschlossen ist. Hinweis: Eine evtl. auftretende Fehlermeldung „Keine Rückmeldung“ kann ignoriert werden.

9. Schließen Sie den AppBlaster und programmieren Sie das Interface des AT-120 mit Hilfe der AT-120-Utility auf die ursprüngliche Einstellung.

Page 25: RFID-Reader AT-120 Bedienungsanleitung - Aitronic · 2018-11-22 · Use User Cmd ( -1=off) Wurde die StandardApp „Simple Protocol“ durch eine kundenspezifische App ersetzt, in

RFID-Reader AT-120 Bedienungsanleitung_____________________________________

Ausgabe 22.11.2018 ___________________________________________________ aitronic

21

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 https://www.aitronic.de/de/rfid-radio-frequency-identification/rfid-lesegeraet-at-120 runter und installieren Sie diese.

2. Starten Sie die AT-120-Utility und führen drücken Sie den Config-Taster am AT-120.

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 https://www.aitronic.de/de/rfid-radio-frequency-identification/rfid-lesegeraet-at-120 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 https://www.aitronic.de/de/rfid-radio-frequency-identification/rfid-lesegeraet-at-120 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).

Page 26: RFID-Reader AT-120 Bedienungsanleitung - Aitronic · 2018-11-22 · Use User Cmd ( -1=off) Wurde die StandardApp „Simple Protocol“ durch eine kundenspezifische App ersetzt, in

RFID-Reader AT-120 Bedienungsanleitung_____________________________________

Ausgabe 22.11.2018 ___________________________________________________ aitronic

22

7. Technische Daten

Anschluss USB-HID (Tastatur), USB-Seriell (Virtual COM Port), RS-232 (optional)

Stromversorgung über USB

Optische und

akustische Anzeigen

2-farbige LED (grün: „betriebsbereit“, orange: „Transponder gelesen“), akustisches Signal für „Transponder gelesen“

RFID-LF/HF-Reader-

Modul Standard oder

LEGIC

Unterstützte Transponder-Tag-Typen siehe nächste Seiten

Lesedistanz bis ca. 2 cm

Abmessungen 80 x 76 x 25 mm

Gewicht 76 g

Umgebungs-

bedingungen

-20º C bis +50º C, relative Luftfeuchtigkeit 95 % (nicht kondensierend)

Betriebssysteme Windows und Linux

Page 27: RFID-Reader AT-120 Bedienungsanleitung - Aitronic · 2018-11-22 · Use User Cmd ( -1=off) Wurde die StandardApp „Simple Protocol“ durch eine kundenspezifische App ersetzt, in

RFID-Reader AT-120 Bedienungsanleitung_____________________________________

Ausgabe 22.11.2018 ___________________________________________________ aitronic

23

Tag-Typ

Reader-Typ

Standard LEGIC 1

3,5

MH

z

ISO

14443A

LEGIC Advant ✔ 1) ✔

MIFARE: Classic/DESFire EV1/Mini/Plus S & X/Ultralight/Ultralight C & EV1

✔ ✔

MIFARE Classic EV1 ✔ 5) ✔ 5)

MIFARE DESFire EV2 ✔ 5) ✔ 5)

MIFARE Pro X, Smart MX ✔ 6) ✔ 6)

LEGIC Prime ✔

NTAG2xx, SLE44R35 ✔ ✔

PayPass ✔ 6) ✔ 6)

SLE66Rxx (my-d move) ✔ 6) ✔ 6)

Topaz ✔

ISO

14443B

Calypso, CEPAS, Moneo ✔ 6) ✔ 6)

Calypso Innovatron protocol ✔ 5)

Pico Pass ✔ 2) ✔ 1)

SRI4K, SRIX4K, SRI512, SRT512 ✔

HID iCLASS ✔ 1) ✔ 1)

ISO

18092 /

EC

MA

-340 NFC Forum Tag 1-5 ✔

NFC Peer-to-Peer, NFC active and passive communication mode

✔ ✔

Sony FeliCa ✔ 7) ✔ 7)

Passive peer-to-peer mode - initiator, NFC Tag 2/3/4

ISO

15693

EM4x33, EM4x35 ✔ 6) ✔ 6)

HID iCLASS, HID iCLASS SE/SR ✔ 1) ✔ 1)

ICODE SLI, Tag-it ✔ ✔

LEGIC Advant ✔ 1) ✔

M24LR16/64 ✔ ✔

MB89R118/119 ✔ 12)

SRF55Vxx (my-d vicinity) ✔ 6) ✔ 6)

Pico Pass ✔ 2) ✔ 1)

LEGIC Prime ✔ ✔

1) UID only, 2) UID Only, read/write on request, 3) on request, 4) r/w, enhanced security

features on request, 5) r/w in direct chip command mode, 6) UID + r/w public area, 7) without

crypto, 8) hash value only, 9) UID + PAC (CSN & Facility Code), r/w on request, 10) only

emulation of 4100, 4102, 11) supported by TWN4 MultiTech 2/3 BLE and TWN4 MultiTech

Nano only, 12) not supported by TWN4 MultiTech HF Mini, 13) AES only

Page 28: RFID-Reader AT-120 Bedienungsanleitung - Aitronic · 2018-11-22 · Use User Cmd ( -1=off) Wurde die StandardApp „Simple Protocol“ durch eine kundenspezifische App ersetzt, in

RFID-Reader AT-120 Bedienungsanleitung_____________________________________

Ausgabe 22.11.2018 ___________________________________________________ aitronic

24

Tag-Typ Reader-Typ

Standard LEGIC 1

25

kH

z /

13

4,2

kH

z

AWID, Cardax, CASI-RUSCO, FDX-B ✔ ✔

Cotag ✔

Deister ✔ 9) ✔ 9)

EM4100, 4102, 4105, 4050, 4150, 4450, 4550 ✔ ✔

EM4200 ✔ 12) ✔ 12)

EM4305 ✔ 4) ✔ 4)

G-Prox ✔ 9) ✔ 9)

HID iCLASS Elite & SE Elite ✔

HITAG 1, 2, S ✔ 8) ✔ 8)

ICT ✔ 4) ✔ 4)

IDTECK ✔ ✔

Isonas ✔ 4) ✔ 4)

Keri, Miro, PAC, Pyramid, Q5, UNIQUE ✔ ✔

Nedap ✔ 9) ✔ 9)

T5557, T5567, T5577 ✔ ✔

TIRIS/HDX ✔ ✔

TITAN (EM4050) ✔ ✔

ZODIAC ✔ ✔

1) UID only, 2) UID Only, read/write on request, 3) on request, 4) r/w, enhanced security

features on request, 5) r/w in direct chip command mode, 6) UID + r/w public area, 7) without

crypto, 8) hash value only, 9) UID + PAC (CSN & Facility Code), r/w on request, 10) only

emulation of 4100, 4102, 11) supported by TWN4 MultiTech 2/3 BLE and TWN4 MultiTech

Nano only, 12) not supported by TWN4 MultiTech HF Mini, 13) AES only

Page 29: RFID-Reader AT-120 Bedienungsanleitung - Aitronic · 2018-11-22 · Use User Cmd ( -1=off) Wurde die StandardApp „Simple Protocol“ durch eine kundenspezifische App ersetzt, in

RFID-Reader AT-120 Bedienungsanleitung_____________________________________

Ausgabe 22.11.2018 ___________________________________________________ aitronic

25

8. 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: [email protected]