GNU Linux-libre 6.9.1-gnu
[releases.git] / Documentation / wmi / devices / wmi-bmof.rst
1 .. SPDX-License-Identifier: GPL-2.0-only
2
3 ==============================
4 WMI embedded Binary MOF driver
5 ==============================
6
7 Introduction
8 ============
9
10 Many machines embed WMI Binary MOF (Managed Object Format) metadata used to
11 describe the details of their ACPI WMI interfaces. The data can be decoded
12 with tools like `bmfdec <https://github.com/pali/bmfdec>`_ to obtain a
13 human readable WMI interface description, which is useful for developing
14 new WMI drivers.
15
16 The Binary MOF data can be retrieved from the ``bmof`` sysfs attribute of the
17 associated WMI device. Please note that multiple WMI devices containing Binary
18 MOF data can exist on a given system.
19
20 WMI interface
21 =============
22
23 The Binary MOF WMI device is identified by the WMI GUID ``05901221-D566-11D1-B2F0-00A0C9062910``.
24 The Binary MOF can be obtained by doing a WMI data block query. The result is
25 then returned as an ACPI buffer with a variable size.