summaryrefslogtreecommitdiffstats
path: root/Documentation/wmi/devices/wmi-bmof.rst
diff options
context:
space:
mode:
authorDmitry Torokhov <dmitry.torokhov@gmail.com>2023-09-05 23:08:14 +0200
committerDmitry Torokhov <dmitry.torokhov@gmail.com>2023-09-05 23:08:14 +0200
commit34069d12e239ae8f36dd96c378e4622fb1c42a76 (patch)
treeb33fabf1a4cc7530e93ab416f3156bdfe601a3a0 /Documentation/wmi/devices/wmi-bmof.rst
parentInput: rpckbd - fix the return value handle for platform_get_irq() (diff)
parentLinux 6.5 (diff)
downloadlinux-34069d12e239ae8f36dd96c378e4622fb1c42a76.tar.xz
linux-34069d12e239ae8f36dd96c378e4622fb1c42a76.zip
Merge tag 'v6.5' into next
Sync up with mainline to bring in updates to the shared infrastructure.
Diffstat (limited to 'Documentation/wmi/devices/wmi-bmof.rst')
-rw-r--r--Documentation/wmi/devices/wmi-bmof.rst25
1 files changed, 25 insertions, 0 deletions
diff --git a/Documentation/wmi/devices/wmi-bmof.rst b/Documentation/wmi/devices/wmi-bmof.rst
new file mode 100644
index 000000000000..ca1ee9a29be3
--- /dev/null
+++ b/Documentation/wmi/devices/wmi-bmof.rst
@@ -0,0 +1,25 @@
+.. SPDX-License-Identifier: GPL-2.0-only
+
+==============================
+WMI embedded Binary MOF driver
+==============================
+
+Introduction
+============
+
+Many machines embed WMI Binary MOF (Managed Object Format) metadata used to
+describe the details of their ACPI WMI interfaces. The data can be decoded
+with tools like `bmfdec <https://github.com/pali/bmfdec>`_ to obtain a
+human readable WMI interface description, which is useful for developing
+new WMI drivers.
+
+The Binary MOF data can be retrieved from the ``bmof`` sysfs attribute of the
+associated WMI device. Please note that multiple WMI devices containing Binary
+MOF data can exist on a given system.
+
+WMI interface
+=============
+
+The Binary MOF WMI device is identified by the WMI GUID ``05901221-D566-11D1-B2F0-00A0C9062910``.
+The Binary MOF can be obtained by doing a WMI data block query. The result is
+then returned as an ACPI buffer with a variable size.