1 // SPDX-License-Identifier: GPL-2.0+
3 * Intel Virtual Button driver for Windows 8.1+
5 * Copyright (C) 2016 AceLan Kao <acelan.kao@canonical.com>
6 * Copyright (C) 2016 Alex Hung <alex.hung@canonical.com>
9 #include <linux/acpi.h>
10 #include <linux/dmi.h>
11 #include <linux/input.h>
12 #include <linux/input/sparse-keymap.h>
13 #include <linux/kernel.h>
14 #include <linux/module.h>
15 #include <linux/platform_device.h>
16 #include <linux/suspend.h>
18 /* When NOT in tablet mode, VGBS returns with the flag 0x40 */
19 #define TABLET_MODE_FLAG 0x40
20 #define DOCK_MODE_FLAG 0x80
22 MODULE_LICENSE("GPL");
23 MODULE_AUTHOR("AceLan Kao");
25 static const struct acpi_device_id intel_vbtn_ids[] = {
29 MODULE_DEVICE_TABLE(acpi, intel_vbtn_ids);
31 /* In theory, these are HID usages. */
32 static const struct key_entry intel_vbtn_keymap[] = {
33 { KE_KEY, 0xC0, { KEY_POWER } }, /* power key press */
34 { KE_IGNORE, 0xC1, { KEY_POWER } }, /* power key release */
35 { KE_KEY, 0xC2, { KEY_LEFTMETA } }, /* 'Windows' key press */
36 { KE_KEY, 0xC3, { KEY_LEFTMETA } }, /* 'Windows' key release */
37 { KE_KEY, 0xC4, { KEY_VOLUMEUP } }, /* volume-up key press */
38 { KE_IGNORE, 0xC5, { KEY_VOLUMEUP } }, /* volume-up key release */
39 { KE_KEY, 0xC6, { KEY_VOLUMEDOWN } }, /* volume-down key press */
40 { KE_IGNORE, 0xC7, { KEY_VOLUMEDOWN } }, /* volume-down key release */
41 { KE_KEY, 0xC8, { KEY_ROTATE_LOCK_TOGGLE } }, /* rotate-lock key press */
42 { KE_KEY, 0xC9, { KEY_ROTATE_LOCK_TOGGLE } }, /* rotate-lock key release */
45 static const struct key_entry intel_vbtn_switchmap[] = {
46 { KE_SW, 0xCA, { .sw = { SW_DOCK, 1 } } }, /* Docked */
47 { KE_SW, 0xCB, { .sw = { SW_DOCK, 0 } } }, /* Undocked */
48 { KE_SW, 0xCC, { .sw = { SW_TABLET_MODE, 1 } } }, /* Tablet */
49 { KE_SW, 0xCD, { .sw = { SW_TABLET_MODE, 0 } } }, /* Laptop */
53 (ARRAY_SIZE(intel_vbtn_keymap) + ARRAY_SIZE(intel_vbtn_switchmap) + 1)
55 struct intel_vbtn_priv {
56 struct key_entry keymap[KEYMAP_LEN];
57 struct input_dev *input_dev;
62 static int intel_vbtn_input_setup(struct platform_device *device)
64 struct intel_vbtn_priv *priv = dev_get_drvdata(&device->dev);
65 int ret, keymap_len = 0;
68 memcpy(&priv->keymap[keymap_len], intel_vbtn_keymap,
69 ARRAY_SIZE(intel_vbtn_keymap) *
70 sizeof(struct key_entry));
71 keymap_len += ARRAY_SIZE(intel_vbtn_keymap);
74 if (priv->has_switches) {
75 memcpy(&priv->keymap[keymap_len], intel_vbtn_switchmap,
76 ARRAY_SIZE(intel_vbtn_switchmap) *
77 sizeof(struct key_entry));
78 keymap_len += ARRAY_SIZE(intel_vbtn_switchmap);
81 priv->keymap[keymap_len].type = KE_END;
83 priv->input_dev = devm_input_allocate_device(&device->dev);
87 ret = sparse_keymap_setup(priv->input_dev, priv->keymap, NULL);
91 priv->input_dev->dev.parent = &device->dev;
92 priv->input_dev->name = "Intel Virtual Button driver";
93 priv->input_dev->id.bustype = BUS_HOST;
95 return input_register_device(priv->input_dev);
98 static void notify_handler(acpi_handle handle, u32 event, void *context)
100 struct platform_device *device = context;
101 struct intel_vbtn_priv *priv = dev_get_drvdata(&device->dev);
102 unsigned int val = !(event & 1); /* Even=press, Odd=release */
103 const struct key_entry *ke, *ke_rel;
106 if (priv->wakeup_mode) {
107 ke = sparse_keymap_entry_from_scancode(priv->input_dev, event);
109 pm_wakeup_hard_event(&device->dev);
112 * Switch events like tablet mode will wake the device
113 * and report the new switch position to the input
116 if (ke->type == KE_SW)
117 sparse_keymap_report_event(priv->input_dev,
127 * Even press events are autorelease if there is no corresponding odd
128 * release event, or if the odd event is KE_IGNORE.
130 ke_rel = sparse_keymap_entry_from_scancode(priv->input_dev, event | 1);
131 autorelease = val && (!ke_rel || ke_rel->type == KE_IGNORE);
133 if (sparse_keymap_report_event(priv->input_dev, event, val, autorelease))
137 dev_dbg(&device->dev, "unknown event index 0x%x\n", event);
140 static void detect_tablet_mode(struct platform_device *device)
142 struct intel_vbtn_priv *priv = dev_get_drvdata(&device->dev);
143 acpi_handle handle = ACPI_HANDLE(&device->dev);
144 unsigned long long vgbs;
148 status = acpi_evaluate_integer(handle, "VGBS", NULL, &vgbs);
149 if (ACPI_FAILURE(status))
152 m = !(vgbs & TABLET_MODE_FLAG);
153 input_report_switch(priv->input_dev, SW_TABLET_MODE, m);
154 m = (vgbs & DOCK_MODE_FLAG) ? 1 : 0;
155 input_report_switch(priv->input_dev, SW_DOCK, m);
158 static bool intel_vbtn_has_switches(acpi_handle handle)
160 const char *chassis_type = dmi_get_system_info(DMI_CHASSIS_TYPE);
161 unsigned long long vgbs;
164 if (!(chassis_type && strcmp(chassis_type, "31") == 0))
167 status = acpi_evaluate_integer(handle, "VGBS", NULL, &vgbs);
168 return ACPI_SUCCESS(status);
171 static int intel_vbtn_probe(struct platform_device *device)
173 acpi_handle handle = ACPI_HANDLE(&device->dev);
174 struct intel_vbtn_priv *priv;
178 status = acpi_evaluate_object(handle, "VBDL", NULL, NULL);
179 if (ACPI_FAILURE(status)) {
180 dev_warn(&device->dev, "failed to read Intel Virtual Button driver\n");
184 priv = devm_kzalloc(&device->dev, sizeof(*priv), GFP_KERNEL);
187 dev_set_drvdata(&device->dev, priv);
189 priv->has_switches = intel_vbtn_has_switches(handle);
191 err = intel_vbtn_input_setup(device);
193 pr_err("Failed to setup Intel Virtual Button\n");
197 if (priv->has_switches)
198 detect_tablet_mode(device);
200 status = acpi_install_notify_handler(handle,
204 if (ACPI_FAILURE(status))
207 device_init_wakeup(&device->dev, true);
209 * In order for system wakeup to work, the EC GPE has to be marked as
210 * a wakeup one, so do that here (this setting will persist, but it has
211 * no effect until the wakeup mask is set for the EC GPE).
213 acpi_ec_mark_gpe_for_wake();
217 static int intel_vbtn_remove(struct platform_device *device)
219 acpi_handle handle = ACPI_HANDLE(&device->dev);
221 device_init_wakeup(&device->dev, false);
222 acpi_remove_notify_handler(handle, ACPI_DEVICE_NOTIFY, notify_handler);
225 * Even if we failed to shut off the event stream, we can still
226 * safely detach from the device.
231 static int intel_vbtn_pm_prepare(struct device *dev)
233 if (device_may_wakeup(dev)) {
234 struct intel_vbtn_priv *priv = dev_get_drvdata(dev);
236 priv->wakeup_mode = true;
241 static void intel_vbtn_pm_complete(struct device *dev)
243 struct intel_vbtn_priv *priv = dev_get_drvdata(dev);
245 priv->wakeup_mode = false;
248 static int intel_vbtn_pm_resume(struct device *dev)
250 intel_vbtn_pm_complete(dev);
254 static const struct dev_pm_ops intel_vbtn_pm_ops = {
255 .prepare = intel_vbtn_pm_prepare,
256 .complete = intel_vbtn_pm_complete,
257 .resume = intel_vbtn_pm_resume,
258 .restore = intel_vbtn_pm_resume,
259 .thaw = intel_vbtn_pm_resume,
262 static struct platform_driver intel_vbtn_pl_driver = {
264 .name = "intel-vbtn",
265 .acpi_match_table = intel_vbtn_ids,
266 .pm = &intel_vbtn_pm_ops,
268 .probe = intel_vbtn_probe,
269 .remove = intel_vbtn_remove,
272 static acpi_status __init
273 check_acpi_dev(acpi_handle handle, u32 lvl, void *context, void **rv)
275 const struct acpi_device_id *ids = context;
276 struct acpi_device *dev;
278 if (acpi_bus_get_device(handle, &dev) != 0)
281 if (acpi_match_device_ids(dev, ids) == 0)
282 if (acpi_create_platform_device(dev, NULL))
284 "intel-vbtn: created platform device\n");
289 static int __init intel_vbtn_init(void)
291 acpi_walk_namespace(ACPI_TYPE_DEVICE, ACPI_ROOT_OBJECT,
292 ACPI_UINT32_MAX, check_acpi_dev, NULL,
293 (void *)intel_vbtn_ids, NULL);
295 return platform_driver_register(&intel_vbtn_pl_driver);
297 module_init(intel_vbtn_init);
299 static void __exit intel_vbtn_exit(void)
301 platform_driver_unregister(&intel_vbtn_pl_driver);
303 module_exit(intel_vbtn_exit);