Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
Merge master.kernel.org:/home/rmk/linux-2.6-serial
* master.kernel.org:/home/rmk/linux-2.6-serial:
[SERIAL] Update serial driver documentation
+18
-4
+18
-4
Documentation/serial/driver
+18
-4
Documentation/serial/driver
···
3
3
--------------------
4
4
5
5
6
-
$Id: driver,v 1.10 2002/07/22 15:27:30 rmk Exp $
7
-
8
-
9
6
This document is meant as a brief overview of some aspects of the new serial
10
7
driver. It is not complete, any questions you have should be directed to
11
8
<rmk@arm.linux.org.uk>
12
9
13
-
The reference implementation is contained within serial_amba.c.
10
+
The reference implementation is contained within amba_pl011.c.
14
11
15
12
16
13
···
27
30
The serial core provides a few helper functions. This includes identifing
28
31
the correct port structure (via uart_get_console) and decoding command line
29
32
arguments (uart_parse_options).
33
+
34
+
There is also a helper function (uart_write_console) which performs a
35
+
character by character write, translating newlines to CRLF sequences.
36
+
Driver writers are recommended to use this function rather than implementing
37
+
their own version.
30
38
31
39
32
40
Locking
···
88
86
- TIOCM_DTR DTR signal.
89
87
- TIOCM_OUT1 OUT1 signal.
90
88
- TIOCM_OUT2 OUT2 signal.
89
+
- TIOCM_LOOP Set the port into loopback mode.
91
90
If the appropriate bit is set, the signal should be driven
92
91
active. If the bit is clear, the signal should be driven
93
92
inactive.
···
144
141
enable_ms(port)
145
142
Enable the modem status interrupts.
146
143
144
+
This method may be called multiple times. Modem status
145
+
interrupts should be disabled when the shutdown method is
146
+
called.
147
+
147
148
Locking: port->lock taken.
148
149
Interrupts: locally disabled.
149
150
This call must not sleep
···
167
160
state. Enable the port for reception. It should not activate
168
161
RTS nor DTR; this will be done via a separate call to set_mctrl.
169
162
163
+
This method will only be called when the port is initially opened.
164
+
170
165
Locking: port_sem taken.
171
166
Interrupts: globally disabled.
172
167
···
177
168
effect, and free any interrupt resources. It should not disable
178
169
RTS nor DTR; this will have already been done via a separate
179
170
call to set_mctrl.
171
+
172
+
Drivers must not access port->info once this call has completed.
173
+
174
+
This method will only be called when there are no more users of
175
+
this port.
180
176
181
177
Locking: port_sem taken.
182
178
Interrupts: caller dependent.