.TH sane\-mustek_pp 5 "13 Jul 2008" .de EX .sp .nf .ft CW .. .de EE .ft R .fi .sp .. .IX sane\-mustek_pp .SH "نام (NAME)" sane\-mustek_pp \- بک‌اند SANE برای اسکنرهای تخت درگاه موازی Mustek .SH "توضیحات (DESCRIPTION)" کتابخانهٔ .B sane\-mustek_pp یک بک‌اند SANE (Scanner Access Now Easy) را پیاده‌سازی می‌کند که دسترسی به اسکنرهای تخت درگاه موازی Mustek و نسخه‌های OEM را فراهم می‌سازد. دو دسته از اسکنرهای درگاه موازی Mustek وجود دارند: اسکنرهای معمولی .B CCD (دستگاه کاتد سرد) و اسکنرهای .B CIS (حسگر تماسی تصویر). .P نسخهٔ فعلی این بک‌اند هم از اسکنرهای نوع CCD و هم از اسکنرهای نوع CIS پشتیبانی می‌کند. .P اسکنرهای زیر ممکن است با این بک‌اند کار کنند: .SS "اسکنرهای CCD" .EX Model: ASIC ID: CCD Type: works: -------------------------------------------------------------- SE 6000 P 1013 00 yes SM 4800 P 1013/1015 04/01 yes SE 1200 ED Plus 1015 01 no SM 1200 ED Plus 1015 01 no SE 12000 P 1505 05 no 600 III EP Plus 1013/1015 00/01 yes SE 600 SEP 1013 ?? yes 600 II EP ???? ?? no MD9848 1015 00 yes Gallery 4800 ???? ?? yes Viviscan Compact II 1013 00 yes .EE .SS "اسکنرهای CIS" .EX Model: ASIC ID: works: ----------------------------------------------- Mustek 600 CP & 96 CP 1015 yes (*) Mustek 1200 CP 1015 yes Mustek 1200 CP+ 1015 yes .EE .EX OEM versions Original works -------------------------------------------------- Medion/LifeTec/Tevion MD/LT 9350/9351 1200 CP yes MD/LT 9850/9851 1200 CP maybe (**) MD/LT 9858 1200 CP probably MD/LT 9890/9891 1200 CP yes Targa Funline TS12EP 1200 CP yes Funline TS6EP 600 CP yes Trust Easy Connect 9600+ 600 CP yes Cybercom 9352 1200 CP yes (***) .EE .HP (*) مشکلات کالیبراسیون در نسخه‌های قبلی این درایور وجود داشت. اکنون به نظر می‌رسد حل شده‌اند. .HP (**) مشکلاتی در گذشته برای نوع MD/LT9850 گزارش شده بود (اسکن‌های خط‌خطی، حرکت هد در جهت اشتباه در برخی تفکیک‌پذیری‌ها). مشخص نیست که آیا نسخهٔ فعلی درایور همچنان این مشکلات را دارد یا خیر. .PP .B در صورت شنیدن صداهای بلند تق‌تق، فوراً اسکنر را از برق بکشید! (این نکته برای هر نوع اسکنری صادق است). .HP (***) احتمالاً برای حرکات دقیق موتور، پارامتر engine_delay باید روی 1 میلی‌ثانیه تنظیم شود. .PP لطفاً توجه داشته باشید که این بک‌اند هنوز در حال توسعه است. مدل‌های خاصی در حال حاضر پشتیبانی نمی‌شوند و ممکن است برخی هرگز پشتیبانی نشوند زیرا پروتکل ارتباطی هنوز ناشناخته است (به عنوان مثال، SE 12000 P). .PP برخی اسکنرها زمانی که .B EPP/ECP در BIOS فعال باشد سریع‌تر کار می‌کنند. با این حال حالت EPP ممکن است در برخی سیستم‌های لینوکس منجر به قفل سخت‌افزاری (hard-lock) شود. اگر این اتفاق برای شما رخ داد، می‌توانید ECP/EPP را در BIOS خود غیرفعال کنید یا آن را در خود بک‌اند غیرفعال سازید (گزینه‌های سراسری را ببینید). .PP توجه داشته باشید که در صورت کامپایل با پشتیبانی از libieee1284، بک‌اند باید به عنوان ریشه (root) اجرا شود یا مجوزهای دسترسی مناسب به .I /dev/parport* داشته باشد. برای اجازه دسترسی کاربر به اسکنر، بک‌اند را از طریق رابط شبکه اجرا کنید (نگاه کنید به .BR saned (8) و .BR sane\-net (5)). همچنین توجه داشته باشید که بک‌اند از .IR "اشتراک‌گذاری درگاه موازی (parport sharing)" پشتیبانی .I نمی‌کند ، یعنی اگر هنگام اسکن سعی کنید چاپ کنید، ممکن است کامپیوتر شما از کار بیفتد. برای فعال‌سازی اشتراک‌گذاری parport، باید .BR libieee1284 (3) را در زمان کامپایل فعال کنید. همچنین ممکن است نیاز باشد بک‌اند را به‌طور صریح در فایل .IR dll.conf خود فعال کنید. تنها کافی است علامت مربع (#) را در خط "mustek_pp" بردارید. .SH "تعریف دستگاه (DEVICE DEFINITION)" این بک‌اند اجازه می‌دهد چندین دستگاه از طریق فایل .I mustek_pp.conf تعریف و پیکربندی شوند (حتی به‌طور هم‌زمان، به شرطی که به درگاه‌های موازی مختلف متصل باشند). لطفاً اطمینان حاصل کنید که این فایل را .B قبل از استفاده از بک‌اند ویرایش کرده‌اید. .PP یک دستگاه می‌تواند به شکل زیر تعریف شود: .PP .RS .I scanner .RE .PP که در آن: .HP .B یک نام دلخواه برای دستگاه است که اختیاری در گیومه دوتایی قرار می‌گیرد، به عنوان مثال "LifeTec 9350". .HP .B نام درگاه موازی است که دستگاه به آن متصل شده است. در صورتی که از libieee1284 برای ارتباط با درگاه استفاده شود .I (راه‌اندازی .IR پیش‌فرض) ، نام‌های معتبر درگاه عبارتند از .BR parport0 ، .BR parport1 ، و .BR parport2 . .PP در صورتی که بک‌اند برای ورودی/خروجی خام پیکربندی شده باشد .I (راه‌اندازی .IR قدیمی) ، به‌جای نام‌های درگاه باید از نشانی‌های درگاه استفاده شود: .BR 0x378 ، .BR 0x278 ، یا .BR 0x3BC . نگاشت درگاه‌های موازی (lp0، lp1 و lp2) به این نشانی‌ها ممکن است در نسخه‌های مختلف هسته لینوکس متفاوت باشد. به عنوان مثال، اگر از هسته 2.2.x یا جدیدتر استفاده می‌کنید و تنها یک درگاه موازی دارید، صرف‌نظر از نشانی پایه، این درگاه lp0 نامیده می‌شود. با این حال، این بک‌اند به نشانی پایهٔ درگاه شما نیاز دارد. اگر مطمئن نیستید اسکنر شما به کدام درگاه متصل است، به .IR /etc/conf.modules ، .I /etc/modules.conf یا .IR /proc/ioports نگاهی بیندازید. .PP اگر در مورد درگاه مورد استفاده نامطمئن هستید، می‌توانید از مقدار جادویی .BR * برای پویش و یافتن اسکنر خود استفاده کنید. .PP .HP .B درایوری است که برای این دستگاه استفاده می‌شود. درایورهای موجود در حال حاضر عبارتند از: .IP .BR cis600 " : برای 600 CP، 96 CP و نسخه‌های OEM" .br .BR cis1200 " : برای 1200 CP و نسخه‌های OEM" .br .BR cis1200+ " : برای 1200 CP+ و نسخه‌های OEM" .br .BR ccd300 " : برای 600 IIIE P و نسخه OEM" .IP .B انتخاب درایور اشتباه می‌تواند به اسکنر شما آسیب برساند! .br به‌ویژه، استفاده از تنظیمات 1200CP روی یک 600CP می‌تواند مخرب باشد. اگر اسکنر شروع به ایجاد صدای بلند کرد، فوراً آن را خاموش کنید!!! .PP استفاده از درایور cis600 روی 1200CP یا 1200CP+ احتمالاً خطرناک نیست. درایور cis1200+ برای 1200CP نیز کار می‌کند، و استفاده از درایور cis1200 روی 1200CP+ معمولاً منجر به اسکن‌هایی می‌شود که تنها نیمی از عرض ناحیه اسکن را پوشش می‌دهند (این هم خطرناک نیست). .PP اگر در مورد مدل دقیق نسخهٔ OEM خود شک دارید، تفکیک‌پذیری نوری را در دفترچه راهنما یا روی جعبه بررسی کنید: مدل 600CP دارای بیشینه تفکیک‌پذیری نوری 300x600 DPI است، در حالی که 1200CP و 1200CP+ دارای بیشینه تفکیک‌پذیری نوری 600x1200 DPI هستند. .PP مثال‌ها: .PP .RS scanner "LifeTec 9350" 0x378 cis1200 .PP scanner Mustek_600CP 0x378 cis600 .PP scanner Mustek_600IIIEP * ccd300 .RE اگر شک دارید که از کدام درگاه باید استفاده کنید، یا اینکه آیا اسکنر شما اصلاً شناسایی شده است یا خیر، می‌توانید از .I sane\-find\-scanner \-p برای بررسی تمام درگاه‌های پیکربندی‌شده استفاده کنید. .SH "پیکربندی (CONFIGURATION)" .PP محتوای فایل .I mustek_pp.conf شامل فهرستی از تعاریف دستگاه و گزینه‌های دستگاه مربوط به اسکنرهای Mustek است. خطوط خالی و خطوطی که با علامت مربع (#) شروع می‌شوند نادیده گرفته می‌شوند. گزینه‌ها دارای قالب زیر هستند: .PP .RS .I option [] .RE .PP بسته به ماهیت گزینه، ممکن است مقدار وجود داشته باشد یا نداشته باشد. گزینه‌ها همیشه برای تعریف اسکنری اعمال می‌شوند که پیش از آن‌ها آمده است. هیچ گزینهٔ سراسری وجود ندارد. گزینه‌ها همچنین مختص درایور هستند: همه درایورها از همه گزینه‌های ممکن پشتیبانی نمی‌کنند. .SS "گزینه‌های مشترک" .TP .B bw مقدار تفکیک سیاه/سفید که هنگام اسکن خطی (lineart) استفاده می‌شود. مقادیر پیکسل کمتر از این مقدار به عنوان سیاه و مقادیر بالاتر به عنوان سفید در نظر گرفته می‌شوند. .br مقدار پیش‌فرض: 127 .br حداقل: 0 .br حداکثر: 255 .sp مثال: option bw 150 .SS "گزینه‌های درایور CIS" .TP .B top_adjust تنظیم عمودی نقطهٔ مبدأ، بیان‌شده بر حسب میلی‌متر (عدد اعشاری). این گزینه می‌تواند برای کالیبره کردن موقعیت مبدأ در محدوده معینی استفاده شود. توجه داشته باشید که اسکنرهای CIS احتمالاً به دما حساس هستند و ممکن است جلوگیری از خطایی معین دشوار باشد. اختلاف در آفست میان دفعات اجرا در حدود 1 تا 2 میلی‌متر غیرمعمول نیست. .br مقدار پیش‌فرض: 0.0 .br حداقل: \-5.0 .br حداکثر: 5.0 .br .sp مثال: option top_adjust \-2.5 .TP .B slow_skip پرش سریع به آغاز ناحیه اسکن را غیرفعال می‌کند. هنگامی که ناحیه اسکن از نقطه مبدأ شروع نمی‌شود، درایور سعی می‌کند هد اسکن را با بیشترین سرعت ممکن به ابتدای ناحیه اسکن منتقل کند. در برخی مدل‌ها این ممکن است کار نکند و منجر به خطاهای بزرگ (تا چندین سانتی‌متر) شود. با تنظیم این گزینه، درایور مجبور می‌شود در حین پرش از سرعت عادی استفاده کند که می‌تواند مشکلات دقت را برطرف کند. در حال حاضر مدلی شناخته نشده است که این مشکلات دقت در آن رخ دهد. .sp به‌طور پیش‌فرض، پرش سریع استفاده می‌شود. .sp مثال: option slow_skip .TP .B engine_delay در شرایط عادی، کافی است درایور قبل از ارسال دستور جدید موتور، منتظر بماند تا اسکنر سیگنال پایدار بودن موتور را اعلام کند. در موارد نادر، برخی اسکنرها و/یا چیپ‌ست‌های درگاه موازی ظاهراً مانع از تشخیص مطمئن وضعیت موتور می‌شوند. در نتیجه، دستورات موتور خیلی زود ارسال می‌شوند و حرکت هد اسکنر غیرقابل اعتماد می‌شود. خطاهایی تا 10 سانتی‌متر در کل دامنه اسکن عمودی گزارش شده است. برای حل این مشکل، گزینه engine_delay می‌تواند تنظیم شود. در صورت تنظیم، درایور پس از هر دستور موتور، به میزان مشخص‌شده در پارامتر engine_delay (بر حسب میلی‌ثانیه) زمان اضافه منتظر می‌ماند. در عمل معمولاً یک engine_delay معادل 1 میلی‌ثانیه کافی است. حداکثر تأخیر 100 میلی‌ثانیه است. .sp توجه داشته باشید که هر میلی‌ثانیه تأخیر اضافی می‌تواند تا 14 ثانیه به کل زمان اسکن (در بالاترین تفکیک‌پذیری) بیفزاید، بنابراین کوچک‌ترین مقدار ممکن ترجیح داده می‌شود. .sp مقدار پیش‌فرض: 0 .br حداقل: 0 .br حداکثر: 100 .sp مثال: option engine_delay 1 .SS "گزینه‌های درایور CCD" .TP .B top تعداد خطوط اسکن که برای رسیدن به ابتدای ناحیه اسکن باید رد شوند. این عدد می‌تواند هر عدد صحیح مثبتی باشد. مقادیر شناخته‌شده 47 و 56 هستند. .sp مقدار پیش‌فرض: 47 .br حداقل: 0 .br حداکثر: ندارد .br .sp مثال: option top 56 .TP .B waitbank تعداد میکروثانیه‌ها برای انتظار تغییر بانک حافظه (bank change). در واقع نباید به این مقدار دست بزنید. می‌تواند هر عدد صحیح مثبتی باشد. .sp مقدار پیش‌فرض: 700 .br حداقل: 0 .br حداکثر: ندارد .sp مثال: option waitbank 700 .PP یک نمونه فایل پیکربندی در زیر نشان داده شده است: .PP .EX # # LifeTec/Medion 9350 on port 0x378 # scanner "LifeTec 9350" 0x378 cis1200 # Some calibration options (examples!). option bw 127 option top_skip \-0.8 # # A Mustek 600CP on port 0x3BC # scanner "Mustek 600CP" 0x3BC cis600 # Some calibration options (examples!). option bw 120 option top_skip 1.2 # # A Mustek 1200CP+ on port 0x278 # scanner "Mustek 1200CP plus" 0x278 cis1200+ # Some calibration options (examples!). option bw 130 option top_skip 0.2 # # A Mustek 600 III EPP on port parport0 # scanner "Mustek 600 III EPP" parport0 ccd300 # Some calibration options (examples!). option bw 130 option top 56 .EE .SH "گزینه‌های سراسری (GLOBAL OPTIONS)" .PP شما می‌توانید رفتار کلی بک‌اند .B sane\-mustek_pp را با گزینه‌های سراسری که پیش از هر تعریف اسکنری در فایل .I mustek_pp.conf قرار می‌گیرند، کنترل کنید. .sp در حال حاضر تنها یک گزینهٔ سراسری وجود دارد: .SS "گزینه‌های سراسری" .TP .B no_epp غیرفعال کردن حالت EPP درگاه موازی: برای دور زدن یک باگ شناخته‌شده در کد parport لینوکس. این گزینه را فعال کنید اگر بک‌اند هنگام تلاش برای دسترسی به درگاه موازی در حالت EPP هنگ می‌کند. .sp مقدار پیش‌فرض: استفاده از EPP .sp مثال: option no_epp .SH "فایل‌ها (FILES)" .TP .I /etc/sane.d/mustek_pp.conf فایل پیکربندی بک‌اند (همچنین توضیحات .B SANE_CONFIG_DIR را در زیر ببینید). .TP .I /usr/lib/sane/libsane\-mustek_pp.a کتابخانهٔ ایستا که این بک‌اند را پیاده‌سازی می‌کند. .TP .I /usr/lib/sane/libsane\-mustek_pp.so کتابخانهٔ پویا که این بک‌اند را پیاده‌سازی می‌کند (موجود در سیستم‌هایی که از بارگذاری پویا پشتیبانی می‌کنند). .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_MUSTEK_PP اگر کتابخانه با فعال بودن پشتیبانی از اشکال‌زدایی کامپایل شده باشد، این متغیر محیطی سطح اشکال‌زدایی را برای این بک‌اند کنترل می‌کند. برای مثال، مقدار 128 درخواست چاپ تمامی خروجی‌های اشکال‌زدایی را می‌دهد. سطوح کوچک‌تر پرگویی خروجی را کاهش می‌دهند. .EX level debug output -------------------------------------- 0 nothing 1 errors 2 warnings & minor errors 3 additional information 4 debug information 5 code flow (not supported yet) 6 special debug information .EE .TP .B SANE_DEBUG_SANEI_PA4S2 این متغیر سطح اشکال‌زدایی را برای رابط SANE مربوط به چیپ‌ست Mustek A4S2 تنظیم می‌کند. توجه داشته باشید که فعال کردن این متغیر، ترمینال شما را با چند میلیون خط خروجی اشکال‌زدایی پر خواهد کرد. .EX level debug output ---------------------------- 0 nothing 1 errors 2 warnings 3 things nice to know 4 code flow 5 detailed code flow 6 everything .EE .SH "همچنین ببینید (SEE ALSO)" .BR sane (7), .BR sane\-mustek (5), .BR sane\-net (5), .BR saned (8), .BR sane\-find\-scanner (1), .BR scanimage (1) .TP برای آخرین اطلاعات و رفع اشکالات ببینید .I http://www.penguin\-breeder.org/sane/mustek_pp .TP برای اطلاعات بیشتر درباره درایور CIS، ببینید .I http://home.scarlet.be/eddy_de_greef .SH "نویسندگان (AUTHORS)" .nf Jochen Eisinger .RI < "jochen at penguin\-breeder dot org" > Eddy De Greef .RI < "eddy_de_greef at scarlet dot be" > .fi .SH "اشکالات (BUGS)" بسیار زیاد... لطفاً گزارش‌های باگ را به .I sane\-devel@alioth-lists.debian.net ارسال کنید (توجه داشته باشید که ابتدا باید در فهرست عضو شوید تا بتوانید ایمیل ارسال کنید... ببینید .IR http://www.sane\-project.org/mailing\-lists.html ). .SH "گزارش اشکالات (BUG REPORTS)" اگر چیزی کار نمی‌کند، لطفاً با ما تماس بگیرید (Jochen برای اسکنرهای CCD و Eddy برای اسکنرهای CIS). اما ما برای اینکه بتوانیم به شما کمک کنیم، به اطلاعاتی درباره اسکنر شما نیاز داریم... .TP .I نسخه SANE دستور .I scanimage \-V را اجرا کنید تا این مورد مشخص شود. .TP .I نسخه بک‌اند و سخت‌افزار اسکنر شما دستور .I SANE_DEBUG_MUSTEK_PP=128 scanimage \-L را به عنوان ریشه (root) اجرا کنید. اگر خروجی‌ای از بک‌اند .BR sane\-mustek_pp دریافت نکردید، مطمئن شوید خط "mustek_pp" در فایل .IR /etc/sane.d/dll.conf شما گنجانده شده باشد. اگر اسکنر شما شناسایی نشد، مطمئن شوید که نشانی درگاه درستی را در فایل .IR mustek_pp.conf خود تعریف کرده‌اید. .TP .I نام اسکنر/سازنده شما نیز اطلاعات ارزشمندی است. لطفاً تفکیک‌پذیری نوری و نوع لامپ اسکنر خود را نیز درج کنید، هر دوی این موارد در دفترچه راهنمای اسکنر شما یافت می‌شوند. .TP .I هرگونه نظرات دیگر اگر نظراتی درباره مستندات دارید (چه چیزی می‌تواند بهتر انجام شود)، یا فکر می‌کنید چیزی هست که باید بدانیم، لطفاً آن را درج کنید.