cregit-Linux how code gets into the kernel

Release 4.7 drivers/platform/x86/dell-wmi.c

/*
 * Dell WMI hotkeys
 *
 * Copyright (C) 2008 Red Hat <mjg@redhat.com>
 * Copyright (C) 2014-2015 Pali Rohár <pali.rohar@gmail.com>
 *
 * Portions based on wistron_btns.c:
 * Copyright (C) 2005 Miloslav Trmac <mitr@volny.cz>
 * Copyright (C) 2005 Bernhard Rosenkraenzer <bero@arklinux.org>
 * Copyright (C) 2005 Dmitry Torokhov <dtor@mail.ru>
 *
 *  This program is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 2 of the License, or
 *  (at your option) any later version.
 *
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with this program; if not, write to the Free Software
 *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */


#define pr_fmt(fmt) KBUILD_MODNAME ": " fmt

#include <linux/kernel.h>
#include <linux/module.h>
#include <linux/init.h>
#include <linux/slab.h>
#include <linux/types.h>
#include <linux/input.h>
#include <linux/input/sparse-keymap.h>
#include <linux/acpi.h>
#include <linux/string.h>
#include <linux/dmi.h>
#include <acpi/video.h>
#include "dell-smbios.h"

MODULE_AUTHOR("Matthew Garrett <mjg@redhat.com>");
MODULE_AUTHOR("Pali Rohár <pali.rohar@gmail.com>");
MODULE_DESCRIPTION("Dell laptop WMI hotkeys driver");
MODULE_LICENSE("GPL");


#define DELL_EVENT_GUID "9DBB5994-A997-11DA-B012-B622A1EF5492"

#define DELL_DESCRIPTOR_GUID "8D9DDCBC-A997-11DA-B012-B622A1EF5492"


static u32 dell_wmi_interface_version;

static bool wmi_requires_smbios_request;

MODULE_ALIAS("wmi:"DELL_EVENT_GUID);
MODULE_ALIAS("wmi:"DELL_DESCRIPTOR_GUID);


static int __init dmi_matched(const struct dmi_system_id *dmi) { wmi_requires_smbios_request = 1; return 1; }

Contributors

PersonTokensPropCommitsCommitProp
michal kepienmichal kepien20100.00%1100.00%
Total20100.00%1100.00%

