summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBrendan Connelly <brendanjconnelly17@gmail.com>2025-02-08 12:35:54 -0500
committerJonathan Corbet <corbet@lwn.net>2025-02-21 13:29:53 -0700
commit76a6782284dff53a08b688fdead3e46f22236e71 (patch)
tree6694e3d99af3ddf8f1a9af79239d6481a4c197ed
parent4dd4eef60f8e21db2f1489cbbcba343283212823 (diff)
Documentation: input: Add section pertaining to polled input devices
Added section in Documentation/input/input-programming.rst about input_setup_polling() and input_set_poll_interval() Signed-off-by: Brendan Connelly <brendanjconnelly17@gmail.com> Signed-off-by: Jonathan Corbet <corbet@lwn.net> Link: https://lore.kernel.org/r/20250208173554.209688-1-brendanjconnelly17@gmail.com
-rw-r--r--Documentation/input/input-programming.rst19
1 files changed, 19 insertions, 0 deletions
diff --git a/Documentation/input/input-programming.rst b/Documentation/input/input-programming.rst
index c9264814c7aa..2b3e6a34e34b 100644
--- a/Documentation/input/input-programming.rst
+++ b/Documentation/input/input-programming.rst
@@ -346,3 +346,22 @@ driver can handle these events, it has to set the respective bits in evbit,
This callback routine can be called from an interrupt or a BH (although that
isn't a rule), and thus must not sleep, and must not take too long to finish.
+
+Polled input devices
+~~~~~~~~~~~~~~~~~~~~
+
+Input polling is set up by passing an input device struct and a callback to
+the function::
+
+ int input_setup_polling(struct input_dev *dev,
+ void (*poll_fn)(struct input_dev *dev))
+
+Within the callback, devices should use the regular input_report_* functions
+and input_sync as is used by other devices.
+
+There is also the function::
+
+ void input_set_poll_interval(struct input_dev *dev, unsigned int interval)
+
+which is used to configure the interval, in milliseconds, that the device will
+be polled at.