xref: /openbmc/linux/Documentation/wmi/devices/wmi-bmof.rst (revision 2612e3bbc0386368a850140a6c9b990cd496a5ec)
1*bf4f93c4SArmin Wolf.. SPDX-License-Identifier: GPL-2.0-only
2*bf4f93c4SArmin Wolf
3*bf4f93c4SArmin Wolf==============================
4*bf4f93c4SArmin WolfWMI embedded Binary MOF driver
5*bf4f93c4SArmin Wolf==============================
6*bf4f93c4SArmin Wolf
7*bf4f93c4SArmin WolfIntroduction
8*bf4f93c4SArmin Wolf============
9*bf4f93c4SArmin Wolf
10*bf4f93c4SArmin WolfMany machines embed WMI Binary MOF (Managed Object Format) metadata used to
11*bf4f93c4SArmin Wolfdescribe the details of their ACPI WMI interfaces. The data can be decoded
12*bf4f93c4SArmin Wolfwith tools like `bmfdec <https://github.com/pali/bmfdec>`_ to obtain a
13*bf4f93c4SArmin Wolfhuman readable WMI interface description, which is useful for developing
14*bf4f93c4SArmin Wolfnew WMI drivers.
15*bf4f93c4SArmin Wolf
16*bf4f93c4SArmin WolfThe Binary MOF data can be retrieved from the ``bmof`` sysfs attribute of the
17*bf4f93c4SArmin Wolfassociated WMI device. Please note that multiple WMI devices containing Binary
18*bf4f93c4SArmin WolfMOF data can exist on a given system.
19*bf4f93c4SArmin Wolf
20*bf4f93c4SArmin WolfWMI interface
21*bf4f93c4SArmin Wolf=============
22*bf4f93c4SArmin Wolf
23*bf4f93c4SArmin WolfThe Binary MOF WMI device is identified by the WMI GUID ``05901221-D566-11D1-B2F0-00A0C9062910``.
24*bf4f93c4SArmin WolfThe Binary MOF can be obtained by doing a WMI data block query. The result is
25*bf4f93c4SArmin Wolfthen returned as an ACPI buffer with a variable size.
26