(Page 3 of 3 in this chapter)

Summary of DSP Files

DSP File

Description

adsir.dsp

This file contains the caller ID function which decodes the modem burst that occurs between the first and second rings on a loop-start line. Use adsir.dsp if one of the loop start protocols is used and the parameter adilps.cidsupport is set to 1.
This file is also needed for the adiStartReceivingFSK function.

adsix.dsp

This file contains the FSK transmitter. It is needed for the adiStartSendingFSK function.

callp.dsp

This file contains voice and tone detectors used for call progress detection and for general tone detection.
Use callp.dsp if any outgoing or two-way trunk protocol is in use, and use it for the adiStartCallProgress and adiStartToneDetector functions.

dtmf.dsp

This file contains the DTMF receiver, energy/silence detector and a precise tone detector. Use dtmf.dsp for DTMF detection. The silence/energy detector is used by the record functions and by adiStartEnergyDetector. The precise tone detector is used as the cleardown detector by the loop start protocols when the parameter adilps.cleardownflag is set to 1. Otherwise, it is available as tone detector #1 to adiStartToneDetector.

dtmfe.dsp

This is a variation of dtmf.dsp, optimized for use with the echo canceller (echo.dsp). It yields better talk-off resistance but requires the echo canceller to achieve the best cut through performance.

echo.dsp

This file contains the echo cancellation function. The echo canceller removes reflected energy from the incoming signal, which improves DTMF detection and voice recognition while playing.
Use echo.dsp if echo cancellation is enabled. See the adiStartProtocol function and the ADISTART_PARMS category.
Note: Substitute dtmfe.dsp for dtmf.dsp when using the echo canceller.

g726p.dsp g726r.dsp

These files contain ITU G.726 ADPCM play and record functions respectively. G.726 is a standard for 32 kbs speech coding.
Note: These functions require considerably more DSP processing time than the functions in voice.dsp. You will not be able to run as many contexts actively playing or recording as you can with other speech codings. g726p.dsp is required if you start play with an encoding type of ADI_ENCODE_G726. g726r.dsp is required to record to this encoding type.

mf.dsp

This file contains the Multi-Frequency Receiver function. This function is required for any trunk protocol that uses MF signaling and also by the adiStartMFDetector function.

okiply.dsp okirec.dsp

These files contain play and record functions for OKI ADPCM speech encoding, at 24 kbs or 32 kbs. okiply.dsp is required if you start play with an encoding type of ADI_ENCODE_OKI_24 or ADI_ENCODE_OKI_32. okirec.dsp is required to record to these encoding types. okiply.dsp supports speed-up.

rvoice.dsp

This file contains PCM play and record functions.
rvoice.dsp is required to play or record with an encoding of ADI_ENCODE_MULAW, ADI_ENCODE_ALAW, or ADI_ENCODE_PCM8M16.

signal.dsp

This file 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. It is also required for the adiStartSignalDetector, adiQuerySignalState, and adiStartPulse functions.

tone.dsp

This file contains the tone generation function.
This file is required for any trunk protocol except NOCC. It is also required for the adiStartTones, adiStartDTMF and adiStartDial functions, and for any record function to generate the beep

voice.dsp

This file 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 kbs or stored as uncompressed µ-law or A-law (64 kbs). 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.

voxp.dsp voxr.dsp

These files should be substituted for voice.dsp in order to apply speed up to NMS ADPCM encoded speech. voxp.dsp supports speed-up.

wavply.dsp wavrec.dsp

These files contain play and record functions for PCM speech in formats commonly used in WAVE files, including 8 and 16 bit 11 kHz sampling. wavply.dsp is required if you start play with an encoding type of ADI_ENCODE_PCM11M8 or ADI_ENCODE_PCM11M16. wavrec.dsp is required to record to these encoding types.

