sane-u12(5)

1sane-u12(5)              SANE Scanner Access Now Easy              sane-u12(5)
2
3
4

NAME

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

DESCRIPTION

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

SUPPORTED DEVICES

17       The  backend  is  able  to support some early Plustek USB scanners that
18       based their old parport design around the ASIC 98003 and other rebadged
19       Plustek devices. The following tables will give you a short overview.
20
21       If  your Plustek scanner has another Product ID, then the device is NOT
22       supported by this backend.
23
24       Vendor Plustek - ID: 0x07B3
25       ----------------------------------------------------------
26       Model:                   Vendor-ID:       Product-ID:
27       ----------------------------------------------------------
28       OpticPro U12             0x07B3           0x0001
29       OpticPro U1212           0x07B3           0x0001
30       OpticPro UT12            0x07B3           0x0001
31
32       Vendor KYE/Genius
33       --------------------------------------------------------
34       USB Model:               Vendor-ID:       Product-ID:
35       --------------------------------------------------------
36       ColorPage Vivid III USB  0x07B3           0x0001
37       ColorPage HR6 V1         0x0458           0x2004
38

CONFIGURATION

40       To use your scanner with this backend, you need at least two entries in
41       the configuration file /etc/sane.d/u12.conf
42
43              [usb] vendor-id product-id
44              device /dev/usbscanner
45
46       [usb]  tells the backend, that the following devicename (here /dev/usb‐
47       scanner) has to be interpreted as USB scanner device.  If  vendor-  and
48       product-id  has not been specified, the backend tries to detect this by
49       its own. If device is set to auto then  the  next  matching  device  is
50       used.
51
52       The Options:
53
54       option warmup t
55              t specifies the warmup period in seconds
56
57       option lampOff t
58              t  is the time in seconds for switching off the lamps in standby
59              mode
60
61       option lOffonEnd b
62              b specifies the behaviour when closing the backend, 1 --> switch
63              lamps off, 0 --> do not change lamp status
64
65
66       See the u12.conf file for examples.
67
68       Note: You have to make sure, that the USB subsystem is loaded correctly
69       and  you  have  access  to  the  device-node.  For  more  details   see
70       sane-usb(5)  manpage.  You might use sane-find-scanner(1) to check that
71       you have access to your device.
72
73       Note:
74       If there's no configuration file, the backend defaults to device auto
75
76

FILES

78       /etc/sane.d/u12.conf
79              The backend configuration file
80
81       /usr/lib64/sane/libsane-u12.a
82              The static library implementing this backend.
83
84       /usr/lib64/sane/libsane-u12.so
85              The shared library implementing this backend (present on systems
86              that support dynamic loading).
87
88

ENVIRONMENT

90       SANE_CONFIG_DIR
91              This environment variable specifies the list of directories that
92              may contain the configuration file.  Under UNIX, the directories
93              are  separated  by a colon (`:'), under OS/2, they are separated
94              by a semi-colon (`;').  If this variable is not set, the config‐
95              uration  file is searched in two default directories: first, the
96              current working directory (".") and then in /etc/sane.d.  If the
97              value  of the environment variable ends with the directory sepa‐
98              rator character, then the default directories are searched after
99              the  explicitly  specified  directories.   For  example, setting
100              SANE_CONFIG_DIR to "/tmp/config:" would  result  in  directories
101              tmp/config, ., and /etc/sane.d being searched (in this order).
102
103       SANE_DEBUG_U12
104              If  the  library  was  compiled with debug support enabled, this
105              environment variable controls the debug level for this  backend.
106              Higher debug levels increase the verbosity of the output.
107
108              Example: export SANE_DEBUG_U12=10
109
110

CONTACT AND BUG-REPORTS

118       Please send any information and bug-reports to:
119       SANE Mailing List
120
121       Additional info and hints can be obtained from our
122       Mailing-List archive at:
123       http://www.sane-project.org/mailing-lists.html
124
125       To obtain debug messages from the backend, please set the  environment-
126       variable  SANE_DEBUG_U12  before  calling  your  favorite scan-frontend
127       (i.e.  xscanimage(1)), i.e.:
128
129       export SANE_DEBUG_U12=20 ; xscanimage
130
131       The value controls the verbosity of the backend.
132
133

KNOWN BUGS & RESTRICTIONS

135       * The driver is in alpha state, so please don't expect too much!!!
136
137       * When using libusb, it might be, that  the  backend  hangs.   In  that
138       case, reconnect the scanner.
139
140
141
142                                  14 Jul 2008                      sane-u12(5)