The Solwise Forum is designed to be the first port-of-call for technical support and sales advice for the
whole Solwise product range.
Please check the forum for coverage on any technical problems you have. Many people have
trodden your path before you, and a quick check on the forum will reduce the pressure on our support
staff.
Oct 10, 2003
Solwise Elite VoIP Gateway User’s Guide
Notification is hereby given that Solwise Ltd. reserves the right to modify, change, update or revise this
document from time to time as required without the prior obligation to notify any person, company or
organization. Further, Solwise makes no warranty or representation, either express or implied, with
respect to merchantability, or fitness of its products for a particular purpose.
All rights reserved. No part of this document may be reproduced in any form or by any means
without written permission from the product manufacturer.
Changes are periodically made to the information in this document. They will be incorporated in
subsequent editions. The product manufacturer may take improvement and/or changes in the
product described in this document at any time.
FCC compliance
This equipment complies with Part 68 of the FCC Rules. On this equipment is a label that contains,
among other information, the FCC registration number and Ringer Equivalence Number (REN) for this
equipment. You must, upon request, provide this information to your telephone company.
If your telephone equipment causes harm to the telephone network, the Telephone Company may
discontinue your service temporarily. If possible, they will notify in advance. But, if advance notice isn’t
practical, you will be notified as soon as possible. You will be informed of your right to file a complaint
with the FCC.
Your telephone company may make changes in its facilities, equipment, operations, or procedures
that could affect proper operation of your equipment. If they do, you will be notified in advance to give
you an opportunity to maintain uninterrupted telephone service. The FCC prohibits this equipment to
be connected to party lines or coin-telephone service.
In the event that this equipment should fail to operate properly, disconnect the equipment from the
phone line to determine if it is causing the problem. If the problem is with the equipment, discontinue
use and contact your dealer or vendor.
Before installing this equipment, users ensure that it is permissible to be connected to the facilities of
the local Telecommunications Company. The equipment must also be installed using an acceptable
method of connection. The customer should be aware that compliance with the above conditions
might not prevent degradation of service in some situations.
2
Solwise Elite VoIP Gateway User’s Guide
Repairs to certified equipment should be made by an authorized Canadian maintenance facility
designated by the supplier. Any repairs or alterations made by the user to this equipment, or
equipment malfunctions, may give the telecommunications company cause to request the user to
disconnect the equipment.
Users should ensure for their own protection that the electrical ground connections of the power utility,
telephone lines and internal metallic water pipe system, if present, are connected together. This
precaution may be particularly important in rural areas.
CAUTION: Users should not attempt to make such connections themselves, but should contact the
appropriate electric inspection authority, or electrician, as appropriate.
European CTR 21 compliance
The equipment has been approved in accordance with Council Decision 98/482/EC for pan-European
single terminal connection to the public switched telephone network (PSTN). However, due to
differences between the individual PSTNs provided in different countries, the approval does not, of
itself, give an unconditional assurance of successful operation on every PSTN network termination
point. In the event of problem, you should contact your equipment supplier in the first instance.
3
Table of Contents
1 Extra set-up notes for the Elite series
VoIP gateways ...............................................11
1.1 Using a ‘Wildcard’ phone number............................11
1.2 Clearing to defaults...................................................12
1.3 How can I set-up a ‘hotline’?....................................12
1.3.1 Lets give an example:.....................................12
1.4 How can I stop the gateways ‘playing’ the
DTMF tones when a call is received?.............................14
1.5 How can I configure the gateway to handle
the clear forward signal (caller disconnect) ....................14
1.5.1 So what does this mean? ...............................14
In order to accept incoming calls on your Elite gateway you must
first of all create a dial plan which has entries for each number that
your callers will use to contact you.
e.g. Consider a simple set-up consisting of two FXS gateways.
FXS1 end FXS2 end
Local Dial Plan Set-up
Phone Number 501 401
Hunt group 5 5
Destination ID 5 5
Local Destination Channel 0 0
Remote Dial Plan Set-up
Phone Number 401 501
Hunt Group 6 6
Destination ID 6 6
Remote Destination IP IP address of FXS2 gateway IP address of FXS1 gateway
Now in order for FXS gateway 1 to call FXS gateway 2 then it uses
the dial plan tel. Number 401. But this means that BOTH gateways
must have a defined dial plan entry for 401 (i.e. on for FXS1 which
tells it how to connect to FXS2 but also one for FXS2 to accept the
call to 401). This is fine if the calling party know that they have to
dial 401 to connect the FXS2 but what if you want to accept calls
from callers who don’t know that they have to use 401? The way
round this is to create a dial plan entry which uses “.” (i.e. ‘dot’) i.e.
FXS2 end
Local Dial Plan Set-up
Phone Number .
Hunt group 5
Destination ID 5
Local Destination Channel 0
Then FXS gateway 2 will accept ANY calls.
11
Solwise Elite VoIP Gateway User’s Guide
1.2 Clearing to defaults
In the GW's memory, there are 3 portions to record the different
setting values: network setting, atpm setting and configuration
(port,coding,h323 etc.).
You need to reset (erase) each section separately. After you’ve
erased it all you then re-boot the system and the defaults are
loaded.
Following are the commands:
for dialplan: 'atpm req', 'atpm erase'
for configuration: 'config erase' 'y'
for network: 'net set fac_default' 'y'
re-boot system
1.3 How can I set-up a ‘hotline’?
1.3.1 Lets give an example:
A hotline means that when an FXS or FXO port is picked up (i.e. a
handset connected to an FXS port is picked up or a PSTN call is
made to an FXO port) then the gateway will autodial to another
VoIP device.
To set this feature up you need to use the CLI command
set port <port> dial_in plar [plar number]
where [plar number] is a predefined dial plan phone number.
You have one site with an FXO device connected to four phone
lines.
At the other site you have a four port FXS device with handsets
plugged into each port.
So first of all, at each end, you need to create two dial plans: One is
a dial plan entry which pertains to the local port on the gateway. The
second dial plan entry is to connect to the gateway at the other end
(so, this remote destination is to connect to the local destination of
the other gateway).
12
e.g. (remember this is just an example, the actual numbers will differ
in your set-up)
Solwise Elite VoIP Gateway User’s Guide
FXO end FXS end
Local Dial Plan Set-up
Phone Number 501 401
Hunt group 5 5
Destination ID 5 5
Local Destination Channel 0 0
Remote Dial Plan Set-up
Phone Number 401 501
Hunt Group 6 6
Destination ID 6 6
Remote Destination IP IP address of FXS gateway IP address of FXO gateway
To test the dial plan pick up the handset on FXS port 1 and dial 501;
the call should connect to the first port of the FXO (so you should
hear the dial tone from the PSTN line connected to the first port of
the FXO). To test a call the other way make a call to the PSTN line
on the first port of the FXO gateway. When the call comes in the
FXO gateway will pickup the call and present a second dial tone.
You should then dial 401. This should make the call forward to the
phone on the first FXS port.
Now to make it do this automatically you need to use the CLI
command (connect via the serial port using a terminal application)
set port <port> dial_in plar [plar number]
So… at the CLI prompt for the FXO gateway you need to enter the
command
set port 0 dial_in plar 401
Then do
config activate
config store
to activate and store the settings.
Then, at the CLI prompt for the FXS gateway you need to enter the
command
13
Solwise Elite VoIP Gateway User’s Guide
set port 0 dial_in plar 501
Then do
config activate
config store
to activate and store the settings.
Now do the tests again but this time you shouldn’t have to do the
dialling; the gateways should auto-dial as expected.
1.4 How can I stop the gateways ‘playing’ the DTMF tones when a call is
received?
For example, when you make a call to an FXS device on let’s say
local telephone number 203 then, after you pick the ringing handset
up at the FXS end you hear the phone number ‘203’ DTMF tones
played. If you don’t want to hear these tones (they are sent because
some caller ID devices use the DTMF tones) then you need to
instruct the dialling end device to strip the sent numbers (in this
case it would be the first 3 digits). To do this go to the Telephone
number set-up at the dialling gateway and , on the screen you use
to configure the Telephone number enter 3 (in this example) in the
field called ‘Strip Length’.
1.5 How can I configure the gateway to handle the clear forward signal (caller
disconnect)
1.5.1 So what does this mean?
When you make a PSTN call from one site to another then, when
one party hangs up a signal sent to the other parties end to indicate
to the other party that the phone call is finished. This signal is called
the ‘clear forward signal’ or sometimes the ‘call disconnect signal’.
It’s used so that devices can tell when the call is finished e.g.
answering machines. In the UK the standard signal (as used by BT)
is to reverse the polarity of the phone lines. This is different from
other countries e.g. if you are in the States and the other party
hangs up then you get sent a tone. However, in the UK being
different we use a polarity reversal / Private telephone systems as
used by UK buisnesses may use polarity reversal or the tone
method. The particular method used will depend upon PBX system
used. To test which method your PBX uses make a call from one
extension to the other and then get the calling party to hangup.
Then listen to what you hear. Do you hear a tone?
14
Solwise Elite VoIP Gateway User’s Guide
1.5.2 So what’s this got to do with VoIP gateways?
Imagine you have a site-to-site set-up of an FXO gateway talking to
an FXS gateway. So there is a call in progress from a PSTN phone
line which is connected to the first port of the FXO gateway and
then across to the FXS gateway to a phone on the first FXS port.
Now, if the call to the FXO port hangs up then the FXO gateway
needs to know this. If it doesn’t know that the PSTN call is ended
then it keeps the VoIP call to the FXS gateway open! On the other
hand. If the call to the FXS port (lets say from a remote FXO or FXS
gateway) is ended the FXS gateway needs to send a ‘clear forward’
signal to the device on the FXS port to indicate the call is ended e.g.
this might me an answering machine. So, an FXO port needs to be
able to detect a correct clear forward’ from the PSTN line and an
FXS device needs to make the correct ‘clear forward’ signal for the
handset device (e.g. this might be an answering machine). This
could be either polarity reversal or disconnect tone.
1.5.3 So how do you configure the gateway to handle the polarity reversal then?
So, let’s assume that you need to configure the gateways to handle
the UK standard polarity reversal signal.
You need to use CLI commands to configure the ports.
For an FXS gateway key-in the command…
set port <port> fxs ff_batt_rev on
where <port> is port no (0-7) and the setting should be on.
For an FXO port device the commands are
set port <port> fxo cpc_detect <value in msec>
where <port> is port no (0-7) and <value in msec> is the time taken
for the polarity reversal. A typical value would be 30 i.e. it takes
30mS for the polarity reversal event.
You also need to key-in…
set port <port> fxo batt_rev_times <number of times>
this command is to define how many line reversals the FXO port
needs to receive before accepting the ‘clear forward’: In the UK this
value should be ‘2’.
Also,
set port <port> fxo loop_det_db <value in msec>
15
Solwise Elite VoIP Gateway User’s Guide
This is a value to ensure that false polarity reversals are not
detected. A good value is 20 (10 less then the cpc_detect value).
After entering the commands you need to do
config activate
config store
to activate and store the settings.
1.5.4 So how do you configure the gateway to a disconnect tone correctly then?
So, let’s assume that you need to configure the FXO gateways to
handle the US style tone disconnect signal.
By default your gateway automatically detects the disconnect tone
however it may need to be ‘tuned’ to correctly detect the specific
tone your system produces. I.e. the cadence (the tone might go
‘beep-pause-beep-pause’ so you need to tell the gateway the
duration of the ‘beep’ and the duration of the ‘pause’) and power
level (how loud it is).
The first stage is to tell your FXO gateway to analyse the disconnect
tone it receives on it’s FXO port.
The basic method it to set the gateway into debug mode (to display
the tone analysis) then make a call to the FXO gateway and then,
after the gateway has answered make a call from the gateway to
another port on the same gateway. After the forwarded call is
connected then you hang up. The gateway will then print out the
tones it detects. You then take these figures and enter them into the
gateway configuration.
1.5.4.1 Entering debug mode on the gateway
In console mode enter the following commands:
16
Solwise Elite VoIP Gateway User’s Guide
1.5.4.2 Wiring Up to do the test with an FXO/FXS gateway
In the example above the test procedure is going to be make a call
from phone 1234, through the PBX to the FXO port (number 1233).
If you are connecting the FXO port directly to a phone line then just
dial the phone line that the FXO port is connected to. Then, after the
FXO port has answered the call, dial number 101 which is the
phone connected to the FXS port. Thus you have a call from 1234
to 1233 and then to 101. Then, after the call is routed hang up
1234. You should then see tone detection results appear on the PC
terminal.
i.e.
17
Solwise Elite VoIP Gateway User’s Guide
18
Solwise Elite VoIP Gateway User’s Guide
1.5.4.3 Wiring Up to do the test with an FXO only gateway
In the example above the test procedure is going to be make a call
from phone 1234, through the PBX to the FXO port (number 1233).
If you are connecting the FXO port directly to a phone line then just
dial the phone line that the FXO port is connected to. Then, after the
FXO 102 port has answered the call, dial number 101 which is a
second FXO port. You should then here the dial tone from the PBX
on line 1236. (Yet again if you are connecting the FXO ports directly
to phone lines you should here the phone line dial tone from the
second line.) Now make a third call to phone 1235. Thus you now
have a call from 1234 to 1233, then to 101 and then to 1236 and
finally to 1235! Then, after the call is routed hang up 1234. You
should then see tone detection results appear on the PC terminal.
i.e.
19
Solwise Elite VoIP Gateway User’s Guide
1.5.4.4 Tone detection
When the call is disconnected you should see messages similar to
the following on the console screen:
20
Solwise Elite VoIP Gateway User’s Guide
1.5.4.5 Entering the detected Tone cadence values
So, once your gateway has displayed the detected tone values for
the disconnected call you can now enter these into the gateway
configuration.
At the console prompt use the command show_cp_tone_det to
display the current settings:
21
Solwise Elite VoIP Gateway User’s Guide
Now use the command cp_tone_det disconnect to enter the new,
detected tone values.
22
Solwise Elite VoIP Gateway User’s Guide
Done!
23
Solwise Elite VoIP Gateway User’s Guide
2 Integration Examples for 2 & 4 Port Desktop
Version
This section discusses the various environments and situations where
you can use the Elite Gateway* Desktop Version
2.1 Application A: FXS
Application A has two possible connections. The A-1 shows the
connection between the gateway and telephone set (POTS) or FAX
machine. The FXS module is used in the A-1 connection. The A-2
connection is used to connect the gateway and PBX that has the
CO trunk interface. FXS is also used in this connection. The
telephone sets connected to PBX can be either POTS or digital
telephone depending upon the PBX capability.
2.2 Application B: FXS / FXO combination
Application B has three possible connections. The B-1 connection is
a normal trunk connection between the CO switch and PBX. The B2 connection is identical to the A-1 connection mentioned in
Application A. The B-3 connection is used to connect the PBX and
gateway through the internal analog lines provided by the PBX. In
this case, the FXO module has to be used, and the FXO ports will
serve the same roles as the analog telephone sets.
Note: If the PBX used in the B-3 connection is a digital type, an
analog terminal adapter is needed to provide an analog interface to
the FXO module.
In this application, the caller on the B-2 connection can use the
Gateway through its FXS module to communicate with the party on
the other end in the B-3 connection. The phone call is forwarded
through the FXS module in the B-2 Gateway and is received by the
FXO module in the B-3 gateway, which is connected to the PBX,
which will then switch to the dedicated terminal.
The same caller can also use the feature that the Gateway provides
to redial the local number through the PBX, to the public switch, in
order to reach the person inside the region that the public switch
serves.
24
Solwise Elite VoIP Gateway User’s Guide
25
Solwise Elite VoIP Gateway User’s Guide
3 Integration Examples for 4 & 8 Port Rack Mount
Version
There are three basic environments that the Elite Gateway* can be
applied to. They are described in the following sections.
3.1 Application A: FXS
Application A has two possible connections. The A-1 connection
shows the connection between the gateway and telephone set
(POTS) or FAX machine. The FXS module is used in the A-1
connection. The A-2 connection on the right hand side is used to
connect the gateway and PBX that has the Central Office (CO)
trunk interface. FXS is also used in this connection. The telephone
sets connected to the PBX can be either POTS or digital telephone
depending upon the PBX capability.
3.2 Application B: FXS/FXO Combination
Application B has three possible connections. The B-1 connection is
a normal trunk connection between the CO switch and a PBX. The
B-2 connection is identical to the A-1 connection mentioned in
Application A. The B-3 connection is used to connect the PBX and
gateway through the internal analog lines provided by the PBX. In
this case, the FXO module has to be used and the FXO ports will
serve the same roles as the analog telephone sets.
Note: If the PBX used in the B-3 connection is a digital type an
analog terminal adapter is needed to provide an analog interface to
the FXO module.
In this application the caller in the B-2 connection can use the
gateway through its FXS module to communicate with the party on
the other end of the B-3 connection. The phone call is forwarded
through the FXS module in the B-2 Gateway and is received by the
FXO module in the B-3 gateway, which is connected to the PBX,
which will then switch to the dedicated terminal.
The same caller can also use the feature that the Gateway provides
to redial the local number through the PBX to the public switch in
26
Solwise Elite VoIP Gateway User’s Guide
order to reach the person inside the region that the public switch
serves.
3.3 Application C: FXS/FXO Extended Combination
Application C has four possible connections. The C-1 connection is
a normal trunk connection between the CO switch and PBX
(identical to connection B-1 in the previous application) The C-2
connection is identical to the A-1 connection mentioned in
Application A. The C-3 connection connects the PBX and gateway
through the internal analog line provided by the PBX (identical to the
B-3 connection). The C-4 connection connects the CO switch to the
gateway using the FXO module (similar to the C-3 connection).
The C-2 connection can be replaced by the C-3 connection, but it
must then use an FXO module instead of an FXS module. In this
application, the user can benefit from the VoIP application even
when not in the office. With a properly configured dial plan, the user
can make a phone call through a public switch back to the office,
and the PBX will relay the phone call to the other end which may be
located in another city, state, or even country.
27
Solwise Elite VoIP Gateway User’s Guide
3.4 Configuration Examples
3.4.1 Scenario 1
3 sets of Elite Gateways are connected to Internet. One of Elite
Gateways has an FXO module and the other two are equipped with
an FXS module.
Telephone address description
Elite Gateway A: 408 and 415 are address specific PSTN
connections on PBX CO trunk, and 90 are address specific
connections on PBX internal lines on Elite Gateway A FXO ports
Elite Gateway B: 0900, 0901, 0902, 0903 are specific telephone
address on Elite Gateway B FXS ports
Elite Gateway C: 0800, 0801, 0802, 0803 are specific telephone
address on Elite Gateway C FXS ports
Address Entry Hunt Grp_Id Min. Digits Max. Digits Prefix strip
Prefix Address
0800 1 4 4 0 None
0801 2 4 4 0 None
0802 3 4 4 0 None
0803 4 4 4 0 None
90 11 0 6 0 None
408 11 0 10 0 None
415 11 0 10 0 None
09 12 4 4 0 None
Elite Gateway C hunt group table
Group id Type #Members
Member ids
1 2 1 1
2 2 1 2
3 2 1 3
4 2 1 4
11 2 1 11
12 2 1 12
Elite Gateway C destination table
Dest id Mode Destination
1 Local PORT = 0
2 Local PORT = 1
31
Solwise Elite VoIP Gateway User’s Guide
3 Local PORT = 2
4 Local PORT = 3
11 H.323 Dest = 210.243.230.10/1720 TCP
12 H.323 Dest = 210.243.230.20/1720 TCP
Note: An FXO module was added to both Elite Gateway B and Elite
Gateway C.
3.4.2 Scenario 2
3 sets of Elite Gateways were connected to Internet and all of Elite
Gateways are built-in FXO and FXS modules.
Telephone address description:
Elite Gateway A: 408 and 415 are address specific PSTN
connections on PBX CO trunk, and 90 are address specific
connections on PBX internal lines on Elite Gateway A FXO ports
Elite Gateway B: 0900, 0901, 0902, 0903 are address specific
telephone on Elite Gateway B FXS ports and 932 and 934 are
address specific PSTN connections on Elite Gateway B FXO ports
Elite Gateway C: 0800, 0801, 0802, 0803 are address specific
telephone on Elite Gateway C FXS ports and 712 are address
specific PSTN connections on Elite Gateway C FXO ports
This section explains how to upgrade your Elite Gateway* when new
software revisions become available. Upgrades may improve system
functionality or add new features to your Elite Gateway.
The Elite Gateway offers two operation modes. Under normal
conditions, the Elite Gateway operates in regular operational mode.
When a software upgrade is required, the Elite Gateway is operated
in download mode. In download mode, the CLI will support limited
commands allowing users to load new software from a remote
TFTP server and write it to the built-in flash non-volatile storage.
Entering Download Mode
To switch from normal operation mode to download mode, use the
download CLI command.
Console> download <Enter>
Note: To be able to switch to download mode from Telnet session,
the TFTP loader on the Elite Gateway must be version 3.00 or
higher.
The Elite Gateway will terminate all on-going calls, shut itself down,
reset and enter download mode. If you enter download mode from
Telnet session, the Telnet session will be terminated. You need to
reconnect to the Elite Gateway from Telnet client again to be able to
access the CLI commands.
Upon entering the download mode, the CLI will show the following
prompt.
EITGLoader>
CLI Commands in Download Mode
The CLI in download mode differs from normal in the console
prompt in that only specific software update commands are
supported. In download mode, the CLI supports the following
commands:
Command Description
help Display help screen.
quit Terminate download mode, switch to normal operation mode.
set Change IP parameter.
start Start downloading code from TFTP server.
The following section describes each of the commands:
help
The help command lists the top-level commands.
38
Solwise Elite VoIP Gateway User’s Guide
Syntax Description
This command has no arguments or keywords.
quit
The quit command is used to terminate the download mode and
return to normal operation mode.
Syntax Description
This command has no arguments or keywords.
Note: Switching modes from a Telnet session will terminate the
current active session. You'll need to connect to the Elite Gateway
again to be able to access the CLI.
set ip ip_addr
Use the set ip command to assign a static IP address to the Elite
Gateway.
Syntax description
ip_addr The IP address of the Elite Gateway.
Note: The new IP address will not take effect until the Elite Gateway
is reset.
set mask ip_mask
start
Use the set mask command to set the IP subnet mask for the Elite
Gateway.
Syntax description
ip_mask The subnet mask of your network.
Note: The new setting will not take effect until the Elite Gateway is
reset.
Use the start command to start downloading code from TFTP
server. The Elite Gateway will prompt you for the IP address of the
TFTP server and the file name to download.
Syntax description
This command has no arguments or keywords.
39
Solwise Elite VoIP Gateway User’s Guide
5 CLI Documentation
5.1 Using The Command Line Interface (CLI)
The Elite Gateway* has a built-in command line interpreter and provides
users with a Command Line Interface (CLI). The Elite Gateway can be
configured by entering commands from the CLI.
The CLI can be accessed from a VT-100 terminal or terminal emulator
connected to the RS-232 port on the front panel or through a Telnet
session.
Connection through Serial Port
The serial port of the Elite Gateway is fixed at the following settings:
Baud rate 19,200
Number of data bit 8
Parity check None
Number of stop bit 1
Flow control None
To access the Elite Gateway through the RS-232 serial port, follow these
steps:
1. Insert one end of the serial cable that came with the Elite Gateway into the 9-pin RS-232 port (labeled
User Console) on the front panel.
2. Insert the other end of the cable into your terminal's serial port.
3. Configure the terminal so that settings for baud rate, number of data bit, parity check, number of stop bit
and flow control capability exactly match Elite Gateway's serial interface. (Refer to your terminal
documentation for more information about setting up these features).
4. Press <Return> from the terminal.
5. The Elite Gateway displays the following prompts on the terminal and you are ready to access the CLI.
Console>
Connection through Telnet
To use Telnet, the IP address must have been previously set using
the
net set ip command for the Elite Gateway. Up to two sessions
through Telnet are possible.
40
To access the Elite Gateway from a remote host with Telnet,
perform the following tasks:
Solwise Elite VoIP Gateway User’s Guide
Task Prompt Type
From the remote host, enter the telnet command followed by the IP address
of the Elite Gateway you want to access.
None
telnet
ip_addr
When the Elite Gateway prompts "Login:", enter the user name "adm" Login: Adm
When the Elite Gateway prompts "Password:", enter the password. The
default password is "123" unless a password was previously established
using the net set user_pw command (Refer to the section describing net set
user_pw command later in this section for details about the setting
Password: 123
password).
After successfully entering the password, the Elite Gateway displays a
greeting message along with the following prompts. The CLI commands are
then ready to be accessed.
Console>
Command Help
Help for commands is provided by the CLI. Type help to see a
listing of the top-level commands. In most cases, if a command
is entered using the wrong number of arguments or inappropriate
arguments, the CLI will give further usage.
Designating IP Address
Some commands require an IP address, which must be designated
in a standard format. The IP address format is 32 bits, written as
four octets separated by periods (dotted decimal format) that are
made up of a network section, an optional subnet section, and a
host section, as shown in the following example:
192.168.0.1
Designating Port Number
Some commands require a telephony port number. The Elite
Gateway designates the first port on telephone interface module
(TIM) slot A as port number 0, the 2nd port as port number 1 and so
on. When a TIM is installed in slot B, the first port is designated as
port number 4, the 2nd one is designated as port number 5 and so
on.
Note: If you have only a single TIM, be certain to install it in slot A,
otherwise, the Elite Gateway won't function.
CLI Commands
The ITG offers two operation modes. Under normal
conditions, the ITG operates in Gateway Mode. When
software upgrade is required, the ITG may be operated in
Software Upgrade Mode. Under Software Upgrade Mode,
the CLI supports limited commands allowing users to read
new revision codes from a remote TFTP server and write it to
the built-in flash non-volatile storage.
41
Solwise Elite VoIP Gateway User’s Guide
This section provides two tables (Table 1 and Table 2) that
list all CLI commands supported by the ITG in alphabetical
order, and provides for each command a one-line description,
and the page number where you can find detailed
information. Table 1 lists CLI commands supported under
Gateway Mode. Table 2 lists CLI commands supported under
Software Upgrade Mode. The port in the set port
command and profile_id in the set coding command in
table below stands for port ID and coding profile ID
respectively.
Gateway Mode Commands
Command Description
arp Manages ARP table
clrscr Clears the screen
config Manages configuration parameters
download Enters software upgrade mode
help Displays top level commands
net
reset Resets the ITG
set gateway Sets default gateway’ address
set http Enables/Disables HTTP server
set ip Sets IP address
set ip_preced Sets IP Service Type
set mask Sets subnet mask
set speed Sets link speed for Ethernet interface
set telnet Enables/Disables Telnet server
set http Enables/Disables HTTP server
set user_pw Sets password for Telnet and HTTP server
master_delay Specifies if the ITG should delay sending the
H.323 open logical channel message to remote
gateway after completing master/slave
determination
nat_call Enables/Disables the ITG to connect to remote
gateways connecting to WAN via NAT
capable router
out_fast_start Select the H.323 Faststart mode for outgoing
calls.
rtp_port_base Selects the starting port number for
assignment of RTP ports
term_id
time_to_live
set port port Configures a telephony interface port
ans_wait Sets a wait-for-answer time limit
call_limit Sets a call length limit for calls
cid name Sets the Caller ID Name
cid number Sets the Caller ID Number
copyof Copy the configuration parameters for a port
to another port
cp_tone_det_cfg Selects the call progress tone detection
configuration
cp_tone_det_ctrl Controls the detection of call progress tone
dial_in_plar Configures the number to be dialed in
automatically when a telephony port goes offhook
em clear_conf_detect Sets the minimum duration of on-hook
response on the M-lead that is required for
clear confirm to be detected
44
Solwise Elite VoIP Gateway User’s Guide
g
em clear_conf_wait_max Sets the maximum duration to wait for an on-
hook response on the M-lead after going onhook on the E-lead
em clear_detect Specifies the period of time M-lead needs to
be on-hook before call clearing is declared
em connected_min Specifies the minimum period of time that a
connection will be maintained
em dial_tone Specifies if dial tone should be generated on
incoming calls
em disable_hangup Specifies the time period a port will wait after
hanging up a call before signaling that it is in
a disabled state
em guard_all Sets the period after an aborted call when no
incoming/outgoing calls will be
accepted/initiated
em guard_out Sets an additional period of time after
guard_all when incoming calls will be
accepted.
em offhook_db Sets the off-hook debounce interval
em onhook_db Sets the on-hook debounce interval
em size_detect Specifies the period of time the M-lead needs
to be off-hook before an incoming call is
declared
emd in_delay_max Sets the maximum duration of the delay signal
response to the Seize Detect on the M-lead
emd in_delay_min Sets the minimum duration of the delay signal
response to the seize detect on the M-lead
emd in_digit_ign Sets the period of time, after completing the
delay signal, before the digits will be accepted
on incoming calls
emd out_delay_check Sets the period of time after going off-hook on
the E-lead before checking the M-lead for the
delay signal response
emd out_delay_dur_max Set the maximum duration of the delay signal
response on the M-lead for it to be detected on
outgoing calls
emd out_delay_dur_min Sets the minimum duration of the delay signal
response on the M-lead for it to be detected on
outgoing calls
emd out_intg_check Sets the Integrity Check mode.
emi glare_report Sets a time period during which, if glare is
detected, the interface will stay off-hook and
generate congestion tone
emi wait_dsp_ready Sets a time period to wait for the DSP
software to be ready before digit collection
can be enabled
emw in_wink_digit_ignore Specifies the period of time that will be
i
nored after completing the wink and before
45
Solwise Elite VoIP Gateway User’s Guide
digits will be accepted for incoming calls
emw in_wink_dur Specifies the duration of the wink signal on
the E-lead for incoming calls
emw in_wink_wait_max Sets the maximum delay before beginning the
wink on the E-lead after detecting a line
seizure on the M-lead for an incoming call
emw in_wink_wait_min Sets the minimum delay before beginning the
wink on the E-lead after detecting a line
seizure on the M-lead for an incoming call
emw out_wink_dur_max Sets the maximum duration of the wink
response on the M-lead for it to be detected
emw out_wink_dur_min Sets the minimum duration of the wink
response on the M-lead for it to be detected
emw out_wink_wait_max Specifies the maximum time to wait for a
wink response on the M-lead after going
offhook on the E-lead
enable_user_cid Selects which Caller ID information the ITG
should be conveyed to the called party
fax_holdover Sets the fax holdover delay
fax_prof Selects the preferred fax coder
fax_tone_det_ctrl Specifies if V.21 fax tone should be detected
fxo answer_after Specifies the number of rings to elapse before
a FXO port answering an incoming call
fxo batt_rev_times Specifies the number of times the battery
reversal signal must be detected before
shutting down a FXO port
fxo caller_id Enable/Disble Caller ID detection on a FXO
port
fxo cpc_detect Specifies the expected duration of the loss of
loop current before shutting down a FXO port
fxo guard_out Specifies the time, after completing a call over
a FXO port and before another call can be
originated.
fxo loop_det_db Specifies the time for debouncing the loop
current detector
fxo ringing_db Specifies the time for debouncing the ring-on
signal
fxo ringing_inter_cycle Specifies the duration of ring-off signal
fxo ringing_inter_pulse Specifies the time between consecutive ring
pulses in the same ring-on signal
fxs answ_clear_detect Sets the minimum time to wait, when the
answering party drops the line before
declaring on-hook
fxs caller_id Specifies if Caller ID will be generated on a
FXS port
fxs cpc_dur Sets the duration, of the loop current
46
Solwise Elite VoIP Gateway User’s Guide
shutdown
fxs cpc_wait Sets the time to wait, after a FXS port shutting
down loop current and before checking for onhook
fxs offhook_db Specifies the time for debouncing the off-hook
signal
fxs offhook_detect Sets the time to wait, before an off-hook
condition is declared
fxs onhook_db Specifies the time for debouncing the on-hook
signal
fxs onhook_detect Sets the time to wait, before an on-hook
condition is declared.
fxs ring_id Selects the ringing signal
hangup_wait Sets the wait-for-hangup time limit for a
telephony port
out_type Selects tone-dial or pulse-dial
out_wait Specifies the time to delay after going off-
hook before generating outbound dial digits.
prof_bit Selects which coding profiles will be available
to a telephony port
proto Select the signaling protocol
rxgain Adjusts gain level of PCM signal received
from a telephony port
tone_out_off Sets off duration for DTMF tones
tone_out_on Sets the on duration for DTMF tones
tone_out_pwr Sets power level for DTMF tones
tone_table Select the tone table for a telephony port
txgain Adjusts gain level of signal ITG sends to a
telephony port
voice_prof Selects the preferred coding profile for voice
set tone Configures on/off cadence for a CP tone
show
call_record Displays information about the current call or
latest call
coding Displays configuration of a coding profile
cp_tone_det Displays the on/off cadence for a CP tone
cp_tone_det_cfg Displays parameters for the CP tone detection
filter
h323 Displays H.323 configuration
port Displays the configuration of a telephony port
rxtsstat Displays the statistic information about the
voice packets a telephony port has
received/transmitted
tlevels Displays the power level of signals for a
telephony port
47
Solwise Elite VoIP Gateway User’s Guide
tone Displays each element of a CP tone
tstat Displays the telephony interface statistics for a
telephony port
version Displays information that identifies the
versions of various software components
vpstat Displays the statistic information about the
voice packets played out by a telephony port
spy Sets filtering level for a specific spy key
spy dump Display trace buffer
spy flush Flush trace buffer
tel erase_ivr Erases greeting message
tel set pcm_gain_level Adjust gain level of signal ITG sends to FXO
ports
tel set ring_freq Set the frequency of ringing that the ITG
generates
tel show pcm_gain_level Displays the setting of gain level for FXO
ports.
tel show port Displays status of a telephony port
tel show ring_freq Displays frequency of ringing signal that ITG
generates
Software Upgrade Mode Commands
Command Description
help Displays commands
ping Pings a remote IP host
quit Quits Software Upgrade mode
set gateway Sets default gateway’ address
set ip Sets IP address
set mask Sets subnet mask
show Displays network parameters
start Starts downloading code image from TFTP
server
5.2 Utility Commands
This section describes the general-purpose utility commands.
5.2.1 clrscr
This command clears the screen
clrscr
48
Solwise Elite VoIP Gateway User’s Guide
Syntax Description
This command has no arguments or keywords
5.2.2 download
Use the download command to enter download mode for reading code image from a
TFTP server and program it to flash NVS. Refer to Software Upgrade Utility Commands on page 99 for detailed information on how to upgrade the system
software.
download
Syntax Description
This command has no arguments or keywords
5.2.3 help
The help command lists the top-level commands.
help
Syntax Description
This command has no arguments or keywords
5.2.4 ping
The ping command sends ICMP echo request packets to another host on the
network.
Causes ping to send one datagram per second,
printing one line of output for every response
received.
The IP address or IP alias of the host.
Number of echo request packets to send. This
option takes effect only if option –s is
specified.
Timeout value for the ping in millisecond
5.2.5 tel erase_ivr
This command erases the greeting message that was recorded previously.
tel erase_ivr
49
Solwise Elite VoIP Gateway User’s Guide
Syntax Description
This command has no arguments or keywords
5.2.6 tel set pcm_gain_level
The gain control circuitry of the FXO interface ports my adjust the power level of
the analog signal the ITG send to all FXO ports and the gain level is configurable.
This command is for setting this gain level for all FXO ports.
tel set pcm_gain_level {1 | 2 | 3 | 4 | 5}
Syntax description
1
2
3
4
5
Setting gain level to
-1 dB
Setting gain level to
0 dB
Setting gain level to
1 dB
Setting gain level to
2 dB
Setting gain level to
3 dB
Default
1- -1 dB
Notes
The setting apply to all FXO ports.
Related Command
tel show pcm_gain_level
5.2.7 tel set ring_freq
The ITG rings FXS port for signaling an incoming call, and provide 4 types of
ringing signal, each having a unique frequency. This command is for selecting the
frequency of the ringing signal that the ITG sends to FXS ports.
tel set ring_freq {1 | 2 | 3 | 4}
Syntax description
1
50
Setting ring frequency
Solwise Elite VoIP Gateway User’s Guide
to 17 Hz
2
3
4
Default
1- 17 Hz
Related Command
tel show ring_freq
5.2.8 tel show pcm_gain_level
The command displays the gain level, which was set by command tel set
pcm_gain_level.
tel show pcm_gain_level
Setting ring frequency
to 20 Hz
Setting ring frequency
to 25 Hz
Setting ring frequency
to 50 Hz
Syntax description
This command has no arguments or keywords
Related Command
tel set pcm_gain_level
5.2.9 tel show port
This command displays the hook status of a telephony port.
tel show port [port]
Syntax description
port
5.2.10 tel show ring_freq
This command displays the ringing frequency that was configured by the tel set
ring_freq command.
ID of the telephony port. If not specified,
hook status for all telephony ports available
will be displayed.
tel show ring_freq
51
Solwise Elite VoIP Gateway User’s Guide
Syntax description
This command has no arguments or keywords
Related Command
tel set ring_freq
5.3 3. IP Configuration Commands
This section describes the commands to configure and monitor the LAN and IP
interface for the ITG.
5.3.1 arp
Use the arp -a command to display contents of the ARP cache.
arp -a
arp –d ip_addr
Syntax description
-a
-d
ip_addr
5.3.2 net reset
Use the net reset command to reset the ITG. The CLI will prompt you to confirm
the command before resetting the ITG.
net reset
Syntax Description
This command has no arguments or keywords
5.3.3 net set gateway
Use the net set gateway command to assign a default gateway (router) for the ITG.
The default gateway routes packet data outside of the IP subnet that the ITG resides.
Display contents of ARP
cache
Delete an entry from the
ARP cache
IP address of the ARP entry
to be deleted.
52
net set gateway ip_addr
Syntax description
Solwise Elite VoIP Gateway User’s Guide
ip_addr
Default
0.0.0.0
Note
The new setting will not take effect until the ITG is reset.
Related Commands
net set ip
net set mask
5.3.4 net set http
The ITG allows you to enable or disable its built-in HTTP server. This command is
used to enable or disable the HTTP server.
net set http {on | off}
The IP address of the default gateway. IP
address of 0.0.0.0 stands for no default
gateway.
Syntax description
on
off
Default
on
Notes
The new setting will not take effect until the ITG is reset.
5.3.5 net set ip
This command is used to assign a static IP address to the ITG.
net set ip ip_addr
Syntax description
ip_addr
The IP address of
the ITG.
Enable HTTP server. This allows users to
manage the ITG from web browser.
Disable HTTP server.
53
Solwise Elite VoIP Gateway User’s Guide
Default
192.168.0.1
Notes
The new IP address will not take effect until the ITG is reset.
Related Commands
net set gateway
net set mask
5.3.6 net set ip_preced
The ITG allows you to set the 8-bit Service Type field in the IP header for all the
voice packets it sends out. The Service Type field is broken down into five subfields,
among which four subfileds are user configurable. This command is used to set these
subfields.
net set ip_preced ip_preced [d] [t] [r]
Syntax description
ip_preced
d
t
r
The 3-bit PRECEDENCE subfiled
ranging from 0 through 7.
The D bit subfield, either 0 or 1.
The T bit subfield, either 0 or 1.
The R bit subfield, either 0 or 1.
Default
ip_preced: 0
d: 0
t: 0
r: 0
Notes
The new setting will not take effect until the ITG is reset.
5.3.7 net set mask
This command is used to set the IP subnet mask for the ITG.
net set mask ip_mask
54
Solwise Elite VoIP Gateway User’s Guide
Syntax description
ip_mask
Default
255.255.255.0
Notes
The new setting will not take effect until the ITG is reset.
Related Commands
net set gateway
net set mask
5.3.8 net set speed
The ITG allows you set the link speed for its Ethernet interface. This command is
used to set the Ethernet link speed.
net set mask {10 | 100 | auto}
The subnet mask of
your network.
Syntax description
10
100
Auto
Default
auto
5.3.9 net set telnet
The ITG allows you enable or disable its built-in Telnet server. This command is
used to enable or disable the Telnet server.
net set telnet {on | off}
Syntax description
on
Fixed the Ethernet speed at 10
Mbps
Fixed the Ethernet speed at 100
Mbps
Enable the 10/100 Mbps autonegotiation capability.
Enable Telnet server. This allows users to
55
Solwise Elite VoIP Gateway User’s Guide
access the ITG from Telnet client.
off
Default
on
Notes
The new setting will not take effect until the ITG is reset.
5.3.10 net set http
The ITG allows you enable or disable its built-in HTTP server. This command is
used to enable or disable the HTTP server.
net set http {on | off}
Syntax description
on
Disable Telnet server.
Enable HTTP server. This allows users to
access the ITG from HTTP client.
off
Default
on
Notes
The new setting will not take effect until the ITG is reset.
5.3.11 net set user_pw
This command is used to change the password for Telnet client and web browser
login.
net set user_pw password password
Syntax description
password
Disable HTTP server.
The new password. The password must be
equal to or less than 7 alphanumeric
characters. It must be identically typed twice
for the ITG to be certain about the new
password.
56
Solwise Elite VoIP Gateway User’s Guide
Default
123
5.3.12 net show
This command displays all the network settings.
net show
Syntax Description
This command has no arguments or keywords
Example
The following example shows how to display network settings:
Console>net show <Enter> ******************* Net
Parameters ******************* Configured IP address = 172.16.3.252.
Configured IP subnet mask = 255.255.0.0.
Default gateway IP address = 0.0.0.0.
Current active IP address = 172.16.3.252.
Current active subnet mask = 255.255.0.0.
IP precedence = 0 0 0 0
Ethernet MAC address = 00-50-2d-00-04-56
Ethernet speed setting = 10/100 Mbps auto-negotiation
USER password = 123
HTTP server = enabled
Telnet server = enabled
******************************************************
Console>
5.3.13 net show hwstat
This command displays the hardware configuration of the ITG.
net show hwstat
Syntax Description
This command has no arguments or keywords
Example
The following example shows how to display hardware configuration:
Console>net show hwstat <Enter> ****************** Hardware
Configuration ******************
Flash: type-MX29L1611 64 sectors 64 KB/sector
RAM: 8 MB 256K x 32
LAN: auto-netotiation on-going. Link DOWN
TIM slot A: type-FXS4 DSP-C549 codec-NW1034 Diag-OK
TIM slot B: type-FXO4 DSP-C549 codec-NW1034 Diag-OK
***********************************************************
Console>
57
Solwise Elite VoIP Gateway User’s Guide
5.4 Telephony Interface Port Configuration Commands
This section describes commands for configuring the telephony interface ports of the
ITG. All command in this section share the same syntax as follows:
set port {port | all} option [option] . . .
Syntax for the port is as follows:
port
ID of the telephony port to which
the command applies.
all
The command apply to all the
telephony ports
This section is organized as follows:
Common telephony port configuration commands
E&M common signaling configuration commands
E&M immediate start configuration commands
E&M delay start signaling configuration commands
E&M wink start signaling configuration commands
FXO signaling configuration commands
FXS signaling configuration commands
5.5 Common Telephony Port Configuration Commands
The following sections describe commands that apply to all types of telephony
interface port.
5.5.1 set port port ans_wait
This command is used to set a wait-for-answer time limit on a telephony port. If the
call destination does not answer within this period, the call is automatically
terminated.
set port port ans_wait seconds
Syntax description
seconds
Default
-1
58
Value in seconds, ranging from 0 to
65534, or –1 or 65535 for forever.
Solwise Elite VoIP Gateway User’s Guide
5.5.2 set port port call_limit
This command is used to set a call length limit for calls on a telephony port. If the
call length is exceeded, the call is automatically terminated.
set port port call_limit seconds
Syntax description
seconds
Default
-1
5.5.3 set port port cid name
This command is used to set the Caller ID Name for a telephony port.
set port port cid name {name | O}
Syntax description
name
O
Default
No caller ID name
Value in seconds, ranging from 0 to
65534, or –1 or 65535 for forever.
Caller ID name, 1 to 10 characters. Use ‘-‘to
represent spaces in the name.
Caller ID is name is not available
Related Commands
set port port enable_user_cid
set port port fxo_caller_id
set port port fxs caller_id
5.5.4 set port port cid number
This command is used to set the Caller ID Number for a telephony port.
set port port cid number {name | O}
Syntax description
name
59
Caller ID number, 1 to 15 digits. Use ‘-‘to represent spaces in
the name.
Solwise Elite VoIP Gateway User’s Guide
O
Default
No caller ID number
Related Commands
set port port enable_user_cid
set port port fxo_caller_id
set port port fxs caller_id
5.5.5 set port port copyof
This command is used to copy the settings of a telephony port to another telephony
port.
set port port copyof src_port
Syntax description
src_port
Call ID is number is not available
ID of the telephony port which the
settings will be copied from.
5.5.6 set port port cp_tone_det_cfg
The gateway implements two call progress tone detection configurations, default and
alternate, and allows users to specify which configuration will be used for call
progress tone detection. A configuration includes filter information, and a table
containing cadence information of all the call progress tones that are to be detected.
The default configuration allows for the detection of the following tones
busy
ringback
congestion
disconnect
disc1
disc2
disc3
disc4
disc5
The alternate configuration allows for the detection of the following tones
busy
60
ringback
Solwise Elite VoIP Gateway User’s Guide
congestion
disconnect
This commands allows the selection of which configuration for call progress tone
detection.
set port port cp_tone_det_cfg {default |
alternate}
Syntax description
default
alternate
Default
default
Related Commands
set cp_tone_det
set cp_tone_det_cfg
set coding profile_id cp_tone_detect
set port port cp_tone_det_ctrl
5.5.7 set port port cp_tone_det_ctrl
This command is used to control the detection of call progress tones.
set port port cp_tone_det_ctrl {0 | 1 | 2}
Select the default call progress tone
detection configuration
Select the alternate call progress tone
detection configuration
Syntax description
0
1
2
61
Disable call progress tone detection.
Enable call progress tone detection.
Enable/Disable call progress detection
according to the cp_tone_detect
parameter in the coding profile that is
currently loaded. Refer to command “set
coding profile_id cp_tone_detect” on page 52
for details about setting the call progress tone
detection option for a coding profile.
Solwise Elite VoIP Gateway User’s Guide
Default
1
Related Commands
set cp_tone_det
set cp_tone_det_cfg
set coding profile_id cp_tone_detect
5.5.8 set port port dial_in plar
This command is used to configure the number to be dialed in automatically
(automatic ring-down) when a telephony port goes off-hook. If no number is entered,
operation will be as normal.
set port port dial_in plar number
Syntax description
number
Default
None
5.5.9 set port port fax_holdover
This command is used to set the fax holdover delay for a telephony port. This is the
time the ITG will delay after detecting on-hook during fax mode operation before
generating a call clear.
set port port fax_holdover milliseconds
Syntax description
milliseconds
Default
2000
The phone number to be dialed
automatically upon detecting off-hook.
Value in milliseconds, ranging
from 0 to 65535.
5.5.10 set port port fax_tone_det_ctrl
This command is used to control the detection of the V.21 fax tones.
set port port fax_tone_det_ctrl {0 | 1 | 2}
62
Solwise Elite VoIP Gateway User’s Guide
Syntax description
0
1
2
Default
1
Related Command
set coding profile_id fax_tone_detect
5.5.11 set port port fax_prof
This command is used to select the preferred fax coding profile for a telephony port.
Disable fax tone detection.
Enable fax tone detection.
Enable/Disable fax tone detection according
to the fax_tone_detect parameter in
the coding profile that is currently loaded.
Refer to command “set coding profile_id
fax_tone_detect” on page 53 for details about
setting the fax tone detection option for a
coding profile.
set port port fax_prof prof#
Syntax description
prof#
Default
The factory default preferred fax coding profile for all the telephony ports is coding
profile number 5, which is the coder for proprietary T.38 fax relay protocol.
5.5.12 set port port hangup_wait
This command is used to set a wait-for-hangup time limit on a telephony port. If the
call originator does not hang up within this time period after the destination has hung
up, the call is automatically terminated.
set port port hangup_wait seconds
Syntax description
seconds
Preferred coding profile
ID for fax
Value in seconds, ranging from 0 to
65534, or –1 or 65535 for forever.
63
Solwise Elite VoIP Gateway User’s Guide
Default
5
5.5.13 set port port out_type
The ITG supports tone-dial and pulse-dial. This command is used to select the dialout characteristic of a telephony port.
set port port out_type {tone | pulse}
Syntax description
tone
pulse
Tone dial
Pulse dial
Default
tone
5.5.14 set port port out_wait
This command is used to specify the time to delay after going off-hook before
generating outbound dial digits.
set port port out_wait milliseconds
Syntax description
milliseconds
Default
400
Value is milliseconds, ranging
from 0 to 65535.
5.5.15 set port port prof_bit
This command is used to select which coding profiles will be available to the
telephony port.
set port port prof_bit {prof_num | all} {0 | 1}
Syntax description
prof_num
all All coding profiles
0 Coding profile number prof_num is not
64
The ID of the coding profile.
available to the telephony port designated by
port
Solwise Elite VoIP Gateway User’s Guide
1 Coding profile number prof_num is available
to the telephony port designated by port
Default
By factory default, all available coding profiles are available to all telephony ports.
5.5.16 set port port proto
This command is used to select the signaling protocol for a telephony port. The ITG
detects its hardware and configure the signaling protocol for all the telephony ports
automatically. You may change the signaling protocol for a port using this
command.
set port port proto {fxs | fxo | emi | emd | emw}
Syntax description
fxs Loop start FXS
protocol
fxo Loop start FXO
emi E&M immediate
emd E&M delay start
emw E&M wink start
Default
The ITG detects the hardware of all the telephony ports and automatically sets the
signaling protocol for each port according to the type of telephony interface port as
shown in the following table:
Type of Telephony Interface Port Signaling Protocol
FXS fxs
FXO fxo
E&M emi
5.5.17 set port port rxgain
protocol
start
The ITG adjust the power level of the PCM signal coming in from the telephony
ports before feeding it to the voice processor for further processing. This command
allows user to specify the gain level for PCM signal received from the telephony
port.
set port port rxgain db
65
Solwise Elite VoIP Gateway User’s Guide
Syntax description
db
Default
0
Related Command
set port port txgain
5.5.18 set port port tone_out_off
This command is used to set the off time for DTMF dial tones from a telephony port.
set port port tone_out_off milliseconds
Syntax description
milliseconds
Gain level in dB, ranging
from –14 to 14.
Value is milliseconds, ranging
from 0 to 65535.
Default
200 ms
Related Commands
set port port tone_out_on
set port port tone_out_pwr
5.5.19 set port port tone_out_on
This command is used to set the on time for DTMF dial tones from a telephony port.
set port port tone_out_on milliseconds
Syntax description
milliseconds
Default
200 ms
Value is milliseconds, ranging
from 0 to 65535.
66
Solwise Elite VoIP Gateway User’s Guide
Related Commands
set port port tone_out_off
set port port tone_out_pwr
5.5.20 set port port tone_out_pwr
This command is used to set the power level for DTMF dial tones generated by the
ITG.
set port port tone_out_pwr power
Syntax description
power
Default
-60. The factory setting for DTMF tone power for all telephony ports is –6.0 dBm.
Related Commands
set port port tone_out_on
set port port tone_out_off
5.5.21 set port port tone_table
The ITG has two built-in tone tables. This command is used to select the tone table
for a telephony port.
set port port tone_table {default | alternate}
Syntax description
default
Power level of DTMF
tones in 0.1 dBm.
Select the default tone
table
alternate
Select the alternate
tone table
Default
default
5.5.22 set port port txgain
After decompressing a voice packet, the ITG adjusts the signal level of the voice
stream before sending the signal toward the telephony port. This command allows
user to specify the gain level for PCM signal before feeding the signal to a telephony
port.
67
Solwise Elite VoIP Gateway User’s Guide
set port port txgain db
Syntax description
db
Default
0
Related Commands
set port port rxgain
5.5.23 set port port voice_prof
This command is used to set the preferred voice coding profile for a telephony port.
set port port voice_prof prof#
Syntax description
prof#
Gain level in dB, ranging
from –14 to 14.
Preferred coding profile
ID for voice
Default
The factory default preferred voice coding profile for all the telephony ports is
coding profile number 0, which is the coder for G.723 6.3 kbps.
5.6 E&M Common Signaling Configuration Commands
The E&M common signaling configuration commands are used to define common
parameters used on all E&M interfaces, regardless of their mode of operation (Wink
Start, Delay Start, or Immediate Start).
5.6.1 set port port em clear_conf_detect
This command is used to set the minimum duration of on-hook response on the Mlead that is required for clear confirm to be detected.
set port port em clear_conf_detect milliseconds
Syntax description
milliseconds
Time in milliseconds, ranging
from 0 to 65535.
68
Solwise Elite VoIP Gateway User’s Guide
Default
5000
5.6.2 set port port em clear_conf_wait_max
This command is used to set the maximum duration to wait for an on-hook response
on the M-lead after going on-hook on the E-lead.
set port port em clear_conf_wait_max milliseconds
Syntax description
milliseconds
Default
10000
5.6.3 set port port em clear_detect
This command is used to specify the period of time M-lead needs to be on-hook
before call clearing is declared.
set port port em clear_detect milliseconds
Syntax description
milliseconds
Default
400
Time in milliseconds, ranging
from 0 to 65535.
Time in milliseconds, ranging
from 0 to 65535.
5.6.4 set port port em connected_min
This command is used to determine the minimum period of time (in milliseconds)
that a connection will be maintained. If the remote end disconnects during this
interval, it will be acknowledged only at the end of this interval.
set port port em connected_min milliseconds
Syntax description
milliseconds
69
Time in milliseconds, ranging
from 0 to 65535.
Solwise Elite VoIP Gateway User’s Guide
Default
2000
5.6.5 set port port em dial_tone
This command is used to determine if dial tone should be generated on incoming
calls.
set port port em dial_tone [on | off]
Syntax description
on
off
Generate dial tone.
Do not generate
dial tone
Default
on
5.6.6 set port port em disable_hangup
This command is used to determine the time period (in milliseconds) a port will wait
after hanging up a call before signaling that it is in a disabled state.
set port port em disable_hangup milliseconds
Syntax description
milliseconds
Default
2000
Time in milliseconds, ranging
from 0 to 65535.
5.6.7 set port port em guard_all
This command is used to set the period after an aborted call when no incoming calls
will be accepted nor outgoing calls initiated.
set port port em guard_all milliseconds
Syntax description
milliseconds
70
Time in milliseconds, ranging
from 0 to 65535.
Solwise Elite VoIP Gateway User’s Guide
Default
400
5.6.8 set port port em guard_out
This command is used to set an additional period of time after guard_all when
incoming calls will be accepted but outgoing calls will not be initiated for aborted
call.
set port port em guard_all milliseconds
Syntax description
milliseconds
Default
400
5.6.9 set port port em offhook_db
This command is used to set the off-hook debounce interval, in milliseconds.
set port port em offhook_db milliseconds
Syntax description
milliseconds
Default
50
Time in milliseconds, ranging
from 0 to 65535.
Time in milliseconds, ranging
from 0 to 65535.
5.6.10 set port port em onhook_db
This command is used to set the on-hook debounce interval, in milliseconds.
set port port em onhook_db milliseconds
Syntax description
milliseconds
Time in milliseconds, ranging
from 0 to 65535.
Default
50
71
Solwise Elite VoIP Gateway User’s Guide
5.6.11 set port port em size_detect
This command is used to specify the period of time the M-lead needs to be off-hook
before an incoming call is declared.
The E&M immediate start signaling configuration commands are used to define
parameters specific to E&M immediate start interface. These commands apply to
E&M Immediate Start signaling protocol only.
5.7.1 set port port emi glare_report
This command is used to set a time period during which, if glare is detected, the
interface will stay off-hook and generate congestion tone.
set port port emi glare_report milliseconds
Syntax description
milliseconds
Default
5000
5.7.2 set port port emi wait_dsp_ready
This command is used to set a time period (in milliseconds) to wait for the DSP
software to be ready before digit collection can be enabled. If glare is detected
during this period, the interface will stay offhook and generate congestion tone.
The E&M delay start signaling configuration commands are used to define
parameters specific to E&M delay start interface. These commands apply to E&M
Delay Start signaling protocol only.
5.8.1 set port port emd in_delay_max
This command is used to set the maximum duration of the delay signal response to
the Seize Detect (of incoming calls) on the M-lead.
set port port emd in_delay_max milliseconds
Syntax description
milliseconds
Default
2500
5.8.2 set port port emd in_delay_min
This command is used to set the minimum duration of the delay signal response to
the seize detect (of incoming calls) on the M-lead.
set port port emd in_delay_min milliseconds
Syntax description
milliseconds
Default
200
Time in milliseconds, ranging
from 0 to 65535.
Time in milliseconds, ranging
from 0 to 65535.
5.8.3 set port port emd in_digit_ign
This command is used to set the period of time, after completing the delay signal,
before the digits will be accepted on incoming calls.
set port port emd in_digit_ign milliseconds
73
Solwise Elite VoIP Gateway User’s Guide
Syntax description
milliseconds
Default
30
5.8.4 set port port emd out_delay_check
This command is used to set the period of time after going off-hook on the E-lead
before checking the M-lead for the delay signal response. If the response is not seen
at this time, the call setup process will continue immediately.
set port port emd out_delay_check milliseconds
Syntax description
milliseconds
Time in milliseconds, ranging
from 0 to 65535.
Time in milliseconds, ranging
from 0 to 65535.
Default
170
5.8.5 set port port emd out_delay_dur_max
This command is used to set the maximum duration of the delay signal response on
the M-lead for it to be detected on outgoing calls.
set port port emd out_delay_dur_max milliseconds
Syntax description
milliseconds
Default
8000
5.8.6 set port port emd out_delay_dur_min
This command is used to set the minimum duration of the delay signal response on
the M-lead for it to be detected on outgoing calls.
Time in milliseconds, ranging
from 0 to 65535.
74
set port port emd out_delay_dur_min milliseconds
Solwise Elite VoIP Gateway User’s Guide
Syntax description
milliseconds
Default
100
5.8.7 set port port emd out_intg_check
This command is used to set the Integrity Check mode. If On, the delay signal
response is required from the PBX for outgoing calls. If Off, no Integrity Check is
performed.
The E&M wink start signaling configuration commands are used to define
parameters specific to E&M wink start interface. These commands apply to E&M
Wink Start signaling protocol only.
5.9.1 set port port emw in_wink_digit_ignore
This command is used to specify the period of time that will be ignored after
completing the wink and before digits will be accepted for incoming calls.
set port port emw in_wink_digit_ignore
milliseconds
Syntax description
milliseconds
Time in milliseconds, ranging
from 0 to 65535.
75
Solwise Elite VoIP Gateway User’s Guide
Default
30
5.9.2 set port port emw in_wink_dur
This command is used to specify the duration of the wink signal on the E-lead for
incoming calls.
set port port emw in_wink_dur milliseconds
Syntax description
milliseconds
Default
200
5.9.3 set port port emw in_wink_wait_max
This command is used to set the maximum delay before beginning the wink on the
E-lead after detecting a line seizure on the M-lead for an incoming call.
set port port emw in_wink_wait_max milliseconds
Syntax description
milliseconds
Default
3000
Time in milliseconds, ranging
from 0 to 65535.
Time in milliseconds, ranging
from 0 to 65535.
5.9.4 set port port emw in_wink_wait_min
This command is used to set the minimum delay before beginning the wink on the Elead after detecting a line seizure on the M-lead for an incoming call.
set port port emw in_wink_wait_min milliseconds
Syntax description
milliseconds
Default
150
76
Time in milliseconds, ranging
from 0 to 65535.
Solwise Elite VoIP Gateway User’s Guide
5.9.5 set port port emw out_wink_dur_max
This command is used to set the maximum duration of the wink response on the Mlead for it to be detected.
set port port emw out_wink_dur_max milliseconds
Syntax description
milliseconds
Default
800
5.9.6 set port port emw out_wink_dur_min
This command is used to set the minimum duration of the wink response on the Mlead for it to be detected.
set port port emw out_wink_dur_min milliseconds
Syntax description
milliseconds
Default
100
Time in milliseconds, ranging
from 0 to 65535.
Time in milliseconds, ranging
from 0 to 65535.
5.9.7 set port port emw out_wink_wait_max
This command is used to specify the maximum time to wait for a wink response on
the M-lead after going offhook on the E-lead. If the period is exceeded, the interface
will declare an error condition and abort the (outgoing) call attempt.
set port port emw out_wink_wait_max milliseconds
Syntax description
milliseconds
Time in milliseconds, ranging
from 0 to 65535.
Default
8000
77
Solwise Elite VoIP Gateway User’s Guide
5.10 FXO Signaling Configuration Commands
The FXO Signaling Configuration Commands are used to define parameters specific
to FXO interface. These command apply to Loop Start FXO signaling protocol only.
5.10.1 set port port fxo answer_after
This command specifies the number of rings to elapse before a FXO port answering
an incoming call.
set port port fxo answer_after rings
Syntax description
Rings
Number of
rings.
Default
2
5.10.2 set port port fxo batt_rev_times
The ITG incorporates battery reversal detector on the FXO interface. After detecting
battery reversal signal on a FXO port for certain times, the ITG shuts down the port.
This command is used to specify the number of times the battery reversal signal
must be detected before the ITG shutting down a FXO port.
set port port fxo batt_rev_times count
Syntax description
Counts
Number of time of battery reversal signal
before shutting down the port, ranging from 0
to 65535.
78
Default
2
Notes
The battery reversal detector functions only under the condition that the CPC
detector is enabled. Refer to command “set port port fxo cpc_detect” on page 42 for
information about enabling/disabling the CPC detector.
Related Commands
set port port fxo cpc_detect
Solwise Elite VoIP Gateway User’s Guide
5.10.3 set port port fxo caller_id
This command selects if Caller ID will be detected on the FXO port.
set port port fxo caller_id {on | off}
Syntax description
on
off
Default
on
Related Command
set port port enable_user_cid
5.10.4 set port port fxo cpc_detect
The ITG incorporates loop current and battery reversal detectors on the FXO
interface. Upon detecting loss of loop current on a FXO port for a specific duration,
the ITG shuts down the port. This command is used to specify the expected duration
of the loss of loop current (CPC supervisory disconnect signal) in milliseconds. If
the loop current on a FXO port drops for a time period greater than this duration, it is
regarded as a supervisory disconnect and the ITG shuts down the port.
set port port fxo cpc_detect milliseconds
Enable Caller ID
detection
Disable Caller ID
detection
Syntax description
milliseconds
Time in milliseconds, ranging from 1 to
60000. –1 stands for no loop current and
battery reversal detection
Default
-1. Do not detect loop current loss and battery reversal.
Related Command
set port port fxo loop_det_db
5.10.5 set port port fxo guard_out
After completing a call over a FXO port, there a short time interval the ITG does not
allow originating outgoing calls, however, incoming calls will be received. This
79
Solwise Elite VoIP Gateway User’s Guide
command is used to set this time interval in milliseconds.
set port port fxo guard_out milliseconds
Syntax description
milliseconds
Default
2000
5.10.6 set port port fxo loop_det_db
The ITG incorporate loop current detector on the FXO interface. This command
specifies the time in milliseconds to use as a debouncer interval for debouncing the
loop current detector. When the ITG detects loss of loop current on a FXO port, the
duration of the loss must be greater then this debouncer interval, otherwise it is not
regarded as loss of loop current.
set port port fxo loop_det_db milliseconds
Syntax description
milliseconds
Time in milliseconds, ranging
from 1 to 60000.
Time in milliseconds, ranging
from 1 to 1000.
Default
20
Related Command
set port port fxo cpc_detect
5.10.7 set port port fxo ringing_db
This command specifies the time in milliseconds to use as a debouncer interval for
debouncing the ring-on signal. For preventing from mistakenly interpreting noise
signal as ring-on, the ITG incorporates this debouncer. When the ITG detect ring on
signal on a FXO port, the signal must sustain for at least the debouncer time,
otherwise it is not regarded as a ring-on.
set port port fxo ringing_db milliseconds
Syntax description
milliseconds
80
Time in milliseconds, ranging
Solwise Elite VoIP Gateway User’s Guide
from 1 to 1000.
Default
50
Related Command
set port port fxo ringing_inter_cycle
set port port fxo ringing_inter_pulse
5.10.8 set port port fxo ringing_inter_cycle
The FXO port detects ringing for signifying an incoming call. A ring is a cycle of
ring-on and ring-off signals. This command is used to specify the time between
consecutive ring-on signals, that is, the duration of the ring-off signal, in
milliseconds. It is used to detect ringing.
set port port fxo ringing_inter_cycle milliseconds
Syntax description
milliseconds
Default
4000
Related Command
set port port fxo ringing_db
set port port fxo ringing_inter_pulse
5.10.9 set port port fxo ringing_inter_pulse
The FXO port detects ringing for signifying an incoming call. A ring is a cycle of
ring-on and ring-off signals. The ring-on signal is comprised of a sequence of pulses.
This command is used to specify the time between consecutive ring pulses in the
same ring-on signal in milliseconds (that is, one half the inverse of ring frequency).
For instance, if the ring frequency is 25 Hz, then the period of a ring-on signal is 40
ms, and the ringing_inter_pulse is 20 ms. It is used to detect ring-on.
set port port fxo ringing_inter_pulse milliseconds
Time in milliseconds, ranging
from 1 to 6000.
Syntax description
81
Solwise Elite VoIP Gateway User’s Guide
milliseconds
Default
20
Related Command
set port port fxo ringing_db
set port port fxo ringing_inter_cycle
set port port enable_user_cid
Though FXO ports can detect Caller ID and convey the detected Caller ID
information to the called party. The ITG allows conveying the Caller ID information
users configured to a FXO port, instead of conveying Caller ID information detected
from the port. This command is used to select which Caller ID information the ITG
should convey to the called party.
set port port enable_user_cid {on | off}
Time in milliseconds, ranging
from 1 to 6000.
Syntax description
on
off
Conveying Caller ID
information user configured.
Conveying Caller ID
information the port detected.
Default
off
Related Command
set port port cid name
set port port cid number
set port port fxo_caller_id
5.11 FXS Signaling Configuration Commands
The FXS Signaling Configuration Commands are used to define parameters specific
to FXS interface. These commands apply to Loop Start FXS signaling protocol only.
82
Solwise Elite VoIP Gateway User’s Guide
5.11.1 set port port fxs answ_clear_detect
This command is used to set the minimum time to wait, in milliseconds, when the
answering party drops the line before declaring on-hook.
set port port fxs answ_clear milliseconds
Syntax description
milliseconds
Default
2000
5.11.2 set port port fxs caller_id
This command selects if Caller ID will be generated on a FXS port.
set port port fxs caller_id {on | off}
Syntax description
on
off
Default
on
Time in milliseconds, ranging
from 1 to 60000.
Enable Caller ID
generation
Disable Caller ID
generation
Related Commands
set port port cid name
set port port cid number
5.11.3 set port port fxs cpc_dur
The ITG implements loop current shutdown feature on FXS port. It shuts down the
current feeding toward a FXS port upon detecting a call is being terminated by the
other party participated in the call. This command is used to set the duration, in
milliseconds, of the loop current shutdown (CPC supervisory disconnect).
set port port fxs cpc_dur milliseconds
Syntax description
83
Solwise Elite VoIP Gateway User’s Guide
milliseconds
Default
0
5.11.4 set port port fxs cpc_wait
This command is used to set the time to wait, in milliseconds, after a FXS port
shutting down loop current and before checking for on-hook.
set port port fxs cpc_wait milliseconds
Syntax description
milliseconds
Default
20
Time in milliseconds, ranging from 1 to
60000. 0 stands for never shutting down loop
current
Time in milliseconds, ranging
from 1 to 60000.
5.11.5 set port port fxs offhook_db
This command specifies the time in milliseconds to use as a debouncer interval for
debouncing the off-hook signal. For preventing from mistakenly interpreting noise
signal as off-hook, the ITG incorporates this debouncer. When the ITG detect offhook signal on a FXS port, the signal must sustain for at least the debouncer time,
otherwise it no regarded as a off-hook.
set port port fxs offhook_db milliseconds
Syntax description
milliseconds
Default
50
Related Command
set port port fxs offhook_detect
Time in milliseconds, ranging
from 1 to 1000.
5.11.6 set port port fxs offhook_detect
This command is used to set the time to wait, in milliseconds, before an off-hook
84
Solwise Elite VoIP Gateway User’s Guide
condition is declared.
set port port fxs offhook_detect milliseconds
Syntax description
milliseconds
Default
150
Related Command
set port port fxs offhook_db
5.11.7 set port port fxs onhook_db
This command specifies the time in milliseconds to use as a debouncer interval for
debouncing the on-hook signal. When the ITG detect on-hook signal on a FXS port,
the signal must sustain for at least the debouncer time, otherwise it no regarded as a
on-hook.
set port port fxs onhook_db milliseconds
Syntax description
Time in milliseconds, ranging
from 1 to 1000.
milliseconds
Default
50
Related Command
set port port fxs onhook_detect
5.11.8 set port port fxs onhook_detect
This command is used to set the time to wait, in milliseconds, before an on-hook
condition is declared.
set port port fxs onhook_detect milliseconds
Syntax description
Time in milliseconds, ranging
from 1 to 1000.
85
Solwise Elite VoIP Gateway User’s Guide
milliseconds
Default
800
Related Command
set port port fxs onhook_db
5.11.9 set port port fxs ring_id
A ringing signal is a repetition of ring-on and ring-off cycles (the so-called cadence).
The ITG can generate 11 types of ring cadence, each having a unique ID, on/off
cadence and total ringing duration. Types of ringing cadence and their IDs are shown
in the following table.
ID On Off On Off On Off Duration
0
1
2 0.8 0.4 0.8 4.0
3 0.4 0.2 0.4 0.2 0.8 4.0 3 minutes
4 0.3 0.2 1.0 0.2 0.3 4.0 3 minutes
5
6 0.5 0.2 0.3 0.2 0.5 3.0 3 minutes
7
8
9
10
This command is used to select which ring ID is to use on a FXS port.
Ring-On/Off Cycle Ringing
2.0
1.0
0.5
2.0
3.0
0.5
1.0
Time in milliseconds, ranging
from 1 to 1000.
4.0
3.0
0.1
4.0
5.0
1.
3.0
Forever
3 minutes
3 minutes
0.6 seconds
3 minutes
3 minutes
0.6 seconds
3 minutes
set port port fxs ring_id ring_id
Syntax description
ring_id
Ring ID, ranging from
0 to 10.
Default
0
5.12 Voice and Fax Coder Configuration Commands
The coding profile is used to store coding parameters for voice and fax coders that
86
Solwise Elite VoIP Gateway User’s Guide
can be used by any telephony port on the ITG. The ITG has 11 built-in coding
profiles, each having a unique profile ID and parameters for a specific voice, fax or
modem coder. Among these 11 coding profiles, 5 may be used for voice or fax
applications. The following table summarizes coding profiles available for voice and
fax applications.
Coding profile ID Coder
0
1 G.729AB voice coder
2
5 Proprietary fax coder
6
10 Standard T.38 fax coder
G.723 6.3 kbps voice
coder
G723 5.3 kbps voice
coder
G.711 µ-law voice coder
This section describes the commands for setting the parameters for a particular
coding profile. All the commands in this section are of the same syntax as follows:
set coding profile_id option [option] . . .
Syntax for the profile_id is as follows:
profile_id
This section is organized as follows:
Common coding profile configuration commands
Voice coding profile configuration commands
Fax coding profile configuration commands
5.12.1 Common Coding Profile Configuration Commands
The following sections describe commands that apply to all types of coding profiles.
5.12.1.1 set coding profile_id coding_type
This command is used to define the codec type for a coding profile.
ID of the coding profile to
be modified.
set coding profile_id coding_type coding_type
Syntax description
coding_type
Type of the codcc as defined in
the following table.
Parameter Description
g711_mu G.711 PCM u-law coding
87
Solwise Elite VoIP Gateway User’s Guide
g723_53 G.723.1 5.3 kbps coding
g723_63 G.723.1 6.3 kbps coding
g729ab
fax_t38 Fax Relay in T.38 mode
G.729 annex A, annex B
8kbps coding
Related Command
set coding profile_id usage
5.12.1.2 set coding profile_id cp_tone_detect
This command is used to specify a secondary level of control of call progress tone
detection. If the call progress detection control for a telephony port is set to "As per
coding profile" (refer to command “set port port cp_tone_det_ctrl” on page 24), this
parameter determines if detection is to be enabled or not.
set coding profile_id cp_tone_detect {on | off}
Syntax description
on
off
Related Command
set cp_tone_det
set cp_tone_det_cfg
set port port cp_tone_det_cfg
set port port cp_tone_det_ctrl
5.12.1.3 set coding profile_id copyof
This command is used to copy the settings of the coding profile to another coding
profile.
set coding profile_id copyof src_profile_id
Enable call progress tone
detection.
Disable call progress tone
detection.
88
Syntax description
src_profile_id
ID of the coding profile which the
setting will be copied from
Solwise Elite VoIP Gateway User’s Guide
5.12.1.4 set coding profile_id fax_tone_detect
This command is used to specify a secondary level of control of V.21 fax tone detection.
If the fax tone detection control for a telephony port is set to "As per coding profile" (refer
to command “set port port fax_tone_det_ctrl” on page 25), this parameter determines if
detection is to be enabled or not. For a voice coder, fax tone detection has to be enabled,
otherwise, s telephony port never switches to fax mode while the voice coder is active.
For a fax profile it does not matter if the fax tone detection is enabled or disabled.
set coding profile_id fax_tone_detect {on | off}
Syntax description
on
Disable V.21 fax tone detection.
Related Command
set port port fax_tone_det_ctrl
5.12.1.5 set coding profile_id usage
This command is used to set allowed usage for a coding profile.
set coding profile_id usage {voice | fax} {on |
off}
Syntax description
Voice
Enable V.21 fax tone
detection. off
The coding profile is allowed, if the parameter
that follows is “on”, for being used as voice
coder.
The coding profile is not allowed, if the
parameter that follows is “off”, for being used
as voice coder.
Fax
The coding profile is allowed, if the parameter
that follows is “on”, for being used as fax
coder.
The coding profile is not allowed, if the
parameter that follows is “off”, for being used
as fax coder.
The following sections describe commands that apply to coding profiles for voice
coder.
89
Solwise Elite VoIP Gateway User’s Guide
5.12.2.1 set coding profile_id adaptive_playout
The ITG has a built-in voice packet buffer, which allows the ITG to remove the
packet jitter from the incoming packet stream. The ITG also implements an adaptive
voice packet playback
algorithm, which automatically adjust the time each voice packet is buffered in the
voice packet buffer before being played out. This command is used to enable/disable
the adaptive playback function for a voice coding profile.
set coding profile_id adaptive_playout {on | off}
Syntax description
on
Enable adaptive
playback.
off
Disable adaptive
playback.
Related Commands
set coding profile_id max_delay
set coding profile_id min_delay
set coding profile_id nom_delay
5.12.2.2 set coding profile_id dtmf_relay
The ITG supports DTMF Relay, in which DTMF tones are detected during voice
processing, encoded into H323-UserInformation packets and conveyed to the remote
ITG via the H.323 call control band. This command is used to enable or disable the
DTMF Relay feature.
set coding profile_id dtmf_relay {on | off}
Syntax description
on
off
5.12.2.3 set coding profile_id max_delay
The ITG has a built-in voice packet buffer, which stores voice packets received from
the network. Voice packets from network may have traversed variable path and each
packets have experienced different propagation delay. The effect of non-uniform
90
Detect DTMF tones while voice session is ongoing, and send detected DTMF digits to
remote gateway via the H.323 call control
band.
Do not detect DTMF tones. DTMF tones are
compressed and send to remote gateway the
same as regular voice frame.
Solwise Elite VoIP Gateway User’s Guide
delay among packets is known as jitter. The voice buffer allows the ITG to remove
the packet jitter from the incoming packet stream before decompressing and sending
the packet to telephony port for playing out. This command is used to set the size of
the voice buffer.
set coding profile_id max_delay delay
Syntax description
delay
Value in
milliseconds.
Notes
1. The maximum delay should be at least 2 packet times greater than the nominal
delay. Refer to command “set coding profile_id nom_delay” on page 55 for details
about setting nominal delay.
2. The maximum delay for each coder is shown in the following table:
Coding Type Maximum Delay
G.711 µ-law
G.723 500 ms
G.729AB 500 ms
145 ms
Related Commands
set coding profile_id adaptive_playout
set coding profile_id nom_delay
5.12.2.4 set coding profile_id min_delay
This command is used to set the time each voice packet is stored in the voice packet
buffer before the ITG playing out the packet. It is only meaningful when the
adaptive playback feature is disabled. Refer to command “set coding profile_id
adaptive_playout” on page 53 for details about adaptive playback feature.
set coding profile_id max_delay delay
Syntax description
delay
Value in
milliseconds.
Related Commands
91
Solwise Elite VoIP Gateway User’s Guide
set coding profile_id adaptive_playout
5.12.2.5 set coding profile_id nom_delay
While the “set coding profile_id max_delay” command sets the size
of the voice packet buffer, this command sets the average time in milliseconds each
voice packet is stored in the buffer.
set coding profile_id nom_delay delay
Syntax description
Delay
Value in
milliseconds.
Note
The nominal delay should be at least twice the packet time. Refer to command “set
coding profile_id vif” on page 57 for details about setting the packet time.
Related Commands
set coding profile_id adaptive_playout
set coding profile_id max_delay
set coding profile_id vif
5.12.2.6 set coding profile_id vad
This command is used to enable/disable the Voice Activity Detector (VAD) for a
coding profile.
set coding profile_id vad {on | off}
Syntax description
On
Off
Enable VAD.
Disable VAD.
Related Commands
set coding profile_id vad_thresh
5.12.2.7 set coding profile_id vad_thresh
This command is used to set threshold level for the VAD for a coding profile.
set coding profile_id vad_thresh threshold
Syntax description
92
Solwise Elite VoIP Gateway User’s Guide
threshold
Related Commands
set coding profile_id vad
5.12.2.8 set coding profile_id vif
This command is used to set the size of the Voice Information Field (VIF), in bits,
for a voice coder.
set coding profile_id vif no_of_bits
Syntax description
no_of_bits
Size of the Voice Information Field (VIF), in bits, for a voice coder.
The appropriate VIF sizes to use are related to the coding type and the
rate the voice coder samples a voice frame (the packet time), as shown
in the following table. VIF sizes of a coder of values other than those
shown in the table are not valid.
Coding type Sampling time VIF
Value in dBm, ranging from
–20 to +10.
G.711 µ-law
G.723 30 ms 192
G.729AB 10 ms 80
10 ms 640
20 ms 1,280
30 ms 1,920
60 ms 384
20 ms 160
30 ms 240
40 ms 320
50 ms 400
60 ms 480
Related Commands
set coding profile_id nom_delay
5.12.3 Fax Coding Profile Configuration Commands
The following sections describe commands that apply to coding profiles for fax.
5.12.3.1 set coding profile_id fax_hs_pkt_rate
This T-38 mode command is used to set the rate at which high-speed data will be
93
Solwise Elite VoIP Gateway User’s Guide
sent across the network, for a fax coder (i.e., determines the size of the high-speed
IFPs).
set coding profile_id fax_hs_pkt_rate milliseconds
Syntax description
milliseconds
5.12.3.2 set coding profile_id fax_hs_redundancy
Value in
milliseconds
The T-38 mode command is used to specify the packet-level redundancy for highspeed data transmissions (i.e., T.4 image data) for a fax coder profile.
set coding profile_id fax_hs_redundancy pkt
Syntax description
pkt
Related Commands
set coding profile_id fax_ls_redundancy
5.12.3.3 set coding profile_id fax_ls_redundancy
This T-38 mode command is used to specify the packet-level redundancy for lowspeed data transmissions (i.e., T.30 handshaking information), for a fax coder.
Number of prior primary packets to be
encapsulated in each fax payload, ranging from
0 to 2.
set coding profile_id fax_ls_redundancy pkt
Syntax description
pkt
Related Commands
set coding profile_id fax_hs_redundancy
5.12.3.4 set coding profile_id fax_relay_features
This command is used to enable or disable specific fax processing capabilities for a
fax coder.
Number of prior primary packets to be
encapsulated in each fax payload, ranging from
0 to 5.
Solwise Elite VoIP Gateway User’s Guide
Syntax description
scanlon
scanloff
fdison
fdisoff
nfson
nfsoff
5.12.3.5 set coding profile_id fax_t30_features
This command is used to enable or disable the use of specific fax capabilities
between two end fax devices.
set coding profile_id fax_t30_features {ecmon |
ecmoff}
Enable concealment of page data errors due to
network packet loss.
Disable concealment of page data errors due to
network packet loss.
Enable prolonging of the second Digital
Identification Signal (DIS) retransmission.
Disable prolonging of the second DIS
retransmission.
Enable overriding of Non-standard Facility (NSF)
data and prevent end fax devices from employing
proprietary capabilities.
Disable overriding of NSF data.
Syntax description
ecmon
ecmoff
5.12.3.6 set coding profile_id fax_tcf_method
This T-38 mode command is used to control the method with which data is handled
over the network, for a fax coding profile. Method 1 (Local) requires that the TCF
training signal be generated and checked locally by the gateway and is not forwarded
over the network. In Method 2 (Network), TCF data is sent over the network. These
correspond to Data Management methods 1 and 2 in specification T.38.
This command sets the timeout period after which the ITG will declare a fax
cleardown event, if no data is received from the IP network while the gateway is in a
local transmit state. It is safeguard to ensure the channel is not left in a fax relay state
in a transparent signaling environment.
set coding profile_id fax_tx_net_timeout seconds
Syntax description
seconds
Value in seconds, ranging
from 10 to 32000.
5.13 Call Progress Tone Configuration Commands
Cal Progress (CP) tones such as ring-back, busy, congestion and disconnect tone are
signaling tones PBXs and CO switches present at various stage of a call. Telephony
device, or user operating it, must act upon the CP tones generated by device
connected to it for completing a call. The ITG implements a CP generator for
generating CP tones and a detector for detecting CP tones. Since the frequency
specifications and on/off cadence of CP tones are not uniform over all telephone
administrations globally, the ITG implements user configurable CP tone
generator/detector allowing user to customize the CP tone generator and detector.
This section describes commands for configuring the CP tone generator and detector.
5.13.1 Configuring CP Tones
A CP tone is a sequence of tones of up to 6 elements, and each tone element is
characterized by a composition of up to 4 mono-frequency tones and a duration that
the tone generator plays out these tones. Once configured, the CP tone generator
plays these tone elements, in sequence, repeatedly. The ITG allows users to define
the tone elements and duration for the following CP tones:
Dial tone
Busy tone
Congestion tone
Disconnect tone
This section describes the command for configuring these tones.
5.13.1.1 set tone
This interactive command is used to configure the each of the element of the CP
tones that the ITG generates.
set tone {dial | busy | congest | disconnect}
Syntax description
dial
96
Dial tone
Solwise Elite VoIP Gateway User’s Guide
busy
congest
disconnect
Busy tone
Congestion tone
Disconnect tone
After entering the command, the CLI first prompts you to enter the number of tone
elements, then prompts you to enter each tone element in sequence. For each tone
element, you’ll need to specify the following parameters:
Number of mono-frequency tone components, up to 4, that comprise the tone.
Frequency (in Hz) and power level (in unit of 0.1 dBm) for all the mono-frequency
tone components. Since a tone may be comprised of up to 4 mono-frequency tone
components, you need to provide the frequency and power level of all the 4 tone
components. If a tone element is comprised of less than 4 mono-frequency tone
components, you need to specify frequency of 0 Hz and power level of 0 dBm to the
components that do not exist.
Duration (in milliseconds) of the tone. The duration of –1 specifies playing out the
tone forever.
Example
Assuming you want to define a congestion tone, which is a repetition of two tone
elements as shown in the following table:
Tone No. of Tone 1 Tone 2 Dura-
Element mono-
1 2 480 -24.0 620 -24.0 250
2 0
Tone Composition
freq. tones
Freq
(Hz)
Power
(dBm)
Freq
(Hz)
Power
(dBm)
tion
(ms)
Remark
The first
tone
element is a
compositio
n of a 420
Hz tone of
power level
–24.0 dBm
and a 620
Hz tone of
power level
–24.0 dBm
of duration
250
millisecond
s.
The 2nd tone
element is a
silence of
duration
250 ms.
The following example explains how this interactive command is used to define this
tone. Command and keywords user entered are designated in boldface.
Console>set tone congest <Enter>
97
Solwise Elite VoIP Gateway User’s Guide
How many sets of tone do you want the whole tone to be? (1~6)
2 <Enter>
Please enter set 1 parameters in the following order:
num_freq freq1 amp1 freq2 amp2 freq3 amp3 freq4 amp4 duration (-1:
forever)
2 480 –240 620 –240 0 0 0 0 250 <Enter>
Please enter set 2 parameters in the following order:
num_freq freq1 amp1 freq2 amp2 freq3 amp3 freq4 amp4 duration (-1:
forever)
0 0 0 0 0 0 0 0 0 250 <Enter>
OK
Use 'config store' cmd to save all the tone generation settings
you've made.
Console>
The following example explains how to define a dial tone, which is a continuous playing out of a
400 Hz tone of power level –20 dBm.
Console>set tone dial <Enter>
How many sets of tone do you want the whole tone to be? (1~6)
1 <Enter>
Please enter set 1 parameters in the following order:
num_freq freq1 amp1 freq2 amp2 freq3 amp3 freq4 amp4 duration (-1:
forever)
1 400 –200 0 0 0 0 0 0 -1 <Enter>
OK
Use 'config store' cmd to save all the tone generation settings
you've made.
Console>
Related Commands
show tone
5.13.2 Configuring CP Tone Detector
The CP tones that the ITG can detect include busy, ring-back, congestion and 6 types
of disconnect tones. The ITG allows user to configure its CP tone detection
configuration. The CP tone detection configuration includes tone filter information,
and a table containing cadence information of all the CP tones that are to be
detected. The CP tone filter is a band-pass filter, which filters all the tones present on
the telephony ports. After filtering, if a tone is regarded as a CP tone, the ITG
matches the on/off cadence of the tone against the cadence table users configured. If
a match is found, the ITG regards it as a specific tone. This section describes
command for configuring the tone detection filter and the tone on/off cadence for all
the CP tone the ITG can detect.
5.13.2.1 set cp_tone_det
This command is used to configure the on/off cadence for all the CP tones the ITG
can detect.
The cadence of a CP tone that user may configure include a sequence of tone-on and
tone-off duration and the number or repetition of the sequence. For each CP tone,
user may define up t 8 tone-on and tone-off duration, each is defined by a minimum
and maximum duration.
After entering the command, the CLI first prompts you to enter the number of on/off
cadence elements, then prompts you to enter each cadence element in sequence. For
each cadence element, you’ll need to specify the following parameters:
Tone on or tone off.
Minimum duration (in milliseconds) of the tone.
Maximum duration (in milliseconds) of the tone.
Example
Assuming you want to define a busy tone, which is a sequence of the following toneon and tone-off:
Tone Minimum
On 450 ms 550 ms
Off 350 ms 450 ms
On 450 ms 550 ms
Off 350 ms 450 ms
The following example explains how this interactive command is used to define the
cadence. Command and keywords user entered are designated in boldface.
Duration
Maximum
Duration
99
Solwise Elite VoIP Gateway User’s Guide
Console>set cp_tone_det busy <Enter>
How many sets of elements do you want the whole CP tone to be
detected? (1~8)
2 <Enter>
Please enter set 1 parameters in the following order:
on/off min.-duration max.-duration
on 450 550 <Enter>
Please enter set 2 parameters in the following order:
on/off min.-duration max.-duration
off 350 450 <Enter>
Please enter the repeat count now (1~10):
2 <Enter>
OK
Use 'config store' cmd to save all the CPtone detection settings
you've made.
Console>
Related Commands
set cp_tone_det_cfg
set coding profile_id cp_tone_detect
set port port cp_tone_det_cfg
set port port cp_tone_det_ctrl
show cp_tone_det
5.13.2.2 set cp_tone_det_cfg
This command is used to configure the CP tone detection filter for the default CP
tone detection configuration.
set cp_tone_det_dfg on_frac [threshold|0|-]
[hold_over_time|0|-] [low_freq|0|-] [high_freq|0|-]
Syntax description
on_frac
threshold
Percentage of tone on fraction ranging from 10
to 95. If the ratio between the tone energy and
total energy is below this fraction, the call
progress tone is ignored. “0” specifies the
default of 50%. “-“ specifies using the original
setting.
Tone detection threshold, in dBm, ranging from
–35 to –20. “0” specifies the default of –37
dBm. “-“ specifies using the original setting.
100
hold_over_time
Minimum time duration in millisecond, ranging
from 5 to 32767 for the call progress tone to be
detected. “0” specifies the default of 200 ms. ““ specifies using the original setting.
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.