So installieren Sie den MagTek MSR JPOS-Treiber

Dieser Artikel bietet die Schritt-für-Schritt-Anleitung zur Installation, Konfiguration und zum Testen des MagTek Magnetic Stripe Reader (MSR) JavaPOS (JPOS) Treibers für Elo – jetzt Teil der Systeme von Zebra Technologies.

Benötigte Werkzeuge

• Ein Windows 7 oder neuer Computer-System.
• Ein MagTek MSR, der im HID-Modus mit PID 002 oder 011 arbeitet (dies sind die Standard-PIDs für den HID-Modus).
• Die MagTek USB MSR Anwendung (verwenden Sie dieses Dienstprogramm, um den Leser bei Bedarf in den HID-Modus zu wechseln und um die PID zu überprüfen).
• Das MagTek JPOS Treiberpaket für USB HID Swipe-Leser.

Installationsverfahren

1. Laden Sie das JPOS Treiberpaket für USB HID Swipe-Leser herunter und entpacken Sie es auf Ihrem lokalen Laufwerk.
2. Doppelklicken Sie auf die entpackte Installationsdatei 99510116-116.zip, um den Setup-Assistenten zu starten.
3. Klicken Sie auf Weiter, um die ersten Willkommens- und Lizenzvereinbarungsbildschirme zu durchlaufen.
   
   

4. Bestätigen Sie den Standard-Zielordner. Die Standard-Installationspfade sind:

   • Für x86-Plattformen: C:\Program Files\OPOS\MagTek
   • Für x64-Plattformen: C:\Program Files (x86)\OPOS\MagTek

   
   

5. Wählen Sie den Setup-Typ. Wählen Sie Vollständig, um alle notwendigen Komponenten für den MagTek OPOS MSR zu installieren, und klicken Sie dann auf Weiter.
   
6. Falls während des Vorgangs eine Aufforderung erscheint, klicken Sie auf Ja, um die Installation der erforderlichen Microsoft Visual C++ Runtime-Bibliotheken zu erlauben.
   
7. Klicken Sie auf Fertigstellen, um die Treiberinstallation abzuschließen.
   

Wartungshinweis: Sie können die ausführbare Treiber-Installationsdatei jederzeit erneut starten, um den OPOS-Treiber zu ändern, zu reparieren oder vollständig vom System zu entfernen.

Testen der OPOS-Installation

Die MagTek UPOS 1.13 JavaPOS MSR Utility-Anwendung führt einen JavaPOS Check Health-Test am Gerät durch, basierend auf den vorregistrierten Logical Device Names (LDN), die über die jpos.xml Datei definiert sind.

1. Navigieren Sie zum service-Unterordner im Ziel-Installationsverzeichnis (z. B. C:\Program Files (x86)\JavaPOS\MagTek\service).
2. Doppelklicken Sie auf die Datei MSRUtility.bat, um die MagTek JavaPOS MSR Utility Check Health-Anwendung zu starten.

3. Wählen Sie im Anwendungsfenster im Kombinationsfeld den MSR Logical Device Name (LDN) für Ihr USB-verbundenes Gerät aus. Die vorregistrierten LDNs sind:

   • MagTekMSR (repräsentiert den nicht-verschlüsselten Leser)
   • MagTekMSR_Encrypted (repräsentiert den verschlüsselten Leser)

   

4. Klicken Sie in der Utility auf die Funktionen Open, Claim und DeviceEnabled, um den Leser zu aktivieren.
5. Ziehen Sie eine Karte durch. Die Felder der Utility (Track 1 Data, Track 2 Data und Track 3 Data) werden je nach Lesertyp mit Daten gefüllt.
   

Beispiel 1: Nicht-verschlüsselter Leser

Wenn Sie den MagTekMSR LDN mit einem nicht-verschlüsselten Leser verwenden, werden beim Durchziehen einer Karte die entsprechenden unverschlüsselten Datenfelder mit Klartextinformationen gefüllt.

Beispiel 2: Verschlüsselter Leser

Wenn Sie den MagTekMSR_Encrypted LDN mit einem verschlüsselten Leser verwenden, werden die entsprechenden Datenfelder mit maskierten Textdaten und verschlüsselten Payload-Blöcken gefüllt, zusammen mit den zusätzlichen Sicherheitsinformationen, die für die Entschlüsselung erforderlich sind.

Verwendung der MagTek Beispielanwendung

