xref: /linux/sound/soc/sof/Kconfig (revision d642ef71)
1# SPDX-License-Identifier: GPL-2.0-only
2menuconfig SND_SOC_SOF_TOPLEVEL
3	bool "Sound Open Firmware Support"
4	help
5	  This adds support for Sound Open Firmware (SOF). SOF is free and
6	  generic open source audio DSP firmware for multiple devices.
7	  Say Y if you have such a device that is supported by SOF.
8	  If unsure select "N".
9
10if SND_SOC_SOF_TOPLEVEL
11
12config SND_SOC_SOF_PCI_DEV
13	tristate
14
15config SND_SOC_SOF_PCI
16	tristate "SOF PCI enumeration support"
17	depends on PCI
18	help
19	  This adds support for PCI enumeration. This option is
20	  required to enable Intel Skylake+ devices.
21	  For backwards-compatibility with previous configurations the selection will
22	  be used as default for platform-specific drivers.
23	  Say Y if you need this option.
24	  If unsure select "N".
25
26config SND_SOC_SOF_ACPI
27	tristate "SOF ACPI enumeration support"
28	depends on ACPI || COMPILE_TEST
29	help
30	  This adds support for ACPI enumeration. This option is required
31	  to enable Intel Broadwell/Baytrail/Cherrytrail devices.
32	  For backwards-compatibility with previous configurations the selection will
33	  be used as default for platform-specific drivers.
34	  Say Y if you need this option.
35	  If unsure select "N".
36
37config SND_SOC_SOF_ACPI_DEV
38	tristate
39
40config SND_SOC_SOF_OF
41	tristate "SOF OF enumeration support"
42	depends on OF
43	help
44	  This adds support for Device Tree enumeration. This option is
45	  required to enable i.MX8 or Mediatek devices.
46	  Say Y if you need this option. If unsure select "N".
47
48config SND_SOC_SOF_OF_DEV
49	tristate
50
51config SND_SOC_SOF_COMPRESS
52	bool
53	select SND_SOC_COMPRESS
54
55config SND_SOC_SOF_DEBUG_PROBES
56	tristate
57	select SND_SOC_SOF_CLIENT
58	select SND_SOC_COMPRESS
59	help
60	  This option enables the data probing feature that can be used to
61	  gather data directly from specific points of the audio pipeline.
62	  This option is not user-selectable but automagically handled by
63	  'select' statements at a higher level.
64
65config SND_SOC_SOF_CLIENT
66	tristate
67	select AUXILIARY_BUS
68	help
69	  This option is not user-selectable but automagically handled by
70	  'select' statements at a higher level.
71
72config SND_SOC_SOF_DEVELOPER_SUPPORT
73	bool "SOF developer options support"
74	depends on EXPERT && SND_SOC_SOF
75	help
76	  This option unlocks SOF developer options for debug/performance/
77	  code hardening.
78	  Distributions should not select this option, only SOF development
79	  teams should select it.
80	  Say Y if you are involved in SOF development and need this option.
81	  If not, select N.
82
83if SND_SOC_SOF_DEVELOPER_SUPPORT
84
85config SND_SOC_SOF_FORCE_PROBE_WORKQUEUE
86	bool "SOF force probe workqueue"
87	select SND_SOC_SOF_PROBE_WORK_QUEUE
88	help
89	  This option forces the use of a probe workqueue, which is only used
90	  when HDaudio is enabled due to module dependencies. Forcing this
91	  option is intended for debug only, but this should not add any
92	  functional issues in nominal cases.
93	  Say Y if you are involved in SOF development and need this option.
94	  If not, select N.
95
96config SND_SOC_SOF_NOCODEC
97	tristate
98
99config SND_SOC_SOF_NOCODEC_SUPPORT
100	bool "SOF nocodec static mode support"
101	help
102	  This adds support for a dummy/nocodec machine driver fallback
103	  option if no known codec is detected. This is typically only
104	  enabled for developers or devices where the sound card is
105	  controlled externally.
106	  This option is mutually exclusive at build time with the Intel HDAudio support.
107	  Selecting it may have negative impacts and prevent e.g. microphone
108	  functionality from being enabled on Intel CoffeeLake and later
109	  platforms.
110	  Distributions should not select this option!
111	  Say Y if you need this nocodec fallback option.
112	  If unsure select "N".
113
114config SND_SOC_SOF_STRICT_ABI_CHECKS
115	bool "SOF strict ABI checks"
116	help
117	  This option enables strict ABI checks for firmware and topology
118	  files.
119	  When these files are more recent than the kernel, the kernel
120	  will handle the functionality it supports and may report errors
121	  during topology creation or run-time usage if new functionality
122	  is invoked.
123	  This option will stop topology creation and firmware load upfront.
124	  It is intended for SOF CI/releases and not for users or distros.
125	  Say Y if you want strict ABI checks for an SOF release.
126	  If you are not involved in SOF releases and CI development,
127	  select "N".
128
129config SND_SOC_SOF_DEBUG
130	bool "SOF debugging features"
131	help
132	  This option can be used to enable or disable individual SOF firmware
133	  and driver debugging options.
134	  Say Y if you are debugging SOF FW or drivers.
135	  If unsure select "N".
136
137if SND_SOC_SOF_DEBUG
138
139config SND_SOC_SOF_NOCODEC_DEBUG_SUPPORT
140	bool "SOF nocodec debug mode support"
141	depends on !SND_SOC_SOF_NOCODEC_SUPPORT
142	help
143	  This adds support for a dummy/nocodec machine driver fallback
144	  option.
145	  Unlike the SND_SOC_SOF_NOCODEC_SUPPORT, this option is NOT
146	  mutually exclusive at build with the Intel HDAudio support. The
147	  selection will be done depending on command line or modprobe.d settings
148	  Distributions should not select this option!
149	  Say Y if you need this nocodec debug fallback option.
150	  If unsure select "N".
151
152config SND_SOC_SOF_FORCE_NOCODEC_MODE
153	bool "SOF force nocodec Mode"
154	depends on SND_SOC_SOF_NOCODEC_SUPPORT
155	help
156	  This forces SOF to use dummy/nocodec as machine driver, even
157	  though there is a codec detected on the real platform. This is
158	  typically only enabled for developers for debug purposes, before
159	  codec/machine driver is ready, or to exclude the impact of those
160	  drivers.
161	  Say Y if you need this force nocodec mode option.
162	  If unsure select "N".
163
164config SND_SOC_SOF_DEBUG_XRUN_STOP
165	bool "SOF stop on XRUN"
166	help
167	  This option forces PCMs to stop on any XRUN event. This is useful to
168	  preserve any trace data and pipeline status prior to the XRUN.
169	  Say Y if you are debugging SOF FW pipeline XRUNs.
170	  If unsure select "N".
171
172config SND_SOC_SOF_DEBUG_VERBOSE_IPC
173	bool "SOF verbose IPC logs"
174	help
175	  This option enables more verbose IPC logs, with command types in
176	  human-readable form instead of just 32-bit hex dumps. This is useful
177	  if you are trying to debug IPC with the DSP firmware.
178	  If unsure select "N".
179
180config SND_SOC_SOF_DEBUG_FORCE_IPC_POSITION
181	bool "SOF force to use IPC for position update on SKL+"
182	help
183	  This option forces to handle stream position update IPCs and run PCM
184	  elapse to inform ALSA about that, on platforms (e.g. Intel SKL+) that
185	  with other approach (e.g. HDAC DPIB/posbuf) to elapse PCM.
186	  On platforms (e.g. Intel SKL-) where position update IPC is the only
187	  one choice, this setting won't impact anything.
188	  If you are trying to debug pointer update with position IPCs or where
189	  DPIB/posbuf is not ready, select "Y".
190	  If unsure select "N".
191
192config SND_SOC_SOF_DEBUG_ENABLE_DEBUGFS_CACHE
193	bool "SOF enable debugfs caching"
194	help
195	  This option enables caching of debugfs
196	  memory -> DSP resource (memory, register, etc)
197	  before the audio DSP is suspended. This will increase the suspend
198	  latency and therefore should be used for debug purposes only.
199	  Say Y if you want to enable caching the memory windows.
200	  If unsure, select "N".
201
202config SND_SOC_SOF_DEBUG_ENABLE_FIRMWARE_TRACE
203	bool "SOF enable firmware trace"
204	help
205	  The firmware trace can be enabled either at build-time with
206	  this option, or dynamically by setting flags in the SOF core
207	  module parameter (similar to dynamic debug).
208	  If unsure, select "N".
209
210config SND_SOC_SOF_DEBUG_IPC_FLOOD_TEST
211	tristate "SOF enable IPC flood test"
212	depends on SND_SOC_SOF
213	select SND_SOC_SOF_CLIENT
214	help
215	  This option enables a separate client device for IPC flood test
216	  which can be used to flood the DSP with test IPCs and gather stats
217	  about response times.
218	  Say Y if you want to enable IPC flood test.
219	  If unsure, select "N".
220
221config SND_SOC_SOF_DEBUG_IPC_FLOOD_TEST_NUM
222	int "Number of IPC flood test clients"
223	range 1 32
224	default 2
225	depends on SND_SOC_SOF_DEBUG_IPC_FLOOD_TEST
226	help
227	  Select the number of IPC flood test clients to be created.
228
229config SND_SOC_SOF_DEBUG_IPC_MSG_INJECTOR
230	tristate "SOF enable IPC message injector"
231	depends on SND_SOC_SOF
232	select SND_SOC_SOF_CLIENT
233	help
234	  This option enables the IPC message injector which can be used to send
235	  crafted IPC messages to the DSP to test its robustness.
236	  Say Y if you want to enable the IPC message injector.
237	  If unsure, select "N".
238
239config SND_SOC_SOF_DEBUG_IPC_KERNEL_INJECTOR
240	tristate "SOF enable IPC kernel injector"
241	depends on SND_SOC_SOF
242	select SND_SOC_SOF_CLIENT
243	help
244	  This option enables the IPC kernel injector which can be used to send
245	  crafted IPC messages to the kernel to test its robustness against
246	  DSP messages.
247	  Say Y if you want to enable the IPC kernel injector.
248	  If unsure, select "N".
249
250config SND_SOC_SOF_DEBUG_RETAIN_DSP_CONTEXT
251	bool "SOF retain DSP context on any FW exceptions"
252	help
253	  This option keeps the DSP in D0 state so that firmware debug
254	  information can be retained and dumped to userspace.
255	  Say Y if you want to retain DSP context for FW exceptions.
256	  If unsure, select "N".
257
258endif ## SND_SOC_SOF_DEBUG
259
260endif ## SND_SOC_SOF_DEVELOPER_SUPPORT
261
262config SND_SOC_SOF
263	tristate
264	select SND_SOC_TOPOLOGY
265	select SND_SOC_SOF_NOCODEC if SND_SOC_SOF_NOCODEC_SUPPORT
266	select SND_SOC_SOF_NOCODEC if SND_SOC_SOF_NOCODEC_DEBUG_SUPPORT
267	help
268	  This option is not user-selectable but automagically handled by
269	  'select' statements at a higher level.
270	  The selection is made at the top level and does not exactly follow
271	  module dependencies but since the module or built-in type is decided
272	  at the top level it doesn't matter.
273
274config SND_SOC_SOF_PROBE_WORK_QUEUE
275	bool
276	help
277	  This option is not user-selectable but automagically handled by
278	  'select' statements at a higher level.
279	  When selected, the probe is handled in two steps, for example to
280	  avoid lockdeps if request_module is used in the probe.
281
282# Supported IPC versions
283config SND_SOC_SOF_IPC3
284	bool
285
286config SND_SOC_SOF_IPC4
287	bool
288
289source "sound/soc/sof/amd/Kconfig"
290source "sound/soc/sof/imx/Kconfig"
291source "sound/soc/sof/intel/Kconfig"
292source "sound/soc/sof/mediatek/Kconfig"
293source "sound/soc/sof/xtensa/Kconfig"
294
295endif
296