Table of Contents

Index

NMS Glossary

Previous Page

Next Page

(Page 40 of 69 in this chapter) Version

adiStartMFDetector

Description

Enables the detection of MFs (Multi Frequency tones).

Prototype

DWORD adiStartMFDetector ( CTAHD ctahd,
unsigned mftype )
ctahd CTA context handle returned by ctaCreateContext.
mftype Type of MF tone to detect:
ADI_MF_US ADI_MF_CCITT_FORWARD ADI_MF_CCITT_BACKWARD

Return Values

SUCCESS
ADIERR_INVALID_CALL_STATE
CTAERR_FUNCTION_ACTIVE
CTAERR_FUNCTION_NOT_AVAIL
mf.dsp has not been loaded to the board.
CTAERR_INVALID_CTAHD
CTAERR_INVALID_STATE

Events

ADIEVN_MF_DETECT_DONE
The DTMF detector is no longer running. The event value field will contain one of the following:
CTA_REASON_RELEASED
The call was terminated.
CTA_REASON_STOPPED
The function was stopped by adiStopMFDetector.
CTAERR_xxx or ADIERR_xxx
The DTMF detector failed.
ADIEVN_MF_DIGIT_BEGIN
ADIEVN_MF_DIGIT_END

DSP File

For most AG hardware, this function requires that mf.dsp has been loaded. On AG 2000 boards and AG 4000/C boards, mf.m54 must be loaded to the board before adiStartMFDetector will work.
On CG 6000C boards mf.f54 must be loaded to the board before adiStartMFDetector will work. Refer to the board-specific installation and developer's manual for a table of MIPS usage for all functions.
For QX hardware, this function is supported in the standard DSP file. Refer to the QX Installation and Developer's Manual for a table of MIPS usage for all functions.

Details

This function enables detection of MFs (Multi Frequency tones). The function can be stopped by calling adiStopMFDetector.
Note that you need to disable DTMF detection (adiStopDTMFDetector) before initiating MF detection, as there are some overlapping frequency ranges in which both a DTMF and an MF event will be reported. Likewise, when the application is finished with MF detection, make sure to re-enable DTMF detection (adiStartDTMFDetector) if DTMFs are desired.
ADIEVN_MFDIGIT_BEGIN and ADIEVN_MFDIGIT_END events are generated for every MF tone detected. Each event contains an ASCII representation (character) of the MF digit, in the event value field.
This table describes the MF frequencies for each mftype, along with the digit value returned in the event's value field:

Digit

US MF

ITU Forward

ITU Backward

1

700,900

1380,1500

1140,1020

2

700,1100

1380,1620

1140,900

3

900,1100

1500,1620

1020,900

4

700,1300

1380,1740

1140,780

5

900,1300

1500,1740

1020,780

6

1100,1300

1620,1740

900,780

7

700,1500

1380,1860

1140,660

8

900,1500

1500,1860

1020,660

9

1100,1500

1620,1860

900,660

0

1300,1500

1740,1860

780,660

B

700,1700

1380,1980

1140,540

C

900,1700

1500,1980

1020,540

D

1100,1700

1620,1980

900,540

E

1300,1700

1740,1980

780,540

F

1500,1700

1860,1980

660,540
Note the mapping to the U.S. MF names: Digit U.S. MF Name 0 to 9 Specific digit address. B MF ST3P C MF STP D MF KP E MF KP2, MF ST2P F MF ST Note: The digit values are the same as those used by adiPlaceCall, adiStartDTMF, and adiStartDial, when MF digits are being dialed.

See Also

adiStopMFDetector, adiStopDTMFDetector, adiStartDTMFDetector

Table of Contents

Index

NMS Glossary

Previous Page

Next Page

(Page 40 of 69 in this chapter) Version

Want to send us feedback on our documentation? Email: Tech_Pubs@nmss.com

Copyright © 2000, Natural MicroSystems, Inc. All rights reserved.