DSP.C5x[x].Files[y]

Specifies the name or the ID of a DSP file that targets a specific DSP.

Syntax

DSP.C5x[x].Files[y] = filename

x = 0..31

y = file number

Access

Read/Write

Type

File name

Default

None.

Allowed values

A valid file name.

Example

DSP.C5x[0..7].Files[0] = callp.m54

Details

These files are automatically distributed among the various DSPs by the AG plug-in according to internal rules. The naming convention for files is filename.m54.

The following DSP files are available:

DSP file

Description

adsir(_j).m54

Contains the caller ID function that decodes the modem burst that occurs between the first and second rings on a loop start line. In addition, it contains the FSK data receiver. (_j) is the V.23 variant.

adsix(_j).m54

Contains the FSK data transmitter. (_j) is the V.23 variant.

callp.m54

Contains voice and tone detectors used for call progress detection. Use for any outgoing or two-way trunk protocol and for call progress analysis.

dtmf.m54

Contains the DTMF receiver, energy and silence detector, and precise tone filter typically used for cleardown.

dtmfe.m54

A variant of dtmf.m54, optimized for use with the echo canceller (echo.m54). It yields better talk-off resistance but requires the echo canceller to achieve the best cut-through performance.

Note: You must use the echo canceller with this function.

echo.m54

Contains the echo cancellation function. The echo canceller removes reflected transmit channel energy from the incoming signal, which improves DTMF detection and voice recognition while playing.

NMS echo functions are characterized by two parameters: tail length and adaptation rate. Tail length represents the maximum duration of the echo that can be cancelled, in ms. The adaptation rate specifies the percentage of the echo canceller filter coefficients that are adapted every period.

The echo function has an adapt period of 2 ms. Therefore, an echo function with a 20 ms tail length and 100% rate adapts all the coefficients in 2 ms while the same function with a 25% rate adapts in 8 ms.

echo_v3.m54

Contains an improved echo cancellation function. This echo canceller presents a higher performance than the one in echo.m54. It also has a maximum tail length of 64 ms.

Note: Substitute dtmfe.m54 for dtmf.m54 when using this echo canceller.

echo_v4.m54

Contains the improved echo cancellation functions available in echo_v3.m54, and also provides comfort noise generation and tone disabling features.

g726.m54

Contains ITU G.726 ADPCM play and record functions. G.726 is a standard for 32 kbps speech coding.

These functions require considerably more DSP processing time than the functions in voice.m54.

g6726.m54 is required if you start play and record with an encoding type of ADI_ENCODE_G726.

gsm_ms.m54

Contains MS-GSM play and record functions. The 13 kbps Full Rate GSM speech codec is in Microsoft formatted frames.

gsm_mspl.m54

Contains identical play and record functions as gsm_ms.m54 except that the maximum output power of the play function is limited.

ima.m54

Contains IMA ADPCM play and record functions. IMA is a standard for 32 kbps speech encoding.

mf.m54

Contains the multi-frequency receiver which is required for any trunk protocol (TCP) that uses MF signaling, and required by the MF detector.

oki.m54

Contains play and record functions for OKI ADPCM speech encoding at 24 kbps or 32 kbps (used to play and record compatible voice files).

ptf.m54

Contains precise tone filters. Typically used for CNG, CED, or custom tone detection.

rvoice.m54

Contains PCM play and record functions.

rvoice.m54 is required to play or record with an encoding of ADI_ENCODE_MULAW, ADI_ENCODE_ALAW, or ADI_ENCODE_PCM8M16.

rvoice_vad.m54

Contains PCM play and record functions. Record functions can enable the voice activity detection (VAD) capability.

rvoice_vad.m54 is required to play or record with an encoding of ADI_ENCODE_MULAW, ADI_ENCODE_ALAW, or ADI_ENCODE_PCM8M16.

signal.m54

Contains signaling, ring detector, and pulse functions. These are out of band functions which typically operate on the MVIP signaling stream. This file is required for:

  • Any trunk protocol except NOCC

  • The signal detector

  • Sending a pulse

tone.m54

Contains the tone generation function. This file is required for any trunk protocol except NOCC. It is also required for generating tones, generating DTMF tones, MF tones, initiating dialing, and for generating a beep tone with any second record function.

voice.m54

Contains NMS ADPCM play and record functions. The compressed speech is in a framed format with 20 milliseconds of data per frame. Speech is compressed to 16, 24, or 32 kbps or stored as uncompressed mu-law or A-law (64 kbps). This file is required to play or record with encoding values of ADI_ENCODE_NMS_16, ADI_ENCODE_NMS_24, ADI_ENCODE_NMS_32, or ADI_ENCODE_NMS_64.

wave.m54

Contains play and record functions for PCM speech in formats commonly used in WAVE files, including 8-bit and 16-bit 11 kHz sampling.


Refer to Functions for managing resources for more information about the DSP resources available on each board and the DSP requirements for each ADI service function.

Refer to DSP/task processor files and processing power to estimate the DSP requirements for your application and for instructions for re-configuring DSP resources if necessary.