sane-microtek2(5) SANE Scanner Access Now Easy sane-microtek2(5)

sane-microtek2 - پشتیبان SANE برای اسکنرهای Microtek با مجموعه دستورات SCSI-2

کتابخانه sane-microtek2 یک پشتیبان SANE (Scanner Access Now Easy) را پیاده‌سازی می‌کند که دسترسی به اسکنرهای Microtek با مجموعه دستورات SCSI-2 را فراهم می‌سازد. این پشتیبان می‌تواند در وضعیت آلفا تا بتا در نظر گرفته شود. گزارش شده برخی مدل‌های اسکنر به‌خوبی کار می‌کنند و برخی دیگر خیر.

پشتیبان متفاوتی برای اسکنرهای Microtek با مجموعه دستورات SCSI-1 وجود دارد. برای جزئیات به sane-microtek(5) مراجعه کنید.

همچنین پیشرفت‌هایی جزئی برای ScanMaker 3600 حاصل شده است. ببینید: http://sourceforge.net/projects/sm3600

در حال حاضر، عملکرد اسکنرهای زیر با این پشتیبان با قطعیت تأیید شده است:

Vendor     Product id        Remark
--------------------------------------------------------------------
Microtek   E3+               Parport and SCSI
Microtek   X6                SCSI
Microtek   X6EL              SCSI
Microtek   X6USB             USB
Microtek   ScanMaker V300    Parport and SCSI
Microtek   ScanMaker V310    Parport and SCSI
Microtek   ScanMaker V600    Parport and SCSI
Microtek   ScanMaker 330     SCSI
Microtek   ScanMaker 630     SCSI
Microtek   ScanMaker 636     SCSI
Microtek   ScanMaker 9600XL  SCSI; only flatbed mode?
Microtek   Phantom 330CX     Parport
Microtek   SlimScan C3       Parport
Microtek   SlimScan C6       USB
Microtek   Phantom 636       SCSI
Microtek   Phantom 636CX     Parport
Microtek   V6USL             SCSI and USB
Microtek   V6UPL             USB; not stable
Microtek   X12USL            SCSI; only 8bit color, work in progress
Vobis      HighScan          SCSI (E3+ based models)
Scanport   SQ300             Parport?
Scanport   SQ4836            SCSI
Scanpaq    SQ2030            Parport

اطلاعات بیشتر را می‌توانید در http://www.sane-project.org بیابید.

اگر صاحب اسکنر Microtek دیگری غیر از موارد فهرست‌شده در بالا هستید، ممکن است با SANE کار کند یا نکند! از آنجا که اسکنرهای یکسان در کشورهای مختلف تحت نام‌های گوناگونی فروخته می‌شوند، مدل شما ممکن است معادل یکی از موارد بالا باشد.

اسکنرهای درگاه موازی (parport) با ماژول‌های هسته ppscsi + onscsi کار می‌کنند. ببینید: http://cyberelk.net/tim/parport/ppscsi.html و http://penguin-breeder.org/kernel/download

اسکنرهای USB با ماژول هسته microtek کار می‌کنند. در صورتی که کدهای سازنده و مدل هنوز در microtek.c فهرست نشده باشند، ممکن است نیاز باشد آن‌ها را اضافه کنید.

هر دو گروه اسکنرهای درگاه موازی و USB به پشتیبانی عمومی SCSI نیاز دارند، بنابراین بررسی کنید که ماژول‌های scsi_mod و sg بارگذاری شده باشند!

اگر برای نخستین بار اسکنر خود را آزمایش می‌کنید، مراقب آن باشید. اگر دستوراتی دریافت کند که برایش قابل فهم نباشد، هد اسکن ممکن است از محدوده اسکن فراتر رود. در این حالت اسکنر صداهای نامتعارفی تولید می‌کند. در این وضعیت بلافاصله اسکنر را خاموش کنید یا کابل برق آن را بکشید تا از آسیب جلوگیری شود!

اگر اسکنر شما مدلی متفاوت از موارد ذکرشده در بالاست و کار می‌کند، لطفاً آن را به نویسنده اطلاع دهید. مناسب خواهد بود اگر یک فایل گزارش (logfile) نیز به این اطلاعات ضمیمه کنید (نحوه ایجاد فایل گزارش: پایین‌تر را ببینید).

اگر اسکنر شما به‌درستی کار نمی‌کند نیز باید یک فایل گزارش ایجاد کرده و برای نویسنده ارسال نمایید. او از این اطلاعات برای بهبود پشتیبان و در صورت امکان راه‌اندازی اسکنر شما استفاده خواهد کرد.

