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