2010-02-10 03:44:08 +00:00
|
|
|
.TH sane\-fujitsu 5 "09 Feb 2010" "@PACKAGEVERSION@" "SANE Scanner Access Now Easy"
|
2008-07-14 10:49:06 +00:00
|
|
|
.IX sane\-fujitsu
|
2000-03-05 13:57:25 +00:00
|
|
|
|
|
|
|
.SH NAME
|
2008-07-14 10:49:06 +00:00
|
|
|
sane\-fujitsu \- SANE backend for Fujitsu flatbed and ADF scanners
|
2000-03-05 13:57:25 +00:00
|
|
|
|
|
|
|
.SH DESCRIPTION
|
2006-05-31 03:01:06 +00:00
|
|
|
The
|
2008-07-14 10:49:06 +00:00
|
|
|
.B sane\-fujitsu
|
2002-04-17 18:50:39 +00:00
|
|
|
library implements a SANE (Scanner Access Now Easy) backend which
|
2006-05-14 15:29:08 +00:00
|
|
|
provides access to most Fujitsu flatbed and ADF scanners.
|
|
|
|
|
2010-02-10 03:44:08 +00:00
|
|
|
This document describes backend version 98, which shipped with SANE 1.0.21cvs.
|
2006-05-14 15:29:08 +00:00
|
|
|
|
2008-07-02 20:43:49 +00:00
|
|
|
.SH SUPPORTED HARDWARE
|
2008-10-10 00:51:31 +00:00
|
|
|
This version supports every known model which speaks the Fujitsu SCSI and
|
2009-02-23 16:46:26 +00:00
|
|
|
SCSI\-over\-USB protocols. Specifically, the SCSI M309x and M409x series, the
|
2010-02-10 03:44:08 +00:00
|
|
|
SCSI fi\-series, most of the USB fi\-series, and the USB ScanSnap S5xx/S15xx
|
|
|
|
scanners are supported. Please see the list at
|
2008-07-14 10:49:06 +00:00
|
|
|
http://www.sane\-project.org/sane\-supported\-devices.html for details.
|
2006-05-14 15:29:08 +00:00
|
|
|
|
2008-07-02 20:43:49 +00:00
|
|
|
This backend may support other Fujitsu scanners. The best
|
|
|
|
way to determine level of support is to test the scanner directly,
|
|
|
|
or to collect a trace of the windows driver in action.
|
2008-10-10 00:51:31 +00:00
|
|
|
Please contact the author for help or with test results.
|
2008-07-02 20:43:49 +00:00
|
|
|
|
|
|
|
.SH UNSUPPORTED HARDWARE
|
2006-05-14 15:29:08 +00:00
|
|
|
The following scanners are known NOT to work with this backend,
|
2009-02-23 16:46:26 +00:00
|
|
|
either because they have a non\-fujitsu chipset, or an unsupported
|
2006-05-14 15:29:08 +00:00
|
|
|
interface type. Some of these scanners may be supported by another
|
|
|
|
backend.
|
|
|
|
.PP
|
2002-04-17 18:50:39 +00:00
|
|
|
.RS
|
2006-05-14 15:29:08 +00:00
|
|
|
.ft CR
|
|
|
|
.nf
|
2009-02-23 16:46:26 +00:00
|
|
|
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
|
2006-05-14 15:29:08 +00:00
|
|
|
SCSI: SERIAL: USB:
|
2009-02-23 16:46:26 +00:00
|
|
|
\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-
|
|
|
|
ScanStation M3093E/DE/EX fi\-4110EOX/2
|
|
|
|
ScanPartner M3096EX fi\-4010CU
|
|
|
|
SP\-Jr M3097E+/DE S300/S300M
|
|
|
|
SP\-10/10C M3099A/EH/EX fi\-60F
|
|
|
|
SP\-15C/300C fi\-5015C
|
|
|
|
SP\-600C/620C
|
2006-05-14 15:29:08 +00:00
|
|
|
.fi
|
|
|
|
.ft R
|
2002-04-17 18:50:39 +00:00
|
|
|
.RE
|
2006-05-14 15:29:08 +00:00
|
|
|
.P
|
|
|
|
|
|
|
|
.SH OPTIONS
|
2008-07-02 20:43:49 +00:00
|
|
|
Effort has been made to expose all hardware options, including:
|
2002-04-17 18:50:39 +00:00
|
|
|
.PP
|
2008-07-02 20:43:49 +00:00
|
|
|
source s
|
2002-04-17 18:50:39 +00:00
|
|
|
.RS
|
2006-05-14 15:29:08 +00:00
|
|
|
Selects the source for the scan. Options
|
|
|
|
may include "Flatbed", "ADF Front", "ADF Back", "ADF Duplex".
|
2002-04-17 18:50:39 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
2008-07-02 20:43:49 +00:00
|
|
|
mode m
|
2002-04-17 18:50:39 +00:00
|
|
|
.RS
|
2006-05-14 15:29:08 +00:00
|
|
|
Selects the mode for the scan. Options
|
|
|
|
may include "Lineart", "Halftone", "Gray", and "Color".
|
2002-04-17 18:50:39 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
2009-02-23 16:46:26 +00:00
|
|
|
resolution, y\-resolution
|
2002-04-17 18:50:39 +00:00
|
|
|
.RS
|
2008-07-14 10:49:06 +00:00
|
|
|
Controls scan resolution. Setting \-\-resolution also sets \-\-y\-resolution,
|
2006-07-15 15:15:52 +00:00
|
|
|
though this behavior is overridden by some frontends.
|
2002-04-17 18:50:39 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
2008-07-14 10:49:06 +00:00
|
|
|
tl\-x, tl\-y, br\-x, br\-y
|
2002-04-17 18:50:39 +00:00
|
|
|
.RS
|
2006-07-15 15:15:52 +00:00
|
|
|
Sets scan area upper left and lower right coordinates. These are renamed
|
|
|
|
t, l, x, y by some frontends.
|
2002-04-17 18:50:39 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
2008-10-10 00:51:31 +00:00
|
|
|
page\-width, page\-height
|
2002-04-17 18:50:39 +00:00
|
|
|
.RS
|
2006-05-14 15:29:08 +00:00
|
|
|
Sets paper size. Used by scanner to determine centering of scan
|
2006-07-15 15:15:52 +00:00
|
|
|
coordinates when using ADF and to detect double feed errors.
|
2002-04-17 18:50:39 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
2008-07-02 20:43:49 +00:00
|
|
|
Other options will be available based on the capabilities of the scanner:
|
|
|
|
machines with IPC or DTC will have additional enhancement options, those
|
2008-10-10 00:51:31 +00:00
|
|
|
with CMP will have compression options, those with a printer will have a
|
|
|
|
group of endorser options.
|
2008-07-02 20:43:49 +00:00
|
|
|
|
2010-02-10 03:44:08 +00:00
|
|
|
Additionally, several 'software' options are exposed by the backend. These
|
|
|
|
are reimplementations of features provided natively by larger scanners, but
|
|
|
|
running on the host computer. This enables smaller machines to have similar
|
|
|
|
capabilites. Please note that these features are somewhat simplistic, and
|
|
|
|
may not perform as well as the native implementations. Note also that these
|
|
|
|
features all require that the driver cache the entire image in memory. This
|
|
|
|
will almost certainly result in a reduction of scanning speed.
|
|
|
|
|
2008-07-14 10:49:06 +00:00
|
|
|
Use 'scanimage \-\-help' to get a list, but be aware that some options may
|
2008-10-10 00:51:31 +00:00
|
|
|
be settable only when another option has been set, and that advanced options
|
2008-07-02 20:43:49 +00:00
|
|
|
may be hidden by some frontend programs.
|
2006-05-14 15:29:08 +00:00
|
|
|
.PP
|
|
|
|
.SH CONFIGURATION FILE
|
2006-07-15 15:15:52 +00:00
|
|
|
The configuration file "fujitsu.conf" is used to tell the backend how to look
|
|
|
|
for scanners, and provide options controlling the operation of the backend.
|
2006-05-31 03:01:06 +00:00
|
|
|
This file is read each time the frontend asks the backend for a list
|
2006-05-14 15:29:08 +00:00
|
|
|
of scanners, generally only when the frontend starts. If the configuration
|
|
|
|
file is missing, the backend will use a set of compiled defaults, which
|
|
|
|
are identical to the default configuration file shipped with SANE.
|
|
|
|
.PP
|
|
|
|
Scanners can be specified in the configuration file in 4 ways:
|
|
|
|
.PP
|
|
|
|
"scsi FUJITSU"
|
2002-04-17 18:50:39 +00:00
|
|
|
.RS
|
2006-05-31 03:01:06 +00:00
|
|
|
Requests backend to search all scsi busses in the system for a device
|
2006-05-14 15:29:08 +00:00
|
|
|
which reports itself to be a scanner made by 'FUJITSU'.
|
2002-04-17 18:50:39 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
2006-05-14 15:29:08 +00:00
|
|
|
"scsi /dev/sg0" (or other scsi device file)
|
2002-04-17 18:50:39 +00:00
|
|
|
.RS
|
2006-05-14 15:29:08 +00:00
|
|
|
Requests backend to open the named scsi device. Only useful if you have
|
|
|
|
multiple compatible scanners connected to your system, and need to
|
|
|
|
specify one. Probably should not be used with the other "scsi" line above.
|
2002-04-17 18:50:39 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
2006-05-14 15:29:08 +00:00
|
|
|
"usb 0x04c5 0x1042" (or other vendor/product ids)
|
2002-04-17 18:50:39 +00:00
|
|
|
.RS
|
2006-05-31 03:01:06 +00:00
|
|
|
Requests backend to search all usb busses in the system for a device
|
2006-05-14 15:29:08 +00:00
|
|
|
which uses that vendor and product id. The device will then be queried
|
|
|
|
to determine if it is a Fujitsu scanner.
|
2002-04-17 18:50:39 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
2006-05-14 15:29:08 +00:00
|
|
|
"usb /dev/usb/scanner0" (or other device file)
|
2002-04-17 18:50:39 +00:00
|
|
|
.RS
|
2010-02-10 03:44:08 +00:00
|
|
|
Some systems use a kernel driver to access usb scanners. This method is
|
|
|
|
untested.
|
2002-04-17 18:50:39 +00:00
|
|
|
.RE
|
2006-05-14 15:29:08 +00:00
|
|
|
.PP
|
2008-07-14 10:49:06 +00:00
|
|
|
The only configuration option supported is "buffer\-size=xxx", allowing you
|
2006-05-31 03:01:06 +00:00
|
|
|
to set the number of bytes in the data buffer to something other than the
|
2009-02-23 16:46:26 +00:00
|
|
|
compiled\-in default, 65536 (64K). Some users report that their scanner will
|
|
|
|
"hang" mid\-page, or fail to transmit the image if the buffer is not large
|
2006-05-31 03:01:06 +00:00
|
|
|
enough.
|
2006-05-14 15:29:08 +00:00
|
|
|
.PP
|
|
|
|
Note: This option may appear multiple times in the configuration file. It only
|
2006-05-31 03:01:06 +00:00
|
|
|
applies to scanners discovered by 'scsi/usb' lines that follow this option.
|
2006-05-14 15:29:08 +00:00
|
|
|
.PP
|
|
|
|
Note: The backend does not place an upper bound on this value, as some users
|
2006-05-31 03:01:06 +00:00
|
|
|
required it to be quite large. Values above the default are not recommended,
|
2006-05-14 15:29:08 +00:00
|
|
|
and may crash your OS or lockup your scsi card driver. You have been
|
|
|
|
warned.
|
2006-05-19 21:12:41 +00:00
|
|
|
.PP
|
2002-04-17 18:50:39 +00:00
|
|
|
|
2006-05-14 15:29:08 +00:00
|
|
|
.SH ENVIRONMENT
|
|
|
|
The backend uses a single environment variable, SANE_DEBUG_FUJITSU, which
|
|
|
|
enables debugging output to stderr. Valid values are:
|
|
|
|
.PP
|
|
|
|
.RS
|
|
|
|
5 Errors
|
|
|
|
.br
|
|
|
|
10 Function trace
|
|
|
|
.br
|
|
|
|
15 Function detail
|
|
|
|
.br
|
|
|
|
20 Option commands
|
2002-04-17 18:50:39 +00:00
|
|
|
.br
|
2006-05-31 03:01:06 +00:00
|
|
|
25 SCSI/USB trace
|
|
|
|
.br
|
|
|
|
30 SCSI/USB detail
|
2006-07-15 15:15:52 +00:00
|
|
|
.br
|
|
|
|
35 Useless noise
|
2006-05-14 15:29:08 +00:00
|
|
|
.RE
|
2002-04-17 18:50:39 +00:00
|
|
|
|
2006-05-14 15:29:08 +00:00
|
|
|
.SH KNOWN ISSUES
|
2008-10-10 00:51:31 +00:00
|
|
|
Flatbed units may fail to scan at maximum area, particularly at
|
|
|
|
high resolution.
|
|
|
|
.PP
|
|
|
|
Any model that does not support VPD during inquiry will not function until
|
2008-07-02 20:43:49 +00:00
|
|
|
an override is added to the backend.
|
2008-10-10 00:51:31 +00:00
|
|
|
.PP
|
|
|
|
CCITT Fax compression used by older scanners is not supported.
|
2009-04-21 01:18:04 +00:00
|
|
|
.PP
|
2010-02-10 03:44:08 +00:00
|
|
|
Hardware automatic paper width detection (aka auto-cropping) is not supported.
|
2009-04-21 01:18:04 +00:00
|
|
|
.PP
|
|
|
|
JPEG output is supported by the backend, but not by the SANE protocol, so is
|
|
|
|
disabled in this release. It can be enabled if you rebuild from source.
|
2002-04-17 18:50:39 +00:00
|
|
|
|
2008-07-02 20:43:49 +00:00
|
|
|
.SH CREDITS
|
2006-05-14 15:29:08 +00:00
|
|
|
m3091 backend: Frederik Ramm <frederik a t remote d o t org>
|
|
|
|
.br
|
|
|
|
m3096g backend: Randolph Bentson <bentson a t holmsjoen d o t com>
|
|
|
|
.br
|
|
|
|
(with credit to the unnamed author of the coolscan driver)
|
|
|
|
.br
|
2009-02-23 16:46:26 +00:00
|
|
|
fujitsu backend, m3093, fi\-4340C, ipc, cmp, long\-time maintainer:
|
2006-05-14 15:29:08 +00:00
|
|
|
.br
|
|
|
|
Oliver Schirrmeister <oschirr a t abm d o t de>
|
|
|
|
.br
|
2009-02-23 16:46:26 +00:00
|
|
|
m3092: Mario Goppold <mgoppold a t tbzpariv d o t tcc\-chemnitz dot de>
|
2006-05-31 03:01:06 +00:00
|
|
|
.br
|
2009-02-23 16:46:26 +00:00
|
|
|
fi\-4220C and basic USB support: Ron Cemer <ron a t roncemer d o t com>
|
2006-05-14 15:29:08 +00:00
|
|
|
.br
|
2009-02-23 16:46:26 +00:00
|
|
|
fi\-4120, fi\-series color, backend re\-write, jpeg, current maintainer:
|
2007-01-27 01:42:13 +00:00
|
|
|
m. allan noah: <kitno455 a t gmail d o t com>
|
2000-03-05 13:57:25 +00:00
|
|
|
|
2008-06-25 02:30:54 +00:00
|
|
|
JPEG output support funded by:
|
|
|
|
Archivista GmbH
|
|
|
|
www.archivista.ch
|
|
|
|
|
|
|
|
Endorser support funded by:
|
|
|
|
O A S Oilfield Accounting Service Ltd
|
2009-02-23 16:46:26 +00:00
|
|
|
1500, 840 \- 7th Avenue S.W.
|
2008-06-25 02:30:54 +00:00
|
|
|
Calgary, Alberta
|
|
|
|
T2P 3G2 Canada
|
2009-02-23 16:46:26 +00:00
|
|
|
1\-403\-263\-2600
|
2008-06-25 02:30:54 +00:00
|
|
|
www.oas.ca
|
|
|
|
|
2009-08-17 13:49:22 +00:00
|
|
|
Automatic length detection support funded by:
|
|
|
|
Martin G. Miller
|
|
|
|
mgmiller at optonline.net
|
|
|
|
|
2009-04-21 01:18:04 +00:00
|
|
|
Hardware donated by Fujitsu Computer Products of America, Inc.
|
|
|
|
http://us.fujitsu.com/fcpa
|
|
|
|
|
2000-03-05 13:57:25 +00:00
|
|
|
.SH "SEE ALSO"
|
2002-04-17 18:50:39 +00:00
|
|
|
sane(7),
|
2008-07-14 10:49:06 +00:00
|
|
|
sane\-scsi(5),
|
|
|
|
sane\-usb(5),
|
|
|
|
sane\-sp15c(5),
|
|
|
|
sane\-avision(5),
|
|
|
|
sane\-epjitsu(5)
|
2000-03-05 13:57:25 +00:00
|
|
|
|
|
|
|
.SH AUTHOR
|
2007-01-27 01:42:13 +00:00
|
|
|
m. allan noah: <kitno455 a t gmail d o t com>
|
2000-03-05 13:57:25 +00:00
|
|
|
|