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
32 The contents of the artec.conf file are a list of device names that
33 correspond to Artec scanners. Empty lines and lines starting with a
34 hash mark (#) are ignored. See sane-scsi(5) on details of what consti‐
35 tutes a valid device name.
36 Sample file:
38 # artec.conf
39 #
40 # this is a comment.
41 #
42 # this line says search for any SCSI devices which are scanners and have
43 # a vendor string of 'ULTIMA'
44 scsi ULTIMA
45 #
46 # the next line forces the backend to assume the next scanner found has
47 # the specified vendor string (useful for testing rebadged models).
48 vendor ULTIMA
49 #
50 # the next line forces the backend to assume the next scanner found has
51 # the specified model string (useful for testing rebadged models).
52 model AT3
53 #
54 # now a line that actually specifies a device. The backend is going to
55 # assume this is an Artec/Ultima AT3 because we forced the vendor and
56 # model above.
57 /dev/scanner
58 #
59 # once we hit a scanner device line, the forced vendor and model
60 # string are
61 # 'forgotten', so the vendor and model for this next device will be
62 # determined from the result of a SCSI inquiry.
63 /dev/sge
64 #
65
68 Some Artec scanners come with an included SCSI adapter. If your scan‐
69 ner came with a DTC ISA scsi cards, you can probably use it with recent
70 (>= 2.2.0) kernels using the generic NCR5380 support. You must pass
71 the following boot argument to the kernel: "dtc3181e=0x2c0,0"
72 I do not have any information on the PCI SCSI adapter included with
73 some newer Artec scanners.
74
77 /etc/sane.d/artec.conf
78 The backend configuration file (see also description of
79 SANE_CONFIG_DIR below).
80 /usr/lib64/sane/libsane-artec.a
82 The static library implementing this backend.
83 /usr/lib64/sane/libsane-artec.so
85 The shared library implementing this backend (present on systems
86 that support dynamic loading).
87
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
101 this 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
112 1 print errors
113 2 print sense
114 3 print warnings
115 4 print scanner-inquiry
116 5 print informations
117 6 print less important informations
118 7 print major called procedures
119 8 print all called procedures
120 9 print procedure info/data messages
121 10 print called sane-init-routines
122 11 print called sane-procedures
123 12 print sane infos
124 13 print sane option-control messages
125 50 print verbose data/debug messages
127 == 100 print software RGB calibration data
129 == 101 print raw data from scanner to artec.data.raw file
130 == 128 print out all messages
132 Example: export SANE_DEBUG_ARTEC=13
134
137 Known bugs in this release: A6000C+ users with firmware v1.92 or ear‐
138 lier have problems with the backend, the cause has not been determined.
139 Sometimes the backend is not particularly robust, you can possibly lock
140 up the SCSI bus (and/or machine) by not having patience enough when
141 scanning. 3-channel gamma correction is not implemented and single-
142 channel gamma correction is not totally working on models other than
143 the AT3.
144
147 sane(7), sane-scsi(5)
148
151 Chris Pinkham (cpinkham@corp.infi.net)
152 11 Jul 2008 sane-artec(5)