Index: stable/10/share/man/man4/acpi_hp.4 =================================================================== --- stable/10/share/man/man4/acpi_hp.4 (revision 286261) +++ stable/10/share/man/man4/acpi_hp.4 (revision 286262) @@ -1,287 +1,289 @@ .\" Copyright (c) 2009 Michael Gmelin .\" 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 February 8, 2010 +.Dd June 19, 2015 .Dt ACPI_HP 4 .Os .Sh NAME .Nm acpi_hp .Nd "ACPI extras driver for HP laptops" .Sh SYNOPSIS To compile this driver into the kernel, place the following line in your kernel configuration file: .Bd -ragged -offset indent .Cd "device acpi_hp" .Ed .Pp Alternatively, to load the driver as a module at boot time, place the following line in .Xr loader.conf 5 : .Bd -literal -offset indent acpi_hp_load="YES" .Ed .Sh DESCRIPTION The .Nm driver provides support for ACPI-controlled features found on HP laptops -that use a WMI enabled BIOS (e.g. HP Compaq 8510p and 6510p). +that use a WMI enabled BIOS (e.g., HP Compaq 8510p and 6510p). .Pp The main purpose of this driver is to provide an interface, accessible via .Xr sysctl 8 , .Xr devd 8 and .Xr devfs 8 , through which applications can determine and change the status of various laptop components and BIOS settings. .Pp -.Ss Xr devd 8 Ss Events +.Ss Xr devd 8 Events Devd events received by .Xr devd 8 provide the following information: .Pp .Bl -tag -width "subsystem" -offset indent -compact .It system .Qq Li ACPI .It subsystem .Qq Li HP .It type The source of the event in the ACPI namespace. The value depends on the model. .It notify Event code (see below). .El .Pp Event codes: .Pp .Bl -tag -width "0xc0" -offset indent -compact .It Li 0xc0 WLAN on air status changed to 0 (not on air) .It Li 0xc1 WLAN on air status changed to 1 (on air) .It Li 0xd0 Bluetooth on air status changed to 0 (not on air) .It Li 0xd1 Bluetooth on air status changed to 1 (on air) .It Li 0xe0 WWAN on air status changed to 0 (not on air) .It Li 0xe1 WWAN on air status changed to 1 (on air) .El -.Ss Xr devfs 8 Ss Device +.Ss Xr devfs 8 Device You can read /dev/hpcmi to see your current BIOS settings. The detail level can be adjusted by setting the sysctl .Va cmi_detail as described below. .Sh SYSCTL VARIABLES The following sysctls are currently implemented: .Ss WLAN: .Bl -tag -width indent .It Va dev.acpi_hp.0.wlan_enabled Toggle WLAN chip activity. .It Va dev.acpi_hp.0.wlan_radio (read-only) WLAN radio status (controlled by hardware switch) .It Va dev.acpi_hp.0.wlan_on_air (read-only) WLAN on air (chip enabled, hardware switch enabled + enabled in BIOS) .It Va dev.acpi_hp.0.wlan_enabled_if_radio_on If set to 1, the WLAN chip will be enabled if the radio is turned on .It Va dev.acpi_hp.0.wlan_disable_if_radio_off If set to 1, the WLAN chip will be disabled if the radio is turned off .El .Ss Bluetooth: .Bl -tag -width indent .It Va dev.acpi_hp.0.bt_enabled Toggle Bluetooth chip activity. .It Va dev.acpi_hp.0.bt_radio (read-only) Bluetooth radio status (controlled by hardware switch) .It Va dev.acpi_hp.0.bt_on_air (read-only) Bluetooth on air (chip enabled, hardware switch enabled + enabled in BIOS) .It Va dev.acpi_hp.0.bt_enabled_if_radio_on If set to 1, the Bluetooth chip will be enabled if the radio is turned on .It Va dev.acpi_hp.0.bt_disable_if_radio_off If set to 1, the Bluetooth chip will be disabled if the radio is turned off .El .Ss WWAN: .Bl -tag -width indent .It Va dev.acpi_hp.0.wwan_enabled Toggle WWAN chip activity. .It Va dev.acpi_hp.0.wwan_radio (read-only) WWAN radio status (controlled by hardware switch) .It Va dev.acpi_hp.0.wwan_on_air (read-only) WWAN on air (chip enabled, hardware switch enabled + enabled in BIOS) .It Va dev.acpi_hp.0.wwan_enabled_if_radio_on If set to 1, the WWAN chip will be enabled if the radio is turned on .It Va dev.acpi_hp.0.wwan_disable_if_radio_off If set to 1, the WWAN chip will be disabled if the radio is turned off .El .Ss Misc: .Bl -tag -width indent .It Va dev.acpi_hp.0.als_enabled Toggle ambient light sensor (ALS) .It Va dev.acpi_hp.0.display (read-only) Display status (bitmask) .It Va dev.acpi_hp.0.hdd_temperature (read-only) HDD temperature .It Va dev.acpi_hp.0.is_docked (read-only) Docking station status (1 if docked) .It Va dev.acpi_hp.0.cmi_detail Bitmask to control detail level in /dev/hpcmi output (values can be ORed). .Bl -tag -width "0x01" -offset indent -compact .It Li 0x01 Show path component of BIOS setting .It Li 0x02 Show a list of valid options for the BIOS setting .It Li 0x04 Show additional flags of BIOS setting (ReadOnly etc.) .It Li 0x08 Query highest BIOS entry instance. This is broken on many HP models and therefore disabled by default. .El .It Va dev.acpi_hp.0.verbose (read-only) Set verbosity level .El .Pp Defaults for these sysctls can be set in .Xr sysctl.conf 5 . .Sh HARDWARE The .Nm driver has been reported to support the following hardware: .Pp .Bl -bullet -compact .It HP Compaq 8510p .It HP Compaq nx7300 .El .Pp It should work on most HP laptops that feature a WMI enabled BIOS. .Sh FILES .Bl -tag -width ".Pa /dev/hpcmi" .It Pa /dev/hpcmi Interface to read BIOS settings .El .Sh EXAMPLES The following can be added to .Xr devd.conf 5 -in order disable the LAN interface when WLAN on air and reenable if it's -not: +in order disable the LAN interface when WLAN on air and reenable if it is not: .Bd -literal -offset indent notify 0 { match "system" "ACPI"; match "subsystem" "HP"; match "notify" "0xc0"; action "ifconfig em0 up"; }; notify 0 { match "system" "ACPI"; match "subsystem" "HP"; match "notify" "0xc1"; action "ifconfig em0 down"; }; .Ed .Pp Enable the ambient light sensor: .Bd -literal -offset indent sysctl dev.acpi_hp.0.als_enabled=1 .Ed .Pp Enable Bluetooth: .Bd -literal -offset indent sysctl dev.acpi_hp.0.bt_enabled=1 .Ed .Pp Get BIOS settings: .Bd -literal -offset indent cat /dev/hpcmi Serial Port Disable Infrared Port Enable Parallel Port Disable Flash Media Reader Disable USB Ports including Express Card slot Enable 1394 Port Enable Cardbus Slot Disable Express Card Slot Disable (...) .Ed .Pp Set maximum detail level for /dev/hpcmi output: .Bd -literal -offset indent sysctl dev.acpi_hp.0.cmi_detail=7 .Ed .Sh SEE ALSO .Xr acpi 4 , .Xr acpi_wmi 4 , .Xr sysctl.conf 5 , .Xr devd 8 , .Xr devfs 8 , .Xr sysctl 8 .Sh HISTORY The .Nm device driver first appeared in .Fx 8.0 . .Sh AUTHORS .An -nosplit The .Nm driver was written by .An Michael Gmelin Aq freebsd@grem.de . .Pp It has been inspired by hp-wmi driver, which implements a subset of these features (hotkeys) on Linux. .Bl -tag -width indent .It HP CMI whitepaper: http://h20331.www2.hp.com/Hpsub/downloads/cmi_whitepaper.pdf .It wmi-hp for Linux: http://www.kernel.org .It WMI and ACPI: http://www.microsoft.com/whdc/system/pnppwr/wmi/wmi-acpi.mspx .El .Pp This manual page was written by .An Michael Gmelin Aq freebsd@grem.de . .Sh BUGS This driver is experimental and has only been tested on i386 on an HP Compaq 8510p which featured all supported wireless devices (WWAN/BT/WLAN). Expect undefined results when operating on different hardware. .Pp -Loading the driver is slow. Reading from /dev/hpcmi is even slower. +Loading the driver is slow. +Reading from +.Pa /dev/hpcmi +is even slower. .Pp Additional features like HP specific sensor readings or writing BIOS settings are not supported. Index: stable/10/share/man/man4/acpi_ibm.4 =================================================================== --- stable/10/share/man/man4/acpi_ibm.4 (revision 286261) +++ stable/10/share/man/man4/acpi_ibm.4 (revision 286262) @@ -1,485 +1,485 @@ .\" Copyright (c) 2005 Christian Brueffer .\" Copyright (c) 2005 Markus Brueffer .\" 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 June 24, 2012 +.Dd June 19, 2015 .Dt ACPI_IBM 4 .Os .Sh NAME .Nm acpi_ibm .Nd "ACPI extras driver for IBM laptops" .Sh SYNOPSIS To compile this driver into the kernel, place the following line in your kernel configuration file: .Bd -ragged -offset indent .Cd "device acpi_ibm" .Ed .Pp Alternatively, to load the driver as a module at boot time, place the following line in .Xr loader.conf 5 : .Bd -literal -offset indent acpi_ibm_load="YES" .Ed .Sh DESCRIPTION The .Nm driver provides support for hotkeys and other components of IBM laptops. The main purpose of this driver is to provide an interface, accessible via .Xr sysctl 8 and .Xr devd 8 , through which applications can determine the status of various laptop components. .Pp While the .Xr sysctl 8 interface is enabled automatically after loading the driver, the .Xr devd 8 interface has to be enabled explicitly, as it may alter the default action of certain keys. This is done by setting the .Va 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 .Va eventmask sysctl, is set to .Va availmask by default, a value representing all possible keypress events on the specific ThinkPad model. -.Ss Xr devd 8 Ss Events +.Ss Xr devd 8 Events Hotkey events received by .Xr devd 8 provide the following information: .Pp .Bl -tag -width "subsystem" -offset indent -compact .It system .Qq Li ACPI .It subsystem .Qq Li IBM .It type The source of the event in the ACPI namespace. The value depends on the model. .It notify Event code (see below). .El .Pp Depending on the ThinkPad model, event codes may vary. On a ThinkPad T41p these are as follows: .Pp .Bl -tag -width "subsystem" -offset indent -compact .It Li 0x01 Fn + F1 .It Li 0x02 Fn + F2 .It Li 0x03 Fn + F3 (LCD backlight) .It Li 0x04 Fn + F4 (Suspend to RAM) .It Li 0x05 Fn + F5 (Bluetooth) .It Li 0x06 Fn + F6 .It Li 0x07 Fn + F7 (Screen expand) .It Li 0x08 Fn + F8 .It Li 0x09 Fn + F9 .It Li 0x0a Fn + F10 .It Li 0x0b Fn + F11 .It Li 0x0c Fn + F12 (Suspend to disk) .It Li 0x0d Fn + Backspace .It Li 0x0e Fn + Insert .It Li 0x0f Fn + Delete .It Li 0x10 Fn + Home (Brightness up) .It Li 0x11 Fn + End (Brightness down) .It Li 0x12 Fn + PageUp (ThinkLight) .It Li 0x13 Fn + PageDown .It Li 0x14 Fn + Space (Zoom) .It Li 0x15 Volume Up .It Li 0x16 Volume Down .It Li 0x17 Mute .It Li 0x18 Access IBM Button .El -.Ss Xr led 4 Ss Interface +.Ss Xr led 4 Interface The .Nm driver provides a .Xr led 4 interface for the ThinkLight. The ThinkLight can be made to blink by writing .Tn ASCII strings to the .Pa /dev/led/thinklight device. .Sh SYSCTL VARIABLES The following sysctls are currently implemented: .Bl -tag -width indent .It Va dev.acpi_ibm.0.initialmask (read-only) Bitmask of ACPI events before the .Nm driver was loaded. .It Va dev.acpi_ibm.0.availmask (read-only) Bitmask of all supported ACPI events. .It Va dev.acpi_ibm.0.events Enable ACPI events and set the .Va eventmask to .Va availmask . Without the .Nm driver being loaded, only the Fn+F4 button generates an ACPI event. .It Va dev.acpi_ibm.0.eventmask Sets the ACPI events which are reported to .Xr devd 8 . Fn+F3, Fn+F4 and Fn+F12 always generate ACPI events, regardless which value .Va eventmask has. Depending on the ThinkPad model, the meaning of different bits in the .Va eventmask may vary. On a ThinkPad T41p this is a bitwise OR of the following: .Pp .Bl -tag -width indent-two -compact .It Li 1 Fn + F1 .It Li 2 Fn + F2 .It Li 4 Fn + F3 (LCD backlight) .It Li 8 Fn + F4 (Suspend to RAM) .It Li 16 Fn + F5 (Bluetooth) .It Li 32 Fn + F6 .It Li 64 Fn + F7 (Screen expand) .It Li 128 Fn + F8 .It Li 256 Fn + F9 .It Li 512 Fn + F10 .It Li 1024 Fn + F11 .It Li 2048 Fn + F12 (Suspend to disk) .It Li 4096 Fn + Backspace .It Li 8192 Fn + Insert .It Li 16384 Fn + Delete .It Li 32768 Fn + Home (Brightness up) .It Li 65536 Fn + End (Brightness down) .It Li 131072 Fn + PageUp (ThinkLight) .It Li 262144 Fn + PageDown .It Li 524288 Fn + Space (Zoom) .It Li 1048576 Volume Up .It Li 2097152 Volume Down .It Li 4194304 Mute .It Li 8388608 Access IBM Button .El .It Va dev.acpi_ibm.0.hotkey (read-only) Status of several buttons. Every time a button is pressed, the respecting bit is toggled. It is a bitwise OR of the following: .Pp .Bl -tag -width indent-two -compact .It Li 1 Home Button .It Li 2 Search Button .It Li 4 Mail Button .It Li 8 Access IBM Button .It Li 16 Zoom .It Li 32 Wireless LAN Button .It Li 64 Video Button .It Li 128 Hibernate Button .It Li 256 ThinkLight Button .It Li 512 Screen Expand .It Li 1024 Brightness Up/Down Button .It Li 2048 Volume Up/Down/Mute Button .El .It Va dev.acpi_ibm.0.lcd_brightness Current brightness level of the display. .It Va dev.acpi_ibm.0.volume Speaker volume. .It Va dev.acpi_ibm.0.mute Indicates, whether the speakers are muted or not. .It Va dev.acpi_ibm.0.thinklight Indicates, whether the ThinkLight keyboard light is activated or not. .It Va dev.acpi_ibm.0.bluetooth Toggle Bluetooth chip activity. .It Va dev.acpi_ibm.0.wlan (read-only) Indicates whether the WLAN chip is active or not. .It Va dev.acpi_ibm.0.fan Indicates whether the fan is in automatic (1) or manual (0) mode. Default is automatic mode. This sysctl should be used with extreme precaution, since disabling automatic fan control might overheat the ThinkPad and lead to permanent damage if the .Va fan_level is not set accordingly. .It Va dev.acpi_ibm.0.fan_level Indicates at what speed the fan should run when being in manual mode. Values are ranging from 0 (off) to 7 (max). The resulting speed differs from model to model. On a T41p this is as follows: .Pp .Bl -tag -width indent-two -compact .It Li 0 off .It Li 1, 2 ~3000 RPM .It Li 3, 4, 5 ~3600 RPM .It Li 6, 7 ~4300 RPM .El .It Va dev.acpi_ibm.0.fan_speed (read-only) Fan speed in rounds per minute. A few older ThinkPads report the fan speed in levels ranging from 0 (off) to 7 (max). .It Va dev.acpi_ibm.0.thermal (read-only) Shows the readings of up to eight different temperature sensors. Most ThinkPads include six or more temperature sensors but only expose the CPU temperature through .Xr acpi_thermal 4 . Some ThinkPads have the below sensor layout which might vary depending on the specific model: .Pp .Bl -enum -compact .It CPU .It Mini PCI Module .It HDD .It GPU .It Built-in battery .It UltraBay battery .It Built-in battery .It UltraBay battery .El .It Va dev.acpi_ibm.0.handlerevents .Xr devd 8 events handled by .Nm when .Va events is set to 1. Events are specified as a whitespace-separated list of event code in hexadecimal or decimal form. -Note that the event maybe handled twice (eg. Brightness up/down) if ACPI BIOS +Note that the event maybe handled twice (e.g., Brightness up/down) if ACPI BIOS already handled the event. .El .Pp Defaults for these sysctls can be set in .Xr sysctl.conf 5 . .Sh FILES .Bl -tag -width ".Pa /dev/led/thinklight" .It Pa /dev/led/thinklight ThinkLight .Xr led 4 device node .El .Sh EXAMPLES The following can be added to .Xr devd.conf 5 in order to pass button events to a .Pa /usr/local/sbin/acpi_oem_exec.sh script: .Bd -literal -offset indent notify 10 { match "system" "ACPI"; match "subsystem" "IBM"; action "/usr/local/sbin/acpi_oem_exec.sh $notify ibm"; }; .Ed .Pp A possible .Pa /usr/local/sbin/acpi_oem_exec.sh script might look like: .Bd -literal -offset indent #!/bin/sh # if [ "$1" = "" -o "$2" = "" ] then echo "usage: $0 notify oem_name" exit 1 fi NOTIFY=`echo $1` LOGGER="logger" CALC="bc" BC_PRECOMMANDS="scale=2" ECHO="echo" CUT="cut" MAX_LCD_BRIGHTNESS=7 MAX_VOLUME=14 OEM=$2 DISPLAY_PIPE=/tmp/acpi_${OEM}_display case ${NOTIFY} in 0x05) LEVEL=`sysctl -n dev.acpi_${OEM}.0.bluetooth` if [ "$LEVEL" = "1" ] then sysctl dev.acpi_${OEM}.0.bluetooth=0 MESSAGE="bluetooth disabled" else sysctl dev.acpi_${OEM}.0.bluetooth=1 MESSAGE="bluetooth enabled" fi ;; 0x10|0x11) LEVEL=`sysctl -n dev.acpi_${OEM}.0.lcd_brightness` PERCENT=`${ECHO} "${BC_PRECOMMANDS} ; \\ ${LEVEL} / ${MAX_LCD_BRIGHTNESS} * 100" |\\ ${CALC} | ${CUT} -d . -f 1` MESSAGE="brightness level ${PERCENT}%" ;; 0x12) LEVEL=`sysctl -n dev.acpi_${OEM}.0.thinklight` if [ "$LEVEL" = "1" ] then MESSAGE="thinklight enabled" else MESSAGE="thinklight disabled" fi ;; 0x15|0x16) LEVEL=`sysctl -n dev.acpi_${OEM}.0.volume` PERCENT=`${ECHO} "${BC_PRECOMMANDS} ; \\ ${LEVEL} / ${MAX_VOLUME} * 100" | \\ ${CALC} | ${CUT} -d . -f 1` MESSAGE="volume level ${PERCENT}%" ;; 0x17) LEVEL=`sysctl -n dev.acpi_${OEM}.0.mute` if [ "$LEVEL" = "1" ] then MESSAGE="volume muted" else MESSAGE="volume unmuted" fi ;; *) ;; esac ${LOGGER} ${MESSAGE} if [ -p ${DISPLAY_PIPE} ] then ${ECHO} ${MESSAGE} >> ${DISPLAY_PIPE} & fi exit 0 .Ed .Pp The following example specify that event code 0x04 (Suspend to RAM), 0x10 (Brightness up) and 0x11 (Brightness down) are handled by .Nm . .Bd -literal -offset indent sysctl dev.acpi_ibm.0.handlerevents='0x04 0x10 0x11' .Ed .Pp in .Xr sysctl.conf 5 : .Bd -literal -offset indent dev.acpi_ibm.0.handlerevents=0x04\\ 0x10\\ 0x11 .Ed .Sh SEE ALSO .Xr acpi 4 , .Xr led 4 , .Xr sysctl.conf 5 , .Xr devd 8 , .Xr sysctl 8 .Sh HISTORY The .Nm device driver first appeared in .Fx 6.0 . .Sh AUTHORS .An -nosplit The .Nm driver was written by .An Takanori Watanabe Aq takawata@FreeBSD.org and later mostly rewritten by .An Markus Brueffer Aq markus@FreeBSD.org . This manual page was written by .An Christian Brueffer Aq brueffer@FreeBSD.org and .An Markus Brueffer Aq markus@FreeBSD.org . Index: stable/10/share/man/man4/acpi_panasonic.4 =================================================================== --- stable/10/share/man/man4/acpi_panasonic.4 (revision 286261) +++ stable/10/share/man/man4/acpi_panasonic.4 (revision 286262) @@ -1,178 +1,178 @@ .\" .\" 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 February 25, 2012 +.Dd June 19, 2015 .Dt ACPI_PANASONIC 4 .Os .Sh NAME .Nm acpi_panasonic .Nd "ACPI hotkey driver for Panasonic laptops" .Sh SYNOPSIS To compile this driver into the kernel, place the following line in your kernel configuration file: .Bd -ragged -offset indent .Cd "device acpi_panasonic" .Ed .Pp Alternatively, to load the driver as a module at boot time, place the following line in .Xr loader.conf 5 : .Bd -literal -offset indent acpi_panasonic_load="YES" .Ed .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 occurrences 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 .Xr sysctl 8 . .Ss Hotkeys There are 9 hotkeys available on the supported hardware: .Pp .Bl -tag -width 10n -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 , 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 Xr devd 8 Ss Events +.Ss Xr devd 8 Events When notified to .Xr devd 8 , the hotkey event provides the following information: .Pp .Bl -tag -width 10n -compact -offset indent .It system .Qq Li ACPI .It subsystem .Qq Li Panasonic .It type The source of the event in ACPI namespace. The value depends on the model but typically .Qq Li \e_SB_.HKEY . .It notify Event code (see below). .El .Pp Event codes to be generated are assigned as follows: .Bl -tag -width 10n -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 SYSCTL VARIABLES The following MIBs are available: .Bl -tag -width indent .It Va hw.acpi.panasonic.lcd_brightness_max The maximum level of brightness. The value is read only and automatically set according to hardware model. .It Va hw.acpi.panasonic.lcd_brightness_min The minimum level of brightness. The value is read only and automatically set according to hardware model. .It Va hw.acpi.panasonic.lcd_brightness Current brightness level of the LCD (read-write). The value ranges from .Va hw.acpi.panasonic.lcd_brightness_min to .Va hw.acpi.panasonic.lcd_brightness_max . .It Va 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. .El .Sh SEE ALSO .Xr acpi 4 , .Xr devd.conf 5 , .Xr devd 8 , .Xr sysctl 8 .Sh HISTORY The .Nm driver first appeared in .Fx 5.3 . .Sh AUTHORS .An -nosplit 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 . Index: stable/10 =================================================================== --- stable/10 (revision 286261) +++ stable/10 (revision 286262) Property changes on: stable/10 ___________________________________________________________________ Modified: svn:mergeinfo ## -0,0 +0,1 ## Merged /head:r284611