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

sane-gt68xx - بک‌اند SANE برای اسکنرهای تخت USB مبتنی بر GT-68XX

کتابخانهٔ sane-gt68xx یک بک‌اند SANE (Scanner Access Now Easy) را پیاده‌سازی می‌کند که دسترسی به اسکنرهای تخت USB مبتنی بر تراشه‌های Grandtech GT-6801 و GT-6816 را فراهم می‌آورد. فهرستی از اسکنرهای پشتیبانی‌شده را می‌توان در وب‌گاه بک‌اند gt68xx یافت: http://www.meier-geinitz.de/sane/gt68xx-backend/.

این یک نرم‌افزار آزمایشی (BETA) است. به‌ویژه اگر در حال آزمایش اسکنرهای جدید یا تست‌نشده هستید، دست خود را روی دوشاخهٔ اسکنر نگه دارید و اگر هِد اسکنر در انتهای محدودهٔ اسکن به دیواره برخورد کرد، آن را از برق بکشید.

اگر صاحب اسکنری غیر از موارد فهرست‌شده در صفحهٔ gt68xx هستید که با این بک‌اند کار می‌کند، لطفاً با ارسال نام دقیق مدل اسکنر و شناسه‌های سازنده و دستگاه USB (مثلاً از طریق sane-find-scanner(1) یا syslog) آن را به من اطلاع دهید. حتی اگر نام اسکنر تفاوت بسیار جزئی با مدل‌های پشتیبانی‌شده دارد، لطفاً اطلاع دهید.

اگر صاحب اسکنری هستید که توسط بک‌اند gt68xx شناسایی نمی‌شود اما دارای چیپ‌ست GT-6801 یا GT-6816 است، می‌توانید برای افزودن آن به بک‌اند تلاش کنید. نگاهی به این صفحهٔ وب بیندازید: http://www.meier-geinitz.de/sane/gt68xx-backend/adding.html

لطفاً از libusb-0.1.8 یا نسخه‌های بالاتر استفاده کنید. بدون libusb یا با نسخه‌های قدیمی‌تر آن، انواع مشکلات ممکن است رخ دهد. اسکنر باید توسط sane-find-scanner(1) بدون نیاز به اقدامات اضافه شناسایی شود. برای تنظیم دسترسی‌ها و اطلاعات عمومی USB، به sane-usb(5) مراجعه کنید.

شما برای اسکنر خود به یک فایل سفت‌افزار (firmware) نیاز دارید. این یک فایل کوچک حاوی نرم‌افزاری است که در حافظهٔ اسکنر بارگذاری می‌شود. این فایل معمولاً با پسوند *.usb نام‌گذاری می‌شود، مانند PS1fw.usb. این فایل در دیسک نصب ارائه‌شده توسط شرکت سازنده موجود است، اما ممکن است همراه با برنامهٔ نصب در یک فایل .exe فشرده شده باشد. برای اسکنرهای Mustek، این فایل را می‌توان از وب‌گاه بک‌اند gt68xx دریافت کرد. برای سایر اسکنرها، دیسک مربوطه را جهت یافتن فایل‌های .usb بررسی کنید. اگر تنها فایل‌های *.cab را پیدا کردید، برای استخراج آن‌ها از cabextract(1) استفاده کنید. اگر همهٔ راه‌ها ناموفق بود، باید درایور ویندوز را نصب کرده و سفت‌افزار را از آنجا استخراج نمایید (معمولاً در دایرکتوری‌های windows/system یا system32). فایل سفت‌افزار را در مسیر /usr/share/sane/gt68xx/ قرار دهید. اطمینان حاصل کنید که فایل برای همگان قابل خواندن باشد.

