(Page 21 of 46 in this chapter)

DSPfile

Syntax

DSPfile = filename

Description

Installs a digital signal processor (DSP) function module on the current board(s). Every board requires at least one DSP file; typically there are several loaded to each board. If the same DSP files are required for all boards, place them in the Common, or Board All, section.
For AG 2000 and AG 4000 boards, DSP functions are installed with the AG2DSPFile keyword.
The ADI Service Function Reference Manual lists the DSP files required for each ADI service function. Note: For rvoice files, voice encoding refers to the data played/recorded on the line. The choice between rvoice.dsp and rvoice_a.dsp depends on the encoding of the line. For example, to play mu-law data on an A-law line, specify ADI_ENCODE_MULAW for the encoding, and configure rvoice.dsp to be loaded to the board.
The following DSP files (in mu-law and A-law form) are currently included with CT Access: mu-law version A-law version Description adsir.dsp adsir_a.dsp Caller ID which decodes the modem bus that occurs between the first and second rings on a loopstart line. Also contains ADSI receive functions, and FSK data receiver. adsix.dsp adsix_a.dsp ADSI send function and FSK data transmitter. adsir_j.dsp adsir_ja.dsp Japanese caller ID and ADSI receive functions. adsix_j.dsp adsix_ja.dsp Japanese ADSI send function. callp.dsp callp_a.dsp Call progress detection function including voice and tone detectors, and general tone detection. Use for any outgoing or two-way trunk protocol, and for call progress analysis. dtmf.dsp dtmf_a.dsp DTMF detection: DTMF receiver, energy/ silence, and precise tone detector. The precise tone detector can be used as the cleardown detector by loop start protocols. dtmfe.dsp dtmfe_a.dsp dtmf.dsp optimized for use with echo cancellation (echo.dsp).yields better talk-off response than dtmf.dsp, but requires the echo canceller to achieve the best cut-through performance. echo.dsp echo_a.dsp Echo canceller function: removes reflected energy from the incoming signal (which improves DMF detection and voice recognition while playing). Note: When using the echo canceler, substitute dtmfe.dsp for dtmf.dsp. g726p.dsp g726p_a.dsp ITU G726 ADPCM play functions (G.726 is the standard for 32 kbit/s coding). Required to play with an encoding type of ADI_ENCODE_G726. g726r.dsp g726r_a.dsp ITU G726 ADPCM record function. Required to record with an encoding type of ADI_ENCODE_G726. imaply.dsp imaply_a.dsp IMA/DVI ADPCM play. imarec.dsp imarec_a.dsp IMA/DVI ADPCM record. mf.dsp mf_a.dsp Multi-Frequency receiver function. Required by he MF detector and for any trunk protocol that uses MF signaling (MFC-R2, EAM, MFS, IWK, etc.) okiply.dsp okiply_a.dsp OKI ADPCM play functions for speech encoding at 24 or 32 Kbits/s. Required to play with an encoding type of: · ADI_ENCODE_OKI24 · ADI_ENCODE_OKI32 Note: okiply.dsp supports speed-up. okirec.dsp okirec_a.dsp OKI ADPCM record functions for speech encoding at 24 or 32 kbits/s. Required to record with an encoding type of: · ADI_ENCODE_OKI24 · ADI_ENCODE_OKI32 rvoice.dsp rvoice_a.dsp Unformatted (raw) PCM play and record functions. Required to play and record when encoding type is specified as: · ADI_ENCODE_MUAW · ADI_ENCODE_ALAW · ADI_ENCODE_PCM8M16 signal.dsp signal_a.dsp Signaling, ring detector, and pulse functions. These are "out of band" functions which typically operate on the MVIP signaling stream. Note :Required for any trunk protocol except NOCC (for signal detection, and for sending pulses) tone.dsp tone_a.dsp Tone and DTMF generation functions. Required for generating tones, generating DTMF, initiating dialing, and for generating a beep tone with any second record function. Note: Required for any trunk control protocol except NOCC. voice.dsp voice_a.dsp NMS ADPCM play and record functions. Compressed speech is in framed format with 20 ms of data per frame. Speech is compressed to 16, 24, or 32 kbits/s or stored as uncompressed mu-law or A-law (64 kbits/s). Note: Required to play or record when encoding type is specified as: · ADI_ENCODE_NMS_16 · ADI_ENCODE_NMS_24 · ADI_ENCODE_NMS_32 · ADI_ENCODE_NMS64 voxp.dsp voxp_a.dsp NMS ADPCM play with speed-up. Should be substituted for voice.dsp to apply speed up when playing NMS encoded speech. voxr.dsp voxr_a.dsp NMS ADPCM record function. wavply.dsp wavply_a.dsp WAVE play functions for PCM speech in formats commonly used in WAVE files, including 8 and 16 bit 11 kHz sampling. Note: Required to play when encoding type is specified as: · ADI_ENCODE_PCM11M8 · ADI_ENCODE_PCM11M16 wavrec.dsp wavrec_a.dsp WAVE record functions for PCM speech in formats commonly used in WAVE files, including 8 and 16 bit 11 kHz sampling. Note: Required to record when encoding type is specified as: · ADI_ENCODE_PCM11M8 · ADI_ENCODE_PCM11M16
Additional .dsp files are available for Fusion and Fax configurations. For more information about available Fusion DSP files, refer to the Fusion readme.txt file, or the NaturalFax Developer's Reference Manual.
The DSPfile statement is mandatory for all boards except AG 2000 boards and AG 4000 boards.

