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

sane-umax_pp - بک‌اند SANE برای اسکنرهای تخت درگاه موازی Umax Astra

کتابخانه sane-umax_pp یک بک‌اند SANE (دسترسی آسان به اسکنر) را پیاده‌سازی می‌کند که دسترسی به اسکنرهای تخت درگاه موازی Umax را فراهم می‌سازد. اسکنرهای زیر با این بک‌اند کار می‌کنند:

مدل:
--------------------
Astra 610P
Astra 1220P
HP3200C
Astra 1600P
Astra 2000P
Genius ColorPage-Life Pro

این بک‌اند از تفکیک‌پذیری‌های اسکن 75x75، 150x150، 300x300، 600x600 و 600x1200 نقطه بر اینچ برای 1220P/1600P/2000P و 75x75، 150x150، 300x300 و 300x600 برای 610P پشتیبانی می‌کند. در سطوح رنگی و خاکستری، یک حالت خطی نرم‌افزاری وجود دارد.

مدل‌های نسل جدید از نسخه جدیدتری از تراشه ASIC مدل 610P تعبیه‌شده در یک چیپ EPAT استفاده می‌کنند. تنها بخش‌هایی مانند CCD و ADC بین مدل‌ها تفاوت دارند. آن‌ها حتی همگی از طریق IEEE1284 خود را به عنوان UMAX Astra 1220P گزارش می‌دهند. روش نرم‌افزاری برای شناسایی درست آن‌ها وجود ندارد. در ویندوز، مدل بدون در نظر گرفتن سخت‌افزار، توسط درایور نصب‌شده تعیین می‌شود.

فقط حالت‌های EPP/ECP (EPP/ECP MODES ONLY)
نسخه فعلی این بک‌اند فقط از حالت EPP یا ECP برای ارتباط با اسکنر استفاده می‌کند. حالت PS/2 پیاده‌سازی نشده است. مدل 610P فقط از SPP استفاده می‌کند. توصیه می‌شود در نسخه فعلی این بک‌اند، درگاه موازی خود را در BIOS روی EPP تنظیم کنید. می‌توانید آن را روی ECP یا ECP+EPP بگذارید، اما در این صورت اگر مجبور به استفاده از ECP باشید، ممکن است نتوانید از ppdev استفاده کنید و فقط دسترسی مستقیم سخت‌افزاری داشته باشید. ECPEPP تنها در صورتی کار خواهد کرد که از یک هسته 2.4 یا 2.6 با پشتیبانی از دستگاه کاراکتری ppdev استفاده کنید.

این بک‌اند از اشتراک‌گذاری درگاه موازی تنها در صورتی پشتیبانی می‌کند که هسته‌ای با پشتیبانی از ppdev داشته باشید.

توجه داشته باشید که اگر از دستگاه کاراکتری ppdev استفاده نکنید، بک‌اند باید با دسترسی ریشه (root) اجرا شود. برای فراهم کردن دسترسی کاربر به اسکنر، بک‌اند را از طریق رابط شبکه اجرا کنید (نگاه کنید به saned(8) و sane-net(5)). یک راه‌حل آسان‌تر (از نظر امنیتی) افزودن بیت suid به فرانت‌اند است (نگاه کنید به chmod(1)). بک‌اند به محض دستیابی به دسترسی مستقیم به درگاه‌های I/O امتیازات ریشه را رها می‌کند که خطرات اجرای به عنوان ریشه را کاهش می‌دهد.

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

port value

که در آن value عبارت است از:

