Linux Certif

Toute la documentation sur la certification Linux LPI

emu-dspmgr

NAME

emu-dspmgr - dsp patch loader and manager for emu10k1 based soundcards

SYNOPSIS

emu-dspmgr [options]

DESCRIPTION

emu-dspmgr is used to load/unload dsp patches to/from the emu10k1 processor present in soundcards such as the Creative Labs SBLive!. emu-dspmgr is also used to control the internal routing of signals (for example digital CD input to rear speakers). Some dsp patches will have variable settings used to control their functioning (control gprs) which can also be modified using emu-dspmgr.

OPTIONS

-aroute or --add=route

Adds a signal route. route is given in the form input:output (a list of valid inputs can be obtained with -i and outputs with -o).

-ccontrol or --control=control

Selects control gpr to be modified (you also need to set the -p option). When used with no arguments prints a list of the available control gprs.

When this option is used preceding a -v (create a route with volume) option, the route's volume control will use the name specified by the -c option.

-Dfile or --=dsp_device=file

Use an alternate device than /dev/dsp.

-d or --debug

Enables debug output. A detailed list of loaded dsp patches will be printed.

-ffile or --filestart=file

Loads a '.bin' dsp patch from file. It must be preceeded by -l to indicate the line where to attach the dsp patch.

The patch will have a name specified inside the .bin file, you can rename it to something else by using the -p option. this will add the patch before any other already loaded patches in the signal chain.

-Ffile or --fileend=file

Same as -f but adds the file to the end of a signal chain

-i or --inputs

List the available inputs.

-lline or --line=line

Selects the line where to attach the dsp patch. line is one of the valid inputs or outputs.

-melement or --=mixer=element

Map a control GPR to an OSS mixer element. If no element is specified, a full listing is provided. The option must be preceeded with a patch (-p) and control GPR (-c)

-Mfile or --=mixer_device=file

Use an alternate mixer than /dev/mixer.

-o or --outputs

List the available output.

-ppatch or --patch=patch

When used with the -s (set control GPR), or -m (map GPR to OSS mixer control) options, this selects the dsp patch to be modified.

When used with the -f (load patch) option, renames the loaded patch to

-rroute or --remove=route

Removes a signal route. route is given in the form input:output (a list of valid inputs can be obtained with -i and outputs with -o). This option when used with no arguments prints a list of current signal routes.

(note, if the route is the only route tied to an input/output line and that line has a patch attached, remove the patch first, see -z for a quick way to remove everything).

-svalue or --set=value

Sets the value of a control gpr. This option must be preceeded by the -c and -p options (with a valid patch and control gpr names) to select the control gpr to be modified. value is a signed 32 bit quantity in hexadecimal.

-uprog or --unload=prog

Unloads a dsp patch. This option when used without arguments lists all the loaded patches.

-vroute or --volume=route

Adds a signal route with volume control. route is given in the form input:output (a list of valid inputs can be obtained with -i and outputs with -o).

The option also acts as the -p and -c options at the same time, so, for example, one can create a route with volume and map it to an OSS mixer control in a single command.

-z or --clear

removes all routes and unloads all dsp microcode programs

EXAMPLES

Adding a signal route connecting "Pcm L" to "Rear L":

emu-dspmgr -aPcm L:Rear L

Loading the patch effect.bin and placing it in the "Pcm L" line:

emu-dspmgr -lPcm L -feffect.bin

Create a route with volume control a make it controlable by the OSS' pcm mixer control:

emu-dspmgr -vPcm L:Rear L -mpcm_l

Changing a control gpr value of the "Routing" patch:

emu-dspmgr -pRouting -cVol Pcm L:Rear L -sffffff

Load the tone control patch, rename them as "bass-treble" and map the bass and treble control gprs to mixer elements in one command:

emu-dspmgr -pbass-treble -lPcm L -ftone.bin -cbass -mbass -ctreble -mtreble

For an example of a working script, see emu-script distributed with the driver source in utils/mixer.

BUGS

Not really a bug, but: location matters. Information to be used by 'actions' (-a, -f, m, -r, -s, and -u) should appear before these actions on the command line, follow order in the examples above.

"Help, route XYZ is unremovable!" --> make sure no patches are tied to either the input or output of the route and this route is the only route attached to that input or output.

"Help, the digital out on my SBLive 5.1 doesn't work" --> use "emu-config -d" to toggle it into digital mode (not a bug).

SEE ALSO

as10k1(1), emu-config(1), emu-script (see the script, there's no man page)

COPYING

Copyright 2000, 2001 Rui Sousa, Daniel Bertrand

Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies.

Permission is granted to copy and distribute modified versions of this manual under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one.

Permission is granted to copy and distribute translations of this manual into another language, under the above conditions for modified versions, except that this permission notice may be included in translations approved by the copyright holders instead of in the original English.

AUTHORS

Rui Sousa, Daniel Bertrand