sane-mustek_usb(5) SANE Scanner Access Now Easy sane-mustek_usb(5)

sane-mustek_usb - بک‌اند SANE برای اسکنرهای تخت USB موستک (Mustek)

کتابخانه sane-mustek_usb یک بک‌اند SANE (Scanner Access Now Easy) پیاده‌سازی می‌کند که دسترسی به اسکنرهای تخت USB برند Mustek (از جمله مدل مشابه‌سازی‌شده Trust) را فراهم می‌سازد. در حال حاضر، اسکنرهای زیر کم‌وبیش با این بک‌اند کار می‌کنند:

Mustek 600 CU
Mustek 1200 UB
Mustek 1200 CU
Mustek 1200 CU Plus
Trust Compact Scan USB 19200

جزئیات بیشتر را می‌توان در صفحه خانگی بک‌اند Mustek USB یافت: http://www.meier-geinitz.de/sane/mustek_usb-backend.

اسکنرهای Mustek BearPaw 1200 و 2400 توسط بک‌اند plustek پشتیبانی می‌شوند. برای جزئیات به sane-plustek(5) مراجعه کنید. اسکنر Mustek BearPaw 1200F توسط بک‌اند MA-1509 پشتیبانی می‌شود. برای جزئیات به sane-ma1509(5) مراجعه کنید. سایر اسکنرهای USB موستک توسط بک‌اند gt68xx پشتیبانی می‌شوند، به sane-gt68xx(5) مراجعه کنید.

این بک‌اند فقط می‌تواند با اسکنرهایی کار کند که پیش‌تر توسط سیستم‌عامل شناسایی شده‌اند. برای جزئیات به sane-usb(5) مراجعه کنید.

اگر صاحب یک اسکنر Mustek (یا Trust) غیر از موارد ذکرشده در بالا هستید که با این بک‌اند کار می‌کند، لطفاً با ارسال نام دقیق مدل اسکنر و شناسه‌های سازنده و دستگاه USB (مثلاً از /proc/bus/usb/devices یا syslog) به من، این موضوع را اطلاع دهید.

این بک‌اند نام‌های دستگاه را به این شکل انتظار دارد:

special

که در آن special نام مسیر برای فایل دستگاه ویژه‌ای است که با اسکنر USB مطابقت دارد. در لینوکس، چنین نام دستگاهی می‌تواند برای مثال /dev/usb/scanner0 یا /dev/usbscanner1 باشد.

برای FreeBSD از /dev/uscanner0 استفاده کنید.

