Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ALSATPLG(1)		    General Commands Manual		   ALSATPLG(1)

NAME
       alsatplg	- ALSA Topology	Compiler

SYNOPSIS
       alsatplg	<options> [command]

DESCRIPTION
       alsatplg	(ALSA Topology compiler) is a program to compile topology con-
       figuration file to the binary file for the kernel drivers.

       Current audio drivers typically hard code topology information  in  the
       driver  sources:	 This tightly couples the audio	driver to the develop-
       ment board making it time consuming to modify a driver  to  work	 on  a
       different  devices.  The	 driver	 is  also  tightly  coupled to the DSP
       firmware	version	meaning	extra care is needed to	keep  the  driver  and
       firmware	 version  in sync.  New	firmware features also mean driver up-
       dates.

       The ALSA	topology project removes the need for  re-writing  or  porting
       audio drivers to	different devices or different firmwares: Drivers have
       no hard coded topology data meaning a single driver can be used on dif-
       ferent  devices	by  updating  the  topology data from the file system.
       Firmware	updates	can be pushed without having to	 update	 the  drivers.
       The  new	 firmware  just	 needs to include an updated topology file de-
       scribing	the update.

OPTIONS
       Available options:

	  -h, --help
		 this help

	  -V, --version
		 show the utility version and versions of used libraries

	  -c, --compile	FILE
		 source	configuration file for the compilation

	  -d, --decode FILE
		 source	binary topology	file for the decode

	  -n, --normalize FILE
		 parse and save	the configuration file in the normalized  for-
		 mat

	  -u, --dump FILE
		 parse and save	the configuration file in the specified	format

	  -o, --output FILE
		 output	file

	  -v, --verbose	LEVEL
		 set verbose level

	  -s, --sort
		 sort the configuration	identifiers (set for normalization)

	  -x, --nocheck
		 save the configuration	without	additional integrity check

	  -z, --dapm-nosort
		 do not	sort DAPM graph	items (like in version 1.2.1-)

FILES
       The  master  topology  files  for  each	supported  sound  card	are in
       /usr/share/alsa/topology.

       For example, the	master use case	file for  the  broadwell  card	is  in
       /usr/share/alsa/topology/broadwell/broadwell.conf,  this	file describes
       the audio hardware for the driver.

       For more	details	on the syntax of UCM files, see	 the  alsa-lib	source
       code:
       http://git.alsa-project.org/?p=alsa-lib.git;a=blob;f=src/topology/parser.c

SEE ALSO
       o Topology						    Interface:
	 http://www.alsa-project.org/alsa-doc/alsa-lib/group__topology.html

BUGS
       None known.

AUTHOR
       Jaroslav	Kysela <perex@perex.cz>

COPYRIGHT
       GPLv2+

				  2018-10-09			   ALSATPLG(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | FILES | SEE ALSO | BUGS | AUTHOR | COPYRIGHT

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=alsatplg&sektion=1&manpath=FreeBSD+13.1-RELEASE+and+Ports>

home | help