static const struct dmi_system_id dell_wmi_smbios_list[] __initconst = { { .callback = dmi_matched, .ident = "Dell Inspiron M5110", .matches = { DMI_MATCH(DMI_SYS_VENDOR, "Dell Inc."), DMI_MATCH(DMI_PRODUCT_NAME, "Inspiron M5110"), }, }, { .callback = dmi_matched, .ident = "Dell Vostro V131", .matches = { DMI_MATCH(DMI_SYS_VENDOR, "Dell Inc."), DMI_MATCH(DMI_PRODUCT_NAME, "Vostro V131"), }, }, { } }; /* * Certain keys are flagged as KE_IGNORE. All of these are either * notifications (rather than requests for change) or are also sent * via the keyboard controller so should not be sent again. */ static const struct key_entry dell_wmi_legacy_keymap[] __initconst = { { KE_IGNORE, 0x003a, { KEY_CAPSLOCK } }, { KE_KEY, 0xe045, { KEY_PROG1 } }, { KE_KEY, 0xe009, { KEY_EJECTCD } }, /* These also contain the brightness level at offset 6 */ { KE_KEY, 0xe006, { KEY_BRIGHTNESSUP } }, { KE_KEY, 0xe005, { KEY_BRIGHTNESSDOWN } }, /* Battery health status button */ { KE_KEY, 0xe007, { KEY_BATTERY } }, /* Radio devices state change */ { KE_IGNORE, 0xe008, { KEY_RFKILL } }, /* The next device is at offset 6, the active devices are at offset 8 and the attached devices at offset 10 */ { KE_KEY, 0xe00b, { KEY_SWITCHVIDEOMODE } }, { KE_IGNORE, 0xe00c, { KEY_KBDILLUMTOGGLE } }, /* BIOS error detected */ { KE_IGNORE, 0xe00d, { KEY_RESERVED } }, /* Wifi Catcher */ { KE_KEY, 0xe011, {KEY_PROG2 } }, /* Ambient light sensor toggle */ { KE_IGNORE, 0xe013, { KEY_RESERVED } }, { KE_IGNORE, 0xe020, { KEY_MUTE } }, /* Dell Instant Launch key */ { KE_KEY, 0xe025, { KEY_PROG4 } }, { KE_KEY, 0xe029, { KEY_PROG4 } }, /* Audio panel key */ { KE_IGNORE, 0xe026, { KEY_RESERVED } }, { KE_IGNORE, 0xe02e, { KEY_VOLUMEDOWN } }, { KE_IGNORE, 0xe030, { KEY_VOLUMEUP } }, { KE_IGNORE, 0xe033, { KEY_KBDILLUMUP } }, { KE_IGNORE, 0xe034, { KEY_KBDILLUMDOWN } }, { KE_IGNORE, 0xe03a, { KEY_CAPSLOCK } }, { KE_IGNORE, 0xe045, { KEY_NUMLOCK } }, { KE_IGNORE, 0xe046, { KEY_SCROLLLOCK } }, { KE_IGNORE, 0xe0f7, { KEY_MUTE } }, { KE_IGNORE, 0xe0f8, { KEY_VOLUMEDOWN } }, { KE_IGNORE, 0xe0f9, { KEY_VOLUMEUP } }, { KE_END, 0 } }; static bool dell_new_hk_type; struct dell_bios_keymap_entry { u16 scancode; u16 keycode; }; struct dell_bios_hotkey_table { struct dmi_header header; struct dell_bios_keymap_entry keymap[]; }; struct dell_dmi_results { int err; struct key_entry *keymap; }; /* Uninitialized entries here are KEY_RESERVED == 0. */ static const u16 bios_to_linux_keycode[256] __initconst = { [0] = KEY_MEDIA, [1] = KEY_NEXTSONG, [2] = KEY_PLAYPAUSE, [3] = KEY_PREVIOUSSONG, [4] = KEY_STOPCD, [5] = KEY_UNKNOWN, [6] = KEY_UNKNOWN, [7] = KEY_UNKNOWN, [8] = KEY_WWW, [9] = KEY_UNKNOWN, [10] = KEY_VOLUMEDOWN, [11] = KEY_MUTE, [12] = KEY_VOLUMEUP, [13] = KEY_UNKNOWN, [14] = KEY_BATTERY, [15] = KEY_EJECTCD, [16] = KEY_UNKNOWN, [17] = KEY_SLEEP, [18] = KEY_PROG1, [19] = KEY_BRIGHTNESSDOWN, [20] = KEY_BRIGHTNESSUP, [21] = KEY_UNKNOWN, [22] = KEY_KBDILLUMTOGGLE, [23] = KEY_UNKNOWN, [24] = KEY_SWITCHVIDEOMODE, [25] = KEY_UNKNOWN, [26] = KEY_UNKNOWN, [27] = KEY_SWITCHVIDEOMODE, [28] = KEY_UNKNOWN, [29] = KEY_UNKNOWN, [30] = KEY_PROG2, [31] = KEY_UNKNOWN, [32] = KEY_UNKNOWN, [33] = KEY_UNKNOWN, [34] = KEY_UNKNOWN, [35] = KEY_UNKNOWN, [36] = KEY_UNKNOWN, [37] = KEY_UNKNOWN, [38] = KEY_MICMUTE, [255] = KEY_PROG3, }; /* * These are applied if the 0xB2 DMI hotkey table is present and doesn't * override them. */ static const struct key_entry dell_wmi_extra_keymap[] __initconst = { /* Fn-lock */ { KE_IGNORE, 0x151, { KEY_RESERVED } }, /* Change keyboard illumination */ { KE_IGNORE, 0x152, { KEY_KBDILLUMTOGGLE } }, /* * Radio disable (notify only -- there is no model for which the * WMI event is supposed to trigger an action). */ { KE_IGNORE, 0x153, { KEY_RFKILL } }, /* RGB keyboard backlight control */ { KE_IGNORE, 0x154, { KEY_RESERVED } }, /* Stealth mode toggle */ { KE_IGNORE, 0x155, { KEY_RESERVED } }, }; static struct input_dev *dell_wmi_input_dev;
static void dell_wmi_process_key(int reported_key) { const struct key_entry *key; key = sparse_keymap_entry_from_scancode(dell_wmi_input_dev, reported_key); if (!key) { pr_info("Unknown key with scancode 0x%x pressed\n", reported_key); return; } pr_debug("Key %x pressed\n", reported_key); /* Don't report brightness notifications that will also come via ACPI */ if ((key->keycode == KEY_BRIGHTNESSUP || key->keycode == KEY_BRIGHTNESSDOWN) && acpi_video_handles_brightness_key_presses()) return; if (reported_key == 0xe025 && !wmi_requires_smbios_request) return; sparse_keymap_report_entry(dell_wmi_input_dev, key, 1, true); }

