Setup guide

parameters of PSTN line, as well as for detecting and generating the tones
agc-on-playback (yes | no; default: no) - automatic gain control on playback (can not be used
together with hardware voice codecs)
agc-on-record (yes | no; default: no) - automatic gain control on record (can not be used together
with hardware voice codecs)
detect-cpt (yes | no; default: no) - automatically detect call progress tones
balance-registers (integer: 0..255; default: 199) - registers which depend on telephone line
impedance. Can be adjusted to get best echo cancellation. Should be changed only if echo
cancellation on voicetronix card does not work good enough. Echo cancellation problems can imply
DTMF and busy-tone detection failures. The value has to be in format bal1[,bal3[,bal2]], where
bal1, bal2, bal3 - balance registers. bal1 has to be in interval 192..248 (0xC0..0xF8). The others
should be in interval 0..255 (0x00..0xFF)
balance-status (read-only: integer; default: unknown) - shows quality of hardware echo
cancellation in dB
loop-drop-detection (yes | no; default: yes) - automatically clear call when loop drop is detected
Command Description
test-balance - current balance-registers value is tested once. Result is placed in balance-status
parameter. Balance can be tested only when line is off-hook. It won't work if line is on-hook or
there is an established connection (name) - port name to test balance of
find-best-balance - series of test-balance is executed with different balance-registers values.
During the tests balance-registers are updated to the best values found (name) - port name to find
best balance of
clear-call - terminate a current call established with the specified voice port (name) - port name to
clear call with
show-stats - show voice port statistics (name) - port name show statistics of (time) - maximal time
of packet round trip (integer) - number of packets sent by this card (these packets are digitalized
input of the voice port) (integer) - number of bytes sent by this card (these packets are digitalized
input of the voice port) (text) - minimal/average/maximal intervals between packets sent (integer) -
number of packets received by this card (these packets form analog output of the voice port)
(integer) - number of bytes received by this card (these packets form analog output of the voice
port) (text) - minimal/average/maximal intervals between packets received (time) - approximate
delay time from the moment of receiving an audio packet from the IP network till it is played back
over the telephony voice port. The value shown is never less than 30ms, although the actual delay
time could be less. If the shown value is >40ms, then it is close (+/-1ms) to the actual delay time.
monitor - monitor status of the voice port (name) - port name to monitor (on-hook | off-hook | ring |
connection | busy) - current state of the port:
• on-hook - the handset is on-hook, no activity
• off-hook - the handset is off-hook, the number is being dialed
• ring - call in progress, direction of the call is shown by the direction property
• connection - the connection has been established
• busy - the connection has been terminated, the handset is still off-hook
(ip-to-port | port-to-ip) - direction of the call
• ip-to-port - call from the IP network to the voice card
• port-to-ip - call from the voice card to an IP address
(integer) - the phone number being dialed (text) - name and IP address of the remote party (name) -