1sane-plustek_pp(5) SANE Scanner Access Now Easy sane-plustek_pp(5)
2
6 sane-plustek_pp - SANE backend for Plustek parallel port flatbed scan‐
7 ners
8
10 The sane-plustek_pp library implements a SANE (Scanner Access Now Easy)
11 backend that provides access to Plustek ASIC 9600[1/3] and P9800[1/3]
12 based parallel port flatbed scanners. The access of the scanner is ei‐
13 ther done directly by the backend or via kernel module, called pt_drv
14 which can be created out of the sane-plustek_pp backend code - see also
15 section BUILDING THE KERNEL MODULE for further information.
16
19 At present, the following scanners should work with this backend and/or
20 the kernel module:
21 PLUSTEK SCANNERS
23 Parallelport Model: ASIC: Properties:
25 ---------------------- ----- ------------------------
26 OpticPro PT12 98003 600x1200 dpi 36bit 512Kb
27 OpticPro P12 98003 600x1200 dpi 36bit 512Kb
28 OpticPro 9636T/12000T 98001 600x1200 dpi 36bit 512Kb
29 OpticPro 12000P Turbo 98001 600x1200 dpi 36bit 512Kb
30 OpticPro 9636P+/Turbo 98001 600x1200 dpi 36bit 512Kb
31 OpticPro 9636P 96003 600x1200 dpi 36bit 128Kb
32 OpticPro 12000P/96000P 96003 600x1200 dpi 36bit 128Kb
33 OpticPro 1236P 96003 600x1200 dpi 30bit 128Kb
34 OpticPro 9600P 96003 600x1200 dpi 30bit 128Kb
35 OpticPro 9630P/FBIV 96003 600x1200 dpi 30bit 128Kb
36 OpticPro 9630PL (14") 96003 600x1200 dpi 30bit 128Kb
37 OpticPro A3I 96003 400x800 dpi 36bit 128Kb
38 OpticPro 600P/6000P 96003 300x600 dpi 30bit 32Kb
39 OpticPro 4831P 96003 300x600 dpi 30bit 32Kb
40 OpticPro 4830P/FBIII 96003 300x600 dpi 30bit 32Kb
41 OpticPro 4800P/FBII 96001 300x600 dpi 24bit 32Kb
42 PRIMAX SCANNERS
44 There are some scanners sold by Primax, but they are in fact Plustek
46 devices. These scanners are also supported. The following table will
47 show the relationship:
48 Model: Plustek Model: Remarks:
50 --------------------------- -------------- ------------
51 Colorado 4800 OpticPro 4800 not tested
52 Compact 4800 Direct OpticPro 600 mov=2
53 Compact 4800 Direct 30bit OpticPro 4830 mov=7
54 Compact 9600 Direct 30bit OpticPro 9630 works
55 GENIUS SCANNERS
57 The following devices are sold as Genius Scanners, but are in fact
59 Plustek devices. The table will show the relationship:
60 Model: Remarks:
62 --------------------------- ----------------------------
63 Colorpage Vivid III V2 Like P12 but has two buttons
64 and Wolfson DAC
65 ARIES SCANNERS
67 There's one scanner sold as Aries Scanner, but is in fact a Plustek de‐
69 vice. The following table will show the relationship:
70 Model: Plustek Model: Remarks:
72 --------------------------- -------------- ------------
73 Scan-It 4800 OpticPro 600 mov=2
74 BrightScan SCANNERS
76 There's one scanner sold as BrightScan OpticPro Scanner, this is also a
78 rebadged Plustek device. The following table will show the relation‐
79 ship:
80 Model: Remarks:
82 --------------------------- ----------------------------
83 BrightScan OpticPro OpticPro P12
84
87 This backend works in two modes, the so called "direct-mode" and the
88 "kernel-mode". In direct-mode, the user-space backend is used, in ker‐
89 nel-mode, you should have a kernel-module named pt_drv loaded. This
90 backends default device is:
91 0x378
93 This "default device" will be used, if no configuration file can be
95 found. It is rather the base address of the parallel port on i386 ma‐
96 chines.
97 As the backend supports up to four devices, it is possible to specify
99 them in the configuration file
100 /etc/sane.d/plustek_pp.conf
102 See this file for examples.
104
106 This section describes the backend's configuration file entries. The
107 file is located at: /etc/sane.d/plustek_pp.conf
108 For a proper setup, you will need at least two entries:
110 [direct]
112 device 0x378
113 or
115 [kernel]
116 device /dev/pt_drv
117 direct tells the backend, that the following devicename (here 0x378)
119 has to be interpreted as parallel port scanner device. In fact it is
120 the address to use, alternatively you can use /dev/parport0 if the
121 backend has been compiled with libieee1284 support. kernel should only
122 be used, when a kernel-module has been built out of the backend
123 sources. See below for more instructions about this.
124 Further options:
126 option warmup t
128 t specifies the warmup period in seconds
129 option lampOff t
131 t is the time in seconds for switching off the lamps in standby
132 mode
133 option lOffonEnd b
135 b specifies the behaviour when closing the backend, 1 --> switch
136 lamps off, 0 --> do not change lamp status
137 option mov m
139 m is the model override switch, which only works in direct mode.
140 m = 0 default: no override
142 m = 1 OpticPro 9630PL override (works if OP9630 has been de‐
144 tected) forces legal size (14")
145 m = 2 Primax 4800Direct override (works if OP600 has been de‐
147 tected) swaps red/green color
148 m = 3 OpticPro 9636 override (works if OP9636 has been de‐
150 tected) disables backends transparency/negative capabili‐
151 ties
152 m = 4 OpticPro 9636P override (works if OP9636 has been de‐
154 tected) disables backends transparency/negative capabili‐
155 ties
156 m = 5 OpticPro A3I override (works if OP12000 has been de‐
158 tected) enables A3 scanning
159 m = 6 OpticPro 4800P override (works if OP600 has been de‐
161 tected) swaps red/green color
162 m = 7 Primax 4800Direct 30bit override (works if OP4830 has
164 been detected)
165 See the plustek_pp.conf file for examples.
167
169 As mentioned before, the sane-plustek_pp backend code can also be com‐
170 piled and installed as linux kernel module. To do so, you will need the
171 source-files of this sane-backend installation. Unpack this tar-ball
172 and go to the directory: sane-backends/doc/plustek. Within this direc‐
173 tory, you should find a script called: MakeModule.sh. Now if your
174 Linux kernelsources are installed correctly, it should be possible to
175 build, install and load the module pt_drv. Please note, that the ker‐
176 nelsources need to be configured correctly. Refer to your distribu‐
177 tions manual on how this is done. As root user, try
178 ./MakeModule.sh
180 the script will try and get all necessary information about your run‐
182 ning kernel and will lead you through the whole installation process.
183 Note: Installing and loading the can only be done as superuser.
184
186 The configuration of the kernel module is done by providing some or
187 more options found below to the kernel module at load time. This can be
188 done by invoking insmod(8) with the appropriate parameters or appending
189 the options to the file /etc/modules.conf (kernel < 2.6.x) or /etc/mod‐
190 probe.conf (kernel >= 2.6.x)
191 The Options:
193 lampoff=lll
194 The value lll tells the driver, after how many seconds to
195 switch-off the lamp(s). The default value is 180. 0 will dis‐
196 able this feature.
197 HINT: Do not use a value that is too small, because often
198 switching on/off the lamps will reduce their lifetime.
199 port=ppp
201 ppp specifies the port base address, where the scanner is con‐
202 nected to. The default value is 0x378, which is normally a stan‐
203 dard.
204 warmup=www
206 www specifies the time in seconds, how long a lamp has to be on,
207 until the driver will start to scan. The default value is 30.
208 lOffonEnd=e
210 e specifies the behaviour when unloading the driver, 1 -->
211 switch lamps off, 0 --> do not change lamp status
212 slowIO=s
214 s specifies which I/O functions the driver should use, 1 --> use
215 delayed functions, 0 --> use the non-delayed ones
216 forceMode=fm
218 fm specifies port mode which should be used, 0 --> autodetec‐
219 tion, 1 --> use SPP mode and 2 --> use EPP mode
220 mov=m
222 m = 0 default: no override
224 m = 1 OpticPro 9630PL override (works if OP9630 has been de‐
226 tected) forces legal size (14")
227 m = 2 Primax 4800Direct override (works if OP600 has been de‐
229 tected) swaps red/green color
230 m = 3 OpticPro 9636 override (works if OP9636 has been de‐
232 tected) disables backends transparency/negative capabili‐
233 ties
234 m = 4 OpticPro 9636P override (works if OP9636 has been de‐
236 tected) disables backends transparency/negative capabili‐
237 ties
238 m = 5 OpticPro A3I override (works if OP12000 has been de‐
240 tected) enables A3 scanning
241 m = 6 OpticPro 4800P override (works if OP600 has been de‐
243 tected) swaps red/green color
244 m = 7 Primax 4800Direct 30bit override (works if OP4830 has
246 been detected)
247 Sample entry for file /etc/modules.conf:
249 alias char-major-40 pt_drv
251 pre-install pt_drv modprobe -k parport
252 options pt_drv lampoff=180 warmup=15 port=0x378 lOffonEnd=0
253 mov=0 slowIO=0 forceMode=0
254 For multidevice support, simply add values separated by commas to the
256 different options
257 options pt_drv port=0x378,0x278 mov=0,4 slowIO=0,1 forceMode=0,1
259 Remember to call depmod(8) after changing /etc/conf.modules.
261
263 The current driver works best, when the parallel port has been set to
264 EPP-mode. When detecting any other mode such as ECP or PS/2 the driver
265 tries to set to a faster, supported mode. If this fails, it will use
266 the SPP mode, as this mode should work with all Linux supported paral‐
267 lel ports. If in doubt, enter your BIOS and set it to any mode except
268 ECP.
269 Former Plustek scanner models (4830, 9630) supplied a ISA parallel port
271 adapter card. This card is not supported by the driver.
272 The ASIC 96001/3 based models have sometimes trouble with high resolu‐
274 tion modes. If you encounter sporadic corrupted images (parts dupli‐
275 cated or shifted horizontally) kill all other applications before scan‐
276 ning and (if sufficient memory available) disable swapping.
277 See the plustek_pp.conf file for examples.
279
281 /etc/sane.d/plustek_pp.conf
282 The backend configuration file
283 /usr/lib64/sane/libsane-plustek_pp.a
285 The static library implementing this backend.
286 /usr/lib64/sane/libsane-plustek_pp.so
288 The shared library implementing this backend (present on systems
289 that support dynamic loading).
290 /lib/modules/<Kernel-Version>/kernel/drivers/parport/pt_drv.o
292 The Linux kernelmodule for kernels < 2.6.x.
293 /lib/modules/<Kernel-Version>/kernel/drivers/parport/pt_drv.ko
295 The Linux kernelmodule for kernels >= 2.6.x.
296
298 SANE_CONFIG_DIR
299 This environment variable specifies the list of directories that
300 may contain the configuration file. On *NIX systems, the direc‐
301 tories are separated by a colon (`:'), under OS/2, they are sep‐
302 arated by a semi-colon (`;'). If this variable is not set, the
303 configuration file is searched in two default directories:
304 first, the current working directory (".") and then in
305 /etc/sane.d. If the value of the environment variable ends with
306 the directory separator character, then the default directories
307 are searched after the explicitly specified directories. For
308 example, setting SANE_CONFIG_DIR to "/tmp/config:" would result
309 in directories tmp/config, ., and /etc/sane.d being searched (in
310 this order).
311 SANE_DEBUG_PLUSTEK_PP
313 If the library was compiled with debug support enabled, this en‐
314 vironment variable controls the debug level for this backend.
315 Higher debug levels increase the verbosity of the output.
316 Example: export SANE_DEBUG_PLUSTEK_PP=10
318
321 sane(7), xscanimage(1),
322 /usr/share/doc/sane-backends/plustek/Plustek-PARPORT.changes
323
326 Please send any information and bug-reports to:
327 SANE Mailing List
328 Additional info and hints can be obtained from our
330 Mailing-List archive at:
331 http://www.sane-project.org/mailing-lists.html
332 To obtain debug messages from the backend, please set the environment-
334 variable SANE_DEBUG_PLUSTEK_PP before calling your favorite scan-front‐
335 end (i.e. xscanimage(1)),i.e.:
336 export SANE_DEBUG_PLUSTEK_PP=20 ; xscanimage
337 The value controls the verbosity of the backend.
339
341 * The Halftoning works, but the quality is poor
342 * Printers (especially HP models) will start to print during scanning.
344 This in fact is a problem to other printers too, using bidirectional
345 protocol (see www.plustek.com (TAIWAN) page for further details)
346 * The driver does not support these manic scalings up to 16 times the
348 physical resolution. The only scaling is done on resolutions between
349 the physical resolution of the CCD-sensor and the stepper motor i.e.
350 you have a 600x1200 dpi scanner and you are scanning using 800dpi, so
351 scaling is necessary, because the sensor only delivers 600dpi but the
352 motor is capable to perform 800dpi steps.
353 * On some devices, the pictures seems bluish
355 ASIC 98001 based models:
357 * The 300dpi transparency and negative mode does not work correctly.
359 * There is currently no way to distinguish a model with and without
361 transparency unit.
362 * The scanned images seem to be too dark (P9636T)
364 ASIC 96003/1 based models:
366 * 30bit mode is currently not supported.
368 * On low end systems under heavy system load the driver may lose data,
370 which can result in picture corruption or cause the sensor to hit the
371 scan bed.
372 * The scanning speed on 600x1200 dpi models is slow.
374 * The scanning quality of the A3I is poor.
376 14 Jul 2008 sane-plustek_pp(5)