kopia lustrzana https://gitlab.com/sane-project/backends
Added documentation and description of canon630u backend. Patch from Nathan
Rutman <nathan@gordian.com>. Henning Meier-Geinitz <henning@meier-geinitz.de>DEVEL_2_0_BRANCH-1
Henning Geinitz
rodzic
d90a7a5357
commit
8a1ce4f863
|
|
@ -47,7 +47,7 @@ SECT5 = sane-abaton.5 sane-agfafocus.5 sane-apple.5 sane-as6e.5 sane-dll.5 \
|
|||
sane-st400.5 sane-mustek_pp.5 sane-dc210.5 sane-v4l.5 \
|
||||
sane-snapscan.5 sane-canon.5 sane-coolscan.5 sane-bh.5 sane-dc240.5 \
|
||||
sane-umax_pp.5 sane-umax1220u.5 sane-sm3600.5 sane-usb.5 \
|
||||
sane-mustek_usb.5 sane-sceptre.5 sane-canon_pp.5
|
||||
sane-mustek_usb.5 sane-sceptre.5 sane-canon_pp.5 sane-canon630u.5
|
||||
SECT7 = sane.7
|
||||
MANPAGES = $(SECT1) $(SECT5) $(SECT7)
|
||||
READMES = README AUTHORS COPYING ChangeLog LEVEL2 LICENSE NEWS PROBLEMS \
|
||||
|
|
@ -70,7 +70,7 @@ DISTFILES = Makefile.in backend-writing.txt doxygen-sanei.conf html.sty \
|
|||
net.tex \
|
||||
releases.txt sane-abaton.man sane-agfafocus.man sane-apple.man \
|
||||
sane-artec.man sane-as6e.man sane-avision.man sane-bh.man \
|
||||
sane-canon.man sane-coolscan.man sane-dc210.man sane-dc240.man \
|
||||
sane-canon.man sane-canon630u.man sane-coolscan.man sane-dc210.man sane-dc240.man \
|
||||
sane-dc25.man sane-dll.man sane-dmc.man sane-epson.man \
|
||||
sane-find-scanner.man sane-fujitsu.man sane-gphoto2.man sane-hp.man \
|
||||
sane-logo.png sane-logo2.jpg sane-matsushita.man sane-microtek.man \
|
||||
|
|
@ -81,7 +81,8 @@ DISTFILES = Makefile.in backend-writing.txt doxygen-sanei.conf html.sty \
|
|||
sane-scsi.man sane-sharp.man sane-sm3600.man sane-snapscan.man \
|
||||
sane-st400.man sane-tamarack.man sane-umax.man sane-umax1220u.man \
|
||||
sane-umax_pp.man sane-usb.man sane-v4l.man sane.man sane.png \
|
||||
sane.tex saned.man scanimage.man sane-sceptre.man sane-canon_pp.man
|
||||
sane.tex saned.man scanimage.man sane-sceptre.man sane-canon_pp.man \
|
||||
sane-canon630u.man
|
||||
|
||||
.PHONY: all clean depend dist distclean html html-man install \
|
||||
install-mostang sane-html uninstall
|
||||
|
|
|
|||
|
|
@ -0,0 +1,29 @@
|
|||
;
|
||||
; SANE Backend specification file
|
||||
;
|
||||
; It's basically emacs-lisp --- so ";" indicates comment to end of line.
|
||||
; All syntactic elements are keyword tokens, followed by a string or
|
||||
; keyword argument, as specified.
|
||||
;
|
||||
; ":backend" *must* be specified.
|
||||
; All other information is optional (but what good is the file without it?).
|
||||
;
|
||||
|
||||
:backend "canon630u" ; name of backend
|
||||
:manpage "sane-canon630u"
|
||||
:version "0.1" ; version of backend
|
||||
:status :alpha ; :alpha, :beta, :stable, :new
|
||||
:url "http://canon-fb630u.sourceforge.net/" ; backend home page
|
||||
|
||||
:devicetype :scanner ; start of a list of devices....
|
||||
; other types: :stillcam, :vidcam,
|
||||
; :meta, :api
|
||||
|
||||
:mfg "Canon" ; name a manufacturer
|
||||
:url "http://www.canon.com/"
|
||||
:model "CanoScan fb630u" ; name models for above-specified mfg.
|
||||
:interface "USB"
|
||||
:comment "OK"
|
||||
|
||||
; :comment and :url specifiers are optional after :mfg, :model, :desc,
|
||||
; and at the top-level.
|
||||
|
|
@ -0,0 +1,114 @@
|
|||
.TH sane-canon630u 5 "06 Apr 2002"
|
||||
.IX sane-canon630u
|
||||
.SH NAME
|
||||
sane-canon630u - SANE backend for the Canon 630u USB flatbed scanner
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.B sane-canon
|
||||
library implements a SANE (Scanner Access Now Easy) backend that
|
||||
provides access to the following Canon flatbed scanners:
|
||||
.PP
|
||||
.RS
|
||||
CanoScan 630u
|
||||
.br
|
||||
CanoScan 636u (hopefully)
|
||||
.br
|
||||
.RE
|
||||
.PP
|
||||
IMPORTANT: this is alpha code. Although there are no known bugs at this
|
||||
time, this code uses the Linux USB kernel drivers, which are currently
|
||||
in active development. So it may not work, your computer might even hang, and it cannot
|
||||
be excluded (although I consider it extremely unprobable) that your scanner
|
||||
will be damaged.
|
||||
.PP
|
||||
That said, TESTERS ARE WELCOME. Send your bug reports and comments to
|
||||
Nathan Rutman <nathan@gordian.com>
|
||||
.PP
|
||||
.SH "DEVICE NAMES"
|
||||
This backend expects device names of the form:
|
||||
.PP
|
||||
.RS
|
||||
.I special
|
||||
.RE
|
||||
.PP
|
||||
Where
|
||||
.I special
|
||||
is the path-name for the special device that corresponds to a USB scanner
|
||||
or a symlink to such a device. The program
|
||||
.IR sane-find-scanner
|
||||
helps to find out the correct device. Under Linux, such a device name
|
||||
could be
|
||||
.I /dev/usb/scanner0
|
||||
for example. See sane-usb(5) for details.
|
||||
|
||||
.SH CONFIGURATION
|
||||
The contents of the
|
||||
.I canon630u.conf
|
||||
file is a list of device names that correspond to Canon
|
||||
USB scanners. Empty lines and lines starting with a hash mark (#) are
|
||||
ignored. Only one device name can be listed in
|
||||
.IR canon630u.conf .
|
||||
|
||||
.SH NOTES
|
||||
.PP
|
||||
Due to Canon's unwillingness to provide scanner documentation, this
|
||||
software was developed by analyzing the USB traffic of the Windows
|
||||
2000 driver. So things like the calibration procedure I kind of made up;
|
||||
it seems to work for my scanner. If you have complaints, let me know.
|
||||
.PP
|
||||
This driver requires the ability to send USB Control Messages, available in
|
||||
kernel 2.4.12 or later.
|
||||
.PP
|
||||
This scanner may not be recognized (yet) by the USB kernel driver. Check
|
||||
for "Driver=usbscanner" under /proc/bus/usb/devices. If "Driver=(none)",
|
||||
try forcing it with "modprobe scanner vendor=0x04a9 product=0x2204"
|
||||
.PP
|
||||
.SH FILES
|
||||
.TP
|
||||
.I @CONFIGDIR@/canon630u.conf
|
||||
The backend configuration file (see also description of
|
||||
.B SANE_CONFIG_DIR
|
||||
below).
|
||||
.TP
|
||||
.I @LIBDIR@/libsane-canon630u.a
|
||||
The static library implementing this backend.
|
||||
.TP
|
||||
.I @LIBDIR@/libsane-canon630u.so
|
||||
The shared library implementing this backend (present on systems that
|
||||
support dynamic loading).
|
||||
.TP
|
||||
.I /tmp/canon.cal
|
||||
The calibration file used to normalize pixel brightness. This is
|
||||
calculated every time the scanner is first used after it has lost power.
|
||||
It can be forced to recalibrate by simply deleting this file.
|
||||
.SH ENVIRONMENT
|
||||
.TP
|
||||
.B SANE_CONFIG_DIR
|
||||
This environment variable specifies the list of directories that may
|
||||
contain the configuration file. Under UNIX, the directories are
|
||||
separated by a colon (`:'), under OS/2, they are separated by a
|
||||
semi-colon (`;'). If this variable is not set, the configuration file
|
||||
is searched in two default directories: first, the current working
|
||||
directory (".") and then in @CONFIGDIR@. If the value of the
|
||||
environment variable ends with the directory separator character, then
|
||||
the default directories are searched after the explicitly specified
|
||||
directories. For example, setting
|
||||
.B SANE_CONFIG_DIR
|
||||
to "/tmp/config:" would result in directories "tmp/config", ".", and
|
||||
"@CONFIGDIR@" being searched (in this order).
|
||||
.TP
|
||||
.B SANE_DEBUG_CANON630U
|
||||
If the library was compiled with debug support enabled, this
|
||||
environment variable controls the debug level for this backend. Higher
|
||||
debug levels increase the verbosity of the output.
|
||||
|
||||
Example:
|
||||
export SANE_DEBUG_CANON630U=10
|
||||
.SH "SEE ALSO"
|
||||
sane(7), sane\-usb(5), sane\-find\-scanner(1)
|
||||
.br
|
||||
http://canon-fb630u.sourceforge.net/
|
||||
.br
|
||||
.SH AUTHOR
|
||||
Nathan Rutman
|
||||
|
||||
Ładowanie…
Reference in New Issue