.TH sane\-hp 5 "13 Jul 2008" "" "SANE Scanner Access Now Easy" .IX sane\-hp .SH "نام (NAME)" sane\-hp \- بک‌اند SANE برای اسکنرهای HP ScanJet .SH "شرح (DESCRIPTION)" کتابخانه .B sane\-hp یک بک‌اند SANE (دسترسی آسان به اسکنر \- Scanner Access Now Easy) را پیاده‌سازی می‌کند که دسترسی به اسکنرهای HP ScanJet با پشتیبانی از SCL (زبان کنترل اسکنر ارائه شده توسط HP \- Scanner Control Language) را فراهم می‌آورد. مشخص شده است که اسکنرهای زیر به طور قطعی با این بک‌اند کار می‌کنند: .PP .RS .ft CR .nf Model: Product id: Interface: ---------- ----------- ---------- ScanJet Plus C9195A HP Parallel Interface Card ScanJet IIc C1750A 3226 SCSI ScanJet IIcx C2500A 3332 SCSI ScanJet IIp C1790A SCSI ScanJet 3C C2520A 3503 SCSI ScanJet 3P C2570A 3406 SCSI ScanJet 4C C2520A SCSI ScanJet 4P C1130A 3540 SCSI ScanJet 4100C C6290A USB ScanJet 5P C5110A SCSI ScanJet 5100C C5190A parallel port ScanJet 5200C C7190A 3846 parallel port/USB ScanJet 6100C C2520A 3644 SCSI ScanJet 6200C C6270A 3828 SCSI/USB ScanJet 6250C C6270A 3828 SCSI/USB ScanJet 6300C C7670A SCSI/USB ScanJet 6350C C7670A SCSI/USB ScanJet 6390C C7670A SCSI/USB PhotoSmart C5100A R029,R030,R032 SCSI .fi .ft R .RE .PP پشتیبانی از مدل‌های 5100C/5200C متصل به درگاه موازی نیازمند درایور ppSCSI است که در نشانی‌های .I http://cyberelk.net/tim/parport/ppscsi.html و .IR http://penguin-breeder.org/kernel/download در دسترس است. .PP پشتیبانی از مدل‌های 5200C/62X0C/63X0C متصل به USB نیازمند libusb است. برای جزئیات بیشتر به .BR sane\-usb (5) مراجعه کنید. .PP بک‌اند .B sane\-hp دیگر از دستگاه‌های چندمنظوره OfficeJet پشتیبانی نمی‌کند. برای این دستگاه‌ها از بسته‌های خارجی "hplip" در دسترس در: .IR https://developers.hp.com/hp\-linux\-imaging\-and\-printing استفاده کنید. برای کسب اطلاعات درباره درایور پیشین hpoj، به: .IR http://hpoj.sourceforge.net مراجعه کنید. .PP از آنجا که Hewlett-Packard دیگر اسکنرهایی با پشتیبانی از SCL تولید نمی‌کند (به جز OfficeJets)، فهرست بالا از اسکنرهای پشتیبانی‌شده کامل است. سایر اسکنرهای HP توسط بک‌اند .B sane\-hp پشتیبانی نمی‌شوند، اما ممکن است توسط بک‌اند دیگری پشتیبانی شوند. به .IR http://www.sane\-project.org مراجعه کنید. همچنین می‌توانید فهرست پستی sane\-devel را در .IR http://www.sane\-project.org/mailing\-lists.html دنبال کنید. .PP جزئیات بیشتر درباره بک‌اند hp را می‌توان در صفحه خانگی آن یافت: .IR http://web.archive.org/web/20070206115546/http://www.kirchgessner.net/sane.html . .PP .SH "نام‌های دستگاه (DEVICE NAMES)" این بک‌اند نام‌های دستگاه را در قالب زیر انتظار دارد: .PP .RS .I special .RE .PP که در آن .I special مسیر نام فایل دستگاه ویژه در UNIX است که با اسکنر مطابقت دارد. برای اسکنرهای SCSI نام دستگاه ویژه باید یک دستگاه همگانی SCSI یا یک پیوند نمادین (symlink) به چنین دستگاهی باشد. در لینوکس، چنین نام دستگاهی می‌تواند به عنوان نمونه .I /dev/sga یا .IR /dev/sg2 باشد. اگر نام دستگاه ویژه حاوی "usb"، "uscanner" یا "ugen" باشد، فرض می‌شود که اسکنر از طریق USB متصل شده است. برای HP ScanJet Plus نام دستگاه ویژه باید دستگاهی باشد که با کارت رابط موازی ارائه‌شده همراه اسکنر مطابقت دارد. این نام .IR /dev/hpscan است. برای این کارت به یک درایور ویژه نیاز است. برای جزئیات به .I ftp://rvs.ctrl\-c.liu.se/pub/wingel/hpscan مراجعه کنید. اگر این پیوند کار نکرد، .IR ftp://sunsite.unc.edu/pub/Linux/kernel/patches/scanners را امتحان کنید. .SH "پیکربندی (CONFIGURATION)" محتوای پرونده .I hp.conf فهرستی از گزینه‌ها و نام‌های دستگاه متناظر با اسکنرهای HP ScanJet است. خطوط خالی و خطوطی که با علامت هش (#) آغاز می‌شوند، نادیده گرفته می‌شوند. برای جزئیات در مورد اینکه چه چیزی یک نام دستگاه معتبر را تشکیل می‌دهد، به .BR sane\-scsi (5) و .BR sane\-usb (5) مراجعه کنید. .PP گزینه‌های مشخص‌شده پیش از نخستین خطی که حاوی یک نام دستگاه است، مقادیر پیش‌فرض برای همه دستگاه‌ها هستند. گزینه‌های مشخص‌شده در زیر خطی که حاوی نام یک دستگاه است، فقط برای دستگاهی که اخیراً ذکر شده اعمال می‌شوند. .PP گزینه‌های پشتیبانی‌شده عبارتند از .BR connect\-scsi ، .BR connect\-device ، .BR enable\-image\-buffering ، و .BR dumb\-read . .PP گزینه .B connect\-scsi مشخص می‌کند که اسکنر از طریق SCSI به سیستم متصل است. ورودی/خروجی با استفاده از دستورات SCSI انجام می‌شود. این حالت پیش‌فرض است. اما اگر نام دستگاه SCSI شما حاوی "usb"، "uscanner" یا "ugen" باشد، گزینه connect\-scsi باید به صراحت مشخص شود؛ در غیر این صورت فرض می‌شود که اسکنر از طریق USB متصل است. .PP گزینه .B connect\-device مشخص می‌کند که اسکنر از طریق یک دستگاه ویژه به سیستم متصل است. ورودی/خروجی با عملیات‌های .BR read ()/ write "()" روی دستگاه انجام می‌شود. این گزینه باید برای HP ScanJet Plus یا اسکنرهای متصل به USB که از طریق یک دستگاه نام‌گذاری‌شده در دسترس قرار می‌گیرند (مانند .IR /dev/usb/scanner0 ) استفاده شود. برای نام‌های دستگاهی که حاوی "usb"، "uscanner" یا "ugen" هستند، نیازی به تعیین گزینه connect\-device نیست. .PP گزینه .B enable\-image\-buffering تصویر اسکن‌شده را پیش از ارسال به فرانت‌اند در حافظه ذخیره می‌کند. می‌تواند در مواردی که لامپ اسکنر به جلو و عقب حرکت می‌کند استفاده شود. .PP گزینه .B dumb\-read می‌تواند برای دور زدن مشکلات مربوط به خطای "Error during device I/O" استفاده شود. این مشکلات ممکن است با برخی مبدل‌های SCSI به USB یا کارت‌های SCSI برند Buslogic رخ دهد. این گزینه نباید برای دستگاه‌های SCSI که به درستی کار می‌کنند استفاده شود، در غیر این صورت ممکن است راه‌اندازی فرانت‌اندها و تغییر پارامترها کندتر شود. .PP یک پرونده پیکربندی نمونه در زیر نشان داده شده است: .PP .RS .ft CR .nf /dev/scanner # this is a comment /dev/hpscan option connect\-device .fi .ft R .RE .PP .I /dev/scanner معمولاً یک پیوند نمادین به دستگاه واقعی اسکنر SCSI است. .SH "پرونده‌ها (FILES)" .TP .I /etc/sane.d/hp.conf پرونده پیکربندی بک‌اند (همچنین توضیحات .B SANE_CONFIG_DIR در زیر را ببینید). .TP .I /usr/lib/sane/libsane\-hp.a کتابخانه ایستا که این بک‌اند را پیاده‌سازی می‌کند. .TP .I /usr/lib/sane/libsane\-hp.so کتابخانه پویا که این بک‌اند را پیاده‌سازی می‌کند (در سیستم‌هایی که از بارگذاری پویا پشتیبانی می‌کنند موجود است). .TP .I $HOME/.sane/calib-hp:.dat داده‌های کالیبراسیون برای HP PhotoSmart PhotoScanner که پس از کالیبراسیون از اسکنر دریافت می‌شود. اگر بک‌اند در حالت رسانه 'print media' باشد یا حالت رسانه به 'print media' تغییر کند، این داده‌ها در آغاز کار بک‌اند به اسکنر بارگذاری می‌شوند. .SH "محیط (ENVIRONMENT)" .TP .B SANE_CONFIG_DIR این متغیر محیطی فهرستی از شاخه‌هایی را مشخص می‌کند که ممکن است حاوی پرونده پیکربندی باشند. در سیستم‌های NIX*، شاخه‌ها با دونقطه (`:') و در OS/2 با نقطه‌ویرگول (`;') از هم جدا می‌شوند. اگر این متغیر تنظیم نشده باشد، پرونده پیکربندی در دو شاخه پیش‌فرض جستجو می‌شود: نخست، شاخه کاری جاری .RI ( "." ) و سپس در .IR /etc/sane.d . اگر مقدار متغیر محیطی با نویسه جداکننده شاخه خاتمه یابد، شاخه‌های پیش‌فرض پس از شاخه‌هایی که صراحتاً مشخص شده‌اند جستجو می‌شوند. برای نمونه، تنظیم .B SANE_CONFIG_DIR به "/tmp/config:" منجر به جستجوی شاخه‌های .IR "tmp/config" ، .IR "." ، و .I "/etc/sane.d" (به همین ترتیب) خواهد شد. .TP .B SANE_DEBUG_HP اگر کتابخانه با پشتیبانی از اشکال‌زدایی کامپایل شده باشد، این متغیر محیطی سطح اشکال‌زدایی را برای این بک‌اند کنترل می‌کند. برای نمونه، مقدار 128 درخواست چاپ تمامی خروجی‌های اشکال‌زدایی را دارد. مقادیر کوچکتر پرگویی را کاهش می‌دهند. .TP .B SANE_HOME_HP فقط برای OS/2 و به همراه اسکنر HP PhotoSmart PhotoScanner استفاده می‌شود. باید روی شاخه‌ای تنظیم شود که شاخه .I .sane در آن قرار دارد. برای ذخیره و خواندن پرونده کالیبراسیون به کار می‌رود. .TP .B SANE_HP_KEEPOPEN_SCSI .TP .B SANE_HP_KEEPOPEN_USB .TP .B SANE_HP_KEEPOPEN_DEVICE برای هر نوع اتصال (connect\-scsi، connect\-usb، connect\-device) می‌توان مشخص کرد که آیا اتصال به دستگاه باید باز نگه داشته شود ("1") یا خیر ("0"). معمولاً اتصالات پس از انجام یک عملیات بسته می‌شوند. باز نگه داشتن اتصال به دستگاه‌های SCSI می‌تواند در صورتی که اسکنر برای مدتی استفاده نشده باشد، منجر به بروز خطا در ورودی/خروجی دستگاه شود. به طور پیش‌فرض، اتصالات USB باز نگه داشته می‌شوند و سایر اتصالات بسته می‌شوند. .TP .B SANE_HP_RDREDO تعداد دفعات تلاش مجدد برای عملیات خواندن پیش از بازگرداندن خطای EOF را مشخص می‌کند. فقط برای دستگاه‌های غیر SCSI پشتیبانی می‌شود. پیش‌فرض: ۱ بار تلاش مجدد. زمان بین تلاش‌های مجدد ۰.۱ ثانیه است. .SH "اشکالات (BUGS)" .TP .B HP PhotoSmart PhotoScanner در حالت رسانه 'slide' و 'negative'، تفکیک‌پذیری اسکن به مضربی از 300 dpi گرد می‌شود. اسکنر داده‌ها را در سایر تفکیک‌پذیری‌ها به درستی مقیاس‌بندی نمی‌کند. برخی مدل‌های جدیدتر (کد میان‌افزار R030 و بالاتر) از تنظیم سطح کنتراست/شدت نور و نگاشت تن پشتیبانی نمی‌کنند. بک‌اند این مورد را به وسیله نرم‌افزار شبیه‌سازی خواهد کرد، اما تنها برای حالت خاکستری و رنگی ۲۴ بیتی. .TP .B "تغذیه خودکار سند (ADF)" برای استفاده از ADF با .BR xscanimage (1)، ابتدا کاغذ را در ADF قرار داده و سپس گزینه scan source را به 'ADF' تغییر دهید. برای بارگذاری یک برگ دکمه 'change document' را فشار دهید. سپس برای شروع اسکن 'scan' را بزنید. شاید برای اسکن‌های مکرر فشردن 'scan' بدون 'change document' کافی باشد. استفاده از پنجره پیش‌نمایش هنگام کار با ADF توصیه نمی‌شود. تنظیم یک پنجره برای اسکن از ADF در .BR xscanimage (1) پشتیبانی نمی‌شود. .BR xsane (1) را امتحان کنید. .TP .B "کنش‌های بلادرنگ (Immediate actions)" برخی کنش‌ها در .BR xscanimage (1) (مانند unload، select media، calibrate) اثر فوری بر روی اسکنر دارند بدون اینکه اسکنی آغاز شود. این گزینه‌ها نمی‌توانند با .BR scanimage (1) استفاده شوند. .SH "کارهای آینده (TODO)" .TP .B HP PhotoSmart PhotoScanner اسکنرهای PhotoScanner با نسخه میان‌افزار R030 و بالاتر از جدول کنتراست/روشنایی/گاما در میان‌افزار خود پشتیبانی نمی‌کنند. در بک‌اند کنونی این مورد توسط نرم‌افزار روی داده‌های ۲۴ بیتی شبیه‌سازی می‌شود. شبیه‌سازی روی داده‌های ۳۰ بیتی نتایج بهتری به همراه خواهد داشت. .TP .B "عرض داده‌های بیش از ۸ بیت" جدول گامای سفارشی کار نمی‌کند. .TP .B "پشتیبانی از اسکنر موازی" به جز ScanJet Plus که همراه با کارت رابط موازی اختصاصی خود ارائه می‌شد، در حال حاضر تنها مدل‌های HP ScanJet 5100C/5200C پشتیبانی می‌شوند. این اسکنرها از یک مبدل داخلی موازی به SCSI استفاده می‌کنند که توسط درایور ppSCSI پشتیبانی می‌شود (به بالا مراجعه کنید). .SH "همچنین ببینید (SEE ALSO)" .BR sane (7)، .BR sane\-scsi (5)، .BR sane\-usb (5)، .BR scanimage (1)، .BR xscanimage (1) .SH "نویسنده (AUTHOR)" بک‌اند sane\-hp توسط Geoffrey T. Dairiki نوشته شده است. .br پشتیبانی از HP PhotoSmart PhotoScanner توسط Peter Kirchgessner انجام گرفته است.