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 This file is a short descripton for the avision-backend shipped with
13 SANE.
14
17 The sane-avision library implements a SANE (Scanner Access Now Easy)
18 backend that provides access to various Avision scanners and the Avi‐
19 sion OEM scanners labelled by HP, Minolta, Mitsubishi or Fujitsu.
20 It is fully big-endian aware and in every-day use on PowerPC and SPARC
22 systems.
23 I suggest you hold one hand on the power-button of the scanner while
25 you try the first scans - especially with film-scanners!
26
29 The configuration file for this backend resides in /etc/sane.d/avi‐
30 sion.conf.
31 Its contents is a list of device names that correspond to Avision and
33 Avision compatible scanners and backend-options. Empty lines and lines
34 starting with a hash mark (#) are ignored. A sample configuration file
35 is shown below:
36 # this is a comment
38 option force-a4
40 option force-a3
41 option disable-gamma-table
42 option disable-calibration
43 #scsi Vendor Model Type Bus Channel ID LUN
45 scsi AVISION
46 scsi HP
47 scsi /dev/scanner
48 usb 0x03f0 0x0701
49 force-a4:
52 Forces the backend to overwrite the scanable area returned by
53 the scanner to ISO A4. 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 force-a3:
58 Forces the backend to overwrite the scanable area returned by
59 the scanner to ISO A3. Scanner that are known to return bogus
60 data are marked in the backend so if you need this option please
61 report this to the backend maintainer. USE WITH CARE!
62 disable-gamma-table:
64 Disables the usage of the scanner's gamma-table. You might try
65 this if your scans hang or only produces random garbage.
66 disable-calibration:
68 Disables the scanner's color calibration. You might try this if
69 your scans hang or only produces random garbage.
70 Note: Any option above modifies the default code-flow for your scan‐
72 ner. The options should only be used when you encounter problems
73 with the default be- haviour of the backend. Please report the
74 need of options to the backend-author so the backend can be
75 fixed as soon as possible.
76
79 This backend expects device names of the form:
80 scsi scsi-spec
82 usb usb-spec
84 Where scsi-spec is the path-name to a special device or a device ID for
86 the device that corresponds to a SCSI scanner. The special device name
87 must be a generic SCSI device or a symlink to such a device, for exam‐
88 ple on Linux "/dev/sga" or "/dev/sg0". The device ID is the ID returned
89 by the scanner, for example "HP" or "AVISION". See sane-scsi(5) for
90 details.
91 Note: Since the backend now includes native USB access, it is no
93 longer needed - even considered obsolete - to access USB scanner
94 via the SCSI emulation (named hpusbscsi on Linux) for Avision
95 USB devices such as the HP 53xx, HP 74xx or Minolta film-scan‐
96 ners.
97 usb-spec is the USB device name, the vendor/product ID pair or the name
99 used by libusb corresponding to the USB scanner. For example "0x03f0
100 0x0701" or "libusb:002:003". See sane-usb(5) for details.
101 The program sane-find-scanner helps to find out the correct scsi or usb
103 device name.
104 A list with supported devices is built into the avision backend so nor‐
106 mally specifying an ID should not be necessary.
107
110 /etc/sane.d/avision.conf
111 The backend configuration file (see also description of
112 SANE_CONFIG_DIR below).
113 /usr/lib64/sane/libsane-avision.a
115 The static library implementing this backend.
116 /usr/lib64/sane/libsane-avision.so
118 The shared library implementing this backend (present on systems
119 that support dynamic loading).
120
123 SANE_CONFIG_DIR
124 This environment variable specifies the list of directories that
125 may contain the configuration file. Under UNIX, the directories
126 are separated by a colon (`:'), under OS/2, they are separated
127 by a semi-colon (`;'). If this variable is not set, the config‐
128 uration file is searched in two default directories: first, the
129 current working directory (".") and then in /etc/sane.d. If the
130 value of the environment variable ends with the directory sepa‐
131 rator character, then the default directories are searched after
132 the explicitly specified directories. For example, setting
133 SANE_CONFIG_DIR to "/tmp/config:" would result in directories
134 "tmp/config", ".", and "/etc/sane.d" being searched (in this
135 order).
136 SANE_DEBUG_AVISION
138 If the library was compiled with debug support enabled, this
139 environment variable controls the debug level for this backend.
140 Higher debug levels increase the verbosity of the output. The
141 debug level 7 is the author's prefered value to debug backend
142 problems.
143 Example: export SANE_DEBUG_AVISION=7
145
148 sane(7), sane-scsi(5), sane-usb(5)
149 http://www.exactcode.de/oss/avision/
150
153 René Rebe and Meino Christian Cramer
154 11 Jul 2008 sane-avision(5)