platform/x86: Add driver for Yoga Tablet Mode switch
authorGergo Koteles <soyer@irl.hu>
Wed, 29 Mar 2023 01:45:59 +0000 (18:45 -0700)
committerHans de Goede <hdegoede@redhat.com>
Thu, 6 Apr 2023 10:33:34 +0000 (12:33 +0200)
This WMI driver for the tablet mode control switch for Lenovo Yoga
notebooks was originally written by Gergo Koteles. The mode is mapped to
a SW_TABLET_MODE switch capable input device.

Andrew followed the suggestions that were posted in reply to Gergo's RFC
patch, and on the v1 & v2 versions of this patch to follow-up and get it
merged.

Changes from Gergo's RFC:

 - Refactored obtaining a reference to the EC ACPI device needed for the
   quirk implementation as suggested by Hans de Goede
 - Applied small fixes and switched to always registering handles with
   the driver for automatic cleanup as suggested by Barnabás Pőcze.
 - Merged the lenovo_ymc_trigger_ec function with the
   ideapad_trigger_ymc_next_read function since it was no longer
   external.
 - Added the word "Tablet" to the driver description to hopefully make
   it more clear.
 - Fixed the LENOVO_YMC_QUERY_METHOD ID and the name string for the EC
   APCI device trigged for the quirk
 - Triggered the input event on probe so that the initial tablet mode
   state when the driver is loaded is reported to userspace as suggested
   by Armin Wolf.
 - Restricted the permissions of the ec_trigger parameter as suggested
   by Armin Wolf. Also updated the description.

We have tested this on the Yoga 7 14AIL7 for the non-quirk path and on
the Yoga 7 14ARB7 which has the firmware bug that requires triggering
the embedded controller to send the mode change events. This workaround
is also used by the Windows drivers.

According to reports at https://github.com/lukas-w/yoga-usage-mode,
which uses the same WMI devices, the following models should also work:
Yoga C940, Ideapad flex 14API, Yoga 9 14IAP7, Yoga 7 14ARB7, etc.

Signed-off-by: Gergo Koteles <soyer@irl.hu>
Co-developed-by: Andrew Kallmeyer <kallmeyeras@gmail.com>
Signed-off-by: Andrew Kallmeyer <kallmeyeras@gmail.com>
Link: https://lore.kernel.org/r/20221004214332.35934-1-soyer@irl.hu/
Link: https://lore.kernel.org/r/20230310041726.217447-1-kallmeyeras@gmail.com/
Link: https://lore.kernel.org/r/20230323025200.5462-1-kallmeyeras@gmail.com/
Tested-by: André Apitzsch <git@apitzsch.eu>
Link: https://lore.kernel.org/r/20230329014559.44494-3-kallmeyeras@gmail.com
Reviewed-by: Hans de Goede <hdegoede@redhat.com>
Signed-off-by: Hans de Goede <hdegoede@redhat.com>
drivers/platform/x86/Kconfig
drivers/platform/x86/Makefile
drivers/platform/x86/ideapad-laptop.h
drivers/platform/x86/lenovo-ymc.c [new file with mode: 0644]

index 1899be67dc0c8493c98eb0e0fb93a81ad5b3bc74..22052031c7190097996f778197733a4bf9ad7165 100644 (file)
@@ -461,6 +461,15 @@ config IDEAPAD_LAPTOP
          This is a driver for Lenovo IdeaPad netbooks contains drivers for
          rfkill switch, hotkey, fan control and backlight control.
 
+config LENOVO_YMC
+       tristate "Lenovo Yoga Tablet Mode Control"
+       depends on ACPI_WMI
+       depends on INPUT
+       select INPUT_SPARSEKMAP
+       help
+         This driver maps the Tablet Mode Control switch to SW_TABLET_MODE input
+         events for Lenovo Yoga notebooks.
+
 config SENSORS_HDAPS
        tristate "Thinkpad Hard Drive Active Protection System (hdaps)"
        depends on INPUT
index 27550cf6d4fbcdd32f71f4d9e26a760821c67654..2cafe51ec4d8e87b4dcbba093fca42ce8425ecee 100644 (file)
@@ -62,6 +62,7 @@ obj-$(CONFIG_UV_SYSFS)       += uv_sysfs.o
 # IBM Thinkpad and Lenovo
 obj-$(CONFIG_IBM_RTL)          += ibm_rtl.o
 obj-$(CONFIG_IDEAPAD_LAPTOP)   += ideapad-laptop.o
