2003-09-23 15:30:05 +00:00
|
|
|
<HTML>
|
|
|
|
|
<HEAD>
|
|
|
|
|
<TITLE>sane-plustek.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-plustek.5</H1>
|
|
|
|
|
<HR>
|
|
|
|
|
<PRE>
|
|
|
|
|
<!-- Manpage converted by man2html 3.0.1 -->
|
|
|
|
|
<B><A HREF="sane-plustek.5.html">sane-plustek(5)</A></B> SANE Scanner Access Now Easy <B><A HREF="sane-plustek.5.html">sane-plustek(5)</A></B>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
<H2>NAME</H2><PRE>
|
2004-05-18 18:21:25 +00:00
|
|
|
sane-plustek - SANE backend for LM983[1/2/3] based USB flatbed scanners
|
2003-09-23 15:30:05 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
<H2>DESCRIPTION</H2><PRE>
|
|
|
|
|
The <B>sane-plustek</B> library implements a SANE (Scanner Access Now Easy)
|
2003-09-24 16:17:33 +00:00
|
|
|
backend that provides access to USB flatbed scanners based on National
|
|
|
|
|
Semiconductor Merlin chipsets (LM9831, 9832 and 9833). If you're look-
|
|
|
|
|
ing for parallel-port support for Plustek scanner please refer to the
|
|
|
|
|
<B>sane-plustek_pp</B> backend.
|
2003-09-23 15:30:05 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
2003-09-24 16:17:33 +00:00
|
|
|
<H2>SUPPORTED DEVICES</H2><PRE>
|
2003-09-23 15:30:05 +00:00
|
|
|
The Backend is able to support USB scanner based on the National Semi-
|
2003-09-24 16:17:33 +00:00
|
|
|
conductor chipsets LM9831, LM9832 and LM9833. The following tables show
|
2003-09-23 15:30:05 +00:00
|
|
|
various devices which are currently reported to work. If your Plustek
|
2004-05-18 18:21:25 +00:00
|
|
|
scanner has another Product ID, then the device is <B>NOT</B> supported by
|
|
|
|
|
this backend.
|
2003-09-23 15:30:05 +00:00
|
|
|
|
|
|
|
|
Vendor Plustek - ID: 0x07B3
|
|
|
|
|
----------------------------------------------------------
|
|
|
|
|
USB Model: ASIC: Properties: Prod-ID
|
|
|
|
|
----------------------------------------------------------
|
|
|
|
|
OpticPro U12 LM9831 600x1200dpi 42bit 512Kb 0x0010
|
|
|
|
|
OpticPro UT12 LM9831 600x1200dpi 42bit 512Kb 0x0013
|
|
|
|
|
OpticPro UT12 LM9832 600x1200dpi 42bit 512Kb 0x0017
|
|
|
|
|
OpticPro UT16 LM9832 600x1200dpi 42bit 512Kb 0x0017
|
|
|
|
|
OpticPro U24 LM9831 1200x2400dpi 42bit 2Mb 0x0011
|
|
|
|
|
OpticPro U24 LM9832 1200x2400dpi 42bit 2Mb 0x0015
|
|
|
|
|
OpticPro UT24 LM9832 1200x2400dpi 42bit 2Mb 0x0017
|
|
|
|
|
|
|
|
|
|
Vendor KYE/Genius - ID: 0x0458
|
|
|
|
|
----------------------------------------------------------
|
|
|
|
|
USB Model: ASIC: Properties: Prod-ID
|
|
|
|
|
----------------------------------------------------------
|
|
|
|
|
Colorpage HR6 V2 LM9832 600x1200dpi 42bit 512Kb 0x2007
|
|
|
|
|
Colorpage HR6 V2 LM9832 600x1200dpi 42bit 512Kb 0x2008
|
|
|
|
|
Colorpage HR6A LM9832 600x1200dpi 42bit 512Kb 0x2009
|
|
|
|
|
Colorpage HR7 LM9832 600x1200dpi 42bit 512Kb 0x2013
|
|
|
|
|
Colorpage HR7LE LM9832 600x1200dpi 42bit 512Kb 0x2015
|
|
|
|
|
Colorpage HR6X LM9832 600x1200dpi 42bit 512Kb 0x2016
|
|
|
|
|
|
|
|
|
|
Vendor Hewlett-Packard - ID: 0x03F0
|
|
|
|
|
----------------------------------------------------------
|
|
|
|
|
USB Model: ASIC: Properties: Prod-ID
|
|
|
|
|
----------------------------------------------------------
|
|
|
|
|
ScanJet 2100C LM9831 600x1200dpi 42bit 512Kb 0x0505
|
|
|
|
|
ScanJet 2200C LM9832 600x1200dpi 42bit 512Kb 0x0605
|
|
|
|
|
|
|
|
|
|
Vendor Mustek - ID: 0x0400
|
|
|
|
|
----------------------------------------------------------
|
|
|
|
|
USB Model: ASIC: Properties: Prod-ID
|
|
|
|
|
----------------------------------------------------------
|
|
|
|
|
BearPaw 1200 LM9831 600x1200dpi 42bit 512Kb 0x1000
|
2004-05-18 18:21:25 +00:00
|
|
|
BearPaw 1200 LM9832 600x1200dpi 42bit 512Kb 0x1001*
|
2003-09-23 15:30:05 +00:00
|
|
|
BearPaw 2400 LM9832 1200x2400dpi 42bit 2Mb 0x1001
|
2004-05-18 18:21:25 +00:00
|
|
|
* see also description for model override switch below!
|
2003-09-23 15:30:05 +00:00
|
|
|
|
|
|
|
|
Vendor UMAX - ID: 0x1606
|
|
|
|
|
----------------------------------------------------------
|
|
|
|
|
USB Model: ASIC: Properties: Prod-ID
|
|
|
|
|
----------------------------------------------------------
|
|
|
|
|
UMAX 3400/3450 LM9832 600x1200dpi 42bit 512Kb 0x0060
|
|
|
|
|
UMAX 5400 LM9832 1200x2400dpi 42bit 512Kb 0x0160
|
|
|
|
|
|
|
|
|
|
Vendor COMPAQ - ID: 0x049F
|
|
|
|
|
----------------------------------------------------------
|
|
|
|
|
USB Model: ASIC: Properties: Prod-ID
|
|
|
|
|
----------------------------------------------------------
|
|
|
|
|
S4-100 LM9832 600x1200dpi 42bit 512Kb 0x001A
|
|
|
|
|
|
|
|
|
|
Vendor Epson - ID: 0x04B8
|
|
|
|
|
----------------------------------------------------------
|
|
|
|
|
USB Model: ASIC: Properties: Prod-ID
|
|
|
|
|
----------------------------------------------------------
|
|
|
|
|
Perfection 1250 LM9832 1200x2400dpi 42bit 512Kb 0x010F
|
|
|
|
|
Perfection 1260 LM9832 1200x2400dpi 42bit 512Kb 0x011D
|
|
|
|
|
|
|
|
|
|
Vendor CANON - ID: 0x04A9
|
|
|
|
|
----------------------------------------------------------
|
|
|
|
|
USB Model: ASIC: Properties: Prod-ID
|
|
|
|
|
----------------------------------------------------------
|
|
|
|
|
CanoScan N650/656U LM9832 600x1200dpi 42bit 512Kb 0x2206
|
|
|
|
|
CanoScan N1220U LM9832 1200x2400dpi 42bit 512Kb 0x2207
|
2004-05-18 18:21:25 +00:00
|
|
|
CanoScan D660U LM9832 600x1200dpi 42bit 512Kb 0x2208
|
2003-09-23 15:30:05 +00:00
|
|
|
CanoScan N670/676U LM9833 600x1200dpi 48bit 512Kb 0x220D
|
|
|
|
|
CanoScan N1240U LM9833 1200x2400dpi 48bit 512Kb 0x220E
|
|
|
|
|
CanoScan LIDE20 LM9833 600x1200dpi 48bit 512Kb 0x220D
|
|
|
|
|
CanoScan LIDE30 LM9833 1200x2400dpi 48bit 512Kb 0x220E
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
<H2>OTHER PLUSTEK SCANNERS</H2><PRE>
|
2003-09-24 16:17:33 +00:00
|
|
|
For parallelport device support see the <B>plustek_pp</B> backend.
|
2003-09-23 15:30:05 +00:00
|
|
|
The SCSI scanner OpticPro 19200S is a rebadged Artec AM12S scanner and
|
|
|
|
|
is supported by the <B>Artec</B> backend.
|
2003-09-24 16:17:33 +00:00
|
|
|
Only the National Semiconductor LM983[1/2/] based devices of Plustek
|
2004-05-18 18:21:25 +00:00
|
|
|
are supported by this backend. Older versions of the U12, the UT12, the
|
2003-09-23 15:30:05 +00:00
|
|
|
U1212 and U1248 (GrandTech chipset) are not supported.
|
|
|
|
|
|
|
|
|
|
Model Chipset backend
|
|
|
|
|
---------------------------
|
|
|
|
|
U1248 GrandTech gt68xx
|
|
|
|
|
UT16B GrandTech gt68xx
|
2004-05-18 18:21:25 +00:00
|
|
|
U12 P98003 u12
|
|
|
|
|
UT12 P98003 u12
|
|
|
|
|
1212U P98003 u21
|
|
|
|
|
For a more complete and up to date list see: <B>http://www.sane-</B>
|
|
|
|
|
<B>project.org/sane-supported-devices.html</B>
|
2003-09-23 15:30:05 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
<H2>CONFIGURATION</H2><PRE>
|
2003-09-24 16:17:33 +00:00
|
|
|
To use your scanner with this backend, you need at least two entries in
|
|
|
|
|
the configuration file
|
2003-09-23 15:30:05 +00:00
|
|
|
<I>/usr/local/etc/sane.d/plustek.conf</I>
|
|
|
|
|
|
2003-11-23 12:03:17 +00:00
|
|
|
<I>[usb]</I> <I>vendor-id</I> <I>product-id</I>
|
2003-09-23 15:30:05 +00:00
|
|
|
|
|
|
|
|
<I>device</I> <I>/dev/usbscanner</I>
|
|
|
|
|
|
2004-05-18 18:21:25 +00:00
|
|
|
<I>[usb]</I> tells the backend, that the following devicename (here <I>/dev/usb-</I>
|
|
|
|
|
<I>scanner</I> ) has to be interpreted as USB scanner device. If vendor- and
|
|
|
|
|
product-id has not been specified, the backend tries to detect this by
|
2003-11-23 12:03:17 +00:00
|
|
|
its own. If device ist set to <I>auto</I>
|
2003-09-23 15:30:05 +00:00
|
|
|
then the next matching device is used.
|
|
|
|
|
|
|
|
|
|
<B>The</B> <B>Options:</B>
|
|
|
|
|
|
|
|
|
|
option warmup t
|
|
|
|
|
<I>t</I> specifies the warmup period in seconds
|
|
|
|
|
|
|
|
|
|
option lampOff t
|
2004-05-18 18:21:25 +00:00
|
|
|
<I>t</I> is the time in seconds for switching off the lamps in standby
|
2003-09-23 15:30:05 +00:00
|
|
|
mode
|
|
|
|
|
|
|
|
|
|
option lOffonEnd b
|
|
|
|
|
<I>b</I> specifies the behaviour when closing the backend, 1 --> switch
|
|
|
|
|
lamps off, 0 --> do not change lamp status
|
|
|
|
|
|
2004-05-18 18:21:25 +00:00
|
|
|
option mov m
|
|
|
|
|
<I>m</I> is the model override switch. It works only with Mustek
|
|
|
|
|
BearPaw devices.
|
|
|
|
|
m/PID | 0x1000 | 0x1001
|
|
|
|
|
------+--------------+--------------
|
|
|
|
|
0 | BearPaw 1200 | BearPaw 2400
|
|
|
|
|
1 | no function | BearPaw 1200
|
|
|
|
|
|
2003-09-23 15:30:05 +00:00
|
|
|
option invertNegatives b
|
2003-09-24 16:17:33 +00:00
|
|
|
<I>b</I> 0 --> do not invert the picture during negativ scans, 1 -->
|
2003-09-23 15:30:05 +00:00
|
|
|
invert picture
|
|
|
|
|
|
2003-09-24 16:17:33 +00:00
|
|
|
option cacheCalData b
|
|
|
|
|
<I>b</I> 0 --> do not save coarse calibration results, 1 --> save
|
|
|
|
|
results of coarse calibration in ~/.sane/ directory
|
|
|
|
|
|
2003-09-30 12:09:26 +00:00
|
|
|
option altCalibration b
|
2003-09-24 16:17:33 +00:00
|
|
|
<I>b</I> 0 --> use standard calibration routines, 1 --> use alternate
|
|
|
|
|
calibration (only non Plustek
|
|
|
|
|
devices, standard for CIS devices)
|
|
|
|
|
|
|
|
|
|
option skipFine b
|
|
|
|
|
<I>b</I> 0 --> perform fine calibration, 1 --> skip fine calibration
|
|
|
|
|
(only non Plustek devices)
|
|
|
|
|
|
|
|
|
|
option skipFineWhite b
|
|
|
|
|
<I>b</I> 0 --> perform white fine calibration, 1 --> skip white fine
|
|
|
|
|
calibration (only non Plustek devices)
|
|
|
|
|
|
2003-09-23 15:30:05 +00:00
|
|
|
option skipCalibration b
|
2003-09-24 16:17:33 +00:00
|
|
|
<I>b</I> 0 --> perform calibration, 1 --> skip calibration (only non
|
2003-09-23 15:30:05 +00:00
|
|
|
Plustek devices)
|
|
|
|
|
|
|
|
|
|
option enableTPA b
|
2003-09-24 16:17:33 +00:00
|
|
|
<I>b</I> 0 --> default behaviour, specified by the internal tables, 1
|
2003-09-23 15:30:05 +00:00
|
|
|
--> override internal tables and allow TPA mode (EPSON only)
|
|
|
|
|
|
|
|
|
|
option posOffX x
|
|
|
|
|
option posOffY y
|
|
|
|
|
option tpaOffX x
|
|
|
|
|
option tpaOffY y
|
|
|
|
|
option negOffX x
|
|
|
|
|
option negOffY y
|
2003-09-24 16:17:33 +00:00
|
|
|
<I>x</I> <I>y</I> By using this settings, the user can adjust the given image
|
2003-09-23 15:30:05 +00:00
|
|
|
positions. <B>Please</B> <B>note,</B> <B>that</B> <B>there's</B> <B>no</B> <B>internal</B> <B>range</B> <B>checking</B>
|
|
|
|
|
<B>for</B> <B>this</B> <B>feature.</B>
|
|
|
|
|
|
|
|
|
|
option posShadingY p
|
|
|
|
|
option tpaShadingY p
|
|
|
|
|
option negShadingY p
|
2003-09-24 16:17:33 +00:00
|
|
|
<I>p</I> overrides the internal shading position. The values are in
|
2003-09-23 15:30:05 +00:00
|
|
|
steps. <B>Please</B> <B>note,</B> <B>that</B> <B>there's</B> <B>no</B> <B>internal</B> <B>range</B> <B>checking</B> <B>for</B>
|
|
|
|
|
<B>this</B> <B>feature.</B>
|
|
|
|
|
|
|
|
|
|
option redGamma r
|
|
|
|
|
option greenGamma g
|
|
|
|
|
option blueGamma b
|
|
|
|
|
option grayGamma gr
|
|
|
|
|
<I>r</I> <I>g</I> <I>b</I> <I>gr</I>
|
|
|
|
|
By using these values, the internal linear gamma table (r,g,b,gr = 1.0)
|
|
|
|
|
can be adjusted.
|
|
|
|
|
|
|
|
|
|
option red_gain r
|
|
|
|
|
option green_gain g
|
|
|
|
|
option blue_gain b
|
|
|
|
|
<I>r</I> <I>g</I> <I>b</I> These values can be used to adjust the internally detected
|
2003-09-24 16:17:33 +00:00
|
|
|
gain values of the AFE for each channel. The range is between 0
|
2003-09-23 15:30:05 +00:00
|
|
|
and 63.
|
|
|
|
|
|
|
|
|
|
See the plustek.conf file for examples.
|
|
|
|
|
|
|
|
|
|
<B>Note:</B>
|
2003-09-24 16:17:33 +00:00
|
|
|
You have to make sure, that the USB subsystem is loaded correctly and
|
2004-05-18 18:21:25 +00:00
|
|
|
you have access to the device-node. For more details see <B>sane-usb</B> <B>(5)</B>
|
|
|
|
|
manpage. You might use <B>sane-find-scanner</B> to check that you have access
|
|
|
|
|
to your device.
|
2003-09-24 16:17:33 +00:00
|
|
|
|
|
|
|
|
<B>Note:</B>
|
|
|
|
|
If there's no configuration file, the backend defaults to <B>device</B> <B>auto</B>
|
2003-09-23 15:30:05 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
<H2>FILES</H2><PRE>
|
|
|
|
|
<I>/usr/local/etc/sane.d/plustek.conf</I>
|
|
|
|
|
The backend configuration file
|
|
|
|
|
|
|
|
|
|
<I>/usr/local/lib/sane/libsane-plustek.a</I>
|
|
|
|
|
The static library implementing this backend.
|
|
|
|
|
|
|
|
|
|
<I>/usr/local/lib/sane/libsane-plustek.so</I>
|
|
|
|
|
The shared library implementing this backend (present on systems
|
|
|
|
|
that support dynamic loading).
|
|
|
|
|
|
|
|
|
|
|
2004-05-18 18:21:25 +00:00
|
|
|
</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_PLUSTEK</B>
|
|
|
|
|
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_PLUSTEK=10
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
<H2>SEE ALSO</H2><PRE>
|
|
|
|
|
<B><A HREF="sane.7.html">sane(7)</A></B>, <B><A HREF="sane-usb.5.html">sane-usb(5)</A></B>, <B><A HREF="sane-plustek.5.html">sane-plustek(5)</A></B>,
|
|
|
|
|
<I>/usr/local/doc/sane-1.0.14-cvs/plustek/Plustek-USB.changes</I>
|
|
|
|
|
<I>http://www.gjaeger.de/scanner/plustek.html</I>
|
|
|
|
|
|
|
|
|
|
|
2003-09-23 15:30:05 +00:00
|
|
|
</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>
|
|
|
|
|
|
2004-05-18 18:21:25 +00:00
|
|
|
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
|
2003-09-23 15:30:05 +00:00
|
|
|
(i.e. xscanimage).
|
|
|
|
|
<B>i.e.:</B> <B>export</B> <B>SANE_DEBUG_PLUSTEK=20</B> <B>;</B> <B>xscanimage</B>
|
|
|
|
|
|
|
|
|
|
The value controls the verbosity of the backend. Please note, that val-
|
2004-05-18 18:21:25 +00:00
|
|
|
ues greater than 19 force the backend to output raw data files, which
|
|
|
|
|
could be rather large. The ending of these files is ".raw". For prob-
|
2003-09-23 15:30:05 +00:00
|
|
|
lem reports it should be enough the set the verbosity to 13.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
<H2>KNOWN BUGS & RESTRICTIONS</H2><PRE>
|
|
|
|
|
* 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
|
2004-05-18 18:21:25 +00:00
|
|
|
600dpi but the motor is capable to perform 1200dpi steps.
|
2003-09-23 15:30:05 +00:00
|
|
|
* Plusteks' model policy is somewhat inconsistent. This
|
|
|
|
|
means, they sell technical different devices under the
|
|
|
|
|
same product name. Therefore it is possible that some
|
|
|
|
|
devices like the UT12 or U12 won't work - please check
|
|
|
|
|
the model list above and compare the product-id to
|
|
|
|
|
the one your device has.
|
2003-09-24 16:17:33 +00:00
|
|
|
* Negative/Slide scanning quality is poor.
|
2003-09-23 15:30:05 +00:00
|
|
|
|
2004-05-18 18:21:25 +00:00
|
|
|
sane-backends 1.0.14-cvs 22 Mar 2004 <B><A HREF="sane-plustek.5.html">sane-plustek(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>
|
