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