Hoe de MagTek MSR JPOS-driver te installeren

Dit artikel biedt de stapsgewijze procedure om de MagTek Magnetic Stripe Reader (MSR) JavaPOS (JPOS) driver voor Elo — nu onderdeel van Zebra Technologies systemen — te installeren, configureren en testen.

Benodigde hulpmiddelen

• Een Windows 7 of nieuwer computersysteem.
• Een MagTek MSR die werkt in HID-modus met PID 002 of 011 (dit zijn de standaard PIDs voor HID-modus).
• De MagTek USB MSR applicatie (gebruik deze tool om de lezer indien nodig naar HID-modus te veranderen en om de PID te verifiëren).
• Het MagTek JPOS Driver Package voor USB HID Swipe Readers.

Installatieprocedure

1. Download en pak het JPOS Driver Package voor USB HID Swipe Readers uit op uw lokale schijf.
2. Dubbelklik op het uitgepakte installatiebestand 99510116-116.zip om de setup wizard te starten.
3. Klik op Volgende om door de eerste welkom- en licentieovereenkomstschermen te gaan.
   
   

4. Bevestig de standaard doelmap. De standaard installatielocaties zijn:

   • Voor x86-platforms: C:\Program Files\OPOS\MagTek
   • Voor x64-platforms: C:\Program Files (x86)\OPOS\MagTek

   
   

5. Selecteer het type installatie. Kies Volledig om alle benodigde componenten voor de MagTek OPOS MSR te installeren en klik vervolgens op Volgende.
   
6. Als hierom wordt gevraagd, klik op Ja om de installatie van de vereiste Microsoft Visual C++ Runtime Libraries toe te staan.
   
7. Klik op Voltooien om de driverinstallatie af te ronden.
   

Onderhoudsnotitie: U kunt de driver-installatie-executable op elk gewenst moment in de toekomst opnieuw starten om de OPOS-driver aan te passen, te repareren of volledig te verwijderen van het systeem.

Testen van de OPOS-installatie

De MagTek UPOS 1.13 JavaPOS MSR Utility applicatie voert een JavaPOS Check Health-test uit op het apparaat op basis van de vooraf geregistreerde Logical Device Names (LDN) die zijn gedefinieerd via het jpos.xml-bestand.

1. Navigeer naar de service submap binnen de doelinstallatiemap (bijv. C:\Program Files (x86)\JavaPOS\MagTek\service).
2. Dubbelklik op het bestand MSRUtility.bat om de MagTek JavaPOS MSR Utility Check Health-applicatie te starten.

3. Gebruik in het applicatievenster de keuzelijst om de MSR Logical Device Name (LDN) voor uw via USB aangesloten apparaat te selecteren. De vooraf geregistreerde LDN's zijn:

   • MagTekMSR (vertegenwoordigt de niet-versleutelde lezer)
   • MagTekMSR_Encrypted (vertegenwoordigt de versleutelde lezer)

   

4. Klik in de utility op de functies Open, Claim en DeviceEnabled om de lezer te activeren.
5. Veeg een kaart. De velden in de utility (Track 1 Data, Track 2 Data en Track 3 Data) worden ingevuld afhankelijk van het type lezer.
   

Voorbeeld 1: Niet-versleutelde lezer

Bij gebruik van de MagTekMSR LDN met een niet-versleutelde lezer worden de juiste niet-versleutelde gegevensvelden gevuld met heldere tekstinformatie bij het vegen van een kaart.

Voorbeeld 2: Versleutelde lezer

Bij gebruik van de MagTekMSR_Encrypted LDN met een versleutelde lezer worden de juiste gegevensvelden gevuld met gemaskeerde tekstgegevens en versleutelde payload-blokken, samen met de aanvullende beveiligingsinformatie die nodig is voor decodering.

Gebruik van de MagTek voorbeeldapplicatie

De MagTek UPOS 1.13 JavaPOS MSR voorbeeldapplicatie toont de UPOS-eigenschappen, methoden en evenementen voor zowel niet-versleutelde als versleutelde lezers.

