1sane-artec(5)            SANE Scanner Access Now Easy            sane-artec(5)
2
3
4

NAME

6       sane-artec - SANE backend for Artec flatbed scanners
7
8

DESCRIPTION

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
15              * 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
24       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
29

DOCUMENTATION

CONFIGURATION

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
37       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
66

SCSI ADAPTER TIPS

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
75

FILES

77       /etc/sane.d/artec.conf
78              The   backend   configuration  file  (see  also  description  of
79              SANE_CONFIG_DIR below).
80
81       /usr/lib64/sane/libsane-artec.a
82              The static library implementing this backend.
83
84       /usr/lib64/sane/libsane-artec.so
85              The shared library implementing this backend (present on systems
86              that support dynamic loading).
87

ENVIRONMENT

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
103       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
109              Number  Remark
110
111               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
126               50      print verbose data/debug messages
127
128               == 100  print software RGB calibration data
129               == 101  print raw data from scanner to artec.data.raw file
130
131               == 128  print out all messages
132
133       Example: export SANE_DEBUG_ARTEC=13
134
135

BUGS

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
145

SEE ALSO

147       sane(7), sane-scsi(5)
148
149

AUTHOR

151       Chris Pinkham (cpinkham@corp.infi.net)
152
153
154
155                                  11 Jul 2008                    sane-artec(5)
Impressum