Cómo instalar el controlador MagTek MSR JPOS

Este artículo proporciona el procedimiento paso a paso para instalar, configurar y probar el controlador de lector de banda magnética (MSR) JavaPOS (JPOS) de MagTek para Elo — ahora parte de los sistemas 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 PIDs predeterminados para el modo HID).
• La aplicación MagTek USB MSR (usa esta utilidad para cambiar el lector a modo HID si es necesario, y para verificar el PID).
• El paquete de controladores MagTek JPOS para lectores de deslizamiento USB HID.

Procedimiento de instalación

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

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

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

   
   

5. Selecciona el tipo de instalación. Elige Completo para instalar todos los componentes necesarios para el MagTek OPOS MSR, luego haz clic en Siguiente.
   
6. Si se solicita durante el proceso, haz clic en Sí para permitir la instalación de las Bibliotecas de Tiempo de Ejecución de Microsoft Visual C++ necesarias.
   
7. Haz clic en Finalizar para completar la instalación del controlador.
   

Nota de mantenimiento: Puedes 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 de OPOS

La aplicación de utilidad MagTek UPOS 1.13 JavaPOS MSR realiza una prueba de verificación de salud de JavaPOS en el dispositivo basada en los Nombres de Dispositivo Lógicos (LDN) pre-registrados definidos a través del archivo jpos.xml.

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

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

   • MagTekMSR (representando el lector basado en no encriptación)
   • MagTekMSR_Encrypted (representando el lector basado en encriptación)

   

4. Haz clic en las funciones Abrir, Reclamar y DispositivoHabilitado en la utilidad para activar el lector.
5. Desliza una tarjeta. Los campos de utilidad (Datos de Pista 1, Datos de Pista 2 y Datos de Pista 3) se completarán en función del tipo de lector.
   

Ejemplo 1: Lector no encriptado

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

Ejemplo 2: Lector encriptado

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

Usando la aplicación de muestra de MagTek

La aplicación de muestra MagTek UPOS 1.13 JavaPOS MSR demuestra las Propiedades, Métodos y Eventos de UPOS tanto para lectores no encriptados como encriptados.

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

Descripciones de parámetros

• Nombre de Dispositivo Lógico MSR [Cuadro combinado]: Contiene los LDN registrados de JavaPOS disponibles para instanciar a través del archivo jpos.xml.
• Método Open de JavaPOS [Botón]: Pasa el LDN seleccionado como un parámetro de cadena para instanciar el objeto de dispositivo JavaPOS asociado.
• Método Claim de JavaPOS [Botón]: Reclama el objeto de dispositivo MSR instanciado para uso exclusivo de la aplicación.
• Propiedad DeviceEnabled de JavaPOS [Casilla de verificación]: Habilita o deshabilita el objeto de dispositivo MSR reclamado.
• Propiedad DataEventEnabled de JavaPOS [Casilla de verificación]: Habilita o deshabilita los Eventos de Datos que se envían desde el Objeto de Servicio para los datos de lectura en cola. Según los estándares UPOS, 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 CheckHealth de JavaPOS [Botón]: Invoca la verificación de salud interna y muestra el texto del resultado en la ventana de salida.
• Método ClearInput de JavaPOS [Botón]: Limpia cualquier dato de lectura MSR en cola dentro del Objeto de Servicio.
• Método ClearInputProperties de JavaPOS [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 DecodeData de JavaPOS [Casilla de verificación]: Habilita o deshabilita la propiedad DecodeData específica de MSR.
• Propiedad ParseDecodeData de JavaPOS [Casilla de verificación]: Habilita o deshabilita la propiedad ParseDecodeData específica de MSR.
• Propiedad TransmitSentinels de JavaPOS [Casilla de verificación]: Habilita o deshabilita la propiedad TransmitSentinels específica de MSR.
• TracksToRead [Cuadro combinado]: Define las opciones de JavaPOS MSR para las pistas que se van a leer.
• DataEncryptionAlgorithm [Cuadro combinado]: Contiene los algoritmos de encriptación soportados (aplica solo a dispositivos encriptados).
• RetrieveCardProperty [Cuadro combinado]: Contiene las propiedades específicas de MSR correspondientes a los datos analizados de la tarjeta recién deslizada.
• ErrorReportingType [Cuadro combinado]: Especifica si el informe de errores es basado en tarjeta o basado en pista.
• Método DirectIO de JavaPOS [Botón]: Invoca el ejemplo del Método DirectIO.
• Método Statistics de JavaPOS [Botón]: Recupera y muestra la cadena XML de Estadísticas de JavaPOS en un cuadro de diálogo.
• Propiedad AutoDisable de JavaPOS [Casilla de verificación]: Cambia el estado de la Propiedad de Desactivación Automática, utilizada para el control de entrada basado en eventos.
• Propiedad FreezeEvents de JavaPOS [Casilla de verificación]: Cambia el estado de la Propiedad de Congelamiento de Eventos para controlar cuándo se reciben eventos por la aplicación.
• Método Release (ReleaseDevice) de JavaPOS [Botón]: Libera el objeto de dispositivo de uso exclusivo.
• Cierra me de JavaPOS