#

# sane-artec.5

    sane-artec(5)            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 extraneous 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 consti-
           tutes 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.
           /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 scan-
           ner came with a DTC ISA scsi cards, you can probably 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

           /usr/local/etc/sane.d/artec.conf
                  The   backend   configuration  file  (see  also  description  of
                  SANE_CONFIG_DIR below).

           /usr/local/lib/sane/libsane-artec.a
                  The static library implementing this backend.

           /usr/local/lib/sane/libsane-artec.so
                  The shared library implementing this backend (present on systems
                  that support dynamic loading).

## ENVIRONMENT

           SANE_CONFIG_DIR
                  This environment variable specifies the list of directories 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  con-
                  figuration  file  is searched in two default directories: first,
                  the  current   working   direc-   tory   (".")   and   then   in
                  /usr/local/etc/sane.d.  If the value of the environment variable
                  ends with the directory separator character,  then  the  default
                  directories are searched after the explicitly specified directo-
                  ries.  For example, setting  SANE_CONFIG_DIR  to  "/tmp/config:"
                  would    result    in   directories   "tmp/config",   ".",   and
                  "/usr/local/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 for 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 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 SANE_DEBUG_ARTEC=13

## BUGS

           Known  bugs  in this release: A6000C+ users with firmware v1.92 or ear-
           lier have problems with the backend, the cause has not been determined.
           Sometimes the backend is not particularly robust, you can possibly lock
           up the SCSI bus (and/or machine) by not  having  patience  enough  when
           scanning.   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@infi.net) (does not exist anymore?)

    sane-backends 1.0.12-cvs          24 Jan 2000                    sane-artec(5)