ADI_START_PARMS

Dependent function: adiStartProtocol

Field name

Type

Default

Units

Description

callctl.blockmode

DWORD

0

mask

Not applicable.

callctl.debugmask

DWORD

0x0000

mask

Not applicable.

callctl.eventmask

DWORD

0x0000

mask

Not applicable.

callctl.mediamask

DWORD

0x001F

mask

Controls which functions are running or reserved when the call enters the connected (conversation) state. (The NOCC protocol enters this state immediately). Reserved indicates that the DSP MIPS are committed to the operation before the operation actually starts. The application must reserve DSP resources in advance by using this parameter for DTMF detection, silence detection, cleardown detection, and echo cancellation. See callctl.mediamask valid values.

cleardown.bandw1

DWORD

40

Hz

Not applicable.

cleardown.bandw2

DWORD

40

Hz

Not applicable.

cleardown.freq1

DWORD

350

Hz

Not applicable.

cleardown.freq2

DWORD

440

Hz

Not applicable.

cleardown.qualampl

INT32

-28

dBm

Not applicable.

cleardown.qualtime

DWORD

1000

ms

Not applicable.

cleardown.reflevel

DWORD

0xB000

IDU

Not applicable.

cleardown.reserved

DWORD

0

internal

Not applicable.

cleardown.tonecount

DWORD

0

integer

Not applicable.

cleardown.maxofftime

DWORD

0

ms

Not applicable.

cleardown.maxontime

DWORD

0

ms

Not applicable.

cleardown.minofftime

DWORD

0

ms

Not applicable.

cleardown.minontime

DWORD

0

ms

Not applicable.

dial.breaktime

DWORD

60

ms

Not applicable.

dial.dialtonewait

DWORD

5000

ms

Not applicable.

dial.dtmfampl1

INT32

-6

dBm

Not applicable.

dial.dtmfampl2

INT32

-4

dBm

Not applicable.

dial.dtmfofftime

DWORD

80

ms

Not applicable.

dial.dtmfontime

DWORD

80

ms

Not applicable.

dial.flashtime

DWORD

500

ms

Not applicable.

dial.interpulse

DWORD

700

ms

Not applicable.

dial.longpause

DWORD

5000

ms

Not applicable.

dial.maketime

DWORD

40

ms

Not applicable.

dial.method

DWORD

0

mask

Not applicable.

dial.reserved

DWORD

0

internal

Not applicable.

dial.shortpause

DWORD

2000

ms

Not applicable.

dial.tonebandw1

DWORD

40

Hz

Not applicable.

dial.tonebandw2

DWORD

40

Hz

Not applicable.

dial.tonefreq1

DWORD

350

Hz

Not applicable.

dial.tonefreq2

DWORD

440

Hz

Not applicable.

dial.tonequalampl

INT32

-28

dBm

Not applicable.

dial.tonequaltime

DWORD

50

ms

Not applicable.

dial.tonereflevel

DWORD

0xB000

IDU

Not applicable.

dtmfdet.columnfour

DWORD

1

 

Flag that indicates whether to detect the A, B, C, and D DTMF digits. Set this value to 1 to detect these digits, or 0 to ignore them.

dtmfdet.offqualampl

INT32

-45

dBm

Minimum signal required to maintain recognition of a DTMF signal once recognition starts.

Valid AG board and CG board range is -51 through 15.

dtmfdet.offqualtime

DWORD

40

ms

Minimum duration of absence of a recognized DTMF signal before an end-of-digit event is emitted.

Valid AG board and CG board range is 5 through 32767.

dtmfdet.offthreshold

DWORD

0x92E0

IDU

Do not modify.

dtmfdet.onqualampl

INT32

-39

dBm

Minimum signal level recognized as a DTMF signal.

Valid AG board and CG board range is -51 through -15.

dtmfdet.onqualtime

DWORD

50

ms

Minimum duration of a recognized DTMF signal before a digit event is emitted.

Valid AG board and CG board range is 22 through 32767.

dtmfdet.onthreshold

DWORD

0xCAB0

IDU

Do not modify.

echocancel.adapttime

DWORD

0

ms

Echo canceller adaptation time for echocancel.mode = 2 .

Valid AG board and CG board range is 100 through 1000. Lower values require more DSP processing power.

echocancel.filterlength

DWORD

0

ms

Filter length of echo canceller for echocancel.mode = 2. Set this value to 0 to omit echo cancelling. Valid range is 0 through 20. Higher values require more DSP processing power.

echocancel.gain

INT32

0

dB

Amount of amplification applied to echo-cancelled output. Valid AG board and CG board range is -54 through 24.

echocancel.mode

DWORD

0

Bit field

Controls echo canceller operation. Set the mode to one of the following:

  • 0 = No echo cancellation.

  • 1 = Use internal defaults for filter length and adaptation time based on board type.

  • 2 = Use specified values.

  • 3 = Ignore specified filterlength and adapttime values for adiModifyEchoCanceller only.

Additional values can be formed by using the OR operation. See echocancel.mode valid values.

echocancel.predelay

DWORD

0

ms

Output sample delay. Valid range is 0 through 9.

Valid AG board and CG board range is 0 through 20.

callctl.mediamask valid values

A value can be formed by using the OR operation with any of the following values:

Value

Description

0x0001

Reserve DTMF detector.

0x0002

Reserve silence detector.

0x0004

Reserve cleardown detector.

0x0008

Start DTMF detector.

0x0010

Start echo canceller.

echocancel.mode valid values

Value

Description

0x0008

Enable echo suppressor.

0x0010

Do not reset echo canceller.

0x0020

Disable filter taps adaptation.

0x0040

Bypass echo cancellation.

0x0080

Request status of echo canceller.

0x0100

Enable auto-status event generation when status of echo canceller changes.

0x0200

Enable comfort noise generation.