.TH sane\-u12 5 "14 Jul 2008" "" "SANE Scanner Access Now Easy"
.IX sane\-u12
.SH "نام (NAME)"
sane\-u12 \- بک‌اند SANE برای اسکنرهای تخت USB شرکت Plustek، مبتنی بر طراحی‌های قدیمی‌تر درگاه موازی
.SH "توضیحات (DESCRIPTION)"
کتابخانه
.B sane\-u12
یک بک‌اند SANE (دسترسی آسان به اسکنر) را پیاده‌سازی می‌کند که دسترسی به اسکنرهای تخت USB مبتنی بر تراشه ASIC 98003 شرکت Plustek (یک ASIC درگاه موازی) و تراشه پل ارتباطی USB به درگاه موازی شرکت GeneSys Logics را فراهم می‌نماید.

.SH "دستگاه‌های پشتیبانی‌شده (SUPPORTED DEVICES)"
این بک‌اند قادر است از برخی اسکنرهای اولیه USB شرکت Plustek که طراحی قدیمی درگاه موازی آن‌ها حول تراشه ASIC 98003 بوده و همچنین سایر دستگاه‌های بازتولیدشده با نام‌های تجاری دیگر (rebadged) پشتیبانی کند. جدول‌های زیر یک نمای کلی و کوتاه ارائه می‌دهند.

اگر اسکنر Plustek شما شناسه محصول (Product ID) دیگری دارد، آن‌گاه دستگاه توسط این بک‌اند پشتیبانی
.B نمی‌شود.
.br

تولیدکننده Plustek \- شناسه: 0x07B3
.br
.ft CR
.nf
----------------------------------------------------------
Model:                   Vendor-ID:       Product-ID:
----------------------------------------------------------
OpticPro U12             0x07B3           0x0001
OpticPro U1212           0x07B3           0x0001
OpticPro UT12            0x07B3           0x0001
.fi
.ft R
.PP

تولیدکننده KYE/Genius
.br
.ft CR
.nf
--------------------------------------------------------
USB Model:               Vendor-ID:       Product-ID:
--------------------------------------------------------
ColorPage Vivid III USB  0x07B3           0x0001
ColorPage HR6 V1         0x0458           0x2004
.fi
.ft R
.PP

.SH "پیکربندی (CONFIGURATION)"
برای استفاده از اسکنر خود با این بک‌اند، حداقل به دو مدخل در فایل پیکربندی
.I /etc/sane.d/u12.conf
نیاز دارید:

.RS
.I [usb] vendor-id product-id
.br
.I device /dev/usbscanner
.RE
.PP
.I [usb]
به بک‌اند اعلام می‌کند که نام دستگاه بعدی (در اینجا
.IR /dev/usbscanner )
باید به عنوان یک دستگاه اسکنر USB تفسیر شود. اگر شناسه‌های فروشنده و محصول مشخص نشده باشند، بک‌اند تلاش می‌کند آن را به صورت خودکار شناسایی کند. اگر device روی
.I auto
تنظیم شده باشد، آن‌گاه دستگاه منطبق بعدی استفاده خواهد شد.
.PP
.B
گزینه‌ها:
.PP
option warmup t
.RS
.I t
مدت زمان گرم شدن را بر حسب ثانیه مشخص می‌کند.
.RE
.PP
option lampOff t
.RS
.I t
زمان بر حسب ثانیه برای خاموش کردن لامپ‌ها در حالت آماده‌به‌کار (standby) است.
.RE
.PP
option lOffonEnd b
.RS
.I b
رفتار دستگاه را هنگام بستن بک‌اند مشخص می‌کند؛ 1 --> خاموش کردن لامپ‌ها، 0 --> عدم تغییر وضعیت لامپ‌ها.
.RE

.PP
برای مشاهده مثال‌ها به فایل
.I u12.conf
مراجعه کنید.
.PP
.B نکته:
باید مطمئن شوید که زیرسیستم USB به درستی بارگذاری شده و به گره دستگاه (device-node) دسترسی دارید. برای جزئیات بیشتر به صفحه راهنمای
.BR sane\-usb (5)
مراجعه نمایید. می‌توانید از
.BR sane\-find\-scanner (1)
برای بررسی دسترسی به دستگاه خود استفاده کنید.
.PP
.B نکته:
.br
اگر فایل پیکربندی وجود نداشته باشد، بک‌اند به صورت پیش‌فرض از
.B device auto
استفاده می‌کند.

.SH "فایل‌ها (FILES)"
.TP
.I /etc/sane.d/u12.conf
فایل پیکربندی بک‌اند.
.TP
.I /usr/lib/sane/libsane\-u12.a
کتابخانه ایستا که این بک‌اند را پیاده‌سازی می‌کند.
.TP
.I /usr/lib/sane/libsane\-u12.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_U12
اگر کتابخانه با پشتیبانی از اشکال‌زدایی (debug) کامپایل شده باشد، این متغیر محیطی سطح اشکال‌زدایی را برای این بک‌اند کنترل می‌کند. سطوح بالاتر اشکال‌زدایی، پرحرفی (verbosity) خروجی را افزایش می‌دهند.

مثال:
export SANE_DEBUG_U12=10

.SH "همچنین ببینید (SEE ALSO)"
.BR sane (7),
.BR sane\-usb (5),
.BR sane\-plustek (5),
.BR sane\-find\-scanner (1),
.BR xscanimage (1),
.BR scanimage (1)
.br
.I /usr/share/doc/sane/u12/U12.changes

.SH "تماس و گزارش باگ‌ها (CONTACT AND BUG-REPORTS)"
لطفاً هرگونه اطلاعات و گزارش‌های باگ را به آدرس زیر ارسال کنید:
.br
.B SANE Mailing List
.PP
اطلاعات و راهنمایی‌های بیشتر را می‌توان از بایگانی فهرست پستی در نشانی زیر دریافت کرد:
.IR http://www.sane\-project.org/mailing\-lists.html .
.PP
برای دریافت پیام‌های اشکال‌زدایی از بک‌اند، لطفاً متغیر محیطی
.B SANE_DEBUG_U12
را قبل از فراخوانی فرانت‌اند SANE مورد نظر خود (مانند
.BR xscanimage (1))
تنظیم کنید:
.PP
.I export SANE_DEBUG_U12=20 ; xscanimage
.PP
این مقدار میزان پرحرفی خروجی بک‌اند را کنترل می‌کند.

.SH "باگ‌های شناخته‌شده و محدودیت‌ها (KNOWN BUGS & RESTRICTIONS)"
* این درایور در وضعیت آلفا قرار دارد، بنابراین لطفاً انتظار زیادی نداشته باشید!!!
.PP
* هنگام استفاده از libusb، این احتمال وجود دارد که بک‌اند متوقف شود (hang کند). در این صورت، اسکنر را دوباره متصل کنید.