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

NAME

6       sane-epson2 - SANE backend for EPSON scanners
7

DESCRIPTION

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
15       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
21       At present, the following scanners are known to work with this backend:
22
23              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
85       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

OPTIONS

90       The options the backend supports can either be selected through command
91       line options to programs like scanimage or through GUI elements in pro‐
92       grams like xscanimage or xsane.
93
94       Valid command line options and their syntax can be listed by using
95              scanimage --help -d epson2
96       Not all devices support all options.
97
98       Scan Mode
99              The  --mode  switch  selects  the basic mode of operation of the
100              scanner. Valid choices are Binary, Gray and Color.   The  Binary
101              mode  is  black  and white only, Gray will produce 256 levels of
102              gray or more depending on the scanner and  Color  means  24  bit
103              color mode or more depending on the scanner.  Some scanners will
104              internally use 36 bit color, their  external  interface  however
105              may only support 24 bits.
106
107              The  --depth  option selects the bit depth the scanner is using.
108              This option is only available for  scanners  that  support  more
109              than  one  bit  depth.  Older  scanners will always transfer the
110              image in 8bit mode. Newer scanners allow one to select either  8
111              bits,  12  or  14  bits per color channel. For a color scan this
112              means an effective color depth of 36 or 42 bits over  all  three
113              channels. The valid choices depend on the scanner model.
114
115              The  --halftoning switch selects the mode that is used in Binary
116              mode. Valid  options  are  "None",  "Halftone  A  (Hard  Tone)",
117              "Halftone  B  (Soft Tone)", "Halftone C (Net Screen)", "Dither A
118              (4x4 Bayer)", "Dither  B  (4x4  Spiral)",  "Dither  C  (4x4  Net
119              Screen)",  "Dither  D (8x4 Net Screen)", "Text Enhanced Technol‐
120              ogy", "Download pattern A", and "Download pattern B".
121
122              The --dropout switch selects the so called dropout color.  Valid
123              options  are None, Red, Green and Blue. The default is None. The
124              dropout color is used for monochrome scanning  and  selects  the
125              color  that  is  not  scanned.  This can be used to e.g. scan an
126              original with a colored background.
127
128              The --brightness switch controls the  brightness  of  the  scan.
129              Valid options are integer values from -3 to 3. The default is 0.
130              The larger the brightness value, the brighter the image gets. If
131              a  user  defined table for the gamma correction is selected, the
132              brightness parameter is not available.
133
134              The --sharpness switch sets the sharpness  of  the  image  data.
135              Valid  options  are integer values from -2 to 2, with -2 meaning
136              "Defocus",  -1  "Defocus  slightly",  0  "Normal",  1   "Sharpen
137              slightly" and 2 "Sharpen".
138
139              The  --gamma-correction  switch  controls the scanner's internal
140              gamma correction. Valid options are "Default",  "User  defined",
141              "High  density  printing"  "Low density printing" and "High con‐
142              trast printing".
143
144              The --color-correction switch controls  the  scanner's  internal
145              color  correction  function.  Valid options are "No Correction",
146              "Impact-dot printers", "Thermal  printers",  "Ink-jet  printers"
147              and "CRT monitors". The default is "CRT monitors".
148
149              The  --resolution switch selects the resolution for a scan. Some
150              EPSON scanners will scan in any resolution  between  the  lowest
151              and highest possible value. The list reported by the scanner can
152              be displayed using the "--help -d epson" parameters  to  scanim‐
153              age.
154
155              The  --threshold  switch selects the minimum brightness to get a
156              white point.
157
158              The --mirror option controls the way the image  is  scanned.  By
159              reading the image data from right to left the image is mirrored.
160              Valid options are "yes" and "no". The default is "no".
161
162              The --auto-area-segmentation switch activates the automatic area
163              segmentation  for  monochrome  scans.  The  scanner  will try to
164              determine which areas are text and  which  contain  images.  The
165              image  areas  will  be halftoned, and the text will be improved.
166              Valid options are "yes" and "no". The default is "yes".
167
168              The --red-gamma-table parameter can be used to download  a  user
169              defined  gamma  table for the red channel. The valid options are
170              the same as for --gamma-table.
171
172              The --green-gamma-table parameter can be used to download a user
173              defined gamma table for the green channel. The valid options are
174              the same as for --gamma-table.
175
176              The --blue-gamma-table parameter can be used to download a  user
177              defined  gamma table for the blue channel. The valid options are
178              the same as for --gamma-table.
179
180              The --wait-for-button parameter can be used to  wait  until  the
181              button  on  the  scanner  is  pressed to actually start the scan
182              process.
183
184              The color correction coefficients --cct-1  --cct-2  --cct-3  ...
185              --cct-9  will install color correction coefficients for the user
186              defined color correction. Values are specified  as  integers  in
187              the range -127..127.
188
189              The --preview option requests a preview scan. The frontend soft‐
190              ware automatically selects a low resolution. Valid  options  are
191              "yes" and "no". The default is "no".
192
193              The  geometry options -l -t -x -y control the scan area: -l sets
194              the top left x coordinate, -t the  top  left  y  coordinate,  -x
195              selects the width and -y the height of the scan area. All param‐
196              eters are specified in millimeters.
197
198              The --source option  selects  the  scan  source.  Valid  options
199              depend on the installed options. The default is "Flatbed".
200
201              The  --auto-eject  option  will eject a page after scanning from
202              the document feeder.
203
204              The --film-type option will select the film type for scans  with
205              the  transparency unit. This option is only activated if the TPU
206              is selected as scan source. Valid options  are  "Negative  Film"
207              and "Positive Film".
208
209              The  --focus-position  option selects the focus position for all
210              scans. Valid options are "Focus 2.5mm above glass" and "Focus on
211              glass".  The  focus on the 2.5mm point above the glass is neces‐
212              sary for scans with the transparency unit, so that  the  scanner
213              can  focus on the film if one of the film holders is used.  This
214              option is only functional for selected scanners, all other scan‐
215              ners will ignore this option.
216
217              The --bay option selects which bay to scan
218
219              The --eject option ejects the sheet in the ADF.
220
221              The --adf-mode option select the ADF mode (simplex/duplex).
222
223

