.TH sane\-mustek_usb 5 "13 Jul 2008" "" "SANE Scanner Access Now Easy"
.IX sane\-mustek_usb
.SH "نام (NAME)"
sane\-mustek_usb \- بک‌اند SANE برای اسکنرهای تخت USB موستک (Mustek)
.SH "توضیحات (DESCRIPTION)"
کتابخانه
.B sane\-mustek_usb
یک بک‌اند SANE (Scanner Access Now Easy) پیاده‌سازی می‌کند که دسترسی به اسکنرهای تخت USB برند Mustek (از جمله مدل مشابه‌سازی‌شده Trust) را فراهم می‌سازد. در حال حاضر، اسکنرهای زیر کم‌وبیش با این بک‌اند کار می‌کنند:
.PP
.RS
Mustek 600 CU
.br
Mustek 1200 UB
.br
Mustek 1200 CU
.br
Mustek 1200 CU Plus
.br
Trust Compact Scan USB 19200
.br
.RE
.PP
جزئیات بیشتر را می‌توان در صفحه خانگی بک‌اند Mustek USB یافت:
.IR http://www.meier\-geinitz.de/sane/mustek_usb\-backend .
.PP
اسکنرهای Mustek BearPaw 1200 و 2400 توسط بک‌اند plustek پشتیبانی می‌شوند. برای جزئیات به
.BR sane\-plustek (5)
مراجعه کنید. اسکنر Mustek BearPaw 1200F توسط بک‌اند MA-1509 پشتیبانی می‌شود. برای جزئیات به
.BR sane\-ma1509 (5)
مراجعه کنید. سایر اسکنرهای USB موستک توسط بک‌اند gt68xx پشتیبانی می‌شوند، به
.BR sane\-gt68xx (5)
مراجعه کنید.
.PP
این بک‌اند فقط می‌تواند با اسکنرهایی کار کند که پیش‌تر توسط سیستم‌عامل شناسایی شده‌اند. برای جزئیات به
.BR sane\-usb (5)
مراجعه کنید.
.PP
اگر صاحب یک اسکنر Mustek (یا Trust) غیر از موارد ذکرشده در بالا هستید که با این بک‌اند کار می‌کند، لطفاً با ارسال نام دقیق مدل اسکنر و شناسه‌های سازنده و دستگاه USB (مثلاً از
.I /proc/bus/usb/devices
یا syslog) به من، این موضوع را اطلاع دهید.

.SH "نام‌های دستگاه (DEVICE NAMES)"
این بک‌اند نام‌های دستگاه را به این شکل انتظار دارد:
.PP
.RS
.I special
.RE
.PP
که در آن
.I special
نام مسیر برای فایل دستگاه ویژه‌ای است که با اسکنر USB مطابقت دارد. در لینوکس، چنین نام دستگاهی می‌تواند برای مثال
.I /dev/usb/scanner0
یا
.IR /dev/usbscanner1
باشد.
.PP
برای FreeBSD از
.IR /dev/uscanner0
استفاده کنید.

