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
12       using the GT6816 chipset like the Artec E+ 48U.  These scanners have  a
13       contact image sensor (CIS) and an USB interface.
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 or syslog) to me. Even if the
26       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 without  further  actions.
32       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:\windows\system32\drivers.
47

CONFIGURATION

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

FILES

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

ENVIRONMENT

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

SEE ALSO

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

AUTHOR

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

BUGS

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