kopia lustrzana https://gitlab.com/sane-project/backends
2007-02-11 Jochen Eisinger <jochen@penguin-breeder.org>
* doc/sane-mustek_pp.man: clean up markup, bug #304392merge-requests/1/head
Jochen Eisinger
rodzic
218a1080d0
commit
78e9962f4b
|
|
@ -1,3 +1,7 @@
|
|||
2007-02-11 Jochen Eisinger <jochen@penguin-breeder.org>
|
||||
|
||||
* doc/sane-mustek_pp.man: clean up markup, bug #304392
|
||||
|
||||
2007-02-11 Henning Meier-Geinitz <henning@meier-geinitz.de>
|
||||
|
||||
* po/sane-backends.pl.po: Polish translation fix (from Jakub
|
||||
|
|
|
|||
|
|
@ -1,4 +1,15 @@
|
|||
.\" t
|
||||
.TH sane-mustek_pp 5 "November 17 2003"
|
||||
.de EX
|
||||
.sp
|
||||
.nf
|
||||
.ft CW
|
||||
..
|
||||
.de EE
|
||||
.ft R
|
||||
.fi
|
||||
.sp
|
||||
..
|
||||
.IX sane-mustek_pp
|
||||
.SH NAME
|
||||
sane-mustek_pp \- SANE backend for Mustek parallel port flatbed scanners
|
||||
|
|
@ -13,20 +24,19 @@ There are 2 classes of Mustek parallel port scanners: regular
|
|||
(cold cathode device) scanners and
|
||||
.B CIS
|
||||
(contact image sensor) scanners.
|
||||
|
||||
.P
|
||||
The current version of this backend supports both CCD type scanners and
|
||||
CIS type scanners.
|
||||
|
||||
.P
|
||||
The following scanners might work with this backend:
|
||||
|
||||
.TP
|
||||
.BR "CCD scanners"
|
||||
.PP
|
||||
.RS
|
||||
.ft CR
|
||||
.nf
|
||||
.SS "CCD scanners"
|
||||
|
||||
.TS
|
||||
lb lb lb lb
|
||||
_ _ _ _
|
||||
l l l l.
|
||||
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
|
||||
|
|
@ -38,23 +48,23 @@ SE 600 SEP 1013 ?? yes
|
|||
MD9848 1015 00 yes
|
||||
Gallery 4800 ???? ?? yes
|
||||
Viviscan Compact II 1013 00 yes
|
||||
.fi
|
||||
.ft R
|
||||
.RE
|
||||
.PP
|
||||
.B CIS scanners
|
||||
.PP
|
||||
.RS
|
||||
.ft CR
|
||||
.nf
|
||||
.TE
|
||||
.SS CIS scanners
|
||||
.TS
|
||||
lb lb lb
|
||||
_ _ _
|
||||
l l l.
|
||||
Model: ASIC ID: works:
|
||||
--------------------- --------- -------
|
||||
Mustek 600 CP & 96 CP 1015 yes (*)
|
||||
Mustek 1200 CP 1015 yes
|
||||
Mustek 1200 CP+ 1015 yes
|
||||
.TE
|
||||
|
||||
.TS
|
||||
lb lb lb
|
||||
_ _ _
|
||||
l l l.
|
||||
OEM versions Original works
|
||||
--------------------- --------- ----------
|
||||
Medion/LifeTec/Tevion
|
||||
MD/LT 9350/9351 1200 CP yes
|
||||
MD/LT 9850/9851 1200 CP maybe (**)
|
||||
|
|
@ -67,11 +77,7 @@ Trust
|
|||
Easy Connect 9600+ 600 CP yes
|
||||
Cybercom
|
||||
9352 1200 CP yes (***)
|
||||
.fi
|
||||
.ft R
|
||||
.RE
|
||||
|
||||
.PP
|
||||
.TE
|
||||
.HP
|
||||
(*) Calibration problems existed with earlier version of
|
||||
this driver. They seem to be solved now.
|
||||
|
|
@ -80,15 +86,13 @@ this driver. They seem to be solved now.
|
|||
MD/LT9850 type (striped scans, head moving in wrong
|
||||
direction at some resolutions). It is not known whether
|
||||
the current version of the driver still has these problems.
|
||||
.br
|
||||
.PP
|
||||
.B IF YOU HEAR LOUD CLICKING NOISES, IMMEDIATELY UNPLUG THE SCANNER !
|
||||
(This holds for any type of scanner).
|
||||
.HP
|
||||
(***) Possibly, the engine_delay parameter has to be set to 1 ms
|
||||
for accurate engine movements.
|
||||
.PP
|
||||
|
||||
|
||||
Please note that this backend is still under construction. Certain models
|
||||
are currently not supported and some may never be because the communication
|
||||
protocol is still unknown (eg., SE 12000 P).
|
||||
|
|
@ -116,13 +120,12 @@ in the line "mustek_pp".
|
|||
|
||||
.SH "DEVICE DEFINITION"
|
||||
This backend allows multiple devices being defined and configured via the
|
||||
.B
|
||||
mustek_pp.conf
|
||||
.B mustek_pp.conf
|
||||
file (even simultaneously, provided that they are connected to different
|
||||
parallel ports). Please make sure to edit this file
|
||||
.B before
|
||||
you use the backend.
|
||||
|
||||
.PP
|
||||
A device can be defined as follows:
|
||||
.PP
|
||||
.RS
|
||||
|
|
@ -134,7 +137,6 @@ where
|
|||
.B <name>
|
||||
is an arbitrary name for the device, optionally enclosed by double quotes,
|
||||
for instance "LifeTec 9350".
|
||||
.PP
|
||||
.HP
|
||||
.B <port name>
|
||||
is the name of the parallel port to which the device is connected. In case
|
||||
|
|
@ -146,7 +148,7 @@ valid port names are
|
|||
.BR parport1 ,
|
||||
and
|
||||
.BR parport2 .
|
||||
|
||||
.PP
|
||||
In case the backend is configured for raw IO
|
||||
.I (old
|
||||
.IR setup) ,
|
||||
|
|
@ -162,7 +164,7 @@ parallel port, this port is named lp0 regardless of the base address. However,
|
|||
this backend requires the base address of your port. If you are not sure which
|
||||
port your scanner is connected to, have a look at your /etc/conf.modules,
|
||||
/etc/modules.conf and/or /proc/ioports.
|
||||
|
||||
.PP
|
||||
If you are unsure which port to use, you can use the magic value
|
||||
.BR *
|
||||
to probe for your scanner.
|
||||
|
|
@ -182,19 +184,18 @@ is the driver to use for this device. Currently available drivers are:
|
|||
.B Choosing the wrong driver can damage your scanner!
|
||||
.br
|
||||
Especially, using the 1200CP settings on a 600CP can be
|
||||
harmful. If the scanner starts making a loud noice, turn
|
||||
harmful. If the scanner starts making a loud noise, turn
|
||||
it off immediately !!!
|
||||
.br
|
||||
.PP
|
||||
Using the cis600 driver on a 1200CP or a 1200CP+ is probably not
|
||||
dangerous. The cis1200+ driver also works for the 1200CP, and using
|
||||
the cis1200 driver on a 1200CP+ will typically result in scans that
|
||||
cover only half of the width of the scan area (also not dangerous).
|
||||
.br
|
||||
.PP
|
||||
If unsure about the exact model of your OEM version, check the optical
|
||||
resolution in the manual or on the box: the 600CP has a maximum optical
|
||||
resolution of 300x600 DPI, whereas the 1200CP and 1200CP+ have a maximum
|
||||
optical resolution of 600x1200 DPI.
|
||||
|
||||
.PP
|
||||
Examples:
|
||||
.PP
|
||||
|
|
@ -228,11 +229,8 @@ Options always apply to the scanner definition that precedes them. There
|
|||
are no global options. Options are also driver-specific: not all drivers
|
||||
support all possible options.
|
||||
|
||||
.SS Common options
|
||||
.TP
|
||||
.B Common options
|
||||
.RS 4
|
||||
.PP
|
||||
.HP
|
||||
.B bw <value>
|
||||
Black/white discrimination value to be used during lineart scanning. Pixel
|
||||
values below this value are assumed to be black, values above are
|
||||
|
|
@ -243,15 +241,11 @@ Default value: 127
|
|||
Minimum: 0
|
||||
.br
|
||||
Maximum: 255
|
||||
.PP
|
||||
.sp
|
||||
Example: option bw 150
|
||||
.PP
|
||||
.RE
|
||||
|
||||
.SS CIS driver options
|
||||
.TP
|
||||
.B CIS driver options
|
||||
.RS 4
|
||||
.PP
|
||||
.HP
|
||||
.B top_adjust <value>
|
||||
Vertical adjustment of the origin, expressed in millimeter (floating point).
|
||||
This option can be used to calibrate the position of the origin, within
|
||||
|
|
@ -265,9 +259,9 @@ Minimum: -5.0
|
|||
.br
|
||||
Maximum: 5.0
|
||||
.br
|
||||
.PP
|
||||
.sp
|
||||
Example: option top_adjust -2.5
|
||||
.HP
|
||||
.TP
|
||||
.B slow_skip
|
||||
Turns fast skipping to the start of the scan region off. When the region to
|
||||
scan does not start at the origin, the driver will try to move the scanhead
|
||||
|
|
@ -276,11 +270,11 @@ this may not work, resulting in large inaccuracies (up to centimeters).
|
|||
By setting this option, the driver is forced to use normal speed during
|
||||
skipping, which can circumvent the accuracy problems. Currently, there are
|
||||
no models for which these inaccuracy problems are known to occur.
|
||||
.br
|
||||
.sp
|
||||
By default, fast skipping is used.
|
||||
.PP
|
||||
.sp
|
||||
Example: option slow_skip
|
||||
.HP
|
||||
.TP
|
||||
.B engine_delay <value>
|
||||
Under normal circumstances, it is sufficient for the driver to wait for the
|
||||
scanner signaling that the engine is stable, before a new engine command can
|
||||
|
|
@ -293,144 +287,103 @@ can be set. If it is set, the driver waits an additional amount of time after
|
|||
every engine command, equal to the engine_delay parameter, expressed in
|
||||
milliseconds. It practice an engine_delay of 1 ms is usually sufficient. The
|
||||
maximum delay is 100 ms.
|
||||
.br
|
||||
.sp
|
||||
Note that every additional ms of delay can add up to 14 seconds to the total
|
||||
scanning time (highest resolution), so an as small as possible value is
|
||||
preferred.
|
||||
.br
|
||||
.sp
|
||||
Default value: 0
|
||||
.br
|
||||
Minimum: 0
|
||||
.br
|
||||
Maximum: 100
|
||||
.br
|
||||
.PP
|
||||
.sp
|
||||
Example: option engine_delay 1
|
||||
.PP
|
||||
.RE
|
||||
.TP
|
||||
.B CCD driver options
|
||||
.RS 4
|
||||
.HP
|
||||
.SS CCD driver options
|
||||
.TP
|
||||
.B top <value>
|
||||
Number of scanlines to skip to the start of the scan area. The number can
|
||||
be any positive integer. Values known to me are 47 and 56.
|
||||
.br
|
||||
.sp
|
||||
Default value: 47
|
||||
.br
|
||||
Minimum: 0
|
||||
.br
|
||||
Maximum: none
|
||||
.br
|
||||
.PP
|
||||
.sp
|
||||
Example: option top 56
|
||||
.HP
|
||||
.TP
|
||||
.B waitbank <value>
|
||||
The number of usecs to wait for a bank change. You should not touch this
|
||||
value actually. May be any positive integer
|
||||
.br
|
||||
.sp
|
||||
Default value: 700
|
||||
.br
|
||||
Minimum: 0
|
||||
.br
|
||||
Maximum: none
|
||||
.br
|
||||
.PP
|
||||
.sp
|
||||
Example: option waitbank 700
|
||||
.PP
|
||||
.RE
|
||||
|
||||
.PP
|
||||
A sample configuration file is shown below:
|
||||
.PP
|
||||
.RS
|
||||
.EX
|
||||
#
|
||||
.br
|
||||
# LifeTec/Medion 9350 on port 0x378
|
||||
.br
|
||||
#
|
||||
.br
|
||||
scanner "LifeTec 9350" 0x378 cis1200
|
||||
|
||||
.RS 3
|
||||
# Some calibration options (examples!).
|
||||
.br
|
||||
option bw 127
|
||||
.br
|
||||
option top_skip -0.8
|
||||
.RE
|
||||
|
||||
#
|
||||
.br
|
||||
# A Mustek 600CP on port 0x3BC
|
||||
.br
|
||||
#
|
||||
.br
|
||||
scanner "Mustek 600CP" 0x3BC cis600
|
||||
|
||||
.RS 3
|
||||
# Some calibration options (examples!).
|
||||
.br
|
||||
option bw 120
|
||||
.br
|
||||
option top_skip 1.2
|
||||
.RE
|
||||
|
||||
#
|
||||
.br
|
||||
# A Mustek 1200CP+ on port 0x278
|
||||
.br
|
||||
#
|
||||
.br
|
||||
scanner "Mustek 1200CP plus" 0x278 cis1200+
|
||||
|
||||
.RS 3
|
||||
# Some calibration options (examples!).
|
||||
.br
|
||||
option bw 130
|
||||
.br
|
||||
option top_skip 0.2
|
||||
.RE
|
||||
|
||||
#
|
||||
.br
|
||||
# A Mustek 600 III EPP on port parport0
|
||||
.br
|
||||
#
|
||||
.br
|
||||
scanner "Mustek 600 III EPP" parport0 ccd300
|
||||
|
||||
.RS 3
|
||||
# Some calibration options (examples!).
|
||||
.br
|
||||
option bw 130
|
||||
.br
|
||||
option top 56
|
||||
.RE
|
||||
.RE
|
||||
.EE
|
||||
|
||||
.SH GLOBAL OPTIONS
|
||||
.PP
|
||||
You can control the overall behaviour of the mustek_pp backend by global
|
||||
options which precede any scanner definition in the mustek_pp.conf file.
|
||||
.br
|
||||
.sp
|
||||
Currently, there is only one global option:
|
||||
|
||||
.SS Global options
|
||||
.TP
|
||||
.B Global options
|
||||
.RS 4
|
||||
.PP
|
||||
.HP
|
||||
.B no_epp
|
||||
Disable parallel port mode EPP: works around a known bug in the Linux parport
|
||||
code. Enable this option, if the backend hangs when trying to access the
|
||||
parallel port in EPP mode.
|
||||
.br
|
||||
.sp
|
||||
Default value: use EPP
|
||||
.PP
|
||||
.sp
|
||||
Example: option no_epp
|
||||
.PP
|
||||
.RE
|
||||
|
||||
.SH FILES
|
||||
.TP
|
||||
|
|
@ -467,13 +420,12 @@ If the library was compiled with debug support enabled, this
|
|||
environment variable controls the debug level for this backend. E.g.,
|
||||
a value of 128 requests all debug output to be printed. Smaller
|
||||
levels reduce verbosity.
|
||||
|
||||
.PP
|
||||
.RS
|
||||
.ft CR
|
||||
.nf
|
||||
.sp
|
||||
.TS
|
||||
lb lb;
|
||||
l l.
|
||||
level debug output
|
||||
------- ------------------------------
|
||||
- -
|
||||
0 nothing
|
||||
1 errors
|
||||
2 warnings & minor errors
|
||||
|
|
@ -481,22 +433,18 @@ level debug output
|
|||
4 debug information
|
||||
5 code flow (not supported yet)
|
||||
6 special debug information
|
||||
.fi
|
||||
.ft R
|
||||
.RE
|
||||
.PP
|
||||
.TE
|
||||
.TP
|
||||
.B SANE_DEBUG_SANEI_PA4S2
|
||||
This variable sets the debug level for the SANE interface for the Mustek
|
||||
chipset A4S2. Note that enabling this will spam your terminal with some
|
||||
million lines of debug output.
|
||||
|
||||
.PP
|
||||
.RS
|
||||
.ft CR
|
||||
.nf
|
||||
.sp
|
||||
.TS
|
||||
lb lb;
|
||||
l l.
|
||||
level debug output
|
||||
------- -------------------------------
|
||||
- -
|
||||
0 nothing
|
||||
1 errors
|
||||
2 warnings
|
||||
|
|
@ -504,12 +452,7 @@ level debug output
|
|||
4 code flow
|
||||
5 detailed code flow
|
||||
6 everything
|
||||
.fi
|
||||
.ft R
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.PP
|
||||
.TE
|
||||
.SH "SEE ALSO"
|
||||
sane(7), sane-mustek(5), sane-net(5), saned(8), sane-find-scanner(1)
|
||||
|
||||
|
|
@ -522,16 +465,16 @@ For additional information on the CIS driver, see
|
|||
.I http://home.scarlet.be/eddy_de_greef/
|
||||
|
||||
.SH AUTHORS
|
||||
Jochen Eisinger <jochen.eisinger@gmx.net>
|
||||
.br
|
||||
.nf
|
||||
Jochen Eisinger <jochen at penguin-breeder dot org>
|
||||
Eddy De Greef <eddy_de_greef at scarlet dot be>
|
||||
.fi
|
||||
|
||||
.SH BUGS
|
||||
Too many... please send bug reports to
|
||||
.I sane-devel@lists.alioth.debian.org
|
||||
(note that you have to subscribe first to the list before you can send
|
||||
emails... see http://www.sane-project.org/mailing-lists.html)
|
||||
.PP
|
||||
|
||||
.SH BUG REPORTS
|
||||
If something doesn't work, please contact us (Jochen for the CCD scanners,
|
||||
|
|
@ -557,4 +500,3 @@ if you have comments about the documentation (what could be done better), or you
|
|||
think I should know something, please include it.
|
||||
.TP
|
||||
.I some nice greetings
|
||||
.
|
||||
|
|
|
|||
Ładowanie…
Reference in New Issue