sane-dc240(5)             (11 Jul 2008)             sane-dc240(5)

     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 cam-
          era. 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 bet-
          ter 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 cam-
          era to be printed.

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

          breakpause is the time in 1,000,000ths of a usec between
          sending the "back to default" break 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

     Page 1                       Plan 9             (printed 5/26/22)

     sane-dc240(5)             (11 Jul 2008)             sane-dc240(5)

               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 direc-
               tories 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 /etc/sane.d. If the
               value of the environment variable ends with the direc-
               tory 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 /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 maxi-
               mally copious debug output; smaller levels reduce ver-
               bosity.

     SEE ALSO
          sane(7)

     AUTHOR
          Peter S. Fales

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

          The manpage was largely copied from the dc210 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

     Page 2                       Plan 9             (printed 5/26/22)

     sane-dc240(5)             (11 Jul 2008)             sane-dc240(5)

          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.

     Page 3                       Plan 9             (printed 5/26/22)