Re: [PATCH] HID: Add quirk driver for NTI USB-SUN adapter

From: Benjamin Tissoires
Date: Wed Feb 01 2017 - 03:24:29 EST


Hi Jonathan,

On Jan 31 2017 or thereabouts, Jonathan Tomer wrote:
> These adapters allow pre-USB Sun keyboards to be connected to USB-only
> machines, but includes the wrong maximum keycode in its report
> descriptor, making most of the keys present on Sun keyboards but not
> 101-key PC keyboards nonfunctional.
>
> This patch implements a quirk that overrides the maximum keycode in the
> report descriptor.
>
> Signed-off-by: Jonathan Tomer <jktomer@xxxxxxxxxx>
> ---
> drivers/hid/Kconfig | 7 ++++++
> drivers/hid/Makefile | 1 +
> drivers/hid/hid-core.c | 1 +
> drivers/hid/hid-ids.h | 3 +++
> drivers/hid/hid-nti.c | 66 ++++++++++++++++++++++++++++++++++++++++++++++++++
> 5 files changed, 78 insertions(+)
> create mode 100644 drivers/hid/hid-nti.c
>
> diff --git a/drivers/hid/Kconfig b/drivers/hid/Kconfig
> index 4070b7386e9d..e2a9fdd21d62 100644
> --- a/drivers/hid/Kconfig
> +++ b/drivers/hid/Kconfig
> @@ -580,6 +580,13 @@ config HID_MULTITOUCH
> To compile this driver as a module, choose M here: the
> module will be called hid-multitouch.
>
> +config HID_NTI
> + tristate "NTI keyboard adapters"
> + depends on USB_HID

No need to depend on USB_HID. Your driver is just using the plain HID
protocol, so the guard "if HID" at the beginning of the Kconfig is
sufficient.

