دليل مستخدم قارئ/كاتب البطاقات MSR605

مرحبًا بكم في دليل مستخدم قارئ/كاتب البطاقات MSR605! سيساعدك هذا المستند على البدء في استخدام التطبيق لقراءة وكتابة البطاقات الممغنطة.

جدول المحتويات

  1. التثبيت
  2. البدء
  3. قراءة البطاقات
  4. كتابة البطاقات
  5. التكوين
  6. استكشاف الأخطاء وإصلاحها

التثبيت

ويندوز

  1. حمل أحدث إصدار من المثبت من صفحة الإصدارات
  2. شغل المثبت واتبع التعليمات الظاهرة على الشاشة
  3. صل جهاز MSR605 بأحد منافذ USB المتاحة
  4. شغل التطبيق من قائمة ابدأ أو اختصار سطح المكتب

لينكس/ماك

  1. تأكد من تثبيت Python 3.8 أو أحدث
  2. قم بتثبيت المتطلبات: 
    pip install -r requirements.txt
  3. شغل التطبيق: 
    python main.py

البدء

توصيل الجهاز

  1. صل جهاز MSR605 بجهاز الكمبيوتر باستخدام كابل USB
  2. يجب على التطبيق اكتشاف الجهاز تلقائيًا
  3. سيظهر شريط الحالة “تم الاتصال بالجهاز” عند نجاح الاتصال

الواجهة الرئيسية

قراءة البطاقات

  1. أدخل البطاقة الممغنطة في القارئ
  2. اضغط على زر “قراءة”
  3. ستظهر بيانات البطاقة في النافذة الرئيسية
  4. لحفظ البيانات، اضغط على “ملف” > “حفظ باسم…”

كتابة البطاقات

  1. أدخل بطاقة قابلة للكتابة في الجهاز
  2. أدخل أو الصق البيانات التي تريد كتابتها في حقول المسارات المناسبة
  3. حدد المسارات التي تريد الكتابة عليها
  4. اضغط على زر “كتابة”
  5. سيظهر شريط الحالة نتيجة العملية

تنسيقات البطاقات المدعومة

يدعم التطبيق معيارين رئيسيين للبطاقات الممغنطة: ISO 7811 و ISO 7813.

ISO 7811

المعيار الدولي لبطاقات الهوية ذات الشريط المغناطيسي:

ISO 7813

مجموعة فرعية من ISO 7811 للبطاقات المالية:

اختيار التنسيق

  1. انتقل إلى الإعدادات > تنسيق البطاقة
  2. اختر:
  3. اضغط تطبيق

التكوين

إعدادات الجهاز

إعدادات التطبيق

استكشاف الأخطاء وإصلاحها

مشاكل شائعة

لم يتم العثور على الجهاز

فشل القراءة/الكتابة

تعطل التطبيق

وثائق واجهة برمجة التطبيقات MSR605

الوحدات الأساسية

msr605

الوحدة الرئيسية التي تحتوي على الوظائف الأساسية.

صنف MSR605

class MSR605:
    def __init__(self, port=None, baudrate=9600, timeout=1):
        """تهيئة الاتصال بجهاز MSR605.
        
        المعاملات:
            port (str, اختياري): اسم المنفذ التسلسلي. إذا كان None، 
                               سيتم محاولة الكشف التلقائي.
            baudrate (int, اختياري): سرعة البت. الافتراضي 9600.
            timeout (int, اختياري): وقت انتهاء القراءة بالثواني. الافتراضي 1.
        """
        pass
    
    def connect(self):
        """إنشاء اتصال بالجهاز."""
        pass
    
    def disconnect(self):
        """إغلاق الاتصال بالجهاز."""
        pass
    
    def is_connected(self):
        """التحقق من اتصال الجهاز.
        
        الإرجاع:
            bool: True إذا كان متصلاً، وإلا False.
        """
        pass

أمثلة الاستخدام

قراءة بطاقة

from msr605 import MSR605

try:
    # التهيئة مع الكشف التلقائي عن المنفذ
    device = MSR605()
    device.connect()
    
    if device.is_connected():
        # قراءة جميع المسارات
        tracks = device.read_tracks()
        
        # عرض البيانات
        for i, track in enumerate(tracks, 1):
            if track['data']:
                print(f"المسار {i}: {track['data']}")
            else:
                print(f"المسار {i}: لا توجد بيانات")
    
    device.disconnect()
    
except Exception as e:
    print(f"خطأ: {str(e)}")
    if 'device' in locals():
        device.disconnect()

استكشاف أخطاء واجهة برمجة التطبيقات

خطأ: “الجهاز غير موجود”

  1. تحقق من اتصال الجهاز
  2. تأكد من تثبيت التعريفات بشكل صحيح
  3. تحقق من أذونات الوصول إلى المنفذ التسلسلي
  4. اتصل بدعم العملاء مع تفاصيل الخطأ