xref: /openbsd/share/man/man4/acpi.4 (revision 9e6efb0a)
1.\"	$OpenBSD: acpi.4,v 1.74 2024/04/09 20:18:37 mglocker 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: April 9 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 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 ahci 4
98Advanced Host Controller Interface for Serial ATA
99.It Xr aibs 4
100ASUSTeK AI Booster ACPI ATK0110 temperature, voltage, and fan sensor
101.It Xr amdgpio 4
102AMD GPIO controller
103.It Xr ampchwm 4
104Ampere Altra fine-grained power telemetry
105.It Xr aplgpio 4
106Intel Apollo Lake GPIO controller
107.It Xr asmc 4
108Apple System Management Controller (SMC)
109.It Xr bse 4
110Broadcom GENET 10/100/1Gb Ethernet device
111.It Xr bytgpio 4
112Intel Bay Trail GPIO controller
113.It Xr ccp 4
114AMD cryptographic co-processor
115.It Xr chvgpio 4
116Intel Cherry View GPIO controller
117.It Xr dwgpio 4
118Synopsys DesignWare GPIO controller
119.It Xr dwiic 4
120Synopsys DesignWare I2C controller
121.It Xr glkgpio 4
122Intel Gemini Lake GPIO controller
123.It Xr imxiic 4
124i.MX onboard I2C controller
125.It Xr iosf 4
126Intel OnChip System Fabric device
127.It Xr ipmi 4
128Intelligent Platform Management Interface driver
129.It Xr pchgpio 4
130Intel PCH GPIO controller
131.It Xr pluart 4
132ARM PrimeCell PL011 UART
133.It Xr qcgpio 4
134Qualcomm Snapdragon GPIO controller
135.It Xr qciic 4
136Qualcomm Snapdragon GENI I2C controller
137.It Xr sdhc 4
138SD Host Controller
139.It Xr tpm 4
140Trusted Platform Module device
141.It Xr ufshci 4
142Universal Flash Storage Host Controller Interface
143.El
144.Sh FILES
145.Bl -tag -width "/dev/apmctlXXX"
146.It /dev/apm
147Power management data device.
148May only be opened read-only.
149May be opened by multiple concurrent users.
150.It /dev/apmctl
151Power management control device.
152May be opened read-write or write-only.
153May only be opened by one user at a time.
154An attempt to open the file when in use will fail, returning
155.Er EBUSY .
156.El
157.Sh SEE ALSO
158.Xr apm 4 ,
159.Xr intro 4
160.Sh HISTORY
161The
162.Nm
163driver first appeared in
164.Ox 3.8 .
165.Sh AUTHORS
166.An -nosplit
167The
168.Nm
169driver was written by
170.An Thorsten Lockert Aq Mt tholo@sigmasoft.com
171and
172.An Jordan Hargrave Aq Mt jordan@openbsd.org .
173