sane-canon630u.5

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

NAME

       sane-canon630u - SANE backend for the Canon 630u USB flatbed scanner

DESCRIPTION

       The  sane-canon  library  implements  a  SANE (Scanner Access Now Easy)
       backend that provides access to the following Canon flatbed scanners:

              CanoScan 630u
              CanoScan 636u (hopefully)

       IMPORTANT: this is alpha code.  Although there are  no  known  bugs  at
       this  time, this code uses the Linux USB kernel drivers, which are cur-
       rently in active development.  So it may not work, your computer  might
       even  hang, and it cannot be excluded (although I consider it extremely
       unprobable) that your scanner will be damaged.

       That said, TESTERS ARE WELCOME. Send your bug reports and  comments  to
       Nathan Rutman <nathan@gordian.com>

DEVICE NAMES

       This backend expects device names of the form:

              special

       Where  special is the path-name for the special device that corresponds
       to a USB scanner or a symlink to such a device.  The program sane-find-
       scanner  helps  to  find  out  the  correct device. Under Linux, such a
       device name could be /dev/usb/scanner0 for  example.   See  sane-usb(5)
       for details.

CONFIGURATION

       The  contents of the canon630u.conf file is a list of device names that
       correspond to Canon USB scanners.  Empty lines and lines starting  with
       a  hash  mark  (#)  are ignored.  Only one device name can be listed in
       canon630u.conf.

NOTES

       Due to Canon's unwillingness to  provide  scanner  documentation,  this
       software was developed by analyzing the USB traffic of the Windows 2000
       driver.  So things like the calibration procedure I kind of made up; it
       seems to work for my scanner.  If you have complaints, let me know.

       This  driver  requires the ability to send USB Control Messages, avail-
       able in kernel 2.4.12 or later.

       This scanner may not be recognized (yet)  by  the  USB  kernel  driver.
       Check   for   "Driver=usbscanner"   under   /proc/bus/usb/devices.   If
       "Driver=(none)", try forcing it with  "modprobe  scanner  vendor=0x04a9
       product=0x2204"

FILES

       /usr/local/etc/sane.d/canon630u.conf
              The   backend   configuration  file  (see  also  description  of
              SANE_CONFIG_DIR below).

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

       /usr/local/lib/sane/libsane-canon630u.so
              The shared library implementing this backend (present on systems
              that support dynamic loading).

       /tmp/canon.cal
              The  calibration  file used to normalize pixel brightness.  This
              is calculated every time the scanner is first used after it  has
              lost  power.  It can be forced to recalibrate by simply deleting
              this file.

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_CANON630U
              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: SANE_DEBUG_CANON630U=12 scanimage > /dev/null

SEE ALSO

       sane(7), sane-usb(5), sane-find-scanner(1)
       http://canon-fb630u.sourceforge.net/

AUTHOR

       Nathan Rutman

sane-backends 1.0.12-cvs          06 Apr 2002                sane-canon630u(5)