sane-genesys.5

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

NAME

       sane-genesys - SANE backend for GL646 and GL841 based USB flatbed scan-
       ners

DESCRIPTION

       The sane-genesys library implements a SANE (Scanner  Access  Now  Easy)
       backend  that  provides  access  to  USB  flatbed scanners based on the
       Genesys GL646 and GL841 chips.  At present, the following scanners  are
       known to work with this backend:

              Medion MD6228
              Medion MD6274
              Hewlett-Packard HP2300C

       This is BETA software. Especially if you test new or untested scanners,
       keep your hand at the scanner's plug and unplug it, if the  head  bumps
       at the end of the scan area.

       If  you  own a scanner other than the ones listed above that works with
       this backend, please let me know this by sending  the  scanner's  exact
       model   name   and   the   USB   vendor   and  device  ids  (e.g.  from
       /proc/bus/usb/devices , sane-find-scanner or syslog) to the  sane-devel
       mailing  list.  Even  if  the scanner's name is only slightly different
       from the models mentioned above, please let me know.

       If you own a scanner that isn't detected by the genesys backend but has
       a  GL646  or  GL841 chipset, you can try to add it to the backend. Cur-
       rently, support for GL841 scanners is not implemented.

SYSTEM ISSUES

       This backend needs libusb-0.1.6 or later installed, and  hasn't  tested
       in other configuration than a linux kernel 2.6.9 or higher. However, it
       should work any system with libusb where the SANE package can  be  com-
       piled.  For  setting  permissions  and  general USB information look at
       sane-usb(5).

CONFIGURATION

       The contents of the genesys.conf file is a list of usb lines containing
       vendor  and  product  ids that correspond to USB scanners. The file can
       also contain option lines.  Empty lines and lines starting with a  hash
       mark  (#)  are ignored.  The scanners are autodetected by usb vendor_id
       product_id statements which are already included  into  genesys.conf  .
       "vendor_id"  and  "product_id" are hexadecimal numbers that identfy the
       scanner.

FILES

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

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

       /usr/local/lib/sane/libsane-genesys.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_GENESYS
              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. If the
              debug level is set to 1 or higher,  some  debug  options  become
              available  that are normally hidden. Handle them with care. This
              will  print  messages  related  to   core   genesys   functions.
              SANE_DEBUG_GENESYS_GL646  This environment variable controls the
              debug level for the specific GL646 code part.

              Example   (full   and    highly    verbose    output):    export
              SANE_DEBUG_GENESYS=255 export SANE_DEBUG_GENESYS_GL646=255

SEE ALSO

       sane(7), sane-usb(5)

AUTHOR

       Oliver Rauch
       Henning Meier-Geinitz <henning@meier-geinitz.de>
       Gerhard Jaeger <gerhard@gjaeger.de>
       Stéphane Voltz <svoltz@numericable.fr>
       Philipp Schmid <philipp8288@web.de>

BUGS

       Support for buttons is missing.

sane-backends 1.0.16              3 July 2005                  sane-genesys(5)