1sane-genesys(5)          SANE Scanner Access Now Easy          sane-genesys(5)
2
3
4

NAME

6       sane-genesys - SANE backend for GL646 and GL841 based USB flatbed scan‐
7       ners
8

DESCRIPTION

10       The sane-genesys library implements a SANE (Scanner  Access  Now  Easy)
11       backend  that  provides  access  to  USB  flatbed scanners based on the
12       Genesys GL646 and GL841 chips.  At present, the following scanners  are
13       known to work with this backend:
14
15              Medion MD6228
16              Medion MD6274
17              Hewlett-Packard HP2300C
18              Canon LiDE 35/40/50/60
19
20
21       This is BETA software. Especially if you test new or untested scanners,
22       keep your hand at the scanner's plug and unplug it, if the  head  bumps
23       at the end of the scan area.
24
25       If  you  own a scanner other than the ones listed above that works with
26       this backend, please let me know this by sending  the  scanner's  exact
27       model   name   and   the   USB   vendor   and  device  ids  (e.g.  from
28       /proc/bus/usb/devices , sane-find-scanner or syslog) to the  sane-devel
29       mailing  list.  Even  if  the scanner's name is only slightly different
30       from the models mentioned above, please let me know.
31
32       If you own a scanner that isn't detected by the genesys backend but has
33       a GL646 or GL841 chipset, you can try to add it to the backend.
34

SYSTEM ISSUES

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

CONFIGURATION

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

FILES

54       /etc/sane.d/genesys.conf
55              The   backend   configuration  file  (see  also  description  of
56              SANE_CONFIG_DIR below).
57
58       /usr/lib*/sane/libsane-genesys.a
59              The static library implementing this backend.
60
61       /usr/lib*/sane/libsane-genesys.so
62              The shared library implementing this backend (present on systems
63              that support dynamic loading).
64

ENVIRONMENT

66       SANE_CONFIG_DIR
67              This environment variable specifies the list of directories that
68              may contain the configuration file.  Under UNIX, the directories
69              are  separated  by a colon (`:'), under OS/2, they are separated
70              by a semi-colon (`;').  If this variable is not set, the config‐
71              uration  file is searched in two default directories: first, the
72              current working directory (".") and then in /etc/sane.d.  If the
73              value  of the environment variable ends with the directory sepa‐
74              rator character, then the default directories are searched after
75              the  explicitly  specified  directories.   For  example, setting
76              SANE_CONFIG_DIR to "/tmp/config:" would  result  in  directories
77              "tmp/config",  ".",  and  "/etc/sane.d"  being searched (in this
78              order).
79
80       SANE_DEBUG_GENESYS
81              If the library was compiled with  debug  support  enabled,  this
82              environment  variable controls the debug level for this backend.
83              Higher debug levels increase the verbosity of the output. If the
84              debug  level  is  set  to 1 or higher, some debug options become
85              available that are normally hidden. Handle them with care.  This
86              will print messages related to core genesys functions.
87
88       SANE_DEBUG_GENESYS_GL646
89              This  environment variable controls the debug level for the spe‐
90              cific GL646 code part.
91
92       SANE_DEBUG_GENESYS_GL841
93              This environment variable controls the debug level for the  spe‐
94              cific GL841 code part.
95
96
97              Example (full and highly verbose output for gl646):
98              export SANE_DEBUG_GENESYS=255
99              export SANE_DEBUG_GENESYS_GL646=255
100
101

SEE ALSO

103       sane(7), sane-usb(5)
104
105
106

AUTHOR

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

BUGS

116       Support for buttons is missing.
117
118sane-backends 1.0.18              20 Nov 2005                  sane-genesys(5)
Impressum