xref: /openbmc/linux/drivers/acpi/Kconfig (revision 1771e9fb)
1# SPDX-License-Identifier: GPL-2.0
2#
3# ACPI Configuration
4#
5
6config ARCH_SUPPORTS_ACPI
7	bool
8
9menuconfig 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
45if ACPI
46
47config ACPI_LEGACY_TABLES_LOOKUP
48	bool
49
50config ARCH_MIGHT_HAVE_ACPI_PDC
51	bool
52
53config ACPI_GENERIC_GSI
54	bool
55
56config ACPI_SYSTEM_POWER_STATES_SUPPORT
57	bool
58
59config ACPI_CCA_REQUIRED
60	bool
61
62config 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
71if ACPI_DEBUGGER
72
73config 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
80endif
81
82config 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
90config ACPI_LPIT
91	bool
92	depends on X86_64
93	default y
94
95config ACPI_SLEEP
96	bool
97	depends on SUSPEND || HIBERNATION
98	depends on ACPI_SYSTEM_POWER_STATES_SUPPORT
99	default y
100
101config 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
121config 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
138config 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
150config 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
162config 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
175config 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
189config 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
199config 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
214config 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
225config 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
238config 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
244config ACPI_CPU_FREQ_PSS
245	bool
246	select THERMAL
247
248config ACPI_PROCESSOR_CSTATE
249	def_bool y
250	depends on ACPI_PROCESSOR
251	depends on IA64 || X86
252
253config ACPI_PROCESSOR_IDLE
254	bool
255	select CPU_IDLE
256
257config ACPI_MCFG
258	bool
259
260config 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
273config 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
287config 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
298config ACPI_HOTPLUG_CPU
299	bool
300	depends on ACPI_PROCESSOR && HOTPLUG_CPU
301	select ACPI_CONTAINER
302	default y
303
304config 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
315config 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
329config ACPI_CUSTOM_DSDT_FILE
330	string "Custom DSDT Table file to include"
331	default ""
332	depends on !STANDALONE
333	help
334	  This option supports a custom DSDT by linking it into the kernel.
335	  See Documentation/admin-guide/acpi/dsdt-override.rst
336
337	  Enter the full path name to the file which includes the AmlCode
338	  or dsdt_aml_code declaration.
339
340	  If unsure, don't enter a file name.
341
342config ACPI_CUSTOM_DSDT
343	bool
344	default ACPI_CUSTOM_DSDT_FILE != ""
345
346config ARCH_HAS_ACPI_TABLE_UPGRADE
347	def_bool n
348
349config ACPI_TABLE_UPGRADE
350	bool "Allow upgrading ACPI tables via initrd"
351	depends on BLK_DEV_INITRD && ARCH_HAS_ACPI_TABLE_UPGRADE
352	default y
353	help
354	  This option provides functionality to upgrade arbitrary ACPI tables
355	  via initrd. No functional change if no ACPI tables are passed via
356	  initrd, therefore it's safe to say Y.
357	  See Documentation/admin-guide/acpi/initrd_table_override.rst for details
358
359config ACPI_TABLE_OVERRIDE_VIA_BUILTIN_INITRD
360	bool "Override ACPI tables from built-in initrd"
361	depends on ACPI_TABLE_UPGRADE
362	depends on INITRAMFS_SOURCE!="" && INITRAMFS_COMPRESSION=""
363	help
364	  This option provides functionality to override arbitrary ACPI tables
365	  from built-in uncompressed initrd.
366
367	  See Documentation/admin-guide/acpi/initrd_table_override.rst for details
368
369config ACPI_DEBUG
370	bool "Debug Statements"
371	help
372	  The ACPI subsystem can produce debug output.  Saying Y enables this
373	  output and increases the kernel size by around 50K.
374
375	  Use the acpi.debug_layer and acpi.debug_level kernel command-line
376	  parameters documented in Documentation/firmware-guide/acpi/debug.rst and
377	  Documentation/admin-guide/kernel-parameters.rst to control the type and
378	  amount of debug output.
379
380config ACPI_PCI_SLOT
381	bool "PCI slot detection driver"
382	depends on SYSFS && PCI
383	help
384	  This driver creates entries in /sys/bus/pci/slots/ for all PCI
385	  slots in the system.  This can help correlate PCI bus addresses,
386	  i.e., segment/bus/device/function tuples, with physical slots in
387	  the system.  If you are unsure, say N.
388
389config ACPI_CONTAINER
390	bool "Container and Module Devices"
391	default (ACPI_HOTPLUG_MEMORY || ACPI_HOTPLUG_CPU)
392	help
393	  This driver supports ACPI Container and Module devices (IDs
394	  ACPI0004, PNP0A05, and PNP0A06).
395
396	  This helps support hotplug of nodes, CPUs, and memory.
397
398	  To compile this driver as a module, choose M here:
399	  the module will be called container.
400
401config ACPI_HOTPLUG_MEMORY
402	bool "Memory Hotplug"
403	depends on MEMORY_HOTPLUG
404	help
405	  This driver supports ACPI memory hotplug.  The driver
406	  fields notifications on ACPI memory devices (PNP0C80),
407	  which represent memory ranges that may be onlined or
408	  offlined during runtime.
409
410	  If your hardware and firmware do not support adding or
411	  removing memory devices at runtime, you need not enable
412	  this driver.
413
414	  To compile this driver as a module, choose M here:
415	  the module will be called acpi_memhotplug.
416
417config ACPI_HOTPLUG_IOAPIC
418	bool
419	depends on PCI
420	depends on X86_IO_APIC
421	default y
422
423config ACPI_SBS
424	tristate "Smart Battery System"
425	depends on X86
426	select POWER_SUPPLY
427	help
428	  This driver supports the Smart Battery System, another
429	  type of access to battery information, found on some laptops.
430
431	  To compile this driver as a module, choose M here:
432	  the modules will be called sbs and sbshc.
433
434config ACPI_HED
435	tristate "Hardware Error Device"
436	help
437	  This driver supports the Hardware Error Device (PNP0C33),
438	  which is used to report some hardware errors notified via
439	  SCI, mainly the corrected errors.
440
441config ACPI_CUSTOM_METHOD
442	tristate "Allow ACPI methods to be inserted/replaced at run time"
443	depends on DEBUG_FS
444	help
445	  This debug facility allows ACPI AML methods to be inserted and/or
446	  replaced without rebooting the system. For details refer to:
447	  Documentation/firmware-guide/acpi/method-customizing.rst.
448
449	  NOTE: This option is security sensitive, because it allows arbitrary
450	  kernel memory to be written to by root (uid=0) users, allowing them
451	  to bypass certain security measures (e.g. if root is not allowed to
452	  load additional kernel modules after boot, this feature may be used
453	  to override that restriction).
454
455config ACPI_BGRT
456	bool "Boottime Graphics Resource Table support"
457	depends on EFI && (X86 || ARM64)
458	help
459	  This driver adds support for exposing the ACPI Boottime Graphics
460	  Resource Table, which allows the operating system to obtain
461	  data from the firmware boot splash. It will appear under
462	  /sys/firmware/acpi/bgrt/ .
463
464config ACPI_REDUCED_HARDWARE_ONLY
465	bool "Hardware-reduced ACPI support only" if EXPERT
466	def_bool n
467	help
468	  This config item changes the way the ACPI code is built.  When this
469	  option is selected, the kernel will use a specialized version of
470	  ACPICA that ONLY supports the ACPI "reduced hardware" mode.  The
471	  resulting kernel will be smaller but it will also be restricted to
472	  running in ACPI reduced hardware mode ONLY.
473
474	  If you are unsure what to do, do not enable this option.
475
476source "drivers/acpi/nfit/Kconfig"
477source "drivers/acpi/numa/Kconfig"
478source "drivers/acpi/apei/Kconfig"
479source "drivers/acpi/dptf/Kconfig"
480
481config ACPI_WATCHDOG
482	bool
483
484config ACPI_EXTLOG
485	tristate "Extended Error Log support"
486	depends on X86_MCE && X86_LOCAL_APIC && EDAC
487	select UEFI_CPER
488	help
489	  Certain usages such as Predictive Failure Analysis (PFA) require
490	  more information about the error than what can be described in
491	  processor machine check banks. Most server processors log
492	  additional information about the error in processor uncore
493	  registers. Since the addresses and layout of these registers vary
494	  widely from one processor to another, system software cannot
495	  readily make use of them. To complicate matters further, some of
496	  the additional error information cannot be constructed without
497	  detailed knowledge about platform topology.
498
499	  Enhanced MCA Logging allows firmware to provide additional error
500	  information to system software, synchronous with MCE or CMCI. This
501	  driver adds support for that functionality with corresponding
502	  tracepoint which carries that information to userspace.
503
504config ACPI_ADXL
505	bool
506
507menuconfig PMIC_OPREGION
508	bool "PMIC (Power Management Integrated Circuit) operation region support"
509	help
510	  Select this option to enable support for ACPI operation
511	  region of the PMIC chip. The operation region can be used
512	  to control power rails and sensor reading/writing on the
513	  PMIC chip.
514
515if PMIC_OPREGION
516config BYTCRC_PMIC_OPREGION
517	bool "ACPI operation region support for Bay Trail Crystal Cove PMIC"
518	depends on INTEL_SOC_PMIC
519	help
520	  This config adds ACPI operation region support for the Bay Trail
521	  version of the Crystal Cove PMIC.
522
523config CHTCRC_PMIC_OPREGION
524	bool "ACPI operation region support for Cherry Trail Crystal Cove PMIC"
525	depends on INTEL_SOC_PMIC
526	help
527	  This config adds ACPI operation region support for the Cherry Trail
528	  version of the Crystal Cove PMIC.
529
530config XPOWER_PMIC_OPREGION
531	bool "ACPI operation region support for XPower AXP288 PMIC"
532	depends on MFD_AXP20X_I2C && IOSF_MBI=y
533	help
534	  This config adds ACPI operation region support for XPower AXP288 PMIC.
535
536config BXT_WC_PMIC_OPREGION
537	bool "ACPI operation region support for BXT WhiskeyCove PMIC"
538	depends on INTEL_SOC_PMIC_BXTWC
539	help
540	  This config adds ACPI operation region support for BXT WhiskeyCove PMIC.
541
542config CHT_WC_PMIC_OPREGION
543	bool "ACPI operation region support for CHT Whiskey Cove PMIC"
544	depends on INTEL_SOC_PMIC_CHTWC
545	help
546	  This config adds ACPI operation region support for CHT Whiskey Cove PMIC.
547
548config CHT_DC_TI_PMIC_OPREGION
549	bool "ACPI operation region support for Dollar Cove TI PMIC"
550	depends on INTEL_SOC_PMIC_CHTDC_TI
551	help
552	  This config adds ACPI operation region support for Dollar Cove TI PMIC.
553
554endif
555
556config ACPI_CONFIGFS
557	tristate "ACPI configfs support"
558	select CONFIGFS_FS
559	help
560	  Select this option to enable support for ACPI configuration from
561	  userspace. The configurable ACPI groups will be visible under
562	  /config/acpi, assuming configfs is mounted under /config.
563
564if ARM64
565source "drivers/acpi/arm64/Kconfig"
566
567config ACPI_PPTT
568	bool
569endif
570
571config TPS68470_PMIC_OPREGION
572	bool "ACPI operation region support for TPS68470 PMIC"
573	depends on MFD_TPS68470
574	help
575	  This config adds ACPI operation region support for TI TPS68470 PMIC.
576	  TPS68470 device is an advanced power management unit that powers
577	  a Compact Camera Module (CCM), generates clocks for image sensors,
578	  drives a dual LED for flash and incorporates two LED drivers for
579	  general purpose indicators.
580	  This driver enables ACPI operation region support control voltage
581	  regulators and clocks.
582
583	  This option is a bool as it provides an ACPI operation
584	  region, which must be available before any of the devices
585	  using this, are probed.
586
587endif	# ACPI
588
589config X86_PM_TIMER
590	bool "Power Management Timer Support" if EXPERT
591	depends on X86 && (ACPI || JAILHOUSE_GUEST)
592	default y
593	help
594	  The Power Management Timer is available on all ACPI-capable,
595	  in most cases even if ACPI is unusable or blacklisted.
596
597	  This timing source is not affected by power management features
598	  like aggressive processor idling, throttling, frequency and/or
599	  voltage scaling, unlike the commonly used Time Stamp Counter
600	  (TSC) timing source.
601
602	  You should nearly always say Y here because many modern
603	  systems require this timer.
604