346 lines
9.9 KiB
HTML
346 lines
9.9 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of sane-gt68xx</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>sane-gt68xx</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-gt68xx - SANE backend for GT-68XX based USB flatbed scanners
|
|
<A NAME="lbAC"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
The
|
|
<B>sane-gt68xx</B>
|
|
|
|
library implements a SANE (Scanner Access Now Easy) backend that provides
|
|
access to USB flatbed scanners based on the Grandtech GT-6801 and GT-6816
|
|
chips. A list of supported scanners can be found on the gt68xx backend
|
|
homepage:
|
|
<I><A HREF="http://www.meier-geinitz.de/sane/gt68xx-backend/">http://www.meier-geinitz.de/sane/gt68xx-backend/</A></I>.
|
|
|
|
<P>
|
|
|
|
This is BETA software. Especially if you test new or untested scanners, keep
|
|
your hand at the scanner's plug and unplug it, if the head bumps at the end of
|
|
the scan area.
|
|
<P>
|
|
|
|
If you own a scanner other than the ones listed on the gt68xx homepage 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>sane-find-scanner</I>
|
|
|
|
or syslog) to me. Even if the scanner's name is only slightly different from
|
|
the models already listed as supported, please let me know.
|
|
<P>
|
|
|
|
If you own a scanner that isn't detected by the gt68xx backend but has a GT-6801
|
|
or GT-6816 chipset, you can try to add it to the backend. Have a look at the
|
|
following web page:
|
|
<I><A HREF="http://www.meier-geinitz.de/sane/gt68xx-backend/adding.html">http://www.meier-geinitz.de/sane/gt68xx-backend/adding.html</A></I>
|
|
|
|
<P>
|
|
|
|
<A NAME="lbAD"> </A>
|
|
<H2>LIBUSB ISSUES</H2>
|
|
|
|
Please use libusb-0.1.8 or later. Without libusb or with older libusb versions
|
|
all kinds of trouble can be expected. The scanner should be found by
|
|
sane-find-scanner without further actions. For setting permissions and general
|
|
USB information looks at
|
|
<B><A HREF="/cgi-bin/man/man2html?5+sane-usb">sane-usb</A></B>(5).
|
|
|
|
<P>
|
|
|
|
<P>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>FIRMWARE FILE</H2>
|
|
|
|
You need a firmware file for your scanner. That's a small file containing
|
|
software that will be uploaded to the scanner's memory. It's usually named
|
|
*.usb, e.g.
|
|
<I>PS1fw.usb</I>.
|
|
|
|
It comes on the installation CD that was provided by the manufacturer, but it
|
|
may be packaged together with the installation program in an .exe file. For
|
|
Mustek scanners, the file can be downloaded from the gt68xx backend homepage. For
|
|
other scanners, check the CD for .usb files. If you only find *.cab files, try
|
|
cabextract to unpack. If everything else fails, you must install the Windows
|
|
driver and get the firmware from there (usually in the
|
|
<I>windows/system</I>
|
|
|
|
or
|
|
<I>system32</I>
|
|
|
|
directories). Put that firmware file into
|
|
<I>@DATADIR@/sane/gt68xx/</I>.
|
|
|
|
Make sure that it's readable by everyone.
|
|
<P>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>CONFIGURATION</H2>
|
|
|
|
The contents of the
|
|
<I>gt68xx.conf</I>
|
|
|
|
file is a list of usb lines containing vendor and product ids that correspond
|
|
to USB scanners. The file can also contain option lines. Empty lines and
|
|
lines starting with a hash mark (#) are ignored. The scanners are
|
|
autodetected by
|
|
<B>usb vendor_id product_id</B>
|
|
|
|
statements which are already included into
|
|
<I>gt68xx.conf</I>.
|
|
|
|
"vendor_id" and "product_id" are hexadecimal numbers that identify the
|
|
scanner.
|
|
<P>
|
|
|
|
The
|
|
<B>override</B>,
|
|
|
|
<B>firmware</B>,
|
|
|
|
<B>vendor</B>,
|
|
|
|
<B>model</B>,
|
|
|
|
and
|
|
<B>afe</B>
|
|
|
|
options must be placed after the
|
|
<B>usb</B>
|
|
|
|
line they refer to.
|
|
<P>
|
|
|
|
Option
|
|
<B>override</B>
|
|
|
|
is used to override the default model parameters. That's necessary for some
|
|
scanners that use the same vendor/product ids but are different. For these
|
|
scanners there are already commented out override lines in the configuration
|
|
file.
|
|
<B>override mustek-scanexpress-1200-ub-plus</B>
|
|
|
|
is necessary for the Mustek Scanexpress 1200 UB Plus, the
|
|
Medion/Lifetec/Tevion LT 9452, and the Trust Compact Scan USB 19200.
|
|
<B>override artec-ultima-2000</B>
|
|
|
|
is used for the Artec Ultima 2000, the Boeder SmartScan Slim Edition, the
|
|
Medion/ Lifetec/ Tevion/ Cytron MD/LT 9385, the Medion/ Lifetec/ Tevion MD
|
|
9458, and the Trust Flat Scan USB 19200.
|
|
<B>override mustek-bearpaw-2400-cu</B>
|
|
|
|
is necessary for the Mustek BearPaw 2400 CU and the Fujitsu 1200CUS. The
|
|
<B>override</B>
|
|
|
|
option must be the first one after the
|
|
<B>usb</B>
|
|
|
|
line.
|
|
<P>
|
|
|
|
Option
|
|
<B>firmware</B>
|
|
|
|
selects the name and path of the firmware file. It's only necessary if the
|
|
default (or override) doesn't work. The default firmware directory is
|
|
<I>@DATADIR@/sane/gt68xx/</I>.
|
|
|
|
You may need to create this directory. If you want to place the firmware files
|
|
at a different path, use a
|
|
<B>firmware</B>
|
|
|
|
line.
|
|
<P>
|
|
|
|
The
|
|
<B>vendor</B>
|
|
|
|
and
|
|
<B>model</B>
|
|
|
|
options are not absolutely necessary but for convenience. Quite a lot of
|
|
scanners from different manufacturers share the same vendor/product ids so you
|
|
can set the "correct" name here.
|
|
<P>
|
|
|
|
The
|
|
<B>afe</B>
|
|
|
|
option allows one to set custom offset and gain values for the Analog FrontEnd of
|
|
the scanner. This option can be either used to select the AFE values if
|
|
automatic coarse calibration is disabled, or to make automatic coarse
|
|
calibration faster. For the latter usage, enable debug level 3 (see below),
|
|
scan an image and look for debug line string with "afe". Copy this line to
|
|
<I>gt68xx.conf</I>.
|
|
|
|
The option has six parameters: red offset, red gain, green offset, green gain,
|
|
blue offset, and blue gain.
|
|
<P>
|
|
|
|
A sample configuration file is shown below:
|
|
<P>
|
|
|
|
<DL COMPACT><DT id="1"><DD>
|
|
usb 0x05d8 0x4002
|
|
<BR>
|
|
|
|
override "mustek-scanexpress-1200-ub-plus"
|
|
<BR>
|
|
|
|
firmware "/opt/gt68xx/SBfw.usb"
|
|
<BR>
|
|
|
|
vendor "Trust"
|
|
<BR>
|
|
|
|
model "Compact Scan USB 19200"
|
|
<BR>
|
|
|
|
afe 0x20 0x02 0x22 0x03 0x1f 0x04
|
|
</DL>
|
|
|
|
<P>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="2"><I>@CONFIGDIR@/gt68xx.conf</I>
|
|
|
|
<DD>
|
|
The backend configuration file (see also description of
|
|
<B>SANE_CONFIG_DIR</B>
|
|
|
|
below).
|
|
<DT id="3"><I>@LIBDIR@/libsane-gt68xx.a</I>
|
|
|
|
<DD>
|
|
The static library implementing this backend.
|
|
<DT id="4"><I>@LIBDIR@/libsane-gt68xx.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="5"><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="6"><B>SANE_DEBUG_GT68XX</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. If the debug level is set to 1 or higher,
|
|
some debug options become available that are normally hidden. Handle them with
|
|
care.
|
|
<P>
|
|
Example:
|
|
export SANE_DEBUG_GT68XX=4
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAI"> </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-artec_eplus48u">sane-artec_eplus48u</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-ma1509">sane-ma1509</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+sane-mustek_usb">sane-mustek_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)
|
|
|
|
<BR>
|
|
|
|
<I>@DOCDIR@/gt68xx/gt68xx.CHANGES</I>
|
|
|
|
<BR>
|
|
|
|
<I><A HREF="http://www.meier-geinitz.de/sane/gt68xx">http://www.meier-geinitz.de/sane/gt68xx</A></I>
|
|
|
|
<P>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
Henning Meier-Geinitz <<A HREF="mailto:henning@meier-geinitz.de">henning@meier-geinitz.de</A>>
|
|
<BR>
|
|
|
|
The original gt68xx driver was written by Sergey Vlasov, Andreas Nowack, and
|
|
David Stevenson. Thanks for sending patches and answering questions to them
|
|
and all the other contributors.
|
|
<P>
|
|
<A NAME="lbAK"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
The first few lines of the image are garbage for the 2400 TA
|
|
Plus.
|
|
<P>
|
|
|
|
Interpolation should be used instead of just copying data, when the X- and
|
|
Y-resolution differ.
|
|
<P>
|
|
|
|
Support for buttons is missing.
|
|
<P>
|
|
|
|
More detailed bug information is available at the gt68xx backend homepage
|
|
<I><A HREF="http://www.meier-geinitz.de/sane/gt68xx-backend/">http://www.meier-geinitz.de/sane/gt68xx-backend/</A></I>.
|
|
|
|
Please contact us if you find a bug or missing feature:
|
|
<<A HREF="mailto:sane-devel@alioth-lists.debian.net">sane-devel@alioth-lists.debian.net</A>>. Please send a debug log if your scanner isn't
|
|
detected correctly (see SANE_DEBUG_GT68XX above).
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="7"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="8"><A HREF="#lbAC">DESCRIPTION</A><DD>
|
|
<DT id="9"><A HREF="#lbAD">LIBUSB ISSUES</A><DD>
|
|
<DT id="10"><A HREF="#lbAE">FIRMWARE FILE</A><DD>
|
|
<DT id="11"><A HREF="#lbAF">CONFIGURATION</A><DD>
|
|
<DT id="12"><A HREF="#lbAG">FILES</A><DD>
|
|
<DT id="13"><A HREF="#lbAH">ENVIRONMENT</A><DD>
|
|
<DT id="14"><A HREF="#lbAI">SEE ALSO</A><DD>
|
|
<DT id="15"><A HREF="#lbAJ">AUTHOR</A><DD>
|
|
<DT id="16"><A HREF="#lbAK">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>
|