+obj-$(CONFIG_LENOVO_YMC)       += lenovo-ymc.o
 obj-$(CONFIG_SENSORS_HDAPS)    += hdaps.o
 obj-$(CONFIG_THINKPAD_ACPI)    += thinkpad_acpi.o
 obj-$(CONFIG_THINKPAD_LMI)     += think-lmi.o
index a99664725770585f06243d1cb666e26e840328e9..4498a96de59769e7ed9db5e021b3ed856a121a62 100644 (file)
@@ -35,6 +35,7 @@ enum {
        VPCCMD_W_FAN,
        VPCCMD_R_RF,
        VPCCMD_W_RF,
+       VPCCMD_W_YMC = 0x2A,
        VPCCMD_R_FAN = 0x2B,
        VPCCMD_R_SPECIAL_BUTTONS = 0x31,
        VPCCMD_W_BL_POWER = 0x33,
diff --git a/drivers/platform/x86/lenovo-ymc.c b/drivers/platform/x86/lenovo-ymc.c
new file mode 100644 (file)
index 0000000..4167618
--- /dev/null
@@ -0,0 +1,187 @@
+// SPDX-License-Identifier: GPL-2.0-or-later
+/*
+ * lenovo-ymc.c - Lenovo Yoga Mode Control driver
+ *
+ * Copyright © 2022 Gergo Koteles <soyer@irl.hu>
+ */
+
+#define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
+
+#include <linux/acpi.h>
+#include <linux/dmi.h>
+#include <linux/input.h>
+#include <linux/input/sparse-keymap.h>
+#include <linux/wmi.h>
+#include "ideapad-laptop.h"
+
+#define LENOVO_YMC_EVENT_GUID  "06129D99-6083-4164-81AD-F092F9D773A6"
+#define LENOVO_YMC_QUERY_GUID  "09B0EE6E-C3FD-4243-8DA1-7911FF80BB8C"
+
+#define LENOVO_YMC_QUERY_INSTANCE 0
+#define LENOVO_YMC_QUERY_METHOD 0x01
+
+static bool ec_trigger __read_mostly;
+module_param(ec_trigger, bool, 0444);
+MODULE_PARM_DESC(ec_trigger, "Enable EC triggering work-around to force emitting tablet mode events");
+
+static const struct dmi_system_id ec_trigger_quirk_dmi_table[] = {
+       {
+               /* Lenovo Yoga 7 14ARB7 */
+               .matches = {
+                       DMI_MATCH(DMI_SYS_VENDOR, "LENOVO"),
+                       DMI_MATCH(DMI_PRODUCT_NAME, "82QF"),
+               },
+       },
+       { }
+};
+
+struct lenovo_ymc_private {
+       struct input_dev *input_dev;
+       struct acpi_device *ec_acpi_dev;
+};
+
+static void lenovo_ymc_trigger_ec(struct wmi_device *wdev, struct lenovo_ymc_private *priv)
+{
+       int err;
+
+       if (!priv->ec_acpi_dev)
+               return;
+
+       err = write_ec_cmd(priv->ec_acpi_dev->handle, VPCCMD_W_YMC, 1);
+       if (err)
+               dev_warn(&wdev->dev, "Could not write YMC: %d\n", err);
+}
+
+static const struct key_entry lenovo_ymc_keymap[] = {
+       /* Laptop */
+       { KE_SW, 0x01, { .sw = { SW_TABLET_MODE, 0 } } },
+       /* Tablet */
+       { KE_SW, 0x02, { .sw = { SW_TABLET_MODE, 1 } } },
+       /* Drawing Board */
+       { KE_SW, 0x03, { .sw = { SW_TABLET_MODE, 1 } } },
+       /* Tent */
+       { KE_SW, 0x04, { .sw = { SW_TABLET_MODE, 1 } } },
+       { KE_END },
+};
+
+static void lenovo_ymc_notify(struct wmi_device *wdev, union acpi_object *data)
+{
+       struct lenovo_ymc_private *priv = dev_get_drvdata(&wdev->dev);
+       u32 input_val = 0;
+       struct acpi_buffer input = { sizeof(input_val), &input_val };
+       struct acpi_buffer output = { ACPI_ALLOCATE_BUFFER, NULL };
+       union acpi_object *obj;
+       acpi_status status;
+       int code;
+
+       status = wmi_evaluate_method(LENOVO_YMC_QUERY_GUID,
+                               LENOVO_YMC_QUERY_INSTANCE,
+                               LENOVO_YMC_QUERY_METHOD,
+                               &input, &output);
+
+       if (ACPI_FAILURE(status)) {
+               dev_warn(&wdev->dev,
+                       "Failed to evaluate query method: %s\n",
+                       acpi_format_exception(status));
+               return;
+       }
+
+       obj = output.pointer;
+
+       if (obj->type != ACPI_TYPE_INTEGER) {
+               dev_warn(&wdev->dev,
+                       "WMI event data is not an integer\n");
+               goto free_obj;
+       }
+       code = obj->integer.value;
+
+       if (!sparse_keymap_report_event(priv->input_dev, code, 1, true))
+               dev_warn(&wdev->dev, "Unknown key %d pressed\n", code);
+
+free_obj:
+       kfree(obj);
+       lenovo_ymc_trigger_ec(wdev, priv);
+}
+
+static void acpi_dev_put_helper(void *p) { acpi_dev_put(p); }
+
+static int lenovo_ymc_probe(struct wmi_device *wdev, const void *ctx)
+{
+       struct lenovo_ymc_private *priv;
+       struct input_dev *input_dev;
+       int err;
+
+       ec_trigger |= dmi_check_system(ec_trigger_quirk_dmi_table);
+
+       priv = devm_kzalloc(&wdev->dev, sizeof(*priv), GFP_KERNEL);
+       if (!priv)
+               return -ENOMEM;
+
+       if (ec_trigger) {
+               pr_debug("Lenovo YMC enable EC triggering.\n");
+               priv->ec_acpi_dev = acpi_dev_get_first_match_dev("VPC2004", NULL, -1);
+
+               if (!priv->ec_acpi_dev) {
+                       dev_err(&wdev->dev, "Could not find EC ACPI device.\n");
+                       return -ENODEV;
+               }
+               err = devm_add_action_or_reset(&wdev->dev,
+                               acpi_dev_put_helper, priv->ec_acpi_dev);
+               if (err) {
+                       dev_err(&wdev->dev,
+                               "Could not clean up EC ACPI device: %d\n", err);
+                       return err;
+               }
+       }
+
+       input_dev = devm_input_allocate_device(&wdev->dev);
+       if (!input_dev)
+               return -ENOMEM;
+
+       input_dev->name = "Lenovo Yoga Tablet Mode Control switch";
+       input_dev->phys = LENOVO_YMC_EVENT_GUID "/input0";
+       input_dev->id.bustype = BUS_HOST;
+       input_dev->dev.parent = &wdev->dev;
+       err = sparse_keymap_setup(input_dev, lenovo_ymc_keymap, NULL);
+       if (err) {
+               dev_err(&wdev->dev,
+                       "Could not set up input device keymap: %d\n", err);
+               return err;
+       }
+
+       err = input_register_device(input_dev);
+       if (err) {
+               dev_err(&wdev->dev,
+                       "Could not register input device: %d\n", err);
+               return err;
+       }
+
+       priv->input_dev = input_dev;
+       dev_set_drvdata(&wdev->dev, priv);
+
+       /* Report the state for the first time on probe */
+       lenovo_ymc_trigger_ec(wdev, priv);
+       lenovo_ymc_notify(wdev, NULL);
+       return 0;
+}
+
+static const struct wmi_device_id lenovo_ymc_wmi_id_table[] = {
+       { .guid_string = LENOVO_YMC_EVENT_GUID },
+       { }
+};
+MODULE_DEVICE_TABLE(wmi, lenovo_ymc_wmi_id_table);
+
+static struct wmi_driver lenovo_ymc_driver = {
+       .driver = {
+               .name = "lenovo-ymc",
+       },
+       .id_table = lenovo_ymc_wmi_id_table,
+       .probe = lenovo_ymc_probe,
+       .notify = lenovo_ymc_notify,
+};
+
+module_wmi_driver(lenovo_ymc_driver);
+
+MODULE_AUTHOR("Gergo Koteles <soyer@irl.hu>");
+MODULE_DESCRIPTION("Lenovo Yoga Mode Control driver");
+MODULE_LICENSE("GPL");