mirrors/alsa-lib
1
0
Fork 0
mirror of https://github.com/alsa-project/alsa-lib.git synced 2025-10-29 05:40:25 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

topology: An element can refer to multipe data sections in text conf file

Browse source 
Previously in text conf file, an element can only refer to one data
section (SectionData). Now it can also refer to a list of data sections.
Thus users can split groups of firmware parameters to multiple data
sections, and put them all in the reference list.

Finally, data of these data sections will be merged, in the same order as
they are in the reference list, as the element's private data for kernel.

We still support the original syntax of reference to a single data
section. The doc is updated for the syntax extension.

Signed-off-by: Mengdong Lin <mengdong.lin@linux.intel.com>
Reviewed-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>
Signed-off-by: Takashi Iwai <tiwai@suse.de>
This commit is contained in:
Mengdong Lin 2016-07-15 20:17:43 +08:00 • committed by Takashi Iwai
parent fce5b6dcd1
commit bb03d929e8
5 changed files with 131 additions and 46 deletions
Download patch file Download diff file Expand all files Collapse all files

28
include/topology.h
View file

@ -213,6 +213,34 @@ extern "C" {
* The keyword tuples is to define vendor specific tuples. Please refer to
* section Vendor Tokens and Vendor tuples.
*
* <h5>How to define an element with private data</h5>
* An element can refer to a single data section or multiple data
* sections.
*
* <h6>To refer to a single data section:</h6>
* <pre>
* Sectionxxx."element name" {
* ...
* data "name of data section" # optional private data
* }
* </pre>
*
* <h6>To refer to multiple data sections:</h6>
* <pre>
* Sectionxxx."element name" {
* ...
* data [ # optional private data
* "name of 1st data section"
* "name of 2nd data section"
* ...
* ]
* }
* </pre>
* And data of these sections will be merged in the same order as they are
* in the list, as the element's private data for kernel.
*
* </pre>
*
* <h6>Vendor Tokens</h6>
* A vendor token list is defined as a new section. Each token element is
* a pair of string ID and integer value. And both the ID and value are