نام (NAME)

sane-mustek_pp - بک‌اند SANE برای اسکنرهای تخت درگاه موازی Mustek

توضیحات (DESCRIPTION)

کتابخانهٔ sane-mustek_pp یک بک‌اند SANE (Scanner Access Now Easy) را پیاده‌سازی می‌کند که دسترسی به اسکنرهای تخت درگاه موازی Mustek و نسخه‌های OEM را فراهم می‌سازد.

دو دسته از اسکنرهای درگاه موازی Mustek وجود دارند: اسکنرهای معمولی CCD (دستگاه کاتد سرد) و اسکنرهای CIS (حسگر تماسی تصویر).

نسخهٔ فعلی این بک‌اند هم از اسکنرهای نوع CCD و هم از اسکنرهای نوع CIS پشتیبانی می‌کند.

اسکنرهای زیر ممکن است با این بک‌اند کار کنند:

Model:                  ASIC ID:        CCD Type:       works:
--------------------------------------------------------------
SE 6000 P               1013            00              yes
SM 4800 P               1013/1015       04/01           yes
SE 1200 ED Plus         1015            01              no
SM 1200 ED Plus         1015            01              no
SE 12000 P              1505            05              no
600 III EP Plus         1013/1015       00/01           yes
SE 600 SEP              1013            ??              yes
600 II EP               ????            ??              no
MD9848                  1015            00              yes
Gallery 4800            ????            ??              yes
Viviscan Compact II     1013            00              yes

Model:                  ASIC ID:        works:
-----------------------------------------------
Mustek 600 CP & 96 CP   1015            yes (*)
Mustek 1200 CP          1015            yes
Mustek 1200 CP+         1015            yes

OEM versions            Original        works
--------------------------------------------------
Medion/LifeTec/Tevion
   MD/LT 9350/9351      1200 CP         yes
   MD/LT 9850/9851      1200 CP         maybe (**)
   MD/LT 9858           1200 CP         probably
   MD/LT 9890/9891      1200 CP         yes
Targa
   Funline TS12EP       1200 CP         yes
   Funline TS6EP        600 CP          yes
Trust
   Easy Connect 9600+   600 CP          yes
Cybercom
   9352                 1200 CP         yes (***)

تعریف دستگاه (DEVICE DEFINITION)

این بک‌اند اجازه می‌دهد چندین دستگاه از طریق فایل mustek_pp.conf تعریف و پیکربندی شوند (حتی به‌طور هم‌زمان، به شرطی که به درگاه‌های موازی مختلف متصل باشند). لطفاً اطمینان حاصل کنید که این فایل را قبل از استفاده از بک‌اند ویرایش کرده‌اید.

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

که در آن:

<name> یک نام دلخواه برای دستگاه است که اختیاری در گیومه دوتایی قرار می‌گیرد، به عنوان مثال "LifeTec 9350".

<port name> نام درگاه موازی است که دستگاه به آن متصل شده است. در صورتی که از libieee1284 برای ارتباط با درگاه استفاده شود (راه‌اندازی پیش‌فرض)، نام‌های معتبر درگاه عبارتند از parport0، parport1، و parport2.

در صورتی که بک‌اند برای ورودی/خروجی خام پیکربندی شده باشد (راه‌اندازی قدیمی)، به‌جای نام‌های درگاه باید از نشانی‌های درگاه استفاده شود: 0x378، 0x278، یا 0x3BC. نگاشت درگاه‌های موازی (lp0، lp1 و lp2) به این نشانی‌ها ممکن است در نسخه‌های مختلف هسته لینوکس متفاوت باشد. به عنوان مثال، اگر از هسته 2.2.x یا جدیدتر استفاده می‌کنید و تنها یک درگاه موازی دارید، صرف‌نظر از نشانی پایه، این درگاه lp0 نامیده می‌شود. با این حال، این بک‌اند به نشانی پایهٔ درگاه شما نیاز دارد. اگر مطمئن نیستید اسکنر شما به کدام درگاه متصل است، به /etc/conf.modules، /etc/modules.conf یا /proc/ioports نگاهی بیندازید.