.SH "پیکربندی (CONFIGURATION)"
محتویات فایل
.I mustek_usb.conf
فهرستی از گزینه‌ها و نام‌های دستگاه متناظر با اسکنرهای USB موستک است. خطوط خالی و خطوطی که با علامت هش (#) شروع می‌شوند، نادیده گرفته می‌شوند. اگر نام دستگاهی در
.IR mustek_usb.conf
قرار گیرد، باید پس از آن خطی شامل کلیدواژه
.B option
و گزینه‌ای که نوع اسکنر را مشخص می‌کند بیاید. گزینه‌های زیر می‌توانند استفاده شوند:
.BR 600cu ,
.BR 1200cu ,
.BR 1200cu_plus ,
.BR 1200ub .
برای Trust Compact Scan USB 19200 از `option 1200ub` استفاده کنید.
.PP
به‌جای استفاده از نام دستگاه، اسکنر می‌تواند از طریق عبارت‌های
.B "usb vendor_id product_id"
که از قبل در
.IR mustek_usb.conf
گنجانده شده‌اند، به طور خودکار شناسایی شود. این مورد تنها در لینوکس 2.4.8 و بالاتر و تمام سیستم‌هایی که از libusb پشتیبانی می‌کنند عمل می‌کند. مقادیر «vendor_id» و «product_id» اعداد هگزادسیمالی هستند که اسکنر را مشخص می‌کنند. اگر این روش کار نکرد، باید یک نام دستگاه و گزینه مشخص‌کننده نوع اسکنر در
.I mustek_usb.conf
همان‌طور که در بالا شرح داده شد، قرار گیرد.
.PP
گزینه سراسری
.B option max_block_size
می‌تواند برای محدود کردن حجم داده‌های دریافتی در هر نوبت از سیستم USB استفاده شود. در صورت بروز خطاهای USB، ارزش امتحان کردن را دارد.
.PP
یک نمونه فایل پیکربندی در زیر نشان داده شده است:
.PP
.RS
# Comment
.br
option max_block_size 1024
.br
usb 0x055f 0x0001
.br
/dev/usb/scanner0
.br
option 600cu
.RE
.PP
خط اول نادیده گرفته می‌شود. خط دوم اندازه بافر را به حداکثر ۱۰۲۴ بایت تنظیم می‌کند. خط سوم تلاش می‌کند اسکنری با شناسه سازنده 0x055f و شناسه محصول 0x0001 (اسکنر Mustek 1200 CU) را به طور خودکار شناسایی کند. خط چهارم به بک‌اند می‌گوید که به
.I /dev/usb/scanner0
متصل شود و خط پنجم مشخص می‌کند که
.I /dev/usb/scanner0
یک Mustek 600 CU است.
.SH "فایل‌ها (FILES)"
.TP
.I /etc/sane.d/mustek_usb.conf
فایل پیکربندی بک‌اند (همچنین به توضیحات
.B SANE_CONFIG_DIR
در زیر مراجعه کنید).
.TP
.I /usr/lib/sane/libsane\-mustek_usb.a
کتابخانه ایستا که این بک‌اند را پیاده‌سازی می‌کند.
.TP
.I /usr/lib/sane/libsane\-mustek_usb.so
کتابخانه اشتراکی که این بک‌اند را پیاده‌سازی می‌کند (در سیستم‌هایی که از بارگذاری پویا پشتیبانی می‌کنند موجود است).
.SH "متغیرهای محیطی (ENVIRONMENT)"
.TP
.B SANE_CONFIG_DIR
این متغیر محیطی فهرست دایرکتوری‌هایی را که ممکن است حاوی فایل پیکربندی باشند مشخص می‌کند. در سیستم‌های NIX*، دایرکتوری‌ها با دونقطه (':') و تحت OS/2 با نقطه‌ویرگول (';') از هم جدا می‌شوند. اگر این متغیر تنظیم نشده باشد، فایل پیکربندی در دو دایرکتوری پیش‌فرض جستجو می‌شود: ابتدا دایرکتوری کاری فعلی (".") و سپس در
.IR /etc/sane.d .
اگر مقدار متغیر محیطی با نویسه جداکننده دایرکتوری پایان یابد، دایرکتوری‌های پیش‌فرض پس از دایرکتوری‌های صریحاً مشخص‌شده جستجو می‌شوند. برای مثال، تنظیم
.B SANE_CONFIG_DIR
روی "/tmp/config:" منجر به جستجو در دایرکتوری‌های
.IR tmp/config ,
.IR . ,
و
.I "/etc/sane.d"
می‌شود (به همین ترتیب).
.TP
.B SANE_DEBUG_MUSTEK_USB
اگر کتابخانه با فعال بودن پشتیبانی از اشکال‌زدایی کامپایل شده باشد، این متغیر محیطی سطح اشکال‌زدایی را برای این بک‌اند کنترل می‌کند. سطوح بالاتر اشکال‌زدایی پرگویی خروجی را افزایش می‌دهند.

.ft CR
.nf
مقدار  شرح
0      بدون خروجی
1      چاپ خطاهای مهلک
2      چاپ پیام‌های مهم
3      چاپ خطاهای غیرمهلک و پیام‌های کم‌اهمیت‌تر
4      چاپ همه پیام‌ها به جز پیام‌های اشکال‌زدایی
5      چاپ پیام‌های اشکال‌زدایی سطح بالا
6      چاپ پیام‌های اشکال‌زدایی سطح متوسط
7      چاپ پیام‌های اشکال‌زدایی سطح پایین
.fi
.ft R

مثال:
.nf
export SANE_DEBUG_MUSTEK_USB=4
.fi

.SH "همچنین ببینید (SEE ALSO)"
.BR sane (7),
.BR sane\-usb (5),
.BR sane\-mustek (5),
.BR sane\-mustek_pp (5),
.BR sane\-plustek (5),
.BR sane\-gt68xx (5),
.BR sane\-ma1509 (5)
.br
.IR /usr/share/doc/sane/mustek_usb/mustek_usb.CHANGES ,
.br
.I /usr/share/doc/sane/mustek_usb/mustek_usb.TODO
.br
.I http://www.meier\-geinitz.de/sane/mustek_usb\-backend

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

.SH "اشکالات (BUGS)"
این دستگاه‌ها دارای یک نقص سخت‌افزاری هستند: به محض اینکه داده‌ای در آن‌ها نوشته شود، امکان بازنشانی آن‌ها وجود ندارد (toggle = DATA0). این بدان معناست که هر عملیاتی که تلاش کند دستگاه را بازنشانی کند، به اتمام مهلت زمانی (timeout) منجر خواهد شد.
.PP
در نسخه‌های پیشین، این بک‌اند در صورت بارگذاری مجدد در برخی پیکربندی‌ها با خطا مواجه می‌شد. تنها راهکار در این حالت، جدا کردن و اتصال مجدد کابل اسکنر بود. بک‌اند اکنون از یک راهکار جایگزین برای رفع این نقص استفاده می‌کند، اما این ویژگی تنها روی لینوکس آزمایش شده است. گزارش‌ها برای سایر سیستم‌عامل‌ها مورد استقبال است.
.PP
اطلاعات دقیق‌تر پیرامون اشکالات در صفحه خانگی بک‌اند Mustek در دسترس است:
.IR http://www.meier\-geinitz.de/sane/mustek_usb\-backend .