diff mbox

[1/2] HID: Add mapping for Microsoft Win8 Wireless Radio Controls extensions

Message ID 20170510151253.30324-1-hdegoede@redhat.com (mailing list archive)
State New, archived
Headers show

Commit Message

Hans de Goede May 10, 2017, 3:12 p.m. UTC
Microsoft has defined some extra HUT codes for the Generic Desktop Page
for Wireless Radio controls, see:

https://docs.microsoft.com/en-us/windows-hardware/drivers/hid/airplane-mode-radio-management
https://web.archive.org/web/20170509144631/https://docs.microsoft.com/en-us/windows-hardware/drivers/hid/airplane-mode-radio-management

I've 3 2-in-1 keyboard docks: Dell Venue Pro 11 keyboard dock,
HP pavilion x2 keyboard dock and a PEAQ C1010 keyboard dock which have
a wireless radio toggle hotkey, which uses the 0x000100c6 HUT code
defined in these extensions.

This commit adds a mapping for this key, this makes the rfkill toggle
hotkey work on the Dell Venue Pro 11 and HP Pavilion X2 keyboards,
the PEAQ C1010 keyboard does generate events for the 0x000100c6 HUT
code when pressed, but the reported value is always 0.

Signed-off-by: Hans de Goede <hdegoede@redhat.com>
---
 drivers/hid/hid-input.c |  9 +++++++++
 include/linux/hid.h     | 10 ++++++++++
 2 files changed, 19 insertions(+)

Comments

