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

NAME

6       sane-genesys  -  SANE  backend for GL646, GL841, GL843, GL847 and GL124
7       based USB flatbed scanners
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, 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

CALIBRATION

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

EXTRAS SCAN OPTIONS

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

SYSTEM ISSUES

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

CONFIGURATION

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

FILES

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

ENVIRONMENT

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

CREDITS

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

SEE ALSO

199       sane(7), sane-usb(5)
200
201
202

AUTHOR

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

LIMITATIONS

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

BUGS

220       Currently no known bug.
221
222                                  26 Dec 2010                  sane-genesys(5)
Impressum