Die MagTek UPOS 1.13 JavaPOS MSR Beispielanwendung demonstriert die UPOS-Eigenschaften, -Methoden und -Ereignisse für sowohl nicht-verschlüsselte als auch verschlüsselte Leser.

1. Navigieren Sie zum Sample-Unterordner im Installationsverzeichnis (z. B. C:\Program Files (x86)\JavaPOS\MagTek\service\Sample).
2. Doppelklicken Sie auf die Datei MSRSample.bat, um die Beispielanwendung zu starten.
3. Wählen Sie Ihren MSR Logical Device Name aus dem Kombinationsfeld, um die JavaPOS-Operationen zu testen.
   

Parameterbeschreibungen

• MSR Logical Device Name [Kombinationsfeld]: Enthält die JavaPOS registrierten LDNs, die über die jpos.xml Datei instanziiert werden können.
• JavaPOS Open Methode [Schaltfläche]: Übergibt den ausgewählten LDN als String-Parameter, um das zugehörige JavaPOS-Geräteobjekt zu instanziieren.
• JavaPOS Claim Methode [Schaltfläche]: Beansprucht das instanziierte MSR-Geräteobjekt für die exklusive Nutzung durch die Anwendung.
• JavaPOS DeviceEnabled Eigenschaft [Kontrollkästchen]: Aktiviert oder deaktiviert das beanspruchte MSR-Geräteobjekt.
• JavaPOS DataEventEnabled Eigenschaft [Kontrollkästchen]: Aktiviert oder deaktiviert Data Events, die vom Service-Objekt für wartende gelesene Daten gesendet werden. Gemäß UPOS-Standard wird dies nach jedem Ereignis automatisch auf false gesetzt; die Anwendung muss es erneut aktivieren, um den nächsten Swipe zu empfangen.
• JavaPOS CheckHealth Methode [Schaltfläche]: Ruft die interne Gesundheitsprüfung auf und zeigt das Ergebnis im Ausgabefenster an.
• JavaPOS ClearInput Methode [Schaltfläche]: Löscht alle wartenden MSR-Lesedaten im Service-Objekt.
• JavaPOS ClearInputProperties Methode [Schaltfläche]: Löscht alle Eigenschaften, die durch die zuletzt gelesenen Daten befüllt wurden.
• Properties [Schaltfläche]: Ruft alle allgemeinen und gerätespezifischen MSR-Eigenschaften auf und zeigt sie im Ausgabefenster an.
• JavaPOS DecodeData Eigenschaft [Kontrollkästchen]: Aktiviert oder deaktiviert die MSR-spezifische DecodeData-Eigenschaft.
• JavaPOS ParseDecodeData Eigenschaft [Kontrollkästchen]: Aktiviert oder deaktiviert die MSR-spezifische ParseDecodeData-Eigenschaft.
• JavaPOS TransmitSentinels Eigenschaft [Kontrollkästchen]: Aktiviert oder deaktiviert die MSR-spezifische TransmitSentinels-Eigenschaft.
• TracksToRead [Kombinationsfeld]: Definiert die JavaPOS MSR-Optionen für die zu lesenden Spuren.
• DataEncryptionAlgorithm [Kombinationsfeld]: Enthält die unterstützten Verschlüsselungsalgorithmen (gilt nur für verschlüsselte Geräte).
• RetrieveCardProperty [Kombinationsfeld]: Enthält die MSR-spezifischen Eigenschaften, die den geparsten Daten der zuletzt durchgezogenen Karte entsprechen.
• ErrorReportingType [Kombinationsfeld]: Gibt an, ob die Fehlerberichterstattung kartenbasiert oder spur-basiert erfolgt.
• JavaPOS DirectIO Methode [Schaltfläche]: Ruft das Beispiel für die DirectIO-Methode auf.
• JavaPOS Statistics Methode [Schaltfläche]: Ruft die JavaPOS Statistik-XML-Zeichenkette ab und zeigt sie in einem Dialogfenster an.
• JavaPOS AutoDisable Eigenschaft [Kontrollkästchen]: Schaltet die Auto-Disable-Eigenschaft um, die für ereignisgesteuerte Eingabesteuerung verwendet wird.
• JavaPOS FreezeEvents Eigenschaft [Kontrollkästchen]: Schaltet die Freeze-Events-Eigenschaft um, um zu steuern, wann Ereignisse von der Anwendung empfangen werden.
• JavaPOS Release (ReleaseDevice) Methode [Schaltfläche]: Gibt das Geräteobjekt für die exklusive Nutzung frei.
• JavaPOS Close me