4 * Copyright (C) 2008 Red Hat <mjg@redhat.com>
5 * Copyright (C) 2014-2015 Pali Rohár <pali.rohar@gmail.com>
7 * Portions based on wistron_btns.c:
8 * Copyright (C) 2005 Miloslav Trmac <mitr@volny.cz>
9 * Copyright (C) 2005 Bernhard Rosenkraenzer <bero@arklinux.org>
10 * Copyright (C) 2005 Dmitry Torokhov <dtor@mail.ru>
12 * This program is free software; you can redistribute it and/or modify
13 * it under the terms of the GNU General Public License as published by
14 * the Free Software Foundation; either version 2 of the License, or
15 * (at your option) any later version.
17 * This program is distributed in the hope that it will be useful,
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 * GNU General Public License for more details.
22 * You should have received a copy of the GNU General Public License
23 * along with this program; if not, write to the Free Software
24 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
27 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
29 #include <linux/kernel.h>
30 #include <linux/module.h>
31 #include <linux/init.h>
32 #include <linux/slab.h>
33 #include <linux/types.h>
34 #include <linux/input.h>
35 #include <linux/input/sparse-keymap.h>
36 #include <linux/acpi.h>
37 #include <linux/string.h>
38 #include <linux/dmi.h>
39 #include <acpi/video.h>
41 MODULE_AUTHOR("Matthew Garrett <mjg@redhat.com>");
42 MODULE_AUTHOR("Pali Rohár <pali.rohar@gmail.com>");
43 MODULE_DESCRIPTION("Dell laptop WMI hotkeys driver");
44 MODULE_LICENSE("GPL");
46 #define DELL_EVENT_GUID "9DBB5994-A997-11DA-B012-B622A1EF5492"
47 #define DELL_DESCRIPTOR_GUID "8D9DDCBC-A997-11DA-B012-B622A1EF5492"
49 static u32 dell_wmi_interface_version
;
51 MODULE_ALIAS("wmi:"DELL_EVENT_GUID
);
52 MODULE_ALIAS("wmi:"DELL_DESCRIPTOR_GUID
);
55 * Certain keys are flagged as KE_IGNORE. All of these are either
56 * notifications (rather than requests for change) or are also sent
57 * via the keyboard controller so should not be sent again.
60 static const struct key_entry dell_wmi_legacy_keymap
[] __initconst
= {
61 { KE_IGNORE
, 0x003a, { KEY_CAPSLOCK
} },
63 { KE_KEY
, 0xe045, { KEY_PROG1
} },
64 { KE_KEY
, 0xe009, { KEY_EJECTCD
} },
66 /* These also contain the brightness level at offset 6 */
67 { KE_KEY
, 0xe006, { KEY_BRIGHTNESSUP
} },
68 { KE_KEY
, 0xe005, { KEY_BRIGHTNESSDOWN
} },
70 /* Battery health status button */
71 { KE_KEY
, 0xe007, { KEY_BATTERY
} },
73 /* Radio devices state change */
74 { KE_IGNORE
, 0xe008, { KEY_RFKILL
} },
76 /* The next device is at offset 6, the active devices are at
77 offset 8 and the attached devices at offset 10 */
78 { KE_KEY
, 0xe00b, { KEY_SWITCHVIDEOMODE
} },
80 { KE_IGNORE
, 0xe00c, { KEY_KBDILLUMTOGGLE
} },
82 /* BIOS error detected */
83 { KE_IGNORE
, 0xe00d, { KEY_RESERVED
} },
86 { KE_KEY
, 0xe011, {KEY_PROG2
} },
88 /* Ambient light sensor toggle */
89 { KE_IGNORE
, 0xe013, { KEY_RESERVED
} },
91 { KE_IGNORE
, 0xe020, { KEY_MUTE
} },
93 /* Shortcut and audio panel keys */
94 { KE_IGNORE
, 0xe025, { KEY_RESERVED
} },
95 { KE_IGNORE
, 0xe026, { KEY_RESERVED
} },
97 { KE_IGNORE
, 0xe02e, { KEY_VOLUMEDOWN
} },
98 { KE_IGNORE
, 0xe030, { KEY_VOLUMEUP
} },
99 { KE_IGNORE
, 0xe033, { KEY_KBDILLUMUP
} },
100 { KE_IGNORE
, 0xe034, { KEY_KBDILLUMDOWN
} },
101 { KE_IGNORE
, 0xe03a, { KEY_CAPSLOCK
} },
102 { KE_IGNORE
, 0xe045, { KEY_NUMLOCK
} },
103 { KE_IGNORE
, 0xe046, { KEY_SCROLLLOCK
} },
104 { KE_IGNORE
, 0xe0f7, { KEY_MUTE
} },
105 { KE_IGNORE
, 0xe0f8, { KEY_VOLUMEDOWN
} },
106 { KE_IGNORE
, 0xe0f9, { KEY_VOLUMEUP
} },
110 static bool dell_new_hk_type
;
112 struct dell_bios_keymap_entry
{
117 struct dell_bios_hotkey_table
{
118 struct dmi_header header
;
119 struct dell_bios_keymap_entry keymap
[];
123 static const struct dell_bios_hotkey_table
*dell_bios_hotkey_table
;
125 /* Uninitialized entries here are KEY_RESERVED == 0. */
126 static const u16 bios_to_linux_keycode
[256] __initconst
= {
130 [3] = KEY_PREVIOUSSONG
,
137 [10] = KEY_VOLUMEDOWN
,
146 [19] = KEY_BRIGHTNESSDOWN
,
147 [20] = KEY_BRIGHTNESSUP
,
149 [22] = KEY_KBDILLUMTOGGLE
,
151 [24] = KEY_SWITCHVIDEOMODE
,
154 [27] = KEY_SWITCHVIDEOMODE
,
169 static struct input_dev
*dell_wmi_input_dev
;
171 static void dell_wmi_process_key(int reported_key
)
173 const struct key_entry
*key
;
175 key
= sparse_keymap_entry_from_scancode(dell_wmi_input_dev
,
178 pr_info("Unknown key with scancode 0x%x pressed\n",
183 pr_debug("Key %x pressed\n", reported_key
);
185 /* Don't report brightness notifications that will also come via ACPI */
186 if ((key
->keycode
== KEY_BRIGHTNESSUP
||
187 key
->keycode
== KEY_BRIGHTNESSDOWN
) &&
188 acpi_video_handles_brightness_key_presses())
191 sparse_keymap_report_entry(dell_wmi_input_dev
, key
, 1, true);
194 static void dell_wmi_notify(u32 value
, void *context
)
196 struct acpi_buffer response
= { ACPI_ALLOCATE_BUFFER
, NULL
};
197 union acpi_object
*obj
;
199 acpi_size buffer_size
;
200 u16
*buffer_entry
, *buffer_end
;
203 status
= wmi_get_event_data(value
, &response
);
204 if (status
!= AE_OK
) {
205 pr_warn("bad event status 0x%x\n", status
);
209 obj
= (union acpi_object
*)response
.pointer
;
211 pr_warn("no response\n");
215 if (obj
->type
!= ACPI_TYPE_BUFFER
) {
216 pr_warn("bad response type %x\n", obj
->type
);
221 pr_debug("Received WMI event (%*ph)\n",
222 obj
->buffer
.length
, obj
->buffer
.pointer
);
224 buffer_entry
= (u16
*)obj
->buffer
.pointer
;
225 buffer_size
= obj
->buffer
.length
/2;
227 if (!dell_new_hk_type
) {
228 if (buffer_size
>= 3 && buffer_entry
[1] == 0x0)
229 dell_wmi_process_key(buffer_entry
[2]);
230 else if (buffer_size
>= 2)
231 dell_wmi_process_key(buffer_entry
[1]);
233 pr_info("Received unknown WMI event\n");
238 buffer_end
= buffer_entry
+ buffer_size
;
241 * BIOS/ACPI on devices with WMI interface version 0 does not clear
242 * buffer before filling it. So next time when BIOS/ACPI send WMI event
243 * which is smaller as previous then it contains garbage in buffer from
246 * BIOS/ACPI on devices with WMI interface version 1 clears buffer and
247 * sometimes send more events in buffer at one call.
249 * So to prevent reading garbage from buffer we will process only first
250 * one event on devices with WMI interface version 0.
252 if (dell_wmi_interface_version
== 0 && buffer_entry
< buffer_end
)
253 if (buffer_end
> buffer_entry
+ buffer_entry
[0] + 1)
254 buffer_end
= buffer_entry
+ buffer_entry
[0] + 1;
256 while (buffer_entry
< buffer_end
) {
258 len
= buffer_entry
[0];
264 if (buffer_entry
+ len
> buffer_end
) {
265 pr_warn("Invalid length of WMI event\n");
269 pr_debug("Process buffer (%*ph)\n", len
*2, buffer_entry
);
271 switch (buffer_entry
[1]) {
273 for (i
= 2; i
< len
; ++i
) {
274 switch (buffer_entry
[i
]) {
277 pr_debug("NIC Link is Up\n");
280 /* NIC Link is Down */
281 pr_debug("NIC Link is Down\n");
284 /* Unknown event but defined in DSDT */
287 pr_info("Unknown WMI event type 0x00: "
288 "0x%x\n", (int)buffer_entry
[i
]);
295 for (i
= 2; i
< len
; ++i
)
296 dell_wmi_process_key(buffer_entry
[i
]);
299 for (i
= 2; i
< len
; ++i
) {
300 switch (buffer_entry
[i
]) {
302 /* Battery unplugged */
303 pr_debug("Battery unplugged\n");
306 /* Battery inserted */
307 pr_debug("Battery inserted\n");
314 /* Keyboard backlight level changed */
315 pr_debug("Keyboard backlight level "
320 pr_info("Unknown WMI event type 0x11: "
321 "0x%x\n", (int)buffer_entry
[i
]);
328 pr_info("Unknown WMI event type 0x%x\n",
329 (int)buffer_entry
[1]);
340 static const struct key_entry
* __init
dell_wmi_prepare_new_keymap(void)
342 int hotkey_num
= (dell_bios_hotkey_table
->header
.length
- 4) /
343 sizeof(struct dell_bios_keymap_entry
);
344 struct key_entry
*keymap
;
347 keymap
= kcalloc(hotkey_num
+ 1, sizeof(struct key_entry
), GFP_KERNEL
);
351 for (i
= 0; i
< hotkey_num
; i
++) {
352 const struct dell_bios_keymap_entry
*bios_entry
=
353 &dell_bios_hotkey_table
->keymap
[i
];
355 /* Uninitialized entries are 0 aka KEY_RESERVED. */
356 u16 keycode
= (bios_entry
->keycode
<
357 ARRAY_SIZE(bios_to_linux_keycode
)) ?
358 bios_to_linux_keycode
[bios_entry
->keycode
] :
362 * Log if we find an entry in the DMI table that we don't
363 * understand. If this happens, we should figure out what
364 * the entry means and add it to bios_to_linux_keycode.
366 if (keycode
== KEY_RESERVED
) {
367 pr_info("firmware scancode 0x%x maps to unrecognized keycode 0x%x\n",
368 bios_entry
->scancode
, bios_entry
->keycode
);
372 if (keycode
== KEY_KBDILLUMTOGGLE
)
373 keymap
[i
].type
= KE_IGNORE
;
375 keymap
[i
].type
= KE_KEY
;
376 keymap
[i
].code
= bios_entry
->scancode
;
377 keymap
[i
].keycode
= keycode
;
380 keymap
[hotkey_num
].type
= KE_END
;
385 static int __init
dell_wmi_input_setup(void)
389 dell_wmi_input_dev
= input_allocate_device();
390 if (!dell_wmi_input_dev
)
393 dell_wmi_input_dev
->name
= "Dell WMI hotkeys";
394 dell_wmi_input_dev
->phys
= "wmi/input0";
395 dell_wmi_input_dev
->id
.bustype
= BUS_HOST
;
397 if (dell_new_hk_type
) {
398 const struct key_entry
*keymap
= dell_wmi_prepare_new_keymap();
404 err
= sparse_keymap_setup(dell_wmi_input_dev
, keymap
, NULL
);
407 * Sparse keymap library makes a copy of keymap so we
408 * don't need the original one that was allocated.
412 err
= sparse_keymap_setup(dell_wmi_input_dev
,
413 dell_wmi_legacy_keymap
, NULL
);
418 err
= input_register_device(dell_wmi_input_dev
);
420 goto err_free_keymap
;
425 sparse_keymap_free(dell_wmi_input_dev
);
427 input_free_device(dell_wmi_input_dev
);
431 static void dell_wmi_input_destroy(void)
433 sparse_keymap_free(dell_wmi_input_dev
);
434 input_unregister_device(dell_wmi_input_dev
);
437 static void __init
find_hk_type(const struct dmi_header
*dm
, void *dummy
)
439 if (dm
->type
== 0xb2 && dm
->length
> 6) {
440 dell_new_hk_type
= true;
441 dell_bios_hotkey_table
=
442 container_of(dm
, struct dell_bios_hotkey_table
, header
);
447 * Descriptor buffer is 128 byte long and contains:
449 * Name Offset Length Value
450 * Vendor Signature 0 4 "DELL"
451 * Object Signature 4 4 " WMI"
452 * WMI Interface Version 8 4 <version>
453 * WMI buffer length 12 4 4096
455 static int __init
dell_wmi_check_descriptor_buffer(void)
457 struct acpi_buffer out
= { ACPI_ALLOCATE_BUFFER
, NULL
};
458 union acpi_object
*obj
;
462 status
= wmi_query_block(DELL_DESCRIPTOR_GUID
, 0, &out
);
463 if (ACPI_FAILURE(status
)) {
464 pr_err("Cannot read Dell descriptor buffer - %d\n", status
);
468 obj
= (union acpi_object
*)out
.pointer
;
470 pr_err("Dell descriptor buffer is empty\n");
474 if (obj
->type
!= ACPI_TYPE_BUFFER
) {
475 pr_err("Cannot read Dell descriptor buffer\n");
480 if (obj
->buffer
.length
!= 128) {
481 pr_err("Dell descriptor buffer has invalid length (%d)\n",
483 if (obj
->buffer
.length
< 16) {
489 buffer
= (u32
*)obj
->buffer
.pointer
;
491 if (buffer
[0] != 0x4C4C4544 && buffer
[1] != 0x494D5720)
492 pr_warn("Dell descriptor buffer has invalid signature (%*ph)\n",
495 if (buffer
[2] != 0 && buffer
[2] != 1)
496 pr_warn("Dell descriptor buffer has unknown version (%d)\n",
499 if (buffer
[3] != 4096)
500 pr_warn("Dell descriptor buffer has invalid buffer length (%d)\n",
503 dell_wmi_interface_version
= buffer
[2];
505 pr_info("Detected Dell WMI interface version %u\n",
506 dell_wmi_interface_version
);
512 static int __init
dell_wmi_init(void)
517 if (!wmi_has_guid(DELL_EVENT_GUID
) ||
518 !wmi_has_guid(DELL_DESCRIPTOR_GUID
)) {
519 pr_warn("Dell WMI GUID were not found\n");
523 err
= dell_wmi_check_descriptor_buffer();
527 dmi_walk(find_hk_type
, NULL
);
529 err
= dell_wmi_input_setup();
533 status
= wmi_install_notify_handler(DELL_EVENT_GUID
,
534 dell_wmi_notify
, NULL
);
535 if (ACPI_FAILURE(status
)) {
536 dell_wmi_input_destroy();
537 pr_err("Unable to register notify handler - %d\n", status
);
543 module_init(dell_wmi_init
);
545 static void __exit
dell_wmi_exit(void)
547 wmi_remove_notify_handler(DELL_EVENT_GUID
);
548 dell_wmi_input_destroy();
550 module_exit(dell_wmi_exit
);