1sane-epson2(5) SANE Scanner Access Now Easy sane-epson2(5)
2
6 sane-epson2 - SANE backend for EPSON scanners
7
9 The sane-epson2 library implements a SANE (Scanner Access Now Easy)
10 backend that provides access to Epson flatbed scanners. This library
11 supports a similar set of scanners as the sane-epson driver but was
12 developed to support a wider range of connections to the scanner;
13 include network access.
14 Because sane-epson and sane-epson2 drivers support many of the same
16 devices, if one driver gives you problems you may try disabling it to
17 try the other. This can be done by removing the driver name from the
18 dll.conf or perhaps by commenting out the options in epson.conf or
19 epson2.conf.
20 At present, the following scanners are known to work with this backend:
22 Model: Connection Type
24 --------------------------- -------------------
25 ActionScanner II SCSI, parallel
26 AcuLaser CX11 Series USB, Network
27 AcuLaser CX21 Series USB, Network
28 CX-3200 USB
29 CX-3600 USB
30 CX-3650 USB
31 CX-4050 USB
32 CX-4600 USB
33 CX-4800 USB
34 CX-5000 USB
35 CX-5200 USB
36 CX-5400 USB
37 CX-6300 USB
38 CX-6400 USB
39 CX-6500 USB
40 CX-6600 USB
41 DX-3800 USB
42 DX-5000 USB
43 DX-5050 USB
44 DX-6000 USB
45 DX-7400 USB
46 ES-300C SCSI, parallel
47 ES-300GS SCSI
48 ES-600C parallel
49 ES-1200C parallel
50 Expression 636 SCSI
51 Expression 800 SCSI
52 Expression 1600 USB, SCSI, IEEE-1394
53 Expression 1680 USB, SCSI, IEEE-1394
54 FilmScan 200 SCSI
55 GT-5000 SCSI, parallel
56 GT-5500 SCSI
57 GT-6000 parallel
58 GT-6500 parallel
59 GT-7000 SCSI
60 GT-8000 SCSI
61 GT-8500 SCSI
62 Perfection 610 USB
63 Perfection 636S SCSI
64 Perfection 636U USB
65 Perfection 640 USB
66 Perfection 1200S SCSI
67 Perfection 1200U USB
68 Perfection 1240 USB, SCSI
69 Perfection 1640 USB, SCSI
70 Perfection 1650 USB
71 Perfection 1660 USB
72 Perfection 2400 USB
73 Perfection 2450 USB, IEEE-1394
74 Perfection 3200 USB
75 Perfection 4870 USB
76 Perfection 4990 USB
77 RX-425 USB
78 RX-500 USB
79 RX-600 USB
80 RX-700 USB
81 V700 USB, IEEE-1394
82 V750 USB, IEEE-1394
83 and many more. The official list is on the Sane web site.
84 For other scanners the software may or may not work. Please send mail
86 to the sane-backend mailing list to report success with scanners not on
87 the list or problems with scanners that are listed.
88
90 The options the backend supports can either be selected through command
91 line options to programs like scanimage(1) or through GUI elements in
92 programs like xscanimage(1) or xsane(1).
93 Valid command line options and their syntax can be listed by using
95 scanimage --help -d epson2
97 Not all devices support all options.
99 Scan Mode
101 The --mode switch selects the basic mode of operation of the
102 scanner. Valid choices are Binary, Gray and Color. The Binary
103 mode is black and white only, Gray will produce 256 levels of
104 gray or more depending on the scanner and Color means 24 bit
105 color mode or more depending on the scanner. Some scanners will
106 internally use 36 bit color, their external interface however
107 may only support 24 bits.
108 The --depth option selects the bit depth the scanner is using.
110 This option is only available for scanners that support more
111 than one bit depth. Older scanners will always transfer the
112 image in 8bit mode. Newer scanners allow one to select either 8
113 bits, 12 or 14 bits per color channel. For a color scan this
114 means an effective color depth of 36 or 42 bits over all three
115 channels. The valid choices depend on the scanner model.
116 The --halftoning switch selects the mode that is used in Binary
118 mode. Valid options are "None", "Halftone A (Hard Tone)",
119 "Halftone B (Soft Tone)", "Halftone C (Net Screen)", "Dither A
120 (4x4 Bayer)", "Dither B (4x4 Spiral)", "Dither C (4x4 Net
121 Screen)", "Dither D (8x4 Net Screen)", "Text Enhanced Technol‐
122 ogy", "Download pattern A", and "Download pattern B".
123 The --dropout switch selects the so called dropout color. Valid
125 options are None, Red, Green and Blue. The default is None. The
126 dropout color is used for monochrome scanning and selects the
127 color that is not scanned. This can be used to e.g. scan an
128 original with a colored background.
129 The --brightness switch controls the brightness of the scan.
131 Valid options are integer values from -3 to 3. The default is 0.
132 The larger the brightness value, the brighter the image gets. If
133 a user defined table for the gamma correction is selected, the
134 brightness parameter is not available.
135 The --sharpness switch sets the sharpness of the image data.
137 Valid options are integer values from -2 to 2, with -2 meaning
138 "Defocus", -1 "Defocus slightly", 0 "Normal", 1 "Sharpen
139 slightly" and 2 "Sharpen".
140 The --gamma-correction switch controls the scanner's internal
142 gamma correction. Valid options are "Default", "User defined",
143 "High density printing" "Low density printing" and "High con‐
144 trast printing".
145 The --color-correction switch controls the scanner's internal
147 color correction function. Valid options are "No Correction",
148 "Impact-dot printers", "Thermal printers", "Ink-jet printers"
149 and "CRT monitors". The default is "CRT monitors".
150 The --resolution switch selects the resolution for a scan. Some
152 EPSON scanners will scan in any resolution between the lowest
153 and highest possible value. The list reported by the scanner can
154 be displayed using the "--help -d epson" parameters to scanim‐
155 age(1).
156 The --threshold switch selects the minimum brightness to get a
158 white point.
159 The --mirror option controls the way the image is scanned. By
161 reading the image data from right to left the image is mirrored.
162 Valid options are "yes" and "no". The default is "no".
163 The --auto-area-segmentation switch activates the automatic area
165 segmentation for monochrome scans. The scanner will try to
166 determine which areas are text and which contain images. The
167 image areas will be halftoned, and the text will be improved.
168 Valid options are "yes" and "no". The default is "yes".
169 The --red-gamma-table parameter can be used to download a user
171 defined gamma table for the red channel. The valid options are
172 the same as for --gamma-table.
173 The --green-gamma-table parameter can be used to download a user
175 defined gamma table for the green channel. The valid options are
176 the same as for --gamma-table.
177 The --blue-gamma-table parameter can be used to download a user
179 defined gamma table for the blue channel. The valid options are
180 the same as for --gamma-table.
181 The --wait-for-button parameter can be used to wait until the
183 button on the scanner is pressed to actually start the scan
184 process.
185 The color correction coefficients --cct-1 --cct-2 --cct-3 ...
187 --cct-9 will install color correction coefficients for the user
188 defined color correction. Values are specified as integers in
189 the range -127..127.
190 The --preview option requests a preview scan. The frontend soft‐
192 ware automatically selects a low resolution. Valid options are
193 "yes" and "no". The default is "no".
194 The geometry options -l -t -x -y control the scan area: -l sets
196 the top left x coordinate, -t the top left y coordinate, -x
197 selects the width and -y the height of the scan area. All param‐
198 eters are specified in millimeters.
199 The --source option selects the scan source. Valid options
201 depend on the installed options. The default is "Flatbed".
202 The --auto-eject option will eject a page after scanning from
204 the document feeder.
205 The --film-type option will select the film type for scans with
207 the transparency unit. This option is only activated if the TPU
208 is selected as scan source. Valid options are "Negative Film"
209 and "Positive Film".
210 The --focus-position option selects the focus position for all
212 scans. Valid options are "Focus 2.5mm above glass" and "Focus on
213 glass". The focus on the 2.5mm point above the glass is neces‐
214 sary for scans with the transparency unit, so that the scanner
215 can focus on the film if one of the film holders is used. This
216 option is only functional for selected scanners, all other scan‐
217 ners will ignore this option.
218 The --bay option selects which bay to scan
220 The --eject option ejects the sheet in the ADF.
222 The --adf-mode option select the ADF mode (simplex/duplex).
224
227 The configuration file /etc/sane.d/epson2.conf specifies the device(s)
228 that the backend will use. Possible connection types are:
229 SCSI This is the default, and if nothing else is specified the back‐
231 end software will open a given path as SCSI device. More infor‐
232 mation about valid syntax for SCSI devices can be found in
233 sane-scsi(5).
234 Usually SCSI scanners are configured with a line "scsi EPSON" in
235 this file. In some cases it may be necessary to only use the
236 string "scsi" (e.g. for the GT-6500).
237 PIO - Parallel Interface
239 The parallel interface can be configured in two ways: An integer
240 value starting at the beginning of a line will be interpreted as
241 the IO address of the parallel port. To make it clearer that a
242 configured IO address is a parallel port the port address can be
243 preceded by the string "PIO". The PIO connection does not use a
244 special device file in the /dev directory. The IO address can be
245 specified in hex mode (prefixed with "0x").
246 USB For USB scanners not automatically detect, their VENDOR and
248 PRODUCT ID can be specified manually in the config file. More
249 information about valid syntax for USB devices can be found in
250 sane-usb(5).
251 Network
253 Network scanners can be auto-discovered if autodiscovery is
254 specified after net keyword. An IP address to connect to can
255 also be used.
256
258 /usr/lib64/sane/libsane-epson2.a
259 The static library implementing this backend.
260 /usr/lib64/sane/libsane-epson2.so
262 The shared library implementing this backend (present on systems
263 that support dynamic loading).
264
266 SANE_DEBUG_EPSON2
267 If the library was compiled with debug support enabled, this
268 environment variable controls the debug level for this backend.
269 E.g., a value of 128 requests all debug output to be printed.
270 Smaller levels reduce verbosity.
271 SANE_DEBUG_EPSON2_SCSI
273 If the library was compiled with debug support enabled, this
274 environment variable controls the SCSI related debug level for
275 this backend. Only a value of 2 is supported.
276 SANE_DEBUG_EPSON2_NET
278 If the library was compiled with debug support enabled, this
279 environment variable controls the network related debug level
280 for this backend. E.g., a value of 128 requests all debug out‐
281 put to be printed. Smaller levels reduce verbosity.
282 SANE_EPSON2_CMD_LVL
284 This allows one to override the function or command level that
285 the backend uses to communicate with the scanner. The function
286 level a scanner supports is determined during the initialization
287 of the device. If the backend does not recognize the function
288 level reported by the scanner it will default to function level
289 B3. Valid function levels are A1, A2, B1, B2, B3, B4, B5, B6,
290 B7, B8, D1 and F5. Use this feature only if you know what you
291 are doing!
292
295 sane-scsi(5), sane-usb(5), scanimage(1), xscanimage(1), xsane(1)
296
299 None :-) At least none are currently known.
300
303 The backend may be used with Epson scanners that are not yet listed
304 under the list of supported devices. A scanner that is not recognized
305 may default to the function level B3, which means that not all func‐
306 tions that the scanner may be capable of are accessible.
307 If the scanner is not even recognized as an Epson scanner this is prob‐
309 ably because the device name reported by the scanner is not in the cor‐
310 rect format. Please send this information to the backend maintainer
311 (email address is in the AUTHOR section of this man page or in the
312 AUTHORS file of the SANE distribution).
313
316 The package is written by Alessandro Zummo and is based on previous
317 work done by Karl Hienz Kremer in the epson package as well as based on
318 work by Christian Bucher and Kazuhiro Sasayama.
319 22 Jan 2009 sane-epson2(5)