1sane-artec_eplus48u(5)               SANE               sane-artec_eplus48u(5)
2
3
4

NAME

6       sane-artec_eplus48u - SANE backend for the scanner Artec E+ 48U and re-
7       badged models
8

DESCRIPTION

10       The sane-artec_eplus48u library implements a SANE (Scanner  Access  Now
11       Easy)  backend that provides access to several USB flatbed scanners us‐
12       ing the GT6816 chipset like the Artec E+ 48U.  These  scanners  have  a
13       contact image sensor (CIS).
14
15       A    complete   list   of   supported   devices   can   be   found   on
16       http://www.sane-project.org/sane-supported-devices.html.
17
18       This is ALPHA software. Especially if you test new  or  untested  scan‐
19       ners,  keep  your hand at the scanner's plug and unplug it, if the head
20       bumps at the end of the scan area.
21
22       If you own a scanner other than the ones mentioned  on  the  list  that
23       works  with  this backend, please let us know this by sending the scan‐
24       ner's exact model name and the USB vendor and product  ids  (e.g.  from
25       /proc/bus/usb/devices,  sane-find-scanner(1)  or syslog) to me. Even if
26       the scanner's name is only slightly different from the models mentioned
27       above, please let me know.
28

KERNEL ISSUES

30       If libusb-0.1.6 or later is installed, this section can be skipped. The
31       scanner should be found by  sane-find-scanner(1)  without  further  ac‐
32       tions.  For  setting  permissions  and  general USB information look at
33       sane-usb(5).
34
35       When you are using the scanner module, a Linux kernel 2.4.12  or  newer
36       is required.
37
38

FIRMWARE FILE

40       You need a firmware file for your scanner. That's a small file contain‐
41       ing software that will be uploaded to the  scanner's  memory.  For  the
42       scanners  mentioned  above, it's usually named Artec48.usb or 1200.usb.
43       You can find it on the installation CD that was provided by  the  manu‐
44       facturer,  normally  in  the directory Win98, WinMe or similar.  If the
45       Windows-driver is installed on your computer, then you  can  also  find
46       the firmware file under c:264vers.
47
48

CONFIGURATION

50       The  contents  of  the  artec_eplus48u.conf file is a list of usb lines
51       containing vendor and product ids that correspond to USB scanners.  The
52       file  can  also  contain  option lines.  Empty lines and lines starting
53       with a hash mark (#) are ignored.  The scanners are autodetected by usb
54       vendor_id   product_id  statements  which  are  already  included  into
55       artec_eplus48u.conf .  "vendor_id"  and  "product_id"  are  hexadecimal
56       numbers that identify the scanner.
57
58       Every usb section can have additional options.
59
60       artecFirmwareFile /usr/share/sane/artec_eplus48u/Artec48.usb
61              The path to the firmware file. This option is required.
62
63       redGamma 1.0
64
65       greenGamma 1.0
66
67       blueGamma 1.0
68
69       masterGamma 1.9
70              These  are  the  default gamma values. If you set the "Defaults"
71              option with a frontend, then the gamma options are reset to  the
72              values specified here.
73
74       redOffset 0x28
75
76       greenOffset 0x2f
77
78       blueOffset 0x2f
79
80       redExposure 0xa7
81
82       greenExposure 0x116
83
84       blueExposure 0xdc
85              These  are the default values for offset and exposure time.  You
86              can change them (e.g. to speed up calibration) if you don't want
87              to save the calibration data permanently.
88
89       vendorString Artec
90
91       modelString E+ 48U
92              By  default,  the  scanner is reported as "Artec E+ 48U". If you
93              don't like this, e.g.  because you have an Tevion MD 9693,  then
94              change the options accordingly.
95

FILES

97       /usr/local/etc/sane.d/artec_eplus48u.conf
98              The   backend   configuration  file  (see  also  description  of
99              SANE_CONFIG_DIR below).
100
101       /usr/local/lib/sane/libsane-artec_eplus48u.a
102              The static library implementing this backend.
103
104       /usr/local/lib/sane/libsane-artec_eplus48u.so
105              The shared library implementing this backend (present on systems
106              that support dynamic loading).
107

ENVIRONMENT

109       SANE_CONFIG_DIR
110              This environment variable specifies the list of directories that
111              may contain the configuration file.  On *NIX systems, the direc‐
112              tories are separated by a colon (`:'), under OS/2, they are sep‐
113              arated by a semi-colon (`;').  If this variable is not set,  the
114              configuration  file  is  searched  in  two  default directories:
115              first,  the  current  working  directory  (".")  and   then   in
116              /etc/sane.d.  If the value of the environment variable ends with
117              the directory separator character, then the default  directories
118              are searched after the explicitly specified directories. For ex‐
119              ample, setting SANE_CONFIG_DIR to "/tmp/config:" would result in
120              directories  tmp/config,  .,  and /etc/sane.d being searched (in
121              this order).
122
123       SANE_DEBUG_ARTEC_EPLUS48U
124              If the library was compiled with debug support enabled, this en‐
125              vironment  variable  controls  the debug level for this backend.
126              Higher debug levels increase the verbosity of the output.
127
128              Example: export SANE_DEBUG_ARTEC_EPLUS48U=3
129
130

SEE ALSO

132       sane(7), sane-usb(5)
133
134

AUTHOR

136       Michael Herder.
137       This backend is based on the  gt68xx  test-program  written  by  Sergey
138       Vlasov,  Andreas  Nowack,  and  David Stevenson. Thanks to everyone who
139       tested the backend or reported bugs.
140       This man page is based on man sane-gt68xx(5), written by Henning Meier-
141       Geinitz.
142
143

BUGS

145       This  backend  has  been tested on Linux only. If you are using it on a
146       different platform, please contact us.
147
148       Interpolation with 1200 dpi is weak.
149
150       Support for buttons is missing due to missing support in SANE.
151
152       Please      contact      us      if      you      find      a      bug:
153       http://www.sane-project.org/bugs.html.
154
155
156
157                                  11 Jul 2008           sane-artec_eplus48u(5)
Impressum