SANE Scanner Access Now Easy sane-artec(5)
NAME
sane-artec - SANE backend for Artec flatbed scanners
DESCRIPTION
The sane-artec library implements a SANE (Scanner Access Now
Easy) backend that provides access to Artec/Ultima SCSI flatbed scanners. At present, the following scanners are known to work at least partially with this backend: * Artec A6000C * Artec A6000C PLUS * Artec ViewStation AT3 * BlackWidow BW4800SP (rebadged Artec AT3) * Artec ViewStation AT6 * Artec ViewStation AT12 * Artec AM12S * Plustek 19200S (rebadged Artec AM12S) Although this manual page is generally updated with each
release, up-to-date information on new releases and extrane-
ous helpful hints are available from the backend homepage: http://www4.infi.net/~cpinkham/sane/ DOCUMENTATION CONFIGURATION The contents of the artec.conf file are a list of device names that correspond to Artec scanners. Empty lines andlines starting with a hash mark (#) are ignored. See sane-
scsi(5) on details of what constitutes a valid device name. Sample file:# artec.conf
#
# this is a comment.
#
# this line says search for any SCSI devices which are scanners and have
# a vendor string of 'ULTIMA'
scsi ULTIMA#
# the next line forces the backend to assume the next scanner found has
# the specified vendor string (useful for testing rebadged models).
vendor ULTIMA#
# the next line forces the backend to assume the next scanner found has
# the specified model string (useful for testing rebadged models).
model AT3#
# now a line that actually specifies a device. The backend is going to
# assume this is an Artec/Ultima AT3 because we forced the vendor and
# model above.
sane-backends 1.0.19Last change: 24 Jan 2000 1
SANE Scanner Access Now Easy sane-artec(5)
/dev/scanner#
# once we hit a scanner device line, the forced vendor and model
# string are
# 'forgotten', so the vendor and model for this next device will be
# determined from the result of a SCSI inquiry.
/dev/sge#
SCSI ADAPTER TIPS Some Artec scanners come with an included SCSI adapter. Ifyour scanner came with a DTC ISA scsi cards, you can prob-
ably use it with recent (>= 2.2.0) kernels using the generic NCR5380 support. You must pass the following boot argument to the kernel: "dtc3181e=0x2c0,0" I do not have any information on the PCI SCSI adapter included with some newer Artec scanners. FILES /etc/sane.d/artec.conf The backend configuration file (see also description ofSANE_CONFIG_DIR below).
/usr/lib/sane/libsane-artec.a
The static library implementing this backend./usr/lib/sane/libsane-artec.so
The shared library implementing this backend (present on systems that support dynamic loading). ENVIRONMENTSANE_CONFIG_DIR
This environment variable specifies the list of direc-
tories that may contain the configuration file. Under UNIX, the directories are separated by a colon (`:'),under OS/2, they are separated by a semi- colon (`;').
If this variable is not set, the configuration file is searched in two default directories: first, the currentworking direc- tory (".") and then in /etc/sane.d. If
the value of the environment variable ends with thedirectory separator character, then the default direc-
tories are searched after the explicitly specifieddirectories. For example, setting SANE_CONFIG_DIR to
"/tmp/config:" would result in directories "tmp/config", ".", and "/etc/sane.d" being searched (in this order).SANE_DEBUG_ARTEC
If the library was compiled with debug support enabled, this environment variable controls the debug level forsane-backends 1.0.19Last change: 24 Jan 2000 2
SANE Scanner Access Now Easy sane-artec(5)
this backend. E.g., a value of 128 requests all debug output to be printed. Smaller levels reduce verbosity:SANE_DEBUG_ARTEC values
Number Remark 0 print important errors 1 print errors 2 print sense 3 print warnings4 print scanner-inquiry
5 print informations 6 print less important informations 7 print major called procedures 8 print all called procedures 9 print procedure info/data messages10 print called sane-init-routines
11 print called sane-procedures
12 print sane infos13 print sane option-control messages
50 print verbose data/debug messages == 100 print software RGB calibration data == 101 print raw data from scanner to artec.data.raw file == 128 print out all messagesExample: export SANE_DEBUG_ARTEC=13
BUGS
Known bugs in this release: A6000C+ users with firmware v1.92 or earlier have problems with the backend, the causehas not been determined. Sometimes the backend is not par-
ticularly robust, you can possibly lock up the SCSI bus(and/or machine) by not having patience enough when scan-
ning. 3-channel gamma correction is not implemented and
single-channel gamma correction is not totally working on
models other than the AT3.SEE ALSO
sane(7), sane-scsi(5)
AUTHOR Chris Pinkham (cpinkham@corp.infi.net)ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:sane-backends 1.0.19Last change: 24 Jan 2000 3
SANE Scanner Access Now Easy sane-artec(5)
_________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|____________________|____________________________________|_
| Availability | image/scanner/xsane/sane-backends|
|____________________|____________________________________|_
| Interface Stability| Uncommitted ||____________________|___________________________________|
NOTES Source for SANE is available on http://opensolaris.org.sane-backends 1.0.19Last change: 24 Jan 2000 4