(Page 5 of 8 in this chapter)


6.4 Using DTMF Tones

When initiating a play operation or a record operation, the application can configure the AG board to terminate the operation when a specific DTMF key is pressed by the remote party. By default, the AG board terminates play and record operations when any DTMF key is entered. The respective parameter structure for the operation, either ADI_PLAY_PARMS or ADI_RECORD_PARMS, includes a selective DTMFabort mask specifying which DTMF keys terminate the operation.

6.4.1 DTMFabort Mask

The DTMFabort mask is a 16-bit entity in which each bit corresponds to a specific key on the telephone keypad. Setting a bit in the mask causes the voice operation to terminate if that particular key is entered. The DTMFabort mask corresponds to the DTMF telephone keypad keys as shown:

Most Significant Bit

Least Significant Bit

Bit Position

15

14

13

12

11

10

9

8

7

6

5

4

3

2

1

0

DTMF Key

D

C

B

A

#

*

9

8

7

6

5

4

3

2

1

0


For example, if the abort mask is set to 0x03FF, the play and record operations will terminate if any digit from `0' through `9' is entered by the remote party. The adidef.h include file contains #defines (ADI_DTMF_xxx) for each digit and for certain digit groups.

Note: The DTMFabort mask has no effect on digit collection.



(Page 5 of 8 in this chapter)


tech_support@nmss.com
Copyright © 1997, Natural MicroSystems, Inc. All rights reserved.