1sane-genesys(5) SANE Scanner Access Now Easy sane-genesys(5)
2
3
4
6 sane-genesys - SANE backend for GL646, GL841, GL843, GL847 and GL124
7 based USB flatbed scanners
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, GL841 and GL847 chips. At present, the following scan‐
13 ners are known to work with this backend:
14
15 Canon LiDE 35/40/50/60/100/110/200/210
16 Hewlett-Packard HP2300C/HP3670/HP3690
17 Medion MD5345/MD6228/MD6274
18 Panasonic KV-SS080
19 Plustek OpticBook 3600
20 Pentax DSmobile 600
21 Syscan/Ambir DocketPORT 467/485/487/665/685
22 Visioneer OneTouch 7100/Strobe XP100 (rev3)/XP200/XP300/Roadwar‐
23 rior
24 Xerox Travel Scanner 100
25
26
27 This is stable software for supported models. But if you test new or
28 untested scanners, keep your hand at the scanner's plug and unplug it,
29 if the head bumps at the end of the scan area.
30
31 If you own a scanner other than the ones listed above that works with
32 this backend, please let me know this by sending the scanner's exact
33 model name and the USB vendor and device ids (e.g. from
34 /proc/bus/usb/devices, sane-find-scanner or syslog) to the sane-devel
35 mailing list. Even if the scanner's name is only slightly different
36 from the models mentioned above, please let me know.
37
38 If you own a scanner that isn't detected by the genesys backend but has
39 a GL646, GL841, GL843 or GL847 chipset, you can try to add it to the
40 backend.
41
43 To give correct image quality, sheet fed scanners need to be calibrated
44 using the calibration sheet sold with the scanner. To do calibration,
45 you must insert this target in the feeder then start calibration either
46 by passing the --calibrate option to scanimage or by clicking on the
47 available 'calibrate' button in the 'advanced options' in a graphical
48 frontend. The result of the calibration is stored in a file in the home
49 directory of the user doing it. If you plug the scanner in another
50 machine or use it with another account, calibration will have to be
51 redone.
52
53
55 --lamp-off-time number
56 The lamp will be turned off after the given time (in
57 minutes). A value of 0 means that the lamp won't be turned off.
58
59 --threshold percent
60 0..100% (in steps of 1). Select minimum brightness to get a
61 white point. Pixels whith brightness below that value will be
62 scanned as black.
63
64 --disable-interpolation yes|no
65 When using high resolutions where the horizontal resolu‐
66 tion is smaller than vertical resolution, data is expanded by
67 software to preserve picture geometry. This can be disbled by
68 this option to get real scanned data.
69
70 --color-filter None|Red|Green|Blue
71 When using gray or lineart this option selects the used
72 color. Using a color filter will give a monochrome scan. CIS
73 based scanners can to true gray when no filter (None value) is
74 selected.
75
76
77 Additionally, several 'software' options are exposed by the backend.
78 These are reimplementations of features provided natively by larger
79 scanners, but running on the host computer. This enables smaller
80 machines to have similar capabilites. Please note that these features
81 are somewhat simplistic, and may not perform as well as the native
82 implementations. Note also that these features all require that the
83 driver cache the entire image in memory. This will almost certainly
84 result in a reduction of scanning speed.
85
86 --swcrop
87 Requests the driver to detect the extremities of the paper
88 within the larger image, and crop the empty edges.
89
90 --swdeskew
91 Requests the driver to detect the rotation of the paper
92 within the larger image, and counter the rotation.
93
94 --swdespeck --despeck X
95 Requests the driver to find and remove dots of X diameter
96 or smaller from the image, and fill the space with the average
97 surrounding color.
98
99
101 This backend needs libusb-0.1.6 or later installed, and hasn't tested
102 in other configuration than a linux kernel 2.6.9 or higher. However, it
103 should work any system with libusb where the SANE package can be com‐
104 piled. For setting permissions and general USB information look at
105 sane-usb(5).
106
107
108
110 The contents of the genesys.conf file is a list of usb lines containing
111 vendor and product ids that correspond to USB scanners. The file can
112 also contain option lines. Empty lines and lines starting with a hash
113 mark (#) are ignored. The scanners are autodetected by usb vendor_id
114 product_id statements which are already included into genesys.conf.
115 "vendor_id" and "product_id" are hexadecimal numbers that identify the
116 scanner.
117
119 /etc/sane.d/genesys.conf
120 The backend configuration file (see also description of
121 SANE_CONFIG_DIR below).
122
123 /usr/lib64/sane/libsane-genesys.a
124 The static library implementing this backend.
125
126 /usr/lib64/sane/libsane-genesys.so
127 The shared library implementing this backend (present on systems
128 that support dynamic loading).
129
131 SANE_CONFIG_DIR
132 This environment variable specifies the list of directories that
133 may contain the configuration file. Under UNIX, the directories
134 are separated by a colon (`:'), under OS/2, they are separated
135 by a semi-colon (`;'). If this variable is not set, the config‐
136 uration file is searched in two default directories: first, the
137 current working directory (".") and then in /etc/sane.d. If the
138 value of the environment variable ends with the directory sepa‐
139 rator character, then the default directories are searched after
140 the explicitly specified directories. For example, setting
141 SANE_CONFIG_DIR to "/tmp/config:" would result in directories
142 "tmp/config", ".", and "/etc/sane.d" being searched (in this
143 order).
144
145 SANE_DEBUG_GENESYS
146 If the library was compiled with debug support enabled, this
147 environment variable controls the debug level for this backend.
148 Higher debug levels increase the verbosity of the output. If the
149 debug level is set to 1 or higher, some debug options become
150 available that are normally hidden. Handle them with care. This
151 will print messages related to core genesys functions.
152
153 SANE_DEBUG_GENESYS_LOW
154 This environment variable controls the debug level for low level
155 functions common to all genesys ASICs.
156
157 SANE_DEBUG_GENESYS_GL646
158 This environment variable controls the debug level for the spe‐
159 cific GL646 code part.
160
161 SANE_DEBUG_GENESYS_GL841
162 This environment variable controls the debug level for the spe‐
163 cific GL841 code part.
164
165 SANE_DEBUG_GENESYS_GL843
166 This environment variable controls the debug level for the spe‐
167 cific GL843 code part.
168
169 SANE_DEBUG_GENESYS_GL847
170 This environment variable controls the debug level for the spe‐
171 cific GL847 code part.
172
173 SANE_DEBUG_GENESYS_GL124
174 This environment variable controls the debug level for the spe‐
175 cific GL124 code part.
176
177
178 Example (full and highly verbose output for gl646):
179 export SANE_DEBUG_GENESYS=255
180 export SANE_DEBUG_GENESYS_LOW=255
181 export SANE_DEBUG_GENESYS_GL646=255
182
183
185 Jack McGill for donating several sheetfed and flatbed scanners, which
186 made possible to add support for them in the genesys backend:
187 Hewlett-Packard HP3670
188 Visioneer Strobe XP100 (rev3)/XP200/XP300/Roadwarrior
189 Canon LiDE 200
190 Pentax DSmobile 600
191 Syscan/Ambir DocketPORT 467/485/487/665/685
192 Xerox Travel Scanner 100
193
194 cncsolutions (http://www.cncsolutions.com.br) sponsored and supported
195 the work on the Panasonic KV-SS080.
196
197
199 sane(7), sane-usb(5)
200
201
202
204 Oliver Rauch
205 Henning Meier-Geinitz <henning@meier-geinitz.de>
206 Gerhard Jaeger <gerhard@gjaeger.de>
207 Stéphane Voltz <stef.dev@free.fr>
208 Philipp Schmid <philipp8288@web.de>
209 Pierre Willenbrock <pierre@pirsoft.dnsalias.org>
210
211
213 Powersaving isn't implemented for gl646 based scanner.
214
215 This backend will be much slower if not using libusb-1.0. So be sure
216 that sane-backends is built with the --enable-libusb_1_0 option.
217
218
220 Currently no known bug.
221
222 26 Dec 2010 sane-genesys(5)