اگر در مورد درگاه مورد استفاده نامطمئن هستید، می‌توانید از مقدار جادویی * برای پویش و یافتن اسکنر خود استفاده کنید.

<driver> درایوری است که برای این دستگاه استفاده می‌شود. درایورهای موجود در حال حاضر عبارتند از:

cis600 : برای 600 CP، 96 CP و نسخه‌های OEM
cis1200 : برای 1200 CP و نسخه‌های OEM
cis1200+ : برای 1200 CP+ و نسخه‌های OEM
ccd300 : برای 600 IIIE P و نسخه OEM

انتخاب درایور اشتباه می‌تواند به اسکنر شما آسیب برساند!
به‌ویژه، استفاده از تنظیمات 1200CP روی یک 600CP می‌تواند مخرب باشد. اگر اسکنر شروع به ایجاد صدای بلند کرد، فوراً آن را خاموش کنید!!!

استفاده از درایور cis600 روی 1200CP یا 1200CP+ احتمالاً خطرناک نیست. درایور cis1200+ برای 1200CP نیز کار می‌کند، و استفاده از درایور cis1200 روی 1200CP+ معمولاً منجر به اسکن‌هایی می‌شود که تنها نیمی از عرض ناحیه اسکن را پوشش می‌دهند (این هم خطرناک نیست).

اگر در مورد مدل دقیق نسخهٔ OEM خود شک دارید، تفکیک‌پذیری نوری را در دفترچه راهنما یا روی جعبه بررسی کنید: مدل 600CP دارای بیشینه تفکیک‌پذیری نوری 300x600 DPI است، در حالی که 1200CP و 1200CP+ دارای بیشینه تفکیک‌پذیری نوری 600x1200 DPI هستند.

مثال‌ها:

اگر شک دارید که از کدام درگاه باید استفاده کنید، یا اینکه آیا اسکنر شما اصلاً شناسایی شده است یا خیر، می‌توانید از sane-find-scanner -p برای بررسی تمام درگاه‌های پیکربندی‌شده استفاده کنید.

پیکربندی (CONFIGURATION)

