sane-avision.5

sane-avision(5)          SANE Scanner Access Now Easy          sane-avision(5)

NAME

       sane-avision  - SANE backend for original Avision and Avision OEM scan-
       ners (HP, Minolta, Mitsubishi, UMAX and possibly more) flatbed scanners

ABOUT THIS FILE

       This file only is a short descripton of the avision-backend for sane!

DESCRIPTION

       The  sane-avision  library  implements a SANE (Scanner Access Now Easy)
       backend that provides access to various Avision scanners and  the  Avi-
       sion OEM scanners labelled by HP, Minolta, Mitsubishi or Fujitsu.

CONFIGURATION

       The    configuration    file    for    this    backend    resides    in
            /usr/local/etc/sane.d/avision.conf.

       Its contents is a list of device names that correspond to  Avision  and
       Avision  compatible scanners and backend-options. Empty lines and lines
       starting with a hash mark (#) are ignored. A sample configuration  file
       is shown below:

       I  suggest  you  hold one hand on the power-button of the scanner while
       you try the first scans!

        # this is a comment

        option force-a4
        option disable-gamma-table
        option disable-calibration
        option one-calib-only
        option old-calibration

        #scsi Vendor Model Type Bus Channel ID LUN
        scsi AVISION
        scsi HP
        scsi /dev/scanner
        usb 0x03f0 0x0701

        - force-a4:
          Forces the backend to overwrite the scanable area
          returned by the scanner. This might be needed for
          the AV 630 which returns no area - or newer scanners
          which retun the area in a unkown format our backend
          doesn't recongize yet.

        - disable-gamma-table:
          Disables the usage of the scanner's gamma-table. You
          might try this if your scans hang or only produces
          random garbage.

        - disable-calibration:
          Disables the scanner's color calibration. You
          might try this if your scans hang or only produces
          random garbage.

        - one-calib-only:
          When this option is enabled, the backend will only
          perform a calibration when the backend is initialized
          and not before each scan. This might extend the life
          of the CCD, but does not work reliable with the newer
          USB scanners (they hang sometimes or return garbage
          image data). So this option should be used with care.

        - old-calibration:
          This enables the use of the old calibration code for
          testing purposes.

        Note: Any option above modifies the default code-flow
              for your scanner. The options should only be used
              when you encounter problems with the default be-
              haviour of the backend. Please report the need of
              options to the backend-author so the backend can
              be fixed as soon as possible.

DEVICE NAMES

       This backend expects device names of the form:

              scsi special usb special

       Where special is the path-name for the device  that  corresponds  to  a
       SCSI scanner or the USB vendor/product ID pair corresponding to the USB
       scanner. The special device name must be a generic  SCSI  device  or  a
       symlink  to such a device.  The program sane-find-scanner helps to find
       out the correct device. Under  Linux,  such  a  device  name  could  be
       /dev/sg0 or /dev/sga, for example.  See sane-scsi(5) for details.

        Note: Since the backend now includes native USB access,
              it is no longer needed - even considered obsolete -
              to access the scanner via the SCSI emulation (named
              hpusbscsi on Linux) for Avision USB devices such as
              the HP 53xx, HP 74xx or Minolta film-scanners.

        A list with supported devices is built into the avision backend so
        normally specifying an ID should not be necessary.

FILES

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

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

       /usr/local/lib/sane/libsane-avision.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 config-
              uration  file is searched in two default directories: first, the
              current    working    directory    (".")     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_AVISION
              If the library was compiled with  debug  support  enabled,  this
              environment  variable controls the debug level for this backend.
              Higher debug levels increase the verbosity of  the  output.  The
              debug  level  7  is the author's prefered value to debug backend
              problems.

              Example: export SANE_DEBUG_AVISION=7

SEE ALSO

       sane(7), sane-scsi(5)
       http://drocklinux.dyndns.org/rene/avision/index.html

AUTHOR

       René Rebe and Meino Christian Cramer

sane-backends 1.0.12-cvs          04 Mar 2003                  sane-avision(5)