MSR605 Kartenleser/-schreiber - Benutzerhandbuch
Willkommen zum Benutzerhandbuch für den MSR605 Kartenleser/-schreiber! Dieses Dokument hilft Ihnen beim Einstieg in die Verwendung der Anwendung zum Lesen und Beschreiben von Magnetstreifenkarten.
Inhaltsverzeichnis
- Installation
- Erste Schritte
- Karten lesen
- Karten beschreiben
- Konfiguration
- Fehlerbehebung
Installation
Windows
- Laden Sie das neueste Installationsprogramm von der Releases-Seite herunter
- Führen Sie das Installationsprogramm aus und folgen Sie den Anweisungen auf dem Bildschirm
- Schließen Sie Ihr MSR605-Gerät an einen verfügbaren USB-Port an
- Starten Sie die Anwendung über das Startmenü oder die Desktop-Verknüpfung
Linux/macOS
- Stellen Sie sicher, dass Python 3.8+ installiert ist
- Installieren Sie die erforderlichen Abhängigkeiten:
pip install -r requirements.txt
- Starten Sie die Anwendung:
Erste Schritte
Gerät anschließen
- Schließen Sie Ihr MSR605-Gerät mit dem USB-Kabel an Ihren Computer an
- Die Anwendung sollte das Gerät automatisch erkennen
- In der Statusleiste wird “Gerät verbunden” angezeigt, wenn die Verbindung erfolgreich hergestellt wurde
Hauptoberfläche
- Kartendaten-Anzeige: Zeigt die von der Karte gelesenen Daten an
- Spurauswahl: Wählen Sie aus, welche Spuren gelesen/geschrieben werden sollen (1, 2 und/oder 3)
- Aktionsschaltflächen: Lese-, Schreib- und Löschfunktionen
- Statusleiste: Zeigt den Verbindungsstatus und die Vorgangsergebnisse an
Karten lesen
- Führen Sie eine Magnetstreifenkarte in das Lesegerät ein
- Klicken Sie auf die Schaltfläche “Lesen”
- Die Kartendaten werden im Hauptfenster angezeigt
- Zum Speichern der Daten klicken Sie auf “Datei” > “Speichern unter…”
Karten beschreiben
- Führen Sie eine beschreibbare Magnetstreifenkarte in das Gerät ein
- Geben Sie die zu schreibenden Daten in die entsprechenden Spurenfelder ein oder fügen Sie sie ein
- Wählen Sie aus, auf welche Spuren geschrieben werden soll
- Klicken Sie auf die Schaltfläche “Schreiben”
- In der Statusleiste wird das Ergebnis des Vorgangs angezeigt
Die Anwendung unterstützt zwei wichtige Magnetkartenstandards: ISO 7811 und ISO 7813. Das Verständnis dieser Formate ist entscheidend für korrekte Lese- und Schreibvorgänge.
ISO 7811
ISO 7811 ist der internationale Standard für Identifikationskarten mit Magnetstreifen. Er definiert:
- Spur 1: Alphanumerische Daten (bis zu 79 Zeichen)
- Format:
%[Formatcode][Hauptkontonummer]^[Name]^[Ablaufdatum][Servicecode][Diskretionäre Daten]?
- Beispiel:
%B1234567890123456^KARTENINHABER/NAME^24011234567890123456789?
- Spur 2: Numerische Daten (bis zu 40 Zeichen)
- Format:
;[Hauptkontonummer]=[Ablaufdatum][Servicecode][Diskretionäre Daten]?
- Beispiel:
;1234567890123456=24011234567890123456?
- Spur 3: Lese-/Schreibfähigkeit (selten verwendet)
- Hauptsächlich numerische Daten
- Wird für Finanztransaktionen und Wertaktualisierungen verwendet
ISO 7813
ISO 7813 ist eine Teilmenge von ISO 7811 speziell für Finanztransaktionskarten. Wichtige Unterschiede:
- Spur 1: Strenger formatiert
- Formatcode muss ‘B’ (Bankwesen) sein
- Feste Feldlängen für bestimmte Datenelemente
- Beispiel:
%B1234567890123456^KARTENINHABER/NAME^24011234567890123456789?
- Spur 2: Ähnlich wie ISO 7811, aber mit spezifischen Validierungsregeln
- Beispiel:
;1234567890123456=24011234567890123456?
- Gehen Sie zu Einstellungen > Kartenformat
- Wählen Sie zwischen:
- Automatisch erkennen (Standard): Erkennt das Kartenformat automatisch
- ISO 7811: Für allgemeine Zweckkarten
- ISO 7813: Für Finanztransaktionskarten
- Klicken Sie auf Übernehmen, um die Einstellungen zu speichern
Konfiguration
Geräteeinstellungen
- Baudrate: Stellen Sie die Kommunikationsgeschwindigkeit ein (Standard: 9600)
- Parität: Stellen Sie die Parität ein (Keine, Gerade, Ungerade, Mark, Space)
- Datenbits: Stellen Sie die Anzahl der Datenbits ein (Standard: 8)
- Stoppbits: Stellen Sie die Anzahl der Stoppbits ein (Standard: 1)
Anwendungseinstellungen
- Gerät automatisch erkennen: Aktivieren/Deaktivieren der automatischen Geräteerkennung
- Minimiert starten: Startet die Anwendung im Hintergrund in der Systemleiste
- Protokolle speichern: Aktiviert die Protokollierung von Vorgängen in einer Datei
Fehlerbehebung
Häufige Probleme
Gerät wird nicht erkannt
- Stellen Sie sicher, dass das Gerät ordnungsgemäß an den USB-Port angeschlossen ist
- Versuchen Sie einen anderen USB-Port
- Überprüfen Sie, ob das Gerät im Geräte-Manager erkannt wird
- Starten Sie die Anwendung neu
Lese-/Schreibfehler
- Stellen Sie sicher, dass die Karte korrekt eingelegt ist
- Reinigen Sie den Magnetstreifen der Karte
- Überprüfen Sie, ob die Karte schreibgeschützt ist
- Überprüfen Sie, ob die Spurenkonfiguration dem Kartenformat entspricht
Absturz der Anwendung
- Stellen Sie sicher, dass die neueste Version installiert ist
- Überprüfen Sie die Protokolldatei auf Fehlerdetails
- Versuchen Sie, die Anwendung neu zu installieren
API-Dokumentation für den MSR605 Kartenleser/-schreiber
Dieses Dokument enthält detaillierte Informationen zur MSR605 Kartenleser/-schreiber-API für Entwickler, die die Anwendung erweitern oder integrieren möchten.
Inhaltsverzeichnis
- Übersicht
- Hauptmodule
- Gerätekommunikation
- Kartenoperationen
- Datenformate
- Fehlerbehandlung
- Beispiele
Übersicht
Die MSR605-API bietet eine Python-Schnittstelle für die Interaktion mit Magnetkartenlesern/-schreibern. Die API ist einfach zu verwenden und bietet gleichzeitig Zugriff auf alle Gerätefunktionen.
Hauptmodule
msr605
Das Hauptmodul mit den Kernfunktionalitäten.
Klasse MSR605
class MSR605:
def __init__(self, port=None, baudrate=9600, timeout=1):
"""Initialisiert die Verbindung zum MSR605-Gerät.
Args:
port (str, optional): Name des seriellen Anschlusses. Wenn None, wird automatische Erkennung versucht.
baudrate (int, optional): Kommunikationsgeschwindigkeit in Baud. Standard: 9600.
timeout (int, optional): Lese-Timeout in Sekunden. Standard: 1.
"""
pass
def verbinden(self):
"""Stellt die Verbindung zum Gerät her."""
pass
def trennen(self):
"""Trennt die Verbindung zum Gerät."""
pass
def ist_verbunden(self):
"""Überprüft, ob das Gerät verbunden ist.
Returns:
bool: True wenn verbunden, sonst False.
"""
pass
Technische Spezifikationen
Unterstützte Standards
- ISO/IEC 7811: Magnetstreifenkarten für allgemeine Zwecke
- ISO/IEC 7813: Finanztransaktionskarten (Teilmenge von 7811)
Spur-Spezifikationen
- Spur 1: Bis zu 79 alphanumerische Zeichen
- Spur 2: Bis zu 40 numerische Zeichen
- Spur 3: Bis zu 107 numerische Zeichen (Lese-/Schreibzugriff)
Datenvisualisierung
- Lesen Sie eine Karte oder importieren Sie vorhandene Daten
- Klicken Sie im Fenster für erweiterte Funktionen auf den Reiter “Visualisierung”
- Betrachten Sie die generierten Visualisierungen für jede Spur
Anpassung
Die Anwendung ermöglicht die Anpassung verschiedener Aspekte der Benutzeroberfläche und des Verhaltens über das Einstellungsmenü.