drivers/acpi/Kconfig

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