| sane-mustek_pp(5) | File Formats Manual | sane-mustek_pp(5) |
sane-mustek_pp - SANE backend for Mustek parallel port flatbed scanners
The sane-mustek_pp library implements a SANE (Scanner Access Now Easy) backend that provides access to Mustek parallel port flatbed scanners and OEM versions.
There are 2 classes of Mustek parallel port scanners: regular CCD (cold cathode device) scanners and CIS (contact image sensor) scanners.
The current version of this backend supports both CCD type scanners and CIS type 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 no SM 1200 ED Plus 1015 01 no SE 12000 P 1505 05 no 600 III EP Plus 1013/1015 00/01 yes SE 600 SEP 1013 ?? yes 600 II EP ???? ?? no MD9848 1015 00 yes Gallery 4800 ???? ?? yes Viviscan Compact II 1013 00 yes
Model: ASIC ID: works: ----------------------------------------------- Mustek 600 CP & 96 CP 1015 yes (*) Mustek 1200 CP 1015 yes Mustek 1200 CP+ 1015 yes
OEM versions Original works -------------------------------------------------- Medion/LifeTec/Tevion
MD/LT 9350/9351 1200 CP yes
MD/LT 9850/9851 1200 CP maybe (**)
MD/LT 9858 1200 CP probably
MD/LT 9890/9891 1200 CP yes Targa
Funline TS12EP 1200 CP yes
Funline TS6EP 600 CP yes Trust
Easy Connect 9600+ 600 CP yes Cybercom
9352 1200 CP yes (***)
(*) Calibration problems existed with earlier version of this driver. They seem to be solved now.
(**) Problems have been reported in the past for the MD/LT9850 type (striped scans, head moving in wrong direction at some resolutions). It is not known whether the current version of the driver still has these problems.
IF YOU HEAR LOUD CLICKING NOISES, IMMEDIATELY UNPLUG THE SCANNER ! (This holds for any type of scanner).
(***) Possibly, the engine_delay parameter has to be set to 1 ms for accurate engine movements.
Please note that this backend is still under construction. Certain models are currently not supported and some may never be because the communication protocol is still unknown (eg., SE 12000 P).
Some scanners work faster when EPP/ECP is enabled in the BIOS. EPP mode however may lead to hard-locks on some Linux systems. If that is the case for you, you can either disable ECP/EPP in your BIOS or disable it in the backend itself (see GLOBAL OPTIONS).
Note that the backend needs to run as root or has to have appropriate access rights to /dev/parport* if libieee1284 support is compiled in. To allow user access to the scanner run the backend through the network interface (See saned(8) and sane-net(5)). Note also that the backend does not support parport sharing, i.e. if you try printing while scanning, your computer may crash. To enable parport sharing, you have to enable libieee1284 at compile time. This backend also conflicts with the sane-musteka4s2 backend. You can only enable one of them in your dll.conf. However, you have to enable the backend explicitly in your dll.conf, just remove the hash mark in the line "mustek_pp".
This backend allows multiple devices being defined and configured via the mustek_pp.conf file (even simultaneously, provided that they are connected to different parallel ports). Please make sure to edit this file before you use the backend.
A device can be defined as follows:
where
<name> is an arbitrary name for the device, optionally enclosed by double quotes, for instance "LifeTec 9350".
<port name> is the name of the parallel port to which the device is connected. In case libieee1284 is used for communication with the port (default setup), valid port names are parport0, parport1, and parport2.
In case the backend is configured for raw IO (old setup), port addresses have to be used instead of port names: 0x378, 0x278, or 0x3BC. The mapping of parallel ports (lp0, lp1, and lp2) to these addresses can be different for different Linux kernel versions. For instance, 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/conf.modules, /etc/modules.conf and/or /proc/ioports.
If you are unsure which port to use, you can use the magic value * to probe for your scanner.
<driver> is the driver to use for this device. Currently available drivers are:
Using the cis600 driver on a 1200CP or a 1200CP+ is probably not dangerous. The cis1200+ driver also works for the 1200CP, and using the cis1200 driver on a 1200CP+ will typically result in scans that cover only half of the width of the scan area (also not dangerous).
If unsure about the exact model of your OEM version, check the optical resolution in the manual or on the box: the 600CP has a maximum optical resolution of 300x600 DPI, whereas the 1200CP and 1200CP+ have a maximum optical resolution of 600x1200 DPI.
Examples:
scanner Mustek_600CP 0x378 cis600
scanner Mustek_600IIIEP * ccd300
If in doubt which port you have to use, or whether your scanner is detected at all, you can use sane-find-scanner -p to probe all configured ports.
The contents of the mustek_pp.conf file is a list of device definitions and device options that correspond to Mustek scanners. Empty lines and lines starting with a hash mark (#) are ignored. Options have the following format:
Depending on the nature of the option, a value may or may not be present. Options always apply to the scanner definition that precedes them. There are no global options. Options are also driver-specific: not all drivers support all possible options.
Example: option bw 150
Example: option top_adjust -2.5
By default, fast skipping is used.
Example: option slow_skip
Note that every additional ms of delay can add up to 14 seconds to the total scanning time (highest resolution), so an as small as possible value is preferred.
Default value: 0
Minimum: 0
Maximum: 100
Example: option engine_delay 1
Default value: 47
Minimum: 0
Maximum: none
Example: option top 56
Default value: 700
Minimum: 0
Maximum: none
Example: option waitbank 700
A sample configuration file is shown below:
# # LifeTec/Medion 9350 on port 0x378 # scanner "LifeTec 9350" 0x378 cis1200 # Some calibration options (examples!). option bw 127 option top_skip -0.8 # # A Mustek 600CP on port 0x3BC # scanner "Mustek 600CP" 0x3BC cis600 # Some calibration options (examples!). option bw 120 option top_skip 1.2 # # A Mustek 1200CP+ on port 0x278 # scanner "Mustek 1200CP plus" 0x278 cis1200+ # Some calibration options (examples!). option bw 130 option top_skip 0.2 # # A Mustek 600 III EPP on port parport0 # scanner "Mustek 600 III EPP" parport0 ccd300 # Some calibration options (examples!). option bw 130 option top 56
You can control the overall behaviour of the mustek_pp backend by global options which precede any scanner definition in the mustek_pp.conf file.
Currently, there is only one global option:
Default value: use EPP
Example: option no_epp
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
level debug output ----------------------------
0 nothing
1 errors
2 warnings
3 things nice to know
4 code flow
5 detailed code flow
6 everything
sane(7), sane-mustek(5), sane-net(5), saned(8), sane-find-scanner(1)
Jochen Eisinger <jochen at penguin-breeder dot org> Eddy De Greef <eddy_de_greef at scarlet dot be>
Too many... please send bug reports to sane-devel@alioth-lists.debian.net (note that you have to subscribe first to the list before you can send emails... see http://www.sane-project.org/mailing-lists.html)
If something doesn't work, please contact us (Jochen for the CCD scanners, Eddy for the CIS scanners). But we need some information about your scanner to be able to help you...
| 13 Jul 2008 |