1.\" $NetBSD: acpi.4,v 1.29 2008/09/21 11:12:36 wiz Exp $ 2.\" 3.\" Copyright (c) 2002, 2004 The NetBSD Foundation, Inc. 4.\" All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 1. Redistributions of source code must retain the above copyright 10.\" notice, this list of conditions and the following disclaimer. 11.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" notice, this list of conditions and the following disclaimer in the 13.\" documentation and/or other materials provided with the distribution. 14.\" 15.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 16.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 17.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 18.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 19.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 20.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 21.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 22.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 23.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 24.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 25.\" POSSIBILITY OF SUCH DAMAGE. 26.\" 27.Dd September 21, 2008 28.Dt ACPI 4 29.Os 30.Sh NAME 31.Nm acpi 32.Nd Advanced Configuration and Power Interface 33.Sh SYNOPSIS 34.Cd "acpi0 at mainbus0" 35.Cd "acpiacad* at acpi?" 36.Cd "acpibat* at acpi?" 37.Cd "acpibut* at acpi?" 38.Cd "acpiec* at acpi?" 39.Cd "acpilid* at acpi?" 40.Cd "acpitz* at acpi?" 41.Cd "attimer* at acpi?" 42.Cd "aiboost* at acpi?" 43.Cd "com* at acpi?" 44.Cd "fdc* at acpi?" 45.Cd "hpet* at acpi?" 46.Cd "joy* at acpi?" 47.Cd "lpt* at acpi?" 48.Cd "mpu* at acpi?" 49.Cd "npx* at acpi?" 50.Cd "pckbc* at acpi?" 51.Cd "pcppi* at acpi?" 52.Cd "sony* at acpi?" 53.Cd "spic* at acpi?" 54.Cd "ug* at acpi?" 55.Cd "vald* at acpi?" 56.Cd "wss* at acpi?" 57.Cd "ym* at acpi?" 58.Pp 59.Cd "options ACPI_DEBUG" 60.Cd "options ACPIVERBOSE" 61.Cd "options ACPI_ACTIVATE_DEV" 62.Cd "options ACPICA_PEDANTIC" 63.Cd "options ACPI_DSDT_OVERRIDE" 64.Sh DESCRIPTION 65.Nx 66provides machine-independent bus support for 67.Tn ACPI 68devices and includes several 69.Tn ACPI 70device drivers. 71.Pp 72The 73.Nx 74implementation of 75.Tn ACPI 76integrates Intel's ACPI Component Architecture 77(aka ACPI-CA) for the OS-independent part. 78The ACPI-CA provides 79OS-neutral ACPI functionalities such as ACPI BIOS table support, 80an ACPI event framework and an AML (ACPI Machine Language) interpreter. 81.Pp 82Options: 83.Bl -tag -width ACPI_DSDT_FILE__filename_XX -offset 3n 84.It Dv ACPI_DEBUG 85Enable ACPI debugging message outputs. 86.It Dv ACPI_ACTIVATE_DEV 87Determine if the ACPI driver should attempt to activate 88inactive devices. 89The default is off. 90.It Dv ACPICA_PEDANTIC 91Force strict conformance to the ACPI specification in the 92ACPI-CA. 93Do not enable this option unless you are debugging. 94.It Dv ACPI_DSDT_OVERRIDE 95Force a given DSDT instead of the BIOS-supplied version. 96Use 97.Dv ACPI_DSDT_FILE 98to specify a DSDT. 99.It Dv ACPI_DSDT_FILE="filename" 100If 101.Dv ACPI_DSDT_FILE 102is not specified, default to 103.Dq dsdt.hex 104in the build directory. 105.El 106.Ss sysctl support 107Two 108.Xr sysctl 8 109settings are especially relevant for 110.Nm : 111.Li hw.acpi_supported_states 112and 113.Li machdep.acpi_vbios_reset . 114.Li hw.acpi_supported_states 115is a list of the supported states (see 116.Xr sysctl 7 ) . 117.Li machdep.acpi_vbios_reset 118defines the handling of the graphics card. 119The supported values for this are: 120.Bl -tag -width 2 121.It 0 122No attempt to reset the VGA controller is done. 123.It 1 124Call the VGA BIOS when still in real mode. 125This can result in direct reboots. 126In that case, use 127.Sq 2 128or 129.Ic vbetool post 130from the 131.Pa pkgsrc/sysutils/vbetool 132package. 133.It 2 134Call the VGA BIOS using the in-kernel x86 emulator. 135.El 136.Sh SUPPORTED DEVICES 137.Nx 138.Tn ACPI 139supports several machine-dependent and machine-independent devices: 140.Ss machine-independent devices 141.Bl -tag -width pcdisplay -offset indent 142.It acpiacad 143.Tn ACPI 144AC adapters. 145.It acpibat 146.Tn ACPI 147Control Method Batteries. 148.It acpibut 149.Tn ACPI 150power and sleep buttons. 151.It acpiec 152.Tn ACPI 153Embedded Controllers. 154.It acpilid 155.Tn ACPI 156lid switches. 157.It acpitz 158.Tn ACPI 159thermal zones. 160.It attimer 161AT Timer. 162.It aiboost 163ASUS AI Booster Hardware monitor. 164.It com 165NS8250-, NS16450-, and NS16550-based serial ports. 166.It fdc 167Floppy disk controllers. 168.It hpet 169High Precision Event Timer. 170.It joy 171Joystick/Game port interface. 172.It lpt 173Standard ISA parallel port interface. 174.It mpu 175Roland MPU-401 (compatible) MIDI UART. 176.It pcppi 177AT-style speaker sound. 178.It ug 179Abit uGuru Hardware monitor. 180.It wss 181Windows Sound System-compatible sound cards based on the AD1848 and compatible chips. 182.It ym 183Yamaha OPL3-SA2 and OPL3-SA3 audio device driver. 184.El 185.Ss i386-dependent devices 186.Bl -tag -width pcdisplay -offset indent 187.It npx 188i386 numeric processing extension coprocessor. 189.It pckbc 190PC keyboard controllers. 191.It sony 192Sony Miscellaneous Controller 193.It spic 194Sony programmable I/O controller. 195.It vald 196Toshiba Libretto device. 197.El 198.Sh SEE ALSO 199.Xr acpiacad 4 , 200.Xr acpibat 4 , 201.Xr acpibut 4 , 202.Xr acpiec 4 , 203.Xr acpilid 4 , 204.Xr acpitz 4 , 205.Xr aiboost 4 , 206.Xr apm 4 , 207.Xr attimer 4 , 208.Xr com 4 , 209.Xr fdc 4 , 210.Xr joy 4 , 211.Xr lpt 4 , 212.Xr mpu 4 , 213.Xr npx 4 , 214.Xr pci 4 , 215.Xr pckbc 4 , 216.Xr pcppi 4 , 217.Xr sony 4 , 218.Xr spic 4 , 219.Xr ug 4 , 220.Xr vald 4 , 221.Xr wss 4 , 222.Xr ym 4 , 223.Xr acpidump 8 , 224.Xr amldb 8 225.Rs 226.%T ACPI specification 227.%O http://www.acpi.info/ 228.Re 229.Rs 230.%T Intel ACPI CA (Component Architecture) 231.%O http://developer.intel.com/technology/iapc/acpi/ 232.Re 233.Sh HISTORY 234The 235.Nm 236driver 237appeared in 238.Nx 1.6 . 239.Sh BUGS 240Most of the 241.Tn ACPI 242power management functionalities are not implemented. 243