ACPI_PANASONIC(4)

HOME || NAME SYNOPSIS DESCRIPTION Hotkeys Devd Events SYSCTLS SEE ALSO AUTHORS BUGS
NAME
     acpi_panasonic -- ACPI hotkey driver for Panasonic laptops
SYNOPSIS
     device acpi_panasonic
DESCRIPTION
     The acpi_panasonic driver enables such hotkey facilities of various Pana-
     sonic 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.

     The driver consists of three functionalities.  The first is to detect
     hotkey events and take corresponding actions, which include changing LCD
     luminance and speaker mute state.	The second role is to notify
     occurences of the event by way of devctl(4) and eventually to devd(8).
     The third and last is to provide a way to adjust LCD brightness and sound
     mute state via sysctl.

   Hotkeys
     There are 9 hotkeys available on the supported hardwares:

	   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 Events
     When notified to devd(8), the hotkey event provides the following infor-
     mation:

	   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 cor-
			 responds 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.
SYSCTLS
     The following read-write MIBs are available:

     hw.acpi.panasonic.lcd_brightness_max
	     The max level of brightness.  The value ranges from 0 to 255.
	     CF-R1N and CF-R2A should be 255, CF-R3 is 31.

     hw.acpi.panasonic.lcd_brightness
	     Current brightness level of the LCD.  The value ranges from 0 to
	     hw.acpi.panasonic.lcd_brightness_max.

     hw.acpi.panasonic.sound_mute
	     A boolean flag to control whether to mute the speaker.  The value
	     1 means to mute and 0 not.
SEE ALSO
     acpi(4), sysctl(8), devd(8), devd.conf(5)
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>.
BUGS
     The code is written in trial-and-error manner.  There is no way to con-
     firm the correctness except by ``it just works here''.