- ADI.START
|
|---|
|
Dependent Function(s): adiStartProtocol
|
|---|
|
Field Name
|
Type
|
Default
|
Units
|
Description
|
|---|
|
callctl.blockmode
|
DWORD
|
0
|
mask
|
Selects method of blocking calls for adiBlockCalls. 0 = do not answer subsequent calls. 1 = assert reverse make-busy (after current call is released). Only method 0 is available for QX boards.
|
|
callctl.debugmask
|
DWORD
|
0x0000
|
mask
|
Enables reporting of call control events for debugging. A value may be formed by ORing any of the following:
Value Event(s) reported
1 Each incoming digit 2 Each incoming ring begin and end 4 Each ring tone detected 8 All CID errors
|
|
callctl.eventmask
|
DWORD
|
0x0000
|
mask
|
Controls reporting of informational call control events. A value may be formed by ORing any of the following bit masks:
Value Event reported
1 ADIEVN_SEIZURE_DETECTED 2 ADIEVN_PROCEEDING 4 ADIEVN_REMOTE_ALERTING 8 ADIEVN_REMOTE_ANSWERED
|
|
callctl.mediamask
|
DWORD
|
0x001F
|
mask
|
Controls which functions will be running or reserved when the call enters the Connected (conversation) state. (The NOCC protocol enters this state immediately). Reserved indicates that the DSP MIPS have been committed to the operation before the operation has actually started. The application must reserve DSP resources in advance by using this parameter for DTMF detection, silence detection, cleardown detection, and echo cancellation.
A value may be formed by ORing any of the following:
Value Definition
0x0001 Reserve DTMF detection (Not used for QX 2000)
0x0002 Reserve silence detector (Not used for QX 2000)
0x0004 Reserve cleardown detection (Not used for QX 2000)
0x0008 Start DTMF detection
0x0010 Start echo canceller
|
|
cleardown.bandw1
|
DWORD
|
40
|
Hz
|
Bandwidth for first frequency of the cleardown detector. Valid range is 20-800.
|
|
cleardown.bandw2
|
DWORD
|
40
|
Hz
|
Bandwidth for second frequency. Valid range is 20-800.
|
|
cleardown.freq1
|
DWORD
|
350
|
Hz
|
First frequency to detect. Valid range is 1-4000.
|
|
cleardown.freq2
|
DWORD
|
440
|
Hz
|
Second frequency to detect, or 0 if detecting single frequency. Valid range is 1-4000.
|
|
cleardown.maxofftime
|
DWORD
|
0
|
ms
|
Maximum time tone may be OFF to qualify. For continuous tones, this parameter is ignored. For cadenced tones, the count is reset if the interval between any two tones is longer than this time. Valid range is 0-32767.
|
|
cleardown.maxontime
|
DWORD
|
0
|
ms
|
Maximum time tone must be ON to qualify. For continuous tones, this parameter is ignored. For cadenced tones, the count is reset if any tone is longer than this time. Valid range is 0-32767.
|
|
cleardown.minofftime
|
DWORD
|
0
|
ms
|
Minimum time tone must be OFF to qualify. For continuous tones, this parameter is ignored. For cadenced tones, the count is reset if the interval between any two tones is shorter than this time. Valid range is 0-32767.
|
|
cleardown.minontime
|
DWORD
|
0
|
ms
|
Minimum time tone must be ON to qualify. For continuous tones, this parameter is ignored. For cadenced tones, the count is reset if any tone is shorter than this time. Valid range is 0-32767.
|
|
cleardown.qualampl
|
INT32
|
-28
|
dBm
|
The minimum signal level recognized as a hang-up tone. Valid range is -48 to 0.
|
|
cleardown.qualtime
|
DWORD
|
1000
|
ms
|
The minimum duration of tone before a hang-up will be recognized. The valid range is 0-32767.
|
|
cleardown.reflevel
|
DWORD
|
0xB000
|
IDU
|
Do not modify. Not used for QX 2000 boards.
|
|
cleardown.reserved
|
DWORD
|
0
|
internal
|
Do not modify.
|
|
cleardown.tonecount
|
DWORD
|
0
|
integer
|
Minimum number of cadenced tones detected before reporting the cleardown event. For continuous tones, set this parameter to 0.
|
|
dial.breaktime
|
DWORD
|
60
|
ms
|
The break (on-hook) duration for dial pulses. Valid range is 0-32767.
|
|
dial.dialtonewait
|
DWORD
|
5000
|
ms
|
The maximum time to wait for dial tone (applies only to the ';' character). Valid range is 0-65535.
|
|
dial.dtmfampl1
|
INT32
|
-6
|
dBm
|
The amplitude of the low frequency component of the DTMF pair. Valid range is -90 to 0.
|
|
dial.dtmfampl2
|
INT32
|
-4
|
dBm
|
The amplitude of the high frequency component of the DTMF pair. Valid range is -90 to 0.
|
|
dial.dtmfofftime
|
DWORD
|
80
|
ms
|
The duration of the silence time between each digit. Valid range is 0-2047.
|
|
dial.dtmfontime
|
DWORD
|
80
|
ms
|
The duration of each DTMF or MF digit. Valid range is 0-2047.
|
|
dial.flashtime
|
DWORD
|
500
|
ms
|
The amount of time to assert the on-hook signaling pattern for a flash ('!' character). Valid range is 0-32767.
|
|
dial.interpulse
|
DWORD
|
700
|
ms
|
The inter-digit time for pulsed dialing. Valid range is 0-32767.
|
|
dial.longpause
|
DWORD
|
5000
|
ms
|
The amount of delay associated with the '.' (period) character. Valid range is 0-65535.
|
|
dial.maketime
|
DWORD
|
40
|
ms
|
The make (off-hook) duration for dial pulses. Valid range is 0-32767.
|
|
dial.method
|
DWORD
|
0
|
integer
|
Type of signaling: 0 = DTMF, 1 = Pulse
|
|
dial.reserved
|
DWORD
|
0
|
internal
|
Do not modify.
|
|
dial.shortpause
|
DWORD
|
2000
|
ms
|
The amount of delay associated with the ',' (comma) character. Valid range is 0-65535.
|
|
dial.tonebandw1
|
DWORD
|
40
|
Hz
|
Bandwidth of the first frequency of the dial tone detector. Valid range is 40-2000.
|
|
dial.tonebandw2
|
DWORD
|
40
|
Hz
|
Bandwidth of the second frequency of the dial tone detector. Valid range is 40-2000.
|
|
dial.tonefreq1
|
DWORD
|
350
|
Hz
|
First (or only) dial tone frequency. Valid range is 1-4000.
|
|
dial.tonefreq2
|
DWORD
|
440
|
Hz
|
Second dial tone frequency. Set this to 0 to detect a single frequency. Valid range is 1-4000.
|
|
dial.tonequalampl
|
INT32
|
-28
|
dBm
|
Minimum broadband signal amplitude to qualify for dial tone detection. Valid range is -48 to 0.
|
|
dial.tonequaltime
|
DWORD
|
50
|
ms
|
Minimum duration of a qualified tone to be considered dial tone. Valid range is 0-32767.
|
|
dial.tonereflevel
|
DWORD
|
0xB000
|
IDU
|
Do not modify. Not used for QX 2000 boards.
|
|
dtmfdet.columnfour
|
DWORD
|
1
|
|
Indicates whether to detect the A, B, C, and D DTMF digits. Set this to 1 to detect the digits, or to 0 to ignore them.
|
|
dtmfdet.offqualampl
|
INT32
|
-45
|
dBm
|
Not used for QX 2000 boards.
|
|
dtmfdet.offqualtime
|
DWORD
|
40
|
ms
|
The minimum duration of absence of a recognized DTMF signal before an end-of-digit event will be emitted. Valid range is 30-32766.
|
|
dtmfdet.offthreshold
|
DWORD
|
0x92E0
|
IDU
|
Do not modify. Not used for QX 2000 boards.
|
|
dtmfdet.onqualampl
|
INT32
|
-39
|
dBm
|
Not used for QX 2000 boards.
|
|
dtmfdet.onqualtime
|
DWORD
|
50
|
ms
|
The minimum duration of a recognized DTMF signal before a digit event will be emitted. The valid range is 30-32766.
|
|
dtmfdet.onthreshold
|
DWORD
|
0xCAB0
|
IDU
|
Do not modify. Not used for QX 2000 boards.
|
|
echocancel.adapttime
|
DWORD
|
0
|
ms
|
Not used for QX 2000 boards.
|
|
echocancel.filterlength
|
DWORD
|
0
|
ms
|
Filter length of echo canceller for MODE = 2. Set this to 0 to omit echo cancelling. Valid range is 0-20. Greater values require more DSP processing power.
|
|
echocancel.gain
|
INT32
|
0
|
dB
|
Amount of amplification applied to echo-cancelled output. Done by AGC module for QX 2000.
|
|
echocancel.mode
|
DWORD
|
0
|
bit field
|
Controls echo canceller operation.
Bit Definition 0 and 1 0 = No echo cancellation. (&0x0003) 1 = Use internal defaults for predelay and filterlength. (predelay=0 ms filterlength=20ms for QX board) 2 = Use specified values for predelay and filterlength. 3 = Not used. 2 (&0x0004) 1 = Enable dynamic windowing. 0 = Disable dynamic windowing. 3 (&0x0008) 1 = Enable echo supressor. 0 = Disable echo supressor. 4 (&0x0010) 1 = Do not restart echo cancel. 0 = Restart echo canceller. 5 (&0x0020) 1 = Disable coefficient adaptation. 0 = Enable coefficient adaptation.
|
|
echocancel.predelay
|
DWORD
|
0
|
ms
|
Output sample delay. 0 = disabled, no echo cancellation. For AG-8 boards, must be 0. For other boards, valid range is 0-9.
|