Cómo instalar el controlador MagTek MSR JPOS

Este artículo proporciona el procedimiento paso a paso para instalar, configurar y probar el controlador JavaPOS (JPOS) del lector de banda magnética (MSR) MagTek para sistemas Elo — ahora parte de Zebra Technologies.

Herramientas necesarias

• Un sistema informático con Windows 7 o superior.
• Un MagTek MSR operando en modo HID con PID 002 o 011 (estos son los PID predeterminados para el modo HID).
• La aplicación MagTek USB MSR (use esta utilidad para cambiar el lector al modo HID si es necesario y para verificar el PID).
• El paquete de controladores MagTek JPOS para lectores USB HID Swipe.

Procedimiento de instalación

1. Descargue y extraiga el paquete de controladores JPOS para lectores USB HID Swipe en su unidad local.
2. Haga doble clic en el archivo de instalación extraído 99510116-116.zip para iniciar el asistente de instalación.
3. Haga clic en Siguiente para continuar a través de las pantallas iniciales de bienvenida y acuerdo de licencia.
   
   

4. Confirme la carpeta de destino predeterminada. Las rutas estándar de instalación son:

   • Para plataformas x86: C:\Program Files\OPOS\MagTek
   • Para plataformas x64: C:\Program Files (x86)\OPOS\MagTek

   
   

5. Seleccione el tipo de instalación. Elija Completa para instalar todos los componentes necesarios para el MagTek OPOS MSR y luego haga clic en Siguiente.
   
6. Si se le solicita durante el proceso, haga clic en Sí para permitir la instalación de las bibliotecas necesarias de Microsoft Visual C++ Runtime.
   
7. Haga clic en Finalizar para completar la instalación del controlador.
   

Nota de mantenimiento: Puede ejecutar el instalador del controlador nuevamente en cualquier momento para modificar, reparar o eliminar completamente el controlador OPOS del sistema.

Prueba de la instalación OPOS

La aplicación MagTek UPOS 1.13 JavaPOS MSR Utility realiza una prueba JavaPOS Check Health en el dispositivo basada en los Nombres Lógicos de Dispositivo (LDN) pre-registrados definidos en el archivo jpos.xml.

1. Navegue a la subcarpeta service dentro del directorio de instalación (por ejemplo, C:\Program Files (x86)\JavaPOS\MagTek\service).
2. Haga doble clic en el archivo MSRUtility.bat para iniciar la aplicación MagTek JavaPOS MSR Utility Check Health.

3. En la ventana de la aplicación, use el cuadro combinado para seleccionar el Nombre Lógico de Dispositivo (LDN) MSR para su dispositivo conectado por USB. Los LDN pre-registrados son:

   • MagTekMSR (representando el lector sin cifrado)
   • MagTekMSR_Encrypted (representando el lector cifrado)

   

4. Haga clic en las funciones Abrir, Reclamar y DispositivoHabilitado en la utilidad para activar el lector.
5. Deslice una tarjeta. Los campos de la utilidad (Datos de Pista 1, Datos de Pista 2 y Datos de Pista 3) se completarán según el tipo de lector.
   

Ejemplo 1: Lector sin cifrar

Al usar el LDN MagTekMSR con un lector sin cifrar, los campos de datos sin cifrar apropiados se completan con información en texto claro al deslizar una tarjeta.

Ejemplo 2: Lector cifrado

Al usar el LDN MagTekMSR_Encrypted con un lector cifrado, los campos de datos apropiados se completan con texto enmascarado y bloques de carga cifrada, junto con la Información de Seguridad Adicional requerida para la decodificación.

Uso de la aplicación de ejemplo MagTek

La aplicación de ejemplo MagTek UPOS 1.13 JavaPOS MSR demuestra las Propiedades, Métodos y Eventos UPOS para lectores tanto sin cifrar como cifrados.

1. Navegue a la subcarpeta Sample dentro del directorio de instalación (por ejemplo, C:\Program Files (x86)\JavaPOS\MagTek\service\Sample).
2. Haga doble clic en el archivo MSRSample.bat para iniciar la aplicación de ejemplo.
3. Seleccione su Nombre Lógico de Dispositivo MSR en el cuadro combinado para comenzar a probar las operaciones JavaPOS.
   

Descripción de parámetros

• Nombre Lógico de Dispositivo MSR [Cuadro combinado]: Contiene los LDN registrados en JavaPOS disponibles para instanciación mediante el archivo jpos.xml.
• Método JavaPOS Abrir [Botón]: Pasa el LDN seleccionado como parámetro de cadena para instanciar el objeto de dispositivo JavaPOS asociado.
• Método JavaPOS Reclamar [Botón]: Reclama el objeto de dispositivo MSR instanciado para uso exclusivo de la aplicación.
• Propiedad JavaPOS DispositivoHabilitado [Casilla de verificación]: Habilita o deshabilita el objeto de dispositivo MSR reclamado.
• Propiedad JavaPOS DataEventEnabled [Casilla de verificación]: Habilita o deshabilita los Eventos de Datos enviados desde el Objeto de Servicio para los datos leídos en cola. Según los estándares UPOS, esto se establece automáticamente en falso después de que se dispara cada evento; la aplicación debe volver a habilitarlo para recibir el siguiente deslizamiento.
• Método JavaPOS CheckHealth [Botón]: Invoca la verificación interna de estado y muestra el texto del resultado en la ventana de salida.
• Método JavaPOS ClearInput [Botón]: Borra cualquier dato de lectura MSR en cola dentro del Objeto de Servicio.
• Método JavaPOS ClearInputProperties [Botón]: Borra todas las propiedades pobladas por los datos de lectura más recientes.
• Propiedades [Botón]: Invoca y muestra todas las propiedades comunes y específicas del dispositivo MSR en la ventana de salida.
• Propiedad JavaPOS DecodeData [Casilla de verificación]: Habilita o deshabilita la propiedad DecodeData específica del MSR.
• Propiedad JavaPOS ParseDecodeData [Casilla de verificación]: Habilita o deshabilita la propiedad ParseDecodeData específica del MSR.
• Propiedad JavaPOS TransmitSentinels [Casilla de verificación]: Habilita o deshabilita la propiedad TransmitSentinels específica del MSR.
• TracksToRead [Cuadro combinado]: Define las opciones JavaPOS MSR para las pistas que se deben leer.
• DataEncryptionAlgorithm [Cuadro combinado]: Contiene los algoritmos de cifrado soportados (aplica solo a dispositivos cifrados).
• RetrieveCardProperty [Cuadro combinado]: Contiene las propiedades específicas del MSR correspondientes a los datos analizados de la tarjeta deslizada recientemente.
• ErrorReportingType [Cuadro combinado]: Especifica si el reporte de errores es basado en tarjeta o basado en pista.
• Método JavaPOS DirectIO [Botón]: Invoca el ejemplo del método DirectIO.
• Método JavaPOS Statistics [Botón]: Recupera y muestra la cadena XML de estadísticas JavaPOS en un cuadro de diálogo.
• Propiedad JavaPOS AutoDisable [Casilla de verificación]: Alterna la propiedad Auto Disable, usada para control de entrada basado en eventos.
• Propiedad JavaPOS FreezeEvents [Casilla de verificación]: Alterna la propiedad Freeze Events para controlar cuándo la aplicación recibe eventos.
• Método JavaPOS Release (ReleaseDevice) [Botón]: Libera el objeto del dispositivo del uso exclusivo.
• Cerrar JavaPOS