Skip to content

Commit 1dddada

Browse files
committed
topology2: add split topologies description
Describe what are split topologies and how to create it. Signed-off-by: Bard Liao <yung-chuan.liao@linux.intel.com>
1 parent 6eee88f commit 1dddada

File tree

1 file changed

+32
-0
lines changed

1 file changed

+32
-0
lines changed

developer_guides/topology2/topology2.rst

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1332,6 +1332,38 @@ You can use the ``-P`` switch to convert a 2.0 configuration file to the 1.0 con
13321332
13331333
alsatplg <-D args=values> -P input.conf -o output.conf
13341334
1335+
Split topologies
1336+
****************
1337+
1338+
Linux kernel can load multiple topologies, a topology for a single function.
1339+
This feature is useful when a single device is disabled in specific productuds. To achieve this, you need to split
1340+
the topology into multiple tplg files. The split topology files should be named as follows:
1341+
1342+
.. code-block:: bash
1343+
1344+
sof-<platform>-<function>-id<BE id number>.tplg
1345+
1346+
For example
1347+
1348+
.. code-block:: bash
1349+
1350+
sof-arl-sdca-2amp-id2.tplg
1351+
sof-arl-sdca-mic-id4.tplg
1352+
sof-arl-dmic-2ch-id5.tplg
1353+
sof-arl-sdca-hdmi-id7.tgpl
1354+
1355+
The split topologies are the subset of the monolithic topology. Usually, you just need to add a description with proper
1356+
macro settings to disable the features that you don't need and set the first BE ID that in the topology in the cmake file
1357+
to generate the split topologies.
1358+
1359+
For example
1360+
1361+
.. code-block:: bash
1362+
1363+
"cavs-sdw\;sof-arl-sdca-2amp-id2\;PLATFORM=mtl,NUM_SDW_AMP_LINKS=2,SDW_JACK=false,\
1364+
SDW_AMP_FEEDBACK=false,SDW_SPK_STREAM=Playback-SmartAmp,NUM_HDMIS=0"
1365+
1366+
13351367
Topology reminders
13361368
******************
13371369

0 commit comments

Comments
 (0)