محتویات فایل mustek_usb.conf فهرستی از گزینه‌ها و نام‌های دستگاه متناظر با اسکنرهای USB موستک است. خطوط خالی و خطوطی که با علامت هش (#) شروع می‌شوند، نادیده گرفته می‌شوند. اگر نام دستگاهی در mustek_usb.conf قرار گیرد، باید پس از آن خطی شامل کلیدواژه option و گزینه‌ای که نوع اسکنر را مشخص می‌کند بیاید. گزینه‌های زیر می‌توانند استفاده شوند: 600cu, 1200cu, 1200cu_plus, 1200ub. برای Trust Compact Scan USB 19200 از `option 1200ub` استفاده کنید.

به‌جای استفاده از نام دستگاه، اسکنر می‌تواند از طریق عبارت‌های usb vendor_id product_id که از قبل در mustek_usb.conf گنجانده شده‌اند، به طور خودکار شناسایی شود. این مورد تنها در لینوکس 2.4.8 و بالاتر و تمام سیستم‌هایی که از libusb پشتیبانی می‌کنند عمل می‌کند. مقادیر «vendor_id» و «product_id» اعداد هگزادسیمالی هستند که اسکنر را مشخص می‌کنند. اگر این روش کار نکرد، باید یک نام دستگاه و گزینه مشخص‌کننده نوع اسکنر در mustek_usb.conf همان‌طور که در بالا شرح داده شد، قرار گیرد.

گزینه سراسری option max_block_size می‌تواند برای محدود کردن حجم داده‌های دریافتی در هر نوبت از سیستم USB استفاده شود. در صورت بروز خطاهای USB، ارزش امتحان کردن را دارد.

یک نمونه فایل پیکربندی در زیر نشان داده شده است:

# Comment
option max_block_size 1024
usb 0x055f 0x0001
/dev/usb/scanner0
option 600cu

خط اول نادیده گرفته می‌شود. خط دوم اندازه بافر را به حداکثر ۱۰۲۴ بایت تنظیم می‌کند. خط سوم تلاش می‌کند اسکنری با شناسه سازنده 0x055f و شناسه محصول 0x0001 (اسکنر Mustek 1200 CU) را به طور خودکار شناسایی کند. خط چهارم به بک‌اند می‌گوید که به /dev/usb/scanner0 متصل شود و خط پنجم مشخص می‌کند که /dev/usb/scanner0 یک Mustek 600 CU است.

/etc/sane.d/mustek_usb.conf
فایل پیکربندی بک‌اند (همچنین به توضیحات SANE_CONFIG_DIR در زیر مراجعه کنید).
/usr/lib/sane/libsane-mustek_usb.a
کتابخانه ایستا که این بک‌اند را پیاده‌سازی می‌کند.
/usr/lib/sane/libsane-mustek_usb.so
کتابخانه اشتراکی که این بک‌اند را پیاده‌سازی می‌کند (در سیستم‌هایی که از بارگذاری پویا پشتیبانی می‌کنند موجود است).

این متغیر محیطی فهرست دایرکتوری‌هایی را که ممکن است حاوی فایل پیکربندی باشند مشخص می‌کند. در سیستم‌های NIX*، دایرکتوری‌ها با دونقطه (':') و تحت OS/2 با نقطه‌ویرگول (';') از هم جدا می‌شوند. اگر این متغیر تنظیم نشده باشد، فایل پیکربندی در دو دایرکتوری پیش‌فرض جستجو می‌شود: ابتدا دایرکتوری کاری فعلی (".") و سپس در /etc/sane.d. اگر مقدار متغیر محیطی با نویسه جداکننده دایرکتوری پایان یابد، دایرکتوری‌های پیش‌فرض پس از دایرکتوری‌های صریحاً مشخص‌شده جستجو می‌شوند. برای مثال، تنظیم SANE_CONFIG_DIR روی "/tmp/config:" منجر به جستجو در دایرکتوری‌های tmp/config, ., و /etc/sane.d می‌شود (به همین ترتیب).
اگر کتابخانه با فعال بودن پشتیبانی از اشکال‌زدایی کامپایل شده باشد، این متغیر محیطی سطح اشکال‌زدایی را برای این بک‌اند کنترل می‌کند. سطوح بالاتر اشکال‌زدایی پرگویی خروجی را افزایش می‌دهند. 
مقدار  شرح
0      بدون خروجی
1      چاپ خطاهای مهلک
2      چاپ پیام‌های مهم
3      چاپ خطاهای غیرمهلک و پیام‌های کم‌اهمیت‌تر
4      چاپ همه پیام‌ها به جز پیام‌های اشکال‌زدایی
5      چاپ پیام‌های اشکال‌زدایی سطح بالا
6      چاپ پیام‌های اشکال‌زدایی سطح متوسط
7      چاپ پیام‌های اشکال‌زدایی سطح پایین

مثال:

export SANE_DEBUG_MUSTEK_USB=4

sane(7), sane-usb(5), sane-mustek(5), sane-mustek_pp(5), sane-plustek(5), sane-gt68xx(5), sane-ma1509(5)
/usr/share/doc/sane/mustek_usb/mustek_usb.CHANGES,
/usr/share/doc/sane/mustek_usb/mustek_usb.TODO
http://www.meier-geinitz.de/sane/mustek_usb-backend

Henning Meier-Geinitz <henning@meier-geinitz.de>
این بک‌اند بر پایه بک‌اند Mustek 1200ub از موستک است که توسط Tom Wang نگهداری می‌شد.

این دستگاه‌ها دارای یک نقص سخت‌افزاری هستند: به محض اینکه داده‌ای در آن‌ها نوشته شود، امکان بازنشانی آن‌ها وجود ندارد (toggle = DATA0). این بدان معناست که هر عملیاتی که تلاش کند دستگاه را بازنشانی کند، به اتمام مهلت زمانی (timeout) منجر خواهد شد.

در نسخه‌های پیشین، این بک‌اند در صورت بارگذاری مجدد در برخی پیکربندی‌ها با خطا مواجه می‌شد. تنها راهکار در این حالت، جدا کردن و اتصال مجدد کابل اسکنر بود. بک‌اند اکنون از یک راهکار جایگزین برای رفع این نقص استفاده می‌کند، اما این ویژگی تنها روی لینوکس آزمایش شده است. گزارش‌ها برای سایر سیستم‌عامل‌ها مورد استقبال است.

اطلاعات دقیق‌تر پیرامون اشکالات در صفحه خانگی بک‌اند Mustek در دسترس است: http://www.meier-geinitz.de/sane/mustek_usb-backend.

13 Jul 2008