[alsa-devel] [PATCH v2 1/2] hid-lenovo: Add support for X1 Tablet special keys and LED control
Benjamin Tissoires
benjamin.tissoires at redhat.com
Thu Sep 15 10:11:08 CEST 2016
On Sep 15 2016 or thereabouts, Dennis Wassenberg wrote:
> Hi Benjamin,
>
> Thank you for your comments. I will prepare new patches to replace this
> one. It will take some weeks to do this (vacation, other work). Would
> you please answer my inquiries inlined before I do this.
>
> Best regards,
>
> Dennis
>
> On 14.09.2016 17:32, Benjamin Tissoires wrote:
> > Hi Dennis,
> >
> > On Sep 14 2016 or thereabouts, Dennis Wassenberg wrote:
> >> The Lenovo X1 Tablet Cover is connected via USB. It constists of
> >> 1 device with 3 usb interfaces. Interface 0 represents keyboard,
> >> interface 1 the function / special keys and LED control, interface 2
> >> is the Synaptics touchpad and pointing stick.
> >>
> >> This driver will bind to interfaces 0 and 1 and handle function / special keys
> >> including LED control.
> >> HID: add device id for Lenovo X1 Tablet Cover
> >>
> >> Signed-off-by: Dennis Wassenberg <dennis.wassenberg at secunet.com>
> >> ---
> >> Changes v1 -> v2 (suggested by Benjamin Tissoires):
> >> * Squashed add of device IDs for Lenovo Thinkpad X1 Tablet Cover together with add of support for Lenovo Thinkpad X1 Tablet Cover into one patch
> >>
> >
> > I wanted to review the first version, but got sidetracked.
> >
> > So here it comes :)
> >
> >>
> >> drivers/hid/hid-core.c | 1 +
> >> drivers/hid/hid-ids.h | 1 +
> >> drivers/hid/hid-lenovo.c | 549 +++++++++++++++++++++++++++++++++++++++++++++
> >
> > This seems to be too big for a single patch. Especially when you have
> > actually several changes that could be split for easier reviewing (LED,
> > special keys and keys stuck at least).
> >
> Whats the difference between special keys and keys stuck? This code will
> mainly handle special keys and LED control. I can split these 2 thinks.
> But I currently don't know where to do a third split.
IMO, in the first case, you are mapping unmapped keys to their proper
KEY_* event. In the other case, you are forcing the release of the keys,
which is not something we generally do given that you should be notified
of the release. Splitting this is 2 would allow to better understand the
changes and revert one if needed.
> >> include/linux/hid-lenovo.h | 15 ++
> >> 4 files changed, 566 insertions(+)
> >> create mode 100644 include/linux/hid-lenovo.h
> >>
> >> diff --git a/drivers/hid/hid-core.c b/drivers/hid/hid-core.c
> >> index 6add0b6..ba6a200 100644
> >> --- a/drivers/hid/hid-core.c
> >> +++ b/drivers/hid/hid-core.c
> >> @@ -2111,6 +2111,7 @@ void hid_disconnect(struct hid_device *hdev)
> >> { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_NINTENDO, USB_DEVICE_ID_NINTENDO_WIIMOTE2) },
> >> { HID_USB_DEVICE(USB_VENDOR_ID_RAZER, USB_DEVICE_ID_RAZER_BLADE_14) },
> >> { HID_USB_DEVICE(USB_VENDOR_ID_CMEDIA, USB_DEVICE_ID_CM6533) },
> >> + { HID_USB_DEVICE(USB_VENDOR_ID_LENOVO, USB_DEVICE_ID_LENOVO_X1_COVER) },
> >
> > I know it's hard given the existing code, but please try to keep the
> > list sorted and insert your device in the appropriate place.
> >
> oh sorry, yes of course.
> >> { }
> >> };
> >>
> >> diff --git a/drivers/hid/hid-ids.h b/drivers/hid/hid-ids.h
> >> index 3466f0d..1f08fb5 100644
> >> --- a/drivers/hid/hid-ids.h
> >> +++ b/drivers/hid/hid-ids.h
> >> @@ -615,6 +615,7 @@
> >> #define USB_DEVICE_ID_LENOVO_CUSBKBD 0x6047
> >> #define USB_DEVICE_ID_LENOVO_CBTKBD 0x6048
> >> #define USB_DEVICE_ID_LENOVO_TPPRODOCK 0x6067
> >> +#define USB_DEVICE_ID_LENOVO_X1_COVER 0x6085
> >>
> >> #define USB_VENDOR_ID_LG 0x1fd2
> >> #define USB_DEVICE_ID_LG_MULTITOUCH 0x0064
> >> diff --git a/drivers/hid/hid-lenovo.c b/drivers/hid/hid-lenovo.c
> >> index 1ac4ff4..4251aac 100644
> >> --- a/drivers/hid/hid-lenovo.c
> >> +++ b/drivers/hid/hid-lenovo.c
> >> @@ -3,9 +3,11 @@
> >> * - ThinkPad USB Keyboard with TrackPoint (tpkbd)
> >> * - ThinkPad Compact Bluetooth Keyboard with TrackPoint (cptkbd)
> >> * - ThinkPad Compact USB Keyboard with TrackPoint (cptkbd)
> >> + * - ThinkPad X1 Cover USB Keyboard with TrackPoint and Touchpad (tpx1cover)
> >> *
> >> * Copyright (c) 2012 Bernhard Seibold
> >> * Copyright (c) 2014 Jamie Lentin <jm at lentin.co.uk>
> >> + * Copyright (c) 2016 Dennis Wassenberg <dennis.wassenberg at secunet.com>
> >> */
> >>
> >> /*
> >> @@ -19,11 +21,19 @@
> >> #include <linux/sysfs.h>
> >> #include <linux/device.h>
> >> #include <linux/hid.h>
> >> +#include <linux/hid-lenovo.h>
> >> #include <linux/input.h>
> >> #include <linux/leds.h>
> >>
> >> #include "hid-ids.h"
> >>
> >> +struct led_table_entry {
> >> + struct led_classdev *dev;
> >> + uint8_t state;
> >> +};
> >> +
> >> +static struct led_table_entry hid_lenovo_led_table[HID_LENOVO_LED_MAX];
> >
> > Ouch. Please no static arrays containing random devices. The device is
> > USB, so you could have several of its kind plugged at once.
> >
> > So, please include this array in the driver data in the hid device, and
> > if you need a list of hid device connected, use an actual list of struct
> > hid_device.
> > Well, you can also use a list of struct led_table_entry if you add a
> > field with the type, and iterate over the list for each call on the API
> > in case there are 2 or more LEDs of the same type.
> >
> Yes, you are right. For my use case (X1 Tablet only) this was sufficient
> to do it in this way:) X1 Tablet is only able to connect one
> ThinKeyboard Cover.
> >> +
> >> struct lenovo_drvdata_tpkbd {
> >> int led_state;
> >> struct led_classdev led_mute;
> >> @@ -42,6 +52,37 @@ struct lenovo_drvdata_cptkbd {
> >> int sensitivity;
> >> };
> >>
> >> +struct lenovo_drvdata_tpx1cover {
> >> + uint16_t led_state;
> >> + uint8_t fnlock_state;
> >> + uint8_t led_present;
> >> + struct led_classdev led_mute;
> >> + struct led_classdev led_micmute;
> >> + struct led_classdev led_fnlock;
> >> +};
> >> +
> >> +int hid_lenovo_led_set(int led_num, bool on)
> >
> > You are declaring an enum for LEDs, I'd prefer see it used here (so you
> > have to give it a name first).
> >
> ok.
> >> +{
> >> + struct led_classdev *dev;
> >> +
> >> + if (led_num >= HID_LENOVO_LED_MAX)
> >> + return -EINVAL;
> >> +
> >> + dev = hid_lenovo_led_table[led_num].dev;
> >> + hid_lenovo_led_table[led_num].state = on;
> >> +
> >> + if (!dev)
> >> + return -ENODEV;
> >> +
> >> + if (!dev->brightness_set)
> >> + return -ENODEV;
> >> +
> >> + dev->brightness_set(dev, on ? LED_FULL : LED_OFF);
> >> +
> >> + return 0;
> >> +}
> >> +EXPORT_SYMBOL_GPL(hid_lenovo_led_set);
> >> +
> >> #define map_key_clear(c) hid_map_usage_clear(hi, usage, bit, max, EV_KEY, (c))
> >>
> >> static const __u8 lenovo_pro_dock_need_fixup_collection[] = {
> >> @@ -86,6 +127,84 @@ static int lenovo_input_mapping_tpkbd(struct hid_device *hdev,
> >> return 0;
> >> }
> >>
> >> +static int lenovo_input_mapping_tpx1cover(struct hid_device *hdev,
> >> + struct hid_input *hi, struct hid_field *field,
> >> + struct hid_usage *usage, unsigned long **bit, int *max)
> >> +{
> >> + if ((usage->hid & HID_USAGE_PAGE) == HID_UP_CONSUMER) {
> >> + switch (usage->hid & HID_USAGE) {
> >> + case 0x0001: // Unknown keys -> Idenditied by usage index!
> >
> > Why don't use directly usage->hid and check for HID_CP_CONSUMERCONTROL (0x000c0001)?
> >
> ok, I will use this.
>
> > Note that here you are working with keys while previously it was LED.
> > Split in 2 patches please.
> >
> ok.
> >
> >> + map_key_clear(KEY_UNKNOWN);
> >
> > why?
> > If the key doesn't seem to be used, please don't map it and return -1.
> >
> ok.
> >> + switch (usage->usage_index) {
> >> + case 0x8:
> >
> > It feels weird to have an hexadecimal representation when dealing with
> > indexes.
> >
> ok.
> >> + input_set_capability(hi->input, EV_KEY, KEY_FN);
> >
> > You should consider using map_key_clear(KEY_FN); instead. This way the
> > event handling code will be cheaper.
> >
> > Rince, wash reapeat in the following cases.
> >
> ok.
> >> + break;
> >> +
> >> + case 0x9:
> >> + input_set_capability(hi->input, EV_KEY, KEY_MICMUTE);
> >> + break;
> >> +
> >> + case 0xa:
> >> + input_set_capability(hi->input, EV_KEY, KEY_CONFIG);
> >> + break;
> >> +
> >> + case 0xb:
> >> + input_set_capability(hi->input, EV_KEY, KEY_SEARCH);
> >> + break;
> >> +
> >> + case 0xc:
> >> + input_set_capability(hi->input, EV_KEY, KEY_SETUP);
> >> + break;
> >> +
> >> + case 0xd:
> >> + input_set_capability(hi->input, EV_KEY, KEY_SWITCHVIDEOMODE);
> >> + break;
> >> +
> >> + case 0xe:
> >> + input_set_capability(hi->input, EV_KEY, KEY_RFKILL);
> >> + break;
> >> +
> >> + default:
> >> + return -1;
> >> + }
> >> +
> >> + return 1;
> >> +
> >> + case 0x006f: // Consumer.006f ---> Key.BrightnessUp
> >> + map_key_clear(KEY_BRIGHTNESSUP);
> >
> > Why are you overriding the existing behavior from hid-input if you are
> > using the same code?
> >
> > Just return 0 and hid-input will set the values for you.
> >
> > Rince, wash repeat for the rest of the cases.
> >
> ok.
> >> + return 1;
> >> +
> >> + case 0x0070: // Consumer.0070 ---> Key.BrightnessDown
> >> + map_key_clear(KEY_BRIGHTNESSDOWN);
> >> + return 1;
> >> +
> >> + case 0x00b7:// Consumer.00b7 ---> Key.StopCD
> >> + map_key_clear(KEY_STOPCD);
> >> + return 1;
> >> +
> >> + case 0x00cd: // Consumer.00cd ---> Key.PlayPause
> >> + map_key_clear(KEY_PLAYPAUSE);
> >> + return 1;
> >> +
> >> + case 0x00e0: // Consumer.00e0 ---> Absolute.Volume
> >> + return 0;
> >> + case 0x00e2: // Consumer.00e2 ---> Key.Mute
> >> + map_key_clear(KEY_MUTE);
> >> + return 1;
> >> +
> >> + case 0x00e9: // Consumer.00e9 ---> Key.VolumeUp
> >> + map_key_clear(KEY_VOLUMEUP);
> >> + return 1;
> >> +
> >> + case 0x00ea: // Consumer.00ea ---> Key.VolumeDown
> >> + map_key_clear(KEY_VOLUMEDOWN);
> >> + return 1;
> >> + }
> >> + }
> >> +
> >> + return 0;
> >> +}
> >> +
> >> static int lenovo_input_mapping_cptkbd(struct hid_device *hdev,
> >> struct hid_input *hi, struct hid_field *field,
> >> struct hid_usage *usage, unsigned long **bit, int *max)
> >> @@ -172,6 +291,9 @@ static int lenovo_input_mapping(struct hid_device *hdev,
> >> case USB_DEVICE_ID_LENOVO_CBTKBD:
> >> return lenovo_input_mapping_cptkbd(hdev, hi, field,
> >> usage, bit, max);
> >> + case USB_DEVICE_ID_LENOVO_X1_COVER:
> >> + return lenovo_input_mapping_tpx1cover(hdev, hi, field,
> >> + usage, bit, max);
> >> default:
> >> return 0;
> >> }
> >> @@ -362,6 +484,143 @@ static int lenovo_event_cptkbd(struct hid_device *hdev,
> >> return 0;
> >> }
> >>
> >> +static enum led_brightness lenovo_led_brightness_get_tpx1cover(
> >> + struct led_classdev *led_cdev)
> >> +{
> >> + struct device *dev = led_cdev->dev->parent;
> >> + struct hid_device *hdev = to_hid_device(dev);
> >> + struct lenovo_drvdata_tpx1cover *drv_data = hid_get_drvdata(hdev);
> >> + int led_nr = 0;
> >
> > Would be even better to use the enum.
> >
> ok.
> >> +
> >> + if (led_cdev == &drv_data->led_mute)
> >> + led_nr = 0;
> >> + else if (led_cdev == &drv_data->led_micmute)
> >> + led_nr = 1;
> >> + else if (led_cdev == &drv_data->led_fnlock)
> >> + led_nr = 2;
> >> + else
> >> + return LED_OFF;
> >> +
> >> + return drv_data->led_state & (1 << led_nr)
> >> + ? LED_FULL
> >> + : LED_OFF;
> >> +}
> >> +
> >> +static void lenovo_led_brightness_set_tpx1cover(struct led_classdev *led_cdev,
> >> + enum led_brightness value)
> >> +{
> >> + struct device *dev = led_cdev->dev->parent;
> >> + struct hid_device *hdev = to_hid_device(dev);
> >> + struct lenovo_drvdata_tpx1cover *drv_data = hid_get_drvdata(hdev);
> >> + struct hid_report *report;
> >> + int led_nr = -1;
> >
> > Likewise, the enum would be nice
> >
> ok.
> >> + int led_nr_hw = -1;
> >> +
> >> + if (led_cdev == &drv_data->led_mute) {
> >> + led_nr = 0;
> >> + led_nr_hw = 0x64;
> >
> > Are you sure you are not overriding bits in 0x44?
> >
> ???
See the comment just below.
It feels weird that you need to have 0x54, 0x64, 0x74 to set an LED. I
wouldn't be surprised if the (constant) 0x44 part is there to set a
different feature of the cover.
However, I might have a wrong view of the protocol and using those plain
values are probably enough (and maybe the firmware uses 0x44 as the flag
that you are working with LEDs).
> > If you reorder the enum, I'd say the led_nr_hw could be represented as:
> > ((led_nr + 1) << 4) | 0x44
> >
> > So I think this is too much to be just a coincidence.
> >
> ok.
> >> + } else if (led_cdev == &drv_data->led_micmute) {
> >> + led_nr = 1;
> >> + led_nr_hw = 0x74;
> >> + } else if (led_cdev == &drv_data->led_fnlock) {
> >> + led_nr = 2;
> >> + led_nr_hw = 0x54;
> >> + } else {
> >> + hid_warn(hdev, "Invalid LED to set.\n");
> >> + return;
> >> + }
> >> +
> >> + if (value == LED_OFF)
> >> + drv_data->led_state &= ~(1 << led_nr);
> >> + else
> >> + drv_data->led_state |= 1 << led_nr;
> >> +
> >> + report = hdev->report_enum[HID_OUTPUT_REPORT].report_id_hash[9];
> >> + if (report) {
> >> + report->field[0]->value[0] = led_nr_hw;
> >> + report->field[0]->value[1] = (drv_data->led_state & (1 << led_nr))
> >> + ? 0x02 : 0x01;
> >> + hid_hw_request(hdev, report, HID_REQ_SET_REPORT);
> >> + }
> >> +}
> >> +
> >> +static int lenovo_event_tpx1cover(struct hid_device *hdev,
> >> + struct hid_field *field, struct hid_usage *usage, __s32 value)
> >> +{
> >> + int ret = 0;
> >> +
> >> + if ((usage->hid & HID_USAGE_PAGE) == HID_UP_CONSUMER
> >> + && (usage->hid & HID_USAGE) == 0x0001) {
> >> +
> >> + if (usage->usage_index == 0x8 && value == 1) {
> >> + struct lenovo_drvdata_tpx1cover *drv_data = hid_get_drvdata(hdev);
> >> +
> >> + if (drv_data && drv_data->led_present) {
> >> + drv_data->fnlock_state = lenovo_led_brightness_get_tpx1cover(
> >> + &drv_data->led_fnlock) == LED_OFF ? 1 : 0;
> >> + lenovo_led_brightness_set_tpx1cover(
> >> + &drv_data->led_fnlock,
> >> + drv_data->fnlock_state ? LED_FULL : LED_OFF);
> >> + }
> >
> > This looks like a different semantic change where you sync the actual LED with the incoming event.
> > This is not something we usually do from the kernel but rely on the
> > userspace to do it for us. Not sure about the FN lock state though.
> >
> In case of X1 Tablet the fn lock state and the fn lock led state is the
> same. You can only change the fn lock while changing the fn lock led
> state. I will check if it behaves different if I map KEY_FN appropriate.
> > Anyway, if this needs to be there, it should have its own patch
> >
> ok. I will double check if this is relly needed. If so I will put in
> into a separate patch.
Thanks.
> >> + }
> >> +
> >> + if (usage->usage_index == 0x9 && value == 1) {
> >> + input_event(field->hidinput->input, EV_KEY, KEY_MICMUTE, 1);
> >> + input_sync(field->hidinput->input);
> >> + input_event(field->hidinput->input, EV_KEY, KEY_MICMUTE, 0);
> >> + input_sync(field->hidinput->input);
> >> + ret = 1;
> >
> > Aren't you notified when the key is released?
> >
> Does map_key_clear work if a key can only identified by
> usage->usage_index and not by usage->hid? If yes, I can remove this.
Basically, when you have usage_index > 0, that means that the report
descriptor is declaring more than one field with the same usage in a
row. Given that you should use map_key_clear, you are mapping the HID
usage (the element in the array) to a KEY_* value and you should be
fine.
Consider that each field in the report gets assigned its own usage, and
usage->page, usage->usage and usage->usage_index are just a description
of the usage.
> Otherwise I have to track the previously pressed keys to not issue a key
> release of every special key each time one special key is pressed/released.
Just give a shot at it, but I am pretty confident it will work.
> > If so, you should just drop the change because you used map_key_clear
> > above and hid-input will simply do the right thing for you.
> >
> > If you are not notified, this is big enough a difference to have its own
> > patch.
> >
> > Rince wash repeat
> >
> >> + }
> >> +
> >> + if (usage->usage_index == 0xa && value == 1) {
> >> + input_event(field->hidinput->input, EV_KEY, KEY_CONFIG, 1);
> >> + input_sync(field->hidinput->input);
> >> + input_event(field->hidinput->input, EV_KEY, KEY_CONFIG, 0);
> >> + input_sync(field->hidinput->input);
> >> +
> >> + ret = 1;
> >> + }
> >> +
> >> + if (usage->usage_index == 0xb && value == 1) {
> >> + input_event(field->hidinput->input, EV_KEY, KEY_SEARCH, 1);
> >> + input_sync(field->hidinput->input);
> >> + input_event(field->hidinput->input, EV_KEY, KEY_SEARCH, 0);
> >> + input_sync(field->hidinput->input);
> >> +
> >> + ret = 1;
> >> + }
> >> +
> >> + if (usage->usage_index == 0xc && value == 1) {
> >> + input_event(field->hidinput->input, EV_KEY, KEY_SETUP, 1);
> >> + input_sync(field->hidinput->input);
> >> + input_event(field->hidinput->input, EV_KEY, KEY_SETUP, 0);
> >> + input_sync(field->hidinput->input);
> >> +
> >> + ret = 1;
> >> + }
> >> +
> >> + if (usage->usage_index == 0xd && value == 1) {
> >> + input_event(field->hidinput->input, EV_KEY, KEY_SWITCHVIDEOMODE, 1);
> >> + input_sync(field->hidinput->input);
> >> + input_event(field->hidinput->input, EV_KEY, KEY_SWITCHVIDEOMODE, 0);
> >> + input_sync(field->hidinput->input);
> >> +
> >> + ret = 1;
> >> + }
> >> +
> >> + if (usage->usage_index == 0xe && value == 1) {
> >> + input_event(field->hidinput->input, EV_KEY, KEY_RFKILL, 1);
> >> + input_sync(field->hidinput->input);
> >> + input_event(field->hidinput->input, EV_KEY, KEY_RFKILL, 0);
> >> + input_sync(field->hidinput->input);
> >> +
> >> + ret = 1;
> >> + }
> >> + }
> >> +
> >> + return ret;
> >> +}
> >> +
> >> static int lenovo_event(struct hid_device *hdev, struct hid_field *field,
> >> struct hid_usage *usage, __s32 value)
> >> {
> >> @@ -369,6 +628,8 @@ static int lenovo_event(struct hid_device *hdev, struct hid_field *field,
> >> case USB_DEVICE_ID_LENOVO_CUSBKBD:
> >> case USB_DEVICE_ID_LENOVO_CBTKBD:
> >> return lenovo_event_cptkbd(hdev, field, usage, value);
> >> + case USB_DEVICE_ID_LENOVO_X1_COVER:
> >> + return lenovo_event_tpx1cover(hdev, field, usage, value);
> >> default:
> >> return 0;
> >> }
> >> @@ -731,6 +992,251 @@ static int lenovo_probe_tpkbd(struct hid_device *hdev)
> >> return ret;
> >> }
> >>
> >> +static int lenovo_probe_tpx1cover_configure(struct hid_device *hdev)
> >> +{
> >> + struct hid_report *report = hdev->report_enum[HID_OUTPUT_REPORT].report_id_hash[9];
> >> + struct lenovo_drvdata_tpx1cover *drv_data = hid_get_drvdata(hdev);
> >> +
> >> + if (!drv_data)
> >> + return -ENODEV;
> >
> > Can this really happen?
> >
> I will remove this.
That was really a question, please make sure drv_data can't be null.
> >> +
> >> + if (!report)
> >> + return -ENOENT;
> >> +
> >> + report->field[0]->value[0] = 0x54;
> >> + report->field[0]->value[1] = 0x20;
> >> + hid_hw_request(hdev, report, HID_REQ_SET_REPORT);
> >> + hid_hw_wait(hdev);
> >> +
> >> + report->field[0]->value[0] = 0x54;
> >> + report->field[0]->value[1] = 0x08;
> >> + hid_hw_request(hdev, report, HID_REQ_SET_REPORT);
> >> + hid_hw_wait(hdev);
> >> +
> >> + report->field[0]->value[0] = 0xA0;
> >> + report->field[0]->value[1] = 0x02;
> >> + hid_hw_request(hdev, report, HID_REQ_SET_REPORT);
> >> + hid_hw_wait(hdev);
> >> +
> >> + lenovo_led_brightness_set_tpx1cover(&drv_data->led_mute,
> >> + hid_lenovo_led_table[HID_LENOVO_LED_MUTE].state ? LED_FULL : LED_OFF);
> >> + hid_hw_wait(hdev);
> >> +
> >> + lenovo_led_brightness_set_tpx1cover(&drv_data->led_micmute,
> >> + hid_lenovo_led_table[HID_LENOVO_LED_MICMUTE].state ? LED_FULL : LED_OFF);
> >> + hid_hw_wait(hdev);
> >> +
> >> + lenovo_led_brightness_set_tpx1cover(&drv_data->led_fnlock, LED_FULL);
> >> +
> >> + return 0;
> >> +}
> >> +
> >> +static int lenovo_probe_tpx1cover_special_functions(struct hid_device *hdev)
> >> +{
> >> + struct device *dev = &hdev->dev;
> >> + struct lenovo_drvdata_tpx1cover *drv_data = NULL;
> >> +
> >> + size_t name_sz = strlen(dev_name(dev)) + 16;
> >> + char *name_led = NULL;
> >> +
> >> + struct hid_report *report;
> >> + bool report_match = 1;
> >> +
> >> + int ret = 0;
> >> +
> >> + report = hid_validate_values(hdev, HID_INPUT_REPORT, 2, 0, 3);
> >> + report_match &= report ? 1 : 0;
> >> + report = hid_validate_values(hdev, HID_INPUT_REPORT, 3, 0, 16);
> >> + report_match &= report ? 1 : 0;
> >> + report = hid_validate_values(hdev, HID_OUTPUT_REPORT, 9, 0, 2);
> >> + report_match &= report ? 1 : 0;
> >> + report = hid_validate_values(hdev, HID_FEATURE_REPORT, 32, 0, 1);
> >> + report_match &= report ? 1 : 0;
> >> + report = hid_validate_values(hdev, HID_FEATURE_REPORT, 84, 0, 1);
> >> + report_match &= report ? 1 : 0;
> >> + report = hid_validate_values(hdev, HID_FEATURE_REPORT, 100, 0, 1);
> >> + report_match &= report ? 1 : 0;
> >> + report = hid_validate_values(hdev, HID_FEATURE_REPORT, 116, 0, 1);
> >> + report_match &= report ? 1 : 0;
> >> + report = hid_validate_values(hdev, HID_FEATURE_REPORT, 132, 0, 1);
> >> + report_match &= report ? 1 : 0;
> >> + report = hid_validate_values(hdev, HID_FEATURE_REPORT, 144, 0, 1);
> >> + report_match &= report ? 1 : 0;
> >> + report = hid_validate_values(hdev, HID_FEATURE_REPORT, 162, 0, 1);
> >> + report_match &= report ? 1 : 0;
> >
> > It feels weird to have you check if those reports are actually long
> > enough. I think this is related to checking which interface you have,
> > but you should be able to reduce the list to only those you are actually
> > using (report id "9" seems like a good candidate).
> >
> Yes, its related to select the USB Interface. I queried all existing
> reports of Interface 1 here. I will reduce this list but report id 9 is
> not sufficient because IF2 has report id 9 too. So I will add one other
> report id which enables a clear decision.
> > And please add a comment why you are checking some specific report IDs.
> >
> ok.
> >> +
> >> + if (!report_match) {
> >> + ret = -ENODEV;
> >> + goto err;
> >
> > just return -ENODEV here.
> >
> ok.
> >> + }
> >> +
> >> + drv_data = devm_kzalloc(&hdev->dev,
> >> + sizeof(struct lenovo_drvdata_tpx1cover),
> >> + GFP_KERNEL);
> >> +
> >> + if (!drv_data) {
> >> + hid_err(hdev,
> >> + "Could not allocate memory for tpx1cover driver data\n");
> >> + ret = -ENOMEM;
> >> + goto err;
> >
> > Just return -ENODEV too, the devres manager will kfree drv_data for you.
> >
> ok.
> >> + }
> >> +
> >> + name_led = devm_kzalloc(&hdev->dev, name_sz, GFP_KERNEL);
> >> + if (!name_led) {
> >> + hid_err(hdev, "Could not allocate memory for mute led data\n");
> >> + ret = -ENOMEM;
> >> + goto err_cleanup;
> >
> > likewise
> >
> ok.
> >> + }
> >> + snprintf(name_led, name_sz, "%s:amber:mute", dev_name(dev));
> >> +
> >> + drv_data->led_mute.name = name_led;
> >> + drv_data->led_mute.brightness_get = lenovo_led_brightness_get_tpx1cover;
> >> + drv_data->led_mute.brightness_set = lenovo_led_brightness_set_tpx1cover;
> >> + drv_data->led_mute.dev = dev;
> >> + hid_lenovo_led_table[HID_LENOVO_LED_MUTE].dev = &drv_data->led_mute;
> >> + led_classdev_register(dev, &drv_data->led_mute);
> >
> > Isn't devm_led_class_register working?
> >
> > That would be nice because you could drop all of your cleanup paths
> >
> Ah, ok, didn't know that function until yet.
I *think* it should be fine to use it with hid->dev. If you use it with
input->dev, that won't do and you'll need to do some weird things to
remove the LED device (sadly that's what I had to do in the wacom
driver).
Just make sure /sys/class/leds/ doesn't contain a dangling LED device
when you remove the cover and you should know if this worked or not.
Cheers,
Benjamin
> >> +
> >> +
> >> + name_led = devm_kzalloc(&hdev->dev, name_sz, GFP_KERNEL);
> >> + if (!name_led) {
> >> + hid_err(hdev,
> >> + "Could not allocate memory for mic mute led data\n");
> >> + ret = -ENOMEM;
> >> + goto err_cleanup;
> >
> > ditto
> >
> ok.
> >> + }
> >> + snprintf(name_led, name_sz, "%s:amber:micmute", dev_name(dev));
> >> +
> >> + drv_data->led_micmute.name = name_led;
> >> + drv_data->led_micmute.brightness_get = lenovo_led_brightness_get_tpx1cover;
> >> + drv_data->led_micmute.brightness_set = lenovo_led_brightness_set_tpx1cover;
> >> + drv_data->led_micmute.dev = dev;
> >> + hid_lenovo_led_table[HID_LENOVO_LED_MICMUTE].dev = &drv_data->led_micmute;
> >> + led_classdev_register(dev, &drv_data->led_micmute);
> >> +
> >> +
> >> + name_led = devm_kzalloc(&hdev->dev, name_sz, GFP_KERNEL);
> >> + if (!name_led) {
> >> + hid_err(hdev,
> >> + "Could not allocate memory for FN lock led data\n");
> >> + ret = -ENOMEM;
> >> + goto err_cleanup;
> >
> > ditto
> >
> ok.
> >> + }
> >> +
> >> + snprintf(name_led, name_sz, "%s:amber:fnlock", dev_name(dev));
> >> +
> >> + drv_data->led_fnlock.name = name_led;
> >> + drv_data->led_fnlock.brightness_get = lenovo_led_brightness_get_tpx1cover;
> >> + drv_data->led_fnlock.brightness_set = lenovo_led_brightness_set_tpx1cover;
> >> + drv_data->led_fnlock.dev = dev;
> >> + hid_lenovo_led_table[HID_LENOVO_LED_FNLOCK].dev = &drv_data->led_fnlock;
> >> + led_classdev_register(dev, &drv_data->led_fnlock);
> >
> > ditto
> >
> ok.
> >> +
> >> + drv_data->led_state = 0;
> >> + drv_data->fnlock_state = 1;
> >> + drv_data->led_present = 1;
> >> +
> >> + hid_set_drvdata(hdev, drv_data);
> >> +
> >> + return lenovo_probe_tpx1cover_configure(hdev);
> >> +
> >> +err_cleanup:
> >
> > Shouldn't be required if you use devm_led_classdev_register().
> >
> ok.
> >> + if (drv_data->led_fnlock.name) {
> >> + led_classdev_unregister(&drv_data->led_fnlock);
> >> + devm_kfree(&hdev->dev, (void *) drv_data->led_fnlock.name);
> >> + }
> >> +
> >> + if (drv_data->led_micmute.name) {
> >> + led_classdev_unregister(&drv_data->led_micmute);
> >> + devm_kfree(&hdev->dev, (void *) drv_data->led_micmute.name);
> >> + }
> >> +
> >> + if (drv_data->led_mute.name) {
> >> + led_classdev_unregister(&drv_data->led_mute);
> >> + devm_kfree(&hdev->dev, (void *) drv_data->led_mute.name);
> >> + }
> >> +
> >> + if (drv_data)
> >> + kfree(drv_data);
> >> +
> >> +err:
> >> + return ret;
> >> +}
> >> +
> >> +static int lenovo_probe_tpx1cover_touch(struct hid_device *hdev)
> >> +{
> >> + struct hid_report *report;
> >> + bool report_match = 1;
> >> + int ret = 0;
> >> +
> >> + report = hid_validate_values(hdev, HID_INPUT_REPORT, 2, 0, 2);
> >> + report_match &= report ? 1 : 0;
> >> + report = hid_validate_values(hdev, HID_INPUT_REPORT, 2, 1, 2);
> >> + report_match &= report ? 1 : 0;
> >> + report = hid_validate_values(hdev, HID_INPUT_REPORT, 11, 0, 61);
> >> + report_match &= report ? 1 : 0;
> >> + report = hid_validate_values(hdev, HID_INPUT_REPORT, 12, 0, 61);
> >> + report_match &= report ? 1 : 0;
> >> + report = hid_validate_values(hdev, HID_INPUT_REPORT, 16, 0, 3);
> >> + report_match &= report ? 1 : 0;
> >> + report = hid_validate_values(hdev, HID_INPUT_REPORT, 16, 1, 2);
> >> + report_match &= report ? 1 : 0;
> >> + report = hid_validate_values(hdev, HID_OUTPUT_REPORT, 9, 0, 20);
> >> + report_match &= report ? 1 : 0;
> >> + report = hid_validate_values(hdev, HID_OUTPUT_REPORT, 10, 0, 20);
> >> + report_match &= report ? 1 : 0;
> >> + report = hid_validate_values(hdev, HID_FEATURE_REPORT, 14, 0, 1);
> >> + report_match &= report ? 1 : 0;
> >> + report = hid_validate_values(hdev, HID_FEATURE_REPORT, 15, 0, 3);
> >> + report_match &= report ? 1 : 0;
> >
> > Feels weird too (especially if there is no comment explaining why you
> > are doing those checks).
> >
> ok.
> >> +
> >> + if (!report_match)
> >> + ret = -ENODEV;
> >> +
> >> + return ret;
> >> +}
> >> +
> >> +static int lenovo_probe_tpx1cover(struct hid_device *hdev)
> >> +{
> >> + int ret = 0;
> >> +
> >> + /*
> >> + * Probing for special function keys and LED control -> usb intf 1
> >> + * Probing for touch input -> usb intf 2 (handled by rmi4 driver)
> >> + * Other (keyboard) -> usb intf 0
> >> + */
> >> + if (!lenovo_probe_tpx1cover_special_functions(hdev)) {
> >> + // special function keys and LED control
> >
> > No C++ style comments please.
> >
> Oops
> >> + ret = 0;
> >> + } else if (!lenovo_probe_tpx1cover_touch(hdev)) {
> >> + // handled by rmi
> >> + ret = -ENODEV;
> >
> > I don't quite get how the touch can be handled if you just return
> > -ENODEV here. Given that the device has been added to
> > hid_have_special_driver, if you don't claim the device, no one else will
> > unless you add the ID in the other HID driver.
> >
> Yes, ok. This is because I have some additional RMI4 code which handles
> the touch. At the current upstream situation I should return 0 here such
> that this touch works basically.
> >> + } else {
> >> + // keyboard
> >
> > Why is that keyboard chunk not given it's own probe function?
> >
> Because it is just a few lines:) I will add a probe function.
> >> + struct lenovo_drvdata_tpx1cover *drv_data;
> >> +
> >> + drv_data = devm_kzalloc(&hdev->dev,
> >> + sizeof(struct lenovo_drvdata_tpx1cover),
> >> + GFP_KERNEL);
> >> +
> >> + if (!drv_data) {
> >> + hid_err(hdev,
> >> + "Could not allocate memory for tpx1cover driver data\n");
> >> + ret = -ENOMEM;
> >> + goto out;
> >
> > no need for a goto here. Just a plain return -ENOMEM should be good
> > enough.
> >
> ok
> >> + }
> >> +
> >> + drv_data->led_state = 0;
> >> + drv_data->led_present = 0;
> >> + drv_data->fnlock_state = 0;
> >> + hid_set_drvdata(hdev, drv_data);
> >> +
> >> + ret = 0;
> >> + }
> >> +
> >> +out:
> >> + return ret;
> >> +}
> >> +
> >> static int lenovo_probe_cptkbd(struct hid_device *hdev)
> >> {
> >> int ret;
> >> @@ -803,6 +1309,9 @@ static int lenovo_probe(struct hid_device *hdev,
> >> case USB_DEVICE_ID_LENOVO_CBTKBD:
> >> ret = lenovo_probe_cptkbd(hdev);
> >> break;
> >> + case USB_DEVICE_ID_LENOVO_X1_COVER:
> >> + ret = lenovo_probe_tpx1cover(hdev);
> >> + break;
> >> default:
> >> ret = 0;
> >> break;
> >> @@ -843,6 +1352,42 @@ static void lenovo_remove_cptkbd(struct hid_device *hdev)
> >> &lenovo_attr_group_cptkbd);
> >> }
> >>
> >> +static void lenovo_remove_tpx1cover(struct hid_device *hdev)
> >> +{
> >> + struct lenovo_drvdata_tpx1cover *drv_data = hid_get_drvdata(hdev);
> >> +
> >> + if (!drv_data)
> >> + return;
> >> +
> >> + if (drv_data->led_present) {
> >> + if (drv_data->led_fnlock.name) {
> >> + hid_lenovo_led_table[HID_LENOVO_LED_FNLOCK].dev = NULL;
> >> +
> >> + led_classdev_unregister(&drv_data->led_fnlock);
> >> + devm_kfree(&hdev->dev, (void *) drv_data->led_fnlock.name);
> >
> > Calling yourself devm_kfree usually means there is something wrong.
> > Here, if you used devm_led_*, you could just drop the entire remove
> > function.
> >
> ok.
> >> + }
> >> +
> >> + if (drv_data->led_micmute.name) {
> >> + hid_lenovo_led_table[HID_LENOVO_LED_MICMUTE].dev = NULL;
> >> +
> >> + led_classdev_unregister(&drv_data->led_micmute);
> >> + devm_kfree(&hdev->dev, (void *) drv_data->led_micmute.name);
> >> + }
> >> +
> >> + if (drv_data->led_mute.name) {
> >> + hid_lenovo_led_table[HID_LENOVO_LED_MUTE].dev = NULL;
> >> +
> >> + led_classdev_unregister(&drv_data->led_mute);
> >> + devm_kfree(&hdev->dev, (void *) drv_data->led_mute.name);
> >> + }
> >> + }
> >> +
> >> + if (drv_data)
> >> + devm_kfree(&hdev->dev, drv_data);
> >> +
> >> + hid_set_drvdata(hdev, NULL);
> >> +}
> >> +
> >> static void lenovo_remove(struct hid_device *hdev)
> >> {
> >> switch (hdev->product) {
> >> @@ -853,6 +1398,9 @@ static void lenovo_remove(struct hid_device *hdev)
> >> case USB_DEVICE_ID_LENOVO_CBTKBD:
> >> lenovo_remove_cptkbd(hdev);
> >> break;
> >> + case USB_DEVICE_ID_LENOVO_X1_COVER:
> >> + lenovo_remove_tpx1cover(hdev);
> >> + break;
> >> }
> >>
> >> hid_hw_stop(hdev);
> >> @@ -883,6 +1431,7 @@ static int lenovo_input_configured(struct hid_device *hdev,
> >> { HID_USB_DEVICE(USB_VENDOR_ID_LENOVO, USB_DEVICE_ID_LENOVO_CUSBKBD) },
> >> { HID_BLUETOOTH_DEVICE(USB_VENDOR_ID_LENOVO, USB_DEVICE_ID_LENOVO_CBTKBD) },
> >> { HID_USB_DEVICE(USB_VENDOR_ID_LENOVO, USB_DEVICE_ID_LENOVO_TPPRODOCK) },
> >> + { HID_USB_DEVICE(USB_VENDOR_ID_LENOVO, USB_DEVICE_ID_LENOVO_X1_COVER) },
> >> { }
> >> };
> >>
> >> diff --git a/include/linux/hid-lenovo.h b/include/linux/hid-lenovo.h
> >> new file mode 100644
> >> index 0000000..d0b0145
> >> --- /dev/null
> >> +++ b/include/linux/hid-lenovo.h
> >> @@ -0,0 +1,15 @@
> >> +
> >> +#ifndef __HID_LENOVO_H__
> >> +#define __HID_LENOVO_H__
> >> +
> >> +
> >> +enum {
> >> + HID_LENOVO_LED_MUTE,
> >
> > I'd rather have a name for the enum (so you can reuse it), and also have
> > each enum given its numerical value (or at least the first and last.
> >
> ok.
> >> + HID_LENOVO_LED_MICMUTE,
> >> + HID_LENOVO_LED_FNLOCK,
> >> + HID_LENOVO_LED_MAX,
> >> +};
> >> +
> >> +int hid_lenovo_led_set(int led_num, bool on);
> >> +
> >> +#endif /* __HID_LENOVO_H_ */
> >> --
> >> 1.i9.1
> >
> >
> > Cheers,
> > Benjamin
> >
More information about the Alsa-devel
mailing list