sane-u12.5

sane-u12(5)              SANE Scanner Access Now Easy              sane-u12(5)

NAME

       sane-u12  -  SANE  backend  for  Plustek USB flatbed scanners, based on
       older parport designs

DESCRIPTION

       The sane-u12 library implements a SANE (Scanner Access Now Easy)  back-
       end  that  provides  access  to USB flatbed scanners based on Plusteks'
       ASIC 98003 (parallel-port  ASIC)  and  a  GeneSys  Logics'  USB-parport
       bridge chip.

SUPPORTED DEVICES

       The  backend  is  able  to support some early Plustek USB scanner based
       their old parport design around the ASIC 98003 and other rebadged Plus-
       tek devices. The following tables will give you a short overview.

       If  your Plustek scanner has another Product ID, then the device is NOT
       supported by this backend.

       Vendor Plustek - ID: 0x07B3
       ----------------------------------------------------------
       Model:                   Vendor-ID:       Product-ID:
       ----------------------------------------------------------
       OpticPro U12             0x07B3           0x0001
       OpticPro U1212           0x07B3           0x0001
       OpticPro UT12            0x07B3           0x0001

       Vendor KYE/Genius
       --------------------------------------------------------
       USB Model:               Vendor-ID:       Product-ID:
       --------------------------------------------------------
       ColorPage Vivid III USB  0x07B3           0x0001
       ColorPage HR6 V1         0x0458           0x2004

CONFIGURATION

       To use your scanner with this backend, you need at least two entries in
       the configuration file
       /usr/local/etc/sane.d/u12.conf

       [usb] vendor-id product-id

       device /dev/usbscanner

       [usb]  tells the backend, that the following devicename (here /dev/usb-
       scanner ) has to be interpreted as USB scanner device. If  vendor-  and
       product-id  has not been specified, the backend tries to detect this by
       its own. If device ist set to auto then the  next  matching  device  is
       used.

       The Options:

       option warmup t
              t specifies the warmup period in seconds

       option lampOff t
              t  is the time in seconds for switching off the lamps in standby
              mode

       option lOffonEnd b
              b specifies the behaviour when closing the backend, 1 --> switch
              lamps off, 0 --> do not change lamp status

       See the u12.conf file for examples.

       Note:
       You  have  to make sure, that the USB subsystem is loaded correctly and
       you have access to the device-node. For more details see  sane-usb  (5)
       manpage.  You might use sane-find-scanner to check that you have access
       to your device.

       Note:
       If there's no configuration file, the backend defaults to device auto

FILES

       /usr/local/etc/sane.d/u12.conf
              The backend configuration file

       /usr/local/lib/sane/libsane-u12.a
              The static library implementing this backend.

       /usr/local/lib/sane/libsane-u12.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_U12
              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_U12=10

SEE ALSO

       sane(7), sane-usb(5), sane-plustek(5),
       /usr/local/doc/sane-1.0.16/u12/U12.changes
       http://www.gjaeger.de/scanner/u12/

CONTACT AND BUG-REPORTS

       Please send any information and bug-reports to:
       SANE Mailing List

       Additional info and hints can be obtained from our
       Mailing-List archive at:
       http://www.sane-project.org/mailing-lists.html

       or directly from the projects' homepage at:
       http://www.gjaeger.de/scanner/u12/

       To obtain debug messages from the backend, please set the  environment-
       variable  SANE_DEBUG_U12  before  calling  your  favorite scan-frontend
       (i.e. xscanimage).
       i.e.: export SANE_DEBUG_U12=20 ; xscanimage

       The value controls the verbosity of the backend.

KNOWN BUGS & RESTRICTIONS

       * The driver is in alpha state, so please don't expect too much!!!

       * When using libusb, it might be, that  the  backend  hangs.   In  that
       case, reconnect the scanner.

sane-backends 1.0.16             18 June 2004                      sane-u12(5)