1sane-plustek(5)          SANE Scanner Access Now Easy          sane-plustek(5)
2
3
4

NAME

6       sane-plustek - SANE backend for LM983[1/2/3] based USB flatbed scanners
7

DESCRIPTION

9       The  sane-plustek  library  implements a SANE (Scanner Access Now Easy)
10       backend that provides access to USB flatbed scanners based on  National
11       Semiconductor Merlin chipsets (LM9831, 9832 and 9833).  If you're look‐
12       ing for parallel-port support for Plustek scanner please refer  to  the
13       sane-plustek_pp backend.
14
15

SUPPORTED DEVICES

17       The  Backend is able to support USB scanner based on the National Semi‐
18       conductor chipsets LM9831, LM9832 and LM9833. The following tables show
19       various  devices  which are currently reported to work. If your Plustek
20       scanner has another Product ID, then the device  is  NOT  supported  by
21       this backend.
22
23       Vendor Plustek - ID: 0x07B3
24       ----------------------------------------------------------
25       USB Model:         ASIC:  Properties:              Prod-ID
26       ----------------------------------------------------------
27       OpticPro U12       LM9831  600x1200dpi 42bit 512Kb 0x0010
28       OpticPro UT12      LM9831  600x1200dpi 42bit 512Kb 0x0013
29       OpticPro UT12      LM9832  600x1200dpi 42bit 512Kb 0x0017
30       OpticPro UT16      LM9832  600x1200dpi 42bit 512Kb 0x0017
31       OpticPro U24       LM9831 1200x2400dpi 42bit   2Mb 0x0011
32       OpticPro U24       LM9832 1200x2400dpi 42bit   2Mb 0x0015
33       OpticPro UT24      LM9832 1200x2400dpi 42bit   2Mb 0x0017
34
35       Vendor KYE/Genius - ID: 0x0458
36       ----------------------------------------------------------
37       USB Model:         ASIC:  Properties:              Prod-ID
38       ----------------------------------------------------------
39       Colorpage HR6 V2   LM9832  600x1200dpi 42bit 512Kb 0x2007
40       Colorpage HR6 V2   LM9832  600x1200dpi 42bit 512Kb 0x2008
41       Colorpage HR6A     LM9832  600x1200dpi 42bit 512Kb 0x2009
42       Colorpage HR7      LM9832  600x1200dpi 42bit 512Kb 0x2013
43       Colorpage HR7LE    LM9832  600x1200dpi 42bit 512Kb 0x2015
44       Colorpage HR6X     LM9832  600x1200dpi 42bit 512Kb 0x2016
45
46       Vendor Hewlett-Packard - ID: 0x03F0
47       ----------------------------------------------------------
48       USB Model:         ASIC:  Properties:              Prod-ID
49       ----------------------------------------------------------
50       ScanJet 2100C      LM9831  600x1200dpi 42bit 512Kb 0x0505
51       ScanJet 2200C      LM9832  600x1200dpi 42bit 512Kb 0x0605
52
53       Vendor Mustek - ID: 0x0400
54       ----------------------------------------------------------
55       USB Model:         ASIC:  Properties:              Prod-ID
56       ----------------------------------------------------------
57       BearPaw 1200       LM9831  600x1200dpi 42bit 512Kb 0x1000
58       BearPaw 1200       LM9832  600x1200dpi 42bit 512Kb 0x1001*
59       BearPaw 2400       LM9832 1200x2400dpi 42bit   2Mb 0x1001
60       * see also description for model override switch below!
61
62       Vendor UMAX - ID: 0x1606
63       ----------------------------------------------------------
64       USB Model:         ASIC:  Properties:              Prod-ID
65       ----------------------------------------------------------
66       UMAX 3400          LM9832  600x1200dpi 42bit 512Kb 0x0050
67       UMAX 3400/3450     LM9832  600x1200dpi 42bit 512Kb 0x0060
68       UMAX 5400          LM9832 1200x2400dpi 42bit 512Kb 0x0160
69
70       Vendor COMPAQ - ID: 0x049F
71       ----------------------------------------------------------
72       USB Model:         ASIC:  Properties:              Prod-ID
73       ----------------------------------------------------------
74       S4-100             LM9832  600x1200dpi 42bit 512Kb 0x001A
75
76       Vendor Epson - ID: 0x04B8
77       ----------------------------------------------------------
78       USB Model:         ASIC:  Properties:              Prod-ID
79       ----------------------------------------------------------
80       Perfection 1250    LM9832 1200x2400dpi 42bit 512Kb 0x010F
81       Perfection 1260    LM9832 1200x2400dpi 42bit 512Kb 0x011D
82
83       Vendor CANON - ID: 0x04A9
84       ----------------------------------------------------------
85       USB Model:         ASIC:  Properties:              Prod-ID
86       ----------------------------------------------------------
87       CanoScan N650/656U LM9832  600x1200dpi 42bit 512Kb 0x2206
88       CanoScan N1220U    LM9832 1200x2400dpi 42bit 512Kb 0x2207
89       CanoScan D660U     LM9832  600x1200dpi 42bit 512Kb 0x2208
90       CanoScan N670/676U LM9833  600x1200dpi 48bit 512Kb 0x220D
91       CanoScan N1240U    LM9833 1200x2400dpi 48bit 512Kb 0x220E
92       CanoScan LIDE20    LM9833  600x1200dpi 48bit 512Kb 0x220D
93       CanoScan LIDE25    LM9833 1200x2400dpi 48bit 512Kb 0x2220
94       CanoScan LIDE30    LM9833 1200x2400dpi 48bit 512Kb 0x220E
95
96       Vendor Syscan - ID: 0x0A82
97       ----------------------------------------------------------
98       USB Model:         ASIC:  Properties:              Prod-ID
99       ----------------------------------------------------------
100       Travelscan 662     LM9833  600x1200dpi 48bit 512Kb 0x6620
101
102

