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