Debian Codegraph @

upstream/debian-unstable/man5/sane-dc240.5

raw
1 .TH sane\-dc240 5 "11 Jul 2008" "" "SANE Scanner Access Now Easy"
2 .IX sane\-dc240
3 .SH NAME
4 sane\-dc240 \- SANE backend for Kodak DC240 Digital Camera
5 .SH DESCRIPTION
6 The
7 .B sane\-dc240
8 library implements a SANE (Scanner Access Now Easy) backend that
9 provides access to the Kodak DC240 camera. THIS IS EXTREMELY ALPHA
10 CODE! USE AT YOUR OWN RISK!!
11 .SH "DEVICE NAMES"
12 The current version of the backend only allows one camera to be
13 connected. The device name is always "0".
14 .SH CONFIGURATION
15 The contents of the
16 .I dc240.conf
17 specify the serial port and baud rate to use. The
18 .B baud
19 rate specifies the maximum rate to use while downloading pictures. (The
20 camera is always initialized using 9600 baud, then switches to the
21 higher rate). On a 450MHz Pentium, I usually have no problems downloading
22 at 115200 baud, though the camera sometimes has to resend packets due
23 to lost characters. Results are better when
24 the "interrupt-unmask flag" is set in the IDE driver
25 .RI ( "hdparm \-u1" ).
26 Supported baud rates are: 9600, 19200, 38400, 57600, and 115200.
27 .PP
28 The
29 .B dumpinquiry
30 line causes some information about the camera to be printed.
31 .PP
32 .B cmdrespause
33 specifies how many usec (1,000,000ths of a second) to wait between
34 writing the command and reading the result. 125000 seems to be the
35 lowest I could go reliably.
36 .PP
37 .B breakpause
38 specifies how many usec (1,000,000ths of a second) between sending the
39 "back to default" break and sending commands.
40 .PP
41 Empty lines and lines starting with a hash mark (#) are
42 ignored. A sample configuration file is shown below:
43 .PP
44 .RS
45 port=/dev/ttyS0
46 .br
47 # this is a comment
48 .br
49 baud=115200
50 .br
51 dumpinquiry
52 .br
53 cmdrespause=125000
54 .br
55 breakpause=1000000
56 .RE
57 .PP
58 .SH FILES
59 .TP
60 .I /etc/sane.d/dc240.conf
61 The backend configuration file (see also description of
62 .B SANE_CONFIG_DIR
63 below).
64 .TP
65 .I /usr/lib/x86_64-linux-gnu/sane/libsane\-dc240.a
66 The static library implementing this backend.
67 .TP
68 .I /usr/lib/x86_64-linux-gnu/sane/libsane\-dc240.so
69 The shared library implementing this backend (present on systems that
70 support dynamic loading).
71
72 .SH ENVIRONMENT
73 .TP
74 .B SANE_CONFIG_DIR
75 This environment variable specifies the list of directories that may
76 contain the configuration file. On *NIX systems, the directories are
77 separated by a colon (`:'), under OS/2, they are separated by a
78 semi-colon (`;'). If this variable is not set, the configuration file
79 is searched in two default directories: first, the current working
80 directory (".") and then in
81 .I /etc/sane.d.
82 If the value of the
83 environment variable ends with the directory separator character, then
84 the default directories are searched after the explicitly specified
85 directories. For example, setting
86 .B SANE_CONFIG_DIR
87 to "/tmp/config:" would result in directories
88 .IR "tmp/config",
89 .IR ".",
90 and
91 .I "/etc/sane.d"
92 being searched (in this order).
93 .TP
94 .B SANE_DEBUG_DC240
95 If the library was compiled with debugging support enabled, this
96 environment variable controls the debug level for this backend.
97 A value of 128 requests maximally copious debug output; smaller
98 levels reduce verbosity.
99
100 .SH "SEE ALSO"
101 .BR sane (7)
102
103 .SH AUTHOR
104 Peter S. Fales
105
106 .PP
107 This backend borrows heavily from the
108 .BR sane\-dc210 (5)
109 backend by Brian J. Murrell
110 which is based somewhat on the
111 .BR sane\-dc25 (5)
112 backend by Peter Fales.
113 .PP
114 The manpage was largely copied from the
115 .BR sane\-dc210 (5)
116 manpage.
117
118 .SH BUGS
119 The major limitation that I know of is that the backend assumes
120 the directory in the camera is 100dc240. Once the camera has
121 taken more than 9999 pictures, the directory will increment to 101dc240.
122 Not only should we check for the additional directory, but pictures may
123 actually be found in multiple directories.
124 .PP
125 More general comments, suggestions, and inquiries about frontends
126 or SANE should go to the SANE Developers mailing list
127 (see
128 .I http://www.sane\-project.org/mailing\-lists.html
129 for details).
130 You must be subscribed to the list, otherwise your mail won't be
131 sent to the subscribers.