1# SPDX-License-Identifier: GPL-2.0 2# 3# ACPI Configuration 4# 5 6config ARCH_SUPPORTS_ACPI 7 bool 8 9menuconfig ACPI 10 bool "ACPI (Advanced Configuration and Power Interface) Support" 11 depends on ARCH_SUPPORTS_ACPI 12 select PNP 13 select NLS 14 default y if X86 15 help 16 Advanced Configuration and Power Interface (ACPI) support for 17 Linux requires an ACPI-compliant platform (hardware/firmware), 18 and assumes the presence of OS-directed configuration and power 19 management (OSPM) software. This option will enlarge your 20 kernel by about 70K. 21 22 Linux ACPI provides a robust functional replacement for several 23 legacy configuration and power management interfaces, including 24 the Plug-and-Play BIOS specification (PnP BIOS), the 25 MultiProcessor Specification (MPS), and the Advanced Power 26 Management (APM) specification. If both ACPI and APM support 27 are configured, ACPI is used. 28 29 The project home page for the Linux ACPI subsystem is here: 30 <https://01.org/linux-acpi> 31 32 Linux support for ACPI is based on Intel Corporation's ACPI 33 Component Architecture (ACPI CA). For more information on the 34 ACPI CA, see: 35 <https://acpica.org/> 36 37 ACPI is an open industry specification originally co-developed by 38 Hewlett-Packard, Intel, Microsoft, Phoenix, and Toshiba. Currently, 39 it is developed by the ACPI Specification Working Group (ASWG) under 40 the UEFI Forum and any UEFI member can join the ASWG and contribute 41 to the ACPI specification. 42 The specification is available at: 43 <https://uefi.org/specifications> 44 45if ACPI 46 47config ACPI_LEGACY_TABLES_LOOKUP 48 bool 49 50config ARCH_MIGHT_HAVE_ACPI_PDC 51 bool 52 53config ACPI_GENERIC_GSI 54 bool 55 56config ACPI_SYSTEM_POWER_STATES_SUPPORT 57 bool 58 59config ACPI_CCA_REQUIRED 60 bool 61 62config ACPI_DEBUGGER 63 bool "AML debugger interface" 64 select ACPI_DEBUG 65 help 66 Enable in-kernel debugging of AML facilities: statistics, 67 internal object dump, single step control method execution. 68 This is still under development, currently enabling this only 69 results in the compilation of the ACPICA debugger files. 70 71if ACPI_DEBUGGER 72 73config ACPI_DEBUGGER_USER 74 tristate "Userspace debugger accessiblity" 75 depends on DEBUG_FS 76 help 77 Export /sys/kernel/debug/acpi/acpidbg for userspace utilities 78 to access the debugger functionalities. 79 80endif 81 82config ACPI_SPCR_TABLE 83 bool "ACPI Serial Port Console Redirection Support" 84 default y if X86 85 help 86 Enable support for Serial Port Console Redirection (SPCR) Table. 87 This table provides information about the configuration of the 88 earlycon console. 89 90config ACPI_LPIT 91 bool 92 depends on X86_64 93 default y 94 95config ACPI_SLEEP 96 bool 97 depends on SUSPEND || HIBERNATION 98 depends on ACPI_SYSTEM_POWER_STATES_SUPPORT 99 default y 100 101config ACPI_REV_OVERRIDE_POSSIBLE 102 bool "Allow supported ACPI revision to be overridden" 103 depends on X86 104 default y 105 help 106 The platform firmware on some systems expects Linux to return "5" as 107 the supported ACPI revision which makes it expose system configuration 108 information in a special way. 109 110 For example, based on what ACPI exports as the supported revision, 111 Dell XPS 13 (2015) configures its audio device to either work in HDA 112 mode or in I2S mode, where the former is supposed to be used on Linux 113 until the latter is fully supported (in the kernel as well as in user 114 space). 115 116 This option enables a DMI-based quirk for the above Dell machine (so 117 that HDA audio is exposed by the platform firmware to the kernel) and 118 makes it possible to force the kernel to return "5" as the supported 119 ACPI revision via the "acpi_rev_override" command line switch. 120 121config ACPI_EC_DEBUGFS 122 tristate "EC read/write access through /sys/kernel/debug/ec" 123 help 124 Say N to disable Embedded Controller /sys/kernel/debug interface 125 126 Be aware that using this interface can confuse your Embedded 127 Controller in a way that a normal reboot is not enough. You then 128 have to power off your system, and remove the laptop battery for 129 some seconds. 130 An Embedded Controller typically is available on laptops and reads 131 sensor values like battery state and temperature. 132 The kernel accesses the EC through ACPI parsed code provided by BIOS 133 tables. This option allows to access the EC directly without ACPI 134 code being involved. 135 Thus this option is a debug option that helps to write ACPI drivers 136 and can be used to identify ACPI code or EC firmware bugs. 137 138config ACPI_AC 139 tristate "AC Adapter" 140 select POWER_SUPPLY 141 default y 142 help 143 This driver supports the AC Adapter object, which indicates 144 whether a system is on AC or not. If you have a system that can 145 switch between A/C and battery, say Y. 146 147 To compile this driver as a module, choose M here: 148 the module will be called ac. 149 150config ACPI_BATTERY 151 tristate "Battery" 152 select POWER_SUPPLY 153 default y 154 help 155 This driver adds support for battery information through 156 /proc/acpi/battery. If you have a mobile system with a battery, 157 say Y. 158 159 To compile this driver as a module, choose M here: 160 the module will be called battery. 161 162config ACPI_BUTTON 163 tristate "Button" 164 depends on INPUT 165 default y 166 help 167 This driver handles events on the power, sleep, and lid buttons. 168 A daemon reads events from input devices or via netlink and 169 performs user-defined actions such as shutting down the system. 170 This is necessary for software-controlled poweroff. 171 172 To compile this driver as a module, choose M here: 173 the module will be called button. 174 175config ACPI_TINY_POWER_BUTTON 176 tristate "Tiny Power Button Driver" 177 depends on !ACPI_BUTTON 178 help 179 This driver provides a tiny alternative to the ACPI Button driver. 180 The tiny power button driver only handles the power button. Rather 181 than notifying userspace via the input layer or a netlink event, this 182 driver directly signals the init process to shut down. 183 184 This driver is particularly suitable for cloud and VM environments, 185 which use a simulated power button to initiate a controlled poweroff, 186 but which may not want to run a separate userspace daemon to process 187 input events. 188 189config ACPI_TINY_POWER_BUTTON_SIGNAL 190 int "Tiny Power Button Signal" 191 depends on ACPI_TINY_POWER_BUTTON 192 default 38 193 help 194 Default signal to send to init in response to the power button. 195 196 Likely values here include 38 (SIGRTMIN+4) to power off, or 2 197 (SIGINT) to simulate Ctrl+Alt+Del. 198 199config ACPI_VIDEO 200 tristate "Video" 201 depends on X86 && BACKLIGHT_CLASS_DEVICE 202 depends on INPUT 203 select THERMAL 204 help 205 This driver implements the ACPI Extensions For Display Adapters 206 for integrated graphics devices on motherboard, as specified in 207 ACPI 2.0 Specification, Appendix B. This supports basic operations 208 such as defining the video POST device, retrieving EDID information, 209 and setting up a video output. 210 211 To compile this driver as a module, choose M here: 212 the module will be called video. 213 214config ACPI_FAN 215 tristate "Fan" 216 depends on THERMAL 217 default y 218 help 219 This driver supports ACPI fan devices, allowing user-mode 220 applications to perform basic fan control (on, off, status). 221 222 To compile this driver as a module, choose M here: 223 the module will be called fan. 224 225config ACPI_TAD 226 tristate "ACPI Time and Alarm (TAD) Device Support" 227 depends on SYSFS && PM_SLEEP 228 help 229 The ACPI Time and Alarm (TAD) device is an alternative to the Real 230 Time Clock (RTC). Its wake timers allow the system to transition from 231 the S3 (or optionally S4/S5) state to S0 state after a time period 232 elapses. In comparison with the RTC Alarm, the TAD provides a larger 233 scale of flexibility in the wake timers. The time capabilities of the 234 TAD maintain the time of day information across platform power 235 transitions, and keep track of time even when the platform is turned 236 off. 237 238config ACPI_DOCK 239 bool "Dock" 240 help 241 This driver supports ACPI-controlled docking stations and removable 242 drive bays such as the IBM Ultrabay and the Dell Module Bay. 243 244config ACPI_CPU_FREQ_PSS 245 bool 246 select THERMAL 247 248config ACPI_PROCESSOR_CSTATE 249 def_bool y 250 depends on ACPI_PROCESSOR 251 depends on IA64 || X86 252 253config ACPI_PROCESSOR_IDLE 254 bool 255 select CPU_IDLE 256 257config ACPI_MCFG 258 bool 259 260config ACPI_CPPC_LIB 261 bool 262 depends on ACPI_PROCESSOR 263 select MAILBOX 264 select PCC 265 help 266 If this option is enabled, this file implements common functionality 267 to parse CPPC tables as described in the ACPI 5.1+ spec. The 268 routines implemented are meant to be used by other 269 drivers to control CPU performance using CPPC semantics. 270 If your platform does not support CPPC in firmware, 271 leave this option disabled. 272 273config ACPI_PROCESSOR 274 tristate "Processor" 275 depends on X86 || IA64 || ARM64 276 select ACPI_PROCESSOR_IDLE 277 select ACPI_CPU_FREQ_PSS if X86 || IA64 278 default y 279 help 280 This driver adds support for the ACPI Processor package. It is required 281 by several flavors of cpufreq performance-state, thermal, throttling and 282 idle drivers. 283 284 To compile this driver as a module, choose M here: 285 the module will be called processor. 286 287config ACPI_IPMI 288 tristate "IPMI" 289 depends on IPMI_HANDLER 290 help 291 This driver enables the ACPI to access the BMC controller. And it 292 uses the IPMI request/response message to communicate with BMC 293 controller, which can be found on on the server. 294 295 To compile this driver as a module, choose M here: 296 the module will be called as acpi_ipmi. 297 298config ACPI_HOTPLUG_CPU 299 bool 300 depends on ACPI_PROCESSOR && HOTPLUG_CPU 301 select ACPI_CONTAINER 302 default y 303 304config ACPI_PROCESSOR_AGGREGATOR 305 tristate "Processor Aggregator" 306 depends on ACPI_PROCESSOR 307 depends on X86 308 help 309 ACPI 4.0 defines processor Aggregator, which enables OS to perform 310 specific processor configuration and control that applies to all 311 processors in the platform. Currently only logical processor idling 312 is defined, which is to reduce power consumption. This driver 313 supports the new device. 314 315config ACPI_THERMAL 316 tristate "Thermal Zone" 317 depends on ACPI_PROCESSOR 318 select THERMAL 319 default y 320 help 321 This driver supports ACPI thermal zones. Most mobile and 322 some desktop systems support ACPI thermal zones. It is HIGHLY 323 recommended that this option be enabled, as your processor(s) 324 may be damaged without it. 325 326 To compile this driver as a module, choose M here: 327 the module will be called thermal. 328 329config ACPI_CUSTOM_DSDT_FILE 330 string "Custom DSDT Table file to include" 331 default "" 332 depends on !STANDALONE 333 help 334 This option supports a custom DSDT by linking it into the kernel. 335 See Documentation/admin-guide/acpi/dsdt-override.rst 336 337 Enter the full path name to the file which includes the AmlCode 338 or dsdt_aml_code declaration. 339 340 If unsure, don't enter a file name. 341 342config ACPI_CUSTOM_DSDT 343 bool 344 default ACPI_CUSTOM_DSDT_FILE != "" 345 346config ARCH_HAS_ACPI_TABLE_UPGRADE 347 def_bool n 348 349config ACPI_TABLE_UPGRADE 350 bool "Allow upgrading ACPI tables via initrd" 351 depends on BLK_DEV_INITRD && ARCH_HAS_ACPI_TABLE_UPGRADE 352 default y 353 help 354 This option provides functionality to upgrade arbitrary ACPI tables 355 via initrd. No functional change if no ACPI tables are passed via 356 initrd, therefore it's safe to say Y. 357 See Documentation/admin-guide/acpi/initrd_table_override.rst for details 358 359config ACPI_TABLE_OVERRIDE_VIA_BUILTIN_INITRD 360 bool "Override ACPI tables from built-in initrd" 361 depends on ACPI_TABLE_UPGRADE 362 depends on INITRAMFS_SOURCE!="" && INITRAMFS_COMPRESSION="" 363 help 364 This option provides functionality to override arbitrary ACPI tables 365 from built-in uncompressed initrd. 366 367 See Documentation/admin-guide/acpi/initrd_table_override.rst for details 368 369config ACPI_DEBUG 370 bool "Debug Statements" 371 help 372 The ACPI subsystem can produce debug output. Saying Y enables this 373 output and increases the kernel size by around 50K. 374 375 Use the acpi.debug_layer and acpi.debug_level kernel command-line 376 parameters documented in Documentation/firmware-guide/acpi/debug.rst and 377 Documentation/admin-guide/kernel-parameters.rst to control the type and 378 amount of debug output. 379 380config ACPI_PCI_SLOT 381 bool "PCI slot detection driver" 382 depends on SYSFS && PCI 383 help 384 This driver creates entries in /sys/bus/pci/slots/ for all PCI 385 slots in the system. This can help correlate PCI bus addresses, 386 i.e., segment/bus/device/function tuples, with physical slots in 387 the system. If you are unsure, say N. 388 389config ACPI_CONTAINER 390 bool "Container and Module Devices" 391 default (ACPI_HOTPLUG_MEMORY || ACPI_HOTPLUG_CPU) 392 help 393 This driver supports ACPI Container and Module devices (IDs 394 ACPI0004, PNP0A05, and PNP0A06). 395 396 This helps support hotplug of nodes, CPUs, and memory. 397 398config ACPI_HOTPLUG_MEMORY 399 bool "Memory Hotplug" 400 depends on MEMORY_HOTPLUG 401 help 402 This driver supports ACPI memory hotplug. The driver 403 fields notifications on ACPI memory devices (PNP0C80), 404 which represent memory ranges that may be onlined or 405 offlined during runtime. 406 407 If your hardware and firmware do not support adding or 408 removing memory devices at runtime, you need not enable 409 this driver. 410 411config ACPI_HOTPLUG_IOAPIC 412 bool 413 depends on PCI 414 depends on X86_IO_APIC 415 default y 416 417config ACPI_SBS 418 tristate "Smart Battery System" 419 depends on X86 420 select POWER_SUPPLY 421 help 422 This driver supports the Smart Battery System, another 423 type of access to battery information, found on some laptops. 424 425 To compile this driver as a module, choose M here: 426 the modules will be called sbs and sbshc. 427 428config ACPI_HED 429 tristate "Hardware Error Device" 430 help 431 This driver supports the Hardware Error Device (PNP0C33), 432 which is used to report some hardware errors notified via 433 SCI, mainly the corrected errors. 434 435config ACPI_CUSTOM_METHOD 436 tristate "Allow ACPI methods to be inserted/replaced at run time" 437 depends on DEBUG_FS 438 help 439 This debug facility allows ACPI AML methods to be inserted and/or 440 replaced without rebooting the system. For details refer to: 441 Documentation/firmware-guide/acpi/method-customizing.rst. 442 443 NOTE: This option is security sensitive, because it allows arbitrary 444 kernel memory to be written to by root (uid=0) users, allowing them 445 to bypass certain security measures (e.g. if root is not allowed to 446 load additional kernel modules after boot, this feature may be used 447 to override that restriction). 448 449config ACPI_BGRT 450 bool "Boottime Graphics Resource Table support" 451 depends on EFI && (X86 || ARM64) 452 help 453 This driver adds support for exposing the ACPI Boottime Graphics 454 Resource Table, which allows the operating system to obtain 455 data from the firmware boot splash. It will appear under 456 /sys/firmware/acpi/bgrt/ . 457 458config ACPI_REDUCED_HARDWARE_ONLY 459 bool "Hardware-reduced ACPI support only" if EXPERT 460 def_bool n 461 help 462 This config item changes the way the ACPI code is built. When this 463 option is selected, the kernel will use a specialized version of 464 ACPICA that ONLY supports the ACPI "reduced hardware" mode. The 465 resulting kernel will be smaller but it will also be restricted to 466 running in ACPI reduced hardware mode ONLY. 467 468 If you are unsure what to do, do not enable this option. 469 470source "drivers/acpi/nfit/Kconfig" 471source "drivers/acpi/numa/Kconfig" 472source "drivers/acpi/apei/Kconfig" 473source "drivers/acpi/dptf/Kconfig" 474 475config ACPI_WATCHDOG 476 bool 477 478config ACPI_EXTLOG 479 tristate "Extended Error Log support" 480 depends on X86_MCE && X86_LOCAL_APIC && EDAC 481 select UEFI_CPER 482 help 483 Certain usages such as Predictive Failure Analysis (PFA) require 484 more information about the error than what can be described in 485 processor machine check banks. Most server processors log 486 additional information about the error in processor uncore 487 registers. Since the addresses and layout of these registers vary 488 widely from one processor to another, system software cannot 489 readily make use of them. To complicate matters further, some of 490 the additional error information cannot be constructed without 491 detailed knowledge about platform topology. 492 493 Enhanced MCA Logging allows firmware to provide additional error 494 information to system software, synchronous with MCE or CMCI. This 495 driver adds support for that functionality with corresponding 496 tracepoint which carries that information to userspace. 497 498config ACPI_ADXL 499 bool 500 501config ACPI_CONFIGFS 502 tristate "ACPI configfs support" 503 select CONFIGFS_FS 504 help 505 Select this option to enable support for ACPI configuration from 506 userspace. The configurable ACPI groups will be visible under 507 /config/acpi, assuming configfs is mounted under /config. 508 509if ARM64 510source "drivers/acpi/arm64/Kconfig" 511 512config ACPI_PPTT 513 bool 514endif 515 516source "drivers/acpi/pmic/Kconfig" 517 518endif # ACPI 519 520config X86_PM_TIMER 521 bool "Power Management Timer Support" if EXPERT 522 depends on X86 && (ACPI || JAILHOUSE_GUEST) 523 default y 524 help 525 The Power Management Timer is available on all ACPI-capable, 526 in most cases even if ACPI is unusable or blacklisted. 527 528 This timing source is not affected by power management features 529 like aggressive processor idling, throttling, frequency and/or 530 voltage scaling, unlike the commonly used Time Stamp Counter 531 (TSC) timing source. 532 533 You should nearly always say Y here because many modern 534 systems require this timer. 535