6.7 Call Progress

(Page 8 of 11 in this chapter)

Function	Description
adiStartCallProgress	Starts call progress analysis.
adiStopCallProgress	Stops call progress analysis.

6.7.1 Call Progress Tone Events

The call progress tone events are mapped from the tone events described in Section 3.4.4, Network Tone Parameters, and are controlled by the ADICALLPROG parameter structure as defined in that section.
The following tone events are detected by the call progress function. Each detected tone causes AG Access to generate the respective event. Event Event ID Dial tone ADIEVN_CP_DIALTONE Reorder tone ADIEVN_CP_RORDTONE Ring tone ADIEVN_CP_RINGTONE Ring quit ADIEVN_CP_RINGQUIT SIT ADIEVN_CP_SIT FAX/Modem Answer Tone ADIEVN_CP_CED

The call progress voice events are mapped from the voice events described in Section 3.4.5, Voice Parameters and are controlled by the ADICALLPROG parameter structure as defined in that section.
Whenever a voice event occurs in the context of the call progress function, an ADIEVN_CP_VOICE event is generated. The event value field contains the particular voice event: Event Description Event Value Field Voice Begin Remote party begins speaking. ADI_CP_VOICE_BEGIN Voice Medium Remote party has spoken for a period longer than the first time threshold. ADI_CP_VOICE_MEDIUM Voice Long Remote party has spoken for a period longer than the second time threshold. ADI_CP_VOICE_LONG Voice Extended Remote party has spoken for a period longer than the third time threshold. ADI_CP_VOICE_EXTENDED Voice End Remote party stopped speaking. ADI_CP_VOICE_END

Event	Description	Event Value Field
Voice Begin	Remote party begins speaking.	`ADI_CP_VOICE_BEGIN`
Voice Medium	Remote party has spoken for a period longer than the first time threshold.	`ADI_CP_VOICE_MEDIUM`
Voice Long	Remote party has spoken for a period longer than the second time threshold.	`ADI_CP_VOICE_LONG`
Voice Extended	Remote party has spoken for a period longer than the third time threshold.	`ADI_CP_VOICE_EXTENDED`
Voice End	Remote party stopped speaking.	`ADI_CP_VOICE_END`

The call progress function always terminates when any of the following events occur: Event Description ADIEVN_CP_DIALTONE Dial tone detected. ADIEVN_CP_BUSYTONE Busy tone detected. ADIEVN_CP_RORDTONE Reorder tone detected. ADIEVN_CP_SIT SIT tones detected. ADIEVN_CP_NOANSWER See No Answer heading in Section 3.4.3, Events Used by Call Control. ADIEVN_CP_CED FAX/modem answer tone detected.
Additionally, the application configures the stopmask parameter in the ADICALLPROG parameter structure to selectively terminate on occurrence of any of the following: Event Description ADIEVN_CP_RINGTONE Ring tone detected. ADIEVN_CP_RINGQUIT Loss of ring tone with no following events. ADIEVN_CP_VOICE, BEGIN First detection of voice. ADIEVN_CP_VOICE, MEDIUM Voice duration longer than first time threshold. ADIEVN_CP_VOICE, LONG Voice duration longer than second time threshold. ADIEVN_CP_VOICE, EXTENDED Voice extended. ADIEVN_CP_VOICE, END Voice end.
When call progress terminates, an ADIEVN_CP_DONE event is generated.

Event	Description
`ADIEVN_CP_DIALTONE`	Dial tone detected.
`ADIEVN_CP_BUSYTONE`	Busy tone detected.
`ADIEVN_CP_RORDTONE`	Reorder tone detected.
`ADIEVN_CP_SIT`	SIT tones detected.
`ADIEVN_CP_NOANSWER`	See No Answer heading in Section 3.4.3, Events Used by Call Control.
`ADIEVN_CP_CED`	FAX/modem answer tone detected.

The following functions are typically configured to share the same task processor (physical DSP):
- Call progress
- Voice record
- Voice playback.
For the typical configuration, DSP capacity is allotted under the assumption that every port is running at most one of these functions at any given time. If you concurrently execute a combination of these functions, you will likely exhaust the DSP capacity.
If the port started the NOCC protocol, call progress can be executed at any time; otherwise, call progress can only be run after the call enters the connected state (see Chapter 3 for more information).

(Page 8 of 11 in this chapter)