You are here: CSP API Reference > 1 EXS & SwitchKit API Messages > DSP SIMM Configure 0x00C0
SwitchKit Name
DSPSIMMConfig
Type
EXS API and SwitchKit API message
Description
Use this message to configure a SIMM on a DSP card. Each SIMM is populated with four DSPs. The host can specify the function to be downloaded to each DSP.
You must take a SIMM out of service before sending this message. After receiving an Acknowledgment to the DSP SIMM Configure message, bring the SIMM back in service.
On the DSP-ONE card, each DSP can only handle one function, and four DSPs are configured at the same time.
On the DSP Series 2 card, each DSP can handle multiple functions, so the DSP Chip AIB (0x22) is used to configure individual DSP chips.
NOTE: When configuring DSP cards for MFR2 signaling, each card that contains MFR2 receivers must also have MFR2 backward and forward transmitters. If MFR2 Receivers only are present, an incoming call causes an alarm that specifies "DSP Function Not Configured" and the MFR2 receivers are not used.
Sent by
Host Application
Example Message (Socket Log Output for SwitchKit)
00 0F 00 C0 00 00 FF 00 01 12 02 01 01 01 01 01 01
SwitchKit Code
Configuration
DSPSIMMConfig (
Node = integer,
Slot = integer,
SIMM = integer,
DSP0Func = integer,
DSP1Func = integer,
DSP2Func = integer,
DSP3Func = integer);
C Structure
typedef struct {
UBYTE AddrInfo[30];
UBYTE DSP0Func;
UBYTE DSP1Func;
UBYTE DSP2Func;
UBYTE DSP3Func;
UBYTE reserved51[219]
} XL_DSPSIMMConfig;
C++ Class
class XLC_DSPSIMMConfig : public XLC_SlotMessage {
public:
const UBYTE *getAddrInfo() const;
UBYTE *getAddrInfo();
void setAddrInfo(UBYTE *x);
// Extended addressing functions
// DSP Chip AIB functions
void DSPChip(UBYTE x);
UBYTE getDSPSlot() const;
void setDSPSlot(UBYTE x);
UBYTE getDSPSIMM() const;
void setDSPSIMM(UBYTE x);
UBYTE getSIMM() const;
void setSIMM(UBYTE x);
UBYTE getSlot() const;
void setSlot(UBYTE x);
UBYTE getDSP0Func() const;
void setDSP0Func(UBYTE x);
UBYTE getDSP1Func() const;
void setDSP1Func(UBYTE x);
UBYTE getDSP2Func() const;
void setDSP2Func(UBYTE x);
UBYTE getDSP3Func() const;
void setDSP3Func(UBYTE x);
};
EXS API Hex Format
MESSAGE (White) |
RESPONSE (Gray) |
||
Byte |
Field Description |
Byte |
Field Description |
0 |
Frame (0xFE) |
0 |
Frame (0xFE) |
1, 2 |
Length (0xNNNN) |
1, 2 |
Length (0x0007) |
3, 4 |
Message Type (0x00C0) |
3, 4 |
Message Type (0x00C0) |
5 |
Reserved (0x00) |
5 |
Reserved (0x00) |
6 |
Sequence Number |
6 |
Same Sequence Number |
7 |
Logical Node ID |
7 |
Logical Node ID |
: |
AIB Address Method 0x00 - Individual AEs |
8, 9 |
|
Number of AEs to follow |
|||
AEs 0x22 DSP Chip (DSP Series 2 card only) |
|||
: |
Function 1 |
10 |
Checksum |
: |
Function 2 |
|
|
: |
Function 3 |
||
: |
Function 4 |
||
: |
Checksum |
Slot Number
The slot numbers are as follows:
CSP 2090: 0x00–0x0F - Physical slot number of the DSP card
CSP 2040: 0x00–0x03 - Physical slot number of the DSP card
SIMM Number
The SIMM numbers are as follows:
DSP-ONE Card: 0x00–0x03
DSP Series 2 Card: 0x00 or 0x01
Function
On the DSP Series 2 card, each field configures a function on a single chip on a DSP. On the DSP-ONE card, each field configures a function on an entire DSP.
DSP Series 2
Function 1 = RCV 0
Function 2 = TXMT 0
Function 3 = RCV 1
Function 4 = TXMT 1
DSP-ONE
Function 1 = DSP 0
Function 2 = DSP 1
Function 3 = DSP 2
Function 4 = DSP 3
Function Types
0x00 - No Function Type
Tone Reception
0x01- DTMF µ-law
0x02 - MFR1 µ-law
0x03 - DTMF A-Law
0x04 - MFR1 A-Law
0x05 - MFR2 A-Law
0x06 - MFR2 µ-Law
0x07 - CPA A-Law
0x08 - CPA µ-Law
0x09 - E1 Dial Pulse (DSP-ONE only)
0x0A - Energy Detection
0x0E - Coin Detection µ-Law (DSP-ONE only)
0x0F - Coin Detection A-Law (DSP-ONE only)
Tone Generation
DSP Series 2
0x30 - Universal Tone Generation µ-Law
0x31 - Universal Tone Generation A-Law
DSP-ONE
0x10 - DTMF µ-Law
0x11 - DTMF A-Law
0x12 - MFR1 µ-Law
0x13 - MFR1 A-Law
0x14 - CPT4 µ-Law
0x15 - CPT4 A-Law
0x16 - MFR2 Forward A-Law
0x17 - MFR2 Forward µ-Law
0x18 - MFR2 Backward A-Law
0x19 - MFR2 Backward µ-Law
0x1A - Bong Tone µ-Law
0x1B - Bong Tone A-Law
Fax
0x32 - Send/Receive Fax
File Playback / Record (DSP Series 2 Only)
0x1D - File Playback / Record
Conferencing
DSP Series 2
0x21 - Monitor
0x22 - Unified
0x23 - DTMF-Clamped *
* This option is for backward compatibility. With the DSP Series 2 card you can create a Unified Conference with DTMF Clamping enabled, which is the recommended method
DSP-ONE
0x1E - Standard µ-Law
0x1F - Standard A-Law
0x20 - Mixed
0x21 - Monitor
0x22 - Unified
0x23 - DTMF-Clamped
NOTE: You cannot configure a VRAS SIMM.
Miscellaneous
0x33 - Echo Cancel (DSP Series 2 Only)
0x34 - Positive Voice Detection/Answering Machine Detection (PVD/AMD) (DSP Series 2 Only)
Default Function Types on the DSP Series 2 card
Module Number |
DSP Number |
Rcv 0 |
Txmt 0 |
Rcv 1 |
Txmt 1 |
---|---|---|---|---|---|
0 |
0 |
DTMF µ-law (0x01) |
Universal µ-law |
DTMF µ-law (0x01) |
Universal µ-law |
0 |
1 |
DTMF µ-law (0x01) |
Universal µ-law |
DTMF µ-law (0x01) |
Universal µ-law |
0 |
2 |
CPA µ-law (0x08) |
Universal µ-law |
CPA µ-law (0x08) |
Universal µ-law |
0 |
3 |
File Playback/Record |
Not allowed (0x00) |
File Playback/Record |
Not allowed (0x00) |
1 |
0 |
DTMF µ-law (0x01) |
Universal µ-law |
DTMF µ-law (0x01) |
Universal µ-law |
1 |
1 |
DTMF µ-law (0x01) |
Universal µ-law |
DTMF µ-law (0x01) |
Universal µ-law |
1 |
2 |
MFR1 µ-law (0x02) |
Universal µ-law |
MFR1 µ-law (0x02) |
Universal µ-law |
1 |
3 |
MFR1 µ-law (0x02) |
Universal µ-law |
MFR1 µ-law (0x02) |
Universal µ-law |
Configuration Options on the DSP Series 2 Card
The following table shows configuration options for function types on the DSP Series 2 card.
Rcv 0 |
Txmt 0 |
Rcv 1 |
Txmt 1 |
---|---|---|---|
Any Tone Receiver Function |
Universal Tone Generator |
Any Tone Receiver Function |
Universal Tone Generator |
File Record |
Not allowed |
File Record |
Not allowed |
T.30 Fax |
Not allowed |
T.30 Fax |
Not allowed |
Echo Cancel |
Not allowed |
Echo Cancel |
Not allowed |
Any of the Valid Conferencing Types |
Not allowed |
Any of the Valid Conferencing Types |
Not allowed |
Default Function Types on the DSP-ONE Card
For more information, please refer to the DSP Resources of the Developer’s Guide: Overview.
The table below shows the default SIMM and DSP configurations.
|
DSP 0 |
DSP 1 |
DSP 2 |
DSP 3 |
---|---|---|---|---|
SIMM 0 |
0x01 |
0x01 |
0x01 |
0x01 |
SIMM 1 |
0x10 |
0x12 |
0x14 |
0x08 |
SIMM 2 |
0x02 |
0x02 |
0x02 |
0x02 |
SIMM 3 |
0x01 |
0x01 |
0x01 |
0x01 |