xref: /openbsd-src/share/man/man4/acpi.4 (revision e1eba03ccec1218fb92f6f988c142f38d0321113)
1.\"	$OpenBSD: acpi.4,v 1.76 2024/11/05 11:12:48 miod 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: November 5 2024 $
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 acpicmos 4
56CMOS memory manager
57.It Xr acpicpu 4
58ACPI processor power and performance state
59.It Xr acpidock 4
60ACPI docking station
61.It Xr acpiec 4
62ACPI embedded controller
63.It Xr acpige 4
64ACPI generic event device
65.It Xr acpihid 4
66ACPI HID event and 5-button array
67.It Xr acpihpet 4
68ACPI high precision event timer
69.It Xr acpihve 4
70Hyper-V entropy
71.It Xr acpimadt 4
72ACPI APIC configuration
73.It Xr acpimcfg 4
74ACPI PCI Express configuration space
75.It Xr acpipci 4
76ACPI PCI host bridge
77.It Xr acpiprt 4
78ACPI PCI routing table configuration
79.It Xr acpipwrres 4
80ACPI power resources
81.It Xr acpisbs 4
82ACPI Smart Battery subsystem
83.It Xr acpisony 4
84Sony ACPI control
85.It Xr acpisurface 4
86Microsoft Surface Book ACPI support
87.It Xr acpithinkpad 4
88IBM/Lenovo ThinkPad ACPI support
89.It Xr acpitimer 4
90ACPI power management timer
91.It Xr acpitoshiba 4
92Toshiba ACPI support
93.It Xr acpitz 4
94ACPI thermal zone
95.It Xr acpivideo 4
96ACPI video
97.It Xr acpivout 4
98ACPI video output
99.It Xr ahci 4
100Advanced Host Controller Interface for Serial ATA
101.It Xr aibs 4
102ASUSTeK AI Booster ACPI ATK0110 temperature, voltage, and fan sensor
103.It Xr amdgpio 4
104AMD GPIO controller
105.It Xr ampchwm 4
106Ampere Altra fine-grained power telemetry
107.It Xr aplgpio 4
108Intel Apollo Lake GPIO controller
109.It Xr asmc 4
110Apple System Management Controller (SMC)
111.It Xr bse 4
112Broadcom GENET 10/100/1Gb Ethernet device
113.It Xr bytgpio 4
114Intel Bay Trail GPIO controller
115.It Xr ccp 4
116AMD cryptographic co-processor
117.It Xr chvgpio 4
118Intel Cherry View GPIO controller
119.It Xr dwgpio 4
120Synopsys DesignWare GPIO controller
121.It Xr dwiic 4
122Synopsys DesignWare I2C controller
123.It Xr glkgpio 4
124Intel Gemini Lake GPIO controller
125.It Xr imxiic 4
126i.MX onboard I2C controller
127.It Xr intelpmc 4
128Intel power management controller
129.It Xr iosf 4
130Intel OnChip System Fabric device
131.It Xr ipmi 4
132Intelligent Platform Management Interface driver
133.It Xr pchgpio 4
134Intel PCH GPIO controller
135.It Xr pluart 4
136ARM PrimeCell PL011 UART
137.It Xr qcgpio 4
138Qualcomm Snapdragon GPIO controller
139.It Xr qciic 4
140Qualcomm Snapdragon GENI I2C controller
141.It Xr sdhc 4
142SD Host Controller
143.It Xr tpm 4
144Trusted Platform Module device
145.It Xr ufshci 4
146Universal Flash Storage Host Controller Interface
147.El
148.Sh FILES
149.Bl -tag -width "/dev/apmctlXXX"
150.It /dev/apm
151Power management data device.
152May only be opened read-only.
153May be opened by multiple concurrent users.
154.It /dev/apmctl
155Power management control device.
156May be opened read-write or write-only.
157May only be opened by one user at a time.
158An attempt to open the file when in use will fail, returning
159.Er EBUSY .
160.El
161.Sh SEE ALSO
162.Xr apm 4 ,
163.Xr intro 4
164.Sh HISTORY
165The
166.Nm
167driver first appeared in
168.Ox 3.8 .
169.Sh AUTHORS
170.An -nosplit
171The
172.Nm
173driver was written by
174.An Thorsten Lockert Aq Mt tholo@sigmasoft.com
175and
176.An Jordan Hargrave Aq Mt jordan@openbsd.org .
177