diff mbox

HID: hid-plantronics: Update to map volume up/down controls

Message ID 1428779862-31930-1-git-send-email-terry.junge@plantronics.com (mailing list archive)
State New, archived
Delegated to: Jiri Kosina
Headers show

Commit Message

Junge, Terry April 11, 2015, 7:17 p.m. UTC
Update hid-plantronics.c to identify device type and correctly map
either the vendor unique or consumer control volume up/down usages
to KEY_VOLUMEUP and KEY_VOLUMEDOWN events.

Update Kconfig with enhanced help text for hid-plantronics driver
and changed default value from !EXPERT to m. This driver prevents
hid-input from mapping unknown vendor unique usages to mouse events
so it is preferred that it be available, expert or not.

Signed-off-by: Terry Junge <terry.junge@plantronics.com>
---
 drivers/hid/Kconfig           |   7 +-
 drivers/hid/hid-plantronics.c | 152 +++++++++++++++++++++++++++++++++++++++---
 2 files changed, 149 insertions(+), 10 deletions(-)

--
1.9.1

Comments

Jiri Kosina April 23, 2015, 8:22 a.m. UTC | #1
On Sat, 11 Apr 2015, Terry Junge wrote:

> Update hid-plantronics.c to identify device type and correctly map
> either the vendor unique or consumer control volume up/down usages
> to KEY_VOLUMEUP and KEY_VOLUMEDOWN events.
> 
> Update Kconfig with enhanced help text for hid-plantronics driver
> and changed default value from !EXPERT to m. This driver prevents
> hid-input from mapping unknown vendor unique usages to mouse events
> so it is preferred that it be available, expert or not.
> 
> Signed-off-by: Terry Junge <terry.junge@plantronics.com>
> ---
>  drivers/hid/Kconfig           |   7 +-
>  drivers/hid/hid-plantronics.c | 152 +++++++++++++++++++++++++++++++++++++++---
>  2 files changed, 149 insertions(+), 10 deletions(-)
> 
> diff --git a/drivers/hid/Kconfig b/drivers/hid/Kconfig
> index 152b006..69aac6b 100644
> --- a/drivers/hid/Kconfig
> +++ b/drivers/hid/Kconfig
> @@ -638,10 +638,13 @@ config HID_PICOLCD_CIR
> 
>  config HID_PLANTRONICS
>         tristate "Plantronics USB HID Driver"
> -       default !EXPERT

The '!EXPERT' stuff is gone in current Linus' tree (see commit 
7af05e73cd).