OTHER PLUSTEK SCANNERS

104       For parallelport device support see the plustek_pp backend.
105       The  SCSI scanner OpticPro 19200S is a rebadged Artec AM12S scanner and
106       is supported by the Artec backend.
107       Only the National Semiconductor LM983[1/2/] based  devices  of  Plustek
108       are supported by this backend. Older versions of the U12, the UT12, the
109       U1212 and U1248 (GrandTech chipset) are not supported.
110
111       Model             Chipset    backend
112       ------------------------------------
113       U1248             GrandTech  gt68xx
114       UT16B             GrandTech  gt68xx
115       OpticSlim 1200    GrandTech  gt68xx
116       OpticSlim 2400    GrandTech  gt68xx
117       U12                P98003     u12
118       UT12               P98003     u12
119       1212U              P98003     u12
120       For  a  more  complete  and  up  to  date  list  see:  http://www.sane-
121       project.org/sane-supported-devices.html
122
123

CONFIGURATION

125       To use your scanner with this backend, you need at least two entries in
126       the configuration file /etc/sane.d/plustek.conf
127              [usb] vendor-id product-id
128              device /dev/usbscanner
129
130       [usb] tells the backend, that the following devicename (here  /dev/usb‐
131       scanner)  has  to  be interpreted as USB scanner device. If vendor- and
132       product-id has not been specified, the backend tries to detect this  by
133       its  own.  If  device  is  set to auto then the next matching device is
134       used.
135       The following options can be used for a default setup of  your  device.
136       Most of them are also available through the frontend.
137
138       The Options:
139
140       option warmup t
141              t  specifies  the  warmup  period  in seconds, if set to -1, the
142              automatic warmup function will be used
143
144       option lampOff t
145              t is the time in seconds for switching off the lamps in  standby
146              mode
147
148       option lOffonEnd b
149              b specifies the behaviour when closing the backend, 1 --> switch
150              lamps off, 0 --> do not change lamp status
151
152       option mov m
153              m is the model  override  switch.  It  works  only  with  Mustek
154              BearPaw devices.
155              m/PID |    0x1000    |    0x1001
156              ------+--------------+--------------
157                0   | BearPaw 1200 | BearPaw 2400
158                1   |  no function | BearPaw 1200
159
160       option invertNegatives b
161              b  0  -->  do not invert the picture during negativ scans, 1 -->
162              invert picture
163
164       option cacheCalData b
165              b 0 --> do not save calibration results, 1 --> save  results  of
166              calibration in ~/.sane/ directory
167
168       option altCalibration b
169              b  0  --> use standard calibration routines, 1 --> use alternate
170              calibration (only non Plustek devices, standard for CIS devices)
171
172       option skipFine b
173              b 0 --> perform fine calibration, 1 -->  skip  fine  calibration
174              (only non Plustek devices)
175
176       option skipFineWhite b
177              b  0  -->  perform white fine calibration, 1 --> skip white fine
178              calibration (only non Plustek devices)
179
180       option skipCalibration b
181              b 0 --> perform calibration, 1 --> skip  calibration  (only  non
182              Plustek devices)
183
184       option enableTPA b
185              b  0  --> default behaviour, specified by the internal tables, 1
186              --> override internal tables  and  allow  TPA  mode  (EPSON/UMAX
187              only)
188
189
190       option posOffX x
191       option posOffY y
192       option tpaOffX x
193       option tpaOffY y
194       option negOffX x
195       option negOffY y
196              x  y By using this settings, the user can adjust the given image
197              positions.  Please note, that there's no internal range checking
198              for this feature.
199
200       option posShadingY p
201       option tpaShadingY p
202       option negShadingY p
203              p  overrides  the  internal  shading position. The values are in
204              steps.  Please note, that there's no internal range checking for
205              this feature.
206
207       option redGamma r
208       option greenGamma g
209       option blueGamma b
210       option grayGamma gr
211              r g b gr
212       By using these values, the internal linear gamma table (r,g,b,gr = 1.0)
213       can be adjusted.
214
215       option red_gain r
216       option red_offset ro
217       option green_gain g
218       option green_offset go
219       option blue_gain b
220       option blue_offset bo
221              r g b ro go bo These values can be used to set the gain and off‐
222              set  values  of the AFE for each channel. The range is between 0
223              and 63. -1 means autocalibration.
224
225
226       See the plustek.conf file for examples.
227
228       Note:
229       You have to make sure, that the USB subsystem is loaded  correctly  and
230       you  have  access to the device-node. For more details see sane-usb (5)
231       manpage. You might use sane-find-scanner to check that you have  access
232       to your device.
233
234       Note:
235       If there's no configuration file, the backend defaults to device auto
236
237

