xref: /openbsd-src/share/man/man4/acpi.4 (revision 3374c67d44f9b75b98444cbf63020f777792342e)
1.\"	$OpenBSD: acpi.4,v 1.69 2022/09/13 05:49:23 jmc Exp $
2.\"
3.\" Copyright (c) 2006 Alexander Yurchenko <grange@openbsd.org>
4.\"
5.\" Permission to use, copy, modify, and distribute this software for any
6.\" purpose with or without fee is hereby granted, provided that the above
7.\" copyright notice and this permission notice appear in all copies.
8.\"
9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16.\"
17.Dd $Mdocdate: September 13 2022 $
18.Dt ACPI 4
19.Os
20.Sh NAME
21.Nm acpi
22.Nd Advanced Configuration and Power Interface
23.Sh SYNOPSIS
24.Cd "acpi0 at bios?"
25.Sh DESCRIPTION
26The
27.Nm
28driver provides basic support for ACPI including loading ACPI tables from
29the firmware, parsing and interpreting AML code, event handling,
30suspending and powering off, and attaching device drivers.
31Userland may access
32.Nm
33by using the
34.Xr apm 4
35device.
36.Pp
37The following devices can attach to
38.Nm :
39.Pp
40.Bl -tag -width "acpithinkpad(4)XXX" -offset indent -compact
41.It Xr abl 4
42Apple backlight support
43.It Xr acpiac 4
44ACPI AC adapter
45.It Xr acpials 4
46ACPI ambient light sensor
47.It Xr acpiasus 4
48ASUS ACPI hotkeys
49.It Xr acpibat 4
50ACPI control method battery
51.It Xr acpibtn 4
52ACPI button
53.It Xr acpicbkbd 4
54Chromebook keyboard backlight
55.It Xr acpicpu 4
56ACPI processor power and performance state
57.It Xr acpidock 4
58ACPI docking station
59.It Xr acpiec 4
60ACPI embedded controller
61.It Xr acpige 4
62ACPI generic event device
63.It Xr acpihid 4
64ACPI HID event and 5-button array
65.It Xr acpihpet 4
66ACPI high precision event timer
67.It Xr acpihve 4
68Hyper-V entropy
69.It Xr acpimadt 4
70ACPI APIC configuration
71.It Xr acpimcfg 4
72ACPI PCI Express configuration space
73.It Xr acpipci 4
74ACPI PCI host bridge
75.It Xr acpiprt 4
76ACPI PCI routing table configuration
77.It Xr acpipwrres 4
78ACPI power resources
79.It Xr acpisbs 4
80ACPI Smart Battery subsystem
81.It Xr acpisony 4
82Sony ACPI control
83.It Xr acpisurface 4
84Microsoft Surface Book ACPI support
85.It Xr acpithinkpad 4
86IBM/Lenovo ThinkPad ACPI support
87.It Xr acpitimer 4
88ACPI power management timer
89.It Xr acpitoshiba 4
90Toshiba ACPI support
91.It Xr acpitz 4
92ACPI thermal zone
93.It Xr acpivideo 4
94ACPI video
95.It Xr acpivout 4
96ACPI video output
97.It Xr aibs 4
98ASUSTeK AI Booster ACPI ATK0110 temperature, voltage, and fan sensor
99.It Xr amdgpio 4
100AMD GPIO controller
101.It Xr aplgpio 4
102Intel Apollo Lake GPIO controller
103.It Xr bse 4
104Broadcom GENET 10/100/1Gb Ethernet device
105.It Xr bytgpio 4
106Intel Bay Trail GPIO controller
107.It Xr ccp 4
108AMD cryptographic co-processor
109.It Xr chvgpio 4
110Intel Cherry View GPIO controller
111.It Xr dwgpio 4
112Synopsys DesignWare GPIO controller
113.It Xr dwiic 4
114Synopsys DesignWare I2C controller
115.It Xr glkgpio 4
116Intel Gemini Lake GPIO controller
117.It Xr imxiic 4
118i.MX onboard I2C controller
119.It Xr pchgpio 4
120Intel PCH GPIO controller
121.It Xr qcgpio 4
122Qualcomm Snapdragon GPIO controller
123.It Xr qciic 4
124Qualcomm Snapdragon GENI I2C controller
125.It Xr tpm 4
126Trusted Platform Module device
127.El
128.Sh FILES
129.Bl -tag -width "/dev/apmctlXXX"
130.It /dev/apm
131Power management data device.
132May only be opened read-only.
133May be opened by multiple concurrent users.
134.It /dev/apmctl
135Power management control device.
136May be opened read-write or write-only.
137May only be opened by one user at a time.
138An attempt to open the file when in use will fail, returning
139.Er EBUSY .
140.El
141.Sh SEE ALSO
142.Xr apm 4 ,
143.Xr intro 4
144.Sh HISTORY
145The
146.Nm
147driver first appeared in
148.Ox 3.8 .
149.Sh AUTHORS
150.An -nosplit
151The
152.Nm
153driver was written by
154.An Thorsten Lockert Aq Mt tholo@sigmasoft.com
155and
156.An Jordan Hargrave Aq Mt jordan@openbsd.org .
157