ACPI_PANASONIC(4)

ACPI_PANASONIC πŸ’…

okay bestie, so this is the acpi_panasonic manual page, section 4 of the Kernel Interfaces Manual β€” aka the ACPI hotkey driver for Panasonic laptops. yes, the tiny Japanese laptops. let's get into it πŸŽ€


✨ NAME ✨

acpi_panasonic β€” ACPI hotkey driver for Panasonic laptops 🫢


🌸 SYNOPSIS 🌸

so to compile this driver into the kernel, you literally just drop this line in your kernel configuration file:

device acpi_panasonic

or, alternatively, if you'd rather load the driver as a module at boot time, put this in loader.conf(5):

acpi_panasonic_load="YES"

pick your fighter, both slay πŸ’–


πŸ¦‹ DESCRIPTION πŸ¦‹

The acpi_panasonic driver enables such hotkey facilities of various Panasonic laptops as changing LCD brightness, controlling mixer volumes, entering sleep or suspended state and so on. on the following models it is reported to work: Let's note (or Toughbook, outside Japan) CF-R1N, CF-R2A and CF-R3. it may also work on other models as well β€” no promises, but like, fingers crossed πŸ“

The driver consists of three functionalities:

  1. detect hotkey events and take corresponding actions, which include changing LCD luminance and speaker mute state πŸ‘‘
  2. notify occurrences of the event by way of devctl(4) and eventually to devd(8) πŸ“£
  3. provide a way to adjust LCD brightness and sound mute state via sysctl(8) πŸŽ›οΈ

the third and last is not an afterthought, it's the main character too ✨

πŸŽ€ Hotkeys

there are 9 hotkeys available on the supported hardware:

  • Fn+F1 β€” make LCD backlight darker πŸŒ‘
  • Fn+F2 β€” make LCD backlight brighter β˜€οΈ
  • Fn+F3 β€” switch video output between LCD and CRT. not supported by the acpi_panasonic driver 😭
  • Fn+F4 β€” toggle muting the speaker πŸ”‡
  • Fn+F5 β€” turn the mixer volume down πŸ”‰
  • Fn+F6 β€” turn the mixer volume up πŸ”Š
  • Fn+F7 β€” enter suspend-to-RAM state πŸ’€
  • Fn+F9 β€” show battery status πŸ”‹
  • Fn+F10 β€” enter suspend-to-disk state πŸ’Ύ

Actions are automatically taken within the driver for Fn+F1, Fn+F2 and Fn+F4. for the other events such as mixer control and showing battery status, devd(8) should take the role as described below πŸ‘‡

🧚 devd(8) Events

when notified to devd(8), the hotkey event provides the following information:

  • system β€” "ACPI"
  • subsystem β€” "Panasonic"
  • type β€” the source of the event in ACPI namespace. the value depends on the model but typically "\_SB_.HKEY".
  • notify β€” event code (see below).

Event codes to be generated are assigned as follows:

  • 0x81-0x86, 0x89 β€” Fn+F<n> pressed. 0x81 corresponds to Fn+F1, 0x82 corresponds to Fn+F2, and so on.
  • 0x01-0x07, 0x09, 0x1a β€” Fn+F<n> released. 0x01 corresponds to Fn+F1, 0x02 corresponds to Fn+F2, and so on.

⭐ SYSCTL VARIABLES ⭐

the following MIBs are available:

  • hw.acpi.panasonic.lcd_brightness_max β€” the maximum level of brightness. this read-only value is automatically set according to hardware model. she knows her limits πŸ’…
  • hw.acpi.panasonic.lcd_brightness_min β€” the minimum level of brightness. this read-only value is automatically set according to hardware model.
  • hw.acpi.panasonic.lcd_brightness β€” current brightness level of the LCD (read-write). the value ranges from hw.acpi.panasonic.lcd_brightness_min to hw.acpi.panasonic.lcd_brightness_max.
  • hw.acpi.panasonic.sound_mute β€” a read-write boolean flag to control whether to mute the speaker. the value 1 means to mute and 0 not.

πŸ’œ SEE ALSO πŸ’œ

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


🌈 HISTORY 🌈

The acpi_panasonic driver first appeared in FreeBSD 5.3. vintage era fr fr πŸ•°οΈ


πŸ‘‘ AUTHORS πŸ‘‘

The acpi_panasonic driver and this manual page were written by OGAWA Takaya <t-ogawa@triaez.kaisei.org> and TAKAHASHI Yoshihiro <nyan@FreeBSD.org>. absolute icons, we stan 🫢


and that's the whole page bestie, no notes. go forth and press those hotkeys πŸ’–

Debian Β· June 19, 2015 Β· ACPI_PANASONIC(4) β€” mwah, ty for reading, ily πŸŽ€βœ¨

πŸ“¦ where this page comes from