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

sane-umax - بک‌اند SANE برای اسکنرهای UMAX

این پرونده صرفاً یک شرح مختصر از بک‌اند sane-umax برای SANE است! برای دریافت اطلاعات تفصیلی به sane-umax-doc.html (که در دایرکتوری سورس SANE و در راهنمای برخط xsane(1) گنجانده شده است) مراجعه کنید!

کتابخانهٔ sane-umax یک بک‌اند SANE را پیاده‌سازی می‌کند که دسترسی به چندین اسکنر UMAX-SCSI و برخی اسکنرهای Linotype Hell SCSI را فراهم می‌آورد؛ اسکنرهای موازی (parallel) و USB پشتیبانی نمی‌شوند (و احتمالاً هرگز پشتیبانی نخواهند شد)!

پیشنهاد می‌کنم هنگام انجام اولین اسکن‌ها، یک دست خود را روی دکمه پاور اسکنر نگه دارید!

فایل پیکربندی این بک‌اند در مسیر /etc/sane.d/umax.conf قرار دارد.

محتوای آن فهرستی از نام‌های دستگاه است که با اسکنرهای UMAX و سازگار با UMAX مطابقت دارند. خطوط خالی و خطوطی که با علامت هش (#) آغاز می‌شوند، نادیده گرفته می‌شوند. یک نمونه فایل پیکربندی در زیر نشان داده شده است:

# this is a comment
#
option scsi-maxqueue 4
option scsi-buffer-size-min 65536
option scsi-buffer-size-max 131072
option scan-lines 40
option preview-lines 10
option scsi-maxqueue 2
option execute-request-sense 0
option force-preview-bit-rgb 0
option slow-speed -1
option care-about-smearing -1
option calibration-full-ccd -1
option calibration-width-offset -1
option calibration-bytes-pixel -1
option exposure-time-rgb-bind -1
option invert-shading-data -1
option lamp-control-available 0
option gamma-lsb-padded 0
/dev/sge
#scsi Vendor Model Type Bus Channel ID LUN
# The following scanner supports lamp control
option lamp-control-available 1
scsi UMAX * Scanner * * * * *
# scanner on /dev/scanner does not support lamp control
option lamp-control-available 0
/dev/scanner
مقادیر: 0 = غیرفعال، 1 = فعال
پیش‌فرض = 0
اگر روی 1 تنظیم شود، umax_do_request_sense() در umax_do_calibration() فراخوانی می‌شود. این کار می‌تواند سیستم را متوقف (hang) کند، اما تا این نسخه فعال بوده است.
مقادیر: 4096-1048576
پیش‌فرض: کمینه = 32768، بیشینه = 131072
به‌ویژه مقدار کمینه بسیار مهم است. اگر این مقدار بیش از حد کوچک تنظیم شود، بک‌اند قادر به ارسال جدول‌های گاما به اسکنر یا انجام کالیبراسیون صحیح رنگ نخواهد بود. این امر ممکن است منجر به جلوه‌های رنگی نامتعارف شود. اگر مقدار کمینه بیش از حد بزرگ تنظیم شود، بک‌اند قادر به تخصیص اندازه بافر SCSI درخواستی نخواهد بود و با خطای اتمام حافظه (out of memory) متوقف می‌شود. پیش‌فرض 32 کیلوبایت است، که برای برخی اسکنرها باید به 64 کیلوبایت افزایش یابد.
مقادیر: 1-65535
پیش‌فرض: scan-lines = 40، preview-lines = 10
حداکثر تعداد خطوطی را که در یک بافر اسکن می‌شوند مشخص می‌کند.
مقادیر: 0 = غیرفعال، 1 = فعال
پیش‌فرض = 0
تنظیم بیت پیش‌نمایش در اسکن واقعی RGB.
مقادیر: -1 = خودکار، 0 = غیرفعال، 1 = فعال
پیش‌فرض = -1
گزینه‌های خطرناک، مورد نیاز برای برخی اسکنرها.
این گزینه‌ها را تغییر ندهید مگر آنکه واقعاً بدانید چه کاری انجام می‌دهید؛ در غیر این صورت ممکن است با مقادیر نامعتبر به اسکنر خود آسیب بزنید.
مقادیر: -1 = خودکار، 0 = غیرفعال، 1 = فعال
پیش‌فرض = -1
انجام کالیبراسیون برای تک‌تک پیکسل‌های CCD به‌جای تصویر انتخاب‌شده.
مقادیر: -99999 = خودکار، < -99999 مقدار تعیین‌شده
افزودن یک آفست به عرض محاسبه‌شده برای تصویر/CCD.
مقادیر: -1 = غیرفعال، 0 = تنظیم‌نشده، 1 = ۱ بایت/پیکسل، 2 = ۲ بایت/پیکسل
استفاده از # بایت در هر پیکسل برای کالیبراسیون.
مقادیر: -1 = تنظیم خودکار توسط درایور - در صورت شناخته بودن، 0 = غیرفعال (انتخاب مجزا برای قرمز، سبز و آبی)، 1 = فعال (مقادیر یکسان برای قرمز، سبز و آبی)
مقادیر: -1 = تنظیم خودکار توسط درایور - در صورت شناخته بودن، 0 = غیرفعال، 1 = فعال
پیش‌فرض = -1
معکوس‌کردن داده‌های سایه‌زنی پیش از ارسال مجدد به اسکنر.
مقادیر: 0 = تنظیم خودکار توسط درایور - در صورت شناخته بودن، 1 = در دسترس
پیش‌فرض = 0
مقادیر: -1 = تنظیم خودکار توسط درایور - در صورت شناخته بودن، 0 = داده‌های گاما با msb پدگذاری شده‌اند، 1 = داده‌های گاما با lsb پدگذاری شده‌اند
پیش‌فرض = -1
مقادیر: 0 = رسیدگی به‌عنوان مشغول بودن دستگاه، 1 = رسیدگی به‌عنوان مناسب (ok)، 2 = رسیدگی به‌عنوان خطای ورودی/خروجی، 3 = نادیده گرفتن کد خطای نامناسب - ادامه مدیریت سنس
پیش‌فرض = 0
مقادیر: 1..# (حداکثر در زمان کامپایل تعریف می‌شود)
پیش‌فرض = 2
اکثر درایورهای SCSI صف‌بندی داخلی دستورات را با عمق ۲ دستور مجاز می‌دانند. در بیشتر موارد، افزایش این مقدار بهبودی ایجاد نمی‌کند. اگر درایور SCSI شما از صف‌بندی دستورات پشتیبانی نمی‌کند، می‌توانید این مقدار را روی ۱ تنظیم کنید.

نام دستگاه ویژه باید یک دستگاه عمومی SCSI یا یک پیوند نمادین به چنین دستگاهی باشد. برای آگاهی از این‌که اسکنر شما به کدام دستگاه اختصاص یافته است و چگونه باید مجوزهای دسترسی آن دستگاه را تنظیم کنید، نگاهی به sane-scsi(5) بیندازید.

آداپتورهای ISA-SCSI که به همراه برخی اسکنرهای UMAX عرضه می‌شوند، به‌خوبی توسط لینوکس پشتیبانی نمی‌شوند (پیشنهاد می‌کنم از آن‌ها استفاده نکنید)؛ آداپتورهای PCI-SCSI همراه با برخی اسکنرهای UMAX نیز (تا آنجا که من می‌دانم) اصلاً پشتیبانی نمی‌شوند. در سایر پلتفرم‌ها نیز این آداپتورهای SCSI پشتیبانی نمی‌شوند؛ بنابراین معمولاً نیاز است آداپتور SCSI دیگری تهیه کنید که توسط پلتفرم شما پشتیبانی می‌شود. برای اطلاعات بیشتر به پرسش‌های متداول سخت‌افزاری و راهنماهای پلتفرم خود مراجعه کنید.

اسکنرهای UMAX هنگام اسکن کردن، گذرگاه SCSI را به مدت چند ثانیه مسدود می‌کنند. نیازی نیست اسکنر را به یک آداپتور SCSI اختصاصی متصل کنید؛ اما اگر به زمان پاسخ‌دهی کوتاه برای دیسک سخت SCSI خود (مثلاً اگر رایانه شما یک سرویس‌دهنده فایل است) یا سایر دستگاه‌های SCSI نیاز دارید، پیشنهاد می‌کنم برای اسکنر UMAX خود از یک آداپتور SCSI اختصاصی و جداگانه استفاده کنید.

اگر مشکلی با اسکنر UMAX خود دارید، زنجیره SCSI را بررسی کنید (طول کابل، ترمیناسیون و...).

همچنین ببینید: sane-scsi(5)

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

اگر کتابخانه با پشتیبانی از اشکال‌زدایی کامپایل شده باشد، این متغیر محیطی سطح اشکال‌زدایی را برای این بک‌اند کنترل می‌کند. برای مثال، مقدار ۱۲۸ درخواست چاپ تمامی خروجی‌های اشکال‌زدایی را می‌دهد. سطوح پایین‌تر میزان جزئیات خروجی را کاهش می‌دهند.
مقادیر SANE_DEBUG_UMAX: 
شماره   توضیح
 0       چاپ خطاهای مهم (هر بار چاپ می‌شود)
 1       چاپ خطاها
 2       چاپ sense
 3       چاپ هشدارها
 4       چاپ استعلام اسکنر (scanner-inquiry)
 5       چاپ اطلاعات
 6       چاپ اطلاعات کم‌اهمیت‌تر
 7       چاپ رویه‌های فراخوانی‌شده
 8       چاپ پیام‌های reader_process
 10      چاپ روتین‌های sane-init فراخوانی‌شده
 11      چاپ رویه‌های sane فراخوانی‌شده
 12      چاپ اطلاعات sane
 13      چاپ پیام‌های کنترلی گزینهٔ sane
مثال:
export SANE_DEBUG_UMAX=8

تفکیک‌پذیری‌های افقی (X-resolutions) بزرگ‌تر از 600 dpi گاهی اوقات باعث بروز مشکل می‌شوند.

sane(7), sane-scsi(5)

Oliver Rauch

Oliver.Rauch@Rauch-Domain.DE

14 Jul 2008