kopia lustrzana https://gitlab.com/sane-project/website
Added manpage for mustek_pp_ccd.
Henning Geinitz
rodzic
047e44dd76
commit
fec328f174
|
|
@ -0,0 +1,348 @@
|
|||
<HTML>
|
||||
<HEAD>
|
||||
<TITLE>sane-mustek_pp_ccd.5</TITLE>
|
||||
</HEAD>
|
||||
<BODY BGCOLOR=#FFFFFF TEXT=#000000><H1 ALIGN=CENTER><IMG SRC="/images/sane.png" HEIGHT=117 WIDTH=346></H1>
|
||||
<H1>sane-mustek_pp_ccd.5</H1>
|
||||
<HR>
|
||||
<PRE>
|
||||
<!-- Manpage converted by man2html 3.0.1 -->
|
||||
<B><A HREF="sane-mustek_pp_ccd.5.html">sane-mustek_pp_ccd(5)</A></B> SANE Scanner Access Now Easy <B><A HREF="sane-mustek_pp_ccd.5.html">sane-mustek_pp_ccd(5)</A></B>
|
||||
|
||||
|
||||
</PRE>
|
||||
<H2>NAME</H2><PRE>
|
||||
sane-mustek_pp_ccd - SANE backend for Mustek CCD parallel port flatbed
|
||||
scanners
|
||||
|
||||
|
||||
</PRE>
|
||||
<H2>DESCRIPTION</H2><PRE>
|
||||
The <B>sane-mustek_pp_ccd</B> 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:
|
||||
|
||||
Model: ASIC ID: CCD Type: works:
|
||||
-------------------- --------- ---------- -------
|
||||
SE 6000 P 1013 00 yes
|
||||
SM 4800 P 1013/1015 04/01 yes
|
||||
SE 1200 ED Plus 1015 01 partly
|
||||
SM 1200 ED Plus 1015 01 partly
|
||||
600 III EP Plus 1013/1015 00/01 yes
|
||||
SE 600 SEP 1013 ?? yes
|
||||
MD9848 1015 00 yes
|
||||
Gallery 4800 ???? ?? yes
|
||||
Viviscan Compact II 1013 00 yes
|
||||
|
||||
Other scanners, especially scanners using a CIS type sensor are not
|
||||
supported by this backend. Have a look at the <B><A HREF="sane-mustek_pp.5.html">sane-mustek_pp(5)</A></B> backend
|
||||
for CIS scanners.
|
||||
|
||||
Please note that this backend is still under construction. I don't know
|
||||
which scanners work or which will work in future releases.
|
||||
|
||||
You have to enable the backend explicitly in your dll.conf. Just remove
|
||||
the hash mark in the line "mustek_pp_ccd".
|
||||
|
||||
Some scanners work faster when <B>EPP/ECP</B> is enabled in the BIOS.
|
||||
|
||||
Note that the backend needs to run as root. To allow user access to the
|
||||
scanner run the backend through the network interface (See <B><A HREF="saned.1.html">saned(1)</A></B> and
|
||||
<B><A HREF="sane-net.5.html">sane-net(5)</A></B>). Note also that the backend <I>does</I> <I>not</I> support <I>parport</I> <I>shar-</I>
|
||||
<I>ing</I> <I>,</I> i.e. if you try printing while scanning, your computer may crash.
|
||||
|
||||
|
||||
</PRE>
|
||||
<H2>DEVICE NAMES</H2><PRE>
|
||||
This backend expects device names of the form:
|
||||
|
||||
<I>port</I> <I>addr</I>
|
||||
|
||||
Where <B>addr</B> is the base address of the port your scanner is attached to.
|
||||
Known ports are <B>0x378</B> (lp1) <B>0x278</B> (lp2) and <B>0x3BC</B> (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.
|
||||
|
||||
If libieee1284 is available, its naming scheme can be used. Example:
|
||||
"port parport0".
|
||||
|
||||
You can rename any device using the
|
||||
|
||||
<I>name</I> <I>devname</I>
|
||||
<I>model</I> <I>model</I>
|
||||
<I>vendor</I> <I>vendor</I>
|
||||
|
||||
options. These options aply to the last port option.
|
||||
|
||||
|
||||
</PRE>
|
||||
<H2>CONFIGURATION</H2><PRE>
|
||||
Please make sure to edit mustek_pp_ccd.conf <B>before</B> you use the backend.
|
||||
|
||||
The contents of the <B>mustek_pp_ccd.conf</B> 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.
|
||||
|
||||
The nine options supported are <B>io-mode</B>, <B>wait-bank</B>, <B>strip-height</B>,
|
||||
<B>niceload</B>, <B>auth</B>, <B>wait-lamp</B>, <B>bw</B>, <B>use600</B>, and <B>buffer</B>.
|
||||
|
||||
Option <B>io-mode</B> defines the mode of the sanei_pa4s2 interface. Possible
|
||||
values are <B>try_mode_uni</B> and <B>alt_lock</B>. 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</B> 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</B> 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</B> tries to avoid to heavy load. Note that this reduces
|
||||
scan speed. This is a global option.
|
||||
|
||||
Option <B>auth</B> 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</B> 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</B> 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</B> 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</B> 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
|
||||
|
||||
<B>8.5</B> <B>*</B> <B>dpi</B> <B>*</B> <B>3</B> <B>*</B> <B>strip-height</B> <B>bytes.</B>
|
||||
|
||||
|
||||
A sample configuration file is shown below:
|
||||
|
||||
# GLOBAL #
|
||||
|
||||
# enable this option, if you think your scanner
|
||||
# supports the UNI protocol
|
||||
# note however that this might disable the better
|
||||
# EPP protocol
|
||||
#option io-mode try_mode_uni
|
||||
|
||||
# choose between two different ways to lock to port
|
||||
option io-mode alt_lock
|
||||
|
||||
# set the maximal height (in lines) of a strip
|
||||
# scanned (default: no limit)
|
||||
#option strip-height 0
|
||||
|
||||
# wait n msecs for bank to change (default: 700
|
||||
# msecs) if this value is to low, stripes my appear
|
||||
# in the scanned image
|
||||
#option wait-bank 700
|
||||
|
||||
# size (in bytes) of scan buffer (default:
|
||||
# 1 megabyte)
|
||||
#option buffer 1048576
|
||||
|
||||
# try to avoid to heavy load. Note that this
|
||||
# reduces scan speed
|
||||
option niceload
|
||||
|
||||
# Define the time the lamp has to be on before
|
||||
# scan starts (default 5 secs)
|
||||
#option wait-lamp 5
|
||||
|
||||
# DEVICES #
|
||||
|
||||
# specify the port your scanner is connected to.
|
||||
# Possible are 0x378 (lp1) 0x278 (lp2) and
|
||||
# 0x3bc (lp0)
|
||||
port 0x378
|
||||
|
||||
# the following options are local to this scanner
|
||||
|
||||
# scan maximal 16 lines for one sane_read() call
|
||||
option strip-height 16
|
||||
|
||||
# we just need 16 * 3 * 300 * 8.5 bytes
|
||||
option buffer 122400
|
||||
|
||||
# this scanner needs max 250 msecs to change
|
||||
# the bank
|
||||
option wait-bank 250
|
||||
|
||||
# My scanner is a MD9848 from Medion using the
|
||||
# Mustek chipset
|
||||
name MD9848
|
||||
vendor Medion
|
||||
|
||||
# Enable this option, if you want user
|
||||
# authentification *and* if it's enabled at
|
||||
# compile time
|
||||
#option auth
|
||||
|
||||
# Some scanners (especially ASIC 1013) need
|
||||
# longer to warm up. This option specifies
|
||||
# the time to wait for the lamp to get hot
|
||||
#option wait-lamp 15
|
||||
|
||||
# Use this option to define the maximal
|
||||
# black value in lineart scans
|
||||
#option bw 127
|
||||
|
||||
# Use this option for 600 dpi scanners
|
||||
# for example ScanExpress 1200 ED Plus
|
||||
#option use600
|
||||
|
||||
|
||||
</PRE>
|
||||
<H2>FILES</H2><PRE>
|
||||
<I>/usr/local/etc/sane.d/mustek</I><B>_</B><I>pp</I><B>_</B><I>ccd.conf</I>
|
||||
The backend configuration file (see also description of
|
||||
<B>SANE_CONFIG_DIR</B> below).
|
||||
|
||||
<I>/usr/local/lib/sane/libsane-mustek</I><B>_</B><I>pp</I><B>_</B><I>ccd.a</I>
|
||||
The static library implementing this backend.
|
||||
|
||||
<I>/usr/local/lib/sane/libsane-mustek</I><B>_</B><I>pp</I><B>_</B><I>ccd.so</I>
|
||||
The shared library implementing this backend (present on systems
|
||||
that support dynamic loading).
|
||||
|
||||
|
||||
</PRE>
|
||||
<H2>ENVIRONMENT</H2><PRE>
|
||||
<B>SANE_CONFIG_DIR</B>
|
||||
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 config-
|
||||
uration file is searched in two default directories: first, the
|
||||
current working directory (".") and then in
|
||||
/usr/local/etc/sane.d. If the value of the environment variable
|
||||
ends with the directory separator character, then the default
|
||||
directories are searched after the explicitly specified directo-
|
||||
ries. For example, setting <B>SANE_CONFIG_DIR</B> to "/tmp/config:"
|
||||
would result in directories "tmp/config", ".", and
|
||||
"/usr/local/etc/sane.d" being searched (in this order).
|
||||
|
||||
<B>SANE_DEBUG_MUSTEK_PP_CCD</B>
|
||||
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.
|
||||
|
||||
level debug output
|
||||
------- ------------------------------
|
||||
0 nothing
|
||||
1 errors
|
||||
2 warnings & minor errors
|
||||
3 additional information
|
||||
4 debug information
|
||||
5 code flow (not supported yet)
|
||||
6 special debug information
|
||||
|
||||
<B>SANE_DEBUG_SANEI_PA4S2</B>
|
||||
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.
|
||||
|
||||
|
||||
level debug output
|
||||
------- -------------------------------
|
||||
0 nothing
|
||||
1 errors
|
||||
2 warnings
|
||||
3 things nice to know
|
||||
4 code flow
|
||||
5 detailed code flow
|
||||
6 everything
|
||||
|
||||
|
||||
</PRE>
|
||||
<H2>SEE ALSO</H2><PRE>
|
||||
<B><A HREF="sane.7.html">sane(7)</A></B>, <B><A HREF="sane-mustek_pp.5.html">sane-mustek_pp(5)</A></B>, sane-mustek_usb, <B><A HREF="sane-mustek.5.html">sane-mustek(5)</A></B>,
|
||||
<B><A HREF="sane-net.5.html">sane-net(5)</A></B>, <B><A HREF="saned.1.html">saned(1)</A></B>
|
||||
|
||||
For latest bug fixes and information see
|
||||
<I>http://www.penguin-breeder.org/?page=mustek</I><B>_</B><I>pp</I>
|
||||
|
||||
|
||||
</PRE>
|
||||
<H2>AUTHOR</H2><PRE>
|
||||
Jochen Eisinger <jochen.eisinger@gmx.net>
|
||||
|
||||
|
||||
</PRE>
|
||||
<H2>BUGS</H2><PRE>
|
||||
Too many... please send bug reports to
|
||||
<I>sane-devel@lists.alioth.debian.org</I> (note that you have to subscribe
|
||||
first to the list before you can send emails... see http://www.sane-
|
||||
project.org/mailing-lists.html)
|
||||
|
||||
* 1013 support isn't bullet proofed
|
||||
* 1505 support isn't even present
|
||||
* 1015 only works for CCD type 00 & 01 (01 only bw/grayscale)
|
||||
|
||||
|
||||
</PRE>
|
||||
<H2>BUG REPORTS</H2><PRE>
|
||||
If something doesn't work, please contact me. But I need some informa-
|
||||
tion about your scanner to be able to help you...
|
||||
|
||||
<I>SANE</I> <I>version</I>
|
||||
run "scanimage -V" to determine this
|
||||
|
||||
<I>the</I> <I>backend</I> <I>version</I> <I>and</I> <I>your</I> <I>scanner</I> <I>hardware</I>
|
||||
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
|
||||
/usr/local/etc/sane.d/dll.conf. If your scanner isn't detected,
|
||||
make sure you've defined the right port address in your
|
||||
mustek_pp_ccd.conf.
|
||||
|
||||
<I>the</I> <I>name</I> <I>of</I> <I>your</I> <I>scanner/vendor</I>
|
||||
also a worthy information. Please also include the optical reso-
|
||||
lution and lamp type of your scanner, both can be found in the
|
||||
manual of your scanner.
|
||||
|
||||
<I>any</I> <I>further</I> <I>comments</I>
|
||||
if you have comments about the documentation (what could be done
|
||||
better), or you think I should know something, please include
|
||||
it.
|
||||
|
||||
<I>some</I> <I>nice</I> <I>greetings</I>
|
||||
|
||||
sane-backends 1.0.12-cvs 3 Oct 2003 <B><A HREF="sane-mustek_pp_ccd.5.html">sane-mustek_pp_ccd(5)</A></B>
|
||||
</PRE>
|
||||
<HR>
|
||||
<ADDRESS>
|
||||
Man(1) output converted with
|
||||
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
|
||||
</ADDRESS>
|
||||
</BODY>
|
||||
</HTML>
|
||||
Ładowanie…
Reference in New Issue