From 3c92d13fb3f5acdf411aa32d7e9069eb4a50e7e6 Mon Sep 17 00:00:00 2001 From: nyan Date: Wed, 21 Jul 2004 14:47:54 +0000 Subject: Add the ACPI Panasonic extras driver. Submitted by: OGAWA Takaya and nyan --- share/man/man4/man4.i386/Makefile | 1 + share/man/man4/man4.i386/acpi_panasonic.4 | 161 ++++++++++++++++++++++++++++++ 2 files changed, 162 insertions(+) create mode 100644 share/man/man4/man4.i386/acpi_panasonic.4 (limited to 'share') diff --git a/share/man/man4/man4.i386/Makefile b/share/man/man4/man4.i386/Makefile index 23a3a08..2568e3d 100644 --- a/share/man/man4/man4.i386/Makefile +++ b/share/man/man4/man4.i386/Makefile @@ -1,6 +1,7 @@ # $FreeBSD$ MAN= acpi_asus.4 \ + acpi_panasonic.4 \ acpi_toshiba.4 \ aic.4 \ alpm.4 \ diff --git a/share/man/man4/man4.i386/acpi_panasonic.4 b/share/man/man4/man4.i386/acpi_panasonic.4 new file mode 100644 index 0000000..76ee554 --- /dev/null +++ b/share/man/man4/man4.i386/acpi_panasonic.4 @@ -0,0 +1,161 @@ +.\" +.\" Copyright (c) 2004 OGAWA Takaya +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" $FreeBSD$ +.\" +.Dd July 11, 2004 +.Dt ACPI_PANASONIC 4 i386 +.Os +.Sh NAME +.Nm acpi_panasonic +.Nd "ACPI hotkey driver for Panasonic laptops" +.Sh SYNOPSIS +.Cd "device acpi_panasonic" +.Sh DESCRIPTION +The +.Nm +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. +.Pp +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 +.Xr devctl 4 +and eventually to +.Xr devd 8 . +The third and last is to provide a way to adjust LCD brightness and +sound mute state via sysctl. +.Ss Hotkeys +There are 9 hotkeys available on the supported hardwares: +.Pp +.Bl -tag -compact -offset indent +.It Sy \&Fn+F1 +Make LCD backlight darker. +.It Sy \&Fn+F2 +Make LCD backlight brighter. +.It Sy \&Fn+F3 +Switch video output between LCD and CRT. +Not supported by the +.Nm +driver. +.It Sy \&Fn+F4 +Toggle muting the speaker. +.It Sy \&Fn+F5 +Turn the mixer volume down. +.It Sy \&Fn+F6 +Turn the mixer volume up. +.It Sy \&Fn+F7 +Enter suspend-to-RAM state. +.It Sy \&Fn+F9 +Show battery status. +.It Sy \&Fn+F10 +Enter suspend-to-disk state. +.El +.Pp +Actions are automatically taken within the driver for +.Sy \&Fn+F1 , +.Sy \&Fn+F2 +and +.Sy \&Fn+F4 . +For the other events such as +mixer control and showing battery status, +.Xr devd 8 +should take the role as described below. +.Ss Devd Events +When notified to +.Xr devd 8 , +the hotkey event provides the following information: +.Pp +.Bl -tag -compact -offset indent +.It system +.Qq ACPI +.It subsystem +.Qq Panasonic +.It type +The source of the event in ACPI namespace. +The value depends on the model but typically +.Qq \e_SB_.HKEY . +.It notify +Event code (see below). +.El +.Pp +Event codes to be generated are assigned as follows: +.Bl -tag -offset indent +.It 0x81-0x86, 0x89 +.Sy \&Fn+F +pressed. 0x81 corresponds to +.Sy \&Fn+F1 , +0x82 corresponds to +.Sy \&Fn+F2 , +and so on. +.It 0x01-0x07, 0x09, 0x1a +.Sy \&Fn+F +released. 0x01 corresponds to +.Sy \&Fn+F1 , +0x02 corresponds to +.Sy \&Fn+F2 , +and so on. +.El +.Sh SYSCTLS +The following read-write MIBs are available: +.Bl -tag -width indent +.It Va 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. +.It Va hw.acpi.panasonic.lcd_brightness +Current brightness level of the LCD. +The value ranges from 0 to +.Va hw.acpi.panasonic.lcd_brightness_max . +.It Va hw.acpi.panasonic.sound_mute +A boolean flag to control whether to mute the speaker. +The value 1 means to mute and 0 not. +.El +.Sh SEE ALSO +.Xr acpi 4 , +.Xr sysctl 8 , +.Xr devd 8 , +.Xr devd.conf 5 +.\" .Sh HISTORY +.\" The +.\" .Nm +.\" driver first appeared in +.\" .Fx 5.3 . +.Sh AUTHORS +The +.Nm +driver and this manual page were written by +.An OGAWA Takaya Aq t\-ogawa@triaez.kaisei.org +and +.An TAKAHASHI Yoshihiro Aq nyan@FreeBSD.org . +.Sh BUGS +The code is written in trial-and-error manner. +There is no way to confirm the correctness except by +.Dq it just works here . -- cgit v1.1