How to Install the MagTek MSR JPOS Driver

This article provides the step-by-step procedure to install, configure, and test the MagTek Magnetic Stripe Reader (MSR) JavaPOS (JPOS) driver for Elo — Now part of Zebra Technologies systems.

Tools Needed

• A Windows 7 or newer computer system.
• A MagTek MSR operating in HID Mode with PID 002 or 011 (these are the default PIDs for HID Mode).
• The MagTek USB MSR application (use this utility to change the reader to HID mode if needed, and to verify the PID).
• The MagTek JPOS Driver Package for USB HID Swipe Readers.

Installation Procedure

1. Download and extract the JPOS Driver Package for USB HID Swipe Readers to your local drive.
2. Double-click the extracted 99510116-116.zip installation file to launch the setup wizard.
3. Click Next to proceed through the initial welcome and license agreement screens.
   
   

4. Confirm the default target folder destination. The standard installation paths are:

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

   
   

5. Select the setup type. Choose Complete to install all necessary components for the MagTek OPOS MSR, then click Next.
   
6. If prompted during the process, click Yes to allow the installation of the required Microsoft Visual C++ Runtime Libraries.
   
7. Click Finish to complete the driver installation.
   

Maintenance Note: You can launch the driver installer executable again at any time in the future to modify, repair, or completely remove the OPOS driver from the system.

Testing the OPOS Installation

The MagTek UPOS 1.13 JavaPOS MSR Utility application performs a JavaPOS Check Health test on the device based on the pre-registered Logical Device Names (LDN) defined via the jpos.xml file.

1. Navigate to the service sub-folder inside the target installation directory (e.g., C:\Program Files (x86)\JavaPOS\MagTek\service).
2. Double-click on the MSRUtility.bat file to launch the MagTek JavaPOS MSR Utility Check Health application.

3. In the application window, use the combo box to select the MSR Logical Device Name (LDN) for your USB-connected device. The pre-registered LDNs are:

   • MagTekMSR (representing the non-encrypted based reader)
   • MagTekMSR_Encrypted (representing the encrypted based reader)

   

4. Click the Open, Claim, and DeviceEnabled functions in the utility to activate the reader.
5. Swipe a card. The utility fields (Track 1 Data, Track 2 Data, and Track 3 Data) will populate based on the reader type.
   

Example 1: Non-Encrypted Reader

When using the MagTekMSR LDN with a non-encrypted reader, the appropriate non-encrypted data fields are populated with clear text information upon swiping a card.

Example 2: Encrypted Reader

When using the MagTekMSR_Encrypted LDN with an encrypted reader, the appropriate data fields are populated with masked text data and encrypted payload blocks, along with the Additional Security Information required for decoding.

Using the MagTek Sample Application

The MagTek UPOS 1.13 JavaPOS MSR Sample application demonstrates the UPOS Properties, Methods, and Events for both non-encrypted and encrypted readers.

1. Navigate to the Sample sub-folder inside the installation directory (e.g., C:\Program Files (x86)\JavaPOS\MagTek\service\Sample).
2. Double-click the MSRSample.bat file to launch the sample application.
3. Select your MSR Logical Device Name from the combo box to begin testing the JavaPOS operations.
   

Parameter Descriptions

• MSR Logical Device Name [Combo box]: Contains the JavaPOS registered LDNs available for instantiation via the jpos.xml file.
• JavaPOS Open method [Button]: Passes the selected LDN as a string parameter to instantiate the associated JavaPOS device object.
• JavaPOS Claim method [Button]: Claims the instantiated MSR device object for exclusive application use.
• JavaPOS DeviceEnabled property [Check box]: Enables or disables the claimed MSR device object.
• JavaPOS DataEventEnabled property [Check box]: Enables or disables Data Events to be sent from the Service Object for queued read data. Per UPOS standards, this is automatically set to false after each event fires; the application must re-enable it to receive the next swipe.
• JavaPOS CheckHealth method [Button]: Invokes the internal health check and displays the result text in the output window.
• JavaPOS ClearInput method [Button]: Clears any queued MSR read data within the Service Object.
• JavaPOS ClearInputProperties method [Button]: Clears all properties populated by the most recent read data.
• Properties [Button]: Invokes and displays all common and device-specific MSR properties in the output window.
• JavaPOS DecodeData property [Check box]: Enables or disables the MSR specific DecodeData property.
• JavaPOS ParseDecodeData property [Check box]: Enables or disables the MSR specific ParseDecodeData property.
• JavaPOS TransmitSentinels property [Check box]: Enables or disables the MSR specific TransmitSentinels property.
• TracksToRead [Combo box]: Defines the JavaPOS MSR options for the tracks to be read.
• DataEncryptionAlgorithm [Combo box]: Contains the supported encryption algorithms (applies only to encrypted devices).
• RetrieveCardProperty [Combo box]: Contains the MSR specific properties corresponding to the parsed data of the recently swiped card.
• ErrorReportingType [Combo box]: Specifies whether error reporting is Card-based or Track-based.
• JavaPOS DirectIO method [Button]: Invokes the DirectIO Method example.
• JavaPOS Statistics method [Button]: Retrieves and displays the JavaPOS Statistics XML string in a dialog box.
• JavaPOS AutoDisable property [Check box]: Toggles the Auto Disable Property, used for event-driven input control.
• JavaPOS FreezeEvents property [Check box]: Toggles the Freeze Events Property to control when events are received by the application.
• JavaPOS Release (ReleaseDevice) method [Button]: Releases the device object from exclusive use.
• JavaPOS Close me