sane-usb(5)

الاسم
sane-usb - نصائح تهيئة USB لـ SANE

الوصف
تحتوي صفحة الدليل هذه على معلومات حول كيفية الوصول إلى الماسحات الضوئية بواجهة USB. تركز على موضوعين رئيسيين: جعل نواة نظام التشغيل تكتشف الماسح الضوئي واستخدامه مع SANE.

تنطبق هذه الصفحة على معظم الخلفيات والماسحات الضوئية USB، لأنها تستخدم الواجهة العامة sanei_usb. لكن هناك استثناء واحد: الماسحات الضوئية USB المدعومة من خلفية sane-microtek2(5) تحتاج إلى برنامج تشغيل USB خاص للنواة.

بداية سريعة
هذا قسم قصير يشبه دليل HOWTO. للحصول على التفاصيل الكاملة، اقرأ الأقسام التالية. الهدف من هذا القسم هو جعل الماسح الضوئي يُكتشف بواسطة sane-find-scanner(1).

شغّل sane-find-scanner(1). إذا أدرج الماسح الضوئي الخاص بك مع معرفات البائع والمنتج الصحيحة، فقد انتهيت. راجع القسم SANE ISSUES للحصول على تفاصيل حول كيفية المتابعة.

sane-find-scanner(1) لا يُدرج الماسح الضوئي الخاص بك؟ هل يعمل كجذر؟ إذا كانت الإجابة بنعم، فهناك مشكلة صلاحيات. راجع القسم LIBUSB للحصول على التفاصيل.

لم يُعثر على شيء حتى كجذر؟ تحقق من أن نواتك تدعم USB وأن libusb مثبت (راجع القسم LIBUSB).

طرق الوصول إلى USB
للوصول إلى أجهزة USB، تُستخدم مكتبة USB libusb. كان هناك طريقة أخرى للوصول إلى أجهزة USB: برنامج تشغيل الماسح الضوئي للنواة. طريقة برنامج تشغيل الماسح الضوئي للنواة مهملة ولا ينبغي استخدامها بعد الآن. قد تُزال من SANE في أي وقت. في لينكس، أُزيل برنامج تشغيل الماسح الضوئي للنواة في سلسلة النواة 2.6.*. فقط الوصول عبر libusb موثق في صفحة الدليل هذه.

LIBUSB
يمكن لـ SANE استخدام libusb 0.1.6 أو أحدث فقط. يجب تثبيته في وقت البناء. توزيعات لينكس الحديثة وأنظمة التشغيل الأخرى تأتي مع libusb.

يمكن لـ Libusb الوصول إلى الماسح الضوئي الخاص بك فقط إذا لم يكن مطالبًا به من قبل برنامج تشغيل الماسح الضوئي للنواة. إذا كنت تريد استخدام libusb، فافرغ برنامج تشغيل النواة (مثل rmmod scanner تحت لينكس) أو عطّل برنامج التشغيل عند تجميع نواة جديدة. بالنسبة للينكس، تحتاج نواتك إلى دعم نظام ملفات USB (usbfs). للنواة الأقدم من 2.4.19، استبدل "usbfs" بـ "usbdevfs" لأن الاسم تغير. يجب وصل نظام الملفات هذا. يُفعل ذلك آليًا عند الإقلاع، إذا كان /etc/fstab يحتوي على سطر مثل هذا:

    none /proc/bus/usb usbfs defaults 0 0

يجب تعديل صلاحيات ملفات الجهاز المستخدمة من قبل libusb للوصول من قبل المستخدم. وإلا، يمكن للجذر فقط استخدام أجهزة SANE. بالنسبة لـ Linux، توجد الأجهزة في /proc/bus/usb/ أو في /dev/bus/usb، إذا كنت تستخدم udev. هناك أدلة مسماة مثل "001" (اسم الناقل) تحتوي على ملفات "001"، "002" إلخ (ملفات الجهاز). يمكن معرفة ملفات الجهاز الصحيحة بتشغيل: scanimage -L: كجذر. تعيين الصلاحيات باستخدام chmod(1) ليس دائمًا، مع ذلك. ستُعاد تعيينها بعد إعادة التشغيل أو إعادة توصيل الماسح الضوئي.

