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         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         select POWER_SUPPLY
 159         default y
 160         help
 161           This driver supports the AC Adapter object, which indicates
 162           whether a system is on AC or not.  If you have a system that can
 163           switch between A/C and battery, say Y.
 164
 165           To compile this driver as a module, choose M here:
 166           the module will be called ac.
 167
 168 config ACPI_BATTERY
 169         tristate "Battery"
 170         select POWER_SUPPLY
 171         default y
 172         help
 173           This driver adds support for battery information through
 174           /proc/acpi/battery. If you have a mobile system with a battery,
 175           say Y.
 176
 177           To compile this driver as a module, choose M here:
 178           the module will be called battery.
 179
 180 config ACPI_BUTTON
 181         tristate "Button"
 182         depends on INPUT
 183         default y
 184         help
 185           This driver handles events on the power, sleep, and lid buttons.
 186           A daemon reads events from input devices or via netlink and
 187           performs user-defined actions such as shutting down the system.
 188           This is necessary for software-controlled poweroff.
 189
 190           To compile this driver as a module, choose M here:
 191           the module will be called button.
 192
 193 config ACPI_TINY_POWER_BUTTON
 194         tristate "Tiny Power Button Driver"
 195         depends on !ACPI_BUTTON
 196         help
 197           This driver provides a tiny alternative to the ACPI Button driver.
 198           The tiny power button driver only handles the power button. Rather
 199           than notifying userspace via the input layer or a netlink event, this
 200           driver directly signals the init process to shut down.
 201
 202           This driver is particularly suitable for cloud and VM environments,
 203           which use a simulated power button to initiate a controlled poweroff,
 204           but which may not want to run a separate userspace daemon to process
 205           input events.
 206
 207 config ACPI_TINY_POWER_BUTTON_SIGNAL
 208         int "Tiny Power Button Signal"
 209         depends on ACPI_TINY_POWER_BUTTON
 210         default 38
 211         help
 212           Default signal to send to init in response to the power button.
 213
 214           Likely values here include 38 (SIGRTMIN+4) to power off, or 2
 215           (SIGINT) to simulate Ctrl+Alt+Del.
 216
 217 config ACPI_VIDEO
 218         tristate "Video"
 219         depends on X86 && BACKLIGHT_CLASS_DEVICE
 220         depends on INPUT
 221         select THERMAL
 222         help
 223           This driver implements the ACPI Extensions For Display Adapters
 224           for integrated graphics devices on motherboard, as specified in
 225           ACPI 2.0 Specification, Appendix B.  This supports basic operations
 226           such as defining the video POST device, retrieving EDID information,
 227           and setting up a video output.
 228
 229           To compile this driver as a module, choose M here:
 230           the module will be called video.
 231
 232 config ACPI_FAN
 233         tristate "Fan"
 234         depends on THERMAL
 235         default y
 236         help
 237           This driver supports ACPI fan devices, allowing user-mode
 238           applications to perform basic fan control (on, off, status).
 239
 240           To compile this driver as a module, choose M here:
 241           the module will be called fan.
 242
 243 config ACPI_TAD
 244         tristate "ACPI Time and Alarm (TAD) Device Support"
 245         depends on SYSFS && PM_SLEEP
 246         help
 247           The ACPI Time and Alarm (TAD) device is an alternative to the Real
 248           Time Clock (RTC).  Its wake timers allow the system to transition from
 249           the S3 (or optionally S4/S5) state to S0 state after a time period
 250           elapses.  In comparison with the RTC Alarm, the TAD provides a larger
 251           scale of flexibility in the wake timers.  The time capabilities of the
 252           TAD maintain the time of day information across platform power
 253           transitions, and keep track of time even when the platform is turned
 254           off.
 255
 256 config ACPI_DOCK
 257         bool "Dock"
 258         help
 259           This driver supports ACPI-controlled docking stations and removable
 260           drive bays such as the IBM Ultrabay and the Dell Module Bay.
 261
 262 config ACPI_CPU_FREQ_PSS
 263         bool
 264         select THERMAL
 265
 266 config ACPI_PROCESSOR_CSTATE
 267         def_bool y
 268         depends on ACPI_PROCESSOR
 269         depends on IA64 || X86
 270
 271 config ACPI_PROCESSOR_IDLE
 272         bool
 273         select CPU_IDLE
 274
 275 config ACPI_MCFG
 276         bool
 277
 278 config ACPI_CPPC_LIB
 279         bool
 280         depends on ACPI_PROCESSOR
 281         select MAILBOX
 282         select PCC
 283         help
 284           If this option is enabled, this file implements common functionality
 285           to parse CPPC tables as described in the ACPI 5.1+ spec. The
 286           routines implemented are meant to be used by other
 287           drivers to control CPU performance using CPPC semantics.
 288           If your platform does not support CPPC in firmware,
 289           leave this option disabled.
 290
 291 config ACPI_PROCESSOR
 292         tristate "Processor"
 293         depends on X86 || IA64 || ARM64
 294         select ACPI_PROCESSOR_IDLE
 295         select ACPI_CPU_FREQ_PSS if X86 || IA64
 296         default y
 297         help
 298           This driver adds support for the ACPI Processor package. It is required
 299           by several flavors of cpufreq performance-state, thermal, throttling and
 300           idle drivers.
 301
 302           To compile this driver as a module, choose M here:
 303           the module will be called processor.
 304
 305 config ACPI_IPMI
 306         tristate "IPMI"
 307         depends on IPMI_HANDLER
 308         help
 309           This driver enables the ACPI to access the BMC controller. And it
 310           uses the IPMI request/response message to communicate with BMC
 311           controller, which can be found on on the server.
 312
 313           To compile this driver as a module, choose M here:
 314           the module will be called as acpi_ipmi.
 315
 316 config ACPI_HOTPLUG_CPU
 317         bool
 318         depends on ACPI_PROCESSOR && HOTPLUG_CPU
 319         select ACPI_CONTAINER
 320         default y
 321
 322 config ACPI_PROCESSOR_AGGREGATOR
 323         tristate "Processor Aggregator"
 324         depends on ACPI_PROCESSOR
 325         depends on X86
 326         help
 327           ACPI 4.0 defines processor Aggregator, which enables OS to perform
 328           specific processor configuration and control that applies to all
 329           processors in the platform. Currently only logical processor idling
 330           is defined, which is to reduce power consumption. This driver
 331           supports the new device.
 332
 333 config ACPI_THERMAL
 334         tristate "Thermal Zone"
 335         depends on ACPI_PROCESSOR
 336         select THERMAL
 337         default y
 338         help
 339           This driver supports ACPI thermal zones.  Most mobile and
 340           some desktop systems support ACPI thermal zones.  It is HIGHLY
 341           recommended that this option be enabled, as your processor(s)
 342           may be damaged without it.
 343
 344           To compile this driver as a module, choose M here:
 345           the module will be called thermal.
 346
 347 config ACPI_CUSTOM_DSDT_FILE
 348         string "Custom DSDT Table file to include"
 349         default ""
 350         depends on !STANDALONE
 351         help
 352           This option supports a custom DSDT by linking it into the kernel.
 353           See Documentation/admin-guide/acpi/dsdt-override.rst
 354
 355           Enter the full path name to the file which includes the AmlCode
 356           or dsdt_aml_code declaration.
 357
 358           If unsure, don't enter a file name.
 359
 360 config ACPI_CUSTOM_DSDT
 361         bool
 362         default ACPI_CUSTOM_DSDT_FILE != ""
 363
 364 config ARCH_HAS_ACPI_TABLE_UPGRADE
 365         def_bool n
 366
 367 config ACPI_TABLE_UPGRADE
 368         bool "Allow upgrading ACPI tables via initrd"
 369         depends on BLK_DEV_INITRD && ARCH_HAS_ACPI_TABLE_UPGRADE
 370         default y
 371         help
 372           This option provides functionality to upgrade arbitrary ACPI tables
 373           via initrd. No functional change if no ACPI tables are passed via
 374           initrd, therefore it's safe to say Y.
 375           See Documentation/admin-guide/acpi/initrd_table_override.rst for details
 376
 377 config ACPI_TABLE_OVERRIDE_VIA_BUILTIN_INITRD
 378         bool "Override ACPI tables from built-in initrd"
 379         depends on ACPI_TABLE_UPGRADE
 380         depends on INITRAMFS_SOURCE!="" && INITRAMFS_COMPRESSION=""
 381         help
 382           This option provides functionality to override arbitrary ACPI tables
 383           from built-in uncompressed initrd.
 384
 385           See Documentation/admin-guide/acpi/initrd_table_override.rst for details
 386
 387 config ACPI_DEBUG
 388         bool "Debug Statements"
 389         help
 390           The ACPI subsystem can produce debug output.  Saying Y enables this
 391           output and increases the kernel size by around 50K.
 392
 393           Use the acpi.debug_layer and acpi.debug_level kernel command-line
 394           parameters documented in Documentation/firmware-guide/acpi/debug.rst and
 395           Documentation/admin-guide/kernel-parameters.rst to control the type and
 396           amount of debug output.
 397
 398 config ACPI_PCI_SLOT
 399         bool "PCI slot detection driver"
 400         depends on SYSFS && PCI
 401         help
 402           This driver creates entries in /sys/bus/pci/slots/ for all PCI
 403           slots in the system.  This can help correlate PCI bus addresses,
 404           i.e., segment/bus/device/function tuples, with physical slots in
 405           the system.  If you are unsure, say N.
 406
 407 config ACPI_CONTAINER
 408         bool "Container and Module Devices"
 409         default (ACPI_HOTPLUG_MEMORY || ACPI_HOTPLUG_CPU)
 410         help
 411           This driver supports ACPI Container and Module devices (IDs
 412           ACPI0004, PNP0A05, and PNP0A06).
 413
 414           This helps support hotplug of nodes, CPUs, and memory.
 415
 416           To compile this driver as a module, choose M here:
 417           the module will be called container.
 418
 419 config ACPI_HOTPLUG_MEMORY
 420         bool "Memory Hotplug"
 421         depends on MEMORY_HOTPLUG
 422         help
 423           This driver supports ACPI memory hotplug.  The driver
 424           fields notifications on ACPI memory devices (PNP0C80),
 425           which represent memory ranges that may be onlined or
 426           offlined during runtime.
 427
 428           If your hardware and firmware do not support adding or
 429           removing memory devices at runtime, you need not enable
 430           this driver.
 431
 432           To compile this driver as a module, choose M here:
 433           the module will be called acpi_memhotplug.
 434
 435 config ACPI_HOTPLUG_IOAPIC
 436         bool
 437         depends on PCI
 438         depends on X86_IO_APIC
 439         default y
 440
 441 config ACPI_SBS
 442         tristate "Smart Battery System"
 443         depends on X86
 444         select POWER_SUPPLY
 445         help
 446           This driver supports the Smart Battery System, another
 447           type of access to battery information, found on some laptops.
 448
 449           To compile this driver as a module, choose M here:
 450           the modules will be called sbs and sbshc.
 451
 452 config ACPI_HED
 453         tristate "Hardware Error Device"
 454         help
 455           This driver supports the Hardware Error Device (PNP0C33),
 456           which is used to report some hardware errors notified via
 457           SCI, mainly the corrected errors.
 458
 459 config ACPI_CUSTOM_METHOD
 460         tristate "Allow ACPI methods to be inserted/replaced at run time"
 461         depends on DEBUG_FS
 462         help
 463           This debug facility allows ACPI AML methods to be inserted and/or
 464           replaced without rebooting the system. For details refer to:
 465           Documentation/firmware-guide/acpi/method-customizing.rst.
 466
 467           NOTE: This option is security sensitive, because it allows arbitrary
 468           kernel memory to be written to by root (uid=0) users, allowing them
 469           to bypass certain security measures (e.g. if root is not allowed to
 470           load additional kernel modules after boot, this feature may be used
 471           to override that restriction).
 472
 473 config ACPI_BGRT
 474         bool "Boottime Graphics Resource Table support"
 475         depends on EFI && (X86 || ARM64)
 476         help
 477           This driver adds support for exposing the ACPI Boottime Graphics
 478           Resource Table, which allows the operating system to obtain
 479           data from the firmware boot splash. It will appear under
 480           /sys/firmware/acpi/bgrt/ .
 481
 482 config ACPI_REDUCED_HARDWARE_ONLY
 483         bool "Hardware-reduced ACPI support only" if EXPERT
 484         def_bool n
 485         help
 486           This config item changes the way the ACPI code is built.  When this
 487           option is selected, the kernel will use a specialized version of
 488           ACPICA that ONLY supports the ACPI "reduced hardware" mode.  The
 489           resulting kernel will be smaller but it will also be restricted to
 490           running in ACPI reduced hardware mode ONLY.
 491
 492           If you are unsure what to do, do not enable this option.
 493
 494 source "drivers/acpi/nfit/Kconfig"
 495 source "drivers/acpi/numa/Kconfig"
 496 source "drivers/acpi/apei/Kconfig"
 497 source "drivers/acpi/dptf/Kconfig"
 498
 499 config ACPI_WATCHDOG
 500         bool
 501
 502 config ACPI_EXTLOG
 503         tristate "Extended Error Log support"
 504         depends on X86_MCE && X86_LOCAL_APIC && EDAC
 505         select UEFI_CPER
 506         help
 507           Certain usages such as Predictive Failure Analysis (PFA) require
 508           more information about the error than what can be described in
 509           processor machine check banks. Most server processors log
 510           additional information about the error in processor uncore
 511           registers. Since the addresses and layout of these registers vary
 512           widely from one processor to another, system software cannot
 513           readily make use of them. To complicate matters further, some of
 514           the additional error information cannot be constructed without
 515           detailed knowledge about platform topology.
 516
 517           Enhanced MCA Logging allows firmware to provide additional error
 518           information to system software, synchronous with MCE or CMCI. This
 519           driver adds support for that functionality with corresponding
 520           tracepoint which carries that information to userspace.
 521
 522 config ACPI_ADXL
 523         bool
 524
 525 menuconfig PMIC_OPREGION
 526         bool "PMIC (Power Management Integrated Circuit) operation region support"
 527         help
 528           Select this option to enable support for ACPI operation
 529           region of the PMIC chip. The operation region can be used
 530           to control power rails and sensor reading/writing on the
 531           PMIC chip.
 532
 533 if PMIC_OPREGION
 534 config BYTCRC_PMIC_OPREGION
 535         bool "ACPI operation region support for Bay Trail Crystal Cove PMIC"
 536         depends on INTEL_SOC_PMIC
 537         help
 538           This config adds ACPI operation region support for the Bay Trail
 539           version of the Crystal Cove PMIC.
 540
 541 config CHTCRC_PMIC_OPREGION
 542         bool "ACPI operation region support for Cherry Trail Crystal Cove PMIC"
 543         depends on INTEL_SOC_PMIC
 544         help
 545           This config adds ACPI operation region support for the Cherry Trail
 546           version of the Crystal Cove PMIC.
 547
 548 config XPOWER_PMIC_OPREGION
 549         bool "ACPI operation region support for XPower AXP288 PMIC"
 550         depends on MFD_AXP20X_I2C && IOSF_MBI=y
 551         help
 552           This config adds ACPI operation region support for XPower AXP288 PMIC.
 553
 554 config BXT_WC_PMIC_OPREGION
 555         bool "ACPI operation region support for BXT WhiskeyCove PMIC"
 556         depends on INTEL_SOC_PMIC_BXTWC
 557         help
 558           This config adds ACPI operation region support for BXT WhiskeyCove PMIC.
 559
 560 config CHT_WC_PMIC_OPREGION
 561         bool "ACPI operation region support for CHT Whiskey Cove PMIC"
 562         depends on INTEL_SOC_PMIC_CHTWC
 563         help
 564           This config adds ACPI operation region support for CHT Whiskey Cove PMIC.
 565
 566 config CHT_DC_TI_PMIC_OPREGION
 567         bool "ACPI operation region support for Dollar Cove TI PMIC"
 568         depends on INTEL_SOC_PMIC_CHTDC_TI
 569         help
 570           This config adds ACPI operation region support for Dollar Cove TI PMIC.
 571
 572 endif
 573
 574 config ACPI_CONFIGFS
 575         tristate "ACPI configfs support"
 576         select CONFIGFS_FS
 577         help
 578           Select this option to enable support for ACPI configuration from
 579           userspace. The configurable ACPI groups will be visible under
 580           /config/acpi, assuming configfs is mounted under /config.
 581
 582 if ARM64
 583 source "drivers/acpi/arm64/Kconfig"
 584
 585 config ACPI_PPTT
 586         bool
 587 endif
 588
 589 config TPS68470_PMIC_OPREGION
 590         bool "ACPI operation region support for TPS68470 PMIC"
 591         depends on MFD_TPS68470
 592         help
 593           This config adds ACPI operation region support for TI TPS68470 PMIC.
 594           TPS68470 device is an advanced power management unit that powers
 595           a Compact Camera Module (CCM), generates clocks for image sensors,
 596           drives a dual LED for flash and incorporates two LED drivers for
 597           general purpose indicators.
 598           This driver enables ACPI operation region support control voltage
 599           regulators and clocks.
 600
 601           This option is a bool as it provides an ACPI operation
 602           region, which must be available before any of the devices
 603           using this, are probed.
 604
 605 endif   # ACPI
 606
 607 config X86_PM_TIMER
 608         bool "Power Management Timer Support" if EXPERT
 609         depends on X86 && (ACPI || JAILHOUSE_GUEST)
 610         default y
 611         help
 612           The Power Management Timer is available on all ACPI-capable,
 613           in most cases even if ACPI is unusable or blacklisted.
 614
 615           This timing source is not affected by power management features
 616           like aggressive processor idling, throttling, frequency and/or
 617           voltage scaling, unlike the commonly used Time Stamp Counter
 618           (TSC) timing source.
 619
 620           You should nearly always say Y here because many modern
 621           systems require this timer.