Guide de l’Utilisateur du Lecteur/Écriveur de Cartes MSR605
Bienvenue dans le guide d’utilisation du Lecteur/Écriveur de Cartes MSR605 ! Ce document vous aidera à commencer à utiliser l’application pour lire et écrire des cartes à bande magnétique.
Table des Matières
- Installation
- Premiers Pas
- Lecture des Cartes
- Écriture sur les Cartes
- Configuration
- Dépannage
Installation
Windows
- Téléchargez le dernier programme d’installation depuis la page Releases
- Exécutez le programme d’installation et suivez les instructions à l’écran
- Connectez votre appareil MSR605 à un port USB disponible
- Lancez l’application depuis le Menu Démarrer ou le raccourci sur le bureau
Linux/macOS
- Assurez-vous d’avoir Python 3.8+ installé
- Installez les dépendances requises :
pip install -r requirements.txt
- Lancez l’application :
Premiers Pas
Connexion de l’Appareil
- Connectez votre appareil MSR605 à votre ordinateur à l’aide du câble USB
- L’application devrait détecter automatiquement l’appareil
- La barre d’état affichera “Appareil Connecté” en cas de succès
Interface Principale
- Affichage des Données de la Carte : Affiche les données lues sur la carte
- Sélection des Pistes : Choisissez les pistes à lire/écrire (1, 2 et/ou 3)
- Boutons d’Action : Fonctions de lecture, d’écriture et d’effacement
- Barre d’État : Affiche l’état de la connexion et les résultats des opérations
Lecture des Cartes
- Insérez une carte à bande magnétique dans le lecteur
- Cliquez sur le bouton “Lire”
- Les données de la carte s’afficheront dans la fenêtre principale
- Pour enregistrer les données, cliquez sur “Fichier” > “Enregistrer sous…”
Écriture sur les Cartes
- Insérez une carte inscriptible dans l’appareil
- Entrez ou collez les données à écrire dans les champs de piste appropriés
- Sélectionnez les pistes sur lesquelles vous souhaitez écrire
- Cliquez sur le bouton “Écrire”
- La barre d’état affichera le résultat de l’opération
L’application prend en charge deux normes majeures de cartes magnétiques : ISO 7811 et ISO 7813. La compréhension de ces formats est essentielle pour des opérations de lecture et d’écriture correctes.
ISO 7811
L’ISO 7811 est la norme internationale pour les cartes d’identification à bande magnétique. Elle définit :
- Piste 1 : Données alphanumériques (jusqu’à 79 caractères)
- Format :
%[code de format][numéro de compte principal]^[nom]^[date d'expiration][code de service][données discrétionnaires]?
- Exemple :
%B1234567890123456^TITULAIRE/NOM^24011234567890123456789?
- Piste 2 : Données numériques (jusqu’à 40 caractères)
- Format :
;[numéro de compte principal]=[date d'expiration][code de service][données discrétionnaires]?
- Exemple :
;1234567890123456=24011234567890123456?
- Piste 3 : Capacité de lecture/écriture (peu utilisée)
- Principalement des données numériques
- Utilisée pour les transactions financières et les mises à jour de valeur
ISO 7813
L’ISO 7813 est un sous-ensemble de l’ISO 7811 spécifiquement pour les cartes de transaction financière. Différences clés :
- Piste 1 : Format plus strict
- Le code de format doit être ‘B’ (banque)
- Longueurs de champs fixes pour certains éléments de données
- Exemple :
%B1234567890123456^TITULAIRE/NOM^24011234567890123456789?
- Piste 2 : Similaire à l’ISO 7811 mais avec des règles de validation spécifiques
- Exemple :
;1234567890123456=24011234567890123456?
- Allez dans Paramètres > Format de Carte
- Choisissez entre :
- Détection automatique (par défaut) : Détecte automatiquement le format de la carte
- ISO 7811 : Pour les cartes à usage général
- ISO 7813 : Pour les cartes de transaction financière
- Cliquez sur Appliquer pour enregistrer les paramètres
Configuration
Paramètres de l’Appareil
- Vitesse de Transmission : Ajustez la vitesse de communication (par défaut : 9600)
- Parité : Définissez la parité (Aucune, Paire, Impaire, Marque, Espace)
- Bits de Données : Définissez le nombre de bits de données (par défaut : 8)
- Bits d’Arrêt : Définissez le nombre de bits d’arrêt (par défaut : 1)
Paramètres de l’Application
- Détection Automatique : Activez/désactivez la détection automatique de l’appareil
- Démarrer Minimisé : Lance l’application réduite dans la zone de notification
- Enregistrer les Journaux : Active l’enregistrement des opérations dans un fichier
Dépannage
Problèmes Courants
Appareil Non Détecté
- Vérifiez que l’appareil est correctement connecté au port USB
- Essayez un autre port USB
- Vérifiez si l’appareil est reconnu dans le Gestionnaire de périphériques
- Redémarrez l’application
Échec de Lecture/Écriture
- Vérifiez que la carte est correctement insérée
- Nettoyez la bande magnétique de la carte
- Vérifiez que la carte n’est pas en lecture seule
- Vérifiez que la configuration des pistes correspond au format de la carte
Plantage de l’Application
- Assurez-vous d’avoir la dernière version installée
- Vérifiez le fichier journal pour plus de détails sur l’erreur
- Essayez de réinstaller l’application
Documentation de l’API du Lecteur/Écriveur de Cartes MSR605
Ce document fournit des informations détaillées sur l’API du Lecteur/Écriveur de Cartes MSR605 pour les développeurs qui souhaitent étendre ou intégrer l’application.
Table des Matières
- Vue d’ensemble
- Modules Principaux
- Communication avec l’Appareil
- Opérations sur les Cartes
- Formats de Données
- Gestion des Erreurs
- Exemples
Vue d’Ensemble
L’API MSR605 fournit une interface Python pour interagir avec les lecteurs/écriveurs de cartes à bande magnétique. L’API est conçue pour être facile à utiliser tout en offrant un accès à toutes les fonctionnalités de l’appareil.
Modules Principaux
msr605
Le module principal contenant les fonctionnalités de base.
Classe MSR605
class MSR605:
def __init__(self, port=None, baudrate=9600, timeout=1):
"""Initialise la connexion à l'appareil MSR605.
Args:
port (str, optionnel): Nom du port série. Si None, une détection automatique est tentée.
baudrate (int, optionnel): Vitesse de transmission en bauds. Par défaut : 9600.
timeout (int, optionnel): Délai de lecture en secondes. Par défaut : 1.
"""
pass
def connecter(self):
"""Établit la connexion à l'appareil."""
pass
def deconnecter(self):
"""Ferme la connexion à l'appareil."""
pass
def est_connecte(self):
"""Vérifie si l'appareil est connecté.
Returns:
bool: True si connecté, False sinon.
"""
pass
Spécifications Techniques
Normes Supportées
- ISO/CEI 7811 : Cartes à bande magnétique à usage général
- ISO/CEI 7813 : Cartes de transaction financière (sous-ensemble de 7811)
Spécifications des Pistes
- Piste 1 : Jusqu’à 79 caractères alphanumériques
- Piste 2 : Jusqu’à 40 caractères numériques
- Piste 3 : Jusqu’à 107 caractères numériques (lecture/écriture)
Visualisation des Données
- Lisez une carte ou importez des données existantes
- Cliquez sur l’onglet “Visualisation” dans la fenêtre des fonctions avancées
- Visualisez les représentations graphiques générées pour chaque piste
Personnalisation
L’application vous permet de personnaliser divers aspects de l’interface utilisateur et du comportement via le menu des paramètres.