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          -c, --compile FILE
38                 source configuration file for the compilation
39
40          -o, --output FILE
41                 output binary file
42
43          -v, --verbose LEVEL
44                 set verbose level
45

FILES

47       The master  topology  files  for  each  supported  sound  card  are  in
48       /usr/share/alsa/topology.
49
50       For  example,  the  master  use  case file for the broadwell card is in
51       /usr/share/alsa/topology/broadwell/broadwell.conf, this file  describes
52       the audio hardware for the driver.
53
54       For  more  details  on the syntax of UCM files, see the alsa-lib source
55       code:
56       http://git.alsa-project.org/?p=alsa-lib.git;a=blob;f=src/topology/parser.c
57

SEE ALSO

59       · Topology                                                   Interface:
60         http://www.alsa-project.org/alsa-doc/alsa-lib/group__topology.html
61

BUGS

63       None known.
64

AUTHOR

66       Jaroslav Kysela <perex@perex.cz>
67

69       GPLv2+
70
71
72
73
74                                  2018-10-09                       ALSATPLG(1)
Impressum