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