From owner-freebsd-acpi@FreeBSD.ORG Sun Jul 18 02:16:29 2004 Return-Path: Delivered-To: freebsd-acpi@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 1719C16A4CE for ; Sun, 18 Jul 2004 02:16:29 +0000 (GMT) Received: from mps7.plala.or.jp (c150240.vh.plala.or.jp [210.150.150.240]) by mx1.FreeBSD.org (Postfix) with ESMTP id D591C43D2F for ; Sun, 18 Jul 2004 02:16:27 +0000 (GMT) (envelope-from t-ogawa@triaez.kaisei.org) Received: from solder.dyndns.org ([220.221.88.1]) by mps7.plala.or.jp with SMTP id <20040718021626.UUWM6937.mps7.plala.or.jp@solder.dyndns.org> for ; Sun, 18 Jul 2004 11:16:26 +0900 Received: (qmail 44366 invoked from network); 18 Jul 2004 02:16:26 -0000 Received: from localhost (HELO gandalf.middle.earth) (127.0.0.1) by localhost with SMTP; 18 Jul 2004 02:16:26 -0000 Date: Sun, 18 Jul 2004 11:16:26 +0900 Message-ID: <86hds6njph.wl.t-ogawa@triaez.kaisei.org> From: OGAWA Takaya To: Takahashi Yoshihiro In-Reply-To: <20040717.183512.74706779.nyan@jp.FreeBSD.org> References: <20040712.200815.74734634.nyan@jp.FreeBSD.org> <86llhpz354.wl.t-ogawa@triaez.kaisei.org> <20040713.011631.74707278.nyan@jp.FreeBSD.org> <20040717.183512.74706779.nyan@jp.FreeBSD.org> User-Agent: Wanderlust/2.10.1 (Watching The Wheels) Emacs/21.3 Mule/5.0 (SAKAKI) MIME-Version: 1.0 (generated by SEMI 1.14.6 - "Maruoka") Content-Type: text/plain; charset=ISO-2022-JP cc: acpi@FreeBSD.org cc: njl@FreeBSD.org Subject: Re: Panasonic acpi driver X-BeenThere: freebsd-acpi@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: ACPI and power management development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Jul 2004 02:16:29 -0000 At Sat, 17 Jul 2004 18:35:12 +0900 (JST), Takahashi Yoshihiro wrote: > I put new patch to > http://home.jp.freebsd.org/~nyan/patches/acpi_pana2.diff.gz Thank you. That looks great! It does the job without any problem here. I'd suggest updating the manual page as attached below. The patch contais some documentation error corrections, a couple of grammartical fixes and a few structural improvements. --- acpi_panasonic.4.orig Sun Jul 18 01:57:27 2004 +++ acpi_panasonic.4 Sun Jul 18 03:28:46 2004 @@ -43,7 +43,17 @@ Toughbook, outside Japan) CF-R1N, CF-R2A and CF-R3. It may also work on other models as well. .Pp -On these models there are 9 hotkeys available: +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 @@ -52,11 +62,11 @@ Make LCD backlight brighter. .It Sy \&Fn+F3 Switch video output between LCD and CRT. -Not supported within the +Not supported by the .Nm driver. .It Sy \&Fn+F4 -Toggle muting a speaker. +Toggle muting the speaker. .It Sy \&Fn+F5 Turn the mixer volume down. .It Sy \&Fn+F6 @@ -69,14 +79,16 @@ Enter suspend-to-disk state. .El .Pp -The driver consists of two functionality. -The first is to notify the occurence of the hotkey event by way of -.Xr devctl 4 -and eventually to -.Xr devd 8 . -The second role is to provide the way to adjust LCD brightness and -sound mute state via sysctl. -.Sh DEVD EVENTS +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: @@ -112,17 +124,18 @@ and so on. .El .Sh SYSCTLS -The following MIBs are available: -.Bl -tag -offset indent -.It Sy hw.acpi.panasonic.lcd_brightness_max +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 32. -.It Sy hw.acpi.panasonic.lcd_brightness +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 15. -.It Sy hw.acpi.panasonic.sound_mute -Boolean flag to control whether to mute the speaker. +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 ---------- おがわ たかや t-ogawa@triaez.kaisei.org