> +       default m
>         depends on HID
>         ---help---
> -       Provides HID support for Plantronics telephony devices.
> +       Provides HID support for Plantronics USB audio devices.
> +       Correctly maps vendor unique volume up/down HID usages to
> +       KEY_VOLUMEUP and KEY_VOLUMEDOWN events and prevents core mapping
> +       of other vendor unique HID usages to random mouse events.
> 
>  config HID_PRIMAX
>         tristate "Primax non-fully HID-compliant devices"
> diff --git a/drivers/hid/hid-plantronics.c b/drivers/hid/hid-plantronics.c
> index 2180e07..c4756a1 100644
> --- a/drivers/hid/hid-plantronics.c
> +++ b/drivers/hid/hid-plantronics.c
> @@ -2,7 +2,7 @@
>   *  Plantronics USB HID Driver
>   *
>   *  Copyright (c) 2014 JD Cole <jd.cole@plantronics.com>
> - *  Copyright (c) 2014 Terry Junge <terry.junge@plantronics.com>
> + *  Copyright (c) 2015 Terry Junge <terry.junge@plantronics.com>
>   */
> 
>  /*
> @@ -14,26 +14,161 @@
> 
>  #include "hid-ids.h"
> 
> +#include <linux/usb.h>
>  #include <linux/hid.h>
>  #include <linux/module.h>
> 
> +#define PLT_HID_1_0_PAGE       0xffa00000
> +#define PLT_HID_2_0_PAGE       0xffa20000
> +
> +#define PLT_BASIC_TELEPHONY    0x0003
> +#define PLT_BASIC_EXCEPTION    0x0005
> +
> +#define PLT_VOL_UP             0x00b1
> +#define PLT_VOL_DOWN           0x00b2
> +
> +#define PLT1_VOL_UP            (PLT_HID_1_0_PAGE | PLT_VOL_UP)
> +#define PLT1_VOL_DOWN          (PLT_HID_1_0_PAGE | PLT_VOL_DOWN)
> +#define PLT2_VOL_UP            (PLT_HID_2_0_PAGE | PLT_VOL_UP)
> +#define PLT2_VOL_DOWN          (PLT_HID_2_0_PAGE | PLT_VOL_DOWN)
> +
> +#define PLT_DA60               0xda60
> +
> +#define PLT_ALLOW_CONSUMER (field->application == HID_CP_CONSUMERCONTROL && \
> +                           (usage->hid & HID_USAGE_PAGE) == HID_UP_CONSUMER)
> +
>  static int plantronics_input_mapping(struct hid_device *hdev,
>                                      struct hid_input *hi,
>                                      struct hid_field *field,
>                                      struct hid_usage *usage,
>                                      unsigned long **bit, int *max)
>  {
> -       if (field->application == HID_CP_CONSUMERCONTROL
> -           && (usage->hid & HID_USAGE_PAGE) == HID_UP_CONSUMER) {
> -               hid_dbg(hdev, "usage: %08x (appl: %08x) - defaulted\n",
> -                        usage->hid, field->application);
> -               return 0;
> +       unsigned short mapped_key;
> +       unsigned long plt_type = (unsigned long)hid_get_drvdata(hdev);
> +
> +       /* handle volume up/down mapping */
> +       /* non-standard types or multi-HID interfaces - plt_type is PID */
> +       if (!(plt_type & HID_USAGE_PAGE)) {
> +               switch (plt_type) {
> +               case PLT_DA60:
> +                       if (PLT_ALLOW_CONSUMER)
> +                               goto defaulted;
> +                       goto ignored;
> +               default:
> +                       if (PLT_ALLOW_CONSUMER)
> +                               goto defaulted;
> +               }
> +       }
> +       /* handle standard types - plt_type is 0xffa0uuuu or 0xffa2uuuu */
> +       /* 'basic telephony compliant' - allow default consumer page map */
> +       else if ((plt_type & HID_USAGE) >= PLT_BASIC_TELEPHONY &&
> +                (plt_type & HID_USAGE) != PLT_BASIC_EXCEPTION) {
> +               if (PLT_ALLOW_CONSUMER)
> +                       goto defaulted;
> +       }
> +       /* not 'basic telephony' - apply legacy mapping */
> +       /* only map if the field is in the device's primary vendor page */
> +       else if (!((field->application ^ plt_type) & HID_USAGE_PAGE)) {
> +               switch (usage->hid) {
> +               case PLT1_VOL_UP:
> +               case PLT2_VOL_UP:
> +                       mapped_key = KEY_VOLUMEUP;
> +                       goto mapped;
> +               case PLT1_VOL_DOWN:
> +               case PLT2_VOL_DOWN:
> +                       mapped_key = KEY_VOLUMEDOWN;
> +                       goto mapped;
> +               }
>         }
> 
> -       hid_dbg(hdev, "usage: %08x (appl: %08x) - ignored\n",
> -               usage->hid, field->application);
> +/*
> + * Future mapping of call control or other usages,
> + * if and when keys are defined would go here
> + * otherwise, ignore everything else that was not mapped
> + */
> 
> +ignored:
>         return -1;
> +
> +defaulted:
> +       hid_dbg(hdev, "usage: %08x (appl: %08x) - defaulted\n",
> +               usage->hid, field->application);
> +       return 0;
> +
> +mapped:
> +       hid_map_usage_clear(hi, usage, bit, max, EV_KEY, mapped_key);
> +       hid_dbg(hdev, "usage: %08x (appl: %08x) - mapped to key %d\n",
> +               usage->hid, field->application, mapped_key);
> +       return 1;
> +}
> +
> +static int plantronics_hid_interface_count(struct hid_device *hdev)
> +{
> +       int i, count;
> +       struct usb_interface *intf = to_usb_interface(hdev->dev.parent);
> +       struct usb_device *udev = interface_to_usbdev(intf);
> +       struct usb_host_config *config = udev->actconfig;

You are now introducing USB-isms into a HID driver.

Is it really necessary? The changelog is rather sparse about the reason 
why you are counting the USB interfaces and make decisions based on it. 
Could you please be more verbose there?

Also, as you as now using USB-isms in the driver, you have to make it 
dependent on USB availability.

Thanks,
Junge, Terry May 8, 2015, 12:16 a.m. UTC | #2
Jiri,
Thanks for the review. Sorry for the late response. Please see below:

> -----Original Message-----
> From: Jiri Kosina [mailto:jkosina@suse.cz]
> Sent: Thursday, April 23, 2015 1:22 AM
> To: Junge, Terry
> Cc: linux-input@vger.kernel.org
> Subject: Re: [PATCH] HID: hid-plantronics: Update to map volume up/down
> controls
>
> On Sat, 11 Apr 2015, Terry Junge wrote:
>
> > Update hid-plantronics.c to identify device type and correctly map
> > either the vendor unique or consumer control volume up/down usages
> > to KEY_VOLUMEUP and KEY_VOLUMEDOWN events.
> >
> > Update Kconfig with enhanced help text for hid-plantronics driver
> > and changed default value from !EXPERT to m. This driver prevents
> > hid-input from mapping unknown vendor unique usages to mouse events
> > so it is preferred that it be available, expert or not.
> >
> > Signed-off-by: Terry Junge <terry.junge@plantronics.com>
> > ---
> >  drivers/hid/Kconfig           |   7 +-
> >  drivers/hid/hid-plantronics.c | 152
> +++++++++++++++++++++++++++++++++++++++---
> >  2 files changed, 149 insertions(+), 10 deletions(-)
> >
> > diff --git a/drivers/hid/Kconfig b/drivers/hid/Kconfig
> > index 152b006..69aac6b 100644
> > --- a/drivers/hid/Kconfig
> > +++ b/drivers/hid/Kconfig
> > @@ -638,10 +638,13 @@ config HID_PICOLCD_CIR
> >
> >  config HID_PLANTRONICS
> >         tristate "Plantronics USB HID Driver"
> > -       default !EXPERT
>
> The '!EXPERT' stuff is gone in current Linus' tree (see commit
> 7af05e73cd).

