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

sane-st400 - بک‌اند SANE برای اسکنرهای مسطح ST/Highscan زیمنس

کتابخانهٔ sane-st400 یک بک‌اند SANE (دسترسی آسان به اسکنر - Scanner Access Now Easy) را پیاده‌سازی می‌کند که امکان دسترسی به اسکنرهای تخت ST400 زیمنس و سازگار با آن را فراهم می‌آورد. در حال حاضر اسکنرهای زیر توسط این بک‌اند پشتیبانی می‌شوند:

Siemens ST400 (مقیاس خاکستری ۶ بیتی)
Siemens ST800 (مقیاس خاکستری ۶ بیتی)

این درایور از اسکن‌های خطی (line art) و مقیاس خاکستری تا سقف 8bpp پشتیبانی می‌کند.

سری زیمنس ST/Highscan شامل چندین مدل دیگر از جمله ST300 و ST600 نیز می‌شود. اگر یکی از این اسکنرها یا اسکنری غیر از موارد فهرست‌شده در بالا دارید که با این بک‌اند کار می‌کند، لطفاً با ارسال نام مدل اسکنر، شناسهٔ SCSI و نسخهٔ سفت‌افزار (firmware) به sane-devel@alioth-lists.debian.net ما را مطلع سازید. برای کسب اطلاعات دربارهٔ عضویت در sane-devel به http://www.sane-project.org/mailing-lists.html مراجعه کنید.

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

special

که در آن special نام مسیر برای دستگاه ویژه‌ای است که متناظر با یک اسکنر SCSI می‌باشد. برای اسکنرهای SCSI، نام دستگاه ویژه باید یک دستگاه عمومی SCSI یا پیوند نمادین به چنین دستگاهی باشد. تحت لینوکس، چنین نام دستگاهی می‌تواند برای مثال /dev/sga یا /dev/sge باشد. برای جزئیات بیشتر به sane-scsi(5) مراجعه کنید.

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

/dev/scanner
# this is a comment
/dev/sge

فایل پیکربندی پیش‌فرضی که همراه با SANE توزیع می‌شود به این صورت است:

scsi SIEMENS "ST 400" Scanner * * 3 0

در این پیکربندی، درایور تنها می‌تواند به مدل ST400 در شناسهٔ SCSI برابر با 3 و LUN برابر با 0 دسترسی پیدا کند (برای دلیل این موضوع به بخش اشکالات (BUGS) در زیر مراجعه کنید). برای استفاده از درایور با سایر مدل‌های اسکنر، خط مناسب را به فایل پیکربندی اضافه کنید. برای مثال، جهت استفاده از آن با یک ST800 در شناسهٔ SCSI برابر با 3 و LUN برابر با 0، خط زیر را اضافه کنید:

scsi SIEMENS "ST 800" Scanner * * 3 0

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

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

همه چیز به جز ابتدایی‌ترین قابلیت‌ها.

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

اسکنر ST400 روی هر هشت LUN مربوط به SCSI پاسخ می‌دهد. معمولاً این مسئله مشکلی ایجاد نمی‌کند، زیرا پشتیبانی از LUN معمولاً در درایورهای SCSI غیرفعال است، اما اگر چندین نمونه از اسکنر را در فهرست دستگاه‌ها مشاهده می‌کنید، یا LUNها را در پیکربندی SCSI خود غیرفعال کنید یا ورودی موجود در فایل پیکربندی را تغییر دهید تا فقط با LUN 0 مطابقت داشته باشد.

اگر با اشکالی مواجه شدید، لطفاً متغیر محیطی SANE_DEBUG_ST400 را روی 128 تنظیم کرده و سعی کنید مشکل را دوباره بازتولید کنید. سپس گزارشی همراه با لاگ پیوست‌شده برای من ارسال کنید.

اگر با خطای گذرگاه SCSI یا تصاویر بریده‌شده و/یا جابه‌جا شده مواجه شدید، لطفاً پیش از ارسال گزارش برای من، متغیر محیطی SANE_DEBUG_SANEI_SCSI را نیز روی 128 تنظیم کنید.

sane(7), sane-scsi(5)
http://www.informatik.uni-oldenburg.de/~ingo/sane

Ingo Wilken <Ingo.Wilken@informatik.uni-oldenburg.de>

14 Jul 2008