Contributors

PersonTokensPropCommitsCommitProp
pali roharpali rohar7585.23%125.00%
michal kepienmichal kepien1011.36%125.00%
hans de goedehans de goede22.27%125.00%
andy lutomirskiandy lutomirski11.14%125.00%
Total88100.00%4100.00%


static void dell_wmi_notify(u32 value, void *context) { struct acpi_buffer response = { ACPI_ALLOCATE_BUFFER, NULL }; union acpi_object *obj; acpi_status status; acpi_size buffer_size; u16 *buffer_entry, *buffer_end; int len, i; status = wmi_get_event_data(value, &response); if (status != AE_OK) { pr_warn("bad event status 0x%x\n", status); return; } obj = (union acpi_object *)response.pointer; if (!obj) { pr_warn("no response\n"); return; } if (obj->type != ACPI_TYPE_BUFFER) { pr_warn("bad response type %x\n", obj->type); kfree(obj); return; } pr_debug("Received WMI event (%*ph)\n", obj->buffer.length, obj->buffer.pointer); buffer_entry = (u16 *)obj->buffer.pointer; buffer_size = obj->buffer.length/2; if (!dell_new_hk_type) { if (buffer_size >= 3 && buffer_entry[1] == 0x0) dell_wmi_process_key(buffer_entry[2]); else if (buffer_size >= 2) dell_wmi_process_key(buffer_entry[1]); else pr_info("Received unknown WMI event\n"); kfree(obj); return; } buffer_end = buffer_entry + buffer_size; /* * BIOS/ACPI on devices with WMI interface version 0 does not clear * buffer before filling it. So next time when BIOS/ACPI send WMI event * which is smaller as previous then it contains garbage in buffer from * previous event. * * BIOS/ACPI on devices with WMI interface version 1 clears buffer and * sometimes send more events in buffer at one call. * * So to prevent reading garbage from buffer we will process only first * one event on devices with WMI interface version 0. */ if (dell_wmi_interface_version == 0 && buffer_entry < buffer_end) if (buffer_end > buffer_entry + buffer_entry[0] + 1) buffer_end = buffer_entry + buffer_entry[0] + 1; while (buffer_entry < buffer_end) { len = buffer_entry[0]; if (len == 0) break; len++; if (buffer_entry + len > buffer_end) { pr_warn("Invalid length of WMI event\n"); break; } pr_debug("Process buffer (%*ph)\n", len*2, buffer_entry); switch (buffer_entry[1]) { case 0x00: for (i = 2; i < len; ++i) { switch (buffer_entry[i]) { case 0xe043: /* NIC Link is Up */ pr_debug("NIC Link is Up\n"); break; case 0xe044: /* NIC Link is Down */ pr_debug("NIC Link is Down\n"); break; case 0xe045: /* Unknown event but defined in DSDT */ default: /* Unknown event */ pr_info("Unknown WMI event type 0x00: " "0x%x\n", (int)buffer_entry[i]); break; } } break; case 0x10: /* Keys pressed */ for (i = 2; i < len; ++i) dell_wmi_process_key(buffer_entry[i]); break; case 0x11: for (i = 2; i < len; ++i) { switch (buffer_entry[i]) { case 0xfff0: /* Battery unplugged */ pr_debug("Battery unplugged\n"); break; case 0xfff1: /* Battery inserted */ pr_debug("Battery inserted\n"); break; case 0x01e1: case 0x02ea: case 0x02eb: case 0x02ec: case 0x02f6: /* Keyboard backlight level changed */ pr_debug("Keyboard backlight level " "changed\n"); break; default: /* Unknown event */ pr_info("Unknown WMI event type 0x11: " "0x%x\n", (int)buffer_entry[i]); break; } } break; default: /* Unknown event */ pr_info("Unknown WMI event type 0x%x\n", (int)buffer_entry[1]); break; } buffer_entry += len; } kfree(obj); }