I see that, good; is there any issue with setting default to 'm'?

>
> > +       default m
> >         depends on HID
> >         ---help---
> > -       Provides HID support for Plantronics telephony devices.
> > +       Provides HID support for Plantronics USB audio devices.
> > +       Correctly maps vendor unique volume up/down HID usages to
> > +       KEY_VOLUMEUP and KEY_VOLUMEDOWN events and prevents core
> mapping
> > +       of other vendor unique HID usages to random mouse events.
> >
> >  config HID_PRIMAX
> >         tristate "Primax non-fully HID-compliant devices"
> > diff --git a/drivers/hid/hid-plantronics.c b/drivers/hid/hid-plantronics.c
> > index 2180e07..c4756a1 100644
> > --- a/drivers/hid/hid-plantronics.c
> > +++ b/drivers/hid/hid-plantronics.c
> > @@ -2,7 +2,7 @@
> >   *  Plantronics USB HID Driver
> >   *
> >   *  Copyright (c) 2014 JD Cole <jd.cole@plantronics.com>
> > - *  Copyright (c) 2014 Terry Junge <terry.junge@plantronics.com>
> > + *  Copyright (c) 2015 Terry Junge <terry.junge@plantronics.com>
> >   */
> >
> >  /*
> > @@ -14,26 +14,161 @@
> >
> >  #include "hid-ids.h"
> >
> > +#include <linux/usb.h>
> >  #include <linux/hid.h>
> >  #include <linux/module.h>
> >
> > +#define PLT_HID_1_0_PAGE       0xffa00000
> > +#define PLT_HID_2_0_PAGE       0xffa20000
> > +
> > +#define PLT_BASIC_TELEPHONY    0x0003
> > +#define PLT_BASIC_EXCEPTION    0x0005
> > +
> > +#define PLT_VOL_UP             0x00b1
> > +#define PLT_VOL_DOWN           0x00b2
> > +
> > +#define PLT1_VOL_UP            (PLT_HID_1_0_PAGE | PLT_VOL_UP)
> > +#define PLT1_VOL_DOWN          (PLT_HID_1_0_PAGE | PLT_VOL_DOWN)
> > +#define PLT2_VOL_UP            (PLT_HID_2_0_PAGE | PLT_VOL_UP)
> > +#define PLT2_VOL_DOWN          (PLT_HID_2_0_PAGE | PLT_VOL_DOWN)
> > +
> > +#define PLT_DA60               0xda60
> > +
> > +#define PLT_ALLOW_CONSUMER (field->application ==
> HID_CP_CONSUMERCONTROL && \
> > +                           (usage->hid & HID_USAGE_PAGE) == HID_UP_CONSUMER)
> > +
> >  static int plantronics_input_mapping(struct hid_device *hdev,
> >                                      struct hid_input *hi,
> >                                      struct hid_field *field,
> >                                      struct hid_usage *usage,
> >                                      unsigned long **bit, int *max)
> >  {
> > -       if (field->application == HID_CP_CONSUMERCONTROL
> > -           && (usage->hid & HID_USAGE_PAGE) == HID_UP_CONSUMER) {
> > -               hid_dbg(hdev, "usage: %08x (appl: %08x) - defaulted\n",
> > -                        usage->hid, field->application);
> > -               return 0;
> > +       unsigned short mapped_key;
> > +       unsigned long plt_type = (unsigned long)hid_get_drvdata(hdev);
> > +
> > +       /* handle volume up/down mapping */
> > +       /* non-standard types or multi-HID interfaces - plt_type is PID */
> > +       if (!(plt_type & HID_USAGE_PAGE)) {
> > +               switch (plt_type) {
> > +               case PLT_DA60:
> > +                       if (PLT_ALLOW_CONSUMER)
> > +                               goto defaulted;
> > +                       goto ignored;
> > +               default:
> > +                       if (PLT_ALLOW_CONSUMER)
> > +                               goto defaulted;
> > +               }
> > +       }
> > +       /* handle standard types - plt_type is 0xffa0uuuu or 0xffa2uuuu */
> > +       /* 'basic telephony compliant' - allow default consumer page map */
> > +       else if ((plt_type & HID_USAGE) >= PLT_BASIC_TELEPHONY &&
> > +                (plt_type & HID_USAGE) != PLT_BASIC_EXCEPTION) {
> > +               if (PLT_ALLOW_CONSUMER)
> > +                       goto defaulted;
> > +       }
> > +       /* not 'basic telephony' - apply legacy mapping */
> > +       /* only map if the field is in the device's primary vendor page */
> > +       else if (!((field->application ^ plt_type) & HID_USAGE_PAGE)) {
> > +               switch (usage->hid) {
> > +               case PLT1_VOL_UP:
> > +               case PLT2_VOL_UP:
> > +                       mapped_key = KEY_VOLUMEUP;
> > +                       goto mapped;
> > +               case PLT1_VOL_DOWN:
> > +               case PLT2_VOL_DOWN:
> > +                       mapped_key = KEY_VOLUMEDOWN;
> > +                       goto mapped;
> > +               }
> >         }
> >
> > -       hid_dbg(hdev, "usage: %08x (appl: %08x) - ignored\n",
> > -               usage->hid, field->application);
> > +/*
> > + * Future mapping of call control or other usages,
> > + * if and when keys are defined would go here
> > + * otherwise, ignore everything else that was not mapped
> > + */
> >
> > +ignored:
> >         return -1;
> > +
> > +defaulted:
> > +       hid_dbg(hdev, "usage: %08x (appl: %08x) - defaulted\n",
> > +               usage->hid, field->application);
> > +       return 0;
> > +
> > +mapped:
> > +       hid_map_usage_clear(hi, usage, bit, max, EV_KEY, mapped_key);
> > +       hid_dbg(hdev, "usage: %08x (appl: %08x) - mapped to key %d\n",
> > +               usage->hid, field->application, mapped_key);
> > +       return 1;
> > +}
> > +
> > +static int plantronics_hid_interface_count(struct hid_device *hdev)
> > +{
> > +       int i, count;
> > +       struct usb_interface *intf = to_usb_interface(hdev->dev.parent);
> > +       struct usb_device *udev = interface_to_usbdev(intf);
> > +       struct usb_host_config *config = udev->actconfig;
>
> You are now introducing USB-isms into a HID driver.
>
> Is it really necessary? The changelog is rather sparse about the reason
> why you are counting the USB interfaces and make decisions based on it.
> Could you please be more verbose there?
>

The intent of this driver was to be able to identify Plantronics devices
by their HID collection characteristics as opposed to an ever growing
PID list. There is one group of devices that have multiple HID interfaces
so counting sibling HID interfaces is a method to identify them and
force all the interfaces to be processed and mapped.

However, I can see that pulling USB-isms into a HID driver may be
setting a bad precedent. I have created and tested an alternate patch
that uses PIDs to identify the current devices with multiple HID interfaces.
This eliminates the interface counting but would require an update if we
ever shipped another device with multiple HID interfaces (I hope not).

I'm good either way. We can kill this patch and I can submit a v2 patch
that eliminates the USB-isms. Or just add in the USB dependency and
go with this one. What's your preference?

> Also, as you as now using USB-isms in the driver, you have to make it
> dependent on USB availability.
>
> Thanks,
>
> --
> Jiri Kosina
> SUSE Labs

Thanks again for your time and review,
Terry Junge
Plantronics
Jiri Kosina May 11, 2015, 8:24 a.m. UTC | #3
On Fri, 8 May 2015, Junge, Terry wrote:

> > >  config HID_PLANTRONICS
> > >         tristate "Plantronics USB HID Driver"
> > > -       default !EXPERT
> >
> > The '!EXPERT' stuff is gone in current Linus' tree (see commit
> > 7af05e73cd).
> 
> I see that, good; is there any issue with setting default to 'm'?

