نام (NAME)

sane-plustek - بک‌اند SANE برای اسکنرهای تخت USB مبتنی بر LM983[1/2/3]

توضیحات (DESCRIPTION)

کتابخانه sane-plustek یک بک‌اند SANE (دسترسی آسان به اسکنر) را پیاده‌سازی می‌کند که امکان دسترسی به اسکنرهای تخت USB مبتنی بر چیپ‌ست‌های Merlin شرکت National Semiconductor (شامل LM9831، 9832 و 9833) را فراهم می‌آورد. اگر به دنبال پشتیبانی از درگاه موازی (parallel-port) برای اسکنرهای Plustek هستید، لطفاً به بک‌اند sane-plustek_pp(5) مراجعه کنید.

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

این بک‌اند قادر به پشتیبانی از اسکنرهای USB مبتنی بر چیپ‌ست‌های LM9831، LM9832 و LM9833 شرکت National Semiconductor است. جدول‌های زیر دستگاه‌های مختلفی را نشان می‌دهند که در حال حاضر کارکرد آن‌ها گزارش شده است. اگر اسکنر Plustek شما شناسه محصول (Product ID) دیگری دارد، دستگاه مربوطه توسط این بک‌اند پشتیبانی نمی‌شود.

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

----------------------------------------------------------
USB Model:         ASIC:  Properties:              Prod-ID
----------------------------------------------------------
OpticPro U12       LM9831  600x1200dpi 42bit 512Kb 0x0010
OpticPro UT12      LM9831  600x1200dpi 42bit 512Kb 0x0013
OpticPro UT12      LM9832  600x1200dpi 42bit 512Kb 0x0017
OpticPro UT16      LM9832  600x1200dpi 42bit 512Kb 0x0017
OpticPro U24       LM9831 1200x2400dpi 42bit   2Mb 0x0011
OpticPro U24       LM9832 1200x2400dpi 42bit   2Mb 0x0015
OpticPro UT24      LM9832 1200x2400dpi 42bit   2Mb 0x0017

تولیدکننده KYE/Genius - شناسه: 0x0458

----------------------------------------------------------
USB Model:         ASIC:  Properties:              Prod-ID
----------------------------------------------------------
Colorpage HR6 V2   LM9832  600x1200dpi 42bit 512Kb 0x2007
Colorpage HR6 V2   LM9832  600x1200dpi 42bit 512Kb 0x2008
Colorpage HR6A     LM9832  600x1200dpi 42bit 512Kb 0x2009
Colorpage HR7      LM9832  600x1200dpi 42bit 512Kb 0x2013
Colorpage HR7LE    LM9832  600x1200dpi 42bit 512Kb 0x2015
Colorpage HR6X     LM9832  600x1200dpi 42bit 512Kb 0x2016

تولیدکننده Hewlett-Packard - شناسه: 0x03F0

----------------------------------------------------------
USB Model:         ASIC:  Properties:              Prod-ID
----------------------------------------------------------
ScanJet 2100C      LM9831  600x1200dpi 42bit 512Kb 0x0505
ScanJet 2200C      LM9832  600x1200dpi 42bit 512Kb 0x0605

تولیدکننده Mustek - شناسه: 0x0400

----------------------------------------------------------
USB Model:         ASIC:  Properties:              Prod-ID
----------------------------------------------------------
BearPaw 1200       LM9831  600x1200dpi 42bit 512Kb 0x1000
BearPaw 1200       LM9832  600x1200dpi 42bit 512Kb 0x1001*
BearPaw 2400       LM9832 1200x2400dpi 42bit   2Mb 0x1001

* همچنین توضیحات مربوط به سوئیچ بازنویسی مدل (model override switch) را در زیر ببینید!

تولیدکننده UMAX - شناسه: 0x1606

----------------------------------------------------------
USB Model:         ASIC:  Properties:              Prod-ID
----------------------------------------------------------
UMAX 3400          LM9832  600x1200dpi 42bit 512Kb 0x0050
UMAX 3400/3450     LM9832  600x1200dpi 42bit 512Kb 0x0060
UMAX 5400          LM9832 1200x2400dpi 42bit 512Kb 0x0160

تولیدکننده COMPAQ - شناسه: 0x049F

----------------------------------------------------------
USB Model:         ASIC:  Properties:              Prod-ID
----------------------------------------------------------
S4-100             LM9832  600x1200dpi 42bit 512Kb 0x001A

تولیدکننده Epson - شناسه: 0x04B8

----------------------------------------------------------
USB Model:         ASIC:  Properties:              Prod-ID
----------------------------------------------------------
Perfection 1250    LM9832 1200x2400dpi 42bit 512Kb 0x010F
Perfection 1260    LM9832 1200x2400dpi 42bit 512Kb 0x011D

