NCC.X.ADI_START

Dependent function: nccStartProtocol

Note: All field names in this structure are prefaced with NCC.X.ADI_START; for example, NCC.X.ADI_START.mediamask.

Field name

Type

Default

Units

Description

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 cancelation. See callctl.mediamask valid values.

debugmask

DWORD

0x0000

mask

Not applicable.

protocoldebugmask

DWORD

0x0000

mask

Not used.

dial.method

DWORD

0

mask

Not applicable.

dial.breaktime

DWORD

60

ms

Not applicable.

dial.maketime

DWORD

40

ms

Not applicable.

dial.interpulse

DWORD

700

ms

Not applicable.

dial.flashtime

DWORD

500

ms

Not applicable.

dial.shortpause

DWORD

2000

ms

Not applicable.

dial.longpause

DWORD

5000

ms

Not applicable.

dial.dtmfampl1

INT32

-6

dBm

Not applicable.

dial.dtmfampl2

INT32

-4

dBm

Not applicable.

dial.dtmfontime

DWORD

80

ms

Not applicable.

dial.dtmfofftime

DWORD

80

ms

Not applicable.

dial.dialtonewait

DWORD

5000

ms

Not applicable.

dial.tonefreq1

DWORD

350

Hz

Not applicable.

dial.tonebandw1

DWORD

40

Hz

Not applicable.

dial.tonefreq2

DWORD

440

Hz

Not applicable.

tonebandw2

DWORD

40

Hz

Not applicable.

dial.tonequalampl

INT32

-28

dBm

Not applicable.

dial.tonequaltime

DWORD

50

ms

Not applicable.

dial.tonereflevel

DWORD

0xB000

IDU

Not applicable.

dial.reserved

DWORD

0

internal

Not applicable.

dial.tonetotaltime

DWORD

0

ms

Total time for which the interrupted dialtone must be present. Valid values are:

0: Does not detect an interrupted dialtone.

n (where n is 1 or higher): Detects an interrupted dialtone that is present for at least n ms.

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.onqualampl

INT32

-39

dBm

Minimum signal level recognized as a DTMF signal. Valid range is -51 through -15.

dtmfdet.onthreshold

DWORD

0xCAB0

IDU

Do not modify.

dtmfdet.onqualtime

DWORD

50

ms

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

Valid range is 22 through 32767.

dtmfdet.offqualampl

INT32

-45

dBm

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

Valid range is -51 through 15.

dtmfdet.offthreshold

DWORD

0x92E0

IDU

Do not modify.

dtmfdet.offqualtime

DWORD

40

ms

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

Valid range is 5 through 32767.

echocancel.mode

DWORD

0

Bit field

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

0 = No echo cancelation.

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.filterlength

DWORD

0

ms

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

echocancel.adapttime

DWORD

0

ms

Echo canceler adaptation time for echocancel.mode = 2 . Valid  range is 100 through 1000. Lower values require more DSP processing power.

echocancel.gain

INT32

0

dB

Amount of amplification applied to echo-canceled output. Valid range is -54 through 24.

echocancel.predelay

DWORD

0

ms

Output sample delay. Valid range is 0 through 9.

Valid range is 0 through 20.

cleardown.freq1

DWORD

350

Hz

Not applicable.

cleardown.bandw1

DWORD

40

Hz

Not applicable.

ceardown.freq2

DWORD

440

Hz

Not applicable.

cleardown.bandw2

DWORD

40

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.minontime

DWORD

0

ms

Not applicable.

cleardown.maxontime

DWORD

0

ms

Not applicable.

cleardown.minofftime

DWORD

0

ms

Not applicable.

cleardown.maxofftime

DWORD

0

ms

Not applicable.

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 canceler.

echocancel.mode valid values

Value

Description

0x0004

Not applicable.

0x0008

Enable echo suppressor.

0x0010

Do not reset echo canceler.

0x0020

Disable filter taps adaptation.

0x0040

Bypass echo cancelation.

0x0080

Request status of echo canceler.

0x0100

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

0x0200

Enable comfort noise generation.