ACPI_ASUS_WMI(4)

πŸ’– ACPI_ASUS_WMI(4) πŸ’–

okay bestie, welcome to the Kernel Interfaces Manual entry for acpi_asus_wmi β€” literally the glow-up your Asus laptop has been waiting for πŸ¦‹


✨ NAME ✨

acpi_asus_wmi β€” Asus Laptop WMI Extras πŸŽ€


🌸 SYNOPSIS 🌸

so like, you wanna build this driver straight into the kernel? no cap, just drop this line into your kernel configuration file:

device acpi_asus_wmi

orrrr, if you'd rather load it as a module at boot time (which is honestly the move for a lot of ppl), put this line in loader.conf(5):

acpi_asus_wmi_load="YES"

πŸ’… DESCRIPTION πŸ’…

the acpi_asus_wmi driver is giving extra WMI-controlled gadget support β€” we're talking hotkeys, leds, all that cute stuff that lives on Asus laptops. it ate, fr fr.

with it, you get to use the sysctl(8) interface to:

  • mess with the brightness of your LCD panel and keyboard backlight ✨
  • power on/off different internal components β€” WiFi, Bluetooth, camera, cardreader, etc. πŸ”Œ
  • read some sensors πŸ‘€

hotkey events get passed along to devd(8) so you can handle them super easily in userspace, with the default configuration living at /etc/devd/asus.conf. and some hotkey events β€” like keyboard backlight and touchpad control β€” are handled inside the driver itself, no extra effort from you. iconic.


⭐ SYSCTL VARIABLES ⭐

here's the sysctls that are currently implemented, bestie:

  • dev.acpi_asus_wmi.0.handle_keys β€” specifies whether the driver should handle some hardware keys, such as keyboard backlight, internally. it's giving "do I do this myself or not" πŸ’β€β™€οΈ

and that's not all β€” a number of other variables under the same sysctl branch are model-specific, so your mileage may vibe differently depending on your machine.

you can set defaults for these variables in sysctl.conf(5), which gets parsed at boot-time. set it and forget it, periodt. πŸ’œ


πŸ‘‘ SEE ALSO πŸ‘‘

acpi(4), acpi_asus(4), acpi_video(4), sysctl.conf(5), devd(8), sysctl(8)


🌈 HISTORY 🌈

the acpi_asus_wmi driver first appeared in FreeBSD 10.0. a legend from day one, honestly.


🫢 AUTHORS 🫢

Alexander Motin <mav@FreeBSD.org>


lowkey reminder bestie: handle_keys is the one knob you'll actually be poking, and the rest of the sysctl branch depends on your exact model β€” don't assume, check πŸ’€

and that's the whole page, no notes πŸ’– this one's from the Debian crew, dated July 2, 2012, filed under ACPI_ASUS_WMI(4). ty for coming to my ted talk, go touch some grass (or at least run sysctl first) πŸŒΈπŸ¦‹βœ¨

πŸ“¦ where this page comes from