xref: /netbsd-src/share/man/man4/acpi.4 (revision fad4c9f71477ae11cea2ee75ec82151ac770a534)
1.\" $NetBSD: acpi.4,v 1.22 2006/03/26 14:27:54 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.\" 3. All advertising materials mentioning features or use of this software
15.\"    must display the following acknowledgement:
16.\"        This product includes software developed by the NetBSD
17.\"        Foundation, Inc. and its contributors.
18.\" 4. Neither the name of The NetBSD Foundation nor the names of its
19.\"    contributors may be used to endorse or promote products derived
20.\"    from this software without specific prior written permission.
21.\"
22.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
23.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
24.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
25.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
26.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
27.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
28.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
29.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
30.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
31.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
32.\" POSSIBILITY OF SUCH DAMAGE.
33.\"
34.Dd March 25, 2006
35.Dt ACPI 4
36.Os
37.Sh NAME
38.Nm acpi
39.Nd Advanced Configuration and Power Interface
40.Sh SYNOPSIS
41.Cd "acpi0     at mainbus0"
42.Cd "acpiacad* at acpi?"
43.Cd "acpibat*  at acpi?"
44.Cd "acpibut*  at acpi?"
45.Cd "acpiec*   at acpi?"
46.Cd "acpilid*  at acpi?"
47.Cd "acpitz*   at acpi?"
48.Cd "attimer*  at acpi?"
49.Cd "com*      at acpi?"
50.Cd "fdc*      at acpi?"
51.Cd "joy*      at acpi?"
52.Cd "lpt*      at acpi?"
53.Cd "mpu*      at acpi?"
54.Cd "npx*      at acpi?"
55.Cd "pckbc*    at acpi?"
56.Cd "pcppi*    at acpi?"
57.Cd "sony*     at acpi?"
58.Cd "spic*     at acpi?"
59.Cd "vald*     at acpi?"
60.Cd "wss*      at acpi?"
61.Pp
62.Cd "options   ACPI_DEBUG"
63.Cd "options   ACPIVERBOSE"
64.Cd "options   ACPI_ACTIVATE_DEV"
65.Cd "options   ACPICA_PEDANTIC"
66.Cd "options   ACPI_DSDT_OVERRIDE"
67.Sh DESCRIPTION
68.Nx
69provides machine-independent bus support for
70.Tn ACPI
71devices and includes several
72.Tn ACPI
73device drivers.
74.Pp
75The
76.Nx
77implementation of
78.Tn ACPI
79integrates Intel's ACPI Component Architecture
80(aka ACPI-CA) for the OS-independent part.
81The ACPI-CA provides
82OS-neutral ACPI functionalities such as ACPI BIOS table support,
83an ACPI event framework and an AML (ACPI Machine Language) interpreter.
84.Pp
85Options:
86.Bl -tag -width ACPI_DSDT_FILE__filename_XX -offset 3n
87.It Dv ACPI_DEBUG
88Enable ACPI debugging message outputs.
89.It Dv ACPI_ACTIVATE_DEV
90Determine if the ACPI driver should attempt to activate
91inactive devices.
92The default is off.
93.It Dv ACPICA_PEDANTIC
94Force strict conformance to the ACPI specification in the
95ACPI-CA.
96Do not enable this option unless you are debugging.
97.It Dv ACPI_DSDT_OVERRIDE
98Force a given DSDT instead of the BIOS-supplied version.
99Use
100.Dv ACPI_DSDT_FILE
101to specify a DSDT.
102.It Dv ACPI_DSDT_FILE="filename"
103If
104.Dv ACPI_DSDT_FILE
105is not specified, default to
106.Dq dsdt.hex
107in the build directory.
108.El
109.Sh SUPPORTED DEVICES
110.Nx
111.Tn ACPI
112supports several machine-dependent and machine-independent devices:
113.Ss machine-independent devices
114.Bl -tag -width pcdisplay -offset indent
115.It acpiacad
116.Tn ACPI
117AC adapters.
118.It acpibat
119.Tn ACPI
120Control Method Batteries.
121.It acpibut
122.Tn ACPI
123power and sleep buttons.
124.It acpiec
125.Tn ACPI
126Embedded Controllers.
127.It acpilid
128.Tn ACPI
129lid switches.
130.It acpitz
131.Tn ACPI
132thermal zones.
133.It attimer
134AT Timer.
135.It com
136NS8250-, NS16450-, and NS16550-based serial ports.
137.It fdc
138Floppy disk controllers.
139.It joy
140Joystick/Game port interface.
141.It lpt
142Standard ISA parallel port interface.
143.It mpu
144Roland MPU-401 (compatible) MIDI UART.
145.It pcppi
146AT-style speaker sound.
147.It wss
148Windows Sound System-compatible sound cards based on the AD1848 and compatible chips.
149.El
150.Ss i386-dependent devices
151.Bl -tag -width pcdisplay -offset indent
152.It npx
153i386 numeric processing extension coprocessor.
154.It pckbc
155PC keyboard controllers.
156.It sony
157Sony Miscellaneous Controller
158.It spic
159Sony programmable I/O controller.
160.It vald
161Toshiba Libretto device.
162.El
163.Sh SEE ALSO
164.Xr acpiacad 4 ,
165.Xr acpibat 4 ,
166.Xr acpibut 4 ,
167.Xr acpiec 4 ,
168.Xr acpilid 4 ,
169.Xr acpitz 4 ,
170.Xr apm 4 ,
171.Xr attimer 4 ,
172.Xr com 4 ,
173.Xr fdc 4 ,
174.Xr joy 4 ,
175.Xr lpt 4 ,
176.Xr mpu 4 ,
177.Xr npx 4 ,
178.Xr pci 4 ,
179.Xr pckbc 4 ,
180.Xr pcppi 4 ,
181.Xr sony 4 ,
182.Xr spic 4 ,
183.Xr vald 4 ,
184.Xr wss 4
185.Rs
186.%T ACPI specification
187.%O http://www.acpi.info/
188.Re
189.Rs
190.%T Intel ACPI CA (Component Architecture)
191.%O http://developer.intel.com/technology/iapc/acpi/
192.Re
193.Sh HISTORY
194The
195.Nm
196driver
197appeared in
198.Nx 1.6 .
199.Sh BUGS
200Most of the
201.Tn ACPI
202power management functionalities are not implemented.
203