.TH sane\-gt68xx 5 "13 ژوئیه 2008" "" "SANE Scanner Access Now Easy"
.IX sane\-gt68xx
.SH "نام (NAME)"
sane\-gt68xx \- بک‌اند SANE برای اسکنرهای تخت USB مبتنی بر GT-68XX
.SH "توضیحات (DESCRIPTION)"
کتابخانهٔ
.B sane\-gt68xx
یک بک‌اند SANE (Scanner Access Now Easy) را پیاده‌سازی می‌کند که دسترسی به اسکنرهای تخت USB مبتنی بر تراشه‌های Grandtech GT-6801 و GT-6816 را فراهم می‌آورد. فهرستی از اسکنرهای پشتیبانی‌شده را می‌توان در وب‌گاه بک‌اند gt68xx یافت:
.IR http://www.meier\-geinitz.de/sane/gt68xx\-backend/ .
.PP
این یک نرم‌افزار آزمایشی (BETA) است. به‌ویژه اگر در حال آزمایش اسکنرهای جدید یا تست‌نشده هستید، دست خود را روی دوشاخهٔ اسکنر نگه دارید و اگر هِد اسکنر در انتهای محدودهٔ اسکن به دیواره برخورد کرد، آن را از برق بکشید.
.PP
اگر صاحب اسکنری غیر از موارد فهرست‌شده در صفحهٔ gt68xx هستید که با این بک‌اند کار می‌کند، لطفاً با ارسال نام دقیق مدل اسکنر و شناسه‌های سازنده و دستگاه USB (مثلاً از طریق
.BR sane\-find\-scanner (1)
یا syslog) آن را به من اطلاع دهید. حتی اگر نام اسکنر تفاوت بسیار جزئی با مدل‌های پشتیبانی‌شده دارد، لطفاً اطلاع دهید.
.PP
اگر صاحب اسکنری هستید که توسط بک‌اند gt68xx شناسایی نمی‌شود اما دارای چیپ‌ست GT-6801 یا GT-6816 است، می‌توانید برای افزودن آن به بک‌اند تلاش کنید. نگاهی به این صفحهٔ وب بیندازید:
.I http://www.meier\-geinitz.de/sane/gt68xx\-backend/adding.html
.PP
.SH "مشکلات LIBUSB (LIBUSB ISSUES)"
لطفاً از libusb-0.1.8 یا نسخه‌های بالاتر استفاده کنید. بدون libusb یا با نسخه‌های قدیمی‌تر آن، انواع مشکلات ممکن است رخ دهد. اسکنر باید توسط
.BR sane\-find\-scanner (1)
بدون نیاز به اقدامات اضافه شناسایی شود. برای تنظیم دسترسی‌ها و اطلاعات عمومی USB، به
.BR sane\-usb (5)
مراجعه کنید.
.PP
.SH "فایل سفت‌افزار (FIRMWARE FILE)"
شما برای اسکنر خود به یک فایل سفت‌افزار (firmware) نیاز دارید. این یک فایل کوچک حاوی نرم‌افزاری است که در حافظهٔ اسکنر بارگذاری می‌شود. این فایل معمولاً با پسوند *.usb نام‌گذاری می‌شود، مانند
.IR PS1fw.usb .
این فایل در دیسک نصب ارائه‌شده توسط شرکت سازنده موجود است، اما ممکن است همراه با برنامهٔ نصب در یک فایل .exe فشرده شده باشد. برای اسکنرهای Mustek، این فایل را می‌توان از وب‌گاه بک‌اند gt68xx دریافت کرد. برای سایر اسکنرها، دیسک مربوطه را جهت یافتن فایل‌های .usb بررسی کنید. اگر تنها فایل‌های *.cab را پیدا کردید، برای استخراج آن‌ها از
.BR cabextract (1)
استفاده کنید. اگر همهٔ راه‌ها ناموفق بود، باید درایور ویندوز را نصب کرده و سفت‌افزار را از آنجا استخراج نمایید (معمولاً در دایرکتوری‌های
.I windows/system
یا
.IR system32 ).
فایل سفت‌افزار را در مسیر
.IR /usr/share/sane/gt68xx/
قرار دهید. اطمینان حاصل کنید که فایل برای همگان قابل خواندن باشد.

