DSP Instrument Templates

A DSP instrument template contains information used by the audio folio to load the program into the DSP, allocate the necessary resources, and to control the program via knobs.

The template consists of chunks stored in 3DO file format that specify an offset into the DSP code. The offset points to the first DSP code location that references the resource. The code at that location begins a singly linked list of other locations to be resolved with the same value, ending with a NULL field. The fields patched are all 10 bits right-justified.

The chunks in a DSPP FORM include:

DCOD Chunk (Code Plus TagArgs)

The beginning of a DCPD chunk contains a table with entries for each subchunk, as follows:

int32    dcod_Type 
int32    dcod_Offset
int32    dcod_Size
There are three possible values for dcod_Type:

DKNB Chunk (Knob)

The DKNB Chunk is an array of knob declarations used to control DSP programs, typically through the EI stack. Knobs may require single or double precision EI space or they may be virtual knobs that control ARM parameters and require no EI space.

int32 dknb_Next   /* offset in chunk of next knob */
int32 dknb_Min
int32 dknb_Max
int32 dknb_Nominal
int32 dknb_NumResources
char dknb_Name[AF_MAX_NAME_SIZE]
arrayof
int32 dknr_RsrcIndex
int32 dknr_CalcType
int32 dknr_Data1
int32 dknr_Data2
The CalcType (see the table below) determines how the knob parameters are converted.

Table 1:   CalcType and available resources.
-------------------------------------------------------
CALC_LINEAR     |Resource = knob_value * Data1 + Data2 
-------------------------------------------------------
CALC_INVERT     |Resource = (Data1/knob_value) + Data2 
-------------------------------------------------------
CALC_LINEAR_FP  |Resource = knob_value * Data1 + Data2 
                |(Multiplication is fixed point)       
-------------------------------------------------------
CALC_SIN        |Resource = sin( knob_value *          
                |Data1)*Data (Useful for cordics and   
                |State Variable Filter)                
-------------------------------------------------------

DRLC Chunk (Relocation)

A DRLC chunk is an array of relocation commands consisting of the following:

uchar    drlc_Attribute                        /* of resource */
uchar    drlc_Flags
uchar    drlc_Width                        /* of field to update */
uchar    drlc_Bit                         /* bit position of LSB of field*/
int32    drlc_CodeIndex                        /* Index of subchunk in DCOD */
int32    drlc_RsrcIndex                        /* Index of entry in Resource Chunk */
int32    drlc_CodeOffset                        /* Offset within subchunk */
Some important fields are discussed in the following table

Table 2:  DLRC chunk fields.
--------------------------------------------------------
DLRC_Attribute|Used to calculate the relocation value   
              |from the allocated value. An example     
              |would be the STATUS address for a FIFO as
              |opposed to the normal FIFO address.      
--------------------------------------------------------
DRLC_ADD      |Adds allocated value to current contents 
              |of word pointed to by CodeOffset instead 
              |of simply setting contents. Generally    
              |used for relocating branches by          
              |referencing EN Resource. When the EN     
              |instruction space is allocated, the new  
              |base address is added to the offset      
              |currently compiled for each branch.      
--------------------------------------------------------
DRLC_LIST     |The CodeOffset points to a singly linked 
              |list of fields to be set to the allocated
              |value. This field should not be set if   
              |DRLC_ADD is set.                         
--------------------------------------------------------
DRLC_32       |32-bit data are relocated. Offsets are   
              |indexes into uint32 instead of ushort    
              |arrays.                                  
--------------------------------------------------------

DRSC Chunk (Resource Allocation Request)

A DRSC chunk consists of an array of resource requests, as follows:

int32 drsc_Type
int32 drsc_Many
various drsc_Allocated                                 /* Filled when allocated */
int32 drsc_References                                   /* Count for exported references */
The following types are supported are:

DNMS Chunk (Packed Resource Names)

A DNMS chunk is a packed array of Forth/Pascal style strings. Resources without names have a 0-byte placeholder.