Comment installer le pilote MagTek MSR JPOS

Cet article fournit la procédure étape par étape pour installer, configurer et tester le pilote JavaPOS (JPOS) du lecteur de bande magnétique (MSR) MagTek pour les systèmes Elo — désormais partie de 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 de pilotes JPOS pour lecteurs USB HID Swipe sur votre disque local.

2. Double-cliquez sur le fichier d'installation extrait jpos.zip pour lancer l'assistant d'installation.

   Remarque : Si un mot de passe d'extraction est demandé, saisissez : magtek2010.
3. Cliquez sur Suivant pour passer les écrans d'accueil et de contrat de licence initiaux.
   
   

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 demandé durant le processus, cliquez sur Oui pour autoriser l'installation des bibliothèques Microsoft Visual C++ Runtime nécessaires.
   
7. Cliquez sur Terminer pour finaliser l'installation du pilote.
   

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

Tester l'installation OPOS

L'application MagTek UPOS 1.13 JavaPOS MSR Utility réalise un test JavaPOS Check Health sur le périphérique basé sur les noms de périphériques logiques (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 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 se remplissent avec des informations en texte 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 se remplissent avec des données en texte masqué et des blocs de charge utile chiffrée, ainsi que les Informations de Sécurité Additionnelles 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 à l’intérieur du 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 JavaPOS enregistrés 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 des événements de données depuis l’objet service pour les données lues en file d’attente. Selon les normes UPOS, cette propriété est automatiquement mise à false après chaque événement déclenché ; l’application doit la réactiver pour recevoir le passage suivant.
• Méthode JavaPOS CheckHealth [Bouton] : Lance le contrôle interne de santé et affiche le résultat dans la fenêtre de sortie.
• Méthode JavaPOS ClearInput [Bouton] : Vide toute donnée MSR en file d’attente dans l’objet service.
• Méthode JavaPOS ClearInputProperties [Bouton] : Vide toutes les propriétés remplies par la dernière lecture de données.
• Propriétés [Bouton] : Affiche toutes les propriétés communes et spécifiques au MSR dans la fenêtre de sortie.
• Propriété JavaPOS DecodeData [Case à cocher] : Active ou désactive la propriété spécifique DecodeData du MSR.
• Propriété JavaPOS ParseDecodeData [Case à cocher] : Active ou désactive la propriété spécifique ParseDecodeData du MSR.
• Propriété JavaPOS TransmitSentinels [Case à cocher] : Active ou désactive la propriété spécifique TransmitSentinels du 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] : Lance un 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