kopia lustrzana https://gitlab.com/sane-project/website
369 wiersze
16 KiB
HTML
369 wiersze
16 KiB
HTML
<HTML>
|
|
<HEAD>
|
|
<TITLE>sane-mustek_pp.5</TITLE>
|
|
</HEAD>
|
|
<BODY BGCOLOR=#FFFFFF TEXT=#000000><H1 ALIGN=CENTER><IMG SRC="../sane.png" HEIGHT=117 WIDTH=346></H1>
|
|
<H1>sane-mustek_pp.5</H1>
|
|
<HR>
|
|
<PRE>
|
|
<!-- Manpage converted by man2html 3.0.1 -->
|
|
<B><A HREF="sane-mustek_pp.5.html">sane-mustek_pp(5)</A></B> <B><A HREF="sane-mustek_pp.5.html">sane-mustek_pp(5)</A></B>
|
|
|
|
|
|
</PRE>
|
|
<H2>NAME</H2><PRE>
|
|
sane-mustek_pp - SANE backend for Mustek parallel port flatbed scanners
|
|
|
|
|
|
</PRE>
|
|
<H2>DESCRIPTION</H2><PRE>
|
|
The <B>sane-mustek_pp</B> 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: regular <B>CCD</B> (cold
|
|
cathode device) scanners and <B>CIS</B> (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:
|
|
|
|
<B>CCD</B> <B>scanners</B> (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
|
|
|
|
<B>CIS</B> <B>scanners</B>
|
|
|
|
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 resolu-
|
|
tions). It is not known whether the current version of the
|
|
driver still has these problems.
|
|
<B>IF</B> <B>YOU</B> <B>HEAR</B> <B>LOUD</B> <B>CLICKING</B> <B>NOISES,</B> <B>IMMEDIATELY</B> <B>UNPLUG</B> <B>THE</B> <B>SCANNER</B>
|
|
<B>!</B> (This holds for any type of scanner).
|
|
|
|
Please note that this backend is still under construction. Certain mod-
|
|
els are currently not supported and some may never be because the com-
|
|
munication protocol is still unknown (eg., SE 12000 P).
|
|
|
|
Some scanners work faster when <B>EPP/ECP</B> 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 <B><A HREF="saned.1.html">saned(1)</A></B> and
|
|
<B><A HREF="sane-net.5.html">sane-net(5)</A></B>). Note also that the backend <I>does</I> <I>not</I> support <I>parport</I> <I>shar-</I>
|
|
<I>ing</I> <I>,</I> i.e. if you try printing while scanning, your computer may crash.
|
|
This backend also conflicts with the <I>sane-musteka4s2</I> 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".
|
|
|
|
|
|
</PRE>
|
|
<H2>DEVICE DEFINITION</H2><PRE>
|
|
This backend allows multiple devices being defined and configured via
|
|
the <B>mustek_pp.conf</B> file (even simultaneously, provided that they are
|
|
connected to different parallel ports). Please make sure to edit this
|
|
file <B>before</B> you use the backend.
|
|
|
|
A device can be defined as follows:
|
|
|
|
<I>scanner</I> <I><name></I> <I><address></I> <I><driver></I>
|
|
|
|
where
|
|
|
|
<B><name></B> is an arbitrary name for the device, optionally enclosed by dou-
|
|
ble quotes, for instance "LifeTec 9350".
|
|
|
|
<B><address></B> is the port address of the parallel port to which the device
|
|
is connected. Known ports are <B>0x378,</B> <B>0x278,</B> and <B>0x3BC</B>. 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 con-
|
|
nected to, have a look at your /etc/conf.modules, /etc/mod-
|
|
ules.conf and/or /proc/ioports.
|
|
|
|
<B><driver></B> is the driver to use for this device. Currently available
|
|
drivers are:
|
|
|
|
<B>cis600</B> : for 600 CP & OEM versions
|
|
<B>cis1200</B> : for 1200 CP & OEM versions
|
|
<B>cis1200+</B> : for 1200 CP+ & OEM versions
|
|
|
|
<B>Choosing</B> <B>the</B> <B>wrong</B> <B>driver</B> <B>can</B> <B>damage</B> <B>your</B> <B>scanner!</B>
|
|
Especially, using the 1200CP settings on a 600CP can be harmful.
|
|
If the scanner starts making a loud noice, turn it off immedi-
|
|
ately !!!
|
|
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 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.
|
|
|
|
Examples:
|
|
|
|
scanner "LifeTec 9350" 0x378 cis1200
|
|
|
|
scanner Mustek_600CP 0x378 cis600
|
|
|
|
|
|
</PRE>
|
|
<H2>CONFIGURATION</H2><PRE>
|
|
The contents of the <B>mustek_pp.conf</B> 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 fol-
|
|
lowing format:
|
|
|
|
<I>option</I> <I><name></I> <I>[<value>]</I>
|
|
|
|
Depending on the nature of the option, a value may or may not be
|
|
present. Options always apply to the scanner definition that preceeds
|
|
them. There are no global options. Options are also driver-specific:
|
|
not all drivers support all possible options.
|
|
|
|
<B>Common</B> <B>options</B>
|
|
|
|
<B>bw</B> <B><value></B> Black/white discrimination value to be used during lin-
|
|
eart 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
|
|
|
|
<B>CIS</B> <B>driver</B> <B>options</B>
|
|
|
|
<B>top_adjust</B> <B><value></B> 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 sensitive,
|
|
and that a certain inaccuracy may be hard to avoid. Differ-
|
|
ences 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
|
|
|
|
<B>slow_skip</B> 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 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.
|
|
By default, fast skipping is used.
|
|
|
|
Example: option slow_skip
|
|
|
|
<B>CCD</B> <B>driver</B> <B>options</B>
|
|
|
|
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
|
|
|
|
|
|
</PRE>
|
|
<H2>FILES</H2><PRE>
|
|
<I>/usr/local/etc/sane.d/mustek</I><B>_</B><I>pp.conf</I>
|
|
The backend configuration file (see also description of
|
|
<B>SANE_CONFIG_DIR</B> below).
|
|
|
|
<I>/usr/local/lib/sane/libsane-mustek</I><B>_</B><I>pp.a</I>
|
|
The static library implementing this backend.
|
|
|
|
<I>/usr/local/lib/sane/libsane-mustek</I><B>_</B><I>pp.so</I>
|
|
The shared library implementing this backend (present on systems
|
|
that support dynamic loading).
|
|
|
|
|
|
</PRE>
|
|
<H2>ENVIRONMENT</H2><PRE>
|
|
<B>SANE_CONFIG_DIR</B>
|
|
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 config-
|
|
uration file is searched in two default directories: first, the
|
|
current working directory (".") and then in
|
|
/usr/local/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 specified directo-
|
|
ries. For example, setting <B>SANE_CONFIG_DIR</B> to "/tmp/config:"
|
|
would result in directories "tmp/config", ".", and
|
|
"/usr/local/etc/sane.d" being searched (in this order).
|
|
|
|
<B>SANE_DEBUG_MUSTEK_PP</B>
|
|
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
|
|
|
|
<B>SANE_DEBUG_SANEI_PA4S2</B>
|
|
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
|
|
|
|
|
|
</PRE>
|
|
<H2>SEE ALSO</H2><PRE>
|
|
<B><A HREF="sane.7.html">sane(7)</A></B>, <B><A HREF="sane-mustek.5.html">sane-mustek(5)</A></B>, <B><A HREF="sane-net.5.html">sane-net(5)</A></B>, <B><A HREF="saned.1.html">saned(1)</A></B>
|
|
|
|
For latest bug fixes and information see
|
|
<I>http://www.penguin-breeder.org/?page=mustek</I><B>_</B><I>pp</I>
|
|
|
|
For the latest CIS driver versions, see
|
|
<I>http://home.tiscalinet.be/EddyDeGreef/</I>
|
|
|
|
|
|
</PRE>
|
|
<H2>AUTHORS</H2><PRE>
|
|
Jochen Eisinger <jochen.eisinger@gmx.net>
|
|
Eddy De Greef <eddy_de_greef at tiscali dot be>
|
|
|
|
|
|
</PRE>
|
|
<H2>BUGS</H2><PRE>
|
|
Too many... please send bug reports to
|
|
<I>sane-devel@lists.alioth.debian.org</I> (note that you have to subscribe
|
|
first to the list before you can send emails... see
|
|
http://www.sane-project.org/mailing-lists.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)
|
|
|
|
|
|
</PRE>
|
|
<H2>BUG REPORTS</H2><PRE>
|
|
If something doesn't work, please contact us (Jochen for the CCD scan-
|
|
ners, Eddy for the CIS scanners). But we need some information about
|
|
your scanner to be able to help you...
|
|
|
|
<I>SANE</I> <I>version</I>
|
|
run "scanimage -V" to determine this
|
|
|
|
<I>the</I> <I>backend</I> <I>version</I> <I>and</I> <I>your</I> <I>scanner</I> <I>hardware</I>
|
|
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/local/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.
|
|
|
|
<I>the</I> <I>name</I> <I>of</I> <I>your</I> <I>scanner/vendor</I>
|
|
also a worthy information. Please also include the optical reso-
|
|
lution and lamp type of your scanner, both can be found in the
|
|
manual of your scanner.
|
|
|
|
<I>any</I> <I>further</I> <I>comments</I>
|
|
if you have comments about the documentation (what could be done
|
|
better), or you think I should know something, please include
|
|
it.
|
|
|
|
<I>some</I> <I>nice</I> <I>greetings</I>
|
|
|
|
February 20 2002 <B><A HREF="sane-mustek_pp.5.html">sane-mustek_pp(5)</A></B>
|
|
</PRE>
|
|
<HR>
|
|
<ADDRESS>
|
|
Man(1) output converted with
|
|
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
|
|
</ADDRESS>
|
|
</BODY>
|
|
</HTML>
|