211 lines
6.7 KiB
HTML
211 lines
6.7 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of sane-abaton</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>sane-abaton</H1>
|
|
Section: SANE Scanner Access Now Easy (5)<BR>Updated: 11 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-abaton - SANE backend for Abaton flatbed scanners
|
|
<A NAME="lbAC"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
The
|
|
<B>sane-abaton</B>
|
|
|
|
library implements a SANE (Scanner Access Now Easy) backend that
|
|
provides access to Abaton flatbed scanners. At present, only the Scan
|
|
300/GS (8bit, 256 levels of gray) is fully supported, due to the
|
|
absence of programming information. The Scan 300/S (black and white)
|
|
is recognized, but support for it is untested.
|
|
<P>
|
|
|
|
If you own a Abaton scanner other than the ones listed above that
|
|
works with this backend, or if you own an Abaton scanner that does not
|
|
work with this backend, please contact
|
|
<I><A HREF="mailto:sane-devel@alioth-lists.debian.net">sane-devel@alioth-lists.debian.net</A></I>
|
|
|
|
with the model number, so that arrangements can be made to include
|
|
support for it. Have a look at <A HREF="http://www.sane-project.org/mailing-lists.html">http://www.sane-project.org/mailing-lists.html</A>
|
|
concerning subscription to sane-devel.
|
|
<P>
|
|
|
|
Abaton is out of business, and these scanners are not supported by
|
|
Everex (the parent company of Abaton), nor is there any programming
|
|
information to be found. This driver is therefore based on
|
|
information obtained by running Abaton's scanning desk accessory under
|
|
MacsBug and tracing the MacOS SCSI Manager calls it made during image
|
|
acquisition.
|
|
<P>
|
|
|
|
However, the protocol is very similar to, though not compatible with,
|
|
the one used by the Apple scanners, therefore, if this backend is ever
|
|
extended to support the other Abaton models (they also made a color
|
|
flatbed scanner), it may be possible to fill in some "missing pieces"
|
|
from the (quite detailed) Apple scanner documentation.
|
|
<P>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DEVICE NAMES</H2>
|
|
|
|
This backend expects device names of the form:
|
|
<P>
|
|
|
|
<DL COMPACT><DT id="1"><DD>
|
|
<I>special</I>
|
|
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
Where
|
|
<I>special</I>
|
|
|
|
is the path-name for the special device that corresponds to a SCSI
|
|
scanner. For SCSI scanners, the special device name must be a generic
|
|
SCSI device or a symlink to such a device. Under Linux, such a device
|
|
name takes a format such as
|
|
<I>/dev/sga</I>
|
|
|
|
or
|
|
<I>/dev/sg0</I>,
|
|
|
|
for example. See <A HREF="/cgi-bin/man/man2html?5+sane-scsi">sane-scsi</A>(5) for details.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>CONFIGURATION</H2>
|
|
|
|
The contents of the
|
|
<I>abaton.conf</I>
|
|
|
|
file is a list of device names that correspond to Abaton scanners.
|
|
Empty lines and lines starting with a hash mark (#) are ignored. See
|
|
<A HREF="/cgi-bin/man/man2html?5+sane-scsi">sane-scsi</A>(5) on details of what constitutes a valid device name.
|
|
<P>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="2"><I>@CONFIGDIR@/abaton.conf</I>
|
|
|
|
<DD>
|
|
The backend configuration file (see also description of
|
|
<B>SANE_CONFIG_DIR</B>
|
|
|
|
below).
|
|
<DT id="3"><I>@LIBDIR@/libsane-abaton.a</I>
|
|
|
|
<DD>
|
|
The static library implementing this backend.
|
|
<DT id="4"><I>@LIBDIR@/libsane-abaton.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="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_ABATON</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.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
There are a few known ones, and definitely some unknown ones.
|
|
<DL COMPACT>
|
|
<DT id="7"><B>Scan area miscalculations</B>
|
|
|
|
<DD>
|
|
For the sake of programmer efficiency, this backend handles all
|
|
measurements in millimetres, and floors (rather than rounds) values to
|
|
avoid possible damage to the scanner mechanism. Therefore, it may not
|
|
be possible to scan to the extreme right or bottom edges of the page.
|
|
<DT id="8"><B>Cancelling the scan</B>
|
|
|
|
<DD>
|
|
This might not work correctly, or it might abort the frontend. The
|
|
former is more likely than the latter.
|
|
</DL>
|
|
<P>
|
|
|
|
If you have found something that you think is a bug, please attempt to
|
|
recreate it with the SANE_DEBUG_ABATON environment variable set to
|
|
255, and send a report detailing the conditions surrounding the bug to
|
|
<I><A HREF="mailto:sane-devel@alioth-lists.debian.net">sane-devel@alioth-lists.debian.net</A></I>.
|
|
|
|
<P>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>TODO</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="9"><B>Implement non-blocking support</B>
|
|
|
|
<DD>
|
|
<DT id="10"><B>Finish reverse-engineering the MacOS driver</B>
|
|
|
|
<DD>
|
|
This will allow me to add support for other models with reasonable
|
|
confidence that it will work, as well as to fully exploit the
|
|
information returned by the INQUIRY command.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<A HREF="/cgi-bin/man/man2html?7+sane">sane</A>(7), <A HREF="/cgi-bin/man/man2html?5+sane-scsi">sane-scsi</A>(5), <A HREF="/cgi-bin/man/man2html?1+scanimage">scanimage</A>(1)
|
|
<P>
|
|
<A NAME="lbAK"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
The sane-abaton backend was partially written by David Huggins-Daines,
|
|
based on the sane-apple backend by Milon Firikis.
|
|
<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">DEVICE NAMES</A><DD>
|
|
<DT id="14"><A HREF="#lbAE">CONFIGURATION</A><DD>
|
|
<DT id="15"><A HREF="#lbAF">FILES</A><DD>
|
|
<DT id="16"><A HREF="#lbAG">ENVIRONMENT</A><DD>
|
|
<DT id="17"><A HREF="#lbAH">BUGS</A><DD>
|
|
<DT id="18"><A HREF="#lbAI">TODO</A><DD>
|
|
<DT id="19"><A HREF="#lbAJ">SEE ALSO</A><DD>
|
|
<DT id="20"><A HREF="#lbAK">AUTHOR</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:04 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|