summaryrefslogtreecommitdiff
path: root/doc/sane-canon630u.man
diff options
context:
space:
mode:
authorJörg Frings-Fürst <debian@jff-webhosting.net>2014-10-06 14:00:40 +0200
committerJörg Frings-Fürst <debian@jff-webhosting.net>2014-10-06 14:00:40 +0200
commit6e9c41a892ed0e0da326e0278b3221ce3f5713b8 (patch)
tree2e301d871bbeeb44aa57ff9cc070fcf3be484487 /doc/sane-canon630u.man
Initial import of sane-backends version 1.0.24-1.2
Diffstat (limited to 'doc/sane-canon630u.man')
-rw-r--r--doc/sane-canon630u.man106
1 files changed, 106 insertions, 0 deletions
diff --git a/doc/sane-canon630u.man b/doc/sane-canon630u.man
new file mode 100644
index 0000000..bdfb874
--- /dev/null
+++ b/doc/sane-canon630u.man
@@ -0,0 +1,106 @@
+.TH sane\-canon630u 5 "11 Jul 2008" "@PACKAGEVERSION@" "SANE Scanner Access Now Easy"
+.IX sane\-canon630u
+.SH NAME
+sane\-canon630u \- SANE backend for the Canon 630u USB flatbed scanner
+.SH DESCRIPTION
+The
+.B sane\-canon630u
+library implements a SANE (Scanner Access Now Easy) backend that
+provides access to the following Canon flatbed scanners:
+.PP
+.RS
+CanoScan 630u
+.br
+CanoScan 636u
+.br
+.RE
+.PP
+Color scanning is supported at 75, 150, 300, and 600 dpi, and gamma and
+analog gain are adjustable.
+.PP
+TESTERS ARE WELCOME. Send your bug reports and comments to
+Nathan Rutman <nthn1@yahoo.com>
+.PP
+.SH CONFIGURATION
+The contents of the
+.I canon630u.conf
+file is a list of device names that correspond to Canon
+USB scanners. Empty lines and lines starting with a hash mark (#) are
+ignored. Only one device name can be listed in
+.IR canon630u.conf .
+The program
+.IR sane\-find\-scanner
+helps to find out the correct device. Under Linux, such a device name
+could be
+.I /dev/usb/scanner0
+for example. See sane\-usb(5) for details.
+.PP
+This product-specific scanner driver uses the lower-level kernel USB driver
+"scanner". Check for "Driver=usbscanner" under /proc/bus/usb/devices. If
+"Driver=(none)", try forcing it with "insmod scanner vendor=0x04a9 product=0x2204"
+.SH NOTES
+.PP
+Due to Canon's unwillingness to provide scanner documentation, this
+software was developed by analyzing the USB traffic of the Windows
+2000 driver. So things like the calibration procedure I kind of made up;
+it seems to work for my scanner. If you have complaints, let me know.
+.PP
+This driver requires the ability to send USB Control Messages, available in
+kernel 2.4.12 or later.
+.PP
+Some users have reported that this driver doesn't work at all. This seems
+to be a hardware specific issue, although I don't know what exactly the
+problem is. If you are having problems, please send me the info in
+/proc/bus/usb/devices, /proc/pci, the kernel scanner.c driver version from
+/var/log/messages, and the output from "SANE_DEBUG_CANON630U=12 scanimage > /dev/null"
+.PP
+.SH FILES
+.TP
+.I @CONFIGDIR@/canon630u.conf
+The backend configuration file (see also description of
+.B SANE_CONFIG_DIR
+below).
+.TP
+.I @LIBDIR@/libsane\-canon630u.a
+The static library implementing this backend.
+.TP
+.I @LIBDIR@/libsane\-canon630u.so
+The shared library implementing this backend (present on systems that
+support dynamic loading).
+.TP
+.I /tmp/canon.cal
+The calibration file used to normalize pixel brightness. This is
+calculated every time the scanner is first used after it has lost power.
+Deleting this file will force recalibration.
+.SH ENVIRONMENT
+.TP
+.B SANE_CONFIG_DIR
+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
+to "/tmp/config:" would result in directories "tmp/config", ".", and
+"@CONFIGDIR@" being searched (in this order).
+.TP
+.B SANE_DEBUG_CANON630U
+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.
+
+Example:
+.br
+SANE_DEBUG_CANON630U=12 scanimage > /dev/null
+.SH "SEE ALSO"
+sane(7), sane\-usb(5), sane\-find\-scanner(1)
+.br
+http://canon-fb630u.sourceforge.net/
+.br
+.SH AUTHOR
+Nathan Rutman
+