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 and
lines 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. If
your 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 of
SANECONFIGDIR 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).
ENVIRONMENT
SANECONFIGDIR
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 current
working direc- tory (".") and then in /etc/sane.d. If
the value of the environment variable ends with the
directory separator character, then the default direc-
tories are searched after the explicitly specified
directories. For example, setting SANECONFIGDIR to
"/tmp/config:" would result in directories
"tmp/config", ".", and "/etc/sane.d" being searched (in
this order).
SANEDEBUGARTEC
If the library was compiled with debug support enabled,
this environment variable controls the debug level for
sane-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:
SANEDEBUGARTEC values
Number Remark
0 print important errors
1 print errors
2 print sense
3 print warnings
4 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 messages
10 print called sane-init-routines
11 print called sane-procedures
12 print sane infos
13 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 messages
Example: export SANEDEBUGARTEC=13
BUGS
Known bugs in this release: A6000C] users with firmware
v1.92 or earlier have problems with the backend, the cause
has 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)
ATRIBUTES
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)
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWsane-backend
Interface Stability Uncommitted
NOTES
Source for SANE is available on http:/opensolaris.org.
sane-backends 1.0.19Last change: 24 Jan 2000 4
|
