kopia lustrzana https://gitlab.com/sane-project/website
308 wiersze
13 KiB
HTML
308 wiersze
13 KiB
HTML
<HTML>
|
|
<HEAD>
|
|
<TITLE>sane-plustek_pp.5</TITLE>
|
|
</HEAD>
|
|
<BODY BGCOLOR=#FFFFFF TEXT=#000000><H1 ALIGN=CENTER><IMG SRC="/images/sane.png" HEIGHT=117 WIDTH=346></H1>
|
|
<H1>sane-plustek_pp.5</H1>
|
|
<HR>
|
|
<PRE>
|
|
<!-- Manpage converted by man2html 3.0.1 -->
|
|
<B><A HREF="sane-plustek_pp.5.html">sane-plustek_pp(5)</A></B> SANE Scanner Access Now Easy <B><A HREF="sane-plustek_pp.5.html">sane-plustek_pp(5)</A></B>
|
|
|
|
|
|
</PRE>
|
|
<H2>NAME</H2><PRE>
|
|
sane-plustek_pp - SANE backend for Plustek parallel port flatbed scan-
|
|
ners
|
|
|
|
|
|
</PRE>
|
|
<H2>DESCRIPTION</H2><PRE>
|
|
The <B>sane-plustek_pp</B> library implements a SANE (Scanner Access Now Easy)
|
|
backend that provides access to Plustek ASIC 9600[1/3] and P9800[1/3]
|
|
based parallel port flatbed scanners. The access of the scanner is
|
|
either done directly by the backend or via kernel module, called pt_drv
|
|
which can be created out of the plustek_pp backend code - see also sec-
|
|
tion <B>BUILDING</B> <B>THE</B> <B>KERNEL</B> <B>MODULE</B> for further information.
|
|
|
|
|
|
</PRE>
|
|
<H2>SUPPORTED DEVICES</H2><PRE>
|
|
At present, the following scanners should work with this backend and/or
|
|
the kernel module:
|
|
|
|
<B>PLUSTEK</B> <B>SCANNERS</B>
|
|
|
|
Parallelport Model: ASIC: Properties:
|
|
---------------------- ----- ------------------------
|
|
OpticPro PT12 98003 600x1200 dpi 36bit 512Kb
|
|
OpticPro P12 98003 600x1200 dpi 36bit 512Kb
|
|
OpticPro 9636T/12000T 98001 600x1200 dpi 36bit 512Kb
|
|
OpticPro 12000P Turbo 98001 600x1200 dpi 36bit 512Kb
|
|
OpticPro 9636P+/Turbo 98001 600x1200 dpi 36bit 512Kb
|
|
OpticPro 9636P 96003 600x1200 dpi 36bit 128Kb
|
|
OpticPro 12000P/96000P 96003 600x1200 dpi 36bit 128Kb
|
|
OpticPro 1236P 96003 600x1200 dpi 30bit 128Kb
|
|
OpticPro 9600P 96003 600x1200 dpi 30bit 128Kb
|
|
OpticPro 9630P/FBIV 96003 600x1200 dpi 30bit 128Kb
|
|
OpticPro 9630PL (14") 96003 600x1200 dpi 30bit 128Kb
|
|
OpticPro A3I 96003 400x800 dpi 36bit 128Kb
|
|
OpticPro 600P/6000P 96003 300x600 dpi 30bit 32Kb
|
|
OpticPro 4831P 96003 300x600 dpi 30bit 32Kb
|
|
OpticPro 4830P/FBIII 96003 300x600 dpi 30bit 32Kb
|
|
OpticPro 4800P/FBII 96001 300x600 dpi 24bit 32Kb
|
|
|
|
<B>PRIMAX</B> <B>SCANNERS</B>
|
|
|
|
There are some scanners sold by Primax, but they are in fact Plustek
|
|
devices. These scanners are also supported. The following table will
|
|
show the relationship:
|
|
|
|
Model: Plustek Model: Remarks:
|
|
--------------------------- -------------- ------------
|
|
Colorado 4800 OpticPro 4800 not tested
|
|
Compact 4800 Direct OpticPro 600 mov=2
|
|
Compact 4800 Direct 30bit OpticPro 4830 mov=7
|
|
Compact 9600 Direct 30bit OpticPro 9630 works
|
|
|
|
<B>GENIUS</B> <B>SCANNERS</B>
|
|
|
|
The following devices are sold as Genius Scanners, but are in fact
|
|
Plustek devices. The table will show the relationship:
|
|
|
|
Model: Remarks:
|
|
--------------------------- ----------------------------
|
|
Colorpage Vivid III V2 Like P12 but has two buttons
|
|
and Wolfson DAC
|
|
|
|
<B>ARIES</B> <B>SCANNERS</B>
|
|
|
|
There's one scanner sold as Aries Scanner, but is in fact a Plustek
|
|
device. The following table will show the relationship:
|
|
|
|
Model: Plustek Model: Remarks:
|
|
--------------------------- -------------- ------------
|
|
Scan-It 4800 OpticPro 600 mov=2
|
|
|
|
<B>BrightScan</B> <B>SCANNERS</B>
|
|
|
|
There's one scanner sold as BrightScan OpticPro Scanner, this is also a
|
|
rebadged Plustek device. The following table will show the relation-
|
|
ship:
|
|
|
|
Model: Remarks:
|
|
--------------------------- ----------------------------
|
|
BrightScan OpticPro OpticPro P12
|
|
|
|
|
|
</PRE>
|
|
<H2>DEVICE NAMES</H2><PRE>
|
|
This backend works in two modes, the so called "direct-mode" and the
|
|
"kernel-mode". In direct-mode, the user-space backend is used, in ker-
|
|
nel-mode, you should have a kernel-module named pt_drv loaded. This
|
|
backends default device is:
|
|
|
|
<I>0x378</I>
|
|
|
|
This "default device" will be used, if no configuration file can be
|
|
found. It is rather the base address of the parallel port on i386
|
|
machines.
|
|
|
|
As the backend supports up to four devices, it is possible to specify
|
|
them in the configuration file
|
|
|
|
<I>/usr/local/etc/sane.d/plustek</I><B>_</B><I>pp.conf</I>
|
|
|
|
See the plustek_pp.conf file for examples.
|
|
|
|
|
|
</PRE>
|
|
<H2>CONFIGURATION</H2><PRE>
|
|
Beside the kernel-module options, which are described below, you need
|
|
to enable the parallel port device in the configuration file
|
|
|
|
<I>/usr/local/etc/sane.d/plustek</I><B>_</B><I>pp.conf</I>
|
|
|
|
For a proper setup, you will need at least two entries:
|
|
|
|
<I>[direct]</I>
|
|
|
|
<I>device</I> <I>0x378</I>
|
|
|
|
or
|
|
|
|
<I>[kernel]</I>
|
|
|
|
<I>device</I> <I>/dev/pt</I><B>_</B><I>drv</I>
|
|
|
|
<I>direct</I> tells the backend, that the following devicename (here
|
|
<I>/dev/pt</I><B>_</B><I>drv</I> ) has to be interpreted as parallel port scanner device.
|
|
|
|
To have this device, you will need to setup the kernel module. As the
|
|
driver is a loadable kernel module, it is configured by invoking insmod
|
|
with the appropriate parameters or appending the options to the file
|
|
<B>/etc/conf.modules</B>
|
|
|
|
<B>The</B> <B>Options:</B>
|
|
lampoff=lll
|
|
The value <I>lll</I> tells the driver, after how many seconds to
|
|
switch-off the lamp(s). The default value is 180. 0 will dis-
|
|
able this feature.
|
|
<B>HINT:</B> Do not use a value that is too small, because often
|
|
switching on/off the lamps will reduce their lifetime.
|
|
|
|
port=ppp
|
|
<I>ppp</I> specifies the port base address, where the scanner is con-
|
|
nected to. The default value is 0x378 which normaly is standard.
|
|
|
|
warmup=www
|
|
<I>www</I> specifies the time in seconds, how long a lamp has to be on,
|
|
until the driver will start to scan. The default value is 30.
|
|
|
|
lOffonEnd=e
|
|
<I>e</I> specifies the behaviour when unloading the driver, 1 -->
|
|
switch lamps off, 0 --> do not change lamp status
|
|
|
|
slowIO=s
|
|
<I>s</I> specifies which I/O functions the driver should use, 1 --> use
|
|
delayed functions, 0 --> use the non-delayed ones
|
|
|
|
forceMode=fm
|
|
<I>fm</I> specifies port mode which should be used, 0 --> autodetec-
|
|
tion, 1 --> use SPP mode and 2 --> use EPP mode
|
|
|
|
mov=m
|
|
<I>m</I> =0 - default: no override
|
|
<I>m</I> =1 - OpticPro 9630PL override (works if OP9630
|
|
has been detected) forces legal size (14")
|
|
<I>m</I> =2 - Primax 4800Direct override (works if OP600
|
|
has been detected) swaps red/green color
|
|
<I>m</I> =3 - OpticPro 9636 override (works if OP9636 has
|
|
been detected) disables backends
|
|
transparency/negativ capabilities
|
|
<I>m</I> =4 - OpticPro 9636P override (works if OP9636 has
|
|
been detected) disables backends
|
|
transparency/negativ capabilities
|
|
<I>m</I> =5 - OpticPro A3I override (works if OP12000 has
|
|
been detected) enables A3 scanning
|
|
<I>m</I> =6 - OpticPro 4800P override (works if OP600
|
|
has been detected) swaps red/green color
|
|
<I>m</I> =7 - Primax 4800Direct 30bit override (works if OP4830
|
|
has been detected)
|
|
|
|
Sample entry for file <B>/etc/modules.conf</B> :
|
|
<I>alias</I> <I>char-major-40</I> <I>pt</I><B>_</B><I>drv</I>
|
|
<I>pre-install</I> <I>pt</I><B>_</B><I>drv</I> <I>modprobe</I> <I>-k</I> <I>parport</I>
|
|
<I>options</I> <I>pt</I><B>_</B><I>drv</I> <I>lampoff=180</I> <I>warmup=15</I> <I>port=0x378</I> <I>lOffonEnd=0</I> <I>mov=0</I>
|
|
<I>slowIO=0</I> <I>forceMode=0</I>
|
|
|
|
For multidevice support, simply add values separated by commas to the
|
|
different options
|
|
<I>options</I> <I>pt</I><B>_</B><I>drv</I> <I>port=0x378,0x278</I> <I>mov=0,4</I> <I>slowIO=0,1</I> <I>forceMode=0,1</I>
|
|
|
|
Remember to call depmod after changing /etc/conf.modules.
|
|
|
|
<B>PARALLEL</B> <B>PORT</B> <B>MODES</B>
|
|
|
|
The current driver works best, when the parallel port has been set to
|
|
EPP-mode. When detecting any other mode such as ECP or PS/2 the driver
|
|
tries to set to a faster, supported mode. If this fails, it will use
|
|
the SPP mode, as this mode should work with all Linux supported paral-
|
|
lel ports.
|
|
|
|
Former Plustek scanner models (4830, 9630) supplied a ISA parallel port
|
|
adapter card. This card is <B>not</B> supported by the driver.
|
|
|
|
The ASIC 96001/3 based models have sometimes trouble with high resolu-
|
|
tion modes. If you encounter sporadic corrupted images (parts dupli-
|
|
cated or shifted horizontally) kill all other applications before scan-
|
|
ning and (if sufficient memory available) disable swapping.
|
|
|
|
See the plustek_pp.conf file for examples.
|
|
|
|
|
|
</PRE>
|
|
<H2>BUILDING THE KERNEL MODULE</H2><PRE>
|
|
As mentioned before, the plustek_pp backend code can also be compiled
|
|
and installed as linux kernel module...
|
|
|
|
|
|
</PRE>
|
|
<H2>FILES</H2><PRE>
|
|
<I>/usr/local/etc/sane.d/plustek</I><B>_</B><I>pp.conf</I>
|
|
The backend configuration file
|
|
|
|
<I>/usr/local/lib/sane/libsane-plustek</I><B>_</B><I>pp.a</I>
|
|
The static library implementing this backend.
|
|
|
|
<I>/usr/local/lib/sane/libsane-plustek</I><B>_</B><I>pp.so</I>
|
|
The shared library implementing this backend (present on systems
|
|
that support dynamic loading).
|
|
|
|
<I>/lib/modules/<Kernel-Version>/misc/pt</I><B>_</B><I>drv.o</I>
|
|
The Linux Kernelmodule.
|
|
|
|
|
|
</PRE>
|
|
<H2>CONTACT AND BUG-REPORTS</H2><PRE>
|
|
Please send any information and bug-reports to:
|
|
<B>Plustek</B> <B>Driver</B> <B>Mailing</B> <B>List</B> <B><plustek@linuxhacker.org></B>
|
|
or directly to:
|
|
<B>Gerhard</B> <B>Jaeger</B> <B><gerhard@gjaeger.de></B>
|
|
|
|
Additional info and hints can be obtained from our
|
|
Mailing-List archive at:
|
|
<B>http://www.linuxhacker.org/cgi-bin/ezmlm-cgi/3</B>
|
|
|
|
or directly from the projects' homepage at:
|
|
<B>http://www.gjaeger.de/scanner/plustek.html</B>
|
|
|
|
To obtain debug messages from the backend, please set the environment-
|
|
variable <I>SANE</I><B>_</B><I>DEBUG</I><B>_</B><I>PLUSTEK</I> before calling your favorite scan-frontend
|
|
(i.e. xscanimage).
|
|
<B>i.e.:</B> <B>export</B> <B>SANE_DEBUG_PLUSTEK_PP=20</B> <B>;</B> <B>xscanimage</B>
|
|
|
|
The value controls the verbosity of the backend.
|
|
|
|
|
|
</PRE>
|
|
<H2>KNOWN BUGS & RESTRICTIONS</H2><PRE>
|
|
* The Halftoning works, but the quality is poor
|
|
* Printers (especially HP models) will start to
|
|
print during scanning. This in fact is a problem
|
|
to other printers too, using bidirectional protocol
|
|
(see www.plustek.com (TAIWAN) page for further details)
|
|
* The driver does not support these manic scalings up
|
|
to 16 times the physical resolution. The only scaling
|
|
is done on resolutions between the physical resolution
|
|
of the CDD-sensor and the stepper motor i.e. you have a
|
|
600x1200 dpi scanner and you are scanning using 800dpi,
|
|
so scaling is necesary, because the sensor only delivers
|
|
600dpi but the motor is capable to perform 800dpi steps.
|
|
* On some devices, the pictures seems to be bluished
|
|
|
|
ASIC 98001 based models:
|
|
* The 300dpi transparency and negative mode does not work
|
|
correctly.
|
|
* There is currently no way to distinguish a model with
|
|
and without transpareny unit.
|
|
* The scanned images seem to be too dark (P9636T)
|
|
|
|
ASIC 96003/1 based models:
|
|
* 30bit mode is currently not supported.
|
|
* On low-end systems and under heavy system load, the
|
|
driver will loose data, this might causes the sensor
|
|
to hit the scan-bed and/or the picture is corrupted.
|
|
* The scanspeed on 600x1200 dpi models is slow.
|
|
* The scanquality of the A3I is poor
|
|
|
|
sane-backends 1.0.12-cvs 24 September 2003 <B><A HREF="sane-plustek_pp.5.html">sane-plustek_pp(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>
|