332 lines
8.4 KiB
HTML
332 lines
8.4 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of sane-mustek_usb</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>sane-mustek_usb</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="ixAAB"></A>
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
sane-mustek_usb - SANE backend for Mustek USB flatbed scanners
|
|
<A NAME="lbAC"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
The
|
|
<B>sane-mustek_usb</B>
|
|
|
|
library implements a SANE (Scanner Access Now Easy) backend that provides
|
|
access to Mustek USB flatbed scanners (including a clone from Trust). At
|
|
present, the following scanners are known to work more or less with this
|
|
backend:
|
|
<P>
|
|
|
|
<DL COMPACT><DT id="1"><DD>
|
|
Mustek 600 CU
|
|
<BR>
|
|
|
|
Mustek 1200 UB
|
|
<BR>
|
|
|
|
Mustek 1200 CU
|
|
<BR>
|
|
|
|
Mustek 1200 CU Plus
|
|
<BR>
|
|
|
|
Trust Compact Scan USB 19200
|
|
<BR>
|
|
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
More details can be found on the Mustek USB backend homepage
|
|
<I><A HREF="http://www.meier-geinitz.de/sane/mustek_usb-backend/">http://www.meier-geinitz.de/sane/mustek_usb-backend/</A></I>.
|
|
|
|
<P>
|
|
|
|
The Mustek BearPaw 1200 and 2400 scanners are supported by the plustek
|
|
backend. See
|
|
<B><A HREF="/cgi-bin/man/man2html?5+sane-plustek">sane-plustek</A></B>(5)
|
|
|
|
for details. The Mustek BearPaw 1200F is supported by the MA-1509 backend. See
|
|
<B><A HREF="/cgi-bin/man/man2html?5+sane-ma1509">sane-ma1509</A></B>(5)
|
|
|
|
for details. Other Mustek USB scanners are supported by the gt68xx backend,
|
|
see
|
|
<B><A HREF="/cgi-bin/man/man2html?5+sane-gt68xx">sane-gt68xx</A></B>(5).
|
|
|
|
<P>
|
|
|
|
This backend can only work with scanners that are already detected by the
|
|
operating system. See
|
|
<B><A HREF="/cgi-bin/man/man2html?5+sane-usb">sane-usb</A></B>(5)
|
|
|
|
for details.
|
|
<P>
|
|
|
|
If you own a Mustek (or Trust) scanner other than the ones listed above that
|
|
works with this backend, please let me know this by sending the scanner's
|
|
exact model name and the USB vendor and device ids (e.g. from
|
|
<I>/proc/bus/usb/devices</I>
|
|
|
|
or syslog) to me.
|
|
<P>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DEVICE NAMES</H2>
|
|
|
|
This backend expects device names of the form:
|
|
<P>
|
|
|
|
<DL COMPACT><DT id="2"><DD>
|
|
<I>special</I>
|
|
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
Where
|
|
<I>special</I>
|
|
|
|
is a path-name for the special device that corresponds to a USB scanner.
|
|
With Linux, such a device name could be
|
|
<I>/dev/usb/scanner0</I>
|
|
|
|
or
|
|
<I>/dev/usbscanner1</I>,
|
|
|
|
for example.
|
|
<P>
|
|
|
|
For FreeBSD use
|
|
<I>/dev/uscanner0</I>.
|
|
|
|
<P>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>CONFIGURATION</H2>
|
|
|
|
The contents of the
|
|
<I>mustek_usb.conf</I>
|
|
|
|
file is a list of options and device names that correspond to Mustek
|
|
USB scanners. Empty lines and lines starting with a hash mark (#) are
|
|
ignored. If a device name is placed in
|
|
<I>mustek_usb.conf</I>,
|
|
|
|
it must be followed by a line containing the keyword
|
|
<B>option</B>
|
|
|
|
and an option specifying the scanner type. The following options can be used:
|
|
<B>600cu</B>,
|
|
|
|
<B>1200cu</B>,
|
|
|
|
<B>1200cu_plus</B>,
|
|
|
|
<B>1200ub</B>.
|
|
|
|
For the Trust Compact Scan USB 19200 use `option 1200ub'.
|
|
<P>
|
|
|
|
Instead of using the device name, the scanner can be autodetected by
|
|
<B>usb vendor_id product_id</B>
|
|
|
|
statements which are already included into
|
|
<I>mustek_usb.conf</I>.
|
|
|
|
This is only supported with Linux 2.4.8 and higher and all systems that
|
|
support libsub. "vendor_id" and "product_id" are hexadecimal numbers that
|
|
identify the scanner. If this doesn't work, a device name and the option
|
|
specifying the scanner type must be placed in
|
|
<I>mustek_usb.conf</I>
|
|
|
|
as described above.
|
|
<P>
|
|
|
|
The global
|
|
<B>option max_block_size</B>
|
|
|
|
can be used to limit the amount of data acquired in one turn from the USB
|
|
system. It may be worth trying, if USB errors occur.
|
|
<P>
|
|
|
|
A sample configuration file is shown below:
|
|
<P>
|
|
|
|
<DL COMPACT><DT id="3"><DD>
|
|
# Comment
|
|
<BR>
|
|
|
|
option max_block_size 1024
|
|
<BR>
|
|
|
|
usb 0x055f 0x0001
|
|
<BR>
|
|
|
|
/dev/usb/scanner0
|
|
<BR>
|
|
|
|
option 600cu
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
The first line is ignored. The second line sets the buffer size to a maximum of
|
|
1024 bytes. The third line tries to autodetect a scanner with vendor id 0x055f
|
|
and product id 0x0001 (Mustek 1200 CU). The fourth line tells the backend to
|
|
attach to
|
|
<I>/dev/usb/scanner0</I>
|
|
|
|
and the fifth line specifies that
|
|
<I>/dev/usb/scanner0</I>
|
|
|
|
is a Mustek 600 CU.
|
|
<A NAME="lbAF"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="4"><I>@CONFIGDIR@/mustek_usb.conf</I>
|
|
|
|
<DD>
|
|
The backend configuration file (see also description of
|
|
<B>SANE_CONFIG_DIR</B>
|
|
|
|
below).
|
|
<DT id="5"><I>@LIBDIR@/libsane-mustek_usb.a</I>
|
|
|
|
<DD>
|
|
The static library implementing this backend.
|
|
<DT id="6"><I>@LIBDIR@/libsane-mustek_usb.so</I>
|
|
|
|
<DD>
|
|
The shared library implementing this backend (present on systems that
|
|
support dynamic loading).
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>ENVIRONMENT</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="7"><B>SANE_CONFIG_DIR</B>
|
|
|
|
<DD>
|
|
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 @CONFIGDIR@. If the value of the
|
|
environment variable ends with the directory separator character, then
|
|
the default directories are searched after the explicitly specified
|
|
directories. For example, setting
|
|
<B>SANE_CONFIG_DIR</B>
|
|
|
|
to "/tmp/config:" would result in directories "tmp/config", ".", and
|
|
"@CONFIGDIR@" being searched (in this order).
|
|
<DT id="8"><B>SANE_DEBUG_MUSTEK_USB</B>
|
|
|
|
<DD>
|
|
If the library was compiled with debug support enabled, this
|
|
environment variable controls the debug level for this backend. Higher
|
|
debug levels increase the verbosity of the output.
|
|
<P>
|
|
|
|
<PRE>
|
|
Value Description
|
|
0 no output
|
|
1 print fatal errors
|
|
2 print important messages
|
|
3 print non-fatal errors and less important messages
|
|
4 print all but debugging messages
|
|
5 print high level debugging messages
|
|
6 print medium level debugging messages
|
|
7 print low level debugging messages
|
|
</PRE>
|
|
|
|
|
|
<P>
|
|
Example:
|
|
export SANE_DEBUG_MUSTEK_USB=4
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?7+sane">sane</A></B>(7),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+sane-usb">sane-usb</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+sane-mustek">sane-mustek</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+sane-mustek_pp">sane-mustek_pp</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+sane-plustek">sane-plustek</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+sane-gt68xx">sane-gt68xx</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+sane-ma1509">sane-ma1509</A></B>(5)
|
|
|
|
<BR>
|
|
|
|
<I>@DOCDIR@/mustek_usb/mustek_usb.CHANGES</I>,
|
|
|
|
<BR>
|
|
|
|
<I>@DOCDIR@/mustek_usb/mustek_usb.TODO</I>
|
|
|
|
<BR>
|
|
|
|
<I><A HREF="http://www.meier-geinitz.de/sane/mustek_usb-backend/">http://www.meier-geinitz.de/sane/mustek_usb-backend/</A></I>
|
|
|
|
<P>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
Henning Meier-Geinitz <<A HREF="mailto:henning@meier-geinitz.de">henning@meier-geinitz.de</A>>
|
|
<BR>
|
|
|
|
This backend is based on the Mustek 1200ub backend from Mustek, maintained by
|
|
Tom Wang.
|
|
<P>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
These devices have a hardware bug: Once data is written to them, they can't be
|
|
reset (toggle = DATA0). That means, any operation that tries to reset the
|
|
device will result in running into timeouts.
|
|
<P>
|
|
In earlier versions this backend failed when it was loaded the second time in
|
|
some configurations. The only choice was to replug the scanner in this case. The
|
|
backend uses a workaround for that bug now but it's only tested on
|
|
Linux. Reports for other operating systems are appreciated.
|
|
<P>
|
|
<P>
|
|
|
|
More detailed bug information is available at the Mustek backend homepage
|
|
<I><A HREF="http://www.meier-geinitz.de/sane/mustek_usb-backend/">http://www.meier-geinitz.de/sane/mustek_usb-backend/</A></I>.
|
|
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="9"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="10"><A HREF="#lbAC">DESCRIPTION</A><DD>
|
|
<DT id="11"><A HREF="#lbAD">DEVICE NAMES</A><DD>
|
|
<DT id="12"><A HREF="#lbAE">CONFIGURATION</A><DD>
|
|
<DT id="13"><A HREF="#lbAF">FILES</A><DD>
|
|
<DT id="14"><A HREF="#lbAG">ENVIRONMENT</A><DD>
|
|
<DT id="15"><A HREF="#lbAH">SEE ALSO</A><DD>
|
|
<DT id="16"><A HREF="#lbAI">AUTHOR</A><DD>
|
|
<DT id="17"><A HREF="#lbAJ">BUGS</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>
|