1 // SPDX-License-Identifier: GPL-2.0+
3 * Intel HID event & 5 button array driver
5 * Copyright (C) 2015 Alex Hung <alex.hung@canonical.com>
6 * Copyright (C) 2015 Andrew Lutomirski <luto@kernel.org>
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 BIT(6)
21 MODULE_LICENSE("GPL");
22 MODULE_AUTHOR("Alex Hung");
24 static const struct acpi_device_id intel_hid_ids
[] = {
30 MODULE_DEVICE_TABLE(acpi
, intel_hid_ids
);
32 /* In theory, these are HID usages. */
33 static const struct key_entry intel_hid_keymap
[] = {
34 /* 1: LSuper (Page 0x07, usage 0xE3) -- unclear what to do */
35 /* 2: Toggle SW_ROTATE_LOCK -- easy to implement if seen in wild */
36 { KE_KEY
, 3, { KEY_NUMLOCK
} },
37 { KE_KEY
, 4, { KEY_HOME
} },
38 { KE_KEY
, 5, { KEY_END
} },
39 { KE_KEY
, 6, { KEY_PAGEUP
} },
40 { KE_KEY
, 7, { KEY_PAGEDOWN
} },
41 { KE_KEY
, 8, { KEY_RFKILL
} },
42 { KE_KEY
, 9, { KEY_POWER
} },
43 { KE_KEY
, 11, { KEY_SLEEP
} },
44 /* 13 has two different meanings in the spec -- ignore it. */
45 { KE_KEY
, 14, { KEY_STOPCD
} },
46 { KE_KEY
, 15, { KEY_PLAYPAUSE
} },
47 { KE_KEY
, 16, { KEY_MUTE
} },
48 { KE_KEY
, 17, { KEY_VOLUMEUP
} },
49 { KE_KEY
, 18, { KEY_VOLUMEDOWN
} },
50 { KE_KEY
, 19, { KEY_BRIGHTNESSUP
} },
51 { KE_KEY
, 20, { KEY_BRIGHTNESSDOWN
} },
52 /* 27: wake -- needs special handling */
56 /* 5 button array notification value. */
57 static const struct key_entry intel_array_keymap
[] = {
58 { KE_KEY
, 0xC2, { KEY_LEFTMETA
} }, /* Press */
59 { KE_IGNORE
, 0xC3, { KEY_LEFTMETA
} }, /* Release */
60 { KE_KEY
, 0xC4, { KEY_VOLUMEUP
} }, /* Press */
61 { KE_IGNORE
, 0xC5, { KEY_VOLUMEUP
} }, /* Release */
62 { KE_KEY
, 0xC6, { KEY_VOLUMEDOWN
} }, /* Press */
63 { KE_IGNORE
, 0xC7, { KEY_VOLUMEDOWN
} }, /* Release */
64 { KE_KEY
, 0xC8, { KEY_ROTATE_LOCK_TOGGLE
} }, /* Press */
65 { KE_IGNORE
, 0xC9, { KEY_ROTATE_LOCK_TOGGLE
} }, /* Release */
66 { KE_KEY
, 0xCE, { KEY_POWER
} }, /* Press */
67 { KE_IGNORE
, 0xCF, { KEY_POWER
} }, /* Release */
71 static const struct dmi_system_id button_array_table
[] = {
73 .ident
= "Wacom MobileStudio Pro 13",
75 DMI_MATCH(DMI_SYS_VENDOR
, "Wacom Co.,Ltd"),
76 DMI_MATCH(DMI_PRODUCT_NAME
, "Wacom MobileStudio Pro 13"),
80 .ident
= "Wacom MobileStudio Pro 16",
82 DMI_MATCH(DMI_SYS_VENDOR
, "Wacom Co.,Ltd"),
83 DMI_MATCH(DMI_PRODUCT_NAME
, "Wacom MobileStudio Pro 16"),
87 .ident
= "HP Spectre x2 (2015)",
89 DMI_MATCH(DMI_SYS_VENDOR
, "HP"),
90 DMI_MATCH(DMI_PRODUCT_NAME
, "HP Spectre x2 Detachable"),
97 * Some convertible use the intel-hid ACPI interface to report SW_TABLET_MODE,
98 * these need to be compared via a DMI based authorization list because some
99 * models have unreliable VGBS return which could cause incorrect
100 * SW_TABLET_MODE report.
102 static const struct dmi_system_id dmi_vgbs_allow_list
[] = {
105 DMI_MATCH(DMI_SYS_VENDOR
, "HP"),
106 DMI_MATCH(DMI_PRODUCT_NAME
, "HP Spectre x360 Convertible 15-df0xxx"),
112 struct intel_hid_priv
{
113 struct input_dev
*input_dev
;
114 struct input_dev
*array
;
115 struct input_dev
*switches
;
119 #define HID_EVENT_FILTER_UUID "eeec56b3-4442-408f-a792-4edd4d758054"
121 enum intel_hid_dsm_fn_codes
{
122 INTEL_HID_DSM_FN_INVALID
,
123 INTEL_HID_DSM_BTNL_FN
,
124 INTEL_HID_DSM_HDMM_FN
,
125 INTEL_HID_DSM_HDSM_FN
,
126 INTEL_HID_DSM_HDEM_FN
,
127 INTEL_HID_DSM_BTNS_FN
,
128 INTEL_HID_DSM_BTNE_FN
,
129 INTEL_HID_DSM_HEBC_V1_FN
,
130 INTEL_HID_DSM_VGBS_FN
,
131 INTEL_HID_DSM_HEBC_V2_FN
,
135 static const char *intel_hid_dsm_fn_to_method
[INTEL_HID_DSM_FN_MAX
] = {
148 static unsigned long long intel_hid_dsm_fn_mask
;
149 static guid_t intel_dsm_guid
;
151 static bool intel_hid_execute_method(acpi_handle handle
,
152 enum intel_hid_dsm_fn_codes fn_index
,
153 unsigned long long arg
)
155 union acpi_object
*obj
, argv4
, req
;
159 if (fn_index
<= INTEL_HID_DSM_FN_INVALID
||
160 fn_index
>= INTEL_HID_DSM_FN_MAX
)
163 method_name
= (char *)intel_hid_dsm_fn_to_method
[fn_index
];
165 if (!(intel_hid_dsm_fn_mask
& BIT(fn_index
)))
168 /* All methods expects a package with one integer element */
169 req
.type
= ACPI_TYPE_INTEGER
;
170 req
.integer
.value
= arg
;
172 argv4
.type
= ACPI_TYPE_PACKAGE
;
173 argv4
.package
.count
= 1;
174 argv4
.package
.elements
= &req
;
176 obj
= acpi_evaluate_dsm(handle
, &intel_dsm_guid
, 1, fn_index
, &argv4
);
178 acpi_handle_debug(handle
, "Exec DSM Fn code: %d[%s] success\n",
179 fn_index
, method_name
);
185 status
= acpi_execute_simple_method(handle
, method_name
, arg
);
186 if (ACPI_SUCCESS(status
))
192 static bool intel_hid_evaluate_method(acpi_handle handle
,
193 enum intel_hid_dsm_fn_codes fn_index
,
194 unsigned long long *result
)
196 union acpi_object
*obj
;
200 if (fn_index
<= INTEL_HID_DSM_FN_INVALID
||
201 fn_index
>= INTEL_HID_DSM_FN_MAX
)
204 method_name
= (char *)intel_hid_dsm_fn_to_method
[fn_index
];
206 if (!(intel_hid_dsm_fn_mask
& fn_index
))
209 obj
= acpi_evaluate_dsm_typed(handle
, &intel_dsm_guid
,
211 NULL
, ACPI_TYPE_INTEGER
);
213 *result
= obj
->integer
.value
;
214 acpi_handle_debug(handle
,
215 "Eval DSM Fn code: %d[%s] results: 0x%llx\n",
216 fn_index
, method_name
, *result
);
222 status
= acpi_evaluate_integer(handle
, method_name
, NULL
, result
);
223 if (ACPI_SUCCESS(status
))
229 static void intel_hid_init_dsm(acpi_handle handle
)
231 union acpi_object
*obj
;
233 guid_parse(HID_EVENT_FILTER_UUID
, &intel_dsm_guid
);
235 obj
= acpi_evaluate_dsm_typed(handle
, &intel_dsm_guid
, 1, 0, NULL
,
238 switch (obj
->buffer
.length
) {
241 intel_hid_dsm_fn_mask
= *(u16
*)obj
->buffer
.pointer
;
244 intel_hid_dsm_fn_mask
= *obj
->buffer
.pointer
;
247 acpi_handle_warn(handle
, "intel_hid_dsm_fn_mask length is zero\n");
248 intel_hid_dsm_fn_mask
= 0;
254 acpi_handle_debug(handle
, "intel_hid_dsm_fn_mask = %llx\n",
255 intel_hid_dsm_fn_mask
);
258 static int intel_hid_set_enable(struct device
*device
, bool enable
)
260 acpi_handle handle
= ACPI_HANDLE(device
);
262 /* Enable|disable features - power button is always enabled */
263 if (!intel_hid_execute_method(handle
, INTEL_HID_DSM_HDSM_FN
,
265 dev_warn(device
, "failed to %sable hotkeys\n",
266 enable
? "en" : "dis");
273 static void intel_button_array_enable(struct device
*device
, bool enable
)
275 struct intel_hid_priv
*priv
= dev_get_drvdata(device
);
276 acpi_handle handle
= ACPI_HANDLE(device
);
277 unsigned long long button_cap
;
283 /* Query supported platform features */
284 status
= acpi_evaluate_integer(handle
, "BTNC", NULL
, &button_cap
);
285 if (ACPI_FAILURE(status
)) {
286 dev_warn(device
, "failed to get button capability\n");
290 /* Enable|disable features - power button is always enabled */
291 if (!intel_hid_execute_method(handle
, INTEL_HID_DSM_BTNE_FN
,
292 enable
? button_cap
: 1))
293 dev_warn(device
, "failed to set button capability\n");
296 static int intel_hid_pm_prepare(struct device
*device
)
298 if (device_may_wakeup(device
)) {
299 struct intel_hid_priv
*priv
= dev_get_drvdata(device
);
301 priv
->wakeup_mode
= true;
306 static void intel_hid_pm_complete(struct device
*device
)
308 struct intel_hid_priv
*priv
= dev_get_drvdata(device
);
310 priv
->wakeup_mode
= false;
313 static int intel_hid_pl_suspend_handler(struct device
*device
)
315 intel_button_array_enable(device
, false);
317 if (!pm_suspend_no_platform())
318 intel_hid_set_enable(device
, false);
323 static int intel_hid_pl_resume_handler(struct device
*device
)
325 intel_hid_pm_complete(device
);
327 if (!pm_suspend_no_platform())
328 intel_hid_set_enable(device
, true);
330 intel_button_array_enable(device
, true);
334 static const struct dev_pm_ops intel_hid_pl_pm_ops
= {
335 .prepare
= intel_hid_pm_prepare
,
336 .complete
= intel_hid_pm_complete
,
337 .freeze
= intel_hid_pl_suspend_handler
,
338 .thaw
= intel_hid_pl_resume_handler
,
339 .restore
= intel_hid_pl_resume_handler
,
340 .suspend
= intel_hid_pl_suspend_handler
,
341 .resume
= intel_hid_pl_resume_handler
,
344 static int intel_hid_input_setup(struct platform_device
*device
)
346 struct intel_hid_priv
*priv
= dev_get_drvdata(&device
->dev
);
349 priv
->input_dev
= devm_input_allocate_device(&device
->dev
);
350 if (!priv
->input_dev
)
353 ret
= sparse_keymap_setup(priv
->input_dev
, intel_hid_keymap
, NULL
);
357 priv
->input_dev
->name
= "Intel HID events";
358 priv
->input_dev
->id
.bustype
= BUS_HOST
;
360 return input_register_device(priv
->input_dev
);
363 static int intel_button_array_input_setup(struct platform_device
*device
)
365 struct intel_hid_priv
*priv
= dev_get_drvdata(&device
->dev
);
368 /* Setup input device for 5 button array */
369 priv
->array
= devm_input_allocate_device(&device
->dev
);
373 ret
= sparse_keymap_setup(priv
->array
, intel_array_keymap
, NULL
);
377 priv
->array
->name
= "Intel HID 5 button array";
378 priv
->array
->id
.bustype
= BUS_HOST
;
380 return input_register_device(priv
->array
);
383 static int intel_hid_switches_setup(struct platform_device
*device
)
385 struct intel_hid_priv
*priv
= dev_get_drvdata(&device
->dev
);
387 /* Setup input device for switches */
388 priv
->switches
= devm_input_allocate_device(&device
->dev
);
392 __set_bit(EV_SW
, priv
->switches
->evbit
);
393 __set_bit(SW_TABLET_MODE
, priv
->switches
->swbit
);
395 priv
->switches
->name
= "Intel HID switches";
396 priv
->switches
->id
.bustype
= BUS_HOST
;
397 return input_register_device(priv
->switches
);
400 static void report_tablet_mode_state(struct platform_device
*device
)
402 struct intel_hid_priv
*priv
= dev_get_drvdata(&device
->dev
);
403 acpi_handle handle
= ACPI_HANDLE(&device
->dev
);
404 unsigned long long vgbs
;
407 if (!intel_hid_evaluate_method(handle
, INTEL_HID_DSM_VGBS_FN
, &vgbs
))
410 m
= !(vgbs
& TABLET_MODE_FLAG
);
411 input_report_switch(priv
->switches
, SW_TABLET_MODE
, m
);
412 input_sync(priv
->switches
);
415 static bool report_tablet_mode_event(struct input_dev
*input_dev
, u32 event
)
422 input_report_switch(input_dev
, SW_TABLET_MODE
, 1);
423 input_sync(input_dev
);
426 input_report_switch(input_dev
, SW_TABLET_MODE
, 0);
427 input_sync(input_dev
);
434 static void notify_handler(acpi_handle handle
, u32 event
, void *context
)
436 struct platform_device
*device
= context
;
437 struct intel_hid_priv
*priv
= dev_get_drvdata(&device
->dev
);
438 unsigned long long ev_index
;
442 * Some convertible have unreliable VGBS return which could cause incorrect
443 * SW_TABLET_MODE report, in these cases we enable support when receiving
444 * the first event instead of during driver setup.
446 * Some 360 degree hinges (yoga) style 2-in-1 devices use 2 accelerometers
447 * to allow the OS to determine the angle between the display and the base
448 * of the device. On Windows these are read by a special HingeAngleService
449 * process which calls an ACPI DSM (Device Specific Method) on the
450 * ACPI KIOX010A device node for the sensor in the display, to let the
451 * firmware know if the 2-in-1 is in tablet- or laptop-mode so that it can
452 * disable the kbd and touchpad to avoid spurious input in tablet-mode.
454 * The linux kxcjk1013 driver calls the DSM for this once at probe time
455 * to ensure that the builtin kbd and touchpad work. On some devices this
456 * causes a "spurious" 0xcd event on the intel-hid ACPI dev. In this case
457 * there is not a functional tablet-mode switch, so we should not register
458 * the tablet-mode switch device.
460 if (!priv
->switches
&& (event
== 0xcc || event
== 0xcd) &&
461 !acpi_dev_present("KIOX010A", NULL
, -1)) {
462 dev_info(&device
->dev
, "switch event received, enable switches supports\n");
463 err
= intel_hid_switches_setup(device
);
465 pr_err("Failed to setup Intel HID switches\n");
468 if (priv
->wakeup_mode
) {
470 * Needed for wakeup from suspend-to-idle to work on some
471 * platforms that don't expose the 5-button array, but still
472 * send notifies with the power button event code to this
473 * device object on power button actions while suspended.
479 * Switch events will wake the device and report the new switch
480 * position to the input subsystem.
482 if (priv
->switches
&& (event
== 0xcc || event
== 0xcd))
485 /* Wake up on 5-button array events only. */
486 if (event
== 0xc0 || !priv
->array
)
489 if (!sparse_keymap_entry_from_scancode(priv
->array
, event
)) {
490 dev_info(&device
->dev
, "unknown event 0x%x\n", event
);
495 pm_wakeup_hard_event(&device
->dev
);
497 if (report_tablet_mode_event(priv
->switches
, event
))
504 * Needed for suspend to work on some platforms that don't expose
505 * the 5-button array, but still send notifies with power button
506 * event code to this device object on power button actions.
508 * Report the power button press and release.
512 input_report_key(priv
->input_dev
, KEY_POWER
, 1);
513 input_sync(priv
->input_dev
);
518 input_report_key(priv
->input_dev
, KEY_POWER
, 0);
519 input_sync(priv
->input_dev
);
524 if (report_tablet_mode_event(priv
->switches
, event
))
527 /* 0xC0 is for HID events, other values are for 5 button array */
530 !sparse_keymap_report_event(priv
->array
, event
, 1, true))
531 dev_dbg(&device
->dev
, "unknown event 0x%x\n", event
);
535 if (!intel_hid_evaluate_method(handle
, INTEL_HID_DSM_HDEM_FN
,
537 dev_warn(&device
->dev
, "failed to get event index\n");
541 if (!sparse_keymap_report_event(priv
->input_dev
, ev_index
, 1, true))
542 dev_dbg(&device
->dev
, "unknown event index 0x%llx\n",
546 static bool button_array_present(struct platform_device
*device
)
548 acpi_handle handle
= ACPI_HANDLE(&device
->dev
);
549 unsigned long long event_cap
;
551 if (intel_hid_evaluate_method(handle
, INTEL_HID_DSM_HEBC_V2_FN
,
553 /* Check presence of 5 button array or v2 power button */
554 if (event_cap
& 0x60000)
558 if (intel_hid_evaluate_method(handle
, INTEL_HID_DSM_HEBC_V1_FN
,
560 if (event_cap
& 0x20000)
564 if (dmi_check_system(button_array_table
))
570 static int intel_hid_probe(struct platform_device
*device
)
572 acpi_handle handle
= ACPI_HANDLE(&device
->dev
);
573 unsigned long long mode
;
574 struct intel_hid_priv
*priv
;
578 intel_hid_init_dsm(handle
);
580 if (!intel_hid_evaluate_method(handle
, INTEL_HID_DSM_HDMM_FN
, &mode
)) {
581 dev_warn(&device
->dev
, "failed to read mode\n");
587 * This driver only implements "simple" mode. There appear
588 * to be no other modes, but we should be paranoid and check
591 dev_info(&device
->dev
, "platform is not in simple mode\n");
595 priv
= devm_kzalloc(&device
->dev
, sizeof(*priv
), GFP_KERNEL
);
598 dev_set_drvdata(&device
->dev
, priv
);
600 err
= intel_hid_input_setup(device
);
602 pr_err("Failed to setup Intel HID hotkeys\n");
606 /* Setup 5 button array */
607 if (button_array_present(device
)) {
608 dev_info(&device
->dev
, "platform supports 5 button array\n");
609 err
= intel_button_array_input_setup(device
);
611 pr_err("Failed to setup Intel 5 button array hotkeys\n");
614 /* Setup switches for devices that we know VGBS return correctly */
615 if (dmi_check_system(dmi_vgbs_allow_list
)) {
616 dev_info(&device
->dev
, "platform supports switches\n");
617 err
= intel_hid_switches_setup(device
);
619 pr_err("Failed to setup Intel HID switches\n");
621 report_tablet_mode_state(device
);
624 status
= acpi_install_notify_handler(handle
,
628 if (ACPI_FAILURE(status
))
631 err
= intel_hid_set_enable(&device
->dev
, true);
633 goto err_remove_notify
;
636 unsigned long long dummy
;
638 intel_button_array_enable(&device
->dev
, true);
640 /* Call button load method to enable HID power button */
641 if (!intel_hid_evaluate_method(handle
, INTEL_HID_DSM_BTNL_FN
,
643 dev_warn(&device
->dev
,
644 "failed to enable HID power button\n");
648 device_init_wakeup(&device
->dev
, true);
650 * In order for system wakeup to work, the EC GPE has to be marked as
651 * a wakeup one, so do that here (this setting will persist, but it has
652 * no effect until the wakeup mask is set for the EC GPE).
654 acpi_ec_mark_gpe_for_wake();
658 acpi_remove_notify_handler(handle
, ACPI_DEVICE_NOTIFY
, notify_handler
);
663 static int intel_hid_remove(struct platform_device
*device
)
665 acpi_handle handle
= ACPI_HANDLE(&device
->dev
);
667 device_init_wakeup(&device
->dev
, false);
668 acpi_remove_notify_handler(handle
, ACPI_DEVICE_NOTIFY
, notify_handler
);
669 intel_hid_set_enable(&device
->dev
, false);
670 intel_button_array_enable(&device
->dev
, false);
673 * Even if we failed to shut off the event stream, we can still
674 * safely detach from the device.
679 static struct platform_driver intel_hid_pl_driver
= {
682 .acpi_match_table
= intel_hid_ids
,
683 .pm
= &intel_hid_pl_pm_ops
,
685 .probe
= intel_hid_probe
,
686 .remove
= intel_hid_remove
,
690 * Unfortunately, some laptops provide a _HID="INT33D5" device with
691 * _CID="PNP0C02". This causes the pnpacpi scan driver to claim the
692 * ACPI node, so no platform device will be created. The pnpacpi
693 * driver rejects this device in subsequent processing, so no physical
694 * node is created at all.
696 * As a workaround until the ACPI core figures out how to handle
697 * this corner case, manually ask the ACPI platform device code to
698 * claim the ACPI node.
700 static acpi_status __init
701 check_acpi_dev(acpi_handle handle
, u32 lvl
, void *context
, void **rv
)
703 const struct acpi_device_id
*ids
= context
;
704 struct acpi_device
*dev
;
706 if (acpi_bus_get_device(handle
, &dev
) != 0)
709 if (acpi_match_device_ids(dev
, ids
) == 0)
710 if (!IS_ERR_OR_NULL(acpi_create_platform_device(dev
, NULL
)))
712 "intel-hid: created platform device\n");
717 static int __init
intel_hid_init(void)
719 acpi_walk_namespace(ACPI_TYPE_DEVICE
, ACPI_ROOT_OBJECT
,
720 ACPI_UINT32_MAX
, check_acpi_dev
, NULL
,
721 (void *)intel_hid_ids
, NULL
);
723 return platform_driver_register(&intel_hid_pl_driver
);
725 module_init(intel_hid_init
);
727 static void __exit
intel_hid_exit(void)
729 platform_driver_unregister(&intel_hid_pl_driver
);
731 module_exit(intel_hid_exit
);