[PATCH] Extending wayland protocol for helping a wayland client to identify the event source of device (pointer/keyboard)

[박성진]

Dear all,

Let me share a patch for extending wayland protocol for helping a wayland
client to identify which events are coming from which physical
keyboard/pointer device.

I’d like to discuss with you guys about this patch. : )

In this patch, I added “name” event both for wl_pointer and for
wl_keyboard.

 

Under wayland protocol applied this patch, a wayland compositor will send
the name event when a wayland client add a listener for wl_pointer or
wl_keyboard.

Then, the client can store the name of the keyboard or pointer and will use
it when it is required.

 

Usually in desktop environment, we don’t need to care the source device
name of events.

In vehicle, mobile and TV environment, there will be many input devices and
will be many special requirements for them.

 

For instance, in TV, ‘1’ key in an usual keyboard will be used as a
character ‘1’ and will be sent to the focus surface/window.

By the way ‘1’ key in remote control for TV will be used as a action key
and will be sent to channel managing process which doesn’t have any focus
surface/window.

In addition to this example, there can be many examples.

Thus, I share this patch. Any ideas on this ? : )

 

Thanks and regards,

Sung-Jin Park

 

==================================================================

>From ceeb8e2a10dce59a3fda9aca113b64ea97a85746 Mon Sep 17 00:00:00 2001

From: Sung-Jin Park <sj76.park at samsung.com>

Date: Fri, 25 Sep 2015 14:01:57 +0900

Subject: [PATCH] Add name event for wl_pointer and wl_keyboard in wayland

protocol

 

---

protocol/wayland.xml | 38 ++++++++++++++++++++++++++++++++++++--

1 file changed, 36 insertions(+), 2 deletions(-)

 

diff --git a/protocol/wayland.xml b/protocol/wayland.xml

index 42c9309..7e98720 100644

--- a/protocol/wayland.xml

+++ b/protocol/wayland.xml

@@ -1402,7 +1402,7 @@

 

   </interface>

 

-  <interface name="wl_pointer" version="3">

+  <interface name="wl_pointer" version="4">

     <description summary="pointer input device">

       The wl_pointer interface represents one or more input devices,

       such as mice, which control the pointer location and pointer_focus

@@ -1569,9 +1569,26 @@

       </description>

     </request>

 

+    <!-- Version 4 additions -->

+

+    <event name="name">

+      <description summary="unique identifier for each pointer">

+        This can be used by the client to help identify which pointer
events

+        come from which physical pointer device.

+

+        In some cases, a specific client application can acts in different
ways

+        when it gets pointer events from different pointer devices.

+        For instance, a series of motion events coming from a mouse

+        will be used as a cursor mover while the other series of motion
events coming

+        from a pointer device which has a special wheel will be used as a
scroller

+        of list of items.

+      </description>

+      <arg name="name" type="string"/>

+    </event>

+

   </interface>

 

-  <interface name="wl_keyboard" version="4">

+  <interface name="wl_keyboard" version="5">

     <description summary="keyboard input device">

       The wl_keyboard interface represents one or more keyboards

       associated with a seat.

@@ -1683,6 +1700,23 @@

       <arg name="delay" type="int"

            summary="delay in milliseconds since key down until repeating
starts"/>

     </event>

+

+    <!-- Version 5 additions -->

+

+    <event name="name">

+      <description summary="unique identifier for each keyboard">

+        This can be used by the client to help identify which key events

+        come from which physical keyboard device.

+

+        In some cases, a specific client application can acts in different
ways

+        when it gets an identical key from different keyboard devices.

+        For instance, in TV like environment, '1' key coming from a
keyboard

+        will be used as a character. Meanwhile '1' key coming from a remote

+        control key device will be used as a channel switching key.

+      </description>

+      <arg name="name" type="string"/>

+    </event>

+

   </interface>

 

   <interface name="wl_touch" version="3">

--

1.9.1

 

 

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.freedesktop.org/archives/wayland-devel/attachments/20150925/ce0466c1/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: 0001-Add-name-event-for-wl_pointer-and-wl_keyboard-in-way.patch
Type: application/octet-stream
Size: 2841 bytes
Desc: not available
URL: <http://lists.freedesktop.org/archives/wayland-devel/attachments/20150925/ce0466c1/attachment-0001.obj>