Skip to content

topology2: add function topology description - #11340

Open
bardliao wants to merge 1 commit into
thesofproject:mainfrom
bardliao:function-topology-readme
Open

bardliao wants to merge 1 commit into
thesofproject:mainfrom
bardliao:function-topology-readme

Conversation

@bardliao

Copy link
Copy Markdown
Collaborator

Add function topology description in the README file.

Add function topology description in the README file.

Signed-off-by: Bard Liao <yung-chuan.liao@linux.intel.com>
Copilot AI balanced review requested due to automatic review settings October 23, 2026 06:24

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

The documentation-only addition matches the stated purpose and has only an optional grammar correction.

1 open issue
What changed in this PR

Adds guidance on function topologies to the topology2 README, explaining their shared role across devices with the same audio function.

Changes:

  • Defines function topologies and gives examples of supported functions.
  • Describes ACPI-based selection by the Linux kernel driver.
  • States that function topologies should not contain customized features.
File Description
tools/​topology/​topology2/​README.md Documents function topology purpose, selection, and customization constraints.

Review effort: Balanced

Comment thread tools/topology/topology2/README.md Outdated
Comment on lines +388 to +389
Function topology provides generic and basic audio feature for a single function. Like headset,
amp, mic, etc. The Linux kernel driver will select the function topology based on the function
@bardliao
bardliao force-pushed the function-topology-readme branch from 4f70f0f to 72734ca Compare October 23, 2026 06:34

@kv2019i kv2019i left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Excellent, thanks @bardliao . A few typos. We can extend this if the function topology role increases.

```
### Function topology

A function topology provides generic and basic audio path for an individual hardware functio, such

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Typo: s/functio/function/

### Function topology

A function topology provides generic and basic audio path for an individual hardware functio, such
asheadset, amplifier or microphone. The Linux kernel driver uses function information exposed by

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"asheadset" -> "as headset" (probably not "ass headset" :) )

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants