metaonly interface ti.sdo.ce.audio1.IAUDDEC1
index URL

IAUDDEC1-compliant audio decoder interface

All IAUDDEC1-compliant audio decoder modules must implement this interface.
XDCspec summary sourced in ti/sdo/ce/audio1/IAUDDEC1.xdc
metaonly interface IAUDDEC1 {  ...
// inherits ti.sdo.ce.ICodec
XDCspec declarations sourced in ti/sdo/ce/audio1/IAUDDEC1.xdc
package ti.sdo.ce.audio1;
 
metaonly interface IAUDDEC1 inherits ICodec {
module-wide config parameters
    readonly config String ialgFxns// Name of xDAIS alg function table;
    readonly config String idma3Fxns// Name of xDAIS alg IDMA3 Interface function table;
    readonly config String iresFxns// Name of xDAIS alg IRES Interface function table;
    override readonly config Int rpcProtocolVersion// Version of the Protocol used between the stubFxns and the serverFxns = 1;
 
    override config String serverFxns// Name of skeleton fxn table = "AUDDEC1_SKEL";
    override config String stubFxns// Name of stubs fxn table = "AUDDEC1_STUBS";
    config Bool useCache// Flag indicating whether the framework should provide cached memory;
    config Int uuid// Unique algorithm implementation ID;
module-wide functions
    Int getCreationStackSize// Get the maximum required stack size (in octets) for this algorithm during algorithm instance creation(Program.Module prog);
    Int getDaramScratchSize// Get the maximum scratch size (in octets) required for this algorithm from DARAM space(Program.Module prog);
    Int getSaramScratchSize// Get the maximum scratch size (in octets) required for this algorithm from SARAM space(Program.Module prog);
    Int getStackSize// Get the maximum stack size (in octets) required for this algorithm during its execution phase(Program.Module prog);
}
 
config IAUDDEC1.ialgFxns  // module-wide
index URL

Name of xDAIS alg function table

XDCspec declarations sourced in ti/sdo/ce/audio1/IAUDDEC1.xdc
readonly config String ialgFxns;
 
DETAILS
All xDAIS algorithms must define an IALG_Fxns structure that contains implementations of the IALG methods. This configuration parameter is simply the extern name of this structure.
 
config IAUDDEC1.idma3Fxns  // module-wide
index URL

Name of xDAIS alg IDMA3 Interface function table

XDCspec declarations sourced in ti/sdo/ce/audio1/IAUDDEC1.xdc
readonly config String idma3Fxns;
 
DETAILS
All xDAIS algorithms that use DMA must define an IDMA3_Fxns structure containing the pointers to functions implementatng the IDMA3 interface. If algorithm does not use DMA this structure does not have to be defined.
This configuration parameter is simply the extern name of this structure when defined, null otherwise.
 
config IAUDDEC1.iresFxns  // module-wide
index URL

Name of xDAIS alg IRES Interface function table

XDCspec declarations sourced in ti/sdo/ce/audio1/IAUDDEC1.xdc
readonly config String iresFxns;
 
DETAILS
All xDAIS algorithms that use an IRES resource must define an IRES_Fxns structure containing the pointers to functions implementatng the IRES interface. If algorithm does not use an IRES resource this structure does not have to be defined.
This configuration parameter is simply the extern name of this structure when defined, null otherwise.
SEE
ialgFxns, idma3Fxns
 
config IAUDDEC1.rpcProtocolVersion  // module-wide
index URL

Version of the Protocol used between the stubFxns and the serverFxns

XDCspec declarations sourced in ti/sdo/ce/audio1/IAUDDEC1.xdc
override readonly config Int rpcProtocolVersion = 1;
 
DETAILS
This is set by a particular implementation of a stub/skeleton RPC pair, and is used at runtime to ensure the protocol matches. This is important, for example, to ensure that the protocol used by skeletons built into a server matches that used by the stubs built into the application. Specifically, this is typically changed when the marshalling/unmarshalling message format changes.
This is generally not configured by application or server config scripts, but rather by developers of VISA-like API class extensions.
This rpcProtocolVersion is built into the local application executable, as well as the remote server's executable.
Developers of class extensions should ensure this config parameter is set appropriately by each release of their stubs/skeletons. If a new protocol is introduced, implying that updating both would result in error, the number should be incremented.
There is no "backward-compatibility" requirement in rpcProtocolVersion. If the version is different, regardless of whether it's larger or smaller, the creation of algorithms of this class will fail.
 
config IAUDDEC1.serverFxns  // module-wide
index URL

Name of skeleton fxn table

XDCspec declarations sourced in ti/sdo/ce/audio1/IAUDDEC1.xdc
override config String serverFxns = "AUDDEC1_SKEL";
 
DETAILS
All algorithm's that can run on a remote processor must specify a set of "stub" functions that marshall arguments to send to the remote process that runs corresponding "skeletons" to do the actual processing. This configuration parameter defines the entry point for this algorithm's the skeletons (which run on the remote processor).
This is generally not configured by application or server config scripts, but rather by developers of VISA-like API class extensions. However, an application or server integrator could use this config param to configure in custom serverFxns.
SEE
stubFxns
 
config IAUDDEC1.stubFxns  // module-wide
index URL

Name of stubs fxn table

XDCspec declarations sourced in ti/sdo/ce/audio1/IAUDDEC1.xdc
override config String stubFxns = "AUDDEC1_STUBS";
 
DETAILS
All algorithm's that can run on a remote processor must specify a set of "stub" functions that marshall arguments to send to the remote process that runs corresponding "skeletons" to do the actual processing. This configuration parameter defines the entry point for this algorithm's the stubs (which run on the local processor).
This is generally not configured by application or server config scripts, but rather by developers of VISA-like API class extensions. However, an application or server integrator could use this config param to configure in custom stubFxns.
SEE
serverFxns
 
config IAUDDEC1.useCache  // module-wide
index URL

Flag indicating whether the framework should provide cached memory

XDCspec declarations sourced in ti/sdo/ce/audio1/IAUDDEC1.xdc
config Bool useCache;
 
DETAILS
If set to true, the alg's memory requests will be allocated from cacheable memory. If set to false, the memory will be allocated from non-cached memory. If left unset, the ti.sdo.ce.alg.Algorithm.useCache flag will determine whether the alg's memory will be allocated from cached or non-cached memory.
 
config IAUDDEC1.uuid  // module-wide
index URL

Unique algorithm implementation ID

XDCspec declarations sourced in ti/sdo/ce/audio1/IAUDDEC1.xdc
config Int uuid;
 
DETAILS
This integer must be a unique ID for every algorithm in a "system", where the "system" includes all possible DSP Servers.
This id is used by the Codec Engine APIs to identify the algorithm implementation that will create an instance on a DSP Server.
If a codec doesn't explicitly configure this parameter, a "very likely unique" ID will be generated. It is recommended that codecs not explicitly configure this parameter, and leave it to the system.
 
IAUDDEC1.getCreationStackSize()  // module-wide
index URL

Get the maximum required stack size (in octets) for this algorithm during algorithm instance creation

XDCspec declarations sourced in ti/sdo/ce/audio1/IAUDDEC1.xdc
Int getCreationStackSize(Program.Module prog);
 
DETAILS
This method is called during DSP Server configuration and is used to ensure that the instance creation thread on the server has sufficient stackspace to instantiate the algorithm. This stack size is typically the greater of the stack sizes required by the algorithm's algNumAlloc(), algAlloc(), or algInit() methods.
 
IAUDDEC1.getDaramScratchSize()  // module-wide
index URL

Get the maximum scratch size (in octets) required for this algorithm from DARAM space

XDCspec declarations sourced in ti/sdo/ce/audio1/IAUDDEC1.xdc
Int getDaramScratchSize(Program.Module prog);
 
DETAILS
This method is called during DSP Server configuration and is used to ensure that sufficient scratch space is configured for the specified set of algorithms.
 
IAUDDEC1.getSaramScratchSize()  // module-wide
index URL

Get the maximum scratch size (in octets) required for this algorithm from SARAM space

XDCspec declarations sourced in ti/sdo/ce/audio1/IAUDDEC1.xdc
Int getSaramScratchSize(Program.Module prog);
 
DETAILS
This method is called during DSP Server configuration and is used to ensure that sufficient scratch space is configured for the specified set of algorithms.
 
IAUDDEC1.getStackSize()  // module-wide
index URL

Get the maximum stack size (in octets) required for this algorithm during its execution phase

XDCspec declarations sourced in ti/sdo/ce/audio1/IAUDDEC1.xdc
Int getStackSize(Program.Module prog);
 
DETAILS
This method is called during DSP Server configuration and is used to ensure that threads on the server have sufficient stackspace to run the algorithm.
generated on Tue, 17 Jan 2012 07:29:05 GMT