تولیدکننده CANON - شناسه: 0x04A9

----------------------------------------------------------
USB Model:         ASIC:  Properties:              Prod-ID
----------------------------------------------------------
CanoScan N650/656U LM9832  600x1200dpi 42bit 512Kb 0x2206
CanoScan N1220U    LM9832 1200x2400dpi 42bit 512Kb 0x2207
CanoScan D660U     LM9832  600x1200dpi 42bit 512Kb 0x2208
CanoScan N670/676U LM9833  600x1200dpi 48bit 512Kb 0x220D
CanoScan N1240U    LM9833 1200x2400dpi 48bit 512Kb 0x220E
CanoScan LIDE20    LM9833  600x1200dpi 48bit 512Kb 0x220D
CanoScan LIDE25    LM9833 1200x2400dpi 48bit 512Kb 0x2220
CanoScan LIDE30    LM9833 1200x2400dpi 48bit 512Kb 0x220E

تولیدکننده Syscan - شناسه: 0x0A82

----------------------------------------------------------
USB Model:         ASIC:  Properties:              Prod-ID
----------------------------------------------------------
Travelscan 662     LM9833  600x1200dpi 48bit 512Kb 0x6620
Travelscan 464     LM9833  600x1200dpi 48bit 512Kb 0x4600

تولیدکننده Portable Peripheral Co., Ltd. - شناسه: 0x0A53

----------------------------------------------------------
USB Model:         ASIC:  Properties:              Prod-ID
----------------------------------------------------------
Q-Scan USB001      LM9832   300x600dpi 42bit 512Kb 0x1000
Q-Scan USB201      LM9832   300x600dpi 42bit 512Kb 0x2000

تولیدکننده Visioneer - شناسه: 0x04A7

----------------------------------------------------------
USB Model:         ASIC:  Properties:              Prod-ID
----------------------------------------------------------
Strobe XP100       LM9833  600x1200dpi 48bit 512Kb 0x0427

سایر اسکنرهای پلاستک (OTHER PLUSTEK SCANNERS)

برای پشتیبانی از دستگاه‌های درگاه موازی، بک‌اند sane-plustek_pp(5) را ببینید.
اسکنر SCSI مدل OpticPro 19200S همان اسکنر Artec AM12S با تغییر نام تجاری است و توسط بک‌اند sane-artec(5) پشتیبانی می‌شود.
تنها دستگاه‌های Plustek مبتنی بر LM983[1/2/3] شرکت National Semiconductor توسط این بک‌اند پشتیبانی می‌شوند. نسخه‌های قدیمی‌تر U12، UT12، U1212 و U1248 (چیپ‌ست GrandTech) پشتیبانی نمی‌شوند.

Model             Chipset    backend
------------------------------------
U1248             GrandTech  gt68xx
UT16B             GrandTech  gt68xx
OpticSlim 1200    GrandTech  gt68xx
OpticSlim 2400    GrandTech  gt68xx
U12                P98003     u12
UT12               P98003     u12
1212U              P98003     u12

برای فهرستی کامل‌تر و به‌روزتر به نشانی زیر مراجعه کنید: http://www.sane-project.org/sane-supported-devices.html.

پیکربندی (CONFIGURATION)

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

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

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

گزینه‌ها:

option warmup t

t مدت‌زمان گرم شدن را بر حسب ثانیه مشخص می‌کند؛ اگر روی -1 تنظیم شود، از تابع گرم شدن خودکار استفاده خواهد شد.

option lampOff t

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

option lOffonEnd b

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

option mov m

m سوئیچ بازنویسی مدل (model override) است. این گزینه فقط با دستگاه‌های Mustek BearPaw کار می‌کند.

m/PID |    0x1000    |    0x1001
------+--------------+--------------
  0   | BearPaw 1200 | BearPaw 2400
  1   |  no function | BearPaw 1200

option invertNegatives b

b 0 --> عدم معکوس‌سازی تصویر هنگام اسکن نگاتیو،
1 --> معکوس‌سازی تصویر.

option cacheCalData b

b 0 --> ذخیره نکردن نتایج کالیبراسیون،
1 --> ذخیره نتایج کالیبراسیون در دایرکتوری ~/.sane/.

option altCalibration b

b 0 --> استفاده از روال‌های استاندارد کالیبراسیون،
1 --> استفاده از کالیبراسیون جایگزین (تنها برای دستگاه‌های غیر Plustek؛ استاندارد برای دستگاه‌های CIS).

option skipFine b

b 0 --> انجام کالیبراسیون دقیق (fine calibration)،
1 --> صرف‌نظر از کالیبراسیون دقیق (تنها برای دستگاه‌های غیر Plustek).