DSP File	Description
`adsir.dsp`	This file contains the caller ID function which decodes the modem burst that occurs between the first and second rings on a loop-start line. Use `adsir.dsp` if one of the loop start protocols is used and the parameter `adilps.cidsupport` is set to 1. This file is also needed for the adiStartReceivingFSK function.
`adsix.dsp`	This file contains the FSK transmitter. It is needed for the adiStartSendingFSK function.
`callp.dsp`	This file contains voice and tone detectors used for call progress detection and for general tone detection. Use `callp.dsp` if any outgoing or two-way trunk protocol is in use, and use it for the adiStartCallProgress and adiStartToneDetector functions.
`dtmf.dsp`	This file contains the DTMF receiver, energy/silence detector and a precise tone detector. Use `dtmf.dsp` for DTMF detection. The silence/energy detector is used by the record functions and by adiStartEnergyDetector. The precise tone detector is used as the cleardown detector by the loop start protocols when the parameter `adilps.cleardownflag` is set to 1. Otherwise, it is available as tone detector #1 to adiStartToneDetector.
`dtmfe.dsp`	This is a variation of `dtmf.dsp`, optimized for use with the echo canceller (`echo.dsp`). It yields better talk-off resistance but requires the echo canceller to achieve the best cut through performance.
`echo.dsp`	This file contains the echo cancellation function. The echo canceller removes reflected energy from the incoming signal, which improves DTMF detection and voice recognition while playing. Use `echo.dsp` if echo cancellation is enabled. See the adiStartProtocol function and the ADISTART_PARMS category. Note: Substitute `dtmfe.dsp` for `dtmf.dsp` when using the echo canceller.
`g726p.dsp g726r.dsp`	These files contain ITU G.726 ADPCM play and record functions respectively. G.726 is a standard for 32 kbs speech coding. Note: These functions require considerably more DSP processing time than the functions in `voice.dsp`. You will not be able to run as many contexts actively playing or recording as you can with other speech codings. `g726p.dsp` is required if you start play with an encoding type of ADI_ENCODE_G726. `g726r.dsp` is required to record to this encoding type.
`mf.dsp`	This file contains the Multi-Frequency Receiver function. This function is required for any trunk protocol that uses MF signaling and also by the adiStartMFDetector function.
`okiply.dsp okirec.dsp`	These files contain play and record functions for OKI ADPCM speech encoding, at 24 kbs or 32 kbs. `okiply.dsp` is required if you start play with an encoding type of ADI_ENCODE_OKI_24 or ADI_ENCODE_OKI_32. `okirec.dsp` is required to record to these encoding types. `okiply.dsp` supports speed-up.
`rvoice.dsp`	This file contains PCM play and record functions. `rvoice.dsp` is required to play or record with an encoding of ADI_ENCODE_MULAW, ADI_ENCODE_ALAW, or ADI_ENCODE_PCM8M16.
`signal.dsp`	This file 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. It is also required for the adiStartSignalDetector, adiQuerySignalState, and adiStartPulse functions.
`tone.dsp`	This file contains the tone generation function. This file is required for any trunk protocol except `NOCC`. It is also required for the adiStartTones, adiStartDTMF and adiStartDial functions, and for any record function to generate the beep
`voice.dsp`	This file 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 kbs or stored as uncompressed µ-law or A-law (64 kbs). 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.
`voxp.dsp voxr.dsp`	These files should be substituted for `voice.dsp` in order to apply speed up to NMS ADPCM encoded speech. `voxp.dsp` supports speed-up.
`wavply.dsp wavrec.dsp`	These files contain play and record functions for PCM speech in formats commonly used in WAVE files, including 8 and 16 bit 11 kHz sampling. `wavply.dsp` is required if you start play with an encoding type of ADI_ENCODE_PCM11M8 or ADI_ENCODE_PCM11M16. `wavrec.dsp` is required to record to these encoding types.

(Page 3 of 3 in this chapter)

Tech_Support@nmss.com