Thread (16 messages) flat view 16 messages, 4 authors, 2017-08-24
STALE3274d

[PATCH 1/3] Input: Add new property INPUT_PROP_COMPOSITE

From: Roderick Colenbrander <hidden>
Date: 2017-08-18 02:02:09
Subsystem: documentation, input (keyboard, mouse, joystick, touchscreen) drivers, the rest · Maintainers: Jonathan Corbet, Dmitry Torokhov, Linus Torvalds

From: Roderick Colenbrander <roderick.colenbrander@sony.com>

This new property can be set on subdevices part of a composite
input device. The purpose of the constant is to notify other
kernel components (e.g. joydev) and user space that a device is
a composite device.

Signed-off-by: Roderick Colenbrander <roderick.colenbrander@sony.com>
---
 Documentation/input/event-codes.rst    | 12 ++++++++++++
 include/uapi/linux/input-event-codes.h |  1 +
 2 files changed, 13 insertions(+)
diff --git a/Documentation/input/event-codes.rst b/Documentation/input/event-codes.rst
index a8c0873..d56a32e 100644
--- a/Documentation/input/event-codes.rst
+++ b/Documentation/input/event-codes.rst
@@ -356,6 +356,18 @@ can report through the rotational axes (absolute and/or relative rx, ry, rz).
 All other axes retain their meaning. A device must not mix
 regular directional axes and accelerometer axes on the same event node.
 
+INPUT_PROP_COMPOSITE
+--------------------
+
+The functionality of some advanced input devices is exposed through several
+event devices. For example a gamepad with motion sensors could be exposed as
+a gamepad device with axes / buttons and a separate motion sensor device.
+
+The INPUT_PROP_COMPOSITE flag is set on all sub devices making up a larger
+composite device. This flag allows user space applications in addition to
+other kernel drivers (e.g. joydev) to easily determine whether a device
+is part of a composite device.
+
 Guidelines
 ==========
 
diff --git a/include/uapi/linux/input-event-codes.h b/include/uapi/linux/input-event-codes.h
index 1798910..da3fa83 100644
--- a/include/uapi/linux/input-event-codes.h
+++ b/include/uapi/linux/input-event-codes.h
@@ -26,6 +26,7 @@
 #define INPUT_PROP_TOPBUTTONPAD		0x04	/* softbuttons at top of pad */
 #define INPUT_PROP_POINTING_STICK	0x05	/* is a pointing stick */
 #define INPUT_PROP_ACCELEROMETER	0x06	/* has accelerometer */
+#define INPUT_PROP_COMPOSITE		0x07	/* is part of a composite device */
 
 #define INPUT_PROP_MAX			0x1f
 #define INPUT_PROP_CNT			(INPUT_PROP_MAX + 1)
-- 
2.9.4
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help