NAME

       sane-dc240 - SANE backend for Kodak DC240 Digital Camera

DESCRIPTION

       The  sane-dc240  library  implements a SANE (Scanner Access Now Easy) backend that provides access to the
       Kodak DC240 camera. THIS IS EXTREMELY ALPHA CODE!  USE AT YOUR OWN RISK!!

DEVICE NAMES

       The current version of the backend only allows one camera to be connected.  The  device  name  is  always
       "0".

CONFIGURATION

       The contents of the dc240.conf specify the serial port and baud rate to use.  The baud rate specifies the
       maximum rate to use while downloading pictures.  (The camera is always initialized using 9600 baud,  then
       switches  to  the  higher  rate).   On a 450MHz Pentium, I usually have no problems downloading at 115200
       baud, though the camera sometimes has to resend packets due to lost characters.  Results are better  when
       the  "interrupt-unmask  flag"  is  set  in  the IDE driver (hdparm -u1).  Supported baud rates are: 9600,
       19200, 38400, 57600, and 115200.

       The dumpinquiry line causes some information about the camera to be printed.

       cmdrespause specifies how many usec (1,000,000ths of a second) to wait between writing  the  command  and
       reading the result. 125000 seems to be the lowest I could go reliably.

       breakpause specifies how many usec (1,000,000ths of a second) between sending the "back to default" break
       and sending commands.

       Empty lines and lines starting with a hash mark (#) are ignored.  A sample configuration  file  is  shown
       below:

              port=/dev/ttyS0
              # this is a comment
              baud=115200
              dumpinquiry
              cmdrespause=125000
              breakpause=1000000

FILES

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

       /usr/lib/x86_64-linux-gnu/sane/libsane-dc240.a
              The static library implementing this backend.

       /usr/lib/x86_64-linux-gnu/sane/libsane-dc240.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.  On *NIX systems, 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  /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 directories.  For example, setting
              SANE_CONFIG_DIR to "/tmp/config:" would result in directories tmp/config, ., and /etc/sane.d being
              searched (in this order).

       SANE_DEBUG_DC240
              If the library was compiled with debugging support enabled, this environment variable controls the
              debug  level  for  this  backend.  A value of 128 requests maximally copious debug output; smaller
              levels reduce verbosity.

SEE ALSO

       sane(7)

AUTHOR

       Peter S. Fales

       This backend borrows heavily from the sane-dc210(5) backend by Brian J. Murrell which is  based  somewhat
       on the sane-dc25(5) backend by Peter Fales.

       The manpage was largely copied from the sane-dc210(5) manpage.

BUGS

       The  major limitation that I know of is that the backend assumes the directory in the camera is 100dc240.
       Once the camera has taken more than 9999 pictures, the directory will increment to  101dc240.   Not  only
       should we check for the additional directory, but pictures may actually be found in multiple directories.

       More  general  comments,  suggestions,  and  inquiries  about  frontends  or  SANE  should go to the SANE
       Developers mailing list (see http://www.sane-project.org/mailing-lists.html for details).   You  must  be
       subscribed to the list, otherwise your mail won't be sent to the subscribers.

                                                   11 Jul 2008                                     sane-dc240(5)