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

CONFIGURATION

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
36       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
65

SCSI ADAPTER TIPS

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
74

FILES

76       /etc/sane.d/artec.conf
77              The  backend  configuration  file  (see  also   description   of
78              SANE_CONFIG_DIR below).
79
80       /usr/lib64/sane/libsane-artec.a
81              The static library implementing this backend.
82
83       /usr/lib64/sane/libsane-artec.so
84              The shared library implementing this backend (present on systems
85              that support dynamic loading).
86
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  this
101              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               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
129       Example: export SANE_DEBUG_ARTEC=13
130
131

BUGS

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
141

SEE ALSO

143       sane(7), sane-scsi(5)
144
145

AUTHOR

147       Chris Pinkham <cpinkham@corp.infi.net>
148
149
150
151                                  11 Jul 2008                    sane-artec(5)
Impressum