1 // SPDX-License-Identifier: GPL-2.0-or-later
8 * Portions based on wistron_btns.c:
14 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
16 #include <linux/kernel.h>
17 #include <linux/module.h>
18 #include <linux/init.h>
19 #include <linux/slab.h>
20 #include <linux/types.h>
21 #include <linux/input.h>
22 #include <linux/input/sparse-keymap.h>
23 #include <linux/acpi.h>
24 #include <linux/string.h>
25 #include <linux/dmi.h>
26 #include <linux/wmi.h>
27 #include <acpi/video.h>
28 #include "dell-smbios.h"
29 #include "dell-wmi-descriptor.h"
30 #include "dell-wmi-privacy.h"
34 MODULE_DESCRIPTION("Dell laptop WMI hotkeys driver");
35 MODULE_LICENSE("GPL");
37 #define DELL_EVENT_GUID "9DBB5994-A997-11DA-B012-B622A1EF5492"
39 static bool wmi_requires_smbios_request;
41 struct dell_wmi_priv {
42 struct input_dev *input_dev;
43 u32 interface_version;
46 static int __init dmi_matched(const struct dmi_system_id *dmi)
48 wmi_requires_smbios_request = 1;
52 static const struct dmi_system_id dell_wmi_smbios_list[] __initconst = {
54 .callback = dmi_matched,
55 .ident = "Dell Inspiron M5110",
57 DMI_MATCH(DMI_SYS_VENDOR, "Dell Inc."),
58 DMI_MATCH(DMI_PRODUCT_NAME, "Inspiron M5110"),
62 .callback = dmi_matched,
63 .ident = "Dell Vostro V131",
65 DMI_MATCH(DMI_SYS_VENDOR, "Dell Inc."),
66 DMI_MATCH(DMI_PRODUCT_NAME, "Vostro V131"),
73 * Keymap for WMI events of type 0x0000
75 * Certain keys are flagged as KE_IGNORE. All of these are either
76 * notifications (rather than requests for change) or are also sent
77 * via the keyboard controller so should not be sent again.
79 static const struct key_entry dell_wmi_keymap_type_0000[] = {
80 { KE_IGNORE, 0x003a, { KEY_CAPSLOCK } },
82 /* Key code is followed by brightness level */
83 { KE_KEY, 0xe005, { KEY_BRIGHTNESSDOWN } },
84 { KE_KEY, 0xe006, { KEY_BRIGHTNESSUP } },
86 /* Battery health status button */
87 { KE_KEY, 0xe007, { KEY_BATTERY } },
89 /* Radio devices state change, key code is followed by other values */
90 { KE_IGNORE, 0xe008, { KEY_RFKILL } },
92 { KE_KEY, 0xe009, { KEY_EJECTCD } },
94 /* Key code is followed by: next, active and attached devices */
95 { KE_KEY, 0xe00b, { KEY_SWITCHVIDEOMODE } },
97 /* Key code is followed by keyboard illumination level */
98 { KE_IGNORE, 0xe00c, { KEY_KBDILLUMTOGGLE } },
100 /* BIOS error detected */
101 { KE_IGNORE, 0xe00d, { KEY_RESERVED } },
103 /* Battery was removed or inserted */
104 { KE_IGNORE, 0xe00e, { KEY_RESERVED } },
107 { KE_KEY, 0xe011, { KEY_WLAN } },
109 /* Ambient light sensor toggle */
110 { KE_IGNORE, 0xe013, { KEY_RESERVED } },
112 { KE_IGNORE, 0xe020, { KEY_MUTE } },
114 /* Unknown, defined in ACPI DSDT */
115 /* { KE_IGNORE, 0xe023, { KEY_RESERVED } }, */
117 /* Untested, Dell Instant Launch key on Inspiron 7520 */
118 /* { KE_IGNORE, 0xe024, { KEY_RESERVED } }, */
120 /* Dell Instant Launch key */
121 { KE_KEY, 0xe025, { KEY_PROG4 } },
123 /* Audio panel key */
124 { KE_IGNORE, 0xe026, { KEY_RESERVED } },
126 /* LCD Display On/Off Control key */
127 { KE_KEY, 0xe027, { KEY_DISPLAYTOGGLE } },
129 /* Untested, Multimedia key on Dell Vostro 3560 */
130 /* { KE_IGNORE, 0xe028, { KEY_RESERVED } }, */
132 /* Dell Instant Launch key */
133 { KE_KEY, 0xe029, { KEY_PROG4 } },
135 /* Untested, Windows Mobility Center button on Inspiron 7520 */
136 /* { KE_IGNORE, 0xe02a, { KEY_RESERVED } }, */
138 /* Unknown, defined in ACPI DSDT */
139 /* { KE_IGNORE, 0xe02b, { KEY_RESERVED } }, */
141 /* Untested, Dell Audio With Preset Switch button on Inspiron 7520 */
142 /* { KE_IGNORE, 0xe02c, { KEY_RESERVED } }, */
144 { KE_IGNORE, 0xe02e, { KEY_VOLUMEDOWN } },
145 { KE_IGNORE, 0xe030, { KEY_VOLUMEUP } },
146 { KE_IGNORE, 0xe033, { KEY_KBDILLUMUP } },
147 { KE_IGNORE, 0xe034, { KEY_KBDILLUMDOWN } },
148 { KE_IGNORE, 0xe03a, { KEY_CAPSLOCK } },
151 { KE_IGNORE, 0xe043, { KEY_RESERVED } },
153 /* NIC Link is Down */
154 { KE_IGNORE, 0xe044, { KEY_RESERVED } },
157 * This entry is very suspicious!
158 * Originally Matthew Garrett created this dell-wmi driver specially for
159 * "button with a picture of a battery" which has event code 0xe045.
160 * Later Mario Limonciello from Dell told us that event code 0xe045 is
161 * reported by Num Lock and should be ignored because key is send also
162 * by keyboard controller.
163 * So for now we will ignore this event to prevent potential double
164 * Num Lock key press.
166 { KE_IGNORE, 0xe045, { KEY_NUMLOCK } },
168 /* Scroll lock and also going to tablet mode on portable devices */
169 { KE_IGNORE, 0xe046, { KEY_SCROLLLOCK } },
171 /* Untested, going from tablet mode on portable devices */
172 /* { KE_IGNORE, 0xe047, { KEY_RESERVED } }, */
174 /* Dell Support Center key */
175 { KE_IGNORE, 0xe06e, { KEY_RESERVED } },
177 { KE_IGNORE, 0xe0f7, { KEY_MUTE } },
178 { KE_IGNORE, 0xe0f8, { KEY_VOLUMEDOWN } },
179 { KE_IGNORE, 0xe0f9, { KEY_VOLUMEUP } },
182 struct dell_bios_keymap_entry {
187 struct dell_bios_hotkey_table {
188 struct dmi_header header;
189 struct dell_bios_keymap_entry keymap[];
193 struct dell_dmi_results {
196 struct key_entry *keymap;
199 /* Uninitialized entries here are KEY_RESERVED == 0. */
200 static const u16 bios_to_linux_keycode[256] = {
204 [3] = KEY_PREVIOUSSONG,
211 [10] = KEY_VOLUMEDOWN,
220 [19] = KEY_BRIGHTNESSDOWN,
221 [20] = KEY_BRIGHTNESSUP,
222 [21] = KEY_BRIGHTNESS_AUTO,
223 [22] = KEY_KBDILLUMTOGGLE,
225 [24] = KEY_SWITCHVIDEOMODE,
228 [27] = KEY_SWITCHVIDEOMODE,
244 * Keymap for WMI events of type 0x0010
246 * These are applied if the 0xB2 DMI hotkey table is present and doesn't
249 static const struct key_entry dell_wmi_keymap_type_0010[] = {
250 /* Fn-lock switched to function keys */
251 { KE_IGNORE, 0x0, { KEY_RESERVED } },
253 /* Fn-lock switched to multimedia keys */
254 { KE_IGNORE, 0x1, { KEY_RESERVED } },
256 /* Keyboard backlight change notification */
257 { KE_IGNORE, 0x3f, { KEY_RESERVED } },
259 /* Backlight brightness level */
260 { KE_KEY, 0x57, { KEY_BRIGHTNESSDOWN } },
261 { KE_KEY, 0x58, { KEY_BRIGHTNESSUP } },
264 { KE_KEY, 0x150, { KEY_MICMUTE } },
267 { KE_IGNORE, 0x151, { KEY_RESERVED } },
269 /* Change keyboard illumination */
270 { KE_IGNORE, 0x152, { KEY_KBDILLUMTOGGLE } },
273 * Radio disable (notify only -- there is no model for which the
274 * WMI event is supposed to trigger an action).
276 { KE_IGNORE, 0x153, { KEY_RFKILL } },
278 /* RGB keyboard backlight control */
279 { KE_IGNORE, 0x154, { KEY_RESERVED } },
282 * Stealth mode toggle. This will "disable all lights and sounds".
283 * The action is performed by the BIOS and EC; the WMI event is just
284 * a notification. On the XPS 13 9350, this is Fn+F7, and there's
285 * a BIOS setting to enable and disable the hotkey.
287 { KE_IGNORE, 0x155, { KEY_RESERVED } },
289 /* Rugged magnetic dock attach/detach events */
290 { KE_IGNORE, 0x156, { KEY_RESERVED } },
291 { KE_IGNORE, 0x157, { KEY_RESERVED } },
293 /* Rugged programmable (P1/P2/P3 keys) */
294 { KE_KEY, 0x850, { KEY_PROG1 } },
295 { KE_KEY, 0x851, { KEY_PROG2 } },
296 { KE_KEY, 0x852, { KEY_PROG3 } },
299 * Radio disable (notify only -- there is no model for which the
300 * WMI event is supposed to trigger an action).
302 { KE_IGNORE, 0xe008, { KEY_RFKILL } },
305 { KE_IGNORE, 0xe035, { KEY_RESERVED } },
309 * Keymap for WMI events of type 0x0011
311 static const struct key_entry dell_wmi_keymap_type_0011[] = {
312 /* Battery unplugged */
313 { KE_IGNORE, 0xfff0, { KEY_RESERVED } },
315 /* Battery inserted */
316 { KE_IGNORE, 0xfff1, { KEY_RESERVED } },
319 * Detachable keyboard detached / undocked
320 * Note SW_TABLET_MODE is already reported through the intel_vbtn
321 * driver for this, so we ignore it.
323 { KE_IGNORE, 0xfff2, { KEY_RESERVED } },
325 /* Detachable keyboard attached / docked */
326 { KE_IGNORE, 0xfff3, { KEY_RESERVED } },
328 /* Keyboard backlight level changed */
329 { KE_IGNORE, KBD_LED_OFF_TOKEN, { KEY_RESERVED } },
330 { KE_IGNORE, KBD_LED_ON_TOKEN, { KEY_RESERVED } },
331 { KE_IGNORE, KBD_LED_AUTO_TOKEN, { KEY_RESERVED } },
332 { KE_IGNORE, KBD_LED_AUTO_25_TOKEN, { KEY_RESERVED } },
333 { KE_IGNORE, KBD_LED_AUTO_50_TOKEN, { KEY_RESERVED } },
334 { KE_IGNORE, KBD_LED_AUTO_75_TOKEN, { KEY_RESERVED } },
335 { KE_IGNORE, KBD_LED_AUTO_100_TOKEN, { KEY_RESERVED } },
339 * Keymap for WMI events of type 0x0012
340 * They are events with extended data
342 static const struct key_entry dell_wmi_keymap_type_0012[] = {
343 /* Fn-lock button pressed */
344 { KE_IGNORE, 0xe035, { KEY_RESERVED } },
347 static void dell_wmi_process_key(struct wmi_device *wdev, int type, int code)
349 struct dell_wmi_priv *priv = dev_get_drvdata(&wdev->dev);
350 const struct key_entry *key;
352 key = sparse_keymap_entry_from_scancode(priv->input_dev,
353 (type << 16) | code);
355 pr_info("Unknown key with type 0x%04x and code 0x%04x pressed\n",
360 pr_debug("Key with type 0x%04x and code 0x%04x pressed\n", type, code);
362 /* Don't report brightness notifications that will also come via ACPI */
363 if ((key->keycode == KEY_BRIGHTNESSUP ||
364 key->keycode == KEY_BRIGHTNESSDOWN) &&
365 acpi_video_handles_brightness_key_presses())
368 if (type == 0x0000 && code == 0xe025 && !wmi_requires_smbios_request)
371 if (key->keycode == KEY_KBDILLUMTOGGLE)
372 dell_laptop_call_notifier(
373 DELL_LAPTOP_KBD_BACKLIGHT_BRIGHTNESS_CHANGED, NULL);
375 sparse_keymap_report_entry(priv->input_dev, key, 1, true);
378 static void dell_wmi_notify(struct wmi_device *wdev,
379 union acpi_object *obj)
381 struct dell_wmi_priv *priv = dev_get_drvdata(&wdev->dev);
382 u16 *buffer_entry, *buffer_end;
383 acpi_size buffer_size;
386 if (obj->type != ACPI_TYPE_BUFFER) {
387 pr_warn("bad response type %x\n", obj->type);
391 pr_debug("Received WMI event (%*ph)\n",
392 obj->buffer.length, obj->buffer.pointer);
394 buffer_entry = (u16 *)obj->buffer.pointer;
395 buffer_size = obj->buffer.length/2;
396 buffer_end = buffer_entry + buffer_size;
399 * BIOS/ACPI on devices with WMI interface version 0 does not clear
400 * buffer before filling it. So next time when BIOS/ACPI send WMI event
401 * which is smaller as previous then it contains garbage in buffer from
404 * BIOS/ACPI on devices with WMI interface version 1 clears buffer and
405 * sometimes send more events in buffer at one call.
407 * So to prevent reading garbage from buffer we will process only first
408 * one event on devices with WMI interface version 0.
410 if (priv->interface_version == 0 && buffer_entry < buffer_end)
411 if (buffer_end > buffer_entry + buffer_entry[0] + 1)
412 buffer_end = buffer_entry + buffer_entry[0] + 1;
414 while (buffer_entry < buffer_end) {
416 len = buffer_entry[0];
422 if (buffer_entry + len > buffer_end) {
423 pr_warn("Invalid length of WMI event\n");
427 pr_debug("Process buffer (%*ph)\n", len*2, buffer_entry);
429 switch (buffer_entry[1]) {
430 case 0x0000: /* One key pressed or event occurred */
432 dell_wmi_process_key(wdev, buffer_entry[1],
434 /* Extended data is currently ignored */
436 case 0x0010: /* Sequence of keys pressed */
437 case 0x0011: /* Sequence of events occurred */
438 for (i = 2; i < len; ++i)
439 dell_wmi_process_key(wdev, buffer_entry[1],
443 if ((len > 4) && dell_privacy_process_event(buffer_entry[1], buffer_entry[3],
445 /* dell_privacy_process_event has handled the event */;
447 dell_wmi_process_key(wdev, buffer_entry[1], buffer_entry[2]);
449 default: /* Unknown event */
450 pr_info("Unknown WMI event type 0x%x\n",
451 (int)buffer_entry[1]);
461 static bool have_scancode(u32 scancode, const struct key_entry *keymap, int len)
465 for (i = 0; i < len; i++)
466 if (keymap[i].code == scancode)
472 static void handle_dmi_entry(const struct dmi_header *dm, void *opaque)
474 struct dell_dmi_results *results = opaque;
475 struct dell_bios_hotkey_table *table;
476 int hotkey_num, i, pos = 0;
477 struct key_entry *keymap;
479 if (results->err || results->keymap)
480 return; /* We already found the hotkey table. */
482 /* The Dell hotkey table is type 0xB2. Scan until we find it. */
483 if (dm->type != 0xb2)
486 table = container_of(dm, struct dell_bios_hotkey_table, header);
488 hotkey_num = (table->header.length -
489 sizeof(struct dell_bios_hotkey_table)) /
490 sizeof(struct dell_bios_keymap_entry);
491 if (hotkey_num < 1) {
493 * Historically, dell-wmi would ignore a DMI entry of
494 * fewer than 7 bytes. Sizes between 4 and 8 bytes are
495 * nonsensical (both the header and all entries are 4
496 * bytes), so we approximate the old behavior by
497 * ignoring tables with fewer than one entry.
502 keymap = kcalloc(hotkey_num, sizeof(struct key_entry), GFP_KERNEL);
504 results->err = -ENOMEM;
508 for (i = 0; i < hotkey_num; i++) {
509 const struct dell_bios_keymap_entry *bios_entry =
512 /* Uninitialized entries are 0 aka KEY_RESERVED. */
513 u16 keycode = (bios_entry->keycode <
514 ARRAY_SIZE(bios_to_linux_keycode)) ?
515 bios_to_linux_keycode[bios_entry->keycode] :
516 (bios_entry->keycode == 0xffff ? KEY_UNKNOWN : KEY_RESERVED);
519 * Log if we find an entry in the DMI table that we don't
520 * understand. If this happens, we should figure out what
521 * the entry means and add it to bios_to_linux_keycode.
523 if (keycode == KEY_RESERVED) {
524 pr_info("firmware scancode 0x%x maps to unrecognized keycode 0x%x\n",
525 bios_entry->scancode, bios_entry->keycode);
529 if (keycode == KEY_KBDILLUMTOGGLE)
530 keymap[pos].type = KE_IGNORE;
532 keymap[pos].type = KE_KEY;
533 keymap[pos].code = bios_entry->scancode;
534 keymap[pos].keycode = keycode;
539 results->keymap = keymap;
540 results->keymap_size = pos;
543 static int dell_wmi_input_setup(struct wmi_device *wdev)
545 struct dell_wmi_priv *priv = dev_get_drvdata(&wdev->dev);
546 struct dell_dmi_results dmi_results = {};
547 struct key_entry *keymap;
550 priv->input_dev = input_allocate_device();
551 if (!priv->input_dev)
554 priv->input_dev->name = "Dell WMI hotkeys";
555 priv->input_dev->id.bustype = BUS_HOST;
556 priv->input_dev->dev.parent = &wdev->dev;
558 if (dmi_walk(handle_dmi_entry, &dmi_results)) {
560 * Historically, dell-wmi ignored dmi_walk errors. A failure
561 * is certainly surprising, but it probably just indicates
564 pr_warn("no DMI; using the old-style hotkey interface\n");
567 if (dmi_results.err) {
568 err = dmi_results.err;
572 keymap = kcalloc(dmi_results.keymap_size +
573 ARRAY_SIZE(dell_wmi_keymap_type_0000) +
574 ARRAY_SIZE(dell_wmi_keymap_type_0010) +
575 ARRAY_SIZE(dell_wmi_keymap_type_0011) +
576 ARRAY_SIZE(dell_wmi_keymap_type_0012) +
578 sizeof(struct key_entry), GFP_KERNEL);
580 kfree(dmi_results.keymap);
585 /* Append table with events of type 0x0010 which comes from DMI */
586 for (i = 0; i < dmi_results.keymap_size; i++) {
587 keymap[pos] = dmi_results.keymap[i];
588 keymap[pos].code |= (0x0010 << 16);
592 kfree(dmi_results.keymap);
594 /* Append table with extra events of type 0x0010 which are not in DMI */
595 for (i = 0; i < ARRAY_SIZE(dell_wmi_keymap_type_0010); i++) {
596 const struct key_entry *entry = &dell_wmi_keymap_type_0010[i];
599 * Check if we've already found this scancode. This takes
600 * quadratic time, but it doesn't matter unless the list
601 * of extra keys gets very long.
603 if (dmi_results.keymap_size &&
604 have_scancode(entry->code | (0x0010 << 16),
605 keymap, dmi_results.keymap_size)
609 keymap[pos] = *entry;
610 keymap[pos].code |= (0x0010 << 16);
614 /* Append table with events of type 0x0011 */
615 for (i = 0; i < ARRAY_SIZE(dell_wmi_keymap_type_0011); i++) {
616 keymap[pos] = dell_wmi_keymap_type_0011[i];
617 keymap[pos].code |= (0x0011 << 16);
621 /* Append table with events of type 0x0012 */
622 for (i = 0; i < ARRAY_SIZE(dell_wmi_keymap_type_0012); i++) {
623 keymap[pos] = dell_wmi_keymap_type_0012[i];
624 keymap[pos].code |= (0x0012 << 16);
629 * Now append also table with "legacy" events of type 0x0000. Some of
630 * them are reported also on laptops which have scancodes in DMI.
632 for (i = 0; i < ARRAY_SIZE(dell_wmi_keymap_type_0000); i++) {
633 keymap[pos] = dell_wmi_keymap_type_0000[i];
637 keymap[pos].type = KE_END;
639 err = sparse_keymap_setup(priv->input_dev, keymap, NULL);
641 * Sparse keymap library makes a copy of keymap so we don't need the
642 * original one that was allocated.
648 err = input_register_device(priv->input_dev);
655 input_free_device(priv->input_dev);
659 static void dell_wmi_input_destroy(struct wmi_device *wdev)
661 struct dell_wmi_priv *priv = dev_get_drvdata(&wdev->dev);
663 input_unregister_device(priv->input_dev);
667 * According to Dell SMBIOS documentation:
669 * 17 3 Application Program Registration
671 * cbArg1 Application ID 1 = 0x00010000
672 * cbArg2 Application ID 2
673 * QUICKSET/DCP = 0x51534554 "QSET"
674 * ALS Driver = 0x416c7353 "AlsS"
675 * Latitude ON = 0x4c6f6e52 "LonR"
676 * cbArg3 Application version or revision number
677 * cbArg4 0 = Unregister application
678 * 1 = Register application
679 * cbRes1 Standard return codes (0, -1, -2)
682 static int dell_wmi_events_set_enabled(bool enable)
684 struct calling_interface_buffer *buffer;
687 buffer = kzalloc(sizeof(struct calling_interface_buffer), GFP_KERNEL);
690 buffer->cmd_class = CLASS_INFO;
691 buffer->cmd_select = SELECT_APP_REGISTRATION;
692 buffer->input[0] = 0x10000;
693 buffer->input[1] = 0x51534554;
694 buffer->input[3] = enable;
695 ret = dell_smbios_call(buffer);
697 ret = buffer->output[0];
700 return dell_smbios_error(ret);
703 static int dell_wmi_probe(struct wmi_device *wdev, const void *context)
705 struct dell_wmi_priv *priv;
708 ret = dell_wmi_get_descriptor_valid();
713 &wdev->dev, sizeof(struct dell_wmi_priv), GFP_KERNEL);
716 dev_set_drvdata(&wdev->dev, priv);
718 if (!dell_wmi_get_interface_version(&priv->interface_version))
719 return -EPROBE_DEFER;
721 return dell_wmi_input_setup(wdev);
724 static void dell_wmi_remove(struct wmi_device *wdev)
726 dell_wmi_input_destroy(wdev);
728 static const struct wmi_device_id dell_wmi_id_table[] = {
729 { .guid_string = DELL_EVENT_GUID },
733 static struct wmi_driver dell_wmi_driver = {
737 .id_table = dell_wmi_id_table,
738 .probe = dell_wmi_probe,
739 .remove = dell_wmi_remove,
740 .notify = dell_wmi_notify,
743 static int __init dell_wmi_init(void)
747 dmi_check_system(dell_wmi_smbios_list);
749 if (wmi_requires_smbios_request) {
750 err = dell_wmi_events_set_enabled(true);
752 pr_err("Failed to enable WMI events\n");
757 err = dell_privacy_register_driver();
761 return wmi_driver_register(&dell_wmi_driver);
763 late_initcall(dell_wmi_init);
765 static void __exit dell_wmi_exit(void)
767 if (wmi_requires_smbios_request)
768 dell_wmi_events_set_enabled(false);
770 wmi_driver_unregister(&dell_wmi_driver);
771 dell_privacy_unregister_driver();
773 module_exit(dell_wmi_exit);
775 MODULE_DEVICE_TABLE(wmi, dell_wmi_id_table);