diff options
author | Thierry Reding <thierry.reding@gmail.com> | 2015-07-27 12:00:23 +0200 |
---|---|---|
committer | Thierry Reding <thierry.reding@gmail.com> | 2015-08-17 15:40:21 +0200 |
commit | 6e146f5c41da7e9601fe92fb4d06b45431dbf95b (patch) | |
tree | ccc094c4277c29c8b8bb6238fa4356ea66c40d7d | |
parent | 048838027667872a75d3af40c51a22088bafd968 (diff) | |
download | op-kernel-dev-6e146f5c41da7e9601fe92fb4d06b45431dbf95b.zip op-kernel-dev-6e146f5c41da7e9601fe92fb4d06b45431dbf95b.tar.gz |
pwm: Add to device-drivers documentation
Add a short introductory text along with API documentation generated
from kerneldoc comments for the PWM framework.
Signed-off-by: Thierry Reding <thierry.reding@gmail.com>
-rw-r--r-- | Documentation/DocBook/device-drivers.tmpl | 27 |
1 files changed, 27 insertions, 0 deletions
diff --git a/Documentation/DocBook/device-drivers.tmpl b/Documentation/DocBook/device-drivers.tmpl index faf09d4..172bff8 100644 --- a/Documentation/DocBook/device-drivers.tmpl +++ b/Documentation/DocBook/device-drivers.tmpl @@ -455,4 +455,31 @@ X!Ilib/fonts/fonts.c !Edrivers/hsi/hsi.c </chapter> + <chapter id="pwm"> + <title>Pulse-Width Modulation (PWM)</title> + <para> + Pulse-width modulation is a modulation technique primarily used to + control power supplied to electrical devices. + </para> + <para> + The PWM framework provides an abstraction for providers and consumers + of PWM signals. A controller that provides one or more PWM signals is + registered as <structname>struct pwm_chip</structname>. Providers are + expected to embed this structure in a driver-specific structure. This + structure contains fields that describe a particular chip. + </para> + <para> + A chip exposes one or more PWM signal sources, each of which exposed + as a <structname>struct pwm_device</structname>. Operations can be + performed on PWM devices to control the period, duty cycle, polarity + and active state of the signal. + </para> + <para> + Note that PWM devices are exclusive resources: they can always only be + used by one consumer at a time. + </para> +!Iinclude/linux/pwm.h +!Edrivers/pwm/core.c + </chapter> + </book> |