(Page 4 of 4 in this chapter)
Trunk Control Program Parameters
The following tables are Trunk Control Program (TCP) parameters. They are used with
adiStartProtocol
. Their use depends on the first three letters of the TCP selected (e.g., category ADI.DID is used with
did0.tcp
).
ADI.DID
Dependent Protocol(s): DID0 For AG-8 or AG-T1 or DTI with AG24-60
Field Name
Type
Default
Units
Description
busyofftime
WORD
500
ms
The length of the silent interval between generated slow busy tones.
busyontime
WORD
500
ms
The length of each generated slow busy tone.
defaulttone
WORD
2
integer
The default tone to play if the PC does not respond to an incoming call indication (see waitforPCtime).
Value Definition
0 Reorder (fast busy)
1 Ringing
2 Busy
detectmode
WORD
0
integer
Type of incoming address signaling: 0 = DTMF and dial pulse; 2 = MF.
mfflags
WORD
3
mask
Mask that controls behavior when using MF signaling. A value may be formed by ORing any of the following:
Value Definition
1 Begin with KP tone
2 End with ST tone
numdigits
WORD
3
count
The expected number of digits for incoming calls.
prewinktime
WORD
100
ms
The amount of delay after incoming seizure is detected and before the start of the wink.
qualaddroff
WORD
50
ms
Deglitch time for off-hook to on-hook transitions during call set-up.
qualaddron
WORD
50
ms
Deglitch time for on-hook to off-hook transitions.
qualdisconnect
WORD
150
ms
Deglitch time for off-hook to on-hook transitions after address signaling is completed.
qualpermsignal
WORD
60000
ms
Maximum time for remote end to remain off hook when trunk is not in the conversation state before a permanent signal condition is detected. The valid range is 1-65535.
reorderofftime
WORD
250
ms
The length of the silent interval between generated reorder tones.
reorderontime
WORD
250
ms
The length of each generated reorder (fast busy) tone.
reserved
WORD
0
ms
Reserved.
ringofftime
WORD
3000
ms
The length of the silent interval between generated ring tones.
ringontime
WORD
1000
ms
The length of each generated ring tone.
wait1stdigittime
WORD
7000
ms
The maximum time to wait for the first incoming digit after the completion of the wink.
waitfordigitstime
WORD
8000
ms
The maximum time to wait for each incoming digit after the first one.
waitforPCtime
WORD
10000
ms
The maximum time to wait for the PC to respond to an incoming call indication before playing a default tone (see defaulttone).
winktime
WORD
200
ms
For incoming calls, the duration of the generated wink. Set this to 0 for no wink. Set to 0xffff for 350+440 Hz dial tone to be generated.
ADI.FDI
Dependent Protocol(s): FDI0 For AG-8/DID, Feature Group D
Field Name
Type
Default
Units
Description
busyofftime
WORD
500
ms
Busy tone OFF time.
busyontime
WORD
500
ms
Busy tone ON time.
defaulttone
WORD
2
n/a
Default tone if PC does not respond:
Value Definition
0 Reorder (fast busy)
1 Ringing
2 Busy
detectmode
WORD
2
n/a
Method of detection:
Value Definition
0 DTMFs (and pulses)
1 Pulses (and DTMFs)
2 MFs (and pulses)
maxwinktime
WORD
4900
ms
Max duration of the wink .
mfflags
WORD
3
n/a
Mask for behavior when using MFs:
Value Definition
0x1 Begin with KP tone
0x2 End with ST tone (inbound only)
mfkpstofftime
WORD
80
ms
Duration of MF KP,ST off time.
mfkpstampl
WORD
352
dB
Amplitude of MF KP,ST.
mfkpstontime
WORD
80
ms
Duration of MF KP,ST on time.
minwinktime
WORD
100
ms
Min duration of the wink.
numdigits
WORD
12
integer
Expected number of digits.
preanswertime
WORD
100
ms
Duration before answering call.
predialtime
WORD
70
ms
Post wink/pre-dial delay.
prewinktime
WORD
100
ms
Pre-wink delay.
qualaddroff
WORD
50
ms
qual dur. OFF during addressing.
qualaddron
WORD
50
ms
qual dur. ON during addressing.
qualdisconnect
WORD
150
ms
qual dur. of disconnect.
qualpermsignal
WORD
60000
ms
qual dur. of permanent signal.
releaseguardtime
WORD
1000
ms
Duration before next call.
reorderontime
WORD
250
ms
Reorder tone ON.
reorderofftime
WORD
250
ms
Reorder tone OFF.
reserved
WORD
0
n/a
Do not modify.
ringofftime
WORD
3000
ms
Ring tone OFF time.
size
DWORD
60
bytes
Size of this structure.
wait1stdigittime
WORD
7000
ms
Duration to wait for first digit.
waitfordigitstime
WORD
8000
ms
Duration to wait for nth digit (outbound only).
waitforPCtime
WORD
10000
ms
Duration to wait for PC to respond.
winktime
WORD
200
ms
Duration of the wink.
winkwaittime
WORD
10000
ms
Max time to wait for the wink.
ADI.GST
Dependent Protocol(s): GST8 AG-T1, digital ground-start (OPS-FX)
GST9 AG-T1, digital ground-start (OPS-SA)
Field Name
Type
Default
Units
Description
cidsupport
WORD
0
n/a
Indicates if caller ID is supported:
Value Definition
0 CID disabled
1 CID enabled
cleardownflag
WORD
1
n/a
Indicates if cleardown is supported:
Value Definition
0 Cleardown disabled
1 Cleardown enabled
dialtonemintime
WORD
1000
ms
For outgoing calls, the minimum duration of non-precise dial tone required before dialing will begin. Set this to 0 to disable non-precise dial tone detection. (Precise dial tone detection is controlled by ADISTART parameters).
dialtonewaittime
WORD
5000
ms
For outgoing calls, the maximum time to wait for initial dial tone.
freqdeglitchtime
WORD
26
count
For frequency-selective ring detection, deglitch time in 1/8 ms. Range is 2 - 80 (.25 to 10 ms).
freqringhigh
WORD
54
Hz
For frequency-selective ring detection, the maximum frequency recognized.
freqringlow
WORD
16
Hz
For frequency-selective ring detection, the minimum frequency recognized.
freqringperiods
WORD
4
count
For frequency-selective ring detection, number of periods of the ring frequency needed to qualify. Range is 1 - 8.
freqtolerance
WORD
10
percent
For frequency-selective ring detection, frequency tolerance in percent.
interringmaxtime
WORD
8000
ms
The maximum length of an incoming ring period (on time + off time) that can elapse before the call is considered to be abandoned.
nodialtoneaction
WORD
0
n/a
Selects what to do if no dial tone detected:
Value Definition
0 Hang up and abandon the call
1 Proceed to dial anyway
2 Generate an incoming call event
numrings
WORD
0
count
Number of rings to detect for an incoming call:
Value Definition
0 1st ring begin
1 1st ring end
n after n rings
Note that if caller ID is enabled (cidsupport = 1) then the incoming call is reported after at least one ring.
qualloopoff
WORD
10
ms
Minimum duration of loop current interruption before a hang-up will be recognized.
qualringoff
WORD
100
ms
For voltage-sensitive ring detection, the minimum duration of loss of detected voltage to be recognized as the end of a ringing signal.
qualringon
WORD
6
ms
For voltage-sensitive ring detection, the minimum duration of detected voltage to be recognized as the start of a ringing signal.
releaseguardtime
WORD
1000
ms
Minimum time between hang up & off hook.
reversalmode
WORD
0
n/a
Meaning of a loop current reversal:
Value Definition
0 No loop current reversal
1 Reversal indicates remote answer
2 Reversal indicates remote hang-up
3 Reversal indicates answer
and hang up
ringdetectmode
WORD
0
n/a
Selects whether the ring detector is voltage-sensitive or frequency-selective:
Value Definition
0 Voltage-sensitive
1 Frequency-selective.
ringsigmintime
WORD
100
ms
Inbound minimum ring time (+qual).
ringsigmaxtime
WORD
3000
ms
Inbound maximum ring time (+qual).
size
DWORD
48
bytes
Size of this structure.
xfersupport
WORD
1
n/a
Flag to select whether PBX transfer is allowed.
Value Definition
0 Transfer commands are disabled
1 Transfer commands are allowed
ADI.LPS
Dependent Protocol(s): LPS0 For AG-8 or ATI with AG-24-60
LPS8 For AG-T1, digital loop-start (OPS-FX).
LPS9 For AG-T1, digital loop-start (OPS-SA)
Field Name
Type
Default
Units
Description
cidsupport
WORD
0
mask
Flag to enable caller ID detection:
Value Definition
0 No caller ID detection
1 Caller ID detection enabled
Your AG configuration file must include the DSP file
adsir.dsp
when caller ID is enabled.
cleardownflag
WORD
1
mask
Selects whether to run the cleardown tone detector in the conversation state.
Value Definition
1 Cleardown enabled
0 Not enabled
dialtonemintime
WORD
1000
ms
For outgoing calls, the minimum duration of non-precise dial tone required before dialing will begin. Set this to 0 to disable non-precise dial tone detection. (Precise dial tone detection is controlled by ADISTART parameters).
dialtonewaittime
WORD
5000
ms
For outgoing calls, the maximum time to wait for initial dial tone.
freqdeglitchtime
WORD
26
count
For frequency-selective ring detection, deglitch time in 1/8 ms. Range is 2 - 80 (.25 to 10 ms).
freqringhigh
WORD
54
Hz
For frequency-selective ring detection, the maximum frequency recognized.
freqringlow
WORD
16
Hz
For frequency-selective ring detection, the minimum frequency recognized.
freqringperiods
WORD
4
count
For frequency-selective ring detection, number of periods of the ring frequency needed to qualify. Range is 1 - 8.
freqtolerance
WORD
10
percent
For frequency-selective ring detection, frequency tolerance in percent.
interringmaxtime
WORD
8000
ms
The maximum length of an incoming ring period (on time + off time) that can elapse before the call is considered to be abandoned.
nodialtoneaction
WORD
0
integer
Selects what to do if no dial tone detected:
Value Definition
0 Hang up and abandon the call
1 Proceed to dial anyway
2 Generate an incoming call event
numrings
WORD
0
count
Number of rings to detect for an incoming call. If 0, generate incoming call event on beginning of first ring, otherwise send the event at the end of the selected number of rings. Note that if caller ID is enabled (cidsupport = 1) then the incoming call is reported after at least one ring.
qualloopoff
WORD
10
ms
Minimum duration of loop current interruption before a hang-up will be recognized.
qualringoff
WORD
100
ms
For voltage-sensitive ring detection, the minimum duration of loss of detected voltage to be recognized as the end of a ringing signal.
qualringon
WORD
6
ms
For voltage-sensitive ring detection, the minimum duration of detected voltage to be recognized as the start of a ringing signal.
ringdetectmode
WORD
0
mask
Selects whether the ring detector is voltage-sensitive or frequency-selective:
Value Definition
0 Voltage-sensitive
1 Frequency-selective.
ringsigmaxtime
WORD
3000
ms
The maximum duration of a detected incoming ringing signal before the ringing is considered to be invalidly long.
ringsigmintime
WORD
100
ms
The minimum duration of a detected ring signal before the ring signal is considered valid.
xfersupport
WORD
1
mask
Flag to select whether PBX transfer is allowed.
Value Definition
0 Transfer commands are disabled
1 Transfer commands are allowed
ADI.OGT
Dependent Protocol(s): OGT0 Outgoing only wink-start for an AG-T1 or DTI with AG24-60.
Field Name
Type
Default
Units
Description
maxwinktime
WORD
4900
ms
The maximum duration of a detected wink before a "stuck sender" condition is detected.
mfflags
WORD
3
mask
Mask that controls behavior when using MF signaling. A value may be formed by ORing any of the following:
Value Behavior
1 Begin with KP tone
2 End with ST tone
Set adistart.dial.method =2 so that
adiPlaceCall
uses MF digits.
mfkpstampl
WORD
352
internal
Reserved - do not modify.
mfkpstofftime
WORD
80
ms
Duration of tone off for MF KP and ST.
mfkpstontime
WORD
80
ms
Duration of tone on for MF KP and ST.
minwinktime
WORD
100
ms
The minimum duration of a detected wink.
predialtime
WORD
70
ms
The amount of time to delay the start of outgoing address signaling after end of wink is detected.
qualaddroff
WORD
50
ms
Deglitch time for off-hook to on-hook transitions during call setup.
qualaddron
WORD
50
ms
Deglitch time for on-hook to off-hook transitions.
qualdisconnect
WORD
150
ms
Deglitch time for off-hook to on-hook transitions after address signaling is completed.
qualpermsignal
WORD
60000
ms
Maximum time for remote end to remain off hook when trunk is not in the conversation state before a permanent signal condition is detected. Valid range is 1-65535.
releaseguardtime
WORD
1000
ms
Minimum on-hook interval between calls.
reserved
WORD
0
ms
Reserved.
winkwaittime
WORD
10000
ms
The maximum time to wait for the far end to wink. Set this to 0 if no wink is expected.
ADI.WNK
Dependent Protocol(s): WNK0: 2-way wink start for T1
WNK1: 2-way wink start for AG-8 E&M
Field Name
Type
Default
Units
Description
busyofftime
WORD
500
ms
The length of the silent interval between generated slow busy tones.
busyontime
WORD
500
ms
The length of each generated slow busy tone.
defaulttone
WORD
2
integer
The default tone to play if the PC does not respond to an incoming call indication (see waitforPCtime).
Value Definition
0 Reorder (fast busy)
1 Ringing
2 Busy
detectmode
WORD
0
integer
Type of incoming address signaling:
Value Definition
0 DTMF and dial pulse
2 MF
maxwinktime
WORD
4900
ms
The maximum duration of a detected wink before a "stuck sender" condition is detected.
mfflags
WORD
3
mask
Mask that controls behavior when using MF signaling. Set adistart.dial.method =2 so that
adiPlaceCall
uses MF digits. A value may be formed by ORing any of the following:
Value Definition
1 Begin with KP tone
2 End with ST tone
mfkpstampl
WORD
352
internal
Reserved - do not modify.
mfkpstofftime
WORD
80
ms
Duration of tone off for MF KP and ST.
mfkpstontime
WORD
80
ms
Duration of tone on for MF KP and ST.
minwinktime
WORD
100
ms
The minimum duration of a detected wink.
numdigits
WORD
3
count
The expected number of digits for incoming calls.
predialtime
WORD
70
ms
The amount of time to delay the start of outgoing address signaling after end of wink is detected.
prewinktime
WORD
100
ms
The amount of delay after incoming seizure is detected and before the start of the wink.
qualaddroff
WORD
50
ms
Deglitch time for off-hook to on-hook transitions during call set-up.
qualaddron
WORD
50
ms
Deglitch time for on-hook to off-hook transitions.
qualdisconnect
WORD
150
ms
Deglitch time for off-hook to on-hook transitions after address signaling is completed.
qualpermsignal
WORD
60000
ms
Maximum time for remote end to remain off hook when trunk is not in the conversation state before a permanent signal condition is detected. Valid range is 1-65535.
releaseguardtime
WORD
1000
ms
Minimum on-hook internal between calls.
reorderofftime
WORD
250
ms
The length of the silent interval between generated reorder tones.
reorderontime
WORD
250
ms
The length of each generated reorder (fast busy) tone.
reserved
WORD
0
ms
Reserved.
ringofftime
WORD
3000
ms
The length of the silent interval between generated ring tones.
ringontime
WORD
1000
ms
The length of each generated ring tone.
wait1stdigittime
WORD
7000
ms
The maximum time to wait for the first incoming digit after the completion of the wink.
waitfordigitstime
WORD
8000
ms
The maximum time to wait for each incoming digit after the first one.
waitforPCtime
WORD
10000
ms
The maximum time to wait for the PC to respond to an incoming call indication before playing a default tone (see defaulttone).
winktime
WORD
200
ms
For incoming calls, the duration of the generated wink. Set this to 0 for no wink. Set to 0xffff for 350+440 Hz dial tone to be generated.
winkwaittime
WORD
10000
ms
The maximum time to wait for the far end to wink for an outgoing call. Set this to 0 if no wink is expected.
(Page 4 of 4 in this chapter)
Tech_Support@nmss.com
Copyright © 1996, Natural MicroSystems, Inc. All rights reserved.