محتوای فایل gt68xx.conf فهرستی از خطوط usb حاوی شناسه‌های سازنده و محصول است که با اسکنرهای USB مطابقت دارند. این فایل همچنین می‌تواند حاوی خطوط گزینه‌ها باشد. خطوط خالی و خطوطی که با علامت هش (#) شروع می‌شوند نادیده گرفته می‌شوند. اسکنرها با عبارات usb vendor_id product_id که از پیش در gt68xx.conf قرار دارند، به‌صورت خودکار شناسایی می‌شوند. "vendor_id" و "product_id" اعدادی در مبنای شانزده (hexadecimal) هستند که اسکنر را مشخص می‌کنند.

گزینه‌های override، firmware، vendor، model و afe باید پس از خط usb مربوط به خود قرار گیرند.

گزینهٔ override برای بازنویسی پارامترهای پیش‌فرض مدل استفاده می‌شود. این گزینه برای برخی از اسکنرهایی که شناسه‌های vendor/product یکسان اما سخت‌افزار متفاوت دارند، ضروری است. برای این اسکنرها از قبل خطوط override به‌صورت کامنت در فایل پیکربندی قرار داده شده است. override mustek-scanexpress-1200-ub-plus برای مدل‌های Mustek Scanexpress 1200 UB Plus، Medion/Lifetec/Tevion LT 9452 و Trust Compact Scan USB 19200 الزامی است. override artec-ultima-2000 برای Artec Ultima 2000، Boeder SmartScan Slim Edition، Medion/ Lifetec/ Tevion/ Cytron MD/LT 9385، Medion/ Lifetec/ Tevion MD 9458 و Trust Flat Scan USB 19200 استفاده می‌شود. override mustek-bearpaw-2400-cu برای Mustek BearPaw 2400 CU و Fujitsu 1200CUS نیاز است. گزینهٔ override باید حتماً نخستین گزینه بعد از خط usb باشد.

گزینهٔ firmware نام و مسیر فایل سفت‌افزار را مشخص می‌کند. این گزینه فقط در صورتی لازم است که مقدار پیش‌فرض (یا بازنویسی‌شده) کار نکند. دایرکتوری پیش‌فرض سفت‌افزار /usr/share/sane/gt68xx/ است. ممکن است لازم باشد این دایرکتوری را ایجاد کنید. اگر می‌خواهید فایل‌های سفت‌افزار را در مسیر دیگری قرار دهید، از خط firmware استفاده کنید.

گزینه‌های vendor و model کاملاً ضروری نیستند و تنها برای سهولت کاربری تعبیه شده‌اند. تعداد زیادی از اسکنرهای شرکت‌های مختلف شناسه‌های vendor/product یکسانی دارند؛ بنابراین می‌توانید نام «صحیح» را در اینجا تنظیم کنید.

گزینهٔ afe امکان تنظیم مقادیر آفست و بهره (gain) سفارشی را برای بخش آنالوگ فرانت‌اند (Analog FrontEnd یا AFE) اسکنر فراهم می‌کند. این گزینه را می‌توان برای انتخاب مقادیر AFE در صورتی که کالیبراسیون تقریبی خودکار غیرفعال باشد، یا جهت افزایش سرعت کالیبراسیون تقریبی خودکار استفاده کرد. برای مورد دوم، سطح دیباگ ۳ را فعال کنید (پایین‌تر را ببینید)، تصویری را اسکن کرده و به دنبال خط اشکال‌زدایی حاوی "afe" بگردید. این خط را در gt68xx.conf کپی کنید. این گزینه شش پارامتر دارد: آفست قرمز، بهرهٔ قرمز، آفست سبز، بهرهٔ سبز، آفست آبی و بهرهٔ آبی.

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

usb 0x05d8 0x4002
override "mustek-scanexpress-1200-ub-plus"
firmware "/opt/gt68xx/SBfw.usb"
vendor "Trust"
model "Compact Scan USB 19200"
afe 0x20 0x02 0x22 0x03 0x1f 0x04

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

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

مثال: export SANE_DEBUG_GT68XX=4

sane(7), sane-usb(5), sane-artec_eplus48u(5), sane-plustek(5), sane-ma1509(5), sane-mustek_usb(5), sane-mustek(5), sane-mustek_pp(5), cabextract(1)
/usr/share/doc/sane/gt68xx/gt68xx.CHANGES
http://www.meier-geinitz.de/sane/gt68xx

Henning Meier-Geinitz <henning@meier-geinitz.de>
درایور اصلی gt68xx توسط Sergey Vlasov، Andreas Nowack و David Stevenson نوشته شده است. با تشکر از آن‌ها و تمام مشارکت‌کنندگان دیگر به خاطر ارسال وصله‌ها و پاسخ به پرسش‌ها.

چند خط ابتدایی تصویر در مدل 2400 TA Plus خراب و بدون استفاده است.

هنگامی که تفکیک‌پذیری محورهای X و Y متفاوت است، به جای کپی کردن صرف داده‌ها باید از روش درون‌یابی (interpolation) استفاده شود.

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

اطلاعات دقیق‌تر در خصوص باگ‌ها در وب‌گاه بک‌اند gt68xx موجود است: http://www.meier-geinitz.de/sane/gt68xx-backend/.
در صورت یافتن باگ یا نبود قابلیتی خاص با ما تماس بگیرید: <sane-devel@alioth-lists.debian.net>.
اگر اسکنر شما به درستی شناسایی نمی‌شود، لطفاً لاگ اشکال‌زدایی را ارسال فرمایید (به متغیر SANE_DEBUG_GT68XX در بالا مراجعه کنید).

13 ژوئیه 2008