(Page 1 of 1 in this chapter) Version

Chapter 6

Tone Generation

AG and QX boards are capable of generating single and dual frequency tones. The ADI service provides functions for playing one or more user-defined tones and for generating DTMF tones.

If you want to...	Then use...
Play a sequence of user-defined tones	adiStartTones
Play a sequence of DTMF tones	adiStartDTMF
Terminate playing tones	adiStopTones

adiStartTones allows the application to play a list of single or dual frequency tones. Each individual tone has the following attributes, which are stored in the ADI_TONE_PARMS structure:

Parameter

Description

ontime

A configurable "active" time period.

offtime

A configurable "inactive" time period following the active time period.

iterations

Number of times to repeat the tone.
The combined duration of ontime and offtime represents one complete cycle.
adiStartDTMF is a DTMF tone generator with programmable interdigit delays. The function accepts a string of digits and an ADI_DTMF_PARMS 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.

Parameter	Description
`ontime`	A configurable "active" time period.
`offtime`	A configurable "inactive" time period following the active time period.
`iterations`	Number of times to repeat the tone.

Because only one function can drive the output of the telephone line, the following functions are mutually exclusive: Tone generation Voice playback Voice record when beep is enabled

(Page 1 of 1 in this chapter) Version