نام (NAME)

sane-u12 - بک‌اند SANE برای اسکنرهای تخت USB شرکت Plustek، مبتنی بر طراحی‌های قدیمی‌تر درگاه موازی

توضیحات (DESCRIPTION)

کتابخانه sane-u12 یک بک‌اند SANE (دسترسی آسان به اسکنر) را پیاده‌سازی می‌کند که دسترسی به اسکنرهای تخت USB مبتنی بر تراشه ASIC 98003 شرکت Plustek (یک ASIC درگاه موازی) و تراشه پل ارتباطی USB به درگاه موازی شرکت GeneSys Logics را فراهم می‌نماید.

دستگاه‌های پشتیبانی‌شده (SUPPORTED DEVICES)

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

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

تولیدکننده Plustek - شناسه: 0x07B3

----------------------------------------------------------
Model:                   Vendor-ID:       Product-ID:
----------------------------------------------------------
OpticPro U12             0x07B3           0x0001
OpticPro U1212           0x07B3           0x0001
OpticPro UT12            0x07B3           0x0001

تولیدکننده KYE/Genius

--------------------------------------------------------
USB Model:               Vendor-ID:       Product-ID:
--------------------------------------------------------
ColorPage Vivid III USB  0x07B3           0x0001
ColorPage HR6 V1         0x0458           0x2004

پیکربندی (CONFIGURATION)

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

[usb] vendor-id product-id
device /dev/usbscanner

[usb] به بک‌اند اعلام می‌کند که نام دستگاه بعدی (در اینجا /dev/usbscanner) باید به عنوان یک دستگاه اسکنر USB تفسیر شود. اگر شناسه‌های فروشنده و محصول مشخص نشده باشند، بک‌اند تلاش می‌کند آن را به صورت خودکار شناسایی کند. اگر device روی auto تنظیم شده باشد، آن‌گاه دستگاه منطبق بعدی استفاده خواهد شد.

گزینه‌ها:

option warmup t

t مدت زمان گرم شدن را بر حسب ثانیه مشخص می‌کند.

option lampOff t

t زمان بر حسب ثانیه برای خاموش کردن لامپ‌ها در حالت آماده‌به‌کار (standby) است.

option lOffonEnd b

b رفتار دستگاه را هنگام بستن بک‌اند مشخص می‌کند؛ 1 --> خاموش کردن لامپ‌ها، 0 --> عدم تغییر وضعیت لامپ‌ها.

برای مشاهده مثال‌ها به فایل u12.conf مراجعه کنید.

نکته: باید مطمئن شوید که زیرسیستم USB به درستی بارگذاری شده و به گره دستگاه (device-node) دسترسی دارید. برای جزئیات بیشتر به صفحه راهنمای sane-usb(5) مراجعه نمایید. می‌توانید از sane-find-scanner(1) برای بررسی دسترسی به دستگاه خود استفاده کنید.

نکته:
اگر فایل پیکربندی وجود نداشته باشد، بک‌اند به صورت پیش‌فرض از device auto استفاده می‌کند.

فایل‌ها (FILES)

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

محیط (ENVIRONMENT)

SANE_CONFIG_DIR: این متغیر محیطی فهرستی از دایرکتوری‌هایی را مشخص می‌کند که ممکن است حاوی فایل پیکربندی باشند. در سیستم‌های NIX*، دایرکتوری‌ها با دو‌نقطه («:») و در OS/2 با نقطه‌ویرگول («;») از هم جدا می‌شوند. اگر این متغیر تنظیم نشده باشد، فایل پیکربندی در دو دایرکتوری پیش‌فرض جستجو می‌شود: ابتدا دایرکتوری کاری فعلی («.») و سپس در /etc/sane.d. اگر مقدار متغیر محیطی با نویسه جداکننده دایرکتوری پایان یابد، دایرکتوری‌های پیش‌فرض پس از دایرکتوری‌هایی که صراحتاً مشخص شده‌اند جستجو می‌شوند. برای مثال، تنظیم SANE_CONFIG_DIR روی «/tmp/config:» منجر به جستجو در دایرکتوری‌های tmp/config، . و /etc/sane.d (به همین ترتیب) خواهد شد.
SANE_DEBUG_U12: اگر کتابخانه با پشتیبانی از اشکال‌زدایی (debug) کامپایل شده باشد، این متغیر محیطی سطح اشکال‌زدایی را برای این بک‌اند کنترل می‌کند. سطوح بالاتر اشکال‌زدایی، پرحرفی (verbosity) خروجی را افزایش می‌دهند.
مثال: export SANE_DEBUG_U12=10

همچنین ببینید (SEE ALSO)

sane(7), sane-usb(5), sane-plustek(5), sane-find-scanner(1), xscanimage(1), scanimage(1)
/usr/share/doc/sane/u12/U12.changes

تماس و گزارش باگ‌ها (CONTACT AND BUG-REPORTS)

لطفاً هرگونه اطلاعات و گزارش‌های باگ را به آدرس زیر ارسال کنید:
SANE Mailing List

اطلاعات و راهنمایی‌های بیشتر را می‌توان از بایگانی فهرست پستی در نشانی زیر دریافت کرد: http://www.sane-project.org/mailing-lists.html.

برای دریافت پیام‌های اشکال‌زدایی از بک‌اند، لطفاً متغیر محیطی SANE_DEBUG_U12 را قبل از فراخوانی فرانت‌اند SANE مورد نظر خود (مانند xscanimage(1)) تنظیم کنید:

export SANE_DEBUG_U12=20 ; xscanimage

این مقدار میزان پرحرفی خروجی بک‌اند را کنترل می‌کند.

باگ‌های شناخته‌شده و محدودیت‌ها (KNOWN BUGS & RESTRICTIONS)

* این درایور در وضعیت آلفا قرار دارد، بنابراین لطفاً انتظار زیادی نداشته باشید!!!

* هنگام استفاده از libusb، این احتمال وجود دارد که بک‌اند متوقف شود (hang کند). در این صورت، اسکنر را دوباره متصل کنید.