NAME

acpi_ibm - ACPI extras driver for IBM laptops

SYNOPSIS

To compile this driver into the kernel, place the following line in your
kernel configuration file:
deviceacpi_ibm
Alternatively, to load the driver as a module at boot time, place the
following line in loader.conf(5):
acpi_ibm_load="YES"

DESCRIPTION

The acpi_ibm driver provides support for hotkeys and other components of
IBM laptops. The main purpose of this driver is to provide an interface,
accessible via sysctl(8) and devd(8), through which applications can
determine the status of various laptop components.
While the sysctl(8) interface is enabled automatically after loading the
driver, the devd(8) interface has to be enabled explicitly, as it may
alter the default action of certain keys. This is done by setting the
events sysctl as described below. Specifying which keys should generate
events is done by setting a bitmask, whereas each bit represents one key
or key combination. This bitmask, accessible via the eventmask sysctl,
is set to availmask by default, a value representing all possible
keypress events on the specific ThinkPad model.
devd(8) Events
Hotkey events received by devd(8) provide the following information:
system "ACPI"
subsystem "IBM"
type The source of the event in the ACPI namespace. The
value depends on the model.
notify Event code (see below).
Depending on the ThinkPad model, event codes may vary. On a ThinkPad
T41p these are as follows:
0x01 Fn + F1
0x02 Fn + F2
0x03 Fn + F3 (LCD backlight)
0x04 Fn + F4 (Suspend to RAM)
0x05 Fn + F5 (Bluetooth)
0x06 Fn + F6
0x07 Fn + F7 (Screen expand)
0x08 Fn + F8
0x09 Fn + F9
0x0a Fn + F10
0x0b Fn + F11
0x0c Fn + F12 (Suspend to disk)
0x0d Fn + Backspace
0x0e Fn + Insert
0x0f Fn + Delete
0x10 Fn + Home (Brightness up)
0x11 Fn + End (Brightness down)
0x12 Fn + PageUp (ThinkLight)
0x13 Fn + PageDown
0x14 Fn + Space (Zoom)
0x15 Volume Up
0x16 Volume Down
0x17 Mute
0x18 Access IBM Button
led(4) Interface
The acpi_ibm driver provides a led(4) interface for the ThinkLight. The
ThinkLight can be made to blink by writing ASCII strings to the
/dev/led/thinklight device.