sane-artec_eplus48u(5) SANE sane-artec_eplus48u(5)NAMEsane-artec_eplus48u - SANE backend for the scanner Artec
E+ 48U and re-badged models
DESCRIPTION
The sane-artec_eplus48u library implements a SANE (Scanner
Access Now Easy) backend that at present provides access
to the USB flatbed scanners
Artec E+ 48U,
Tevion MD 9693,
Medion MD 9693,
Medion MD 9705 and
Trust Easy Webscan 19200.
These scanners have a contact image sensor (CIS) and an
USB interface.
VendorID: 0x05d8
ProductID: 0x4003
The Trust Easy Webscan 19200 is an exception. It's Pro-
ductID is 0x4006 .
More details can be found on
http://www.angelfire.com/linux/crapsite/.
This is ALPHA software. Especially if you test new or
untested scanners, keep your hand at the scanner's plug
and unplug it, if the head bumps at the end of the scan
area.
If you own a scanner other than the ones listed above that
works with this backend, please let me know this by send-
ing the scanner's exact model name and the USB vendor and
product ids (e.g. from /proc/bus/usb/devices, sane-find-
scanner or syslog) to me. Even if the scanner's name is
only slightly different from the models mentioned above,
please let me know.
KERNEL ISSUES
If libusb-0.1.6 or later is installed, this section can be
skipped. The scanner should be found by sane-find-scanner
without further actions. For setting permissions and gen-
eral USB information look at sane-usb(5).
When you are using the scanner module, a Linux kernel
2.4.12 or newer is required.
FIRMWARE FILE
You need a firmware file for your scanner. That's a small
file containing software that will be uploaded to the
scanner's memory. For the scanners mentioned above, it's
usually named Artec48.usb. You can find it on the instal-
lation CD that was provided by the manufacturer, normally
in the directory Win98, WinMe or similar. If the Windows-
driver is installed on your computer, then you can also
find the firmware file under c:\windows\system32\drivers.
CONFIGURATION
The contents of the artec_eplus48u.conf file is a list of
usb lines containing vendor and product ids that corre-
spond to USB scanners. The file can also contain option
lines. Empty lines and lines starting with a hash mark
(#) are ignored. The scanners are autodetected by usb
vendor_id product_id statements which are already included
into artec_eplus48u.conf . "vendor_id" and "product_id"
are hexadecimal numbers that identify the scanner.
Every usb section can have additional options
artecFirmwareFile <path>/Artec48.usb
The path to the firmware file. This option is
required.
redGamma 1.0
greenGamma 1.0
blueGamma 1.0
masterGamma 1.9
These are the default gamma values. If you set the
"Defaults" option with a frontend, then the gamma
options are reset to the values specified here.
redOffset 0x28
greenOffset 0x2f
blueOffset 0x2f
redExposure 0xa7
greenExposure 0x116
blueExposure 0xdc
These are the default values for offset and expo-
sure time. You can e.g. change them to speed up
calibration, if you don't want to save the calibra-
tion data to disk.
vendorString Artec
modelString E+ 48U
By default, the scanner is reported as "Artec E+
48U". If you don't like this, e.g. because you
have an Tevion MD 9693, then change the options
accordingly.
FILES
/usr/local/etc/sane.d/artec_eplus48u.conf
The backend configuration file (see also descrip-
tion of SANE_CONFIG_DIR below).
/usr/local/lib/sane/libsane-artec_eplus48u.a
The static library implementing this backend.
/usr/local/lib/sane/libsane-artec_eplus48u.so
The shared library implementing this backend (pre-
sent on systems that support dynamic loading).
ENVIRONMENT
SANE_CONFIG_DIR
This environment variable specifies the list of
directories that may contain the configuration
file. Under UNIX, the directories are separated by
a colon (`:'), under OS/2, they are separated by a
semi-colon (`;'). If this variable is not set, the
configuration file is searched in two default
directories: first, the current working directory
(".") and then in /usr/local/etc/sane.d. If the
value of the environment variable ends with the
directory separator character, then the default
directories are searched after the explicitly spec-
ified directories. For example, setting SANE_CON-
FIG_DIR to "/tmp/config:" would result in directo-
ries "tmp/config", ".", and "/usr/local/etc/sane.d"
being searched (in this order).
SANE_DEBUG_ARTEC_EPLUS48U
If the library was compiled with debug support
enabled, this environment variable controls the
debug level for this backend. Higher debug levels
increase the verbosity of the output.
Example: export SANE_DEBUG_ARTEC_EPLUS48U=3
SEE ALSOsane(7), sane-usb(5)AUTHOR
Michael Herder <crapsite@gmx.net>
This backend is based on the gt68xx test-program written
by Sergey Vlasov, Andreas Nowack, and David Stevenson.
Thanks to everyone who tested the backend or reported
bugs.
This man page is based on man sane-gt68xx, written by Hen-
ning Meier-Geinitz.
BUGS
This backend has been tested on Linux only. If you are
using it on a different platform, please contact me.
Interpolation with 1200 dpi is weak.
Support for buttons is missing due to missing support in
SANE.
More detailed bug information is available at
http://www.angelfire.com/linux/crapsite. Please contact
me if you find a bug or missing feature: <crap-
site@gmx.net>
sane-backends 1.0.12 19 Nov 2002 sane-artec_eplus48u(5)