From nobody Mon Jun 8 05:25:47 2026 Received: from mail-dy1-f181.google.com (mail-dy1-f181.google.com [74.125.82.181]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 1D3673D9028 for ; Mon, 1 Jun 2026 15:14:23 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=74.125.82.181 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1780326865; cv=none; b=Hx2MGlDyShNR8XHk43aagBSw6S33QeObTUE5OFRroZJsNfl27tfbAJOOnhBq1CKzcZjXGDPF6VWKUwb/27oNDgYo7MSjnPRRpA+Y1+dcHrmvYHKW3JmkjtMV5YjLdSAE3towsMMO8qHkYtz+O3lk5ECmoyj4ScRAnQYYrn+c6a0= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1780326865; c=relaxed/simple; bh=U0SyTby7Moc7yebh7ThNHBwxaPJMTf9rOkHyWJGwP+c=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=bjzv3LIkDE6qEcEwm1p7uRXzS6e4q8qaaLydXCNDJPl82fGndifstVP9c2oBmeY7owqBTQTbTUPdzTpOW6TyNk1mLbA9fjz7UF4iNHps0PREr+Jqmoo4GxmKCuzJM8LhNgHWAY7x1GsD90bwG3yD4mNeh12bADF6DJc1CVPguV0= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=sEEZLL9y; arc=none smtp.client-ip=74.125.82.181 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="sEEZLL9y" Received: by mail-dy1-f181.google.com with SMTP id 5a478bee46e88-304d8362a58so2721655eec.1 for ; Mon, 01 Jun 2026 08:14:22 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1780326862; x=1780931662; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=kKdA0q9b01o5FaZjt3XQSJrVum84R1EFltIn6392mwU=; b=sEEZLL9ypUaqWjojh3MPB4gbwdFAeAhFjO7CWCxXqLIcUgDzvHjbwcyK0xGbF4rJkZ J4jfiRJkcwFgjWlVSlrbh7ZcoLvFcpbT9RyUfu/JadB7VIhCLGBmspKGZWdIgiSMqQ7Q 6tgNauvWbuDPN6YIzq52KZF52lJq9lejx7xTtHTLtCl/uEXs/h40csTEUNZ5/racxp2o 482Tzh/np14AzriWpXqWMruJWRaKMaYpzasVP8jKvko1Fr7sDR0+U2/JYMfKawLJZ/Vu Kx2dsFekgSpMsLV+EAy+zpmXQkBWXoVt8BEm7pG+B76V71mt9RCbTe4J2FQYZSxzVLQY NlCA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1780326862; x=1780931662; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=kKdA0q9b01o5FaZjt3XQSJrVum84R1EFltIn6392mwU=; b=cw77R+bcT8b6V6ldcXNTbs8TfyczmZicLMEMv7SJe6t9HCef7W7ZqGLzRQPwByv3Ms KYefrBlpHQaKj3pVeaud9k5wq4NPiZSlXkmbZmB8h/h8QSfob1xK9Yojw01ynZNZd6AQ S8b4ucTmhkYGEQA1/+hiBeWGcI1rJAGKGjfHT461dvLHvwtDrP+fnJUWcoQrsoA9/ggp baUYTbcRcP217/1bTpwm+RpVDzfQ6EDcCNgkv5ZJbGQLhq5Fz4Ei7ydZY0jCwK7Bm0/o CHnGI0FXXHpTq7TE4Pc6AxlcgK/bHLj+vXJ/HcM9UHP2WkqiF9Xlc9HBDjo16kjX37xV yJBw== X-Forwarded-Encrypted: i=1; AFNElJ/DNVv18mIOJSg4e5gCllsNLd2xwB+/HGlLzDRhSSu8bDUxCh0lkkPLt09ZPFpgwvGSzRHfiZMCp/0kpx8=@vger.kernel.org X-Gm-Message-State: AOJu0YwOw0IDXRBl5frAUjeqsKZX848YC12RbyRt1oVgo8HJLmkg0wha X2ARb2VhA58gWH1ewBm/oLo2XJ52yVWQtrnw/D5s1TiOqhbtLLWDTTtC X-Gm-Gg: Acq92OHrTZp8eS2yPzZmOyVLoM4mB5bcYXuY9FY8VLnlIaow/b1QqdbzMkJuRd1yThC /Q6CRXyGik/ppHDMV4KzMs0skSgoyrY2nFt+AiO12aCzWZktH1SzOVCq4CW6uvmTSlehDMC2SL1 iteASGgCkrewgqC1DfqWPNPvDqpkE6yKPVAhpnLoiZFPtNe1a+qWle3uqwgvctR5rlRH0/tW+Ta bSTZC8fJqmyVKn2sgjY9jHB/scn9/VrMPntgokF/EwV5TwmtOlueU6KUITKHtoJqLJXqujk7iQM ABF+qg6gXXmkzb1IAGl5pAdQfisTjez3fpOQYESWbnekhMnt+654OTAR+6K7O/hAyEkN4WIaHx7 oKdNIJFIFf9q34gIn2PrI1u4skIHvE++hjOYmrn+jW3lku/vKU8i5sqca/Aj9T3Ip9ZI/M1J8gM TWK+g851f1A4DlshwdoMQB+n3+pg9gz0DVw8X9 X-Received: by 2002:a05:7300:6426:b0:304:c9f1:a0e9 with SMTP id 5a478bee46e88-304eb115e9amr6707245eec.9.1780326862031; Mon, 01 Jun 2026 08:14:22 -0700 (PDT) Received: from Lucy-Fedora ([198.176.56.12]) by smtp.gmail.com with ESMTPSA id 5a478bee46e88-304ed53d14fsm9116383eec.17.2026.06.01.08.14.20 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 01 Jun 2026 08:14:21 -0700 (PDT) From: Lucy Wong To: Hans de Goede , =?UTF-8?q?Ilpo=20J=C3=A4rvinen?= Cc: platform-driver-x86@vger.kernel.org, linux-kernel@vger.kernel.org, Lucy Wong Subject: [PATCH 1/1] platform/x86: add Xiaomi WMI key driver Date: Mon, 1 Jun 2026 23:14:04 +0800 Message-ID: <20260601151404.93049-2-lucywong2778@gmail.com> X-Mailer: git-send-email 2.54.0 In-Reply-To: <20260601151404.93049-1-lucywong2778@gmail.com> References: <20260601151404.93049-1-lucywong2778@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Certain Xiaomi laptops expose extra function keys through a single WMI event GUID (B74AF83F-8B2F-4069-ACAC-36D176F62FC0). Unlike the existing xiaomi-wmi driver where each key has its own GUID, here all keys share one GUID and the event buffer encodes both an event type and a keycode: buffer[1] =3D event type 0x02: press/release keys (5 keys with abstract icons) 0x03: firmware-handled toggles (touchpad, Fn lock) buffer[2] =3D keycode within that type The keys with abstract icons are mapped to programmable macro keys for userspace to bind. The touchpad and Fn lock keys are handled by the EC and are reported for notification purposes only. Signed-off-by: Lucy Wong --- MAINTAINERS | 6 ++ drivers/platform/x86/Kconfig | 11 ++ drivers/platform/x86/Makefile | 1 + drivers/platform/x86/xiaomi-wmi-keys.c | 139 +++++++++++++++++++++++++ 4 files changed, 157 insertions(+) create mode 100644 drivers/platform/x86/xiaomi-wmi-keys.c diff --git a/MAINTAINERS b/MAINTAINERS index 839e39825455..7969b82c8315 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -29124,6 +29124,12 @@ F: fs/xfs/ F: include/uapi/linux/dqblk_xfs.h F: include/uapi/linux/fsmap.h =20 +XIAOMI WMI KEYS DRIVER +M: Lucy Wong +L: platform-driver-x86@vger.kernel.org +S: Maintained +F: drivers/platform/x86/xiaomi-wmi-keys.c + XILINX AMS DRIVER M: Salih Erim M: Conall O'Griofa diff --git a/drivers/platform/x86/Kconfig b/drivers/platform/x86/Kconfig index b54b5212b204..541b0a255daa 100644 --- a/drivers/platform/x86/Kconfig +++ b/drivers/platform/x86/Kconfig @@ -90,6 +90,17 @@ config XIAOMI_WMI To compile this driver as a module, choose M here: the module will be called xiaomi-wmi. =20 +config XIAOMI_WMI_KEYS + tristate "Xiaomi WMI key events driver" + depends on ACPI_WMI + depends on INPUT + help + Say Y here if you want to support WMI-based hotkey events on certain + Xiaomi laptops. + + To compile this driver as a module, choose M here: the module will + be called xiaomi-wmi-keys. + config REDMI_WMI tristate "Redmibook WMI key driver" depends on ACPI_WMI diff --git a/drivers/platform/x86/Makefile b/drivers/platform/x86/Makefile index 872ac3842391..d852bb0bf61b 100644 --- a/drivers/platform/x86/Makefile +++ b/drivers/platform/x86/Makefile @@ -12,6 +12,7 @@ obj-$(CONFIG_HUAWEI_WMI) +=3D huawei-wmi.o obj-$(CONFIG_MXM_WMI) +=3D mxm-wmi.o obj-$(CONFIG_NVIDIA_WMI_EC_BACKLIGHT) +=3D nvidia-wmi-ec-backlight.o obj-$(CONFIG_XIAOMI_WMI) +=3D xiaomi-wmi.o +obj-$(CONFIG_XIAOMI_WMI_KEYS) +=3D xiaomi-wmi-keys.o obj-$(CONFIG_REDMI_WMI) +=3D redmi-wmi.o obj-$(CONFIG_GIGABYTE_WMI) +=3D gigabyte-wmi.o obj-$(CONFIG_BITLAND_MIFS_WMI) +=3D bitland-mifs-wmi.o diff --git a/drivers/platform/x86/xiaomi-wmi-keys.c b/drivers/platform/x86/= xiaomi-wmi-keys.c new file mode 100644 index 000000000000..524ede0e64eb --- /dev/null +++ b/drivers/platform/x86/xiaomi-wmi-keys.c @@ -0,0 +1,139 @@ +// SPDX-License-Identifier: GPL-2.0 +/* + * Xiaomi laptop WMI hotkey driver + * + * Copyright (C) 2026 Lucy Wong + */ + +#include +#include +#include +#include +#include +#include +#include + +#define XIAOMI_WMI_EVENT_GUID "B74AF83F-8B2F-4069-ACAC-36D176F62FC0" + +#define XIAOMI_TYPE_BACKLIGHT 0x01 /* keyboard backlight level (EC handled= ) */ +#define XIAOMI_TYPE_KEY 0x02 /* press/release keys */ +#define XIAOMI_TYPE_TOGGLE 0x03 /* firmware toggle keys (notify only) */ + +#define XIAOMI_KEY_PRESS_MIN 0x01 +#define XIAOMI_KEY_PRESS_MAX 0x05 +#define XIAOMI_KEY_RELEASE_OFF 0x05 + +#define XIAOMI_TOGGLE_DEDUP_MS 50 + +struct xiaomi_wmi { + struct input_dev *input_dev; + unsigned long last_toggle; + u8 last_toggle_code; +}; + +static const struct key_entry xiaomi_wmi_keymap[] =3D { + /* type 0x02: programmable keys with abstract icons */ + { KE_KEY, 0x0201, { KEY_MACRO1 } }, + { KE_KEY, 0x0202, { KEY_MACRO2 } }, + { KE_KEY, 0x0203, { KEY_MACRO3 } }, + { KE_KEY, 0x0204, { KEY_MACRO4 } }, + { KE_KEY, 0x0205, { KEY_MACRO5 } }, + /* type 0x03: firmware-handled toggles, reported for OSD only */ + { KE_KEY, 0x0300, { KEY_F21 } }, /* touchpad toggle */ + { KE_KEY, 0x0301, { KEY_FN_ESC } }, /* Fn lock */ + { KE_END, 0 }, +}; + +static int xiaomi_wmi_probe(struct wmi_device *wdev, const void *context) +{ + struct xiaomi_wmi *data; + int ret; + + data =3D devm_kzalloc(&wdev->dev, sizeof(*data), GFP_KERNEL); + if (!data) + return -ENOMEM; + dev_set_drvdata(&wdev->dev, data); + + data->input_dev =3D devm_input_allocate_device(&wdev->dev); + if (!data->input_dev) + return -ENOMEM; + + data->input_dev->name =3D "Xiaomi WMI keys"; + data->input_dev->phys =3D "wmi/input0"; + data->input_dev->id.bustype =3D BUS_HOST; + + ret =3D sparse_keymap_setup(data->input_dev, xiaomi_wmi_keymap, NULL); + if (ret) + return ret; + + return input_register_device(data->input_dev); +} + +static void xiaomi_wmi_notify(struct wmi_device *wdev, union acpi_object *= obj) +{ + struct xiaomi_wmi *data =3D dev_get_drvdata(&wdev->dev); + u8 type, code; + + if (obj->type !=3D ACPI_TYPE_BUFFER || obj->buffer.length < 3) + return; + + type =3D obj->buffer.pointer[1]; + code =3D obj->buffer.pointer[2]; + + switch (type) { + case XIAOMI_TYPE_KEY: + if (code >=3D XIAOMI_KEY_PRESS_MIN && + code <=3D XIAOMI_KEY_PRESS_MAX) { + sparse_keymap_report_event(data->input_dev, + 0x0200 | code, 1, false); + } else if (code > XIAOMI_KEY_PRESS_MAX && + code <=3D XIAOMI_KEY_PRESS_MAX + + XIAOMI_KEY_RELEASE_OFF) { + code -=3D XIAOMI_KEY_RELEASE_OFF; + sparse_keymap_report_event(data->input_dev, + 0x0200 | code, 0, false); + } + break; + + case XIAOMI_TYPE_TOGGLE: + /* deduplicate: each press emits two identical events */ + if (data->last_toggle_code =3D=3D code && + time_before(jiffies, data->last_toggle + + msecs_to_jiffies(XIAOMI_TOGGLE_DEDUP_MS))) + return; + data->last_toggle_code =3D code; + data->last_toggle =3D jiffies; + sparse_keymap_report_event(data->input_dev, + 0x0300 | code, 1, true); + break; + + case XIAOMI_TYPE_BACKLIGHT: + /* keyboard backlight handled by EC, nothing to do */ + break; + + default: + dev_dbg(&wdev->dev, "unknown event type 0x%02x\n", type); + break; + } +} + +static const struct wmi_device_id xiaomi_wmi_id_table[] =3D { + { .guid_string =3D XIAOMI_WMI_EVENT_GUID }, + { } +}; +MODULE_DEVICE_TABLE(wmi, xiaomi_wmi_id_table); + +static struct wmi_driver xiaomi_wmi_driver =3D { + .driver =3D { + .name =3D "xiaomi-wmi-keys", + }, + .id_table =3D xiaomi_wmi_id_table, + .probe =3D xiaomi_wmi_probe, + .notify =3D xiaomi_wmi_notify, + .no_singleton =3D true, +}; +module_wmi_driver(xiaomi_wmi_driver); + +MODULE_AUTHOR("Lucy Wong "); +MODULE_DESCRIPTION("Xiaomi laptop WMI hotkey driver"); +MODULE_LICENSE("GPL"); --=20 2.54.0