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)
between writing the command and reading the result should
be used. 125000 seems to be the lowest I could go reli
ably.
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 descrip
tion of SANE_CONFIG_DIR below).
/usr/lib/sane/libsane-dc240.a
The static library implementing this backend.
The shared library implementing this backend (pre
sent on systems that support dynamic loading).
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 /etc/sane.d. If the value of the
environment variable ends with the directory sepa
rator 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 maximally copious debug output; smaller
levels reduce verbosity.
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 back
end by Peter Fales.
The manpage was largeley 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 multiple directories.
frontends or SANE should go to the SANE Developers mailing
list (see http://www.mostang.com/sane/mail.html for
details). You must be subscribed to the list, otherwise
your mail won't be sent to the subscribers.
Man(1) output converted with
man2html