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