Contributors

PersonTokensPropCommitsCommitProp
pali roharpali rohar38573.33%333.33%
dmitry torokhovdmitry torokhov6712.76%111.11%
matthew garrettmatthew garrett366.86%111.11%
rezwanul kabirrezwanul kabir244.57%111.11%
islam amerislam amer61.14%111.11%
anisse astieranisse astier50.95%111.11%
joe perchesjoe perches20.38%111.11%
Total525100.00%9100.00%


static bool have_scancode(u32 scancode, const struct key_entry *keymap, int len) { int i; for (i = 0; i < len; i++) if (keymap[i].code == scancode) return true; return false; }

Contributors

PersonTokensPropCommitsCommitProp
andy lutomirskiandy lutomirski51100.00%1100.00%
Total51100.00%1100.00%


static void __init handle_dmi_entry(const struct dmi_header *dm, void *opaque) { struct dell_dmi_results *results = opaque; struct dell_bios_hotkey_table *table; int hotkey_num, i, pos = 0; struct key_entry *keymap; int num_bios_keys; if (results->err || results->keymap) return; /* We already found the hotkey table. */ if (dm->type != 0xb2) return; table = container_of(dm, struct dell_bios_hotkey_table, header); hotkey_num = (table->header.length - sizeof(struct dell_bios_hotkey_table)) / sizeof(struct dell_bios_keymap_entry); if (hotkey_num < 1) { /* * Historically, dell-wmi would ignore a DMI entry of * fewer than 7 bytes. Sizes between 4 and 8 bytes are * nonsensical (both the header and all entries are 4 * bytes), so we approximate the old behavior by * ignoring tables with fewer than one entry. */ return; } keymap = kcalloc(hotkey_num + ARRAY_SIZE(dell_wmi_extra_keymap) + 1, sizeof(struct key_entry), GFP_KERNEL); if (!keymap) { results->err = -ENOMEM; return; } for (i = 0; i < hotkey_num; i++) { const struct dell_bios_keymap_entry *bios_entry = &table->keymap[i]; /* Uninitialized entries are 0 aka KEY_RESERVED. */ u16 keycode = (bios_entry->keycode < ARRAY_SIZE(bios_to_linux_keycode)) ? bios_to_linux_keycode[bios_entry->keycode] : KEY_RESERVED; /* * Log if we find an entry in the DMI table that we don't * understand. If this happens, we should figure out what * the entry means and add it to bios_to_linux_keycode. */ if (keycode == KEY_RESERVED) { pr_info("firmware scancode 0x%x maps to unrecognized keycode 0x%x\n", bios_entry->scancode, bios_entry->keycode); continue; } if (keycode == KEY_KBDILLUMTOGGLE) keymap[pos].type = KE_IGNORE; else keymap[pos].type = KE_KEY; keymap[pos].code = bios_entry->scancode; keymap[pos].keycode = keycode; pos++; } num_bios_keys = pos; for (i = 0; i < ARRAY_SIZE(dell_wmi_extra_keymap); i++) { const struct key_entry *entry = &dell_wmi_extra_keymap[i]; /* * Check if we've already found this scancode. This takes * quadratic time, but it doesn't matter unless the list * of extra keys gets very long. */ if (!have_scancode(entry->code, keymap, num_bios_keys)) { keymap[pos] = *entry; pos++; } } keymap[pos].type = KE_END; results->keymap = keymap; }

Contributors

PersonTokensPropCommitsCommitProp
andy lutomirskiandy lutomirski21060.17%444.44%
rezwanul kabirrezwanul kabir6217.77%111.11%
dmitry torokhovdmitry torokhov3810.89%111.11%
gabriele mazzottagabriele mazzotta329.17%111.11%
matthew garrettmatthew garrett72.01%222.22%
Total349100.00%9100.00%


