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