sane-artec_eplus48u.5



sane-artec_eplus48u(5)               SANE               sane-artec_eplus48u(5)


NAME

       sane-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 scan-
       ners

       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 ProductID 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 scan-
       ners, 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 sending  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  general  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 contain-
       ing  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 installation CD that was provided by the manufacturer, nor-
       mally 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 correspond 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 exposure  time.  You
              can  e.g. change them to speed up calibration, if you don't want
              to save the calibration 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   description   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 (present 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 config-
              uration 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 specified directo-
              ries.   For  example,  setting SANE_CONFIG_DIR to "/tmp/config:"
              would   result   in   directories   "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 ALSO

       sane(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 Henning 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: <crapsite@gmx.net>

sane-backends 1.0.16              19 Nov 2002           sane-artec_eplus48u(5)

Man(1) output converted with man2html