Debian Codegraph @

upstream/debian-unstable/man5/sane-canon630u.5

raw
1 .TH sane\-canon630u 5 "11 Jul 2008" "" "SANE Scanner Access Now Easy"
2 .IX sane\-canon630u
3 .SH NAME
4 sane\-canon630u \- SANE backend for the Canon 630u USB flatbed scanner
5 .SH DESCRIPTION
6 The
7 .B sane\-canon630u
8 library implements a SANE (Scanner Access Now Easy) backend that
9 provides access to the following Canon flatbed scanners:
10 .PP
11 .RS
12 CanoScan 630u
13 .br
14 CanoScan 636u
15 .br
16 .RE
17 .PP
18 Color scanning is supported at 75, 150, 300, and 600 dpi, and gamma and
19 analog gain are adjustable.
20 .PP
21 TESTERS ARE WELCOME. Send your bug reports and comments to
22 Nathan Rutman
23 .IR <[email protected]> .
24 .PP
25 .SH CONFIGURATION
26 The contents of the
27 .I canon630u.conf
28 file is a list of device names that correspond to Canon
29 USB scanners. Empty lines and lines starting with a hash mark (#) are
30 ignored. Only one device name can be listed in
31 .IR canon630u.conf .
32 The program
33 .BR sane\-find\-scanner (1)
34 helps to find out the correct device. Under Linux, such a device name
35 could be
36 .I /dev/usb/scanner0
37 for example. See
38 .BR sane\-usb (5)
39 for details.
40 .PP
41 This product-specific scanner driver uses the lower-level kernel USB driver
42 "scanner". Check for "Driver=usbscanner" under
43 .IR /proc/bus/usb/devices .
44 If "Driver=(none)", try forcing it with
45 .I "insmod scanner vendor=0x04a9 product=0x2204"
46 .SH NOTES
47 .PP
48 Due to Canon's unwillingness to provide scanner documentation, this
49 software was developed by analyzing the USB traffic of the Windows
50 2000 driver. So things like the calibration procedure I kind of made up;
51 it seems to work for my scanner. If you have complaints, let me know.
52 .PP
53 This driver requires the ability to send USB Control Messages, available in
54 kernel 2.4.12 or later.
55 .PP
56 Some users have reported that this driver doesn't work at all. This seems
57 to be a hardware specific issue, although I dsane\-uson't know what exactly the
58 problem is. If you are having problems, please send me the info in
59 .IR /proc/bus/usb/devices ,
60 .IR /proc/pci ,
61 the kernel
62 .I scanner.c
63 driver version from
64 .IR /var/log/messages ,
65 and the output from
66 .I "SANE_DEBUG_CANON630U=12 scanimage > /dev/null"
67 .PP
68 .SH FILES
69 .TP
70 .I /etc/sane.d/canon630u.conf
71 The backend configuration file (see also description of
72 .B SANE_CONFIG_DIR
73 below).
74 .TP
75 .I /usr/lib/x86_64-linux-gnu/sane/libsane\-canon630u.a
76 The static library implementing this backend.
77 .TP
78 .I /usr/lib/x86_64-linux-gnu/sane/libsane\-canon630u.so
79 The shared library implementing this backend (present on systems that
80 support dynamic loading).
81 .TP
82 .I /tmp/canon.cal
83 The calibration file used to normalize pixel brightness. This is
84 calculated every time the scanner is first used after it has lost power.
85 Deleting this file will force recalibration.
86 .SH ENVIRONMENT
87 .TP
88 .B SANE_CONFIG_DIR
89 This environment variable specifies the list of directories that may
90 contain the configuration file. On *NIX systems, the directories are
91 separated by a colon (`:'), under OS/2, they are separated by a
92 semi-colon (`;'). If this variable is not set, the configuration file
93 is searched in two default directories: first, the current working
94 directory (".") and then in
95 .IR /etc/sane.d .
96 If the value of the environment variable ends with the directory
97 separator character, then the default directories are searched after
98 the explicitly specified directories. For example, setting
99 .B SANE_CONFIG_DIR
100 to "/tmp/config:" would result in directories
101 .IR tmp/config ,
102 .IR . ,
103 and
104 .I /etc/sane.d
105 being searched (in this order).
106 .TP
107 .B SANE_DEBUG_CANON630U
108 If the library was compiled with debug support enabled, this
109 environment variable controls the debug level for this backend. Higher
110 debug levels increase the verbosity of the output.
111
112 Example:
113 .br
114 SANE_DEBUG_CANON630U=12 scanimage > /dev/null
115 .SH "SEE ALSO"
116 .BR sane (7),
117 .BR sane\-usb (5),
118 .BR sane\-find\-scanner (1)
119 .br
120 .I http://canon-fb630u.sourceforge.net/
121 .br
122 .SH AUTHOR
123 Nathan Rutman