sane-mustek_pp(5)sane-mustek_pp(5)NAMEsane-mustek_pp - SANE backend for Mustek parallel port
flatbed scanners
DESCRIPTION
The sane-mustek_pp library implements a SANE (Scanner
Access Now Easy) backend that provides access to Mustek
parallel port flatbed scanners and OEM versions.
There are 2 classes of Mustek parallel port scanners: reg-
ular CCD (cold cathode device) scanners and CIS (contact
image sensor) scanners.
Previous versions of this backend only supported CCD type
scanners. Patches for CIS type scanners were available,
but simultaneous support for both types was not possible.
The current version of the driver enables both types to
co-exist. The CIS drivers have been ported to it already,
and work is going on to port the CCD drivers too.
The following scanners might work with this backend:
CCD scanners (currently not hooked up yet)
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 partly
SM 1200 ED Plus 1015 01 partly
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
CIS scanners
Model: ASIC ID: works:
------------------------------ -------
Mustek 600 CP 1015 yes (*)
Mustek 1200 CP 1015 yes
Mustek 1200 CP+ 1015 yes
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
(*) Calibration problems existed with earlier version
of this driver. They seem to be solved now.
(**) Problems have been reported in the past for the
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.
IF YOU HEAR LOUD CLICKING NOISES, IMMEDIATELY
UNPLUG THE SCANNER ! (This holds for any type of
scanner).
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).
Some scanners work faster when EPP/ECP is enabled in the
BIOS.
Note that the backend needs to run as root. To allow user
access to the scanner run the backend through the network
interface (See saned(1) and sane-net(5)). Note also that
the backend does not support parport sharing , i.e. if you
try printing while scanning, your computer may crash. This
backend also conflicts with the sane-musteka4s2 backend.
You can only enable one of them in your dll.conf. However,
you have to enable the backend explicitly in your
dll.conf, just remove the hash mark in the line
"mustek_pp".
DEVICE DEFINITION
This backend allows multiple devices being defined and
configured via the mustek_pp.conf file (even simultane-
ously, provided that they are connected to different par-
allel ports). Please make sure to edit this file before
you use the backend.
A device can be defined as follows:
scanner <name> <address> <driver>
where
<name> is an arbitrary name for the device, optionally
enclosed by double quotes, for instance "LifeTec
9350".
<address> is the port address of the parallel port to
which the device is connected. Known ports are
0x378, 0x278, and 0x3BC. The mapping of parallel
ports (lp0, lp1, and lp2) to these addresses can be
different for different Linux kernel versions. For
instance, if you are using a Kernel 2.2.x or better
and you have only one 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.mod-
ules, /etc/modules.conf and/or /proc/ioports.
<driver> is the driver to use for this device. Currently
available drivers are:
cis600 : for 600 CP & OEM versions
cis1200 : for 1200 CP & OEM versions
cis1200+ : for 1200 CP+ & OEM versions
Choosing the wrong driver can damage your scanner!
Especially, using the 1200CP settings on a 600CP
can be harmful. If the scanner starts making a loud
noice, turn it off immediately !!!
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).
If unsure about the exact model of your OEM ver-
sion, check the optical resolution in the manual or
on the box: the 600CP has a maximum optical resolu-
tion of 300x600 DPI, whereas the 1200CP and 1200CP+
have a maximum optical resolution of 600x1200 DPI.
Examples:
scanner "LifeTec 9350" 0x378 cis1200
scanner Mustek_600CP 0x378 cis600
CONFIGURATION
The contents of the mustek_pp.conf file is a list of
device definitions and device options that correspond to
Mustek scanners. Empty lines and lines starting with a
hash mark (#) are ignored. Options have the following for-
mat:
option <name> [<value>]
Depending on the nature of the option, a value may or may
not be present. Options always apply to the scanner defi-
nition that preceeds them. There are no global options.
Options are also driver-specific: not all drivers support
all possible options.
Common options
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 assumed to be white.
Default value: 127
Minimum: 0
Maximum: 255
Example: option bw 150
CIS driver options
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 certain limits. Note that
CIS scanners are probably temperature sensi-
tive, and that a certain inaccuracy may be hard
to avoid. Differences in offset between runs in
the order of 1 to 2 mm are not unusual.
Default value: 0.0
Minimum: -5.0
Maximum: 5.0
Example: option top_skip -2.5
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 to the start of the scan area
at the fastest possible speed. On some models,
this may not work, resulting in large inaccura-
cies (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 mod-
els for which these inaccuracy problems are
known to occur.
By default, fast skipping is used.
Example: option slow_skip
CCD driver options
To be defined.
A sample configuration file is shown below:
#
# 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
FILES
/usr/freeware/etc/sane.d/mustek_pp.conf
The backend configuration file (see also descrip-
tion of SANE_CONFIG_DIR below).
/usr/freeware/lib32/sane/libsane-mustek_pp.a
The static library implementing this backend.
/usr/freeware/lib32/sane/libsane-mustek_pp.so
The shared library implementing this backend (pre-
sent on systems that support dynamic loading).
ENVIRONMENT
SANE_CONFIG_DIR
This environment variable specifies the list of
directories that may contain the configuration
file. Under UNIX, the directories are separated by
a colon (`:'), under OS/2, they are separated by a
semi-colon (`;'). If this variable is not set, the
configuration file is searched in two default
directories: first, the current working directory
(".") and then in /usr/freeware/etc/sane.d. If the
value of the environment variable ends with the
directory separator character, then the default
directories are searched after the explicitly spec-
ified directories. For example, setting SANE_CON-
FIG_DIR to "/tmp/config:" would result in directo-
ries "tmp/config", ".", and "/usr/free-
ware/etc/sane.d" being searched (in this order).
SANE_DEBUG_MUSTEK_PP
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.
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
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.
level debug output
------- -------------------------------
0 nothing
1 errors
2 warnings
3 things nice to know
4 code flow
5 detailed code flow
6 everything
SEE ALSOsane(7), sane-mustek(5), sane-net(5), saned(1)
For latest bug fixes and information see
http://www.penguin-breeder.org/?page=mustek_pp
For the latest CIS driver versions, see
http://home.tiscalinet.be/EddyDeGreef/
AUTHORS
Jochen Eisinger <jochen.eisinger@gmx.net>
Eddy De Greef <eddy_de_greef@tiscali.be>
BUGS
Too many... please send bug reports to
sane-devel@mostang.com (note that you have to subscribe
first to the list before you can send emails... see
http://www.mostang.com/sane/mail.html)
* 1013 support isn't bullet proofed
* 1505 support isn't even present
* 1015 only works for CCD type 00 & 01 (01 only
bw/grayscale)
BUG REPORTS
If something doesn't work, please contact us (Jochen for
the CCD scanners, Eddy for the CIS scanners). But we need
some information about your scanner to be able to help
you...
SANE version
run "scanimage -V" to determine this
the backend version and your scanner hardware
run "SANE_DEBUG_MUSTEK_PP=128 scanimage -L" as
root. If you don't get any output from the
mustek_pp backend, make sure a line "mustek_pp" is
included into your /usr/free-
ware/etc/sane.d/dll.conf. If your scanner isn't
detected, make sure you've defined the right port
address in your mustek_pp.conf.
the name of your scanner/vendor
also a worthy information. Please also include the
optical resolution and lamp type of your scanner,
both can be found in the manual of your scanner.
any further comments
if you have comments about the documentation (what
could be done better), or you think I should know
something, please include it.
some nice greetings
February 20 2002 sane-mustek_pp(5)