diff options
author | Uwe Kleine-König <u.kleine-koenig@pengutronix.de> | 2021-04-06 09:30:36 +0200 |
---|---|---|
committer | Thierry Reding <thierry.reding@gmail.com> | 2021-04-09 14:17:03 +0200 |
commit | 1a7a6e8072ea0e4582de2da63a9088841fde798e (patch) | |
tree | c06c96d6547f620a8733a1134b1c01ab5207bcaf /Documentation/driver-api/pwm.rst | |
parent | 9666cec380d60808eb86d3be4caf84faeebe3081 (diff) | |
download | linux-1a7a6e8072ea0e4582de2da63a9088841fde798e.tar.gz linux-1a7a6e8072ea0e4582de2da63a9088841fde798e.tar.bz2 linux-1a7a6e8072ea0e4582de2da63a9088841fde798e.zip |
pwm: Clarify which state pwm_get_state() returns
Given that lowlevel drivers usually cannot implement exactly what a
consumer requests with pwm_apply_state() there is some rounding
involved.
pwm_get_state() returns the setting that was requested most recently by
the consumer (opposed to what was actually implemented in hardware in
reply to the last request). Clarify this in the function kerneldoc.
Signed-off-by: Uwe Kleine-König <u.kleine-koenig@pengutronix.de>
Signed-off-by: Thierry Reding <thierry.reding@gmail.com>
Diffstat (limited to 'Documentation/driver-api/pwm.rst')
-rw-r--r-- | Documentation/driver-api/pwm.rst | 6 |
1 files changed, 5 insertions, 1 deletions
diff --git a/Documentation/driver-api/pwm.rst b/Documentation/driver-api/pwm.rst index ab62f1bb0366..381f3c46cdac 100644 --- a/Documentation/driver-api/pwm.rst +++ b/Documentation/driver-api/pwm.rst @@ -55,7 +55,11 @@ several parameter at once. For example, if you see pwm_config() and pwm_{enable,disable}() calls in the same function, this probably means you should switch to pwm_apply_state(). -The PWM user API also allows one to query the PWM state with pwm_get_state(). +The PWM user API also allows one to query the last applied PWM state with +pwm_get_last_applied_state(). Note this is different to what the driver has +actually implemented if the request cannot be implemented exactly with the +hardware in use. There is currently no way for consumers to get the actually +implemented settings. In addition to the PWM state, the PWM API also exposes PWM arguments, which are the reference PWM config one should use on this PWM. |