Benjamin Tissoires May 10, 2017, 3:41 p.m. UTC | #1
On May 10 2017 or thereabouts, Hans de Goede wrote:
> Microsoft has defined some extra HUT codes for the Generic Desktop Page
> for Wireless Radio controls, see:
> 
> https://docs.microsoft.com/en-us/windows-hardware/drivers/hid/airplane-mode-radio-management
> https://web.archive.org/web/20170509144631/https://docs.microsoft.com/en-us/windows-hardware/drivers/hid/airplane-mode-radio-management
> 
> I've 3 2-in-1 keyboard docks: Dell Venue Pro 11 keyboard dock,
> HP pavilion x2 keyboard dock and a PEAQ C1010 keyboard dock which have
> a wireless radio toggle hotkey, which uses the 0x000100c6 HUT code
> defined in these extensions.
> 
> This commit adds a mapping for this key, this makes the rfkill toggle
> hotkey work on the Dell Venue Pro 11 and HP Pavilion X2 keyboards,
> the PEAQ C1010 keyboard does generate events for the 0x000100c6 HUT
> code when pressed, but the reported value is always 0.
> 
> Signed-off-by: Hans de Goede <hdegoede@redhat.com>
> ---
>  drivers/hid/hid-input.c |  9 +++++++++
>  include/linux/hid.h     | 10 ++++++++++
>  2 files changed, 19 insertions(+)
> 
> diff --git a/drivers/hid/hid-input.c b/drivers/hid/hid-input.c
> index d05f903c7614..79aa2f7d0482 100644
> --- a/drivers/hid/hid-input.c
> +++ b/drivers/hid/hid-input.c
> @@ -656,6 +656,15 @@ static void hidinput_configure_usage(struct hid_input *hidinput, struct hid_fiel
>  		case HID_GD_START:	map_key_clear(BTN_START);	break;
>  		case HID_GD_SELECT:	map_key_clear(BTN_SELECT);	break;
>  
> +		case HID_GD_RFKILL_BTN:
> +			/* MS wireless radio ctl extension, also check CA */
> +			if (field->application == 0x0001000c) {

Nitpicking, but you should probably use HID_GD_WIRELESS_RADIO_CTLS
instead of the constant.

> +				map_key_clear(KEY_RFKILL);
> +				/* We need to simulate the btn release */
> +				field->flags |= HID_MAIN_ITEM_RELATIVE;
> +				break;
> +			}
> +
>  		default: goto unknown;
>  		}
>  
> diff --git a/include/linux/hid.h b/include/linux/hid.h
> index 28f38e2b8f30..8a259c6ea8a1 100644
> --- a/include/linux/hid.h
> +++ b/include/linux/hid.h
> @@ -182,6 +182,12 @@ struct hid_item {
>  #define HID_GD_KEYBOARD		0x00010006
>  #define HID_GD_KEYPAD		0x00010007
>  #define HID_GD_MULTIAXIS	0x00010008
> +/*
> + * Microsoft Win8 Wireless Radio Controls extensions CA, see (checked 09052017):
> + * https://docs.microsoft.com/en-us/windows-hardware/drivers/hid/airplane-mode-radio-management
> + * https://web.archive.org/web/20170509144631/https://docs.microsoft.com/en-us/windows-hardware/drivers/hid/airplane-mode-radio-management

Better linking the HUT directly:
http://www.usb.org/developers/hidpage/HUTRR40RadioHIDUsagesFinal.pdf

We probably just need the full link in the commit message, and here only
a reference to HUTRR40.

> + */
> +#define HID_GD_WIRELESS_RADIO_CTLS	0x0001000c
>  #define HID_GD_X		0x00010030
>  #define HID_GD_Y		0x00010031
>  #define HID_GD_Z		0x00010032
> @@ -210,6 +216,10 @@ struct hid_item {
>  #define HID_GD_DOWN		0x00010091
>  #define HID_GD_RIGHT		0x00010092
>  #define HID_GD_LEFT		0x00010093
> +/* Microsoft Win8 Wireless Radio Controls CA usage codes */
> +#define HID_GD_RFKILL_BTN	0x000100c6
> +#define HID_GD_RFKILL_LED	0x000100c7
> +#define HID_GD_RFKILL_SWITCH	0x000100c8

In the HID usage table extension, they are called "Wireless Radio *".
I wonder if we should have a closer name.

Cheers,
Benjamin

>  
>  #define HID_DC_BATTERYSTRENGTH	0x00060020
>  
> -- 
> 2.12.2
> 
--
To unsubscribe from this list: send the line "unsubscribe linux-input" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Hans de Goede May 10, 2017, 4:19 p.m. UTC | #2
Hi,

On 10-05-17 17:41, Benjamin Tissoires wrote:
> On May 10 2017 or thereabouts, Hans de Goede wrote:
>> Microsoft has defined some extra HUT codes for the Generic Desktop Page
>> for Wireless Radio controls, see:
>>
>> https://docs.microsoft.com/en-us/windows-hardware/drivers/hid/airplane-mode-radio-management
>> https://web.archive.org/web/20170509144631/https://docs.microsoft.com/en-us/windows-hardware/drivers/hid/airplane-mode-radio-management
>>
>> I've 3 2-in-1 keyboard docks: Dell Venue Pro 11 keyboard dock,
>> HP pavilion x2 keyboard dock and a PEAQ C1010 keyboard dock which have
>> a wireless radio toggle hotkey, which uses the 0x000100c6 HUT code
>> defined in these extensions.
>>
>> This commit adds a mapping for this key, this makes the rfkill toggle
>> hotkey work on the Dell Venue Pro 11 and HP Pavilion X2 keyboards,
>> the PEAQ C1010 keyboard does generate events for the 0x000100c6 HUT
>> code when pressed, but the reported value is always 0.
>>
>> Signed-off-by: Hans de Goede <hdegoede@redhat.com>
>> ---
>>   drivers/hid/hid-input.c |  9 +++++++++
>>   include/linux/hid.h     | 10 ++++++++++
>>   2 files changed, 19 insertions(+)
>>
>> diff --git a/drivers/hid/hid-input.c b/drivers/hid/hid-input.c
>> index d05f903c7614..79aa2f7d0482 100644
>> --- a/drivers/hid/hid-input.c
>> +++ b/drivers/hid/hid-input.c
>> @@ -656,6 +656,15 @@ static void hidinput_configure_usage(struct hid_input *hidinput, struct hid_fiel
>>   		case HID_GD_START:	map_key_clear(BTN_START);	break;
>>   		case HID_GD_SELECT:	map_key_clear(BTN_SELECT);	break;
>>   
>> +		case HID_GD_RFKILL_BTN:
>> +			/* MS wireless radio ctl extension, also check CA */
>> +			if (field->application == 0x0001000c) {
> 
> Nitpicking, but you should probably use HID_GD_WIRELESS_RADIO_CTLS
> instead of the constant.

Yeah that is actually why I defined it in the first place, my bad.
> 
>> +				map_key_clear(KEY_RFKILL);
>> +				/* We need to simulate the btn release */
>> +				field->flags |= HID_MAIN_ITEM_RELATIVE;
>> +				break;
>> +			}
>> +
>>   		default: goto unknown;
>>   		}
>>   
>> diff --git a/include/linux/hid.h b/include/linux/hid.h
>> index 28f38e2b8f30..8a259c6ea8a1 100644
>> --- a/include/linux/hid.h
>> +++ b/include/linux/hid.h
>> @@ -182,6 +182,12 @@ struct hid_item {
>>   #define HID_GD_KEYBOARD		0x00010006
>>   #define HID_GD_KEYPAD		0x00010007
>>   #define HID_GD_MULTIAXIS	0x00010008
>> +/*
>> + * Microsoft Win8 Wireless Radio Controls extensions CA, see (checked 09052017):
>> + * https://docs.microsoft.com/en-us/windows-hardware/drivers/hid/airplane-mode-radio-management
>> + * https://web.archive.org/web/20170509144631/https://docs.microsoft.com/en-us/windows-hardware/drivers/hid/airplane-mode-radio-management
> 
> Better linking the HUT directly:
> http://www.usb.org/developers/hidpage/HUTRR40RadioHIDUsagesFinal.pdf
> 
> We probably just need the full link in the commit message, and here only
> a reference to HUTRR40.

Ah I did not know about that version, I added the web.archive.org version
because using URLs usually is a bad idea because they tend to go stale.

I will do as you suggested and send a v2 tomorrow.

>> + */
>> +#define HID_GD_WIRELESS_RADIO_CTLS	0x0001000c
>>   #define HID_GD_X		0x00010030
>>   #define HID_GD_Y		0x00010031
>>   #define HID_GD_Z		0x00010032
>> @@ -210,6 +216,10 @@ struct hid_item {
>>   #define HID_GD_DOWN		0x00010091
>>   #define HID_GD_RIGHT		0x00010092
>>   #define HID_GD_LEFT		0x00010093
>> +/* Microsoft Win8 Wireless Radio Controls CA usage codes */
>> +#define HID_GD_RFKILL_BTN	0x000100c6
>> +#define HID_GD_RFKILL_LED	0x000100c7
>> +#define HID_GD_RFKILL_SWITCH	0x000100c8
> 
> In the HID usage table extension, they are called "Wireless Radio *".
> I wonder if we should have a closer name.

Then we would end up with HID_GD_WIRELESS_RADIO_* ?
Which is a bit long, RFKILL is linux-speak for this,
and nice and short, but if you prefer the long version
let me know and I'll change it for v2.

Regards,

Hans

--
To unsubscribe from this list: send the line "unsubscribe linux-input" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Benjamin Tissoires May 10, 2017, 6:38 p.m. UTC | #3
On May 10 2017 or thereabouts, Hans de Goede wrote:
> Hi,
> 
> On 10-05-17 17:41, Benjamin Tissoires wrote:
> > On May 10 2017 or thereabouts, Hans de Goede wrote:
> > > Microsoft has defined some extra HUT codes for the Generic Desktop Page
> > > for Wireless Radio controls, see:
> > > 
> > > https://docs.microsoft.com/en-us/windows-hardware/drivers/hid/airplane-mode-radio-management
> > > https://web.archive.org/web/20170509144631/https://docs.microsoft.com/en-us/windows-hardware/drivers/hid/airplane-mode-radio-management
> > > 
> > > I've 3 2-in-1 keyboard docks: Dell Venue Pro 11 keyboard dock,
> > > HP pavilion x2 keyboard dock and a PEAQ C1010 keyboard dock which have
> > > a wireless radio toggle hotkey, which uses the 0x000100c6 HUT code
> > > defined in these extensions.
> > > 
> > > This commit adds a mapping for this key, this makes the rfkill toggle
> > > hotkey work on the Dell Venue Pro 11 and HP Pavilion X2 keyboards,
> > > the PEAQ C1010 keyboard does generate events for the 0x000100c6 HUT
> > > code when pressed, but the reported value is always 0.
> > > 
> > > Signed-off-by: Hans de Goede <hdegoede@redhat.com>
> > > ---
> > >   drivers/hid/hid-input.c |  9 +++++++++
> > >   include/linux/hid.h     | 10 ++++++++++
> > >   2 files changed, 19 insertions(+)
> > > 
> > > diff --git a/drivers/hid/hid-input.c b/drivers/hid/hid-input.c
> > > index d05f903c7614..79aa2f7d0482 100644
> > > --- a/drivers/hid/hid-input.c
> > > +++ b/drivers/hid/hid-input.c
> > > @@ -656,6 +656,15 @@ static void hidinput_configure_usage(struct hid_input *hidinput, struct hid_fiel
> > >   		case HID_GD_START:	map_key_clear(BTN_START);	break;
> > >   		case HID_GD_SELECT:	map_key_clear(BTN_SELECT);	break;
> > > +		case HID_GD_RFKILL_BTN:
> > > +			/* MS wireless radio ctl extension, also check CA */
> > > +			if (field->application == 0x0001000c) {
> > 
> > Nitpicking, but you should probably use HID_GD_WIRELESS_RADIO_CTLS
> > instead of the constant.
> 
> Yeah that is actually why I defined it in the first place, my bad.
> > 
> > > +				map_key_clear(KEY_RFKILL);
> > > +				/* We need to simulate the btn release */
> > > +				field->flags |= HID_MAIN_ITEM_RELATIVE;
> > > +				break;
> > > +			}
> > > +
> > >   		default: goto unknown;
> > >   		}
> > > diff --git a/include/linux/hid.h b/include/linux/hid.h
> > > index 28f38e2b8f30..8a259c6ea8a1 100644
> > > --- a/include/linux/hid.h
> > > +++ b/include/linux/hid.h
> > > @@ -182,6 +182,12 @@ struct hid_item {
> > >   #define HID_GD_KEYBOARD		0x00010006
> > >   #define HID_GD_KEYPAD		0x00010007
> > >   #define HID_GD_MULTIAXIS	0x00010008
> > > +/*
> > > + * Microsoft Win8 Wireless Radio Controls extensions CA, see (checked 09052017):
> > > + * https://docs.microsoft.com/en-us/windows-hardware/drivers/hid/airplane-mode-radio-management
> > > + * https://web.archive.org/web/20170509144631/https://docs.microsoft.com/en-us/windows-hardware/drivers/hid/airplane-mode-radio-management
> > 
> > Better linking the HUT directly:
> > http://www.usb.org/developers/hidpage/HUTRR40RadioHIDUsagesFinal.pdf
> > 
> > We probably just need the full link in the commit message, and here only
> > a reference to HUTRR40.
> 
> Ah I did not know about that version, I added the web.archive.org version
> because using URLs usually is a bad idea because they tend to go stale.
> 
> I will do as you suggested and send a v2 tomorrow.
> 
> > > + */
> > > +#define HID_GD_WIRELESS_RADIO_CTLS	0x0001000c
> > >   #define HID_GD_X		0x00010030
> > >   #define HID_GD_Y		0x00010031
> > >   #define HID_GD_Z		0x00010032
> > > @@ -210,6 +216,10 @@ struct hid_item {
> > >   #define HID_GD_DOWN		0x00010091
> > >   #define HID_GD_RIGHT		0x00010092
> > >   #define HID_GD_LEFT		0x00010093
> > > +/* Microsoft Win8 Wireless Radio Controls CA usage codes */
> > > +#define HID_GD_RFKILL_BTN	0x000100c6
> > > +#define HID_GD_RFKILL_LED	0x000100c7
> > > +#define HID_GD_RFKILL_SWITCH	0x000100c8
> > 
> > In the HID usage table extension, they are called "Wireless Radio *".
> > I wonder if we should have a closer name.
> 
> Then we would end up with HID_GD_WIRELESS_RADIO_* ?
> Which is a bit long, RFKILL is linux-speak for this,
> and nice and short, but if you prefer the long version
> let me know and I'll change it for v2.

Nah, no worries. Just that I am not a big fan of the RFKILL either, but
it's shorter than the "official" name in the HUT.

Cheers,
Benjamin

> 
> Regards,
> 
> Hans
> 
--
To unsubscribe from this list: send the line "unsubscribe linux-input" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Jiri Kosina May 11, 2017, 8:28 a.m. UTC | #4
Applied to for-4.13/ite. Thanks,
Hans de Goede May 11, 2017, 5:07 p.m. UTC | #5
Hi,

On 05/11/2017 10:28 AM, Jiri Kosina wrote:
> Applied to for-4.13/ite. Thanks,

Thank you, but Benjamin had 2 valid remarks about the first
patch in this set, so I was planning to do a v2. Instead
I will send a follow-up patch (right after this mail),
feel free to squash that into the original if you want to.

Regards,

Hans
--
To unsubscribe from this list: send the line "unsubscribe linux-input" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
diff mbox

Patch

diff --git a/drivers/hid/hid-input.c b/drivers/hid/hid-input.c
index d05f903c7614..79aa2f7d0482 100644
--- a/drivers/hid/hid-input.c
+++ b/drivers/hid/hid-input.c
@@ -656,6 +656,15 @@  static void hidinput_configure_usage(struct hid_input *hidinput, struct hid_fiel
 		case HID_GD_START:	map_key_clear(BTN_START);	break;
 		case HID_GD_SELECT:	map_key_clear(BTN_SELECT);	break;
 
+		case HID_GD_RFKILL_BTN:
+			/* MS wireless radio ctl extension, also check CA */
+			if (field->application == 0x0001000c) {
+				map_key_clear(KEY_RFKILL);
+				/* We need to simulate the btn release */
+				field->flags |= HID_MAIN_ITEM_RELATIVE;
+				break;
+			}
+
 		default: goto unknown;
 		}
 
diff --git a/include/linux/hid.h b/include/linux/hid.h
index 28f38e2b8f30..8a259c6ea8a1 100644
--- a/include/linux/hid.h
+++ b/include/linux/hid.h
@@ -182,6 +182,12 @@  struct hid_item {
 #define HID_GD_KEYBOARD		0x00010006
 #define HID_GD_KEYPAD		0x00010007
 #define HID_GD_MULTIAXIS	0x00010008
+/*
+ * Microsoft Win8 Wireless Radio Controls extensions CA, see (checked 09052017):
+ * https://docs.microsoft.com/en-us/windows-hardware/drivers/hid/airplane-mode-radio-management
+ * https://web.archive.org/web/20170509144631/https://docs.microsoft.com/en-us/windows-hardware/drivers/hid/airplane-mode-radio-management
+ */
+#define HID_GD_WIRELESS_RADIO_CTLS	0x0001000c
 #define HID_GD_X		0x00010030
 #define HID_GD_Y		0x00010031
 #define HID_GD_Z		0x00010032
@@ -210,6 +216,10 @@  struct hid_item {
 #define HID_GD_DOWN		0x00010091
 #define HID_GD_RIGHT		0x00010092
 #define HID_GD_LEFT		0x00010093
+/* Microsoft Win8 Wireless Radio Controls CA usage codes */
+#define HID_GD_RFKILL_BTN	0x000100c6
+#define HID_GD_RFKILL_LED	0x000100c7
+#define HID_GD_RFKILL_SWITCH	0x000100c8
 
 #define HID_DC_BATTERYSTRENGTH	0x00060020