شناسایی خودکار تمام درگاه‌های موازی و کاوش آن‌ها برای یافتن اسکنر
شناسایی خودکار تمام درگاه‌های موازی و کاوش آن‌ها برای یافتن اسکنر، اما بدون تلاش برای دسترسی مستقیم سخت‌افزاری
/dev/ppi0
استفاده از دستگاه ppi در *BSD؛ بسته به تعداد درگاه‌های موازی موجود، باید از /dev/ppi1، /dev/ppi2، ... استفاده کنید
/dev/parport0
استفاده از دستگاه ppdev در لینوکس؛ بسته به تعداد درگاه‌های موازی موجود، باید از /dev/parport1، /dev/parport2، ... استفاده کنید
0x378
دسترسی مستقیم سخت‌افزاری به نشانی داده‌شده. مقادیر معمول 0x378، 0x278 و 0x3BC هستند. در این حالت، باید بک‌اند را به عنوان ریشه (*BSD و لینوکس) یا با 'IOPL=yes' در OS/2 اجرا کنید

نکته: در تمام موارد، باید دسترسی‌ها و مجوزهای کافی برای دسترسی به دستگاه یا نشانی انتخابی داشته باشید. بسته به تنظیمات امنیتی، ممکن است دستگاه‌ها برای همه کاربران در دسترس نباشند. باید مجوزها را روی دستگاه‌های /dev/ppi* یا /dev/parport* تغییر دهید.
می‌توانید هر دستگاهی را با استفاده از گزینه‌های

name devname
model model
vendor vendor

تغییر نام دهید. این گزینه‌ها روی آخرین گزینه port اعمال می‌شوند.

لطفاً اطمینان حاصل کنید که قبل از استفاده از بک‌اند، پرونده umax_pp.conf را ویرایش کرده‌اید.

