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