sound/soc/sof/Kconfig

   1 # SPDX-License-Identifier: GPL-2.0-only
   2 menuconfig 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
  10 if SND_SOC_SOF_TOPLEVEL
  11
  12 config SND_SOC_SOF_PCI_DEV
  13         tristate
  14
  15 config 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
  26 config 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
  37 config SND_SOC_SOF_ACPI_DEV
  38         tristate
  39
  40 config SND_SOC_SOF_OF
  41         tristate "SOF OF enumeration support"
  42         depends on OF || COMPILE_TEST
  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
  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
  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
  65 config 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
  72 config 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
  83 if SND_SOC_SOF_DEVELOPER_SUPPORT
  84
  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 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
  96 config SND_SOC_SOF_NOCODEC
  97         tristate
  98
  99 config SND_SOC_SOF_NOCODEC_SUPPORT
 100         bool "SOF nocodec 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 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
 114 config 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
 129 config 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
 137 if SND_SOC_SOF_DEBUG
 138
 139 config SND_SOC_SOF_FORCE_NOCODEC_MODE
 140         bool "SOF force nocodec Mode"
 141         depends on SND_SOC_SOF_NOCODEC_SUPPORT
 142         help
 143           This forces SOF to use dummy/nocodec as machine driver, even
 144           though there is a codec detected on the real platform. This is
 145           typically only enabled for developers for debug purposes, before
 146           codec/machine driver is ready, or to exclude the impact of those
 147           drivers.
 148           Say Y if you need this force nocodec mode option.
 149           If unsure select "N".
 150
 151 config SND_SOC_SOF_DEBUG_XRUN_STOP
 152         bool "SOF stop on XRUN"
 153         help
 154           This option forces PCMs to stop on any XRUN event. This is useful to
 155           preserve any trace data and pipeline status prior to the XRUN.
 156           Say Y if you are debugging SOF FW pipeline XRUNs.
 157           If unsure select "N".
 158
 159 config SND_SOC_SOF_DEBUG_VERBOSE_IPC
 160         bool "SOF verbose IPC logs"
 161         help
 162           This option enables more verbose IPC logs, with command types in
 163           human-readable form instead of just 32-bit hex dumps. This is useful
 164           if you are trying to debug IPC with the DSP firmware.
 165           If unsure select "N".
 166
 167 config SND_SOC_SOF_DEBUG_FORCE_IPC_POSITION
 168         bool "SOF force to use IPC for position update on SKL+"
 169         help
 170           This option forces to handle stream position update IPCs and run PCM
 171           elapse to inform ALSA about that, on platforms (e.g. Intel SKL+) that
 172           with other approach (e.g. HDAC DPIB/posbuf) to elapse PCM.
 173           On platforms (e.g. Intel SKL-) where position update IPC is the only
 174           one choice, this setting won't impact anything.
 175           If you are trying to debug pointer update with position IPCs or where
 176           DPIB/posbuf is not ready, select "Y".
 177           If unsure select "N".
 178
 179 config SND_SOC_SOF_DEBUG_ENABLE_DEBUGFS_CACHE
 180         bool "SOF enable debugfs caching"
 181         help
 182           This option enables caching of debugfs
 183           memory -> DSP resource (memory, register, etc)
 184           before the audio DSP is suspended. This will increase the suspend
 185           latency and therefore should be used for debug purposes only.
 186           Say Y if you want to enable caching the memory windows.
 187           If unsure, select "N".
 188
 189 config SND_SOC_SOF_DEBUG_ENABLE_FIRMWARE_TRACE
 190         bool "SOF enable firmware trace"
 191         help
 192           The firmware trace can be enabled either at build-time with
 193           this option, or dynamically by setting flags in the SOF core
 194           module parameter (similar to dynamic debug).
 195           If unsure, select "N".
 196
 197 config SND_SOC_SOF_DEBUG_IPC_FLOOD_TEST
 198         tristate "SOF enable IPC flood test"
 199         select SND_SOC_SOF_CLIENT
 200         help
 201           This option enables a separate client device for IPC flood test
 202           which can be used to flood the DSP with test IPCs and gather stats
 203           about response times.
 204           Say Y if you want to enable IPC flood test.
 205           If unsure, select "N".
 206
 207 config SND_SOC_SOF_DEBUG_IPC_FLOOD_TEST_NUM
 208         int "Number of IPC flood test clients"
 209         range 1 32
 210         default 2
 211         depends on SND_SOC_SOF_DEBUG_IPC_FLOOD_TEST
 212         help
 213           Select the number of IPC flood test clients to be created.
 214
 215 config SND_SOC_SOF_DEBUG_IPC_MSG_INJECTOR
 216         tristate "SOF enable IPC message injector"
 217         select SND_SOC_SOF_CLIENT
 218         help
 219           This option enables the IPC message injector which can be used to send
 220           crafted IPC messages to the DSP to test its robustness.
 221           Say Y if you want to enable the IPC message injector.
 222           If unsure, select "N".
 223
 224 config SND_SOC_SOF_DEBUG_RETAIN_DSP_CONTEXT
 225         bool "SOF retain DSP context on any FW exceptions"
 226         help
 227           This option keeps the DSP in D0 state so that firmware debug
 228           information can be retained and dumped to userspace.
 229           Say Y if you want to retain DSP context for FW exceptions.
 230           If unsure, select "N".
 231
 232 endif ## SND_SOC_SOF_DEBUG
 233
 234 endif ## SND_SOC_SOF_DEVELOPER_SUPPORT
 235
 236 config SND_SOC_SOF
 237         tristate
 238         select SND_SOC_TOPOLOGY
 239         select SND_SOC_SOF_NOCODEC if SND_SOC_SOF_NOCODEC_SUPPORT
 240         help
 241           This option is not user-selectable but automagically handled by
 242           'select' statements at a higher level.
 243           The selection is made at the top level and does not exactly follow
 244           module dependencies but since the module or built-in type is decided
 245           at the top level it doesn't matter.
 246
 247 config SND_SOC_SOF_PROBE_WORK_QUEUE
 248         bool
 249         help
 250           This option is not user-selectable but automagically handled by
 251           'select' statements at a higher level.
 252           When selected, the probe is handled in two steps, for example to
 253           avoid lockdeps if request_module is used in the probe.
 254
 255 source "sound/soc/sof/amd/Kconfig"
 256 source "sound/soc/sof/imx/Kconfig"
 257 source "sound/soc/sof/intel/Kconfig"
 258 source "sound/soc/sof/mediatek/Kconfig"
 259 source "sound/soc/sof/xtensa/Kconfig"
 260
 261 endif