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