Comment installer le pilote MagTek MSR JPOS

Cet article fournit la procédure étape par étape pour installer, configurer et tester le pilote MagTek Magnetic Stripe Reader (MSR) JavaPOS (JPOS) pour Elo — désormais partie des systèmes Zebra Technologies.

Outils nécessaires

• Un système informatique Windows 7 ou plus récent.
• Un MagTek MSR fonctionnant en mode HID avec PID 002 ou 011 (ce sont les PID par défaut pour le mode HID).
• L'application MagTek USB MSR (utilisez cet utilitaire pour changer le lecteur en mode HID si nécessaire, et pour vérifier le PID).
• Le package de pilotes MagTek JPOS pour lecteurs USB HID Swipe.

Procédure d'installation

1. Téléchargez et extrayez le package du pilote JPOS pour lecteurs USB HID Swipe sur votre disque local.
2. Double-cliquez sur le fichier d'installation extrait 99510116-116.zip pour lancer l'assistant d'installation.
3. Cliquez sur Suivant pour poursuivre à travers les écrans d'accueil initial et d'accord de licence.
   
   

4. Confirmez le dossier de destination par défaut. Les chemins d'installation standards sont :

   • Pour les plateformes x86 : C:\Program Files\OPOS\MagTek
   • Pour les plateformes x64 : C:\Program Files (x86)\OPOS\MagTek

   
   

5. Sélectionnez le type d'installation. Choisissez Complet pour installer tous les composants nécessaires pour le MagTek OPOS MSR, puis cliquez sur Suivant.
   
6. Si une invite apparaît durant le processus, cliquez sur Oui pour autoriser l'installation des bibliothèques Microsoft Visual C++ Runtime requises.
   
7. Cliquez sur Terminer pour compléter l'installation du pilote.
   

Note de maintenance : Vous pouvez relancer l'exécutable d'installation du pilote à tout moment dans le futur pour modifier, réparer ou supprimer complètement le pilote OPOS du système.

Tester l'installation OPOS

L'application utilitaire MagTek UPOS 1.13 JavaPOS MSR effectue un test JavaPOS Check Health sur l'appareil basé sur les noms de périphérique logique (LDN) préenregistrés définis via le fichier jpos.xml.

1. Accédez au sous-dossier service dans le répertoire d'installation cible (par exemple, C:\Program Files (x86)\JavaPOS\MagTek\service).
2. Double-cliquez sur le fichier MSRUtility.bat pour lancer l'application utilitaire MagTek JavaPOS MSR Utility Check Health.

3. Dans la fenêtre de l'application, utilisez la liste déroulante pour sélectionner le nom de périphérique logique (LDN) MSR pour votre appareil connecté en USB. Les LDN préenregistrés sont :

   • MagTekMSR (représentant le lecteur non chiffré)
   • MagTekMSR_Encrypted (représentant le lecteur chiffré)

   

4. Cliquez sur les fonctions Open, Claim et DeviceEnabled dans l'utilitaire pour activer le lecteur.
5. Passez une carte. Les champs de l'utilitaire (Données Piste 1, Données Piste 2, et Données Piste 3) se rempliront selon le type de lecteur.
   

Exemple 1 : Lecteur non chiffré

Lors de l'utilisation du LDN MagTekMSR avec un lecteur non chiffré, les champs de données non chiffrées appropriés sont remplis avec des informations en clair lors du passage d'une carte.

Exemple 2 : Lecteur chiffré

Lors de l'utilisation du LDN MagTekMSR_Encrypted avec un lecteur chiffré, les champs de données appropriés sont remplis avec des données masquées et des blocs de charge utile chiffrée, ainsi que les informations de sécurité supplémentaires requises pour le décodage.

Utilisation de l'application d'exemple MagTek

L'application d'exemple MagTek UPOS 1.13 JavaPOS MSR démontre les propriétés, méthodes et événements UPOS pour les lecteurs non chiffrés et chiffrés.

1. Accédez au sous-dossier Sample dans le répertoire d'installation (par exemple, C:\Program Files (x86)\JavaPOS\MagTek\service\Sample).
2. Double-cliquez sur le fichier MSRSample.bat pour lancer l'application d'exemple.
3. Sélectionnez votre nom de périphérique logique MSR dans la liste déroulante pour commencer à tester les opérations JavaPOS.
   

Descriptions des paramètres

• Nom de périphérique logique MSR [Liste déroulante] : Contient les LDN enregistrés JavaPOS disponibles pour instanciation via le fichier jpos.xml.
• Méthode JavaPOS Open [Bouton] : Passe le LDN sélectionné en paramètre chaîne pour instancier l'objet périphérique JavaPOS associé.
• Méthode JavaPOS Claim [Bouton] : Réclame l'objet périphérique MSR instancié pour un usage exclusif par l'application.
• Propriété JavaPOS DeviceEnabled [Case à cocher] : Active ou désactive l'objet périphérique MSR réclamé.
• Propriété JavaPOS DataEventEnabled [Case à cocher] : Active ou désactive l'envoi d'événements de données depuis l'objet service pour les données lues en file d'attente. Selon les normes UPOS, cela est automatiquement désactivé après chaque événement déclenché ; l'application doit le réactiver pour recevoir le passage suivant.
• Méthode JavaPOS CheckHealth [Bouton] : Lance le contrôle de santé interne et affiche le résultat dans la fenêtre de sortie.
• Méthode JavaPOS ClearInput [Bouton] : Efface toutes les données MSR en file d'attente dans l'objet service.
• Méthode JavaPOS ClearInputProperties [Bouton] : Efface toutes les propriétés remplies par la lecture de données la plus récente.
• Propriétés [Bouton] : Invoque et affiche toutes les propriétés MSR communes et spécifiques à l'appareil dans la fenêtre de sortie.
• Propriété JavaPOS DecodeData [Case à cocher] : Active ou désactive la propriété DecodeData spécifique au MSR.
• Propriété JavaPOS ParseDecodeData [Case à cocher] : Active ou désactive la propriété ParseDecodeData spécifique au MSR.
• Propriété JavaPOS TransmitSentinels [Case à cocher] : Active ou désactive la propriété TransmitSentinels spécifique au MSR.
• TracksToRead [Liste déroulante] : Définit les options JavaPOS MSR pour les pistes à lire.
• DataEncryptionAlgorithm [Liste déroulante] : Contient les algorithmes de chiffrement supportés (s'applique uniquement aux appareils chiffrés).
• RetrieveCardProperty [Liste déroulante] : Contient les propriétés spécifiques MSR correspondant aux données analysées de la carte récemment passée.
• ErrorReportingType [Liste déroulante] : Spécifie si le rapport d'erreur est basé sur la carte ou sur la piste.
• Méthode JavaPOS DirectIO [Bouton] : Invoque l'exemple de méthode DirectIO.
• Méthode JavaPOS Statistics [Bouton] : Récupère et affiche la chaîne XML des statistiques JavaPOS dans une boîte de dialogue.
• Propriété JavaPOS AutoDisable [Case à cocher] : Active ou désactive la propriété Auto Disable, utilisée pour le contrôle d'entrée piloté par événements.
• Propriété JavaPOS FreezeEvents [Case à cocher] : Active ou désactive la propriété Freeze Events pour contrôler quand les événements sont reçus par l'application.
• Méthode JavaPOS Release (ReleaseDevice) [Bouton] : Libère l'objet périphérique de son usage exclusif.
• JavaPOS Close me