> + ---help---
> + Support for the "extra" Sun keyboard keys on keyboards attached
> + through Network Technologies USB-SUN keyboard adapters.
> +
> config HID_NTRIG
> tristate "N-Trig touch screen"
> depends on USB_HID
> diff --git a/drivers/hid/Makefile b/drivers/hid/Makefile
> index 4d111f23e801..c0a844b43dcc 100644
> --- a/drivers/hid/Makefile
> +++ b/drivers/hid/Makefile
> @@ -62,6 +62,7 @@ obj-$(CONFIG_HID_MAYFLASH) += hid-mf.o
> obj-$(CONFIG_HID_MICROSOFT) += hid-microsoft.o
> obj-$(CONFIG_HID_MONTEREY) += hid-monterey.o
> obj-$(CONFIG_HID_MULTITOUCH) += hid-multitouch.o
> +obj-$(CONFIG_HID_NTI) += hid-nti.o
> obj-$(CONFIG_HID_NTRIG) += hid-ntrig.o
> obj-$(CONFIG_HID_ORTEK) += hid-ortek.o
> obj-$(CONFIG_HID_PRODIKEYS) += hid-prodikeys.o
> diff --git a/drivers/hid/hid-core.c b/drivers/hid/hid-core.c
> index cff060b56da9..3a435bf75e4d 100644
> --- a/drivers/hid/hid-core.c
> +++ b/drivers/hid/hid-core.c
> @@ -1997,6 +1997,7 @@ static const struct hid_device_id hid_have_special_driver[] = {
> { HID_USB_DEVICE(USB_VENDOR_ID_MICROSOFT, USB_DEVICE_ID_MS_POWER_COVER) },
> { HID_USB_DEVICE(USB_VENDOR_ID_MONTEREY, USB_DEVICE_ID_GENIUS_KB29E) },
> { HID_USB_DEVICE(USB_VENDOR_ID_MSI, USB_DEVICE_ID_MSI_GT683R_LED_PANEL) },
> + { HID_USB_DEVICE(USB_VENDOR_ID_NTI, USB_DEVICE_ID_USB_SUN) },
> { HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN) },
> { HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_1) },
> { HID_USB_DEVICE(USB_VENDOR_ID_NTRIG, USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_2) },
> diff --git a/drivers/hid/hid-ids.h b/drivers/hid/hid-ids.h
> index 54bd22dc1411..9f79e7e657a4 100644
> --- a/drivers/hid/hid-ids.h
> +++ b/drivers/hid/hid-ids.h
> @@ -767,6 +767,9 @@
> #define USB_DEVICE_ID_NOVATEK_PCT 0x0600
> #define USB_DEVICE_ID_NOVATEK_MOUSE 0x1602
>
> +#define USB_VENDOR_ID_NTI 0x0757
> +#define USB_DEVICE_ID_USB_SUN 0x0a00
> +
> #define USB_VENDOR_ID_NTRIG 0x1b96
> #define USB_DEVICE_ID_NTRIG_TOUCH_SCREEN 0x0001
> #define USB_DEVICE_ID_NTRIG_TOUCH_SCREEN_1 0x0003
> diff --git a/drivers/hid/hid-nti.c b/drivers/hid/hid-nti.c
> new file mode 100644
> index 000000000000..48991adc7eb3
> --- /dev/null
> +++ b/drivers/hid/hid-nti.c
> @@ -0,0 +1,66 @@
> +/*
> + * USB HID quirks support for Network Technologies, Inc. "USB-SUN" USB
> + * adapter for pre-USB Sun keyboards
> + *
> + * Copyright (c) 2011 Google, Inc.
> + *
> + * Based on HID apple driver by
> + * Copyright (c) 1999 Andreas Gal
> + * Copyright (c) 2000-2005 Vojtech Pavlik <vojtech@xxxxxxx>
> + * Copyright (c) 2005 Michael Haboustak <mike-@xxxxxxxxxxxx> for Concept2, Inc
> + * Copyright (c) 2006-2007 Jiri Kosina
> + * Copyright (c) 2008 Jiri Slaby <jirislaby@xxxxxxxxx>
> + */
> +
> +/*
> + * This program is free software; you can redistribute it and/or modify it
> + * under the terms of the GNU General Public License as published by the Free
> + * Software Foundation; either version 2 of the License, or (at your option)
> + * any later version.
> + */
> +
> +#include <linux/device.h>
> +#include <linux/input.h>
> +#include <linux/hid.h>
> +#include <linux/module.h>
> +
> +#include "hid-ids.h"
> +
> +/*
> + * NTI Sun keyboard adapter has wrong logical maximum in report descriptor
> + */
> +static __u8 *nti_usbsun_report_fixup(struct hid_device *hdev, __u8 *rdesc,
> + unsigned int *rsize)
> +{
> + if (*rsize >= 60 && rdesc[53] == 0x65 && rdesc[59] == 0x65) {
> + hid_info(hdev, "fixing up NTI USB-SUN keyboard adapter report descriptor\n");
> + rdesc[53] = rdesc[59] = 0xe7;
> + }
> + return rdesc;
> +}
> +
> +static const struct hid_device_id nti_devices[] = {
> + { HID_USB_DEVICE(USB_VENDOR_ID_NTI, USB_DEVICE_ID_USB_SUN) },
> + { }
> +};
> +MODULE_DEVICE_TABLE(hid, nti_devices);
> +
> +static struct hid_driver nti_driver = {
> + .name = "nti",
> + .id_table = nti_devices,
> + .report_fixup = nti_usbsun_report_fixup
> +};
> +
> +static int __init nti_init(void)
> +{
> + return hid_register_driver(&nti_driver);
> +}
> +
> +static void __exit nti_exit(void)
> +{
> + hid_unregister_driver(&nti_driver);
> +}
> +
> +module_init(nti_init);
> +module_exit(nti_exit);

You can use module_hid_driver(nti_driver); and remove both nti_init()
and nti_exit().

Rest looks good to me.

> +MODULE_LICENSE("GPL");

Actually, aren't you missing MODULE_AUTHOR and MODULE_DESCRIPTION?

Cheers,
Benjamin

> --
> 2.11.0.483.g087da7b7c-goog
>