1sane-genesys(5) SANE Scanner Access Now Easy sane-genesys(5)
2
6 sane-genesys - SANE backend for GL646 and GL841 based USB flatbed scan‐
7 ners
8
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 Medion MD5345/MD6228/MD6274
16 Visioneer OneTouch 7100
17 Hewlett-Packard HP2300C
18 Visioneer Strobe XP100 (rev3)/XP200/XP300/Roadwarrior
19 Canon LiDE 35/40/50/60
20 Pentax DSmobile 600
21 Syscan/Ambir DocketPORT 485/487/665/685
22 Xerox Travel Scanner 100
23 This is stable software for supported models. But if you test new or
26 untested scanners, keep your hand at the scanner's plug and unplug it,
27 if the head bumps at the end of the scan area.
28 If you own a scanner other than the ones listed above that works with
30 this backend, please let me know this by sending the scanner's exact
31 model name and the USB vendor and device ids (e.g. from
32 /proc/bus/usb/devices, sane-find-scanner or syslog) to the sane-devel
33 mailing list. Even if the scanner's name is only slightly different
34 from the models mentioned above, please let me know.
35 If you own a scanner that isn't detected by the genesys backend but has
37 a GL646 or GL841 chipset, you can try to add it to the backend.
38
40 To give correct image quality, sheet fed scanners need to be calibrated
41 using the calibration sheet sold with the scanner. To do calibration,
42 you must insert this target in the feeder then start calibration either
43 by passing the --calibrate option to scanimage or by clicking on the
44 available 'calibrate' button in the 'advanced options' in a graphical
45 frontend. The result of the calibration is stored in a file in the home
46 directory of the user doing it. If you plug the scanner in another
47 machine or use it with another account, calibration will have to be
48 redone.
49
52 --lamp-off-time number
53 The lamp will be turned off after the given time (in minutes).
54 A value of 0 means that the lamp won't be turned off.
55 --threshold percent 0..100% (in steps of 1). Select minimum
57 brightness to get a white point. Pixels whith brightness below that
58 value will be scanned as black.
59 --disable-interpolation yes|no
61 When using high resolutions where the horizontal resolution is
62 smaller than vertical resolution, data is expanded by software to pre‐
63 serve picture geometry. This can be disbled by this option to get real
64 scanned data.
65 --color-filter None|Red|Green|Blue
67 When using gray or lineart this option selects the used color.
68 Using a color filter will give a monochrome scan. CIS based scanners
69 can to true gray when no filter (None value) is selected.
70
73 This backend needs libusb-0.1.6 or later installed, and hasn't tested
74 in other configuration than a linux kernel 2.6.9 or higher. However, it
75 should work any system with libusb where the SANE package can be com‐
76 piled. For setting permissions and general USB information look at
77 sane-usb(5).
78
82 The contents of the genesys.conf file is a list of usb lines containing
83 vendor and product ids that correspond to USB scanners. The file can
84 also contain option lines. Empty lines and lines starting with a hash
85 mark (#) are ignored. The scanners are autodetected by usb vendor_id
86 product_id statements which are already included into genesys.conf.
87 "vendor_id" and "product_id" are hexadecimal numbers that identify the
88 scanner.
89
91 /etc/sane.d/genesys.conf
92 The backend configuration file (see also description of
93 SANE_CONFIG_DIR below).
94 /usr/lib64/sane/libsane-genesys.a
96 The static library implementing this backend.
97 /usr/lib64/sane/libsane-genesys.so
99 The shared library implementing this backend (present on systems
100 that support dynamic loading).
101
103 SANE_CONFIG_DIR
104 This environment variable specifies the list of directories that
105 may contain the configuration file. Under UNIX, the directories
106 are separated by a colon (`:'), under OS/2, they are separated
107 by a semi-colon (`;'). If this variable is not set, the config‐
108 uration file is searched in two default directories: first, the
109 current working directory (".") and then in /etc/sane.d. If the
110 value of the environment variable ends with the directory sepa‐
111 rator character, then the default directories are searched after
112 the explicitly specified directories. For example, setting
113 SANE_CONFIG_DIR to "/tmp/config:" would result in directories
114 "tmp/config", ".", and "/etc/sane.d" being searched (in this
115 order).
116 SANE_DEBUG_GENESYS
118 If the library was compiled with debug support enabled, this
119 environment variable controls the debug level for this backend.
120 Higher debug levels increase the verbosity of the output. If the
121 debug level is set to 1 or higher, some debug options become
122 available that are normally hidden. Handle them with care. This
123 will print messages related to core genesys functions.
124 SANE_DEBUG_GENESYS_GL646
126 This environment variable controls the debug level for the spe‐
127 cific GL646 code part.
128 SANE_DEBUG_GENESYS_GL841
130 This environment variable controls the debug level for the spe‐
131 cific GL841 code part.
132 Example (full and highly verbose output for gl646):
135 export SANE_DEBUG_GENESYS=255
136 export SANE_DEBUG_GENESYS_GL646=255
137
140 Jack McGill for donating several sheetfed scanners, which made possible
141 to add support for them in the genesys backend.
142
145 sane(7), sane-usb(5)
146
150 Oliver Rauch
151 Henning Meier-Geinitz <henning@meier-geinitz.de>
152 Gerhard Jaeger <gerhard@gjaeger.de>
153 Stéphane Voltz <stef.dev@free.fr>
154 Philipp Schmid <philipp8288@web.de>
155 Pierre Willenbrock <pierre@pirsoft.dnsalias.org>
156
159 Powersaving isn't implemented for gl646 based scanner.
160
163 Currently no known bug.
164 6 Oct 2009 sane-genesys(5)