Debian Codegraph @

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

raw
1 .TH sane\-artec 5 "11 Jul 2008" "" "SANE Scanner Access Now Easy"
2 .IX sane\-artec
3
4 .SH NAME
5 sane\-artec \- SANE backend for Artec flatbed scanners
6
7 .SH DESCRIPTION
8 The
9 .B sane\-artec
10 library implements a SANE (Scanner Access Now Easy) backend
11 that provides access to Artec/Ultima SCSI flatbed scanners. At present,
12 the following scanners are known to work at least partially with this backend:
13 .PP
14 .RS
15 * Artec A6000C
16 .br
17 * Artec A6000C PLUS
18 .br
19 * Artec ViewStation AT3
20 .br
21 * BlackWidow BW4800SP (rebadged Artec AT3)
22 .br
23 * Artec ViewStation AT6
24 .br
25 * Artec ViewStation AT12
26 .br
27 * Artec AM12S
28 .br
29 * Plustek 19200S (rebadged Artec AM12S)
30 .RE
31 .PP
32 Although this manual page is generally updated with each release,
33 up-to-date information on new releases and extraneous helpful hints
34 are available from the backend homepage:
35 .IR http://www4.infi.net/~cpinkham/sane .
36
37 .SH CONFIGURATION
38
39 The contents of the
40 .I artec.conf
41 file are a list of device names that
42 correspond to Artec scanners. Empty lines and lines starting with a
43 hash mark (#) are ignored. See
44 .BR sane\-scsi (5)
45 on details of what constitutes a valid device name.
46
47 Sample file:
48 .br
49 .nf
50 # artec.conf
51 #
52 # this is a comment.
53 #
54 # this line says search for any SCSI devices which are scanners and have
55 # a vendor string of 'ULTIMA'
56 scsi ULTIMA
57 #
58 # the next line forces the backend to assume the next scanner found has
59 # the specified vendor string (useful for testing rebadged models).
60 vendor ULTIMA
61 #
62 # the next line forces the backend to assume the next scanner found has
63 # the specified model string (useful for testing rebadged models).
64 model AT3
65 #
66 # now a line that actually specifies a device. The backend is going to
67 # assume this is an Artec/Ultima AT3 because we forced the vendor and
68 # model above.
69 /dev/scanner
70 #
71 # once we hit a scanner device line, the forced vendor and model
72 # string are
73 # 'forgotten', so the vendor and model for this next device will be
74 # determined from the result of a SCSI inquiry.
75 /dev/sge
76 #
77 .fi
78
79 .SH SCSI ADAPTER TIPS
80
81 Some Artec scanners come with an included SCSI adapter. If your scanner came
82 with a DTC ISA SCSI cards, you can probably use it with recent (>= 2.2.0)
83 kernels using the generic NCR5380 support. You must pass the following
84 boot argument to the kernel: "dtc3181e=0x2c0,0"
85 .br
86 I do not have any information on the PCI SCSI adapter included with some
87 newer Artec scanners.
88
89 .SH FILES
90 .TP
91 .I /etc/sane.d/artec.conf
92 The backend configuration file (see also description of
93 .B SANE_CONFIG_DIR
94 below).
95 .TP
96 .I /usr/lib/x86_64-linux-gnu/sane/libsane\-artec.a
97 The static library implementing this backend.
98 .TP
99 .I /usr/lib/x86_64-linux-gnu/sane/libsane\-artec.so
100 The shared library implementing this backend (present on systems that
101 support dynamic loading).
102
103 .SH ENVIRONMENT
104 .TP
105 .B SANE_CONFIG_DIR
106 This environment variable specifies the list of directories that may
107 contain the configuration file. On *NIX systems, the directories are
108 separated by a colon (`:'), under OS/2, they are separated by a
109 semi-colon (`;'). If this variable is not set, the configuration file is
110 searched in two default directories: first, the current working
111 directory (".") and then in
112 .IR /etc/sane.d .
113 If the value of the
114 environment variable ends with the directory separator character, then
115 the default directories are searched after the explicitly specified
116 directories. For example, setting
117 .B SANE_CONFIG_DIR
118 to "/tmp/config:" would result in directories
119 .IR tmp/config ,
120 .IR . ,
121 and
122 .I /etc/sane.d
123 being searched (in this order).
124 .TP
125 .B SANE_DEBUG_ARTEC
126 If the library was compiled with debug support enabled, this environment
127 variable controls the debug level for this backend. E.g., a value of 128
128 requests all debug output to be printed. Smaller levels reduce verbosity:
129 .B SANE_DEBUG_ARTEC
130 values:
131
132 .ft CR
133 .nf
134 Number Remark
135 \
136 0 print important errors
137 1 print errors
138 2 print sense
139 3 print warnings
140 4 print scanner-inquiry
141 5 print information
142 6 print less important information
143 7 print major called procedures
144 8 print all called procedures
145 9 print procedure info/data messages
146 10 print called sane\-init-routines
147 11 print called sane\-procedures
148 12 print sane infos
149 13 print sane option-control messages
150 \
151 50 print verbose data/debug messages
152 \
153 == 100 print software RGB calibration data
154 == 101 print raw data from scanner to artec.data.raw file
155 \
156 == 128 print out all messages
157 .fi
158 .ft R
159 .PP
160 Example:
161 export SANE_DEBUG_ARTEC=13
162
163 .SH BUGS
164
165 Known bugs in this release: A6000C+ users with firmware v1.92 or
166 earlier have problems with the backend, the cause has not been determined.
167 Sometimes the backend is not particularly robust, you can possibly lock up
168 the SCSI bus (and/or machine) by not having patience enough when scanning.
169 3-channel gamma correction is not implemented and single-channel gamma
170 correction is not totally working on models other than the AT3.
171
172 .SH "SEE ALSO"
173 .BR sane (7) ,
174 .BR sane\-scsi (5)
175
176 .SH AUTHOR
177
178 Chris Pinkham
179 .I <[email protected]>