2003-09-23 15:30:05 +00:00
|
|
|
|
<HTML>
|
|
|
|
|
<HEAD>
|
|
|
|
|
<TITLE>sane-umax_pp.5</TITLE>
|
|
|
|
|
</HEAD>
|
2003-09-24 17:24:12 +00:00
|
|
|
|
<BODY BGCOLOR=#FFFFFF TEXT=#000000><H1 ALIGN=CENTER><IMG SRC="/images/sane.png" HEIGHT=117 WIDTH=346></H1>
|
2003-09-23 15:30:05 +00:00
|
|
|
|
<H1>sane-umax_pp.5</H1>
|
|
|
|
|
<HR>
|
|
|
|
|
<PRE>
|
|
|
|
|
<!-- Manpage converted by man2html 3.0.1 -->
|
|
|
|
|
<B><A HREF="sane-umax_pp.5.html">sane-umax_pp(5)</A></B> SANE Scanner Access Now Easy <B><A HREF="sane-umax_pp.5.html">sane-umax_pp(5)</A></B>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
<H2>NAME</H2><PRE>
|
|
|
|
|
sane-umax_pp - SANE backend for Umax Astra parallel port flatbed scan-
|
|
|
|
|
ners
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
<H2>DESCRIPTION</H2><PRE>
|
|
|
|
|
The <B>sane-umax_pp</B> library implements a SANE (Scanner Access Now Easy)
|
|
|
|
|
backend that provides access to Umax parallel port flatbed scanners.
|
|
|
|
|
The following scanners work with this backend:
|
|
|
|
|
|
|
|
|
|
Model:
|
|
|
|
|
--------------------
|
2004-05-18 18:21:25 +00:00
|
|
|
|
Astra 610P
|
2003-09-23 15:30:05 +00:00
|
|
|
|
Astra 1220P
|
|
|
|
|
HP3200C
|
|
|
|
|
Astra 1600P
|
|
|
|
|
Astra 2000P
|
|
|
|
|
|
2004-11-07 19:26:31 +00:00
|
|
|
|
This backend handles 75x75, 150x150, 300x300, 600x600 and 600x1200 for
|
|
|
|
|
1220P/1600P/2000P dpi scan reslutions,and 75x75, 150x150, 300x300 and
|
|
|
|
|
300x600 for 610P. In color and gray levels, there is a software lineart
|
2003-09-23 15:30:05 +00:00
|
|
|
|
mode.
|
|
|
|
|
|
2004-11-07 19:26:31 +00:00
|
|
|
|
The new generation models share a newer version of the 610P ASIC embed-
|
|
|
|
|
ded in an EPAT chip. Only parts such as CCD and ADC change from one to
|
|
|
|
|
another. They even all reports being UMAX Astra 1220P via IEEE1284.
|
|
|
|
|
There isn't software way to recognize them properly. Under windows,
|
|
|
|
|
model is set by the driver installed, regardless of the hardware.
|
2003-09-23 15:30:05 +00:00
|
|
|
|
|
2004-05-18 18:21:25 +00:00
|
|
|
|
<B>EPP/ECP</B> <B>MODES</B> <B>ONLY</B>
|
2004-11-07 19:26:31 +00:00
|
|
|
|
The current version of the backend uses only EPP or ECP mode to
|
|
|
|
|
communicate with the scanner. PS/2 mode isn't implemented. The
|
|
|
|
|
610P only use SPP. It is recommended that you set your parallel
|
|
|
|
|
port to EPP in BIOS with the current version of this backend.
|
|
|
|
|
You can leave it to ECP or ECP+EPP, but in this case you may not
|
|
|
|
|
use ppdev but only direct hardware access if you have to use
|
2005-08-07 11:14:41 +00:00
|
|
|
|
ECP. ECPEPP will only work if you use a 2.4 or 2.6 kernel with
|
|
|
|
|
ppdev character device support.
|
2004-05-18 18:21:25 +00:00
|
|
|
|
|
2004-11-07 19:26:31 +00:00
|
|
|
|
This backend does support parport sharing only <I>if</I> <I>you</I> <I>have</I> <I>a</I> <I>kernel</I>
|
2003-09-23 15:30:05 +00:00
|
|
|
|
<I>with</I> <I>ppdev</I> <I>support.</I>
|
|
|
|
|
|
2004-11-07 19:26:31 +00:00
|
|
|
|
Note that if you don't use the ppdev character device, the backend
|
2003-09-23 15:30:05 +00:00
|
|
|
|
needs to run as root. To allow user access to the scanner run the back-
|
2004-11-07 19:26:31 +00:00
|
|
|
|
end through the network interface (See <B><A HREF="saned.8.html">saned(8)</A></B> and <B><A HREF="sane-net.5.html">sane-net(5)</A></B>). A
|
|
|
|
|
more relaxed solution (security wise) is to add suid bit to the fron-
|
|
|
|
|
tend (See <B><A HREF="chmod.1.html">chmod(1)</A></B>). The backend drop root priviledges as soon as it
|
|
|
|
|
can, right after gaining direct access to IO ports, which lessen risks
|
2003-09-23 15:30:05 +00:00
|
|
|
|
when being root.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
<H2>DEVICE NAMES</H2><PRE>
|
|
|
|
|
This backend expects device names of the form:
|
|
|
|
|
|
|
|
|
|
<I>port</I> <I>value</I>
|
|
|
|
|
|
2003-11-23 12:03:17 +00:00
|
|
|
|
Where <B>value</B> is :
|
|
|
|
|
|
2005-08-07 11:14:41 +00:00
|
|
|
|
auto autodetect all parallel ports and probe them for scanner
|
|
|
|
|
|
|
|
|
|
safe-auto
|
|
|
|
|
autodetect all parallel ports and probe them for scanner,
|
|
|
|
|
but does not try direct hardware access
|
|
|
|
|
|
|
|
|
|
/dev/ppi0
|
|
|
|
|
uses *BSD ppi device, depending on the number of avail-
|
|
|
|
|
able parallel port, you have to use /dev/ppi1, /dev/ppi2,
|
|
|
|
|
...
|
|
|
|
|
|
|
|
|
|
/dev/parport0
|
|
|
|
|
uses linux ppdev device, depending on the number of
|
|
|
|
|
available parallel port, you have to use /dev/parport1,
|
|
|
|
|
/dev/parport2, ...
|
|
|
|
|
|
|
|
|
|
0x378 does direct hardware access on the given address. Usual
|
|
|
|
|
values are 0x378, 0x278, 0x3BC In this case, you have to
|
|
|
|
|
run the scanner as root (*BSD and linux), or with
|
|
|
|
|
'IOPL=yes' on OS/2
|
|
|
|
|
|
|
|
|
|
<B>NOTE:</B> in all cases, you must have sufficient priviledges to get access
|
|
|
|
|
to the chosen device or address. Depending on the security settings,
|
|
|
|
|
devices may not be available for all users. You have to change permis-
|
|
|
|
|
sions on the dev/ppi* or /dev/parport* devices.
|
2003-09-23 15:30:05 +00:00
|
|
|
|
|
|
|
|
|
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 apply to the last port option.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
<H2>CONFIGURATION</H2><PRE>
|
|
|
|
|
Please make sure to edit umax_pp.conf <B>before</B> you use the backend.
|
|
|
|
|
|
2004-11-07 19:26:31 +00:00
|
|
|
|
The contents of the <B>umax_pp.conf</B> file is a list of options and device
|
2003-09-23 15:30:05 +00:00
|
|
|
|
names that correspond to Umax scanners. Empty lines and lines starting
|
|
|
|
|
with a hash mark (#) are ignored.
|
|
|
|
|
|
2004-11-07 19:26:31 +00:00
|
|
|
|
The height options supported are <B>red-gain</B>, <B>green-gain</B>, <B>blue-gain</B>,
|
|
|
|
|
<B>red-offset</B>, <B>green-offset</B>, <B>blue-offset</B>, <B>astra</B>, and <B>buffer</B>.
|
2003-09-23 15:30:05 +00:00
|
|
|
|
|
2004-11-07 19:26:31 +00:00
|
|
|
|
Options <B>red-gain</B> , <B>green-gain</B> and <B>blue-gain</B> allow you to adjust the
|
|
|
|
|
sensitivy of your scanner for the given color. Values range from 0
|
|
|
|
|
(lowest gain) to 15 (highest). If the advanced option "Gain" isn't
|
|
|
|
|
checked in the frontend, the backend does automatic gain calibration,
|
|
|
|
|
and do not use user provided values.
|
2003-09-23 15:30:05 +00:00
|
|
|
|
|
2004-11-07 19:26:31 +00:00
|
|
|
|
Options <B>red-offset</B> , <B>green-offset</B> and <B>blue-offset</B> allow you to adjust
|
|
|
|
|
the offset of your scanner for the given color. Values range from 0
|
|
|
|
|
(lowest offset) to 15 (highest).
|
2003-09-23 15:30:05 +00:00
|
|
|
|
|
2004-11-07 19:26:31 +00:00
|
|
|
|
Option <B>astra</B> allows you to change the model of your scanner. Current
|
|
|
|
|
auto detection is based on side effects on scanning when using 1220P
|
2003-09-23 15:30:05 +00:00
|
|
|
|
command set on other models, so it may fail on unkown hardware combina-
|
2004-11-07 19:26:31 +00:00
|
|
|
|
tion. Valid values are 610, 1220, 1600 and 2000. It is usefull only
|
2004-05-18 18:21:25 +00:00
|
|
|
|
when autodetection fails to detect properly your scanner model. If your
|
2003-09-23 15:30:05 +00:00
|
|
|
|
scanner work properly but is reported wrongly, let it be that way. The
|
2004-11-07 19:26:31 +00:00
|
|
|
|
only valid case to change the model is when your scanner produces
|
2003-11-23 12:03:17 +00:00
|
|
|
|
'black' or prevent scanner model autodetection.
|
|
|
|
|
|
2004-11-07 19:26:31 +00:00
|
|
|
|
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 2 megabytes.
|
|
|
|
|
Decreasing this value will improve the smoothness of progress bar in
|
2004-05-18 18:21:25 +00:00
|
|
|
|
the frontend, but will stall the scan more often.
|
2003-09-23 15:30:05 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
<H2>FILES</H2><PRE>
|
|
|
|
|
<I>/usr/local/etc/sane.d/umax</I><B>_</B><I>pp.conf</I>
|
2004-11-07 19:26:31 +00:00
|
|
|
|
The backend configuration file (see also description of
|
2003-09-23 15:30:05 +00:00
|
|
|
|
<B>SANE_CONFIG_DIR</B> below).
|
|
|
|
|
|
|
|
|
|
<I>/usr/local/lib/sane/libsane-umax</I><B>_</B><I>pp.a</I>
|
|
|
|
|
The static library implementing this backend.
|
|
|
|
|
|
|
|
|
|
<I>/usr/local/lib/sane/libsane-umax</I><B>_</B><I>pp.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
|
2004-11-07 19:26:31 +00:00
|
|
|
|
are separated by a colon (`:'), under OS/2, they are separated
|
2003-09-23 15:30:05 +00:00
|
|
|
|
by a semi-colon (`;'). If this variable is not set, the config-
|
2004-11-07 19:26:31 +00:00
|
|
|
|
uration file is searched in two default directories: first, the
|
|
|
|
|
current working directory (".") and then in
|
2003-09-23 15:30:05 +00:00
|
|
|
|
/usr/local/etc/sane.d. If the value of the environment variable
|
2004-11-07 19:26:31 +00:00
|
|
|
|
ends with the directory separator character, then the default
|
2003-09-23 15:30:05 +00:00
|
|
|
|
directories are searched after the explicitly specified directo-
|
2004-11-07 19:26:31 +00:00
|
|
|
|
ries. For example, setting <B>SANE_CONFIG_DIR</B> to "/tmp/config:"
|
|
|
|
|
would result in directories "tmp/config", ".", and
|
2003-09-23 15:30:05 +00:00
|
|
|
|
"/usr/local/etc/sane.d" being searched (in this order).
|
|
|
|
|
|
|
|
|
|
<B>SANE_DEBUG_UMAX_PP</B>
|
2004-11-07 19:26:31 +00:00
|
|
|
|
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.
|
2003-09-23 15:30:05 +00:00
|
|
|
|
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_UMAX_PP_LOW</B>
|
2004-11-07 19:26:31 +00:00
|
|
|
|
This variable sets the debug level for the SANE interface for
|
|
|
|
|
the Umax ASIC. Note that enabling this will spam your terminal
|
2003-09-23 15:30:05 +00:00
|
|
|
|
with some million lines of debug output.
|
|
|
|
|
|
|
|
|
|
level debug output
|
|
|
|
|
------- -------------------------------
|
|
|
|
|
0 nothing
|
|
|
|
|
1 errors
|
|
|
|
|
8 command blocks
|
|
|
|
|
16 detailed code flow
|
|
|
|
|
32 dump datafiles
|
|
|
|
|
255 everything
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
<H2>SEE ALSO</H2><PRE>
|
2004-11-07 19:26:31 +00:00
|
|
|
|
<B><A HREF="sane.7.html">sane(7)</A></B>, <B><A HREF="sane-net.5.html">sane-net(5)</A></B>, <B><A HREF="saned.8.html">saned(8)</A></B>
|
2003-09-23 15:30:05 +00:00
|
|
|
|
|
|
|
|
|
For latest bug fixes and information see
|
|
|
|
|
<I>http://umax1220p.sourceforge.net/</I>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
<H2>AUTHOR</H2><PRE>
|
2003-11-23 12:03:17 +00:00
|
|
|
|
St<53>phane VOLTZ <svoltz@wanadoo.fr>
|
2003-09-23 15:30:05 +00:00
|
|
|
|
|
|
|
|
|
|
2004-11-07 19:26:31 +00:00
|
|
|
|
</PRE>
|
|
|
|
|
<H2>CREDITS</H2><PRE>
|
|
|
|
|
Support for the 610P has been made possible thank to an hardware dona-
|
|
|
|
|
tion by William Stuart.
|
|
|
|
|
|
|
|
|
|
|
2003-09-23 15:30:05 +00:00
|
|
|
|
</PRE>
|
|
|
|
|
<H2>BUG REPORTS</H2><PRE>
|
2004-05-18 18:21:25 +00:00
|
|
|
|
If something doesn't work, please contact me. But I need some informa-
|
2003-09-23 15:30:05 +00:00
|
|
|
|
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>
|
2004-05-18 18:21:25 +00:00
|
|
|
|
run "SANE_DEBUG_UMAX_PP=255 scanimage -L 2>log" as root. If you
|
|
|
|
|
don't get any output from the umax_pp backend, make sure a line
|
|
|
|
|
"umax_pp" 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, or the correct device in your umax_pp.conf.
|
2003-09-23 15:30:05 +00:00
|
|
|
|
|
|
|
|
|
<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-
|
2004-05-18 18:21:25 +00:00
|
|
|
|
lution and lamp type of your scanner, both can be found in the
|
2003-09-23 15:30:05 +00:00
|
|
|
|
manual of your scanner.
|
|
|
|
|
|
|
|
|
|
<I>any</I> <I>further</I> <I>comments</I>
|
|
|
|
|
if you have comments about the documentation (what could be done
|
2004-05-18 18:21:25 +00:00
|
|
|
|
better), or you think I should know something, please include
|
2003-09-23 15:30:05 +00:00
|
|
|
|
it.
|
|
|
|
|
|
2005-08-07 11:14:41 +00:00
|
|
|
|
sane-backends 1.0.16 23 August 2004 <B><A HREF="sane-umax_pp.5.html">sane-umax_pp(5)</A></B>
|
2003-09-23 15:30:05 +00:00
|
|
|
|
</PRE>
|
|
|
|
|
<HR>
|
|
|
|
|
<ADDRESS>
|
|
|
|
|
Man(1) output converted with
|
|
|
|
|
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
|
|
|
|
|
</ADDRESS>
|
|
|
|
|
</BODY>
|
|
|
|
|
</HTML>
|