option skipFineWhite b

b 0 --> انجام کالیبراسیون دقیق رنگ سفید،
1 --> صرف‌نظر از کالیبراسیون دقیق رنگ سفید (تنها برای دستگاه‌های غیر Plustek).

option skipDarkStrip b

b 0 --> انجام کالیبراسیون تیره با لامپ روشن با استفاده از نوار کالیبراسیون تیره اسکنر. اگر اسکنر فاقد چنین نواری باشد، روش جایگزین خاموش کردن لامپ در طول این مرحله است.
1 --> همیشه خاموش کردن لامپ برای کالیبراسیون تیره، حتی اگر نوار مشکی موجود باشد.

option skipCalibration b

b 0 --> انجام کالیبراسیون،
1 --> صرف‌نظر از کالیبراسیون (تنها برای دستگاه‌های غیر Plustek).

option enableTPA b

b 0 --> رفتار پیش‌فرض بر اساس جدول‌های داخلی،
1 --> نادیده گرفتن جدول‌های داخلی و فعال کردن حالت TPA (تنها برای EPSON/UMAX).

option posOffX x
option posOffY y
option tpaOffX x
option tpaOffY y
option negOffX x
option negOffY y

x y با استفاده از این تنظیمات، کاربر می‌تواند موقعیت‌های داده‌شده تصویر را تنظیم کند. لطفاً توجه داشته باشید که هیچ بررسی داخلی برای محدوده این ویژگی وجود ندارد.

option posShadingY p
option tpaShadingY p
option negShadingY p

p موقعیت سایه‌زنی (shading) داخلی را بازنویسی می‌کند. مقادیر بر حسب گام (step) هستند. لطفاً توجه داشته باشید که هیچ بررسی داخلی برای محدوده این ویژگی وجود ندارد.

option redGamma r
option greenGamma g
option blueGamma b
option grayGamma gr

r g b gr

با استفاده از این مقادیر، می‌توان جدول گامای خطی داخلی (r,g,b,gr = 1.0) را تنظیم نمود.

option red_gain r
option red_offset ro
option green_gain g
option green_offset go
option blue_gain b
option blue_offset bo

r g b ro go bo این مقادیر را می‌توان برای تعیین مقادیر بهره (gain) و آفست AFE برای هر کانال استفاده کرد. محدوده مقادیر بین 0 تا 63 است. مقدار -1 به معنای کالیبراسیون خودکار است.

برای نمونه‌ها، فایل plustek.conf را ببینید.

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

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

فایل‌ها (FILES)

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

محیط (ENVIRONMENT)

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

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

sane(7), sane-usb(5), sane-u12(5), sane-gt68xx(5), sane-mustek_pp(5), sane-find-scanner(1), scanimage(1)
/usr/share/doc/sane/plustek/Plustek-USB.changes

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

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

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

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

export SANE_DEBUG_PLUSTEK=20 ; scanimage

این مقدار سطح جزئیات خروجی را کنترل می‌کند. لطفاً توجه داشته باشید که مقادیر بزرگ‌تر از 24 بک‌اند را وادار می‌کنند تا فایل‌های داده خام (raw) تولید کند که ممکن است حجم بسیار زیادی داشته باشند. پسوند این فایل‌ها «.raw» است. برای گزارش مشکلات، تنظیم سطح جزئیات روی 13 کافی خواهد بود.

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

* این درایور از مقیاس‌بندی‌های نامتعارف تا ۱۶ برابر وضوح فیزیکی پشتیبانی نمی‌کند. تنها مقیاس‌بندی انجام‌شده بین وضوح فیزیکی حسگر CCD/CIS و موتور پله‌ای است؛ به عنوان مثال، اگر شما یک اسکنر ۶۰۰x۱۲۰۰ dpi دارید و با وضوح ۸۰۰dpi اسکن می‌کنید، مقیاس‌بندی الزامی است؛ زیرا حسگر تنها ۶۰۰dpi ارائه می‌دهد اما موتور قادر به انجام گام‌های ۱۲۰۰dpi است.

* سیاست نام‌گذاری مدل‌های Plustek تا حدی نامنسجم است. آن‌ها دستگاه‌هایی با تفاوت‌های فنی را تحت یک نام تجاری عرضه می‌کنند. بنابراین ممکن است برخی دستگاه‌ها مانند UT12 یا U12 کار نکنند - لطفاً فهرست مدل‌های بالا را بررسی کرده و شناسه محصول (product-id) را با شناسه دستگاه خود مقایسه نمایید.

* کیفیت اسکن نگاتیو/اسلاید ضعیف است.