Lector/Grabador de Tarjetas MSR605 - Guía de Usuario

¡Bienvenido a la guía de usuario del Lector/Grabador de Tarjetas MSR605! Este documento te ayudará a comenzar a usar la aplicación para leer y escribir en tarjetas de banda magnética.

Tabla de Contenidos

  1. Instalación
  2. Primeros Pasos
  3. Lectura de Tarjetas
  4. Escritura de Tarjetas
  5. Configuración
  6. Solución de Problemas
  7. Formatos de Tarjeta
  8. Características Avanzadas
  9. Preguntas Frecuentes

Instalación

Windows

  1. Descarga el instalador más reciente desde la página de Lanzamientos
  2. Ejecuta el instalador y sigue las instrucciones en pantalla
  3. Conecta tu dispositivo MSR605 a un puerto USB disponible
  4. Inicia la aplicación desde el Menú Inicio o el acceso directo en el escritorio

Linux/macOS

  1. Asegúrate de tener Python 3.8+ instalado
  2. Instala las dependencias necesarias:
    pip install -r requirements.txt
    
  3. Ejecuta la aplicación:
    python main.py
    

Primeros Pasos

Conexión del Dispositivo

  1. Conecta tu dispositivo MSR605 a tu computadora usando el cable USB
  2. La aplicación debería detectar automáticamente el dispositivo
  3. La barra de estado mostrará “Dispositivo Conectado” cuando tenga éxito

Interfaz Principal

Lectura de Tarjetas

  1. Inserta una tarjeta de banda magnética en el lector
  2. Haz clic en el botón “Leer”
  3. Los datos de la tarjeta se mostrarán en la ventana principal
  4. Para guardar los datos, haz clic en “Archivo” > “Guardar Como…”

Escritura de Tarjetas

  1. Inserta una tarjeta de banda magnética grabable en el escritor
  2. Ingresa o pega los datos que deseas escribir en los campos de pista correspondientes
  3. Selecciona a qué pistas deseas escribir
  4. Haz clic en el botón “Escribir”
  5. La barra de estado mostrará el resultado de la operación

Formatos de Tarjeta

La aplicación admite dos estándares principales de tarjetas magnéticas: ISO 7811 e ISO 7813. Comprender estos formatos es crucial para realizar operaciones de lectura y escritura adecuadas.

ISO 7811

ISO 7811 es el estándar internacional para tarjetas de identificación con bandas magnéticas. Define:

ISO 7813

ISO 7813 es un subconjunto de ISO 7811 específicamente para tarjetas de transacciones financieras. Diferencias clave:

Selección del Formato Correcto

  1. Ve a Configuración > Formato de Tarjeta
  2. Elige entre:
  3. Haz clic en Aplicar para guardar la configuración

Configuración

Ajustes del Dispositivo

Ajustes de la Aplicación

Solución de Problemas

Problemas Comunes

Dispositivo No Detectado

Fallos en la Lectura/Escritura

Fallos en la Aplicación

Características Avanzadas

Visualización de Datos

Visualización de Pistas

  1. Lee una tarjeta o carga datos guardados
  2. Haz clic en la pestaña “Visualización” en la ventana de Funciones Avanzadas
  3. Visualiza las representaciones generadas para cada pista

Personalización

Plantillas de Datos

Crea plantillas personalizadas para diferentes tipos de tarjetas:

  1. Ve a Plantillas > Nueva Plantilla
  2. Define los campos y formatos
  3. Guarda la plantilla para uso futuro

Preguntas Frecuentes

¿Cómo actualizo el controlador del dispositivo?

  1. Descarga el controlador más reciente del sitio web del fabricante
  2. Abre el Administrador de dispositivos
  3. Busca el dispositivo MSR605
  4. Haz clic derecho y selecciona “Actualizar controlador”
  5. Sigue las instrucciones en pantalla

¿Qué hago si la aplicación se bloquea?

  1. Cierra la aplicación
  2. Desconecta y vuelve a conectar el dispositivo
  3. Vuelve a abrir la aplicación
  4. Si el problema persiste, contacta al soporte con los detalles del error

Recibo errores de “Dispositivo no encontrado”

  1. Desconecta y vuelve a conectar el dispositivo
  2. Prueba con un puerto USB diferente
  3. Verifica que el dispositivo aparezca en el Administrador de dispositivos
  4. Reinstala los controladores si es necesario

Documentación de la API

Módulos Principales

msr605

El módulo principal que contiene la funcionalidad básica.

Clase MSR605

class MSR605:
    def __init__(self, puerto=None, velocidad=9600, tiempo_espera=1):
        """Inicializa la conexión con el dispositivo MSR605.
        
        Args:
            puerto (str, opcional): Nombre del puerto serie. Si es None, se intenta la detección automática.
            velocidad (int, opcional): Velocidad de comunicación en baudios. Por defecto: 9600.
            tiempo_espera (int, opcional): Tiempo de espera de lectura en segundos. Por defecto: 1.
        """
        pass
    
    def conectar(self):
        """Establece la conexión con el dispositivo."""
        pass
    
    def desconectar(self):
        """Cierra la conexión con el dispositivo."""
        pass
    
    def esta_conectado(self):
        """Verifica si el dispositivo está conectado.
        
        Returns:
            bool: True si está conectado, False en caso contrario.
        """
        pass
    
    def leer_tarjeta(self, pistas=[1, 2, 3]):
        """Lee datos de una tarjeta de banda magnética.
        
        Args:
            pistas (list, opcional): Lista de pistas a leer (1, 2, 3). Por defecto: todas las pistas.
            
        Returns:
            dict: Diccionario que contiene los datos de las pistas con los números de pista como claves.
        """
        pass
    
    def escribir_tarjeta(self, datos_pista, verificar=True):
        """Escribe datos en una tarjeta de banda magnética.
        
        Args:
            datos_pista (dict): Diccionario con números de pista como claves y datos como valores.
            verificar (bool, opcional): Si se debe verificar los datos escritos. Por defecto: True.
            
        Returns:
            bool: True si la escritura fue exitosa, False en caso contrario.
        """
        pass

Ejemplos de Uso

Lectura Básica

from msr605 import MSR605

# Inicializa y conecta al dispositivo
dispositivo = MSR605()
dispositivo.conectar()

# Lee todas las pistas
datos = dispositivo.leer_tarjeta()
print(f"Pista 1: {datos.get(1, 'Sin datos')}")
print(f"Pista 2: {datos.get(2, 'Sin datos')}")
print(f"Pista 3: {datos.get(3, 'Sin datos')}")

# Desconecta
dispositivo.desconectar()

Escritura Básica

from msr605 import MSR605

# Inicializa y conecta al dispositivo
dispositivo = MSR605()
dispositivo.conectar()

# Prepara los datos de las pistas
datos_pista = {
    1: "%B1234567890123456^TITULAR/TARJETA^25121010000000000000000000000000000?",
    2: ";1234567890123456=25121010000000000000?",
    3: ""  # Pista 3 vacía
}

# Escribe en la tarjeta
exito = dispositivo.escribir_tarjeta(datos_pista)
print(f"Escritura {'exitosa' if exito else 'fallida'}")

# Desconecta
dispositivo.desconectar()

Especificaciones Técnicas

Especificaciones del Hardware

Especificaciones del Software

Soporte Técnico

Recursos Adicionales

Contacto

Historial de Versiones

Versión 1.2.0 (Actual)

Versión 1.1.0

Versión 1.0.0