1. Navigeer naar de Sample submap binnen de installatiemap (bijv. C:\Program Files (x86)\JavaPOS\MagTek\service\Sample).
2. Dubbelklik op het bestand MSRSample.bat om de voorbeeldapplicatie te starten.
3. Selecteer uw MSR Logical Device Name uit de keuzelijst om te beginnen met het testen van de JavaPOS-operaties.
   

Parameterbeschrijvingen

• MSR Logical Device Name [Keuzelijst]: Bevat de JavaPOS geregistreerde LDN's die beschikbaar zijn voor instantiering via het jpos.xml-bestand.
• JavaPOS Open-methode [Knop]: Geeft de geselecteerde LDN door als stringparameter om het bijbehorende JavaPOS-apparaatobject te instantieren.
• JavaPOS Claim-methode [Knop]: Claimt het geïnstantieerde MSR-apparaatobject voor exclusief gebruik door de applicatie.
• JavaPOS DeviceEnabled-eigenschap [Selectievakje]: Schakelt het geclaimde MSR-apparaatobject in of uit.
• JavaPOS DataEventEnabled-eigenschap [Selectievakje]: Schakelt Data Events in of uit die vanuit het Service Object worden verzonden voor in de wachtrij staande leesgegevens. Volgens UPOS-standaarden wordt dit automatisch op false gezet na elk event; de applicatie moet het opnieuw inschakelen om de volgende swipe te ontvangen.
• JavaPOS CheckHealth-methode [Knop]: Roept de interne gezondheidscontrole aan en toont de resultaattekst in het uitvoervenster.
• JavaPOS ClearInput-methode [Knop]: Maakt alle in de wachtrij staande MSR-leesgegevens binnen het Service Object leeg.
• JavaPOS ClearInputProperties-methode [Knop]: Maakt alle eigenschappen leeg die zijn gevuld door de meest recente leesgegevens.
• Eigenschappen [Knop]: Roept alle algemene en apparaat-specifieke MSR-eigenschappen aan en toont deze in het uitvoervenster.
• JavaPOS DecodeData-eigenschap [Selectievakje]: Schakelt de MSR-specifieke DecodeData-eigenschap in of uit.
• JavaPOS ParseDecodeData-eigenschap [Selectievakje]: Schakelt de MSR-specifieke ParseDecodeData-eigenschap in of uit.
• JavaPOS TransmitSentinels-eigenschap [Selectievakje]: Schakelt de MSR-specifieke TransmitSentinels-eigenschap in of uit.
• TracksToRead [Keuzelijst]: Definieert de JavaPOS MSR-opties voor de te lezen sporen.
• DataEncryptionAlgorithm [Keuzelijst]: Bevat de ondersteunde versleutelingsalgoritmen (alleen van toepassing op versleutelde apparaten).
• RetrieveCardProperty [Keuzelijst]: Bevat de MSR-specifieke eigenschappen die overeenkomen met de geparseerde gegevens van de recent geveegde kaart.
• ErrorReportingType [Keuzelijst]: Geeft aan of foutmeldingen kaartgebaseerd of spoorgebaseerd zijn.
• JavaPOS DirectIO-methode [Knop]: Roept het voorbeeld van de DirectIO-methode aan.
• JavaPOS Statistics-methode [Knop]: Haalt de JavaPOS Statistics XML-string op en toont deze in een dialoogvenster.
• JavaPOS AutoDisable-eigenschap [Selectievakje]: Schakelt de Auto Disable-eigenschap in of uit, gebruikt voor gebeurtenisgestuurde inputcontrole.
• JavaPOS FreezeEvents-eigenschap [Selectievakje]: Schakelt de Freeze Events-eigenschap in of uit om te regelen wanneer evenementen door de applicatie worden ontvangen.
• JavaPOS Release (ReleaseDevice) methode [Knop]: Geeft het apparaatobject vrij van exclusief gebruik.
• JavaPOS Close me