Como instalar o driver MagTek MSR JPOS

Este artigo fornece o procedimento passo a passo para instalar, configurar e testar o driver MagTek Magnetic Stripe Reader (MSR) JavaPOS (JPOS) para sistemas Elo — agora parte da Zebra Technologies.

Ferramentas necessárias

• Um sistema computadorizado com Windows 7 ou mais recente.
• Um MagTek MSR operando no modo HID com PID 002 ou 011 (estes são os PIDs padrão para o modo HID).
• O aplicativo MagTek USB MSR (use esta ferramenta para alterar o leitor para o modo HID se necessário, e para verificar o PID).
• O Pacote do Driver MagTek JPOS para Leitores USB HID Swipe.

Procedimento de instalação

1. Baixe e extraia o Pacote do Driver JPOS para Leitores USB HID Swipe no seu disco local.

2. Dê um duplo clique no arquivo de instalação extraído jpos.zip para iniciar o assistente de configuração.

   Nota: Se for solicitado uma senha para extração, insira: magtek2010.
3. Clique em Avançar para prosseguir pelas telas iniciais de boas-vindas e do contrato de licença.
   
   

4. Confirme a pasta de destino padrão. Os caminhos padrão de instalação são:

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

   
   

5. Selecione o tipo de instalação. Escolha Completo para instalar todos os componentes necessários para o MagTek OPOS MSR, então clique em Avançar.
   
6. Se solicitado durante o processo, clique em Sim para permitir a instalação das Bibliotecas Microsoft Visual C++ Runtime necessárias.
   
7. Clique em Concluir para completar a instalação do driver.
   

Nota de manutenção: Você pode executar o instalador do driver novamente a qualquer momento no futuro para modificar, reparar ou remover completamente o driver OPOS do sistema.

Testando a instalação OPOS

O aplicativo MagTek UPOS 1.13 JavaPOS MSR Utility realiza um teste JavaPOS Check Health no dispositivo baseado nos Nomes Lógicos de Dispositivo (LDN) pré-registrados definidos via o arquivo jpos.xml.

1. Navegue até a subpasta service dentro do diretório de instalação de destino (por exemplo, C:\Program Files (x86)\JavaPOS\MagTek\service).
2. Dê um duplo clique no arquivo MSRUtility.bat para iniciar o aplicativo MagTek JavaPOS MSR Utility Check Health.

3. Na janela do aplicativo, use a caixa de combinação para selecionar o Nome Lógico de Dispositivo (LDN) MSR para seu dispositivo conectado via USB. Os LDNs pré-registrados são:

   • MagTekMSR (representando o leitor não criptografado)
   • MagTekMSR_Encrypted (representando o leitor criptografado)

   

4. Clique nas funções Abrir, Reivindicar e DeviceEnabled na ferramenta para ativar o leitor.
5. Passe um cartão. Os campos da ferramenta (Dados da Faixa 1, Dados da Faixa 2 e Dados da Faixa 3) serão preenchidos conforme o tipo de leitor.
   

Exemplo 1: Leitor não criptografado

Ao usar o LDN MagTekMSR com um leitor não criptografado, os campos de dados apropriados não criptografados são preenchidos com informações em texto claro ao passar um cartão.

Exemplo 2: Leitor criptografado

Ao usar o LDN MagTekMSR_Encrypted com um leitor criptografado, os campos de dados apropriados são preenchidos com dados mascarados de texto e blocos de carga criptografada, juntamente com as Informações de Segurança Adicionais necessárias para decodificação.

Usando o Aplicativo de Exemplo MagTek

O aplicativo de exemplo MagTek UPOS 1.13 JavaPOS MSR demonstra as Propriedades, Métodos e Eventos UPOS para leitores não criptografados e criptografados.

1. Navegue até a subpasta Sample dentro do diretório de instalação (por exemplo, C:\Program Files (x86)\JavaPOS\MagTek\service\Sample).
2. Dê um duplo clique no arquivo MSRSample.bat para iniciar o aplicativo de exemplo.
3. Selecione o Nome Lógico de Dispositivo MSR na caixa de combinação para começar a testar as operações JavaPOS.
   

Descrição dos parâmetros

• Nome Lógico de Dispositivo MSR [Caixa de combinação]: Contém os LDNs registrados no JavaPOS disponíveis para instanciação via o arquivo jpos.xml.
• Método JavaPOS Open [Botão]: Passa o LDN selecionado como parâmetro string para instanciar o objeto de dispositivo JavaPOS associado.
• Método JavaPOS Claim [Botão]: Reivindica o objeto do dispositivo MSR instanciado para uso exclusivo da aplicação.
• Propriedade JavaPOS DeviceEnabled [Caixa de seleção]: Habilita ou desabilita o objeto do dispositivo MSR reivindicado.
• Propriedade JavaPOS DataEventEnabled [Caixa de seleção]: Habilita ou desabilita Eventos de Dados a serem enviados pelo Objeto de Serviço para dados lidos em fila. Conforme padrão UPOS, isso é automaticamente definido como falso após cada evento; a aplicação deve reativá-lo para receber a próxima passagem.
• Método JavaPOS CheckHealth [Botão]: Invoca a verificação interna de saúde e exibe o texto do resultado na janela de saída.
• Método JavaPOS ClearInput [Botão]: Limpa quaisquer dados MSR lidos em fila dentro do Objeto de Serviço.
• Método JavaPOS ClearInputProperties [Botão]: Limpa todas as propriedades preenchidas pelos dados da leitura mais recente.
• Propriedades [Botão]: Invoca e exibe todas as propriedades comuns e específicas do dispositivo MSR na janela de saída.
• Propriedade JavaPOS DecodeData [Caixa de seleção]: Habilita ou desabilita a propriedade específica DecodeData do MSR.
• Propriedade JavaPOS ParseDecodeData [Caixa de seleção]: Habilita ou desabilita a propriedade específica ParseDecodeData do MSR.
• Propriedade JavaPOS TransmitSentinels [Caixa de seleção]: Habilita ou desabilita a propriedade específica TransmitSentinels do MSR.
• TracksToRead [Caixa de combinação]: Define as opções JavaPOS MSR para as faixas a serem lidas.
• DataEncryptionAlgorithm [Caixa de combinação]: Contém os algoritmos de criptografia suportados (aplica-se apenas a dispositivos criptografados).
• RetrieveCardProperty [Caixa de combinação]: Contém as propriedades específicas do MSR correspondentes aos dados analisados do cartão passado recentemente.
• ErrorReportingType [Caixa de combinação]: Especifica se o relatório de erro é baseado no cartão ou na faixa.
• Método JavaPOS DirectIO [Botão]: Invoca o exemplo do método DirectIO.
• Método JavaPOS Statistics [Botão]: Recupera e exibe a string XML das Estatísticas JavaPOS em uma caixa de diálogo.
• Propriedade JavaPOS AutoDisable [Caixa de seleção]: Alterna a Propriedade Auto Disable, usada para controle de entrada baseado em eventos.
• Propriedade JavaPOS FreezeEvents [Caixa de seleção]: Alterna a Propriedade Freeze Events para controlar quando os eventos são recebidos pela aplicação.
• Método JavaPOS Release (ReleaseDevice) [Botão]: Libera o objeto do dispositivo do uso exclusivo.
• JavaPOS Close me