static int __init dell_wmi_input_setup(void) { struct dell_dmi_results dmi_results = {}; int err; dell_wmi_input_dev = input_allocate_device(); if (!dell_wmi_input_dev) return -ENOMEM; dell_wmi_input_dev->name = "Dell WMI hotkeys"; dell_wmi_input_dev->phys = "wmi/input0"; dell_wmi_input_dev->id.bustype = BUS_HOST; if (dmi_walk(handle_dmi_entry, &dmi_results)) { /* * Historically, dell-wmi ignored dmi_walk errors. A failure * is certainly surprising, but it probably just indicates * a very old laptop. */ pr_warn("no DMI; using the old-style hotkey interface\n"); } if (dmi_results.err) { err = dmi_results.err; goto err_free_dev; } if (dmi_results.keymap) { dell_new_hk_type = true; err = sparse_keymap_setup(dell_wmi_input_dev, dmi_results.keymap, NULL); /* * Sparse keymap library makes a copy of keymap so we * don't need the original one that was allocated. */ kfree(dmi_results.keymap); } else { err = sparse_keymap_setup(dell_wmi_input_dev, dell_wmi_legacy_keymap, NULL); } if (err) goto err_free_dev; err = input_register_device(dell_wmi_input_dev); if (err) goto err_free_keymap; return 0; err_free_keymap: sparse_keymap_free(dell_wmi_input_dev); err_free_dev: input_free_device(dell_wmi_input_dev); return err; }

Contributors

PersonTokensPropCommitsCommitProp
matthew garrettmatthew garrett8246.86%133.33%
dmitry torokhovdmitry torokhov5229.71%133.33%
andy lutomirskiandy lutomirski4123.43%133.33%
Total175100.00%3100.00%


static void dell_wmi_input_destroy(void) { sparse_keymap_free(dell_wmi_input_dev); input_unregister_device(dell_wmi_input_dev); }

Contributors

PersonTokensPropCommitsCommitProp
dmitry torokhovdmitry torokhov18100.00%1100.00%
Total18100.00%1100.00%

/* * Descriptor buffer is 128 byte long and contains: * * Name Offset Length Value * Vendor Signature 0 4 "DELL" * Object Signature 4 4 " WMI" * WMI Interface Version 8 4 <version> * WMI buffer length 12 4 4096 */
static int __init dell_wmi_check_descriptor_buffer(void) { struct acpi_buffer out = { ACPI_ALLOCATE_BUFFER, NULL }; union acpi_object *obj; acpi_status status; u32 *buffer; status = wmi_query_block(DELL_DESCRIPTOR_GUID, 0, &out); if (ACPI_FAILURE(status)) { pr_err("Cannot read Dell descriptor buffer - %d\n", status); return status; } obj = (union acpi_object *)out.pointer; if (!obj) { pr_err("Dell descriptor buffer is empty\n"); return -EINVAL; } if (obj->type != ACPI_TYPE_BUFFER) { pr_err("Cannot read Dell descriptor buffer\n"); kfree(obj); return -EINVAL; } if (obj->buffer.length != 128) { pr_err("Dell descriptor buffer has invalid length (%d)\n", obj->buffer.length); if (obj->buffer.length < 16) { kfree(obj); return -EINVAL; } } buffer = (u32 *)obj->buffer.pointer; if (buffer[0] != 0x4C4C4544 && buffer[1] != 0x494D5720) pr_warn("Dell descriptor buffer has invalid signature (%*ph)\n", 8, buffer); if (buffer[2] != 0 && buffer[2] != 1) pr_warn("Dell descriptor buffer has unknown version (%d)\n", buffer[2]); if (buffer[3] != 4096) pr_warn("Dell descriptor buffer has invalid buffer length (%d)\n", buffer[3]); dell_wmi_interface_version = buffer[2]; pr_info("Detected Dell WMI interface version %u\n", dell_wmi_interface_version); kfree(obj); return 0; }

Contributors

PersonTokensPropCommitsCommitProp
pali roharpali rohar261100.00%1100.00%
Total261100.00%1100.00%

