summaryrefslogtreecommitdiff
path: root/doc/sane-umax1220u.man
blob: eea0e54ffe7c94188db88b023f55af18e059ed6c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
.TH sane\-umax1220u 5 "14 Jul 2008" "@PACKAGEVERSION@" "SANE Scanner Access Now Easy"
.IX sane\-umax
.SH NAME
sane\-umax1220u \- SANE backend for the UMAX Astra 1220U and similar scanners

.SH DESCRIPTION

The
.B sane\-umax1220
library implements a SANE (Scanner Access Now Easy) backend for the
the UMAX Astra 1220U and similar scanners.

For more information on this backend, please visit
.IR http://umax1220u\-sane.sourceforge.net/ .

.SH UMAX ASTRA 1600U/2000U/2100U SUPPORT

This backend is also able to drive the UMAX Astra 1600U/2000U/2100U.  The
2100U is confirmed to work. For the other scanners no reports have been received
yet. Please contact us and tell us if your scanner works
.RI ( sane\-devel@alioth-lists.debian.net ).

.SH CONFIGURATION

Usually, no manual configuration is necessary. The configuration file for this backend resides in
.IR @CONFIGDIR@/umax1220u.conf .

Its content is a list of device names that correspond to UMAX Astra scanners.
Empty lines and lines starting with a hash mark (#) are ignored. A sample
configuration file is shown below:

.nf
 #usb vendor product
 usb 0x1606 0x0010
 # Device list for non-linux systems
 /dev/scanner
 /dev/usb/scanner0
.fi

See
.BR sane\-usb (5)
for information on how to set the access permissions on the usb device files.

.SH FILES

.TP
The backend configuration file:
.I @CONFIGDIR@/umax1220u.conf
.TP
The static library implementing this backend:
.I @LIBDIR@/libsane\-umax1220u.a
.TP
The shared library implementing this backend:
.I @LIBDIR@/libsane\-umax1220u.so
(present on systems that support dynamic loading)

.SH ENVIRONMENT

.TP
.B SANE_DEBUG_UMAX1220U
If the library was compiled with debug support enabled, this environment
variable controls the debug level for this backend. E.g., a value of 128
requests all debug output to be printed. Smaller levels reduce verbosity:

.B SANE_DEBUG_UMAX1220U
values:

.ft CR
.nf
Number  Remark
\
 1       print failures
 2       print information
 3       print high-level function calls
 4       print high-level function checkpoints
 9       print mid-level function calls
 10      print mid-level function checkpoints
 80      print protocol-level function entry
 90      print protocol-level function exit
.fi
.ft R

.TP
Example:
export SANE_DEBUG_UMAX1220U=10

.SH KNOWN BUGS

600 dpi scanning may fail for large image sizes.

If you keep getting I/O errors, try cycling the power on your scanner to reset it.

There is no way to cancel a scan, since the driver ignores
.BR sane_cancel ().

If you try scanning an image which is too small, you will get I/O errors. Be
sure to adjust the scan area before doing a scan, since by default, the scan
area is zero.

.SH SEE ALSO
.BR sane (7),
.BR sane\-usb (5)

.TP
(Old) homepage:
.I http://umax1220u\-sane.sourceforge.net/

.SH AUTHOR
Marcio Luis Teixeira
.RI < marciot@users.sourceforge.net >

.SH EMAIL-CONTACT
.I sane\-devel@alioth-lists.debian.net

.SH REPORTING BUGS
This backend isn't actively maintained. Nevertheless, bug reports and comments
should be sent to the sane\-devel mailing list.  When reporting bugs, please run
the backend with
.B SANE_DEBUG_UMAX1220U
set to 10 and attach a copy of the log messages.