Advanced Configuration and Power Interface
In computing, the Advanced Configuration and Power Interface (ACPI) specification provides an open standard that operating systems can use to perform discovery and configuration of computer hardware components, to perform power management by, for example, putting unused components to sleep, and to do status monitoring. Internally, ACPI advertises the available components and their functions to the operating system kernel using instruction lists ("methods") provided through the system firmware (UEFI or BIOS), which the kernel parses; and then executes the desired operations (such as the initialization of hardware components) using an embedded minimal virtual machine.
First released in December 1996, ACPI defines platform-independent interfaces for hardware discovery, configuration, power management, and monitoring, and is designed to replace Advanced Power Management (APM), the MultiProcessor Specification, and the Plug and Play BIOS (PnP) Specification. ACPI brings the power management under the control of the operating system, as opposed to the previous BIOS-centric system that relied on platform-specific firmware to determine power management and configuration policies. The specification is central to Operating System-directed configuration and Power Management (OSPM), a system implementing ACPI which removes device management responsibilities from legacy firmware interfaces.
Intel, Microsoft and Toshiba originally developed the standard, while HP and Phoenix also participated later. In October 2013, the original developers of the ACPI standard agreed to transfer all assets to the UEFI Forum, in which all future development will take place. The latest version of the standard is "Revision 6.1", which was published by the UEFI Forum in March 2016.
The firmware-level ACPI has three main components: the ACPI tables, the ACPI BIOS, and the ACPI registers. Unlike its predecessors, such as the APM or PnP BIOS, the ACPI implements little of its functionality in the ACPI BIOS code, whose main role is to load the ACPI tables in system memory. Instead, most of the firmware ACPI functionality is provided in ACPI Machine Language (AML) bytecode stored in the ACPI tables. To make use of these tables, the operating system must have an interpreter for the AML bytecode. A reference AML interpreter implementation is provided by the ACPI Component Architecture (ACPICA). At the BIOS development time, AML code is compiled from the ASL (ACPI Source Language) code.
As ACPI also replaces PnP BIOS, it also provides a hardware enumerator, mostly implemented in the Differentiated System Description Table (DSDT) ACPI table. The advantage of a bytecode approach is that unlike PnP BIOS code (which was 16-bit), the ACPI bytecode may be used in any operating system, even in 64-bit long mode.
Overall design decision was not without criticism. In November 2003, Linus Torvalds—author of the Linux kernel—described ACPI as "a complete design disaster in every way". In 2001, other senior Linux software developers like Alan Cox expressed concerns about the requirements that bytecode from an external source must be run by the kernel with full privileges, as well as the overall complexity of the ACPI specification. In 2014, Mark Shuttleworth, founder of the Ubuntu Linux distribution, compared ACPI with Trojan horses.
ACPI Component Architecture (ACPICA)
The ACPI Component Architecture (ACPICA), mainly written by Intel's engineers, provides an open-source platform-independent reference implementation of the operating system–related ACPI code. The ACPICA code is used by Linux, Haiku and FreeBSD, which supplement it with their operating-system specific code.
The first revision of the ACPI specification was released in December 1996, supporting 16 and 32-bit addressing spaces. It was not until August 2000 that ACPI received 64-bit address support as well as support for multiprocessor workstations and servers with revision 2.0.
In September 2004, revision 3.0 was released, bringing to the ACPI specification support for SATA controllers, PCI Express bus, multiprocessor support for more than 256 processors, ambient light sensors and user-presence devices, as well as extending the thermal model beyond the previous processor-centric support.
Microsoft's Windows 98 was the first operating system to implement ACPI, but its implementation was somewhat buggy or incomplete, although some of the problems associated with it were caused by the first-generation ACPI hardware. Windows 98 first edition disabled ACPI by default except on a whitelist of systems. Other operating systems, including later versions of Windows, eComStation, FreeBSD, NetBSD, OpenBSD, HP-UX, OpenVMS, Linux, and PC versions of Solaris, have at least some support for ACPI. Some newer operating systems like Windows Vista require ACPI-compliant BIOS to work at all
The 2.4 series of the Linux kernel had only minimal support for ACPI, with better support implemented (and enabled by default) from kernel version 2.6.0 onwards. Old ACPI BIOS implementations tend to be quite buggy, and consequently are not supported by later operating systems. For example, Windows 2000, Windows XP, and Windows Server 2003 only use ACPI if the BIOS date is after January 1, 1999, and for Windows 98 Second Edition this date is December 1, 1999. Similarly, Linux kernel 2.6 blacklisted any ACPI BIOS from before January 1, 2001.
Once an OSPM-compatible operating system activates ACPI, it takes exclusive control of all aspects of power management and device configuration. The OSPM implementation must expose an ACPI-compatible environment to device drivers, which exposes certain system, device and processor states.
- G0 (S0), Working: The computer is running and the CPU executes instructions. "Awaymode" is a subset of S0, where monitor is off but background tasks are running.
- G1, Sleeping: Divided into four states, S1 through S4:
- S1, Power on Suspend (POS): Processor caches are flushed, and the CPU(s) stops executing instructions. The power to the CPU(s) and RAM is maintained. Devices that do not indicate they must remain on may be powered off.
- S2: CPU powered off. Dirty cache is flushed to RAM.
- S3, commonly referred to as Standby, Sleep, or Suspend to RAM (STR): RAM remains powered.
- S4, Hibernation or Suspend to Disk: All content of the main memory is saved to non-volatile memory such as a hard drive, and the system is powered down.
- G2 (S5), Soft Off: G2/S5 is almost the same as G3 Mechanical Off, except that the power supply unit (PSU) still supplies power, at a minimum, to the power button to allow return to S0. A full reboot is required. No previous content is retained. Other components may remain powered so the computer can "wake" on input from the keyboard, clock, modem, LAN, or USB device.
- G3, Mechanical Off: The computer's power has been totally removed via a mechanical switch (as on the rear of a PSU). The power cord can be removed and the system is safe for disassembly (typically, only the real-time clock continues to run using its own small battery).
The specification also defines a Legacy state: the state on an operating system which does not support ACPI. In this state, the hardware and power are not managed via ACPI, effectively disabling ACPI.
The device states D0–D3 are device dependent:
- D0 or Fully On is the operating state.
- D1 and D2 are intermediate power-states whose definition varies by device.
- D3: The D3 state is further divided into D3 Hot (has aux power), and D3 Cold (no power provided):
- Hot: A device can assert power management requests to transition to higher power states.
- Cold or Off has the device powered off and unresponsive to its bus.
The CPU power states C0–C3 are defined as follows:
- C0 is the operating state.
- C1 (often known as Halt) is a state where the processor is not executing instructions, but can return to an executing state essentially instantaneously. All ACPI-conformant processors must support this power state. Some processors, such as the Pentium 4, also support an Enhanced C1 state (C1E or Enhanced Halt State) for lower power consumption.
- C2 (often known as Stop-Clock) is a state where the processor maintains all software-visible state, but may take longer to wake up. This processor state is optional.
- C3 (often known as Sleep) is a state where the processor does not need to keep its cache coherent, but maintains other state. Some processors have variations on the C3 state (Deep Sleep, Deeper Sleep, etc.) that differ in how long it takes to wake the processor. This processor state is optional.
- Additional states are defined by manufacturers for some processors. For example, Intel's Haswell platform has states up to C10, where it distinguishes core states and package states.
While a device or processor operates (D0 and C0, respectively), it can be in one of several power-performance states. These states are implementation-dependent. Though, P0 is always the highest-performance state; with P1 to Pn being successively lower-performance states, up to an implementation-specific limit of n no greater than 16.
- P0 max power and frequency
- P1 less than P0, voltage and frequency scaled
- P2 less than P1, voltage and frequency scaled
- Pn less than P(n-1), voltage and frequency scaled
ACPI-compliant systems interact with hardware through either a "Function Fixed Hardware (FFH) Interface", or a platform-independent hardware programming model which relies on platform-specific ACPI Machine Language (AML) provided by the original equipment manufacturer (OEM).
Function Fixed Hardware interfaces are platform-specific features, provided by platform manufacturers for the purposes of performance and failure recovery. Standard Intel-based PCs have a fixed function interface defined by Intel, which provides a set of core functionality that reduces an ACPI-compliant system's need for full driver stacks for providing basic functionality during boot time or in the case of major system failure.
ACPI Platform Error Interface (APEI) is a specification for reporting of hardware errors, e.g. from the chipset, to the operating system.
ACPI defines many tables that provide the interface between an ACPI-compliant operating system, and system firmware. This includes Differentiated System Description Table (DSDT), Secondary System Description Table (SSDT), and Static Resource Affinity Table (SRAT), for example.
The tables allow description of system hardware in a platform-independent manner, and are presented as either fixed-formatted data structures or in AML. The main AML table is the DSDT (differentiated system description table).
The Root System Description Pointer is located in a platform-dependent manner, and describes the rest of the tables.
Ubuntu Linux founder Mark Shuttleworth has likened ACPI to Trojan horses. He has described proprietary firmware (ACPI-related or any other firmware) as a security risk, saying that "firmware on your device is the NSA's best friend" and calling firmware (ACPI or non-ACPI) "a Trojan horse of monumental proportions". He has pointed out that low quality, closed source firmware is a major threat to system security: "Your biggest mistake is to assume that the NSA is the only institution abusing this position of trust — in fact, it's reasonable to assume that all firmware is a cesspool of insecurity, courtesy of incompetence of the highest degree from manufacturers, and competence of the highest degree from a very wide range of such agencies".
As a solution to this problem, he has called for declarative firmware (ACPI or non-ACPI). Firmware should be open-source so that the code can be checked and verified. Firmware should be declarative, meaning that it should describe "hardware linkage and dependencies" and should not include executable code.
- ACPI Overview
- "APM BIOS Specification" (RTF). Intel Corporation, Microsoft Corporation. February 1996. Retrieved 2010-07-02.
- "The Advanced Configuration & Power Interface web page has a prominent note that links to the Preexisting ACPI Specifications page on the UEFI web site". acpi.org. July 23, 2014. Retrieved 2016-01-25.
- "Advanced Configuration and Power Interface Specification, Version 6.1" (PDF). UEFI.org. March 2016. Retrieved 2016-07-31.
- ACPI implementation on FreeBSD - Usenix
- ACPI in Linux, 2005
- Linux Magazine issue 162, May 2014, page 9
- Searls, Doc (2003-11-25). "Linus & the Lunatics, Part II". Linux Journal. Retrieved 2010-01-13.
- Corbet, Jonathan (2001-07-04). "Kernel Development". LWN.net weekly edition. LWN.net. Retrieved 2010-07-02.
- Linux Format n°184, June 2014, page 7.
- ACPICA: ACPI Component Architecture
- Hewlett-Packard; Intel Corporation; Microsoft; Phoenix Technologies; Toshiba (2011-12-06). "Advanced Configuration and Power Interface Specification (Revision 5.0)" (PDF). acpi.info. Retrieved 2013-11-17.
- "Advanced Configuration and Power Interface Specification (Revision 5.1)" (PDF). uefi.org. 2014-07-23. Retrieved 2015-05-24.
- "Limitations When Using Microsoft Windows 98 on Compaq Armada Portables" (PDF). physik.hu-berlin.de. October 1998. p. 3. Retrieved 2014-01-27.
- "Windows 98 on ThinkPad systems - ThinkPad General". Support.lenovo.com. Retrieved 2014-01-27.
- Robert Cowart; Brian Knittel (2000). Using Microsoft Windows 2000 Professional. Que Publishing. p. 30. ISBN 978-0-7897-2125-9.
- Windows 98 Does Not Support ACPI Passive Cooling Mode
- Therien, Guy (2000-01-06). "ACPI 2.0 Specification Technical Review, Intel Developer Forum" (PPT). Intel Corporation. Archived from the original on July 21, 2011. Retrieved 2011-08-21.
- Marshall, Allen. "ACPI in Windows Vista" (PPT). Microsoft Corporation. Retrieved 2010-07-02.
- The State of ACPI in the Linux Kernel
- ACPI BIOS
- ACPI Spec Rev 5.0 - dated December 6, 2011
- Anand Lal Shimpi (2012-10-05). "Intel's Haswell Architecture Analyzed". AnandTech. Retrieved 2013-10-20.
- Wasson, Scott (2005-02-21). "Intel's Pentium 4 600 series processors". The Tech Report. p. 2.
- "Processor Package and Core C-States". AnandTech. 2013-06-09. Retrieved 2013-10-20.
- "Advanced Configuration and Power Interface Specification, Revision 3.0, Section 2.6 Device and Processor Performance State Definitions" (PDF). ACPI.info. 2004-09-02. p. 23. Retrieved 2015-08-19.
- Intel Corporation (September 2006). "Intel Processor Vendor-Specific ACPI" (PDF). Archived from the original (PDF) on 2012-12-25. Retrieved 2014-10-05.
- Brown, Len (2005-07-20). "ACPI in Linux". Ottawa Linux Symposium: 3. CiteSeerX 10.1.1.173.2206.
- Mark Shuttleworth blog (2014-03-17), ACPI, firmware and your security
- Official website (ACPI specifications)
- Intel's ACPI Component Architecture
- How Linux Suspend and Resume works in the ACPI age
- Implementing ACPI 5 Features (Linux Foundation Collaboration Summit 2013)
- Using and Debugging FreeBSD ACPI, archived from the original on March 3, 2012
- Everything You Need to Know About the CPU C-States Power Saving Modes
- Sample ASL code (in the *.dsl files) from the SeaBIOS project
- Sample EFI ASL code used by VirtualBox; EFI/ASL code itself is from the open source Intel EFI Development Kit II (TianoCore)