466 lines
12 KiB
HTML
466 lines
12 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of sane-microtek2</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>sane-microtek2</H1>
|
|
Section: SANE Scanner Access Now Easy (5)<BR>Updated: 13 Jul 2008<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
sane-microtek2 - SANE backend for Microtek scanners with SCSI-2 command set
|
|
<A NAME="lbAC"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
The
|
|
<B>sane-microtek2</B>
|
|
|
|
library implements a SANE (Scanner Access Now Easy) backend that
|
|
provides access to Microtek scanners with a SCSI-2 command set.
|
|
This backend can be considered alpha to beta. Some scanner models are reported
|
|
to work well, others not. New development versions of this backend can be
|
|
obtained from
|
|
<B><A HREF="http://karstenfestag.gmxhome.de">http://karstenfestag.gmxhome.de</A></B>
|
|
|
|
<P>
|
|
|
|
There exists a different backend for Microtek scanners with SCSI-1 command
|
|
set.
|
|
Refer to <A HREF="/cgi-bin/man/man2html?5+sane-microtek">sane-microtek</A>(5) for details.
|
|
<P>
|
|
|
|
And there is work in progress for the ScanMaker 3600.
|
|
See
|
|
<B><A HREF="http://sourceforge.net/projects/sm3600">http://sourceforge.net/projects/sm3600</A></B>
|
|
|
|
<P>
|
|
|
|
At present, the following scanners are known positively to work with this
|
|
backend:
|
|
<P>
|
|
|
|
|
|
<PRE>
|
|
Vendor Product id Remark
|
|
--------------------------------------------------------------------
|
|
Microtek E3+ Parport and SCSI
|
|
Microtek X6 SCSI
|
|
Microtek X6EL SCSI
|
|
Microtek X6USB USB
|
|
Microtek ScanMaker V300 Parport and SCSI
|
|
Microtek ScanMaker V310 Parport and SCSI
|
|
Microtek ScanMaker V600 Parport and SCSI
|
|
Microtek ScanMaker 330 SCSI
|
|
Microtek ScanMaker 630 SCSI
|
|
Microtek ScanMaker 636 SCSI
|
|
Microtek ScanMaker 9600XL SCSI; only flatbed mode?
|
|
Microtek Phantom 330CX Parport
|
|
Microtek SlimScan C3 Parport
|
|
Microtek SlimScan C6 USB
|
|
Microtek Phantom 636 SCSI
|
|
Microtek Phantom 636CX Parport
|
|
Microtek V6USL SCSI and USB
|
|
Microtek V6UPL USB; not stable
|
|
Microtek X12USL SCSI; only 8bit color, work in progress
|
|
Vobis HighScan SCSI (E3+ based models)
|
|
Scanport SQ300 Parport?
|
|
Scanport SQ4836 SCSI
|
|
Scanpaq SQ2030 Parport
|
|
</PRE>
|
|
|
|
|
|
<P>
|
|
|
|
Additional information can be found at
|
|
<B><A HREF="http://www.sane-project.org/">http://www.sane-project.org/</A></B>.
|
|
|
|
<P>
|
|
|
|
If you own a Microtek scanner other than the ones listed above,
|
|
it may or may not work with SANE! Because equal scanners are sold under
|
|
different names in different countries your model may be equivalent to one of
|
|
the above.
|
|
<P>
|
|
|
|
The parport scanners work with the ppscsi + onscsi kernel modules. See
|
|
<I><A HREF="http://cyberelk.net/tim/parport/ppscsi.html">http://cyberelk.net/tim/parport/ppscsi.html</A></I>
|
|
|
|
and
|
|
<I><A HREF="http://penguin-breeder.org/kernel/download/">http://penguin-breeder.org/kernel/download/</A></I>.
|
|
|
|
<P>
|
|
<P>
|
|
|
|
The USB scanners work with the microtek kernel module. You may have to add the
|
|
vendor and model codes to microtek.c if they aren't yet listed there.
|
|
<P>
|
|
|
|
Both parport and USB scanners need the generic SCSI support, so check if you
|
|
have loaded the scsi_mod and sg modules!
|
|
<P>
|
|
|
|
If you try your scanner for the first time keep an eye on it. If it gets
|
|
commands that it doesn't understand the scanhead may go beyond the scan area.
|
|
The scanner then makes strange noises. In this case immediately switch off
|
|
the scanner or disconnect its power cable to prevent damages!
|
|
<P>
|
|
|
|
If your scanner is a different one than the models mentioned above and it is
|
|
working please tell the author about it. It would be nice if you add a logfile
|
|
to this information (creation of the logfile: see below).
|
|
<P>
|
|
|
|
If your scanner is not working properly you also should create a logfile and
|
|
send it to the author. He will use the information to improve the backend and
|
|
possibly make your scanner work.
|
|
<P>
|
|
|
|
<BR>
|
|
|
|
How to create the logfile?
|
|
<DL COMPACT>
|
|
<DT id="1">- put the line<DD>
|
|
<BR>
|
|
|
|
"option dump 2" into your
|
|
<I>microtek2.conf</I>
|
|
|
|
file or change the existing "option dump" to "2"
|
|
<DT id="2">- in a terminal (bash) type<DD>
|
|
<BR>
|
|
|
|
"export SANE_DEBUG_MICROTEK2=30" and then
|
|
<BR>
|
|
|
|
"scanimage -l0 -t0 -x100 -y20 2>scan.log >sout.pnm"
|
|
<BR>
|
|
|
|
You get two files: scan.log contains the logfile and sout.pnm the scanned
|
|
image (if there was scanned something). Zip them before sending.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>FRONTEND OPTIONS</H2>
|
|
|
|
This backend dynamically enables the options for the frontend, that are
|
|
supported by the scanner in dependence of the scanning-mode and other
|
|
options.
|
|
Not supported options are disabled.
|
|
<P>
|
|
|
|
The following options are supported by the Microtek2-driver:
|
|
<P>
|
|
|
|
Color, grayscale, halftone and lineart scans.
|
|
<P>
|
|
|
|
Highlight, midtone, shadow, contrast, brightness, exposure time control,
|
|
gamma correction, threshold (dependent of the scan mode and the scanner
|
|
capabilities)
|
|
<P>
|
|
|
|
Transparency media adapter, automatic document feeder
|
|
<P>
|
|
|
|
Additional options can be enabled or disabled in the
|
|
<I>microtek2.conf</I>
|
|
|
|
file. See the configuration section of this manpage.
|
|
<P>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>DEVICE NAMES</H2>
|
|
|
|
This backend expects device names of the form:
|
|
<P>
|
|
|
|
<DL COMPACT><DT id="3"><DD>
|
|
<I>special</I>
|
|
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
Where
|
|
<I>special</I>
|
|
|
|
is the UNIX path-name for the special device that corresponds to the
|
|
scanner. The special device name must be a generic SCSI device or a
|
|
symlink to such a device. Under Linux, such a device name could be
|
|
<I>/dev/sga</I>
|
|
|
|
or
|
|
<I>/dev/sge</I>
|
|
|
|
for example.
|
|
<A NAME="lbAF"> </A>
|
|
<H2>CONFIGURATION</H2>
|
|
|
|
The configuration file for this backend resides in
|
|
<I>@CONFIGDIR@/microtek2.conf</I>.
|
|
|
|
<P>
|
|
Its contents is a list of device names that correspond to Microtek
|
|
scanners with SCSI-2 interface. Empty lines and lines starting with
|
|
a hash mark (#) are ignored.
|
|
<P>
|
|
|
|
The configuration file may also contain options. Global options that are valid
|
|
for all devices are placed above the device names. Device-specific options
|
|
are
|
|
placed under the device name. Note that, except for option dump <n> and
|
|
option strip-height <n>, the entry in the microtek2.conf file only enables
|
|
the corresponding option for being showed in the frontend. There, in the
|
|
frontend, you can switch the options on and off.
|
|
Currently the following options are supported:
|
|
<P>
|
|
|
|
<DL COMPACT><DT id="4"><DD>
|
|
option dump <n>
|
|
<BR>
|
|
|
|
option strip-height <n>
|
|
<BR>
|
|
|
|
option no-backtrack-option <on/off>
|
|
<BR>
|
|
|
|
option lightlid-35 <on/off>
|
|
<BR>
|
|
|
|
option toggle-lamp <on/off>
|
|
<BR>
|
|
|
|
option lineart-autoadjust <on/off>
|
|
<BR>
|
|
|
|
option backend-calibration <on/off>
|
|
<BR>
|
|
|
|
option colorbalance-adjust <on/off>
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
<I>option dump <n></I>
|
|
|
|
enables printing of additional information about the SCSI commands that are
|
|
sent to the scanner to stderr. This option is primarily useful for debugging
|
|
purpose. This option has to be a global option and is best placed at the top
|
|
of the
|
|
<I>microtek2.conf</I>
|
|
|
|
file.
|
|
<P>
|
|
|
|
If n=1 the contents of the command blocks
|
|
and the results for the INQUIRY and READ SCANNER ATTRIBUTES command are
|
|
printed to stderr.
|
|
<P>
|
|
|
|
If n=2 the contents of the command blocks for all other SCSI commands are
|
|
printed to stderr, too. If n=3 the contents of the gamma table is
|
|
printed, too. If n=4 all scan data is additionally printed to stderr.
|
|
<P>
|
|
|
|
The default is n=1.
|
|
<P>
|
|
|
|
<I>option strip-height <n></I>
|
|
|
|
, where <n> is a floating point number, limits the amount of data that is
|
|
read from the scanner with one read command.
|
|
The unit is inch and <n> defaults to 1.0, if this option is not set in the
|
|
configuration file. If less than <n> inch of data fit into the SCSI buffer,
|
|
then the smaller value is used and this option has no effect.
|
|
<P>
|
|
|
|
If your system has a big SCSI buffer and you want to make use of the whole
|
|
buffer, increase the value for <n>. For example, if <n> is set to 14.0,
|
|
no restrictions apply for scanners with a letter, legal or A4 sized scan area.
|
|
<P>
|
|
|
|
<P>
|
|
|
|
The following options enable or disable additional frontend options. If an
|
|
option is set to <on> an appropriate option will appear in the frontend.
|
|
<P>
|
|
|
|
<I>option no-backtrack-option <on/off></I>
|
|
|
|
prevents the scanner head from moving backwards between the read commands.
|
|
This speeds up scanning. Try it.
|
|
<P>
|
|
|
|
<I>option lightlid-35 <on/off></I>
|
|
|
|
If you use the LightLid-35 transparency adapter you get an advanced
|
|
option which switches off the flatbed lamp during the scan.
|
|
<P>
|
|
|
|
<I>option toggle-lamp <on/off></I>
|
|
|
|
You get a button in the frontend where you can switch on and off the flatbed
|
|
lamp.
|
|
<P>
|
|
|
|
<I>option lineart-autoadjust <on/off></I>
|
|
|
|
You can tell the backend to try to determine a good value for the lineart
|
|
threshold.
|
|
<P>
|
|
|
|
<I>option backend-calibration <on/off></I>
|
|
|
|
Some scanners (e.g. Phantom 330CX and 636CX) need to have calibrated the data
|
|
by the backend. Try this option if you see vertical stripes in your pictures.
|
|
<P>
|
|
|
|
<I>option colorbalance-adjust <on/off></I>
|
|
|
|
Some scanners (e.g. Phantom 330CX and 636CX) need to have corrected
|
|
the color balance. If this option is enabled you get advanced options
|
|
where you can balance the colors. And you will have a button
|
|
to use the values that the firmware of the scanner provides.
|
|
<P>
|
|
|
|
A sample configuration file is shown below:
|
|
<P>
|
|
|
|
<DL COMPACT><DT id="5"><DD>
|
|
option dump 1
|
|
<BR>
|
|
|
|
option strip-height 1.0
|
|
<BR>
|
|
|
|
/dev/scanner
|
|
<BR>
|
|
|
|
option no-backtrack-option on
|
|
<BR>
|
|
|
|
# this is a comment
|
|
<BR>
|
|
|
|
/dev/sge
|
|
<BR>
|
|
|
|
option lightlid-35 on
|
|
</DL>
|
|
|
|
<P>
|
|
This backend also supports the new configuration file format which makes
|
|
it easier to detect scanners under Linux. If you have only one scanner it
|
|
would be best to use the following configuration file for this backend:
|
|
<P>
|
|
|
|
<DL COMPACT><DT id="6"><DD>
|
|
option dump 1
|
|
<BR>
|
|
|
|
option strip-height 14.0
|
|
<BR>
|
|
|
|
option no-backtrack-option on
|
|
<BR>
|
|
|
|
option backend-calibration on
|
|
<BR>
|
|
|
|
option lightlid-35 on
|
|
<BR>
|
|
|
|
option toggle-lamp on
|
|
<BR>
|
|
|
|
option lineart-autoadjust on
|
|
<BR>
|
|
|
|
option colorbalance-adjust off
|
|
<BR>
|
|
|
|
scsi * * Scanner
|
|
</DL>
|
|
|
|
<P>
|
|
In this case all SCSI-Scanners should be detected automatically because of the
|
|
<P>
|
|
|
|
scsi * * Scanner
|
|
<P>
|
|
|
|
line.
|
|
<P>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="7"><I>@CONFIGDIR@/microtek2.conf</I>
|
|
|
|
<DD>
|
|
The backend configuration file.
|
|
<DT id="8"><I>@LIBDIR@/libsane-microtek2.a</I>
|
|
|
|
<DD>
|
|
The static library implementing this backend.
|
|
<DT id="9"><I>@LIBDIR@/libsane-microtek2.so</I>
|
|
|
|
<DD>
|
|
The shared library implementing this backend (present on systems that
|
|
support dynamic loading).
|
|
</DL>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>ENVIRONMENT</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="10"><B>SANE_DEBUG_MICROTEK2</B>
|
|
|
|
<DD>
|
|
If the library was compiled with debug support enabled, this
|
|
environment variable controls the debug level for this backend. E.g.,
|
|
a value of 255 requests all debug output to be printed. Smaller
|
|
levels reduce verbosity. To see error messages on stderr set
|
|
SANE_DEBUG_MICROTEK2 to 1 (Remark: The whole debugging levels should
|
|
be better revised).
|
|
<BR>
|
|
|
|
E.g. just say:
|
|
<BR>
|
|
|
|
export SANE_DEBUG_MICROTEK2=128
|
|
</DL>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<A HREF="/cgi-bin/man/man2html?5+sane-scsi">sane-scsi</A>(5), <A HREF="/cgi-bin/man/man2html?7+sane">sane</A>(7)
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>AUTHORS</H2>
|
|
|
|
Bernd Schroeder (not active anymore)
|
|
<BR>
|
|
|
|
Karsten Festag <A HREF="mailto:karsten.festag@gmx.de">karsten.festag@gmx.de</A>
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="11"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="12"><A HREF="#lbAC">DESCRIPTION</A><DD>
|
|
<DT id="13"><A HREF="#lbAD">FRONTEND OPTIONS</A><DD>
|
|
<DT id="14"><A HREF="#lbAE">DEVICE NAMES</A><DD>
|
|
<DT id="15"><A HREF="#lbAF">CONFIGURATION</A><DD>
|
|
<DT id="16"><A HREF="#lbAG">FILES</A><DD>
|
|
<DT id="17"><A HREF="#lbAH">ENVIRONMENT</A><DD>
|
|
<DT id="18"><A HREF="#lbAI">SEE ALSO</A><DD>
|
|
<DT id="19"><A HREF="#lbAJ">AUTHORS</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:06:05 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|