/* * According to Dell SMBIOS documentation: * * 17 3 Application Program Registration * * cbArg1 Application ID 1 = 0x00010000 * cbArg2 Application ID 2 * QUICKSET/DCP = 0x51534554 "QSET" * ALS Driver = 0x416c7353 "AlsS" * Latitude ON = 0x4c6f6e52 "LonR" * cbArg3 Application version or revision number * cbArg4 0 = Unregister application * 1 = Register application * cbRes1 Standard return codes (0, -1, -2) */
static int dell_wmi_events_set_enabled(bool enable) { struct calling_interface_buffer *buffer; int ret; buffer = dell_smbios_get_buffer(); buffer->input[0] = 0x10000; buffer->input[1] = 0x51534554; buffer->input[3] = enable; dell_smbios_send_request(17, 3); ret = buffer->output[0]; dell_smbios_release_buffer(); return dell_smbios_error(ret); }

Contributors

PersonTokensPropCommitsCommitProp
michal kepienmichal kepien74100.00%1100.00%
Total74100.00%1100.00%


static int __init dell_wmi_init(void) { int err; acpi_status status; if (!wmi_has_guid(DELL_EVENT_GUID) || !wmi_has_guid(DELL_DESCRIPTOR_GUID)) { pr_warn("Dell WMI GUID were not found\n"); return -ENODEV; } err = dell_wmi_check_descriptor_buffer(); if (err) return err; err = dell_wmi_input_setup(); if (err) return err; status = wmi_install_notify_handler(DELL_EVENT_GUID, dell_wmi_notify, NULL); if (ACPI_FAILURE(status)) { dell_wmi_input_destroy(); pr_err("Unable to register notify handler - %d\n", status); return -ENODEV; } dmi_check_system(dell_wmi_smbios_list); if (wmi_requires_smbios_request) { err = dell_wmi_events_set_enabled(true); if (err) { pr_err("Failed to enable WMI events\n"); wmi_remove_notify_handler(DELL_EVENT_GUID); dell_wmi_input_destroy(); return err; } } return 0; }

Contributors

PersonTokensPropCommitsCommitProp
matthew garrettmatthew garrett5639.72%111.11%
michal kepienmichal kepien4028.37%111.11%
pali roharpali rohar1913.48%111.11%
dmitry torokhovdmitry torokhov117.80%333.33%
len brownlen brown117.80%111.11%
joe perchesjoe perches32.13%111.11%
axel linaxel lin10.71%111.11%
Total141100.00%9100.00%

module_init(dell_wmi_init);
static void __exit dell_wmi_exit(void) { if (wmi_requires_smbios_request) dell_wmi_events_set_enabled(false); wmi_remove_notify_handler(DELL_EVENT_GUID); dell_wmi_input_destroy(); }

Contributors

PersonTokensPropCommitsCommitProp
matthew garrettmatthew garrett1453.85%125.00%
michal kepienmichal kepien934.62%125.00%
dmitry torokhovdmitry torokhov27.69%125.00%
axel linaxel lin13.85%125.00%
Total26100.00%4100.00%

module_exit(dell_wmi_exit);

Overall Contributors

PersonTokensPropCommitsCommitProp
pali roharpali rohar76129.75%412.90%
andy lutomirskiandy lutomirski54121.15%516.13%
matthew garrettmatthew garrett27110.59%26.45%
michal kepienmichal kepien2499.73%39.68%
dmitry torokhovdmitry torokhov2429.46%39.68%
rezwanul kabirrezwanul kabir2027.90%13.23%
mario limonciellomario limonciello1485.79%13.23%
seth forsheeseth forshee582.27%13.23%
gabriele mazzottagabriele mazzotta351.37%26.45%
joe perchesjoe perches120.47%13.23%
len brownlen brown110.43%13.23%
alex hungalex hung70.27%13.23%
islam amerislam amer60.23%13.23%
hans de goedehans de goede50.20%26.45%
anisse astieranisse astier50.20%13.23%
tejun heotejun heo30.12%13.23%
axel linaxel lin20.08%13.23%
Total2558100.00%31100.00%
Information contained on this website is for historical information purposes only and does not indicate or represent copyright ownership.
{% endraw %}