329 lines
9.3 KiB
HTML
329 lines
9.3 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of sane-canon_dr</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>sane-canon_dr</H1>
|
|
Section: SANE Scanner Access Now Easy (5)<BR>Updated: 31 Aug 2015<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="ixAAB"></A>
|
|
<P>
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
sane-canon_dr - SANE backend for Canon DR-series scanners
|
|
<P>
|
|
<A NAME="lbAC"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
The
|
|
<B>sane-canon_dr</B>
|
|
|
|
library implements a SANE (Scanner Access Now Easy) backend which
|
|
provides access to some Canon DR-series scanners.
|
|
<P>
|
|
This document describes backend version 57, which shipped with SANE 1.0.28.
|
|
<P>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>SUPPORTED HARDWARE</H2>
|
|
|
|
This version has only been tested with a few scanner models. Please see
|
|
<A HREF="http://www.sane-project.org/sane-supported-devices.html">http://www.sane-project.org/sane-supported-devices.html</A> for the most recent
|
|
list.
|
|
<P>
|
|
This backend may support other Canon scanners. The best
|
|
way to determine level of support is to test the scanner directly,
|
|
or to collect a trace of the windows driver in action.
|
|
Please contact the author for help or with test results.
|
|
<P>
|
|
In general, the larger machines (DR-4000 and up) which have been tested use
|
|
a fairly complete protocol, with hardware support for many modes, resolutions
|
|
and features. The smaller machines have many limitations, like missing
|
|
horizontal resolutions, missing binary mode, always scanning full-width, etc.
|
|
There is code in the backend to address these problems, but there seems to be
|
|
no way to detect if they are required, so they must be hard-coded.
|
|
<P>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
Effort has been made to expose most hardware options, including:
|
|
<P>
|
|
|
|
source s
|
|
<DL COMPACT><DT id="1"><DD>
|
|
Selects the source for the scan. Options
|
|
may include "Flatbed", "ADF Front", "ADF Back", "ADF Duplex".
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
mode m
|
|
<DL COMPACT><DT id="2"><DD>
|
|
Selects the mode for the scan. Options
|
|
may include "Lineart", "Halftone", "Gray", and "Color".
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
resolution
|
|
<DL COMPACT><DT id="3"><DD>
|
|
Controls scan resolution.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
tl-x, tl-y, br-x, br-y
|
|
<DL COMPACT><DT id="4"><DD>
|
|
Sets scan area upper left and lower right coordinates. These are renamed
|
|
t, l, x, y by some frontends.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
page-width, page-height
|
|
<DL COMPACT><DT id="5"><DD>
|
|
Sets paper size. Used by scanner to determine centering of scan
|
|
coordinates when using ADF and to detect double feed errors.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
Other options will be available based on the capabilities of the scanner:
|
|
enhancement, compression, buttons and sensors, etc.
|
|
<P>
|
|
|
|
Additionally, several 'software' options are exposed by the backend. These
|
|
are reimplementations of features provided natively by larger scanners, but
|
|
running on the host computer. This enables smaller machines to have similar
|
|
capabilities. Please note that these features are somewhat simplistic, and
|
|
may not perform as well as the native implementations. Note also that these
|
|
features all require that the driver cache the entire image in memory. This
|
|
will almost certainly result in a reduction of scanning speed.
|
|
<P>
|
|
|
|
swcrop
|
|
<DL COMPACT><DT id="6"><DD>
|
|
Requests the driver to detect the extremities of the paper within the larger
|
|
image, and crop the empty edges.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
swdeskew
|
|
<DL COMPACT><DT id="7"><DD>
|
|
Requests the driver to detect the rotation of the paper within the larger
|
|
image, and counter the rotation.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
swdespeck X
|
|
<DL COMPACT><DT id="8"><DD>
|
|
Requests the driver to find and remove dots of X diameter or smaller from the
|
|
image, and fill the space with the average surrounding color.
|
|
</DL>
|
|
|
|
<P>
|
|
Use 'scanimage --help' to get a list, but be aware that some options may
|
|
be settable only when another option has been set, and that advanced options
|
|
may be hidden by some frontend programs.
|
|
<P>
|
|
|
|
<A NAME="lbAF"> </A>
|
|
<H2>CONFIGURATION FILE</H2>
|
|
|
|
The configuration file "canon_dr.conf" is used to tell the backend how to look
|
|
for scanners, and provide options controlling the operation of the backend.
|
|
This file is read each time the frontend asks the backend for a list
|
|
of scanners, generally only when the frontend starts. If the configuration
|
|
file is missing, the backend will fail to run.
|
|
<P>
|
|
|
|
Scanners can be specified in the configuration file in 4 ways:
|
|
<P>
|
|
|
|
"scsi CANON DR"
|
|
<DL COMPACT><DT id="9"><DD>
|
|
Requests backend to search all scsi busses in the system for a device
|
|
which reports itself to be a scanner made by 'CANON', with a model name
|
|
starting with 'DR'.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
"scsi /dev/sg0" (or other scsi device file)
|
|
<DL COMPACT><DT id="10"><DD>
|
|
Requests backend to open the named scsi device. Only useful if you have
|
|
multiple compatible scanners connected to your system, and need to
|
|
specify one. Probably should not be used with the other "scsi" line above.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
"usb 0x04a9 0x1603" (or other vendor/product ids)
|
|
<DL COMPACT><DT id="11"><DD>
|
|
Requests backend to search all usb busses in the system for a device
|
|
which uses that vendor and product id. The device will then be queried
|
|
to determine if it is a Canon scanner.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
"usb /dev/usb/scanner0" (or other device file)
|
|
<DL COMPACT><DT id="12"><DD>
|
|
Some systems use a kernel driver to access usb scanners. This method is untested.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
Besides the 'scsi' and 'usb' lines, the configuration file supports the
|
|
following 'option' lines:
|
|
<P>
|
|
|
|
"option buffer-size [number of bytes]"
|
|
<DL COMPACT><DT id="13"><DD>
|
|
Set the number of bytes in the data buffer to something other than the
|
|
compiled-in default of 4MB. Large values may cause timeouts or hangs, small
|
|
values may cause slow scans.
|
|
<P>
|
|
|
|
Note: The backend does not place an upper bound on this value, as some users
|
|
required it to be quite large. Values above the default are not recommended,
|
|
and may crash your OS or lockup your scsi card driver. You have been
|
|
warned.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
"option vendor-name [string of text]"
|
|
<BR>
|
|
|
|
"option model-name [string of text]"
|
|
<BR>
|
|
|
|
"option version-name [string of text]"
|
|
<DL COMPACT><DT id="14"><DD>
|
|
These options can be used collectively to override the values provided by the
|
|
scanner, or to provide the values when the scanner cannot.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
"option padded-read [0|1]"
|
|
<DL COMPACT><DT id="15"><DD>
|
|
Some scanners prepend all data transmitted to host with 12 bytes. Enable this option if the scanner fails to respond to commands.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
"option duplex-offset [integer]"
|
|
<DL COMPACT><DT id="16"><DD>
|
|
Some scanners pad the upper edge of one side of a duplex scan. There is some variation in the amount of padding. Modify this option if your unit shows an unwanted band of image data on only one side.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
Note: 'option' lines may appear multiple times in the configuration file.
|
|
They only apply to scanners discovered by the next 'scsi/usb' line.
|
|
<P>
|
|
|
|
<P>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>ENVIRONMENT</H2>
|
|
|
|
The backend uses a single environment variable, SANE_DEBUG_CANON_DR, which
|
|
enables debugging output to stderr. Valid values are:
|
|
<P>
|
|
|
|
<DL COMPACT><DT id="17"><DD>
|
|
5 Errors
|
|
<BR>
|
|
|
|
10 Function trace
|
|
<BR>
|
|
|
|
15 Function detail
|
|
<BR>
|
|
|
|
20 Option commands
|
|
<BR>
|
|
|
|
25 SCSI/USB trace
|
|
<BR>
|
|
|
|
30 SCSI/USB detail
|
|
<BR>
|
|
|
|
35 Useless noise
|
|
</DL>
|
|
|
|
<P>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>KNOWN ISSUES</H2>
|
|
|
|
This backend was entirely reverse engineered from usb traces of the proprietary
|
|
driver. Various advanced features of the machines may not be enabled. Many
|
|
machines have not been tested. Their protocol is unknown.
|
|
<P>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>CREDITS</H2>
|
|
|
|
<P>
|
|
The various authors of the sane-fujitsu backend provided useful code
|
|
<BR>
|
|
|
|
Yabarana Corp. <A HREF="http://www.yabarana.com">www.yabarana.com</A> provided significant funding
|
|
<BR>
|
|
|
|
EvriChart, Inc. <A HREF="http://www.evrichart.com">www.evrichart.com</A> provided funding and loaned equipment
|
|
<BR>
|
|
|
|
Canon, USA. <A HREF="http://www.usa.canon.com">www.usa.canon.com</A> loaned equipment
|
|
<BR>
|
|
|
|
HPrint hprint.com.br provided funding and testing for DR-2510 support
|
|
<BR>
|
|
|
|
Stone-IT <A HREF="http://www.stone-it.com">www.stone-it.com</A> provided funding for DR-2010 and DR-2050 support
|
|
<BR>
|
|
|
|
Gerhard Pfeffer provided access and testing for P-208 and P-215
|
|
<BR>
|
|
|
|
Special thanks to: Alejandro Imass, Andre Shimakawa, Martijn van Brummelen, Thanos Diacakis and Junren Shi for testing and feedback.
|
|
<P>
|
|
<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?5+sane-usb">sane-usb</A>(5)
|
|
<P>
|
|
<A NAME="lbAK"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
m. allan noah: <kitno455 a t gmail d o t com>
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="18"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="19"><A HREF="#lbAC">DESCRIPTION</A><DD>
|
|
<DT id="20"><A HREF="#lbAD">SUPPORTED HARDWARE</A><DD>
|
|
<DT id="21"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="22"><A HREF="#lbAF">CONFIGURATION FILE</A><DD>
|
|
<DT id="23"><A HREF="#lbAG">ENVIRONMENT</A><DD>
|
|
<DT id="24"><A HREF="#lbAH">KNOWN ISSUES</A><DD>
|
|
<DT id="25"><A HREF="#lbAI">CREDITS</A><DD>
|
|
<DT id="26"><A HREF="#lbAJ">SEE ALSO</A><DD>
|
|
<DT id="27"><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>
|