محتوای پرونده umax_pp.conf فهرستی از گزینه‌ها و نام‌های دستگاه است که متناظر با اسکنرهای Umax هستند. خطوط خالی و خطوطی که با علامت هش (#) شروع می‌شوند نادیده گرفته می‌شوند.

هشت گزینه پشتیبانی‌شده عبارتند از red-gain، green-gain، blue-gain، red-offset، green-offset، blue-offset، astra و buffer.

گزینه‌های red-gain، green-gain و blue-gain به شما امکان می‌دهند حساسیت اسکنر خود را برای رنگ داده‌شده تنظیم کنید. مقادیر از 0 (کمترین بهره) تا 15 (بیشترین بهره) متغیر هستند. اگر گزینه پیشرفته "Gain" در فرانت‌اند علامت نخورده باشد، بک‌اند کالیبراسیون خودکار بهره را انجام می‌دهد و از مقادیر ارائه‌شده توسط کاربر استفاده نمی‌کند.

گزینه‌های red-offset، green-offset و blue-offset به شما امکان می‌دهند آفست اسکنر خود را برای رنگ داده‌شده تنظیم کنید. مقادیر از 0 (کمترین آفست) تا 15 (بیشترین آفست) متغیر هستند.

گزینه astra به شما امکان می‌دهد مدل اسکنر خود را تغییر دهید. شناسایی خودکار فعلی مبتنی بر اثرات جانبی اسکن هنگام استفاده از مجموعه دستورات 1220P روی مدل‌های دیگر است، بنابراین ممکن است روی ترکیب‌های سخت‌افزاری ناشناخته با شکست مواجه شود. مقادیر معتبر عبارتند از 610، 1220، 1600 و 2000. این گزینه تنها زمانی مفید است که شناسایی خودکار در تشخیص صحیح مدل اسکنر شما با شکست مواجه شود. اگر اسکنر شما به درستی کار می‌کند اما به اشتباه گزارش می‌شود، بگذارید به همان صورت باقی بماند. تنها مورد معتبر برای تغییر مدل زمانی است که اسکنر شما اسکن‌های «سیاه» یا «معکوس» تولید می‌کند. در این صورت می‌توانید مدل را قید کنید. توجه داشته باشید که این کار مانع شناسایی خودکار مدل اسکنر خواهد شد.

گزینه buffer به شما امکان می‌دهد اندازه بافر اسکن را تغییر دهید. اندازه باید بر حسب بایت مشخص شود. مقدار پیش‌فرض 2 مگابایت است. کاهش این مقدار روان بودن نوار پیشرفت در فرانت‌اند را بهبود می‌بخشد، اما فرآیند اسکن را بیشتر دچار توقف می‌کند.

/etc/sane.d/umax_pp.conf
پرونده پیکربندی بک‌اند (همچنین به توضیحات SANE_CONFIG_DIR در زیر مراجعه کنید).
/usr/lib/sane/libsane-umax_pp.a
کتابخانه ایستا که این بک‌اند را پیاده‌سازی می‌کند.
/usr/lib/sane/libsane-umax_pp.so
کتابخانه مشترک که این بک‌اند را پیاده‌سازی می‌کند (موجود در سیستم‌هایی که از بارگذاری پویا پشتیبانی می‌کنند).

این متغیر محیطی فهرستی از دایرکتوری‌هایی را مشخص می‌کند که ممکن است حاوی پرونده پیکربندی باشند. در سیستم‌های *NIX، دایرکتوری‌ها با دونقطه (`:`) و در OS/2 با نقطه-ویرگول (`;`) جدا می‌شوند. اگر این متغیر تنظیم نشده باشد، پرونده پیکربندی در دو دایرکتوری پیش‌فرض جستجو می‌شود: ابتدا دایرکتوری کاری جاری (".") و سپس در /etc/sane.d. اگر مقدار متغیر محیطی با نویسه جداکننده دایرکتوری پایان یابد، دایرکتوری‌های پیش‌فرض پس از دایرکتوری‌های به صراحت مشخص‌شده جستجو می‌شوند. برای مثال، تنظیم SANE_CONFIG_DIR روی "/tmp/config:" باعث می‌شود دایرکتوری‌های tmp/config، . و /etc/sane.d (به همین ترتیب) جستجو شوند.
اگر کتابخانه با پشتیبانی اشکال‌زدایی کامپایل شده باشد، این متغیر محیطی سطح اشکال‌زدایی را برای این بک‌اند کنترل می‌کند. برای مثال، مقدار 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 برای Umax ASIC تنظیم می‌کند. توجه داشته باشید که فعال کردن این مورد، ترمینال شما را با چند میلیون خط خروجی اشکال‌زدایی پر می‌کند. 
level   debug output
------- -------------------------------
 0       nothing
 1       errors
 8       command blocks
 16      detailed code flow
 32      dump datafiles
 255     everything

sane(7), sane-net(5), saned(8)

برای آخرین اصلاحات اشکال‌ها و اطلاعات بیشتر ببینید
http://umax1220p.sourceforge.net

Stéphane Voltz <stef.dev@free.fr>

پشتیبانی از 610P به لطف اهدای سخت‌افزار توسط William Stuart امکان‌پذیر شده است.

اگر چیزی کار نمی‌کند، لطفاً با من تماس بگیرید. اما برای کمک به شما به اطلاعاتی درباره اسکنر شما نیاز دارم...

نسخه SANE
برای تعیین این مورد دستور scanimage -V را اجرا کنید
نسخه بک‌اند و سخت‌افزار اسکنر شما
دستور SANE_DEBUG_UMAX_PP=255 scanimage -L 2>log را به عنوان ریشه اجرا کنید. اگر هیچ خروجی از بک‌اند sane-umax_pp دریافت نکردید، مطمئن شوید خط "umax_pp" در پرونده /etc/sane.d/dll.conf شما گنجانده شده است. اگر اسکنر شما شناسایی نشد، مطمئن شوید نشانی درگاه درست یا دستگاه صحیح را در پرونده umax_pp.conf خود تعریف کرده‌اید.
نام اسکنر/سازنده شما
همچنین اطلاعات مفیدی است. لطفاً تفکیک‌پذیری نوری و نوع لامپ اسکنر خود را نیز قید کنید، هر دو مورد در دفترچه راهنمای اسکنر شما یافت می‌شوند.
هرگونه نظر بیشتر
اگر نظری درباره مستندات دارید (چه چیزی می‌تواند بهتر باشد)، یا فکر می‌کنید چیزی هست که باید بدانم، لطفاً آن را قید کنید.
14 Jul 2008