xref: /netbsd-src/share/man/man4/acpi.4 (revision e5548b402ae4c44fb816de42c7bba9581ce23ef5)
1.\" $NetBSD: acpi.4,v 1.18 2005/12/06 17:23:21 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 December 4, 2005
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.Sh DESCRIPTION
66.Nx
67provides machine-independent bus support for
68.Tn ACPI
69devices and includes several
70.Tn ACPI
71device drivers.
72.Pp
73The
74.Nx
75implementation of
76.Tn ACPI
77integrates Intel's ACPI Component Architecture
78(aka ACPI-CA) for the OS-independent part.
79The ACPI-CA provides
80OS-neutral ACPI functionalities such as ACPI BIOS table support,
81an ACPI event framework and an AML (ACPI Machine Language) interpreter.
82.Pp
83Options:
84.Bl -tag -width ACPI_ACTIVATE_DEV -offset 3n
85.It Nm ACPI_DEBUG
86Enable ACPI debugging message outputs.
87.It Nm ACPI_ACTIVATE_DEV
88Determine if the ACPI driver should attempt to activate
89inactive devices.
90The default is off.
91.It Nm ACPICA_PEDANTIC
92Force strict conformance to the ACPI specification in the
93ACPI-CA.
94Do not enable this option unless you are debugging.
95.El
96.Sh SUPPORTED DEVICES
97.Nx
98.Tn ACPI
99supports several machine-dependent and machine-independent devices:
100.Ss machine-independent devices
101.Bl -tag -width pcdisplay -offset indent
102.It acpiacad
103.Tn ACPI
104AC adapters.
105.It acpibat
106.Tn ACPI
107Control Method Batteries.
108.It acpibut
109.Tn ACPI
110power and sleep buttons.
111.It acpiec
112.Tn ACPI
113Embedded Controllers.
114.It acpilid
115.Tn ACPI
116lid switches.
117.It acpitz
118.Tn ACPI
119thermal zones.
120.It attimer
121AT Timer.
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 pcppi
133AT-style speaker sound.
134.It wss
135Windows Sound System-compatible sound cards based on the AD1848 and compatible chips.
136.El
137.Ss i386-dependent devices
138.Bl -tag -width pcdisplay -offset indent
139.It npx
140i386 numeric processing extension coprocessor.
141.It pckbc
142PC keyboard controllers.
143.It spic
144Sony programmable I/O controller.
145.It vald
146Toshiba Libretto device.
147.El
148.Sh SEE ALSO
149.Xr acpiacad 4 ,
150.Xr acpibat 4 ,
151.Xr acpibut 4 ,
152.Xr acpiec 4 ,
153.Xr acpilid 4 ,
154.Xr acpitz 4 ,
155.Xr apm 4 ,
156.Xr attimer 4 ,
157.Xr com 4 ,
158.Xr fdc 4 ,
159.Xr joy 4 ,
160.Xr lpt 4 ,
161.Xr mpu 4 ,
162.Xr npx 4 ,
163.Xr pci 4 ,
164.Xr pckbc 4 ,
165.Xr pcppi 4 ,
166.Xr spic 4 ,
167.Xr vald 4 ,
168.Xr wss 4
169.Rs
170.%T ACPI specification
171.%O http://www.acpi.info/
172.Re
173.Rs
174.%T Intel ACPI CA (Component Architecture)
175.%O http://developer.intel.com/technology/iapc/acpi/
176.Re
177.Sh HISTORY
178The
179.Nm
180driver
181appeared in
182.Nx 1.6 .
183.Sh BUGS
184Most of the
185.Tn ACPI
186power management functionalities are not implemented.
187