چگونه فایل گزارش ایجاد کنیم؟

- خط

"option dump 2" را در فایل microtek2.conf خود قرار دهید یا "option dump" موجود را به "2" تغییر دهید
- در ترمینال (bash) عبارت

"export SANE_DEBUG_MICROTEK2=30" را وارد کنید و سپس
"scanimage -l0 -t0 -x100 -y20 2>scan.log >sout.pnm"
دو فایل دریافت می‌کنید: scan.log حاوی فایل گزارش است و sout.pnm تصویر اسکن‌شده (در صورت اسکن شدن چیزی). آن‌ها را پیش از ارسال فشرده (zip) کنید.

این پشتیبان گزینه‌های مربوط به رابط کاربری (frontend) را بسته به حالت اسکن و سایر گزینه‌ها به‌طور پویا فعال می‌کند، مشروط بر این‌که توسط اسکنر پشتیبانی شوند. گزینه‌های پشتیبانی‌نشده غیرفعال می‌شوند.

گزینه‌های زیر توسط درایور sane-microtek2 پشتیبانی می‌شوند:

اسکن‌های رنگی، مقیاس خاکستری (grayscale)، ترام (halftone) و خطی (lineart).

کنترل روشنایی نقاط روشن (highlight)، تون میانی (midtone)، سایه (shadow)، کنتراست، روشنایی (brightness)، زمان نوردهی، تصحیح گاما، آستانه (threshold) (بسته به حالت اسکن و قابلیت‌های اسکنر)

مبدل رسانه‌های شفاف (اسلاید و نگاتیو)، تغذیه‌کننده خودکار اسناد (ADF)

گزینه‌های بیشتر را می‌توان در فایل microtek2.conf فعال یا غیرفعال کرد. بخش پیکربندی همین صفحه راهنما را ببینید.

این پشتیبان نام‌های دستگاه را به این شکل انتظار دارد:

special

که در آن special نام مسیر یونیکس برای دستگاه ویژه‌ای است که با اسکنر مطابقت دارد. نام دستگاه ویژه باید یک دستگاه عمومی SCSI یا پیوند نمادین (symlink) به چنین دستگاهی باشد. در لینوکس، چنین نام دستگاهی می‌تواند برای نمونه /dev/sga یا /dev/sge باشد.

فایل پیکربندی این پشتیبان در /etc/sane.d/microtek2.conf قرار دارد.

