xref: /netbsd-src/share/man/man4/acpi.4 (revision 8b0f9554ff8762542c4defc4f70e1eb76fb508fa)
1.\" $NetBSD: acpi.4,v 1.27 2007/05/08 16:52:24 xtraeme 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 May 8, 2007
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 "aiboost*  at acpi?"
50.Cd "com*      at acpi?"
51.Cd "fdc*      at acpi?"
52.Cd "hpet*     at acpi?"
53.Cd "joy*      at acpi?"
54.Cd "lpt*      at acpi?"
55.Cd "mpu*      at acpi?"
56.Cd "npx*      at acpi?"
57.Cd "pckbc*    at acpi?"
58.Cd "pcppi*    at acpi?"
59.Cd "sony*     at acpi?"
60.Cd "spic*     at acpi?"
61.Cd "ug*       at acpi?"
62.Cd "vald*     at acpi?"
63.Cd "wss*      at acpi?"
64.Cd "ym*       at acpi?"
65.Pp
66.Cd "options   ACPI_DEBUG"
67.Cd "options   ACPIVERBOSE"
68.Cd "options   ACPI_ACTIVATE_DEV"
69.Cd "options   ACPICA_PEDANTIC"
70.Cd "options   ACPI_DSDT_OVERRIDE"
71.Sh DESCRIPTION
72.Nx
73provides machine-independent bus support for
74.Tn ACPI
75devices and includes several
76.Tn ACPI
77device drivers.
78.Pp
79The
80.Nx
81implementation of
82.Tn ACPI
83integrates Intel's ACPI Component Architecture
84(aka ACPI-CA) for the OS-independent part.
85The ACPI-CA provides
86OS-neutral ACPI functionalities such as ACPI BIOS table support,
87an ACPI event framework and an AML (ACPI Machine Language) interpreter.
88.Pp
89Options:
90.Bl -tag -width ACPI_DSDT_FILE__filename_XX -offset 3n
91.It Dv ACPI_DEBUG
92Enable ACPI debugging message outputs.
93.It Dv ACPI_ACTIVATE_DEV
94Determine if the ACPI driver should attempt to activate
95inactive devices.
96The default is off.
97.It Dv ACPICA_PEDANTIC
98Force strict conformance to the ACPI specification in the
99ACPI-CA.
100Do not enable this option unless you are debugging.
101.It Dv ACPI_DSDT_OVERRIDE
102Force a given DSDT instead of the BIOS-supplied version.
103Use
104.Dv ACPI_DSDT_FILE
105to specify a DSDT.
106.It Dv ACPI_DSDT_FILE="filename"
107If
108.Dv ACPI_DSDT_FILE
109is not specified, default to
110.Dq dsdt.hex
111in the build directory.
112.El
113.Sh SUPPORTED DEVICES
114.Nx
115.Tn ACPI
116supports several machine-dependent and machine-independent devices:
117.Ss machine-independent devices
118.Bl -tag -width pcdisplay -offset indent
119.It acpiacad
120.Tn ACPI
121AC adapters.
122.It acpibat
123.Tn ACPI
124Control Method Batteries.
125.It acpibut
126.Tn ACPI
127power and sleep buttons.
128.It acpiec
129.Tn ACPI
130Embedded Controllers.
131.It acpilid
132.Tn ACPI
133lid switches.
134.It acpitz
135.Tn ACPI
136thermal zones.
137.It attimer
138AT Timer.
139.It aiboost
140ASUS AI Booster Hardware monitor.
141.It com
142NS8250-, NS16450-, and NS16550-based serial ports.
143.It fdc
144Floppy disk controllers.
145.It hpet
146High Precision Event Timer.
147.It joy
148Joystick/Game port interface.
149.It lpt
150Standard ISA parallel port interface.
151.It mpu
152Roland MPU-401 (compatible) MIDI UART.
153.It pcppi
154AT-style speaker sound.
155.It ug
156Abit uGuru Hardware monitor.
157.It wss
158Windows Sound System-compatible sound cards based on the AD1848 and compatible chips.
159.It ym
160Yamaha OPL3-SA2 and OPL3-SA3 audio device driver.
161.El
162.Ss i386-dependent devices
163.Bl -tag -width pcdisplay -offset indent
164.It npx
165i386 numeric processing extension coprocessor.
166.It pckbc
167PC keyboard controllers.
168.It sony
169Sony Miscellaneous Controller
170.It spic
171Sony programmable I/O controller.
172.It vald
173Toshiba Libretto device.
174.El
175.Sh SEE ALSO
176.Xr acpiacad 4 ,
177.Xr acpibat 4 ,
178.Xr acpibut 4 ,
179.Xr acpiec 4 ,
180.Xr acpilid 4 ,
181.Xr acpitz 4 ,
182.Xr aiboost 4 ,
183.Xr apm 4 ,
184.Xr attimer 4 ,
185.Xr com 4 ,
186.Xr fdc 4 ,
187.Xr joy 4 ,
188.Xr lpt 4 ,
189.Xr mpu 4 ,
190.Xr npx 4 ,
191.Xr pci 4 ,
192.Xr pckbc 4 ,
193.Xr pcppi 4 ,
194.Xr sony 4 ,
195.Xr spic 4 ,
196.Xr ug 4 ,
197.Xr vald 4 ,
198.Xr wss 4 ,
199.Xr ym 4 ,
200.Xr acpidump 8 ,
201.Xr amldb 8
202.Rs
203.%T ACPI specification
204.%O http://www.acpi.info/
205.Re
206.Rs
207.%T Intel ACPI CA (Component Architecture)
208.%O http://developer.intel.com/technology/iapc/acpi/
209.Re
210.Sh HISTORY
211The
212.Nm
213driver
214appeared in
215.Nx 1.6 .
216.Sh BUGS
217Most of the
218.Tn ACPI
219power management functionalities are not implemented.
220