Hi, On 4/20/23 16:32, Armin Wolf wrote: > diff --git a/Documentation/wmi/devices/wmi-bmof.rst b/Documentation/wmi/devices/wmi-bmof.rst > new file mode 100644 > index 000000000000..b558fa46190c > --- /dev/null > +++ b/Documentation/wmi/devices/wmi-bmof.rst > @@ -0,0 +1,22 @@ > +.. SPDX-License-Identifier: GPL-2.0-only > + > +============================== > +WMI embedded Binary MOF driver > +============================== > + Please tell the reader what MOF means. It would be good in drivers/platform/x86/Kconfig also did that. > +Introduction > +============ > + > +Many machines embed WMI Binary MOF 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. -- ~Randy
