xref: /netbsd-src/share/man/man4/acpi.4 (revision fd5cb0acea84d278e04e640d37ca2398f894991f)
1.\" $NetBSD: acpi.4,v 1.13 2004/12/02 14:33:31 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 December 2, 2004
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 "com*      at acpi?"
49.Cd "fdc*      at acpi?"
50.Cd "joy*      at acpi?"
51.Cd "lpt*      at acpi?"
52.Cd "mpu*      at acpi?"
53.Cd "npx*      at acpi?"
54.Cd "pckbc*    at acpi?"
55.Cd "spic*     at acpi?"
56.Cd "vald*     at acpi?"
57.Cd "wss*      at acpi?"
58.Pp
59.Cd "options   ACPI_DEBUG"
60.Cd "options   ACPIVERBOSE"
61.Cd "options   ACPI_PCI_FIXUP"
62.Cd "options   ACPI_ACTIVATE_DEV=0"
63.Cd "options   ACPICA_PEDANTIC"
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_ACTIVATE_DEV -offset 3n
84.It Nm ACPI_DEBUG
85Enable ACPI debugging message outputs.
86.It Nm ACPI_PCI_FIXUP
87Enable ACPI-based PCI interrupt routing fixup.
88If you have PCI interrupt related problem, try this option.
89.It Nm ACPI_ACTIVATE_DEV
90Determine if the ACPI driver should attempt to activate
91inactive devices.
92The default is off.
93.It Nm ACPICA_PEDANTIC
94Force strict conformance to the ACPI specification in the
95ACPI-CA.
96Do not enable this option unless you are debugging.
97.El
98.Sh SUPPORTED DEVICES
99.Nx
100.Tn ACPI
101supports several machine-dependent and machine-independent devices:
102.Ss machine-independent devices
103.Bl -tag -width pcdisplay -offset indent
104.It acpiacad
105.Tn ACPI
106AC adapters.
107.It acpibat
108.Tn ACPI
109Control Method Batteries.
110.It acpibut
111.Tn ACPI
112power and sleep buttons.
113.It acpiec
114.Tn ACPI
115Embedded Controllers.
116.It acpilid
117.Tn ACPI
118lid switches.
119.It acpitz
120.Tn ACPI
121thermal zones.
122.It com
123NS8250-, NS16450-, and NS16550-based serial ports.
124.It fdc
125Floppy disk controllers.
126.It joy
127Joystick/Game port interface.
128.It lpt
129Standard ISA parallel port interface.
130.It mpu
131Roland MPU-401 (compatible) MIDI UART.
132.It wss
133Windows Sound System-compatible sound cards based on the AD1848 and compatible chips.
134.El
135.Ss i386-dependent devices
136.Bl -tag -width pcdisplay -offset indent
137.It npx
138i386 numeric processing extension coprocessor.
139.It pckbc
140PC keyboard controllers.
141.It spic
142Sony programmable I/O controller.
143.It vald
144Toshiba Libretto device.
145.El
146.Sh SEE ALSO
147.Xr acpiacad 4 ,
148.Xr acpibat 4 ,
149.Xr acpibut 4 ,
150.Xr acpiec 4 ,
151.Xr acpilid 4 ,
152.Xr acpitz 4 ,
153.Xr apm 4 ,
154.Xr com 4 ,
155.Xr fdc 4 ,
156.Xr joy 4 ,
157.Xr lpt 4 ,
158.Xr mpu 4 ,
159.Xr npx 4 ,
160.Xr pci 4 ,
161.Xr pckbc 4 ,
162.Xr spic 4 ,
163.Xr vald 4 ,
164.Xr wss 4
165.Rs
166.%T ACPI specification
167.%O http://www.acpi.info/
168.Re
169.Rs
170.%T Intel ACPI CA (Component Architecture)
171.%O http://developer.intel.com/technology/iapc/acpi/
172.Re
173.Sh HISTORY
174The
175.Nm
176driver
177appeared in
178.Nx 1.6 .
179.Sh BUGS
180Most of the
181.Tn ACPI
182power management functionalities are not implemented.
183