mu-law version	A-law version	Description
`adsir.dsp`	`adsir_a.dsp`	Caller ID which decodes the modem bus that occurs between the first and second rings on a loopstart line. Also contains ADSI receive functions, and FSK data receiver.
`adsix.dsp`	`adsix_a.dsp`	ADSI send function and FSK data transmitter.
`adsir_j.dsp`	`adsir_ja.dsp`	Japanese caller ID and ADSI receive functions.
`adsix_j.dsp`	`adsix_ja.dsp`	Japanese ADSI send function.
`callp.dsp`	`callp_a.dsp`	Call progress detection function including voice and tone detectors, and general tone detection. Use for any outgoing or two-way trunk protocol, and for call progress analysis.
`dtmf.dsp`	`dtmf_a.dsp`	DTMF detection: DTMF receiver, energy/ silence, and precise tone detector. The precise tone detector can be used as the cleardown detector by loop start protocols.
`dtmfe.dsp`	`dtmfe_a.dsp`	`dtmf.dsp` optimized for use with echo cancellation (`echo.dsp`).yields better talk-off response than `dtmf.dsp`, but requires the echo canceller to achieve the best cut-through performance.
`echo.dsp`	`echo_a.dsp`	Echo canceller function: removes reflected energy from the incoming signal (which improves DMF detection and voice recognition while playing). Note: When using the echo canceler, substitute `dtmfe.dsp` for `dtmf.dsp`.
`g726p.dsp`	`g726p_a.dsp`	ITU G726 ADPCM play functions (G.726 is the standard for 32 kbit/s coding). Required to play with an encoding type of `ADI_ENCODE_G726`.
`g726r.dsp`	`g726r_a.dsp`	ITU G726 ADPCM record function. Required to record with an encoding type of `ADI_ENCODE_G726.`
`imaply.dsp`	`imaply_a.dsp`	IMA/DVI ADPCM play.
`imarec.dsp`	`imarec_a.dsp`	IMA/DVI ADPCM record.
`mf.dsp`	`mf_a.dsp`	Multi-Frequency receiver function. Required by he MF detector and for any trunk protocol that uses MF signaling (MFC-R2, EAM, MFS, IWK, etc.)
`okiply.dsp`	`okiply_a.dsp`	OKI ADPCM play functions for speech encoding at 24 or 32 Kbits/s. Required to play with an encoding type of: · `ADI_ENCODE_OKI24` · `ADI_ENCODE_OKI32` Note: `okiply.dsp` supports speed-up.
`okirec.dsp`	`okirec_a.dsp`	OKI ADPCM record functions for speech encoding at 24 or 32 kbits/s. Required to record with an encoding type of: · `ADI_ENCODE_OKI24` · `ADI_ENCODE_OKI32`
`rvoice.dsp`	`rvoice_a.dsp`	Unformatted (raw) PCM play and record functions. Required to play and record when encoding type is specified as: · `ADI_ENCODE_MUAW` · `ADI_ENCODE_ALAW` · `ADI_ENCODE_PCM8M16`
`signal.dsp`	`signal_a.dsp`	Signaling, ring detector, and pulse functions. These are "out of band" functions which typically operate on the MVIP signaling stream. Note :Required for any trunk protocol except NOCC (for signal detection, and for sending pulses)
`tone.dsp`	`tone_a.dsp`	Tone and DTMF generation functions. Required for generating tones, generating DTMF, initiating dialing, and for generating a beep tone with any second record function. Note: Required for any trunk control protocol except NOCC.
`voice.dsp`	`voice_a.dsp`	NMS ADPCM play and record functions. Compressed speech is in framed format with 20 ms of data per frame. Speech is compressed to 16, 24, or 32 kbits/s or stored as uncompressed mu-law or A-law (64 kbits/s). Note: Required to play or record when encoding type is specified as: · `ADI_ENCODE_NMS_16` · `ADI_ENCODE_NMS_24` · `ADI_ENCODE_NMS_32` · `ADI_ENCODE_NMS64`
`voxp.dsp`	`voxp_a.dsp`	NMS ADPCM play with speed-up. Should be substituted for `voice.dsp` to apply speed up when playing NMS encoded speech.
`voxr.dsp`	`voxr_a.dsp`	NMS ADPCM record function.
`wavply.dsp`	`wavply_a.dsp`	WAVE play functions for PCM speech in formats commonly used in WAVE files, including 8 and 16 bit 11 kHz sampling. Note: Required to play when encoding type is specified as: · `ADI_ENCODE_PCM11M8` · `ADI_ENCODE_PCM11M16`
`wavrec.dsp`	`wavrec_a.dsp`	WAVE record functions for PCM speech in formats commonly used in WAVE files, including 8 and 16 bit 11 kHz sampling. Note: Required to record when encoding type is specified as: · `ADI_ENCODE_PCM11M8` · `ADI_ENCODE_PCM11M16`

Example

DSPfile = dtmf.dsp

DSPfile

Syntax

Description

Example

See Also