sane-canon630u.5

       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 ker-
       nel drivers, which are currently  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 documenta-
       tion,  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  Mes-
       sages, available 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
              The  shared library implementing this backend (pre-
              sent 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
              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_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: export SANE_DEBUG_CANON630U=10

SEE ALSO

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

AUTHOR

       Nathan Rutman

                           06 Apr 2002          sane-canon630u(5)