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.

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.
       /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 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

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

       /usr/lib/x86_64-linux-gnu/sane/libsane-artec.a
              The static library implementing this backend.

       /usr/lib/x86_64-linux-gnu/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.   On  *NIX  systems,  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 directory (".") and then in  /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 directories.  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 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 information
               6       print less important information
               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  earlier  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@corp.infi.net>

                                           11 Jul 2008                              sane-artec(5)