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/topol-
       ogy/parser.c>

SEE ALSO
        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)

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

home | help