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

sane-avision - پشتیبان SANE برای اسکنرهای تخت و فیلم با برند Avision و OEMهای آن (HP، Minolta، Mitsubishi، UMAX و موارد بیشتر)

کتابخانه sane-avision یک پشتیبان SANE (دسترسی آسان به اسکنر) پیاده‌سازی می‌کند که دسترسی به اسکنرهای مختلف Avision و اسکنرهای OEM برند Avision تحت نام‌های HP، Minolta، Mitsubishi یا Fujitsu را فراهم می‌سازد.

این کتابخانه کاملاً با معماری ترتیب بایت کلان (big-endian) سازگار است و روزانه در سیستم‌های PowerPC و SPARC استفاده می‌شود.

پیشنهاد می‌کنم هنگام انجام اولین اسکن‌ها دست خود را روی دکمه پاور اسکنر نگه دارید - به‌ویژه هنگام کار با اسکنرهای فیلم!

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

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

# این یک توضیح است
option force-a4
option force-a3
option skip-adf
option disable-gamma-table
option disable-calibration
#scsi Vendor Model Type Bus Channel ID LUN
scsi AVISION
scsi HP
scsi /dev/scanner
usb 0x03f0 0x0701
پشتیبان را وادار می‌کند تا ناحیه قابل اسکن بازگردانده‌شده توسط اسکنر را به ISO A4 بازنویسی کند. اسکنرهایی که بازگرداندن داده‌های نامعتبر از آن‌ها شناخته شده است در پشتیبان نشانه‌گذاری شده‌اند، بنابراین اگر به این گزینه نیاز پیدا کردید، لطفاً آن را به نگهدارنده پشتیبان گزارش دهید. با احتیاط استفاده کنید!
پشتیبان را وادار می‌کند تا ناحیه قابل اسکن بازگردانده‌شده توسط اسکنر را به ISO A3 بازنویسی کند. اسکنرهایی که بازگرداندن داده‌های نامعتبر از آن‌ها شناخته شده است در پشتیبان نشانه‌گذاری شده‌اند، بنابراین اگر به این گزینه نیاز پیدا کردید، لطفاً آن را به نگهدارنده پشتیبان گزارش دهید. با احتیاط استفاده کنید!
پشتیبان را وادار می‌کند تا وضعیت متناقض ADF (تغذیه خودکار اسناد) بازگردانده‌شده توسط اسکنر را نادیده بگیرد (عدم حضور ADF، اما شماره مدل غیرصفر ADF). بدون این گزینه، پشتیبان چندین بار برای بازنشانی ADF تلاش کرده و در این وضعیت کوئری را تکرار می‌کند، و اگر ADF همچنان پاسخ ندهد با خطای "not supported" مواجه می‌شود.
استفاده از جدول گامای اسکنر را غیرفعال می‌کند. اگر اسکن‌های شما متوقف می‌شوند یا فقط خروجی نامفهوم و زباله تولید می‌کنند، می‌توانید این گزینه را امتحان کنید.
کالیبراسیون رنگ اسکنر را غیرفعال می‌کند. اگر اسکن‌های شما متوقف می‌شوند یا فقط خروجی نامفهوم و تصادفی تولید می‌کنند، می‌توانید این گزینه را امتحان کنید.
نکته:
هر یک از گزینه‌های بالا، جریان پیش‌فرض کد را برای اسکنر شما تغییر می‌دهد. این گزینه‌ها تنها در صورتی باید استفاده شوند که با رفتار پیش‌فرض پشتیبان دچار مشکل شده باشید. لطفاً نیاز به گزینه‌ها را به نویسنده پشتیبان گزارش دهید تا مشکل پشتیبان در اسرع وقت برطرف شود.

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

scsi scsi-spec

usb usb-spec

که در آن scsi-spec مسیر یک دستگاه خاص یا یک شناسه دستگاه برای دستگاه مربوط به یک اسکنر SCSI است. نام دستگاه خاص باید یک دستگاه عمومی SCSI یا پیوند نمادین به چنین دستگاهی باشد؛ برای مثال در لینوکس /dev/sga یا /dev/sg0. شناسه دستگاه، شناسه‌ای است که توسط اسکنر بازگردانده می‌شود؛ برای مثال "HP" یا "AVISION". برای جزئیات به sane-scsi(5) مراجعه کنید.

نکته:
از آنجا که پشتیبان اکنون شامل دسترسی بومی USB است، دیگر نیازی به دسترسی به اسکنر USB از طریق شبیه‌سازی SCSI (به نام hpusbscsi در لینوکس) برای دستگاه‌های USB برند Avision مانند HP 53xx، HP 74xx یا اسکنرهای فیلم Minolta وجود ندارد و حتی منسوخ تلقی می‌شود.

usb-spec نام دستگاه USB، جفت شناسه سازنده/محصول یا نام استفاده‌شده توسط libusb منطبق بر اسکنر USB است؛ برای مثال "0x03f0 0x0701" یا "libusb:002:003". برای جزئیات به sane-usb(5) مراجعه کنید.

برنامه sane-find-scanner(1) به پیدا کردن نام دستگاه صحیح scsi یا usb کمک می‌کند.

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

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

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

مثال:

export SANE_DEBUG_AVISION=7

sane(7), sane-scsi(5), sane-usb(5)
http://exactcode.com/site/open_source/saneavision

René Rebe

René Rebe و Meino Christian Cramer

11 Jul 2008