kopia lustrzana https://gitlab.com/sane-project/backends
Removed (now again in mustek_pp backend).
rodzic
dc41ea490d
commit
ff2e1ba2cc
|
@ -1,476 +0,0 @@
|
|||
.TH sane-mustek_pp_ccd 5 "3 Oct 2003" "@PACKAGEVERSION@" "SANE Scanner Access Now Easy"
|
||||
.IX sane-mustek_pp_ccd
|
||||
.SH NAME
|
||||
sane-mustek_pp_ccd \- SANE backend for Mustek CCD parallel port flatbed scanners
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.B sane-mustek_pp_ccd
|
||||
library implements a SANE (Scanner Access Now Easy) backend that
|
||||
provides access to Mustek CCD parallel port flatbed scanners. The
|
||||
following scanners might work with this backend:
|
||||
.PP
|
||||
.RS
|
||||
Model: ASIC ID: CCD Type: works:
|
||||
.br
|
||||
-------------------- --------- ---------- -------
|
||||
.br
|
||||
SE 6000 P 1013 00 yes
|
||||
.br
|
||||
SM 4800 P 1013/1015 04/01 yes
|
||||
.br
|
||||
SE 1200 ED Plus 1015 01 partly
|
||||
.br
|
||||
SM 1200 ED Plus 1015 01 partly
|
||||
.br
|
||||
600 III EP Plus 1013/1015 00/01 yes
|
||||
.br
|
||||
SE 600 SEP 1013 ?? yes
|
||||
.br
|
||||
MD9848 1015 00 yes
|
||||
.br
|
||||
Gallery 4800 ???? ?? yes
|
||||
.br
|
||||
Viviscan Compact II 1013 00 yes
|
||||
.RE
|
||||
.PP
|
||||
Other scanners, especially scanners using a CIS type sensor are not supported by this
|
||||
backend. Have a look at the
|
||||
.BR sane-mustek_pp (5)
|
||||
backend for CIS scanners.
|
||||
.PP
|
||||
Please note that this backend is still under construction. I don't know
|
||||
which scanners work or which will work in future releases.
|
||||
.PP
|
||||
You have to enable the backend explicitly in your dll.conf. Just remove the hash mark in the
|
||||
line "mustek_pp_ccd".
|
||||
.PP
|
||||
Some scanners work faster when
|
||||
.B EPP/ECP
|
||||
is enabled in the BIOS.
|
||||
.PP
|
||||
Note that the backend needs to run as root. To allow user access to the scanner run the backend
|
||||
through the network interface (See saned(1) and sane\-net(5)). Note also that the backend
|
||||
.I does not
|
||||
support
|
||||
.I parport sharing ,
|
||||
i.e. if you try printing while scanning, your computer may crash.
|
||||
|
||||
.SH "DEVICE NAMES"
|
||||
This backend expects device names of the form:
|
||||
.PP
|
||||
.RS
|
||||
.I port addr
|
||||
.RE
|
||||
.PP
|
||||
Where
|
||||
.B addr
|
||||
is the base address of the port your scanner is attached to. Known ports are
|
||||
.B 0x378
|
||||
(lp1)
|
||||
.B 0x278
|
||||
(lp2) and
|
||||
.B 0x3BC
|
||||
(lp0). Note that if you are using a Kernel 2.2.x or better and you have only one
|
||||
parallel port this port is named lp0 regardless of the base address. However,
|
||||
this backend requires the base address of your port. If you are not sure which
|
||||
port your scanner is connected to, have a look at your /etc/modules.conf.
|
||||
.PP
|
||||
If libieee1284 is available, its naming scheme can be used. Example: "port parport0".
|
||||
.PP
|
||||
You can rename any device using the
|
||||
.PP
|
||||
.RS
|
||||
.I name devname
|
||||
.br
|
||||
.I model model
|
||||
.br
|
||||
.I vendor vendor
|
||||
.RE
|
||||
.PP
|
||||
options. These options aply to the last port option.
|
||||
|
||||
.SH CONFIGURATION
|
||||
Please make sure to edit mustek_pp_ccd.conf
|
||||
.B before
|
||||
you use the backend.
|
||||
.PP
|
||||
The contents of the
|
||||
.B mustek_pp_ccd.conf
|
||||
file is a list of options and device names that correspond to Mustek
|
||||
scanners. Empty lines and lines starting with a hash mark (#) are
|
||||
ignored.
|
||||
.PP
|
||||
The nine options supported are
|
||||
.BR io\-mode ,
|
||||
.BR wait\-bank ,
|
||||
.BR strip\-height ,
|
||||
.BR niceload ,
|
||||
.BR auth ,
|
||||
.BR wait-lamp ,
|
||||
.BR bw ,
|
||||
.BR use600 ,
|
||||
and
|
||||
.BR buffer .
|
||||
|
||||
Option
|
||||
.B io-mode
|
||||
defines the mode of the sanei_pa4s2 interface. Possible values are
|
||||
.BR try_mode_uni
|
||||
and
|
||||
.BR alt_lock .
|
||||
This option may appear for each possible value. try_mode_uni allows
|
||||
the UNI port mode, however this may disable the (better) EPP mode. alt_lock
|
||||
toggles between two different ways to lock the port for scanner access.
|
||||
This option must come before any port definition or it won't have the effect
|
||||
you'd expect.
|
||||
|
||||
Option
|
||||
.B wait-bank
|
||||
defines the maximal time in msecs the backend waits for the bank to change. The
|
||||
default value is 700. If this option is given after the port option, only this
|
||||
device is affected. If this value is to low, you will get wrong colors and
|
||||
stripes in the scanned image.
|
||||
|
||||
Option
|
||||
.B strip-height
|
||||
is a option that limits the maximum height of the strip scanned with
|
||||
a single read command. The height is specified in lines. If this option is
|
||||
given after the port option, only this device is affected. A strip\-height of
|
||||
zero allows to scan as much as fits into the scan buffer.
|
||||
|
||||
Option
|
||||
.B niceload
|
||||
tries to avoid to heavy load. Note that this reduces scan speed. This is a
|
||||
global option.
|
||||
|
||||
Option
|
||||
.B auth
|
||||
turns on user authentification for this scanner. Use this if you want access
|
||||
control and if you have enabled this at compile time. This option must come
|
||||
after a port option. At the moment, this option isn't really supported.
|
||||
|
||||
Option
|
||||
.B wait-lamp
|
||||
allows you to control the time the backend waits for the lamp to warm up. The
|
||||
time is specified in secs. The default value is 5 secs. Some scanners need
|
||||
longer to warm up. A value of 0 makes the backend start without waiting.
|
||||
However the backend will wait at least 2 secs before turning the lamp off
|
||||
again. If this option is given after a port option it affects only this
|
||||
device.
|
||||
|
||||
Option
|
||||
.B bw
|
||||
defines the maximal color value that is considered black in lineart scans.
|
||||
The default value is 127. Possible values are between 0 and 255. If this
|
||||
option is given after a port option it affects only this device.
|
||||
|
||||
Option
|
||||
.B use600
|
||||
enables the 600 dpi handling code. It's not possible to detect wether a scanner
|
||||
has an optical resolution of 300x600 dpi or 600x1200 dpi. The default is to
|
||||
use the 300x600 dpi code. Use this option only if your scanner has an optical
|
||||
resolution of 600x1200 dpi. This is a local only option.
|
||||
|
||||
Option
|
||||
.B buffer
|
||||
allows you to change the size of the scan buffer. The size must be specified in
|
||||
bytes. The default value is 1 megabyte. If this opttion is given after the port
|
||||
option, only this device is affected. If you have limited the strip\-height,
|
||||
you only need a scan buffer of
|
||||
.PP
|
||||
.RS
|
||||
.B 8.5 * dpi * 3 * strip\-height bytes.
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.PP
|
||||
A sample configuration file is shown below:
|
||||
.PP
|
||||
.RS
|
||||
# GLOBAL #
|
||||
.br
|
||||
|
||||
.br
|
||||
# enable this option, if you think your scanner
|
||||
.br
|
||||
# supports the UNI protocol
|
||||
.br
|
||||
# note however that this might disable the better
|
||||
.br
|
||||
# EPP protocol
|
||||
.br
|
||||
#option io-mode try_mode_uni
|
||||
.br
|
||||
|
||||
.br
|
||||
# choose between two different ways to lock to port
|
||||
.br
|
||||
option io-mode alt_lock
|
||||
.br
|
||||
|
||||
.br
|
||||
# set the maximal height (in lines) of a strip
|
||||
.br
|
||||
# scanned (default: no limit)
|
||||
.br
|
||||
#option strip-height 0
|
||||
.br
|
||||
|
||||
.br
|
||||
# wait n msecs for bank to change (default: 700
|
||||
.br
|
||||
# msecs) if this value is to low, stripes my appear
|
||||
.br
|
||||
# in the scanned image
|
||||
.br
|
||||
#option wait-bank 700
|
||||
.br
|
||||
|
||||
.br
|
||||
# size (in bytes) of scan buffer (default:
|
||||
.br
|
||||
# 1 megabyte)
|
||||
.br
|
||||
#option buffer 1048576
|
||||
.br
|
||||
|
||||
.br
|
||||
# try to avoid to heavy load. Note that this
|
||||
.br
|
||||
# reduces scan speed
|
||||
.br
|
||||
option niceload
|
||||
.br
|
||||
|
||||
.br
|
||||
# Define the time the lamp has to be on before
|
||||
.br
|
||||
# scan starts (default 5 secs)
|
||||
.br
|
||||
#option wait-lamp 5
|
||||
.br
|
||||
|
||||
.br
|
||||
|
||||
.br
|
||||
# DEVICES #
|
||||
.br
|
||||
|
||||
.br
|
||||
# specify the port your scanner is connected to.
|
||||
.br
|
||||
# Possible are 0x378 (lp1) 0x278 (lp2) and
|
||||
.br
|
||||
# 0x3bc (lp0)
|
||||
.br
|
||||
port 0x378
|
||||
.br
|
||||
|
||||
.br
|
||||
# the following options are local to this scanner
|
||||
.br
|
||||
|
||||
.br
|
||||
# scan maximal 16 lines for one sane_read() call
|
||||
.br
|
||||
option strip-height 16
|
||||
.br
|
||||
|
||||
.br
|
||||
# we just need 16 * 3 * 300 * 8.5 bytes
|
||||
.br
|
||||
option buffer 122400
|
||||
.br
|
||||
|
||||
.br
|
||||
# this scanner needs max 250 msecs to change
|
||||
.br
|
||||
# the bank
|
||||
.br
|
||||
option wait-bank 250
|
||||
.br
|
||||
|
||||
.br
|
||||
# My scanner is a MD9848 from Medion using the
|
||||
.br
|
||||
# Mustek chipset
|
||||
.br
|
||||
name MD9848
|
||||
.br
|
||||
vendor Medion
|
||||
.br
|
||||
|
||||
.br
|
||||
# Enable this option, if you want user
|
||||
.br
|
||||
# authentification *and* if it's enabled at
|
||||
.br
|
||||
# compile time
|
||||
.br
|
||||
#option auth
|
||||
.br
|
||||
|
||||
.br
|
||||
# Some scanners (especially ASIC 1013) need
|
||||
.br
|
||||
# longer to warm up. This option specifies
|
||||
.br
|
||||
# the time to wait for the lamp to get hot
|
||||
.br
|
||||
#option wait-lamp 15
|
||||
.br
|
||||
|
||||
.br
|
||||
# Use this option to define the maximal
|
||||
.br
|
||||
# black value in lineart scans
|
||||
.br
|
||||
#option bw 127
|
||||
.br
|
||||
|
||||
.br
|
||||
# Use this option for 600 dpi scanners
|
||||
.br
|
||||
# for example ScanExpress 1200 ED Plus
|
||||
.br
|
||||
#option use600
|
||||
.br
|
||||
|
||||
.RE
|
||||
|
||||
|
||||
.SH FILES
|
||||
.TP
|
||||
.I @CONFIGDIR@/mustek_pp_ccd.conf
|
||||
The backend configuration file (see also description of
|
||||
.B SANE_CONFIG_DIR
|
||||
below).
|
||||
.TP
|
||||
.I @LIBDIR@/libsane\-mustek_pp_ccd.a
|
||||
The static library implementing this backend.
|
||||
.TP
|
||||
.I @LIBDIR@/libsane\-mustek_pp_ccd.so
|
||||
The shared library implementing this backend (present on systems that
|
||||
support dynamic loading).
|
||||
|
||||
.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_MUSTEK_PP_CCD
|
||||
If the library was compiled with debug support enabled, this
|
||||
environment variable controls the debug level for this backend. E.g.,
|
||||
a value of 128 requests all debug output to be printed. Smaller
|
||||
levels reduce verbosity.
|
||||
|
||||
.PP
|
||||
.RS
|
||||
level debug output
|
||||
.br
|
||||
------- ------------------------------
|
||||
.br
|
||||
0 nothing
|
||||
.br
|
||||
1 errors
|
||||
.br
|
||||
2 warnings & minor errors
|
||||
.br
|
||||
3 additional information
|
||||
.br
|
||||
4 debug information
|
||||
.br
|
||||
5 code flow (not supported yet)
|
||||
.br
|
||||
6 special debug information
|
||||
.RE
|
||||
.PP
|
||||
.TP
|
||||
.B SANE_DEBUG_SANEI_PA4S2
|
||||
This variable sets the debug level for the SANE interface for the Mustek
|
||||
chipset A4S2. Note that enabling this will spam your terminal with some
|
||||
million lines of debug output.
|
||||
|
||||
.PP
|
||||
.RS
|
||||
level debug output
|
||||
.br
|
||||
------- -------------------------------
|
||||
.br
|
||||
0 nothing
|
||||
.br
|
||||
1 errors
|
||||
.br
|
||||
2 warnings
|
||||
.br
|
||||
3 things nice to know
|
||||
.br
|
||||
4 code flow
|
||||
.br
|
||||
5 detailed code flow
|
||||
.br
|
||||
6 everything
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.PP
|
||||
.SH "SEE ALSO"
|
||||
sane(7), sane\-mustek_pp(5), sane\-mustek_usb, sane\-mustek(5), sane\-net(5), saned(1)
|
||||
|
||||
.TP
|
||||
For latest bug fixes and information see
|
||||
.I http://www.penguin-breeder.org/?page=mustek_pp
|
||||
|
||||
.SH AUTHOR
|
||||
Jochen Eisinger <jochen.eisinger@gmx.net>
|
||||
|
||||
.SH BUGS
|
||||
Too many... please send bug reports to
|
||||
.I sane\-devel@lists.alioth.debian.org
|
||||
(note that you have to subscribe first to the list before you can send
|
||||
emails... see http://www.sane-project.org/mailing-lists.html)
|
||||
.PP
|
||||
.RS
|
||||
* 1013 support isn't bullet proofed
|
||||
.br
|
||||
* 1505 support isn't even present
|
||||
.br
|
||||
* 1015 only works for CCD type 00 & 01 (01 only bw/grayscale)
|
||||
.RE
|
||||
|
||||
|
||||
.SH BUG REPORTS
|
||||
If something doesn't work, please contact me. But I need some information about
|
||||
your scanner to be able to help you...
|
||||
|
||||
.TP
|
||||
.I SANE version
|
||||
run "scanimage -V" to determine this
|
||||
.TP
|
||||
.I the backend version and your scanner hardware
|
||||
run "SANE_DEBUG_MUSTEK_PP_CCD=128 scanimage -L" as root. If you don't get any output
|
||||
from the mustek_pp_ccd backend, make sure a line "mustek_pp_ccd" is included into
|
||||
your @CONFIGDIR@/dll.conf.
|
||||
If your scanner isn't detected, make sure you've defined the right port address
|
||||
in your mustek_pp_ccd.conf.
|
||||
.TP
|
||||
.I the name of your scanner/vendor
|
||||
also a worthy information. Please also include the optical resolution and lamp type of your scanner, both can be found in the manual of your scanner.
|
||||
.TP
|
||||
.I any further comments
|
||||
if you have comments about the documentation (what could be done better), or you
|
||||
think I should know something, please include it.
|
||||
.TP
|
||||
.I some nice greetings
|
||||
.
|
Ładowanie…
Reference in New Issue