xref: /netbsd-src/share/man/man4/acpi.4 (revision cac8e449158efc7261bebc8657cbb0125a2cfdde)
1.\" $NetBSD: acpi.4,v 1.28 2008/04/30 13:10:53 martin 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 May 8, 2007
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.Sh SUPPORTED DEVICES
107.Nx
108.Tn ACPI
109supports several machine-dependent and machine-independent devices:
110.Ss machine-independent devices
111.Bl -tag -width pcdisplay -offset indent
112.It acpiacad
113.Tn ACPI
114AC adapters.
115.It acpibat
116.Tn ACPI
117Control Method Batteries.
118.It acpibut
119.Tn ACPI
120power and sleep buttons.
121.It acpiec
122.Tn ACPI
123Embedded Controllers.
124.It acpilid
125.Tn ACPI
126lid switches.
127.It acpitz
128.Tn ACPI
129thermal zones.
130.It attimer
131AT Timer.
132.It aiboost
133ASUS AI Booster Hardware monitor.
134.It com
135NS8250-, NS16450-, and NS16550-based serial ports.
136.It fdc
137Floppy disk controllers.
138.It hpet
139High Precision Event Timer.
140.It joy
141Joystick/Game port interface.
142.It lpt
143Standard ISA parallel port interface.
144.It mpu
145Roland MPU-401 (compatible) MIDI UART.
146.It pcppi
147AT-style speaker sound.
148.It ug
149Abit uGuru Hardware monitor.
150.It wss
151Windows Sound System-compatible sound cards based on the AD1848 and compatible chips.
152.It ym
153Yamaha OPL3-SA2 and OPL3-SA3 audio device driver.
154.El
155.Ss i386-dependent devices
156.Bl -tag -width pcdisplay -offset indent
157.It npx
158i386 numeric processing extension coprocessor.
159.It pckbc
160PC keyboard controllers.
161.It sony
162Sony Miscellaneous Controller
163.It spic
164Sony programmable I/O controller.
165.It vald
166Toshiba Libretto device.
167.El
168.Sh SEE ALSO
169.Xr acpiacad 4 ,
170.Xr acpibat 4 ,
171.Xr acpibut 4 ,
172.Xr acpiec 4 ,
173.Xr acpilid 4 ,
174.Xr acpitz 4 ,
175.Xr aiboost 4 ,
176.Xr apm 4 ,
177.Xr attimer 4 ,
178.Xr com 4 ,
179.Xr fdc 4 ,
180.Xr joy 4 ,
181.Xr lpt 4 ,
182.Xr mpu 4 ,
183.Xr npx 4 ,
184.Xr pci 4 ,
185.Xr pckbc 4 ,
186.Xr pcppi 4 ,
187.Xr sony 4 ,
188.Xr spic 4 ,
189.Xr ug 4 ,
190.Xr vald 4 ,
191.Xr wss 4 ,
192.Xr ym 4 ,
193.Xr acpidump 8 ,
194.Xr amldb 8
195.Rs
196.%T ACPI specification
197.%O http://www.acpi.info/
198.Re
199.Rs
200.%T Intel ACPI CA (Component Architecture)
201.%O http://developer.intel.com/technology/iapc/acpi/
202.Re
203.Sh HISTORY
204The
205.Nm
206driver
207appeared in
208.Nx 1.6 .
209.Sh BUGS
210Most of the
211.Tn ACPI
212power management functionalities are not implemented.
213