So installieren Sie den MagTek MSR JPOS-Treiber

Dieser Artikel bietet eine 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 Zebra Technologies Systeme.

Benötigte Werkzeuge

• Ein Computersystem mit Windows 7 oder neuer.
• Ein MagTek MSR, das 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 Tool, um den Leser bei Bedarf in den HID-Modus zu wechseln und die PID zu überprüfen).
• Das MagTek JPOS-Treiberpaket für USB HID Swipe Reader.

Installationsverfahren

1. Laden Sie das JPOS-Treiberpaket für USB HID Swipe Reader herunter und entpacken Sie es auf Ihrem lokalen Laufwerk.

2. Doppelklicken Sie auf die entpackte Installationsdatei jpos.zip, um den Setup-Assistenten zu starten.

   Hinweis: Wenn Sie nach einem Entpackungspasswort gefragt werden, geben Sie bitte magtek2010 ein.
3. Klicken Sie auf Weiter, um die ersten Begrüßungs- 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. Wenn Sie während des Vorgangs dazu aufgefordert werden, klicken Sie auf Ja, um die Installation der erforderlichen Microsoft Visual C++ Runtime-Bibliotheken zuzulassen.
   
7. Klicken Sie auf Fertigstellen, um die Treiberinstallation abzuschließen.
   

Wartungshinweis: Sie können die ausführbare Treiberinstallationsdatei 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 basierend auf den vorregistrierten Logical Device Names (LDN) durch, 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 Utility-Felder (Track 1 Data, Track 2 Data und Track 3 Data) werden je nach Lesertyp mit Daten gefüllt.
   

Beispiel 1: Nicht verschlüsselter Leser

Bei Verwendung des MagTekMSR LDN mit einem nicht verschlüsselten Leser werden die entsprechenden unverschlüsselten Datenfelder beim Durchziehen einer Karte mit Klartextinformationen gefüllt.

Beispiel 2: Verschlüsselter Leser

Bei Verwendung des MagTekMSR_Encrypted LDN mit einem verschlüsselten Leser werden die entsprechenden Datenfelder mit maskierten Textdaten und verschlüsselten Nutzlastblöcken sowie den zusätzlichen Sicherheitsinformationen gefüllt, die für die Dekodierung 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 im Kombinationsfeld aus, um mit dem Testen der JavaPOS-Operationen zu beginnen.
   

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]: Übermittelt 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 zur exklusiven Anwendung.
• JavaPOS DeviceEnabled-Eigenschaft [Kontrollkästchen]: Aktiviert oder deaktiviert das beanspruchte MSR-Geräteobjekt.
• JavaPOS DataEventEnabled-Eigenschaft [Kontrollkästchen]: Aktiviert oder deaktiviert Datenereignisse, die vom Service-Objekt für wartende gelesene Daten gesendet werden. Gemäß UPOS-Standards wird dies nach jedem Ereignis automatisch auf false gesetzt; die Anwendung muss es erneut aktivieren, um den nächsten Kartenlesevorgang zu erhalten.
• JavaPOS CheckHealth-Methode [Schaltfläche]: Führt die interne Gesundheitsprüfung aus 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 belegt wurden.
• Eigenschaften [Schaltfläche]: Ruft alle allgemeinen und gerätespezifischen MSR-Eigenschaften ab 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 analysierten Daten der zuletzt durchgezogenen Karte entsprechen.
• ErrorReportingType [Kombinationsfeld]: Gibt an, ob die Fehlerberichterstattung kartenbasiert oder spurgebunden ist.
• JavaPOS DirectIO-Methode [Schaltfläche]: Ruft das Beispiel für die DirectIO-Methode auf.
• JavaPOS Statistics-Methode [Schaltfläche]: Ruft die JavaPOS-Statistiken als XML-String 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 zur Nicht-Exklusivnutzung frei.
• JavaPOS Close me