.SH "پیکربندی (CONFIGURATION)"
محتوای فایل
.I gt68xx.conf
فهرستی از خطوط usb حاوی شناسه‌های سازنده و محصول است که با اسکنرهای USB مطابقت دارند. این فایل همچنین می‌تواند حاوی خطوط گزینه‌ها باشد. خطوط خالی و خطوطی که با علامت هش (#) شروع می‌شوند نادیده گرفته می‌شوند. اسکنرها با عبارات
.B usb vendor_id product_id
که از پیش در
.I gt68xx.conf
قرار دارند، به‌صورت خودکار شناسایی می‌شوند. "vendor_id" و "product_id" اعدادی در مبنای شانزده (hexadecimal) هستند که اسکنر را مشخص می‌کنند.
.PP
گزینه‌های
.BR override ،
.BR firmware ،
.BR vendor ،
.BR model
و
.B afe
باید پس از خط
.B usb
مربوط به خود قرار گیرند.
.PP
گزینهٔ
.B override
برای بازنویسی پارامترهای پیش‌فرض مدل استفاده می‌شود. این گزینه برای برخی از اسکنرهایی که شناسه‌های vendor/product یکسان اما سخت‌افزار متفاوت دارند، ضروری است. برای این اسکنرها از قبل خطوط override به‌صورت کامنت در فایل پیکربندی قرار داده شده است.
.B override "mustek\-scanexpress\-1200\-ub\-plus"
برای مدل‌های Mustek Scanexpress 1200 UB Plus، Medion/Lifetec/Tevion LT 9452 و Trust Compact Scan USB 19200 الزامی است.
.B 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 استفاده می‌شود.
.B override "mustek\-bearpaw\-2400\-cu"
برای Mustek BearPaw 2400 CU و Fujitsu 1200CUS نیاز است. گزینهٔ
.B override
باید حتماً نخستین گزینه بعد از خط
.B usb
باشد.
.PP
گزینهٔ
.B firmware
نام و مسیر فایل سفت‌افزار را مشخص می‌کند. این گزینه فقط در صورتی لازم است که مقدار پیش‌فرض (یا بازنویسی‌شده) کار نکند. دایرکتوری پیش‌فرض سفت‌افزار
.IR /usr/share/sane/gt68xx/
است. ممکن است لازم باشد این دایرکتوری را ایجاد کنید. اگر می‌خواهید فایل‌های سفت‌افزار را در مسیر دیگری قرار دهید، از خط
.B firmware
استفاده کنید.
.PP
گزینه‌های
.B vendor
و
.B model
کاملاً ضروری نیستند و تنها برای سهولت کاربری تعبیه شده‌اند. تعداد زیادی از اسکنرهای شرکت‌های مختلف شناسه‌های vendor/product یکسانی دارند؛ بنابراین می‌توانید نام «صحیح» را در اینجا تنظیم کنید.
.PP
گزینهٔ
.B afe
امکان تنظیم مقادیر آفست و بهره (gain) سفارشی را برای بخش آنالوگ فرانت‌اند (Analog FrontEnd یا AFE) اسکنر فراهم می‌کند. این گزینه را می‌توان برای انتخاب مقادیر AFE در صورتی که کالیبراسیون تقریبی خودکار غیرفعال باشد، یا جهت افزایش سرعت کالیبراسیون تقریبی خودکار استفاده کرد. برای مورد دوم، سطح دیباگ ۳ را فعال کنید (پایین‌تر را ببینید)، تصویری را اسکن کرده و به دنبال خط اشکال‌زدایی حاوی "afe" بگردید. این خط را در
.I gt68xx.conf
کپی کنید. این گزینه شش پارامتر دارد: آفست قرمز، بهرهٔ قرمز، آفست سبز، بهرهٔ سبز، آفست آبی و بهرهٔ آبی.
.PP
نمونه‌ای از فایل پیکربندی در زیر آورده شده است:
.PP
.RS
usb 0x05d8 0x4002
.br
override "mustek\-scanexpress\-1200\-ub\-plus"
.br
firmware "/opt/gt68xx/SBfw.usb"
.br
vendor "Trust"
.br
model "Compact Scan USB 19200"
.br
afe 0x20 0x02 0x22 0x03 0x1f 0x04
.RE

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

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

.SH "همچنین ببینید (SEE ALSO)"
.BR sane (7),
.BR sane\-usb (5),
.BR sane\-artec_eplus48u (5),
.BR sane\-plustek (5),
.BR sane\-ma1509 (5),
.BR sane\-mustek_usb (5),
.BR sane\-mustek (5),
.BR sane\-mustek_pp (5),
.BR cabextract (1)
.br
.I /usr/share/doc/sane/gt68xx/gt68xx.CHANGES
.br
.I http://www.meier\-geinitz.de/sane/gt68xx

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

.SH "گزارش باگ‌ها (BUGS)"
چند خط ابتدایی تصویر در مدل 2400 TA Plus خراب و بدون استفاده است.
.PP
هنگامی که تفکیک‌پذیری محورهای X و Y متفاوت است، به جای کپی کردن صرف داده‌ها باید از روش درون‌یابی (interpolation) استفاده شود.
.PP
پشتیبانی از کلیدها و دکمه‌های روی اسکنر پیاده‌سازی نشده است.
.PP
اطلاعات دقیق‌تر در خصوص باگ‌ها در وب‌گاه بک‌اند gt68xx موجود است:
.IR http://www.meier\-geinitz.de/sane/gt68xx\-backend/ .
.br
در صورت یافتن باگ یا نبود قابلیتی خاص با ما تماس بگیرید:
.RI < sane\-devel@alioth-lists.debian.net >.
.br
اگر اسکنر شما به درستی شناسایی نمی‌شود، لطفاً لاگ اشکال‌زدایی را ارسال فرمایید (به متغیر
.B SANE_DEBUG_GT68XX
در بالا مراجعه کنید).