عادةً ما يُستخدم udev(7) أو للتوزيعات الأقدم أدوات hotplug، التي تدعم التعيين الديناميكي لصلاحيات الوصول. تأتي SANE مع نصوص udev و hotplug في الدليل tools/udev و tools/hotplug. يمكن استخدامها لتعيين الصلاحيات، راجع /usr/share/doc/sane/README.linux، tools/README و README في الدليل tools/hotplug لمزيد من التفاصيل.

بالنسبة لـ BSDs، تُسمى ملفات الجهاز المستخدمة من قبل libusb /dev/ugen*. استخدم chmod(1) لتطبيق الصلاحيات المناسبة.

قضايا SANE

يفترض هذا القسم أن الماسح الضوئي الخاص بك يُكتشف بواسطة sane-find-scanner(1). لا معنى للمتابعة إذا لم يكن الأمر كذلك. بينما sane-find-scanner(1) قادر على اكتشاف أي ماسح ضوئي USB، فإن المسح الفعلي سيعمل فقط إذا كان الماسح الضوئي مدعومًا من خلفية SANE. يمكن العثور على معلومات حول مستوى الدعم على صفحة ويب SANE (http://www.sane-project.org/)، وصفحات دليل الخلفية الفردية.

تستطيع معظم الخلفيات كشف الماسحات الضوئية USB آلي باستخدام سطور ملف الضبط "usb". تسمح هذه الطريقة بتعريف الماسحات بواسطة أرقام البائع والمنتج USB. صيغة تحديد ماسح ضوئي بهذه الطريقة هي:

    usb البائع المنتج

حيث البائع هو معرف بائع USB، والمنتج هو معرف منتج USB للماسح الضوئي. كلا المعرفين هما أعداد صحيحة غير سالبة بصيغة عشرية أو سداسية عشرية. يمكن إيجاد القيم الصحيحة لهذه الحقول بتشغيل sane-find-scanner(1)، أو بالنظر في سجل النظام (مثل /var/log/messages) أو تحت لينكس بإصدار الأمر cat /proc/bus/usb/devices. هذا مثال لسطر ملف ضبط:

    usb 0x055f 0x0006

سيكون له الأثر بأن جميع أجهزة USB في النظام ذات معرف بائع 0x55f ومعرف منتج 0x0006 سيتم فحصها وتعريفها بواسطة الخلفية.

إذا لم يتم كشف الماسح الضوئي آلي، قد يكون من الضروري تحرير ملف ضبط الخلفية المناسب قبل استخدام SANE لأول مرة. لوصف مفصل لملف ضبط كل خلفية، يُرجى الرجوع إلى صفحة الدليل الخاصة بالخلفية ذات الصلة (مثل sane-mustek_usb(5) لماسحات Mustek USB).

لا تنشئ رابطًا رمزيًا من /dev/scanner إلى جهاز USB لأن هذا الرابط يُستخدم بواسطة خلفيات SCSI. قد يرتبك الماسح الضوئي إذا تلقى أوامر SCSI.

البيئة

SANE_DEBUG_SANEI_USB
    إذا تم ترجمة المكتبة مع دعم التصحيح مفعل، يتحكم متغير البيئة هذا في مستوى التصحيح للنظام الفرعي للإدخال/الإخراج USB. مثلًا، قيمة 128 تطلب طباعة كل مخرجات التصحيح. المستويات الأصغر تقلل الإسهاب. القيم الأكبر من 4 تفعل تصحيح libusb (إذا كان متاحًا). مثال: export SANE_DEBUG_SANEI_USB=4.

SANE_USB_WORKAROUND
    إذا لم يعمل الماسح الضوئي عند توصيله بمنفذ USB3، حاول ضبط متغير البيئة SANE_USB_WORKAROUND إلى 1. قد يتجاوز هذا مشاكل تحدث مع إصدارات نواة معينة. مثال: export SANE_USB_WORKAROUND=1.

SANE_XEROX_USB_HALT_WORKAROUND
    إذا تم كشف ماسح Xerox / Samsung / HP القديم (قبل 2010) مرة واحدة فقط ويتطلب الاستخدام اللاحق إعادة توصيل الكابل، حاول ضبط متغير البيئة SANE_XEROX_USB_HALT_WORKAROUND إلى 1. قد يتجاوز هذا مشاكل تحدث مع وحدات تحكم USB معينة. مثال: export SANE_XEROX_USB_HALT_WORKAROUND=1.

انظر أيضًا
sane(7), sane-find-scanner(1), sane-"اسم_الخلفية"(5), sane-scsi(5)

المؤلف
Henning Meier-Geinitz <henning@meier-geinitz.de>

ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.