(Page 6 of 46 in this chapter)

AG2DSPFile

Syntax

AG2DSPFile = filename

Description

This statement specifies the module to load (.m54) DSP functions for AG 2000 boards and AG 4000 boards. The naming convention for files is filename.m54.
For AG 2000 boards and AG 4000 boards, the following DSP files are available: DSP File Description adsir.m54 Contains the caller ID function which 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. The Japanese variant is adsir_j.m54. adsix.m54 Contains the FSK data transmitter. The Japanese variant is adsix_j.m54. 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 and an energy/silence detector. 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. 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. Note: Substitute dtmfe.m54 for dtmf.m54 when using the echo canceller. g726.m54 Contains ITU G.726 ADPCM play and record functions. G.726 is a standard for 32 kbit/s speech coding. Note: These functions require considerably more DSP processing time than the functions in voice.m54. g726.m54 is required if you start play/record with an encoding type of ADI_ENCODE_G726. ima.m54 Contains IMA ADPCM play and record functions. IMA is a standard for 32 kbit/s speech coding. 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. ptf.m54 Contains precise tone filters. Used as the cleardown detector by loop start protocols. oki.m54 Contains play and record functions for OKI ADPCM speech encoding, at 24 Kbit/s or 32 Kbit/s (used to play/record compatible voice files). 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. signal.m54 Contains out of band signaling functions, such as ring detector and pulse functions for AG 2000 and AG 4000 boards. These functions operate on signaling timeslots. This file is required for the following: · Any trunk protocol except NOCC · The signal detector · Sending a pulse Note: On AG 4000 boards, DSP 0 is automatically reserved for signalling. 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 kbit/s or stored as uncompressed mu-law or A-law (64 kbit/s). 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 and 16 bit 11 kHz sampling. Note: All DSP processors not explicitly configured with an AG2DSPImage or AG2TaskProcessor keyword are loaded with default DSP files. In addition, processors are loaded with DSP files specified by the AG2DSPFile keyword. Default DSP files include: callp, dtmf, mf, ptf, tone, and signal. (signal.m54 is only used on AG 2000 boards).

DSP File	Description
`adsir.m54`	Contains the caller ID function which 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. The Japanese variant is `adsir_j.m54`.
`adsix.m54`	Contains the FSK data transmitter. The Japanese variant is `adsix_j.m54.`
`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 and an energy/silence detector.
`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.
`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. Note: Substitute `dtmfe.m54` for `dtmf.m54` when using the echo canceller.
`g726.m54`	Contains ITU G.726 ADPCM play and record functions. G.726 is a standard for 32 kbit/s speech coding. Note: These functions require considerably more DSP processing time than the functions in `voice.m54`. `g726.m54` is required if you start play/record with an encoding type of `ADI_ENCODE_G726`.
`ima.m54`	Contains IMA ADPCM play and record functions. IMA is a standard for 32 kbit/s speech coding.
`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.
`ptf.m54`	Contains precise tone filters. Used as the cleardown detector by loop start protocols.
`oki.m54`	Contains play and record functions for OKI ADPCM speech encoding, at 24 Kbit/s or 32 Kbit/s (used to play/record compatible voice files).
`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`.
`signal.m54`	Contains out of band signaling functions, such as ring detector and pulse functions for AG 2000 and AG 4000 boards. These functions operate on signaling timeslots. This file is required for the following: · Any trunk protocol except `NOCC` · The signal detector · Sending a pulse Note: On AG 4000 boards, DSP 0 is automatically reserved for signalling.
`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 kbit/s or stored as uncompressed mu-law or A-law (64 kbit/s). 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 and 16 bit 11 kHz sampling.

Example

AG2DSPfile = dtmf.m54

AG2DSPFile

Syntax

Description

Example

See Also