FILES

239       /etc/sane.d/plustek.conf
240              The backend configuration file
241
242       /usr/lib*/sane/libsane-plustek.a
243              The static library implementing this backend.
244
245       /usr/lib*/sane/libsane-plustek.so
246              The shared library implementing this backend (present on systems
247              that support dynamic loading).
248
249

ENVIRONMENT

251       SANE_CONFIG_DIR
252              This environment variable specifies the list of directories that
253              may contain the configuration file.  Under UNIX, the directories
254              are separated by a colon (`:'), under OS/2, they  are  separated
255              by a semi-colon (`;').  If this variable is not set, the config‐
256              uration file is searched in two default directories: first,  the
257              current working directory (".") and then in /etc/sane.d.  If the
258              value of the environment variable ends with the directory  sepa‐
259              rator character, then the default directories are searched after
260              the explicitly  specified  directories.   For  example,  setting
261              SANE_CONFIG_DIR  to  "/tmp/config:"  would result in directories
262              "tmp/config", ".", and "/etc/sane.d"  being  searched  (in  this
263              order).
264
265       SANE_DEBUG_PLUSTEK
266              If  the  library  was  compiled with debug support enabled, this
267              environment variable controls the debug level for this  backend.
268              Higher debug levels increase the verbosity of the output.
269
270              Example: export SANE_DEBUG_PLUSTEK=10
271
272

SEE ALSO

274       sane(7), sane-usb(5), sane-u12(5), sane-gt68xx(5),
275       /usr/share/doc/sane-backends-1.0.18/plustek/Plustek-USB.changes
276       http://www.gjaeger.de/scanner/plustek/
277
278

CONTACT AND BUG-REPORTS

280       Please send any information and bug-reports to:
281       SANE Mailing List
282
283       Additional info and hints can be obtained from our
284       Mailing-List archive at:
285       http://www.sane-project.org/mailing-lists.html
286
287       or directly from the projects' homepage at:
288       http://www.gjaeger.de/scanner/plustek/
289
290       To  obtain debug messages from the backend, please set the environment-
291       variable SANE_DEBUG_PLUSTEK before calling your favorite  scan-frontend
292       (i.e. xscanimage).
293       i.e.: export SANE_DEBUG_PLUSTEK=20 ; xscanimage
294
295       The value controls the verbosity of the backend. Please note, that val‐
296       ues greater than 24 force the backend to output raw data  files,  which
297       could  be rather large. The ending of these files is ".raw".  For prob‐
298       lem reports it should be enough the set the verbosity to 13.
299
300

KNOWN BUGS & RESTRICTIONS

302       * The driver does not support these manic scalings up to 16  times  the
303       physical  resolution.  The  only scaling is done on resolutions between
304       the physical resolution of the CCD-/CIS-sensor and  the  stepper  motor
305       i.e. you have a 600x1200 dpi scanner and you are scanning using 800dpi,
306       so scaling is necessary, because the sensor only  delivers  600dpi  but
307       the motor is capable to perform 1200dpi steps.
308
309       *  Plusteks'  model  policy is somewhat inconsistent. They sell techni‐
310       cally different devices under the same product name.  Therefore  it  is
311       possible  that  some  devices  like the UT12 or U12 won't work - please
312       check the model list above and compare the product-id to the  one  your
313       device has.
314
315       * Negative/Slide scanning quality is poor.
316
317
318
319sane-backends 1.0.18             09 April 2006                 sane-plustek(5)
Impressum