1sane-avision(5) SANE Scanner Access Now Easy sane-avision(5)
2
6 sane-avision - SANE backend for original Avision and Avision OEM scan‐
7 ners (HP, Minolta, Mitsubishi, UMAX and possibly more) flatbed and film
8 scanners.
9
12 The sane-avision library implements a SANE (Scanner Access Now Easy)
13 backend that provides access to various Avision scanners and the Avi‐
14 sion OEM scanners labelled by HP, Minolta, Mitsubishi or Fujitsu.
15 It is fully big-endian aware and in everyday use on PowerPC and SPARC
17 systems.
18 I suggest you hold one hand on the power-button of the scanner while
20 you try the first scans - especially with film-scanners!
21
24 The configuration file for this backend resides in /etc/sane.d/avi‐
25 sion.conf.
26 Its contents is a list of device names that correspond to Avision and
28 Avision compatible scanners and backend-options. Empty lines and lines
29 starting with a hash mark (#) are ignored. A sample configuration file
30 is shown below:
31 # this is a comment
33 option force-a4
34 option force-a3
35 option skip-adf
36 option disable-gamma-table
37 option disable-calibration
38 #scsi Vendor Model Type Bus Channel ID LUN
39 scsi AVISION
40 scsi HP
41 scsi /dev/scanner
42 usb 0x03f0 0x0701
43 force-a4:
46 Forces the backend to overwrite the scanable area returned by
47 the scanner to ISO A4. Scanner that are known to return bogus
48 data are marked in the backend so if you need this option please
49 report this to the backend maintainer. USE WITH CARE!
50 force-a3:
52 Forces the backend to overwrite the scanable area returned by
53 the scanner to ISO A3. Scanner that are known to return bogus
54 data are marked in the backend so if you need this option please
55 report this to the backend maintainer. USE WITH CARE!
56 skip-adf:
58 Forces the backend to ignore an inconsistent ADF status returned
59 by the scanner (ADF not present, but ADF model number non-zero).
60 Without this option, the backend will make several attempts to
61 reset the ADF and retry the query in this situation, and will
62 fail with a "not supported" error if the ADF still doesn't
63 respond.
64 disable-gamma-table:
66 Disables the usage of the scanner's gamma-table. You might try
67 this if your scans hang or only produces random garbage.
68 disable-calibration:
70 Disables the scanner's color calibration. You might try this if
71 your scans hang or only produces random garbage.
72 Note: Any option above modifies the default code-flow for your scan‐
74 ner. The options should only be used when you encounter problems
75 with the default be- haviour of the backend. Please report the
76 need of options to the backend-author so the backend can be
77 fixed as soon as possible.
78
81 This backend expects device names of the form:
82 scsi scsi-spec
84 usb usb-spec
86 Where scsi-spec is the path-name to a special device or a device ID for
88 the device that corresponds to a SCSI scanner. The special device name
89 must be a generic SCSI device or a symlink to such a device, for exam‐
90 ple on Linux /dev/sga or /dev/sg0. The device ID is the ID returned by
91 the scanner, for example "HP" or "AVISION". See sane-scsi(5) for
92 details.
93 Note: Since the backend now includes native USB access, it is no
95 longer needed - even considered obsolete - to access USB scanner
96 via the SCSI emulation (named hpusbscsi on Linux) for Avision
97 USB devices such as the HP 53xx, HP 74xx or Minolta film-scan‐
98 ners.
99 usb-spec is the USB device name, the vendor/product ID pair or the name
101 used by libusb corresponding to the USB scanner. For example "0x03f0
102 0x0701" or "libusb:002:003". See sane-usb(5) for details.
103 The program sane-find-scanner(1) helps to find out the correct scsi or
105 usb device name.
106 A list with supported devices is built into the avision backend so nor‐
108 mally specifying an ID should not be necessary.
109
112 /etc/sane.d/avision.conf
113 The backend configuration file (see also description of
114 SANE_CONFIG_DIR below).
115 /usr/lib64/sane/libsane-avision.a
117 The static library implementing this backend.
118 /usr/lib64/sane/libsane-avision.so
120 The shared library implementing this backend (present on systems
121 that support dynamic loading).
122
125 SANE_CONFIG_DIR
126 This environment variable specifies the list of directories that
127 may contain the configuration file. Under UNIX, the directories
128 are separated by a colon (`:'), under OS/2, they are separated
129 by a semi-colon (`;'). If this variable is not set, the config‐
130 uration file is searched in two default directories: first, the
131 current working directory (".") and then in /etc/sane.d. If the
132 value of the environment variable ends with the directory sepa‐
133 rator character, then the default directories are searched after
134 the explicitly specified directories. For example, setting
135 SANE_CONFIG_DIR to "/tmp/config:" would result in directories
136 tmp/config, ., and /etc/sane.d being searched (in this order).
137 SANE_DEBUG_AVISION
139 If the library was compiled with debug support enabled, this
140 environment variable controls the debug level for this backend.
141 Higher debug levels increase the verbosity of the output. The
142 debug level 7 is the author's preferred value to debug backend
143 problems.
144 Example: export SANE_DEBUG_AVISION=7
146
149 sane(7), sane-scsi(5), sane-usb(5)
150 http://exactcode.com/site/open_source/saneavision
151
154 René Rebe
155
158 René Rebe and Meino Christian Cramer
159 11 Jul 2008 sane-avision(5)