محتوای آن فهرستی از نام‌های دستگاه است که با اسکنرهای Microtek دارای رابط SCSI-2 مطابقت دارند. خطوط خالی و خطوطی که با علامت هش (#) آغاز می‌شوند نادیده گرفته می‌شوند.

فایل پیکربندی می‌تواند حاوی گزینه‌ها نیز باشد. گزینه‌های عمومی که برای تمام دستگاه‌ها معتبرند بالای نام دستگاه‌ها قرار می‌گیرند. گزینه‌های ویژه دستگاه در زیر نام دستگاه درج می‌شوند. توجه داشته باشید که به‌جز option dump <n> و option strip-height <n>، مدخل موجود در فایل microtek2.conf تنها گزینه متناظر را برای نمایش در فرانت‌اند فعال می‌کند. در آنجا، در فرانت‌اند، می‌توانید گزینه‌ها را روشن و خاموش کنید. در حال حاضر گزینه‌های زیر پشتیبانی می‌شوند:

option dump <n>
option strip-height <n>
option no-backtrack-option <on/off>
option lightlid-35 <on/off>
option toggle-lamp <on/off>
option lineart-autoadjust <on/off>
option backend-calibration <on/off>
option colorbalance-adjust <on/off>

گزینه option dump <n> چاپ اطلاعات تکمیلی درباره دستورات SCSI ارسال‌شده به اسکنر در stderr را فعال می‌کند. این گزینه در درجه اول برای اهداف عیب‌یابی مفید است. این گزینه باید یک گزینه سراسری باشد و بهتر است در بالای فایل microtek2.conf قرار گیرد.

اگر n=1 باشد، محتوای بلوک‌های فرمان و نتایج دستورات INQUIRY و READ SCANNER ATTRIBUTES در stderr چاپ می‌شوند.

اگر n=2 باشد، محتوای بلوک‌های فرمان برای تمام دستورات دیگر SCSI نیز در stderr چاپ می‌شود. اگر n=3 باشد، محتوای جدول گاما نیز چاپ می‌شود. اگر n=4 باشد، تمام داده‌های اسکن نیز علاوه بر این در stderr چاپ می‌شوند.

مقدار پیش‌فرض n=1 است.

گزینه option strip-height <n> ، که در آن <n> یک عدد اعشاری است، مقدار داده‌ای را که با یک دستور خواندن از اسکنر خوانده می‌شود محدود می‌کند. واحد آن اینچ است و اگر این گزینه در فایل پیکربندی تنظیم نشده باشد، مقدار <n> به‌طور پیش‌فرض 1.0 است. اگر داده‌های کمتر از <n> اینچ در بافر SCSI جای گیرند، مقدار کوچک‌تر استفاده می‌شود و این گزینه تأثیری نخواهد داشت.

اگر سیستم شما بافر SCSI بزرگی دارد و می‌خواهید از تمام ظرفیت بافر استفاده کنید، مقدار <n> را افزایش دهید. برای نمونه، اگر <n> برابر با 14.0 تنظیم شود، هیچ محدودیتی برای اسکنرهایی با ناحیه اسکن اندازه letter، legal یا A4 اعمال نخواهد شد.

گزینه‌های زیر گزینه‌های تکمیلی فرانت‌اند را فعال یا غیرفعال می‌کنند. اگر گزینه‌ای روی <on> تنظیم شود، گزینه مربوطه در فرانت‌اند ظاهر خواهد شد.

گزینه option no-backtrack-option <on/off> از حرکت رو به عقب هد اسکنر بین دستورات خواندن جلوگیری می‌کند. این کار سرعت اسکن را افزایش می‌دهد. آن را آزمایش کنید.

گزینه option lightlid-35 <on/off> اگر از مبدل رسانه شفاف LightLid-35 استفاده می‌کنید، گزینه پیشرفته‌ای دریافت می‌کنید که لامپ صفحه تخت را هنگام اسکن خاموش می‌کند.

گزینه option toggle-lamp <on/off> دکمه‌ای در فرانت‌اند در اختیارتان می‌گذارد که با آن می‌توانید لامپ صفحه تخت را روشن و خاموش کنید.

گزینه option lineart-autoadjust <on/off> می‌توانید به پشتیبان بگویید تلاش کند مقدار مناسبی برای آستانه (threshold) حالت خطی تعیین کند.

گزینه option backend-calibration <on/off> برخی اسکنرها (مانند Phantom 330CX و 636CX) نیاز دارند داده‌های آن‌ها توسط پشتیبان کالیبره شود. اگر خطوط عمودی در تصاویر خود مشاهده کردید این گزینه را امتحان کنید.

گزینه option colorbalance-adjust <on/off> برخی اسکنرها (مانند Phantom 330CX و 636CX) نیاز به تصحیح توازن رنگ دارند. اگر این گزینه فعال باشد، گزینه‌های پیشرفته‌ای دریافت می‌کنید که در آن می‌توانید رنگ‌ها را متوازن کنید. و دکمه‌ای خواهید داشت برای استفاده از مقادیری که سفت‌افزار (firmware) اسکنر ارائه می‌دهد.

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

option dump 1
option strip-height 1.0
/dev/scanner
option no-backtrack-option on
# this is a comment
/dev/sge
option lightlid-35 on

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

option dump 1
option strip-height 14.0
option no-backtrack-option on
option backend-calibration on
option lightlid-35 on
option toggle-lamp on
option lineart-autoadjust on
option colorbalance-adjust off
scsi * * Scanner

در این حالت تمام اسکنرهای SCSI باید به‌دلیل خط

scsi * * Scanner

به‌طور خودکار شناسایی شوند.

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

اگر کتابخانه با فعال بودن پشتیبانی از اشکال‌زدایی کامپایل شده باشد، این متغیر محیطی سطح اشکال‌زدایی را برای این پشتیبان کنترل می‌کند. برای نمونه، مقدار 255 درخواست می‌کند تمام خروجی اشکال‌زدایی چاپ شود. سطوح کوچک‌تر پرگویی را کاهش می‌دهند. برای مشاهده پیام‌های خطا در stderr، مقدار SANE_DEBUG_MICROTEK2 را روی 1 تنظیم کنید (یادداشت: کل سطوح اشکال‌زدایی بهتر است بازنگری شوند).
برای مثال کافیست بنویسید:
export SANE_DEBUG_MICROTEK2=128

sane-scsi(5), sane(7)

Bernd Schroeder (دیگر فعال نیست)
Karsten Festag <karsten.festag@gmx.de>.

13 Jul 2008