CONFIGURATION FILE

225       The  configuration file /etc/sane.d/epson2.conf specifies the device(s)
226       that the backend will use. Possible connection types are:
227
228       SCSI   This is the default, and if nothing else is specified the  back‐
229              end  software will open a given path as SCSI device. More infor‐
230              mation about valid syntax for  SCSI  devices  can  be  found  in
231              sane-scsi(5).
232              Usually SCSI scanners are configured with a line "scsi EPSON" in
233              this file. In some cases it may be necessary  to  only  use  the
234              string "scsi" (e.g. for the GT-6500).
235
236       PIO - Parallel Interface
237              The parallel interface can be configured in two ways: An integer
238              value starting at the beginning of a line will be interpreted as
239              the  IO  address of the parallel port. To make it clearer that a
240              configured IO address is a parallel port the port address can be
241              preceded  by the string "PIO". The PIO connection does not use a
242              special device file in the /dev directory. The IO address can be
243              specified in hex mode (prefixed with "0x").
244
245       USB    For  USB  scanners  not  automatically  detect, their VENDOR and
246              PRODUCT ID can be specified manually in the config  file.   More
247              information  about  valid syntax for USB devices can be found in
248              sane-usb(5).
249
250       Network
251              Network scanners can  be  auto-discovered  if  autodiscovery  is
252              specified  after  net  keyword.  An IP address to connect to can
253              also be used.
254

FILES

256       /usr/lib64/sane/libsane-epson2.a
257              The static library implementing this backend.
258
259       /usr/lib64/sane/libsane-epson2.so
260              The shared library implementing this backend (present on systems
261              that support dynamic loading).
262

ENVIRONMENT

264       SANE_DEBUG_EPSON2
265              If  the  library  was  compiled with debug support enabled, this
266              environment variable controls the debug level for this  backend.
267              E.g.,  a  value  of 128 requests all debug output to be printed.
268              Smaller levels reduce verbosity.
269
270       SANE_DEBUG_EPSON2_SCSI
271              If the library was compiled with  debug  support  enabled,  this
272              environment  variable  controls the SCSI related debug level for
273              this backend.  Only a value of 2 is supported.
274
275       SANE_DEBUG_EPSON2_NET
276              If the library was compiled with  debug  support  enabled,  this
277              environment  variable  controls  the network related debug level
278              for this backend.  E.g., a value of 128 requests all debug  out‐
279              put to be printed.  Smaller levels reduce verbosity.
280
281       SANE_EPSON2_CMD_LVL
282              This  allows  one to override the function or command level that
283              the backend uses to communicate with the scanner.  The  function
284              level a scanner supports is determined during the initialization
285              of the device. If the backend does not  recognize  the  function
286              level  reported by the scanner it will default to function level
287              B3. Valid function levels are A1, A2, B1, B2, B3,  B4,  B5,  B6,
288              B7,  B8,  D1  and F5. Use this feature only if you know what you
289              are doing!
290
291

SEE ALSO

293       sane-scsi(5), sane-usb(5), scanimage(1), xscanimage(1), xsane(1)
294
295

BUGS

297       None :-) At least none are currently known.
298
299

UNSUPPORTED DEVICES

301       The backend may be used with Epson scanners that  are  not  yet  listed
302       under  the  list of supported devices. A scanner that is not recognized
303       may default to the function level B3, which means that  not  all  func‐
304       tions that the scanner may be capable of are accessible.
305
306       If the scanner is not even recognized as an Epson scanner this is prob‐
307       ably because the device name reported by the scanner is not in the cor‐
308       rect  format.  Please  send  this information to the backend maintainer
309       (email address is in the AUTHOR section of this  man  page  or  in  the
310       AUTHORS file of the SANE distribution).
311
312

AUTHOR

314       The  package  is  written  by Alessandro Zummo and is based on previous
315       work done by Karl Hienz Kremer in the epson package as well as based on
316       work by Christian Bucher and Kazuhiro Sasayama
317
318
319
320                                  22 Jan 2009                   sane-epson2(5)
Impressum