It's a general rule of thumb not to add any new default-to-on options for 
things that are not crucial core infrastructure of the kernel.

[ ... snip ... ]
> > > +static int plantronics_hid_interface_count(struct hid_device *hdev)
> > > +{
> > > +       int i, count;
> > > +       struct usb_interface *intf = to_usb_interface(hdev->dev.parent);
> > > +       struct usb_device *udev = interface_to_usbdev(intf);
> > > +       struct usb_host_config *config = udev->actconfig;
> >
> > You are now introducing USB-isms into a HID driver.
> >
> > Is it really necessary? The changelog is rather sparse about the reason
> > why you are counting the USB interfaces and make decisions based on it.
> > Could you please be more verbose there?
> >
> 
> The intent of this driver was to be able to identify Plantronics devices
> by their HID collection characteristics as opposed to an ever growing
> PID list. There is one group of devices that have multiple HID interfaces
> so counting sibling HID interfaces is a method to identify them and
> force all the interfaces to be processed and mapped.
> 
> However, I can see that pulling USB-isms into a HID driver may be
> setting a bad precedent. I have created and tested an alternate patch
> that uses PIDs to identify the current devices with multiple HID interfaces.
> This eliminates the interface counting but would require an update if we
> ever shipped another device with multiple HID interfaces (I hope not).
> 
> I'm good either way. We can kill this patch and I can submit a v2 patch
> that eliminates the USB-isms. Or just add in the USB dependency and
> go with this one. What's your preference?

I'd like to defer that decision to you. However the patch you submitted 
isn't really consistent; therefore it needs to be modified one way or 
another anyway.

Basically the two options I am fine with, are:

- keep the USB-isms there, but put an explicit CONFIG_USB dependency into 
  the Kconfig and explain in changelog of the patch why this is a good 
  thing to do (like the paragraph you wrote above). If you, as a HW  
  vendor, are certain that there will never ever be any device using 
  non-USB transport, then this is a viable option (not nice, but I can 
  understand the reasons for that)

- fall back to PID-based device identification

Thanks,
Junge, Terry May 15, 2015, 12:59 a.m. UTC | #4
On Mon, May 11, 2015, Kosina, Jiri wrote:

 [ ... snip ... ]
> I'd like to defer that decision to you. However the patch you submitted
> isn't really consistent; therefore it needs to be modified one way or
> another anyway.
>
> Basically the two options I am fine with, are:
>
> - keep the USB-isms there, but put an explicit CONFIG_USB dependency into
>   the Kconfig and explain in changelog of the patch why this is a good
>   thing to do (like the paragraph you wrote above). If you, as a HW
>   vendor, are certain that there will never ever be any device using
>   non-USB transport, then this is a viable option (not nice, but I can
>   understand the reasons for that)
>
> - fall back to PID-based device identification

I will fall back to using PID to identify multi-HID interface devices.
I will be submitting a v2 patch set tomorrow.

Thanks again for your time,
Terry Junge
Plantronics
diff mbox

Patch

diff --git a/drivers/hid/Kconfig b/drivers/hid/Kconfig
index 152b006..69aac6b 100644
--- a/drivers/hid/Kconfig
+++ b/drivers/hid/Kconfig
@@ -638,10 +638,13 @@  config HID_PICOLCD_CIR

 config HID_PLANTRONICS
        tristate "Plantronics USB HID Driver"
-       default !EXPERT
+       default m
        depends on HID
        ---help---
-       Provides HID support for Plantronics telephony devices.
+       Provides HID support for Plantronics USB audio devices.
+       Correctly maps vendor unique volume up/down HID usages to
+       KEY_VOLUMEUP and KEY_VOLUMEDOWN events and prevents core mapping
+       of other vendor unique HID usages to random mouse events.

 config HID_PRIMAX
        tristate "Primax non-fully HID-compliant devices"
diff --git a/drivers/hid/hid-plantronics.c b/drivers/hid/hid-plantronics.c
index 2180e07..c4756a1 100644
--- a/drivers/hid/hid-plantronics.c
+++ b/drivers/hid/hid-plantronics.c
@@ -2,7 +2,7 @@ 
  *  Plantronics USB HID Driver
  *
  *  Copyright (c) 2014 JD Cole <jd.cole@plantronics.com>
- *  Copyright (c) 2014 Terry Junge <terry.junge@plantronics.com>
+ *  Copyright (c) 2015 Terry Junge <terry.junge@plantronics.com>
  */

 /*
@@ -14,26 +14,161 @@ 

 #include "hid-ids.h"

+#include <linux/usb.h>
 #include <linux/hid.h>
 #include <linux/module.h>

+#define PLT_HID_1_0_PAGE       0xffa00000
+#define PLT_HID_2_0_PAGE       0xffa20000
+
+#define PLT_BASIC_TELEPHONY    0x0003
+#define PLT_BASIC_EXCEPTION    0x0005
+
+#define PLT_VOL_UP             0x00b1
+#define PLT_VOL_DOWN           0x00b2
+
+#define PLT1_VOL_UP            (PLT_HID_1_0_PAGE | PLT_VOL_UP)
+#define PLT1_VOL_DOWN          (PLT_HID_1_0_PAGE | PLT_VOL_DOWN)
+#define PLT2_VOL_UP            (PLT_HID_2_0_PAGE | PLT_VOL_UP)
+#define PLT2_VOL_DOWN          (PLT_HID_2_0_PAGE | PLT_VOL_DOWN)
+
+#define PLT_DA60               0xda60
+
+#define PLT_ALLOW_CONSUMER (field->application == HID_CP_CONSUMERCONTROL && \
+                           (usage->hid & HID_USAGE_PAGE) == HID_UP_CONSUMER)
+
 static int plantronics_input_mapping(struct hid_device *hdev,
                                     struct hid_input *hi,
                                     struct hid_field *field,
                                     struct hid_usage *usage,
                                     unsigned long **bit, int *max)
 {
-       if (field->application == HID_CP_CONSUMERCONTROL
-           && (usage->hid & HID_USAGE_PAGE) == HID_UP_CONSUMER) {
-               hid_dbg(hdev, "usage: %08x (appl: %08x) - defaulted\n",
-                        usage->hid, field->application);
-               return 0;
+       unsigned short mapped_key;
+       unsigned long plt_type = (unsigned long)hid_get_drvdata(hdev);
+
+       /* handle volume up/down mapping */
+       /* non-standard types or multi-HID interfaces - plt_type is PID */
+       if (!(plt_type & HID_USAGE_PAGE)) {
+               switch (plt_type) {
+               case PLT_DA60:
+                       if (PLT_ALLOW_CONSUMER)
+                               goto defaulted;
+                       goto ignored;
+               default:
+                       if (PLT_ALLOW_CONSUMER)
+                               goto defaulted;
+               }
+       }
+       /* handle standard types - plt_type is 0xffa0uuuu or 0xffa2uuuu */
+       /* 'basic telephony compliant' - allow default consumer page map */
+       else if ((plt_type & HID_USAGE) >= PLT_BASIC_TELEPHONY &&
+                (plt_type & HID_USAGE) != PLT_BASIC_EXCEPTION) {
+               if (PLT_ALLOW_CONSUMER)
+                       goto defaulted;
+       }
+       /* not 'basic telephony' - apply legacy mapping */
+       /* only map if the field is in the device's primary vendor page */
+       else if (!((field->application ^ plt_type) & HID_USAGE_PAGE)) {
+               switch (usage->hid) {
+               case PLT1_VOL_UP:
+               case PLT2_VOL_UP:
+                       mapped_key = KEY_VOLUMEUP;
+                       goto mapped;
+               case PLT1_VOL_DOWN:
+               case PLT2_VOL_DOWN:
+                       mapped_key = KEY_VOLUMEDOWN;
+                       goto mapped;
+               }
        }

-       hid_dbg(hdev, "usage: %08x (appl: %08x) - ignored\n",
-               usage->hid, field->application);
+/*
+ * Future mapping of call control or other usages,
+ * if and when keys are defined would go here
+ * otherwise, ignore everything else that was not mapped
+ */

+ignored:
        return -1;
+
+defaulted:
+       hid_dbg(hdev, "usage: %08x (appl: %08x) - defaulted\n",
+               usage->hid, field->application);
+       return 0;
+
+mapped:
+       hid_map_usage_clear(hi, usage, bit, max, EV_KEY, mapped_key);
+       hid_dbg(hdev, "usage: %08x (appl: %08x) - mapped to key %d\n",
+               usage->hid, field->application, mapped_key);
+       return 1;
+}
+
+static int plantronics_hid_interface_count(struct hid_device *hdev)
+{
+       int i, count;
+       struct usb_interface *intf = to_usb_interface(hdev->dev.parent);
+       struct usb_device *udev = interface_to_usbdev(intf);
+       struct usb_host_config *config = udev->actconfig;
+
+       if (!config) {
+               hid_dbg(hdev, "no active configuration found\n");
+               return 0;
+       }
+
+       for (i = 0, count = 0; i < config->desc.bNumInterfaces; i++) {
+               intf = config->interface[i];
+               if (intf && intf->cur_altsetting &&
+                   intf->cur_altsetting->desc.bInterfaceClass == USB_CLASS_HID)
+                       count++;
+       }
+
+       hid_dbg(hdev, "found %d HID interface(s)\n", count);
+       return count;
+}
+
+static unsigned long plantronics_device_type(struct hid_device *hdev)
+{
+       unsigned i, col_page;
+       unsigned long plt_type = hdev->product;
+
+       if (plantronics_hid_interface_count(hdev) != 1) {
+               hdev->quirks |= HID_QUIRK_HIDINPUT_FORCE;
+               goto exit;
+       }
+
+       for (i = 0; i < hdev->maxcollection; i++) {
+               col_page = hdev->collection[i].usage & HID_USAGE_PAGE;
+               if (col_page == PLT_HID_2_0_PAGE) {
+                       plt_type = hdev->collection[i].usage;
+                       break;
+               }
+               if (col_page == PLT_HID_1_0_PAGE)
+                       plt_type = hdev->collection[i].usage;
+       }
+
+exit:
+       hid_dbg(hdev, "plt_type decoded as: %08lx\n", plt_type);
+       return plt_type;
+}
+
+static int plantronics_probe(struct hid_device *hdev,
+                            const struct hid_device_id *id)
+{
+       int ret;
+
+       ret = hid_parse(hdev);
+       if (ret) {
+               hid_err(hdev, "parse failed\n");
+               goto err;
+       }
+
+       hid_set_drvdata(hdev, (void *)plantronics_device_type(hdev));
+
+       ret = hid_hw_start(hdev, HID_CONNECT_DEFAULT);
+       if (ret)
+               hid_err(hdev, "hw start failed\n");
+
+err:
+       return ret;
 }

 static const struct hid_device_id plantronics_devices[] = {
@@ -46,6 +181,7 @@  static struct hid_driver plantronics_driver = {
        .name = "plantronics",
        .id_table = plantronics_devices,
        .input_mapping = plantronics_input_mapping,
+       .probe = plantronics_probe,
 };
 module_hid_driver(plantronics_driver);