EMU-DSPMGR(1)

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 -a"Pcm L:Rear L"

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

emu-dspmgr -l"Pcm L" -feffect.bin

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

emu-dspmgr -v"Pcm L:Rear L" -mpcm_l

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

emu-dspmgr -p"Routing" -c"Vol 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 -p"bass-treble" -l"Pcm 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