1sane-artec(5) SANE Scanner Access Now Easy sane-artec(5)
2
6 sane-artec - SANE backend for Artec flatbed scanners
7
10 The sane-artec library implements a SANE (Scanner Access Now Easy)
11 backend that provides access to Artec/Ultima SCSI flatbed scanners. At
12 present, the following scanners are known to work at least partially
13 with this backend:
14 * Artec A6000C
16 * Artec A6000C PLUS
17 * Artec ViewStation AT3
18 * BlackWidow BW4800SP (rebadged Artec AT3)
19 * Artec ViewStation AT6
20 * Artec ViewStation AT12
21 * Artec AM12S
22 * Plustek 19200S (rebadged Artec AM12S)
23 Although this manual page is generally updated with each release, up-
25 to-date information on new releases and extraneous helpful hints are
26 available from the backend homepage:
27 http://www4.infi.net/~cpinkham/sane.
28
31 The contents of the artec.conf file are a list of device names that
32 correspond to Artec scanners. Empty lines and lines starting with a
33 hash mark (#) are ignored. See sane-scsi(5) on details of what consti‐
34 tutes a valid device name.
35 Sample file:
37 # artec.conf
38 #
39 # this is a comment.
40 #
41 # this line says search for any SCSI devices which are scanners and have
42 # a vendor string of 'ULTIMA'
43 scsi ULTIMA
44 #
45 # the next line forces the backend to assume the next scanner found has
46 # the specified vendor string (useful for testing rebadged models).
47 vendor ULTIMA
48 #
49 # the next line forces the backend to assume the next scanner found has
50 # the specified model string (useful for testing rebadged models).
51 model AT3
52 #
53 # now a line that actually specifies a device. The backend is going to
54 # assume this is an Artec/Ultima AT3 because we forced the vendor and
55 # model above.
56 /dev/scanner
57 #
58 # once we hit a scanner device line, the forced vendor and model
59 # string are
60 # 'forgotten', so the vendor and model for this next device will be
61 # determined from the result of a SCSI inquiry.
62 /dev/sge
63 #
64
67 Some Artec scanners come with an included SCSI adapter. If your scan‐
68 ner came with a DTC ISA scsi cards, you can probably use it with recent
69 (>= 2.2.0) kernels using the generic NCR5380 support. You must pass
70 the following boot argument to the kernel: "dtc3181e=0x2c0,0"
71 I do not have any information on the PCI SCSI adapter included with
72 some newer Artec scanners.
73
76 /etc/sane.d/artec.conf
77 The backend configuration file (see also description of
78 SANE_CONFIG_DIR below).
79 /usr/lib64/sane/libsane-artec.a
81 The static library implementing this backend.
82 /usr/lib64/sane/libsane-artec.so
84 The shared library implementing this backend (present on systems
85 that support dynamic loading).
86
89 SANE_CONFIG_DIR
90 This environment variable specifies the list of directories that
91 may contain the configuration file. Under UNIX, the directories
92 are separated by a colon (`:'), under OS/2, they are separated
93 by a semi- colon (`;'). If this variable is not set, the con‐
94 figuration file is searched in two default directories: first,
95 the current working direc- tory (".") and then in /etc/sane.d.
96 If the value of the environment variable ends with the directory
97 separator character, then the default directories are searched
98 after the explicitly specified directories. For example, set‐
99 ting SANE_CONFIG_DIR to "/tmp/config:" would result in directo‐
100 ries tmp/config, ., and /etc/sane.d being searched (in this
101 order).
102 SANE_DEBUG_ARTEC
104 If the library was compiled with debug support enabled, this
105 environment variable controls the debug level for this backend.
106 E.g., a value of 128 requests all debug output to be printed.
107 Smaller levels reduce verbosity: SANE_DEBUG_ARTEC values:
108 Number Remark
110 0 print important errors
111 1 print errors
112 2 print sense
113 3 print warnings
114 4 print scanner-inquiry
115 5 print information
116 6 print less important information
117 7 print major called procedures
118 8 print all called procedures
119 9 print procedure info/data messages
120 10 print called sane-init-routines
121 11 print called sane-procedures
122 12 print sane infos
123 13 print sane option-control messages
124 50 print verbose data/debug messages
125 == 100 print software RGB calibration data
126 == 101 print raw data from scanner to artec.data.raw file
127 == 128 print out all messages
128 Example: export SANE_DEBUG_ARTEC=13
130
133 Known bugs in this release: A6000C+ users with firmware v1.92 or ear‐
134 lier have problems with the backend, the cause has not been determined.
135 Sometimes the backend is not particularly robust, you can possibly lock
136 up the SCSI bus (and/or machine) by not having patience enough when
137 scanning. 3-channel gamma correction is not implemented and single-
138 channel gamma correction is not totally working on models other than
139 the AT3.
140
143 sane(7), sane-scsi(5)
144
147 Chris Pinkham <cpinkham@corp.infi.net>
148 11 Jul 2008 sane-artec(5)