Skip to content

Commit f70388a

Browse files
ujfalusilgirdwood
authored andcommitted
intel_debug: introduction: Update for pathnames for IPC4 support
SOF supports platforms from Tiger Lake with IPC4, update the docuementation accordingly. Update the MTL/LNL topology path to follow a generic pattern and add a note about the need for a symlink for the old path to retain backwards compatibility with released kernels. Signed-off-by: Peter Ujfalusi <[email protected]>
1 parent bc438c0 commit f70388a

File tree

1 file changed

+21
-10
lines changed

1 file changed

+21
-10
lines changed

getting_started/intel_debug/introduction.rst

+21-10
Original file line numberDiff line numberDiff line change
@@ -120,28 +120,35 @@ configuration issue.
120120
Linux SOF will look up firmware files at the following paths:
121121

122122
.. list-table:: Firmware look-up paths per Intel platform
123-
:widths: 50 50 25
123+
:widths: 55 5 50 25
124124
:header-rows: 1
125125

126126
* - Platform
127+
- IPC type
127128
- Firmware load path
128129
- Notes
129130
* - Raptor Lake and older
131+
- IPC3
130132
- /lib/firmware/intel/sof/sof-PLAT.ri
131133
- PLAT = glk, cml, ..., rpl
132134
* - Raptor Lake and older (community signed)
135+
- IPC3
133136
- /lib/firmware/intel/sof/community/sof-PLAT.ri
134137
- PLAT = glk, cml, ..., rpl
135-
* - Meteor Lake and newer
138+
* - Tiger Lake and newer
139+
- IPC4
136140
- /lib/firmware/intel/sof-ipc4/PLAT/sof-PLAT.ri
137-
- PLAT = mtl, lnl, ...
138-
* - Meteor Lake and newer (community signed)
141+
- PLAT = tgl, adl, rpl, mtl, lnl, ...
142+
* - Tiger Lake and newer (community signed)
143+
- IPC4
139144
- /lib/firmware/intel/sof-ipc4/PLAT/community/sof-PLAT.ri
140-
- PLAT = mtl, lnl, ...
141-
* - Meteor Lake and newer Loadable Module
145+
- PLAT = tgl, adl, rpl, mtl, lnl, ...
146+
* - Tiger Lake and newer Loadable Module
147+
- IPC4
142148
- /lib/firmware/intel/sof-ipc4-lib/PLAT/UUID.bin
143149
- PLAT as above, UUID = UUID of the module
144-
* - Meteor Lake and newer Loadable Module (community signed)
150+
* - Tiger Lake and newer Loadable Module (community signed)
151+
- IPC4
145152
- /lib/firmware/intel/sof-ipc4-lib/PLAT/community/UUID.bin
146153
- PLAT as above, UUID = UUID of the module
147154

@@ -158,20 +165,24 @@ be instantiated by the SOF driver. The topology can be regenerated and
158165
reconfigured with tools but requires expert knowledge of the ALSA/ASoC/topology frameworks.
159166

160167
.. list-table:: Firmware topology file look-up paths per Intel platform
161-
:widths: 50 50 25
168+
:widths: 50 5 50 25
162169
:header-rows: 1
163170

164171
* - Platform
172+
- IPC type
165173
- Topology load path
166174
- Notes
167175
* - Raptor Lake and older
176+
- IPC3
168177
- /lib/firmware/intel/sof-tplg/sof-CONFIG.tplg
169178
- CONFIG = topology variant needed for detected hardware configuration
170-
* - Meteor Lake and newer
171-
- /lib/firmware/intel/sof-ace-tplg/sof-CONFIG.tplg
179+
* - Tiger Lake and newer
180+
- IPC4
181+
- /lib/firmware/intel/sof-ipc4-tplg/sof-CONFIG.tplg
172182
- CONFIG = topology variant needed for detected hardware configuration
173183

174184
Important notices:
185+
- For compatibility reasons for **Meteor Lake and newer** ``/lib/firmware/intel/sof-ace-tplg`` must be symlinked to ``/lib/firmware/intel/sof-ipc4-tplg``
175186
- The standard Linux firmware search path and order is followed. The above table covers the base "/lib/firmware" case. See https://docs.kernel.org/driver-api/firmware/fw_search_path.html for more information.
176187
- The topology folder and filename can be overridden with "tplg_path" and "tplg_filename" `snd_sof_pci` kernel parameters.
177188

0 commit comments

Comments
 (0)