Cómo instalar el controlador MagTek MSR JPOS

Este artículo proporciona el procedimiento paso a paso para instalar, configurar y probar el controlador MagTek Magnetic Stripe Reader (MSR) JavaPOS (JPOS) para sistemas Elo — ahora parte de Zebra Technologies.

Herramientas necesarias

• Un sistema informático con Windows 7 o una versión más reciente.
• 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 (utilice 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 jpos.zip para iniciar el asistente de configuración.

   Nota: Si se solicita una contraseña para la extracción, ingrese: magtek2010.
3. Haga clic en Siguiente para continuar con 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, 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 de tiempo de ejecución de Microsoft Visual C++ requeridas.
   
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 en el futuro 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 de verificación de salud JavaPOS en el dispositivo basada en los Nombres Lógicos de Dispositivo (LDN) pre-registrados definidos a través del archivo jpos.xml.

1. Navegue a la subcarpeta service dentro del directorio de instalación objetivo (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 (que representa el lector sin cifrado)
   • MagTekMSR_Encrypted (que representa el lector cifrado)

   

4. Haga clic en las funciones Abrir, Reclamar y DeviceEnabled en la utilidad para activar el lector.
5. Deslice una tarjeta. Los campos de la utilidad (Datos de la Pista 1, Datos de la Pista 2 y Datos de la 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 no cifrados 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 datos de texto enmascarados y bloques de carga útil cifrados, 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 a través del archivo jpos.xml.
• Método JavaPOS Open [Botón]: Pasa el LDN seleccionado como parámetro de cadena para instanciar el objeto del dispositivo JavaPOS asociado.
• Método JavaPOS Claim [Botón]: Reclama el objeto del dispositivo MSR instanciado para uso exclusivo de la aplicación.
• Propiedad JavaPOS DeviceEnabled [Casilla de verificación]: Habilita o deshabilita el objeto del dispositivo MSR reclamado.
• Propiedad JavaPOS DataEventEnabled [Casilla de verificación]: Habilita o deshabilita los Eventos de Datos enviados desde el Objeto Servicio para los datos de lectura en cola. Según los estándares UPOS, esto se establece automáticamente en falso después de que cada evento se dispara; la aplicación debe volver a habilitarlo para recibir la siguiente lectura.
• Método JavaPOS CheckHealth [Botón]: Invoca la verificación interna de salud y muestra el texto del resultado en la ventana de salida.
• Método JavaPOS ClearInput [Botón]: Limpia cualquier dato de lectura MSR en cola dentro del Objeto Servicio.
• Método JavaPOS ClearInputProperties [Botón]: Limpia 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 leerán.
• 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 leída recientemente.
• ErrorReportingType [Cuadro combinado]: Especifica si la notificación de errores es basada en tarjeta o basada 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.
• JavaPOS Close me