summaryrefslogtreecommitdiffstats
path: root/Documentation/driver-api/miscellaneous.rst
diff options
context:
space:
mode:
authorJonathan Corbet <corbet@lwn.net>2016-08-20 15:17:32 -0400
committerJonathan Corbet <corbet@lwn.net>2016-08-22 16:42:08 -0400
commitdcec3c8c9aea9e779c59f420465381c0f3322913 (patch)
treef8752c216e37a44941af6a16fda595c0fa4dde0d /Documentation/driver-api/miscellaneous.rst
parent47cb398dd75a9faa89d0617b55d4cf537935b731 (diff)
docs: split up the driver book
We don't need to keep it as a single large file anymore; split it up so that it is easier to manage and the individual sections can be read directly as plain files. Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Diffstat (limited to 'Documentation/driver-api/miscellaneous.rst')
-rw-r--r--Documentation/driver-api/miscellaneous.rst50
1 files changed, 50 insertions, 0 deletions
diff --git a/Documentation/driver-api/miscellaneous.rst b/Documentation/driver-api/miscellaneous.rst
new file mode 100644
index 000000000000..8da7d115bafc
--- /dev/null
+++ b/Documentation/driver-api/miscellaneous.rst
@@ -0,0 +1,50 @@
1Parallel Port Devices
2=====================
3
4.. kernel-doc:: include/linux/parport.h
5 :internal:
6
7.. kernel-doc:: drivers/parport/ieee1284.c
8 :export:
9
10.. kernel-doc:: drivers/parport/share.c
11 :export:
12
13.. kernel-doc:: drivers/parport/daisy.c
14 :internal:
15
1616x50 UART Driver
17=================
18
19.. kernel-doc:: drivers/tty/serial/serial_core.c
20 :export:
21
22.. kernel-doc:: drivers/tty/serial/8250/8250_core.c
23 :export:
24
25Pulse-Width Modulation (PWM)
26============================
27
28Pulse-width modulation is a modulation technique primarily used to
29control power supplied to electrical devices.
30
31The PWM framework provides an abstraction for providers and consumers of
32PWM signals. A controller that provides one or more PWM signals is
33registered as :c:type:`struct pwm_chip <pwm_chip>`. Providers
34are expected to embed this structure in a driver-specific structure.
35This structure contains fields that describe a particular chip.
36
37A chip exposes one or more PWM signal sources, each of which exposed as
38a :c:type:`struct pwm_device <pwm_device>`. Operations can be
39performed on PWM devices to control the period, duty cycle, polarity and
40active state of the signal.
41
42Note that PWM devices are exclusive resources: they can always only be
43used by one consumer at a time.
44
45.. kernel-doc:: include/linux/pwm.h
46 :internal:
47
48.. kernel-doc:: drivers/pwm/core.c
49 :export:
50