alsatplg(1)

1ALSATPLG(1)                 General Commands Manual                ALSATPLG(1)
2
3
4

NAME

6       alsatplg - ALSA Topology Compiler
7

SYNOPSIS

9       alsatplg <options> [command]
10

DESCRIPTION

12       alsatplg (ALSA Topology compiler) is a program to compile topology con‐
13       figuration file to the binary file for the kernel drivers.
14
15       Current audio drivers typically hard code topology information  in  the
16       driver  sources:  This tightly couples the audio driver to the develop‐
17       ment board making it time consuming to modify a driver  to  work  on  a
18       different  devices.  The  driver  is  also  tightly  coupled to the DSP
19       firmware version meaning extra care is needed to keep  the  driver  and
20       firmware  version  in  sync.   New  firmware  features also mean driver
21       updates.
22
23       The ALSA topology project removes the need for  re-writing  or  porting
24       audio drivers to different devices or different firmwares: Drivers have
25       no hard coded topology data meaning a single driver can be used on dif‐
26       ferent  devices  by  updating  the  topology data from the file system.
27       Firmware updates can be pushed without having to  update  the  drivers.
28       The  new  firmware  just  needs  to  include  an  updated topology file
29       describing the update.
30

OPTIONS

32       Available options:
33
34          -h, --help
35                 this help
36
37          -V, --version
38                 show the utility version and versions of used libraries
39
40          -c, --compile FILE
41                 source configuration file for the compilation
42
43          -d, --decode FILE
44                 source binary topology file for the decode
45
46          -n, --normalize FILE
47                 parse and save the configuration file in the normalized  for‐
48                 mat
49
50          -u, --dump FILE
51                 parse and save the configuration file in the specified format
52
53          -o, --output FILE
54                 output file
55
56          -v, --verbose LEVEL
57                 set verbose level
58
59          -s, --sort
60                 sort the configuration identifiers (set for normalization)
61
62          -x, --nocheck
63                 save the configuration without additional integrity check
64
65          -z, --dapm-nosort
66                 do not sort DAPM graph items (like in version 1.2.1-)
67

FILES

69       The  master  topology  files  for  each  supported  sound  card  are in
70       /usr/share/alsa/topology.
71
72       For example, the master use case file for  the  broadwell  card  is  in
73       /usr/share/alsa/topology/broadwell/broadwell.conf,  this file describes
74       the audio hardware for the driver.
75
76       For more details on the syntax of UCM files, see  the  alsa-lib  source
77       code:
78       http://git.alsa-project.org/?p=alsa-lib.git;a=blob;f=src/topology/parser.c
79

BUGS

85       None known.
86

AUTHOR

88       Jaroslav Kysela <perex@perex.cz>
89

COPYRIGHT

91       GPLv2+
92
93
94
95
96                                  2018-10-09                       ALSATPLG(1)