Detectors, Generators<br>and Timers
6.2 DTMF and Tone Generation
(Page 3 of 11 in this chapter)
- AG boards are capable of generating single and dual frequency tones. AG Access
provides functions for playing one or more user-defined tones and for generating
DTMF tones.
- The AG Access tone generation functions are listed below:
- The adiStartTones function allows the application to play a list of single or dual
frequency tones. Each individual tone has the following programmable features
which are enabled with the ADITONE parameter structure:
- The combined duration of ontime and offtime represents one complete cycle.
- The adiStartDTMF is a DTMF tone generator with programmable interdigit
delays. The function accepts a string of digits and an ADIDTMF parameter
structure. The parameter structure allows you to specify interdigit pause duration
for the comma and period characters which can be interspersed with the DTMFs
in the digit string.
- The adiStopTones function immediately terminates active tone generation.
Regardless of which tone type is active, AG Access generates an
ADIEVN_TONES_DONE event with the value set to ADI_REASON_STOPPED.
- In the normal case of tones of a specific duration, AG Access generates an
ADIEVN_TONES_DONE event with the value set to ADI_REASON_FINISHED.
- If an error occurs in starting the function, the done event may be sent with the
value set to an ADIERR_xxx code.
6.2.1 System Restrictions
- Because only one function can drive the output of the telephone line, the
following functions are mutually exclusive:
(Page 3 of 11 in this chapter)
Copyright 1996 Natural MicroSystems, Inc. All Rights Reserved.