acpi_wmi(4)

acpi_wmi4

Acpi to wmi mapping driver

Usage

To compile this driver into the kernel, place the following line in your kernel configuration file:

device acpi_wmi

Alternatively, to load the driver as a module at boot time, place the following line in loader.conf(5):

acpi_wmi_load="YES"

Overview

The acpi_wmi driver provides an interface for vendor specific WMI implementations (e.g. HP and Acer laptops). It creates /dev/wmistat%d, which can be read to get information about GUIDs found in the system.

Files

/dev/wmistat%d

WMI status devices.

Sysctls

The following sysctl node is currently implemented:

dev.acpi_wmi.%d.bmof

binary Managed Object Format (MOF) buffer

Examples

Read GUIDs from the first WMI interface found in the system:

# cat /dev/wmistat0
GUID                                  INST EXPE METH STR EVENT OID
{5FB7F034-2C63-45E9-BE91-3D44E2C707E4}   1 NO   WMAA NO  NO    AA
{95F24279-4D7B-4334-9387-ACCDC67EF61C}   1 NO   NO   NO  0x80+ -
{2B814318-4BE8-4707-9D84-A190A859B5D0}   1 NO   NO   NO  0xA0  -
{05901221-D566-11D1-B2F0-00A0C9062910}   1 NO   NO   NO  NO    AB
{1F4C91EB-DC5C-460B-951D-C7CB9B4B8D5E}   1 NO   WMBA NO  NO    BA
{2D114B49-2DFB-4130-B8FE-4A3C09E75133}  57 NO   NO   NO  NO    BC
{988D08E3-68F4-4C35-AF3E-6A1B8106F83C}  20 NO   NO   NO  NO    BD
{14EA9746-CE1F-4098-A0E0-7045CB4DA745}   1 NO   NO   NO  NO    BE
{322F2028-0F84-4901-988E-015176049E2D}   2 NO   NO   NO  NO    BF
{8232DE3D-663D-4327-A8F4-E293ADB9BF05}   0 NO   NO   NO  NO    BG
{8F1F6436-9F42-42C8-BADC-0E9424F20C9A}   0 NO   NO   NO  NO    BH
{8F1F6435-9F42-42C8-BADC-0E9424F20C9A}   0 NO   NO   NO  NO    BI

Read first WMI interface description with bmf2mof from ports/converters/bmfdec:

# sysctl -b dev.acpi_wmi.0.bmof | bmf2mof
[abstract]
class Lenovo_BIOSElement {
};
[WMI, Dynamic, Provider("WMIProv"), WmiExpense(1), Description("Bios Setting"),
GUID("{51F5230E-9677-46cd-A1CF-C0B23EE34DB7}"), Locale("MS\0x409")]
class Lenovo_BiosSetting : Lenovo_BiosElement {
  [key, read] String InstanceName;
    [read] Boolean Active;
      [WmiDataId(1), Description("BIOS setting")] String CurrentSetting;
      };
   ...

Releases

39 releases since FreeBSD 8.0-RELEASE; the text changed 27 times.

  1. 8.0
  2. 8.1
  3. 8.2
  4. 8.3
  5. 8.4
  6. 9.0
  7. 9.1
  8. 9.2
  9. 9.3
  10. 10.0
  11. 10.1
  12. 10.2
  13. 10.3
  14. 10.4
  15. 11.0
  16. 11.1
  17. 11.2
  18. 11.3
  19. 11.4
  20. 12.0
  21. 12.1
  22. 12.2
  23. 12.3
  24. 12.4
  25. 13.0–13.2
  26. 13.3–13.5
  27. 14.0–14.3
  28. 14.4–16.0

Standards

Windows Instrumentation: WMI and ACPI, Microsoft Corporation, https://github.com/microsoft/Windows-driver-samples/tree/main/wmi/wmiacpi.

History

The acpi_wmi device driver first appeared in FreeBSD 8.0.

Authors

The acpi_wmi driver was written by Michael Gmelin ⟨[email protected]⟩.

Work inspired by the Linux acpi-wmi driver written by Carlos Corbacho.

MOF handling inspired by the Linux wmi-bmof driver written by Andy Lutomirski.

This manual page was written by Michael Gmelin ⟨[email protected]⟩.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.