محتوای فایل mustek_pp.conf شامل فهرستی از تعاریف دستگاه و گزینه‌های دستگاه مربوط به اسکنرهای Mustek است. خطوط خالی و خطوطی که با علامت مربع (#) شروع می‌شوند نادیده گرفته می‌شوند. گزینه‌ها دارای قالب زیر هستند:

بسته به ماهیت گزینه، ممکن است مقدار وجود داشته باشد یا نداشته باشد. گزینه‌ها همیشه برای تعریف اسکنری اعمال می‌شوند که پیش از آن‌ها آمده است. هیچ گزینهٔ سراسری وجود ندارد. گزینه‌ها همچنین مختص درایور هستند: همه درایورها از همه گزینه‌های ممکن پشتیبانی نمی‌کنند.

#
# LifeTec/Medion 9350 on port 0x378
#
scanner "LifeTec 9350" 0x378 cis1200
# Some calibration options (examples!).
option bw 127
option top_skip -0.8
#
# A Mustek 600CP on port 0x3BC
#
scanner "Mustek 600CP" 0x3BC cis600
# Some calibration options (examples!).
option bw 120
option top_skip 1.2
#
# A Mustek 1200CP+ on port 0x278
#
scanner "Mustek 1200CP plus" 0x278 cis1200+
# Some calibration options (examples!).
option bw 130
option top_skip 0.2
#
# A Mustek 600 III EPP on port parport0
#
scanner "Mustek 600 III EPP" parport0 ccd300
# Some calibration options (examples!).
option bw 130
option top 56

گزینه‌های سراسری (GLOBAL OPTIONS)

شما می‌توانید رفتار کلی بک‌اند sane-mustek_pp را با گزینه‌های سراسری که پیش از هر تعریف اسکنری در فایل mustek_pp.conf قرار می‌گیرند، کنترل کنید.

در حال حاضر تنها یک گزینهٔ سراسری وجود دارد:

فایل‌ها (FILES)

/etc/sane.d/mustek_pp.conf

فایل پیکربندی بک‌اند (همچنین توضیحات SANE_CONFIG_DIR را در زیر ببینید).

/usr/lib/sane/libsane-mustek_pp.a

کتابخانهٔ ایستا که این بک‌اند را پیاده‌سازی می‌کند.

/usr/lib/sane/libsane-mustek_pp.so

کتابخانهٔ پویا که این بک‌اند را پیاده‌سازی می‌کند (موجود در سیستم‌هایی که از بارگذاری پویا پشتیبانی می‌کنند).

متغیرهای محیطی (ENVIRONMENT)

SANE_CONFIG_DIR

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

SANE_DEBUG_MUSTEK_PP

اگر کتابخانه با فعال بودن پشتیبانی از اشکال‌زدایی کامپایل شده باشد، این متغیر محیطی سطح اشکال‌زدایی را برای این بک‌اند کنترل می‌کند. برای مثال، مقدار 128 درخواست چاپ تمامی خروجی‌های اشکال‌زدایی را می‌دهد. سطوح کوچک‌تر پرگویی خروجی را کاهش می‌دهند.

level   debug output
--------------------------------------
 0      nothing
 1      errors
 2      warnings & minor errors
 3      additional information
 4      debug information
 5      code flow (not supported yet)
 6      special debug information

SANE_DEBUG_SANEI_PA4S2

این متغیر سطح اشکال‌زدایی را برای رابط SANE مربوط به چیپ‌ست Mustek A4S2 تنظیم می‌کند. توجه داشته باشید که فعال کردن این متغیر، ترمینال شما را با چند میلیون خط خروجی اشکال‌زدایی پر خواهد کرد.

level   debug output
----------------------------
 0      nothing
 1      errors
 2      warnings
 3      things nice to know
 4      code flow
 5      detailed code flow
 6      everything

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

sane(7), sane-mustek(5), sane-net(5), saned(8), sane-find-scanner(1), scanimage(1)

برای آخرین اطلاعات و رفع اشکالات ببینید

http://www.penguin-breeder.org/sane/mustek_pp

برای اطلاعات بیشتر درباره درایور CIS، ببینید

http://home.scarlet.be/eddy_de_greef

نویسندگان (AUTHORS)

Jochen Eisinger
<jochen at penguin-breeder dot org>
Eddy De Greef
<eddy_de_greef at scarlet dot be>

اشکالات (BUGS)

بسیار زیاد... لطفاً گزارش‌های باگ را به sane-devel@alioth-lists.debian.net ارسال کنید (توجه داشته باشید که ابتدا باید در فهرست عضو شوید تا بتوانید ایمیل ارسال کنید... ببینید http://www.sane-project.org/mailing-lists.html).

گزارش اشکالات (BUG REPORTS)

اگر چیزی کار نمی‌کند، لطفاً با ما تماس بگیرید (Jochen برای اسکنرهای CCD و Eddy برای اسکنرهای CIS). اما ما برای اینکه بتوانیم به شما کمک کنیم، به اطلاعاتی درباره اسکنر شما نیاز داریم...

نسخه SANE

دستور scanimage -V را اجرا کنید تا این مورد مشخص شود.

نسخه بک‌اند و سخت‌افزار اسکنر شما

دستور SANE_DEBUG_MUSTEK_PP=128 scanimage -L را به عنوان ریشه (root) اجرا کنید. اگر خروجی‌ای از بک‌اند sane-mustek_pp دریافت نکردید، مطمئن شوید خط "mustek_pp" در فایل /etc/sane.d/dll.conf شما گنجانده شده باشد. اگر اسکنر شما شناسایی نشد، مطمئن شوید که نشانی درگاه درستی را در فایل mustek_pp.conf خود تعریف کرده‌اید.

نام اسکنر/سازنده شما نیز اطلاعات ارزشمندی است. لطفاً تفکیک‌پذیری نوری و نوع لامپ اسکنر خود را نیز درج کنید، هر دوی این موارد در دفترچه راهنمای اسکنر شما یافت می‌شوند.

هرگونه نظرات دیگر

اگر نظراتی درباره مستندات دارید (چه چیزی می‌تواند بهتر انجام شود)، یا فکر می‌کنید چیزی هست که باید بدانیم، لطفاً آن را درج کنید.