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